How to use

NilObject

in

org.apache.sis.xml

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()));