Package org.hl7.fhir.dstu3.formats

Interface IParser

All Known Implementing Classes:
JsonParser, JsonParserBase, ParserBase, RdfParser, RdfParserBase, XmlParser, XmlParserBase
public interface IParser
General interface - either an XML or JSON parser: read or write instances Defined to allow a factory to create a parser of the right type

  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Interface
    Description
    static enum 
    IParser.OutputStyle
     

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    compose(OutputStream stream, Resource resource)
    Compose a resource to a stream, possibly using pretty presentation for a human reader (used in the spec, for example, but not normally in production)
    void
    compose(OutputStream stream, Type type, String rootName)
    Compose a type to a stream, possibly using pretty presentation for a human reader (used in the spec, for example, but not normally in production) Not supported by all implementations.
    byte[]
    composeBytes(Resource resource)
    Compose a resource to a stream, possibly using pretty presentation for a human reader (used in the spec, for example, but not normally in production)
    byte[]
    composeBytes(Type type, String rootName)
    Compose a type to a stream, possibly using pretty presentation for a human reader (used in the spec, for example, but not normally in production) Not supported by all implementations.
    String
    composeString(Resource resource)
    Compose a resource to a stream, possibly using pretty presentation for a human reader (used in the spec, for example, but not normally in production)
    String
    composeString(Type type, String rootName)
    Compose a type to a stream, possibly using pretty presentation for a human reader (used in the spec, for example, but not normally in production) Not supported by all implementations.
    boolean
    getHandleComments()
    Whether to parse or ignore comments - either reading or writing
    IParser.OutputStyle
    getOutputStyle()
    Writing:
    ParserType
    getType()
    check what kind of parser this is
    boolean
    isAllowUnknownContent()
     
    Resource
    parse(byte[] bytes)
    parse content that is known to be a resource
    Resource
    parse(InputStream input)
    parse content that is known to be a resource
    Resource
    parse(String input)
    parse content that is known to be a resource
    Type
    parseType(byte[] bytes, String knownType)
    This is used to parse a type - a fragment of a resource.
    Type
    parseType(InputStream input, String knownType)
    This is used to parse a type - a fragment of a resource.
    Type
    parseType(String input, String knownType)
    This is used to parse a type - a fragment of a resource.
    IParser
    setAllowUnknownContent(boolean value)
     
    IParser
    setHandleComments(boolean value)
     
    IParser
    setOutputStyle(IParser.OutputStyle value)
     
    IParser
    setSuppressXhtml(String message)
    This method is used by the publication tooling to stop the xhrtml narrative being generated.

  • Method Details

    • getType

      ParserType getType()
      check what kind of parser this is
      Returns:
      what kind of parser this is

    • getHandleComments

      boolean getHandleComments()
      Whether to parse or ignore comments - either reading or writing

    • setHandleComments

      IParser setHandleComments(boolean value)

    • isAllowUnknownContent

      boolean isAllowUnknownContent()
      Parameters:
      allowUnknownContent - Whether to throw an exception if unknown content is found (or just skip it) when parsing

    • setAllowUnknownContent

      IParser setAllowUnknownContent(boolean value)

    • getOutputStyle

      IParser.OutputStyle getOutputStyle()
      Writing:

    • setOutputStyle

      IParser setOutputStyle(IParser.OutputStyle value)

    • setSuppressXhtml

      IParser setSuppressXhtml(String message)
      This method is used by the publication tooling to stop the xhrtml narrative being generated. It is not valid to use in production use. The tooling uses it to generate json/xml representations in html that are not cluttered by escaped html representations of the html representation

    • parse

      Resource parse(InputStream input) throws IOException, org.hl7.fhir.exceptions.FHIRFormatError
      parse content that is known to be a resource
      Throws:
      org.xmlpull.v1.XmlPullParserException
      org.hl7.fhir.exceptions.FHIRFormatError
      IOException

    • parse

      Resource parse(String input) throws UnsupportedEncodingException, org.hl7.fhir.exceptions.FHIRFormatError, IOException
      parse content that is known to be a resource
      Throws:
      UnsupportedEncodingException
      IOException
      org.hl7.fhir.exceptions.FHIRFormatError

    • parse

      Resource parse(byte[] bytes) throws org.hl7.fhir.exceptions.FHIRFormatError, IOException
      parse content that is known to be a resource
      Throws:
      IOException
      org.hl7.fhir.exceptions.FHIRFormatError

    • parseType

      Type parseType(InputStream input, String knownType) throws IOException, org.hl7.fhir.exceptions.FHIRFormatError
      This is used to parse a type - a fragment of a resource. There's no reason to use this in production - it's used in the build tools Not supported by all implementations
      Parameters:
      input -
      knownType - . if this is blank, the parser may try to infer the type (xml only)
      Returns:
      Throws:
      org.xmlpull.v1.XmlPullParserException
      org.hl7.fhir.exceptions.FHIRFormatError
      IOException

    • parseType

      Type parseType(String input, String knownType) throws UnsupportedEncodingException, org.hl7.fhir.exceptions.FHIRFormatError, IOException
      This is used to parse a type - a fragment of a resource. There's no reason to use this in production - it's used in the build tools Not supported by all implementations
      Parameters:
      input -
      knownType - . if this is blank, the parser may try to infer the type (xml only)
      Returns:
      Throws:
      UnsupportedEncodingException
      IOException
      org.hl7.fhir.exceptions.FHIRFormatError

    • parseType

      Type parseType(byte[] bytes, String knownType) throws org.hl7.fhir.exceptions.FHIRFormatError, IOException
      This is used to parse a type - a fragment of a resource. There's no reason to use this in production - it's used in the build tools Not supported by all implementations
      Parameters:
      knownType - . if this is blank, the parser may try to infer the type (xml only)
      input -
      Returns:
      Throws:
      IOException
      org.hl7.fhir.exceptions.FHIRFormatError

    • compose

      void compose(OutputStream stream, Resource resource) throws IOException
      Compose a resource to a stream, possibly using pretty presentation for a human reader (used in the spec, for example, but not normally in production)
      Throws:
      IOException

    • composeString

      String composeString(Resource resource) throws IOException
      Compose a resource to a stream, possibly using pretty presentation for a human reader (used in the spec, for example, but not normally in production)
      Throws:
      IOException

    • composeBytes

      byte[] composeBytes(Resource resource) throws IOException
      Compose a resource to a stream, possibly using pretty presentation for a human reader (used in the spec, for example, but not normally in production)
      Throws:
      IOException

    • compose

      void compose(OutputStream stream, Type type, String rootName) throws IOException
      Compose a type to a stream, possibly using pretty presentation for a human reader (used in the spec, for example, but not normally in production) Not supported by all implementations. rootName is ignored in the JSON format
      Throws:
      org.xmlpull.v1.XmlPullParserException
      org.hl7.fhir.exceptions.FHIRFormatError
      IOException

    • composeString

      String composeString(Type type, String rootName) throws IOException
      Compose a type to a stream, possibly using pretty presentation for a human reader (used in the spec, for example, but not normally in production) Not supported by all implementations. rootName is ignored in the JSON format
      Throws:
      IOException

    • composeBytes

      byte[] composeBytes(Type type, String rootName) throws IOException
      Compose a type to a stream, possibly using pretty presentation for a human reader (used in the spec, for example, but not normally in production) Not supported by all implementations. rootName is ignored in the JSON format
      Throws:
      IOException