Class XContentFactory

java.lang.Object
org.elasticsearch.xcontent.XContentFactory

public class XContentFactory extends Object
A one stop to use XContent and XContentBuilder.
  • Field Details

  • Constructor Details

    • XContentFactory

      public XContentFactory()
  • Method Details

    • jsonBuilder

      public static XContentBuilder jsonBuilder() throws IOException
      Returns a content builder using JSON format (XContentType.JSON.
      Throws:
      IOException
    • jsonBuilder

      public static XContentBuilder jsonBuilder(OutputStream os) throws IOException
      Constructs a new json builder that will output the result into the provided output stream.
      Throws:
      IOException
    • smileBuilder

      public static XContentBuilder smileBuilder() throws IOException
      Returns a content builder using SMILE format (XContentType.SMILE.
      Throws:
      IOException
    • smileBuilder

      public static XContentBuilder smileBuilder(OutputStream os) throws IOException
      Constructs a new json builder that will output the result into the provided output stream.
      Throws:
      IOException
    • yamlBuilder

      public static XContentBuilder yamlBuilder() throws IOException
      Returns a content builder using YAML format (XContentType.YAML.
      Throws:
      IOException
    • yamlBuilder

      public static XContentBuilder yamlBuilder(OutputStream os) throws IOException
      Constructs a new yaml builder that will output the result into the provided output stream.
      Throws:
      IOException
    • cborBuilder

      public static XContentBuilder cborBuilder() throws IOException
      Returns a content builder using CBOR format (XContentType.CBOR.
      Throws:
      IOException
    • cborBuilder

      public static XContentBuilder cborBuilder(OutputStream os) throws IOException
      Constructs a new cbor builder that will output the result into the provided output stream.
      Throws:
      IOException
    • contentBuilder

      public static XContentBuilder contentBuilder(XContentType type, OutputStream outputStream) throws IOException
      Constructs a xcontent builder that will output the result into the provided output stream.
      Throws:
      IOException
    • contentBuilder

      public static XContentBuilder contentBuilder(XContentType type) throws IOException
      Returns a binary content builder for the provided content type.
      Throws:
      IOException
    • xContent

      public static XContent xContent(XContentType type)
      Returns the XContent for the provided content type.
    • xContentType

      @Deprecated public static XContentType xContentType(CharSequence content)
      Deprecated.
      the content type should not be guessed except for few cases where we effectively don't know the content type. The REST layer should move to reading the Content-Type header instead. There are other places where auto-detection may be needed. This method is deprecated to prevent usages of it from spreading further without specific reasons.
      Guesses the content type based on the provided char sequence.
    • xContent

      @Deprecated public static XContent xContent(CharSequence content)
      Deprecated.
      the content type should not be guessed except for few cases where we effectively don't know the content type. The REST layer should move to reading the Content-Type header instead. There are other places where auto-detection may be needed. This method is deprecated to prevent usages of it from spreading further without specific reasons.
      Guesses the content (type) based on the provided char sequence and returns the corresponding XContent
    • xContent

      @Deprecated public static XContent xContent(byte[] data)
      Deprecated.
      the content type should not be guessed except for few cases where we effectively don't know the content type. The REST layer should move to reading the Content-Type header instead. There are other places where auto-detection may be needed. This method is deprecated to prevent usages of it from spreading further without specific reasons.
      Guesses the content type based on the provided bytes and returns the corresponding XContent
    • xContent

      @Deprecated public static XContent xContent(byte[] data, int offset, int length)
      Deprecated.
      guessing the content type should not be needed ideally. We should rather know the content type upfront or read it from headers. Till we fixed the REST layer to read the Content-Type header, that should be the only place where guessing is needed.
      Guesses the content type based on the provided bytes and returns the corresponding XContent
    • xContentType

      @Deprecated public static XContentType xContentType(InputStream si) throws IOException
      Deprecated.
      the content type should not be guessed except for few cases where we effectively don't know the content type. The REST layer should move to reading the Content-Type header instead. There are other places where auto-detection may be needed. This method is deprecated to prevent usages of it from spreading further without specific reasons.
      Guesses the content type based on the provided input stream without consuming it.
      Throws:
      IOException
    • xContentType

      @Deprecated public static XContentType xContentType(byte[] bytes)
      Deprecated.
      the content type should not be guessed except for few cases where we effectively don't know the content type. The REST layer should move to reading the Content-Type header instead. There are other places where auto-detection may be needed. This method is deprecated to prevent usages of it from spreading further without specific reasons.
      Guesses the content type based on the provided bytes.
    • xContentType

      @Deprecated public static XContentType xContentType(byte[] bytes, int offset, int length)
      Deprecated.
      the content type should not be guessed except for few cases where we effectively don't know the content type. The REST layer should move to reading the Content-Type header instead. There are other places where auto-detection may be needed. This method is deprecated to prevent usages of it from spreading further without specific reasons.
      Guesses the content type based on the provided bytes.