org.apache.sis.xml.NilObject java code examples

Add the Codota plugin to your IDE and get smart completions

private void myMethod () {
 BufferedReader b =InputStream in;new BufferedReader(new InputStreamReader(in))
Reader in;new BufferedReader(in)
File file;new BufferedReader(new FileReader(file))
Smart code suggestions by Codota
}

if (object != null) {
  if (object instanceof NilObject) {
    return ((NilObject) object).getNilReason();

ox = ((NilObject) other).getNilReason();

ox = ((NilObject) other).getNilReason();

if (object != null) {
  if (object instanceof NilObject) {
    return ((NilObject) object).getNilReason();

final NilReason reason = ((NilObject) value).getNilReason();
if (reason != null) {
  reference = reason.toString();

final NilReason reason = ((NilObject) value).getNilReason();
if (reason != null) {
  reference = reason.toString();

assertInstanceOf("Should have instantiated a proxy.", NilObject.class, series);
final NilReason reason = ((NilObject) series).getNilReason();
assertNull("NilReason.explanation", reason.getOtherExplanation());
assertEquals("NilReason.URI", "http://www.myreason.org", String.valueOf(reason.getURI()));

/**
 * Tests a simple case for a missing data.
 *
 * @throws JAXBException if an error occurred during (un)marshalling.
 */
@Test
public void testMissing() throws JAXBException {
  final String expected =
      "<cit:CI_Citation xmlns:cit=\"" + Namespaces.CIT + '"' +
              " xmlns:gco=\"" + Namespaces.GCO + "\">\n" +
      "  <cit:title>\n" +
      "    <gco:CharacterString>A title</gco:CharacterString>\n" +
      "  </cit:title>\n" +
      "  <cit:series gco:nilReason=\"missing\"/>\n" +
      "</cit:CI_Citation>";
  final Citation citation = unmarshal(Citation.class, expected);
  assertTitleEquals("citation", "A title", citation);
  final Series series = citation.getSeries();
  assertInstanceOf("Should have instantiated a proxy.", NilObject.class, series);
  final NilReason reason = ((NilObject) series).getNilReason();
  assertSame("nilReason", NilReason.MISSING, reason);
  assertNull("NilReason.explanation", reason.getOtherExplanation());
  assertNull("NilReason.URI",         reason.getURI());
  assertEquals("Series[missing]", series.toString());
  assertNull("All attributes are expected to be null.", series.getName());
  final String actual = marshal(citation);
  assertXmlEquals(expected, actual, "xmlns:*");
  assertEquals(citation, unmarshal(Citation.class, actual));
}

/**
 * Tests a case where the nil reason is specified by an other reason.
 *
 * @throws JAXBException if an error occurred during (un)marshalling.
 */
@Test
@DependsOnMethod("testMissing")
public void testOther() throws JAXBException {
  final String expected =
      "<cit:CI_Citation xmlns:cit=\"" + Namespaces.CIT + '"' +
              " xmlns:gco=\"" + Namespaces.GCO + "\">\n" +
      "  <cit:title>\n" +
      "    <gco:CharacterString>A title</gco:CharacterString>\n" +
      "  </cit:title>\n" +
      "  <cit:series gco:nilReason=\"other:myReason\"/>\n" +
      "</cit:CI_Citation>";
  final Citation citation = unmarshal(Citation.class, expected);
  assertTitleEquals("citation", "A title", citation);
  final Series series = citation.getSeries();
  assertInstanceOf("Should have instantiated a proxy.", NilObject.class, series);
  final NilReason reason = ((NilObject) series).getNilReason();
  assertEquals("NilReason.explanation", "myReason", reason.getOtherExplanation());
  assertNull("NilReason.URI", reason.getURI());
  assertEquals("Series[other:myReason]", series.toString());
  assertNull("All attributes are expected to be null.", series.getName());
  final String actual = marshal(citation);
  assertXmlEquals(expected, actual, "xmlns:*");
  assertEquals(citation, unmarshal(Citation.class, actual));
}

final Citation citation = identification.getCitation();
assertInstanceOf("citation", NilObject.class, citation);
assertEquals("nilReason", NilReason.MISSING, ((NilObject) citation).getNilReason());
assertEquals("abstract", "SIS test", identification.getAbstract().toString());
assertEquals("language", Locale.ENGLISH, getSingleton(identification.getLanguages()));

Javadoc

A marker interface for nil XML elements providing an explanation about why the information is absent. GeoAPI getter methods usually return a null value when no information is available for a given attribute. However it is possible to specify why an information is absent, in which case the corresponding getter method will rather return an instance of this NilObject interface. The information may be absent for various reasons, including the attribute being inapplicable in the metadata context ( NilReason#INAPPLICABLE), the information probably exists but is unknown to the data provider ( NilReason#UNKNOWN), the information may not exist at all ( NilReason#MISSING) or can not be divulged ( NilReason#WITHHELD).

Nil objects appear most frequently in XML documents because if a mandatory ISO 19115-1 attribute is absent, then the ISO 19115-3 standard requires us to said why it is absent. The following example shows a CI_Citation fragment with an ordinary CI_Series element on the left side, and an unknown CI_Series element on the right side:

Example of missing object
Normal Series element	Unknown Series element
xml	xml

If the CI_Series element was completely omitted, then org.opengis.metadata.citation.Citation#getSeries()method would return null in Apache SIS implementation. But since a nilReason is provided, then the SIS implementation of getSeries() will rather return an object which implement both the Series and the NilObject interfaces, and the #getNilReason() method on that instance will return the NilReason#UNKNOWN constant.

Instantiation

Instances of NilObject are created by first fetching the reason why the information is missing, then invoking NilReason#createNilObject(Class). The following example instantiates a Citation object which is nil because the information are missing: java

Most used methods

getNilReason
Returns the reason why this object contains no information.

Popular in Java

Making http requests using okhttp
scheduleAtFixedRate (Timer)
getOriginalFilename (MultipartFile)
Return the original filename in the client's filesystem.This may contain path information depending
scheduleAtFixedRate (ScheduledExecutorService)
Creates and executes a periodic action that becomes enabled first after the given initial delay, and
FlowLayout (java.awt)
A flow layout arranges components in a left-to-right flow, much like lines of text in a paragraph. F
Charset (java.nio.charset)
A charset is a named mapping between Unicode characters and byte sequences. Every Charset can decode
KeyStore (java.security)
This class represents an in-memory collection of keys and certificates. It manages two types of entr
Vector (java.util)
The Vector class implements a growable array of objects. Like an array, it contains components that
Modifier (javassist)
The Modifier class provides static methods and constants to decode class and member access modifiers
JFileChooser (javax.swing)

How to useNilObject in org.apache.sis.xml

Best Java code snippets using org.apache.sis.xml.NilObject (Showing top 10 results out of 315)

How to use
NilObject
in
org.apache.sis.xml