Package com.sportradar.livedata.sdk.proto.common

Interface JaxbBuilder

All Known Implementing Classes:
JaxbFactory
public interface JaxbBuilder

Represents a builder used to build JAXB based Marshaller and Unmarshaller instances. Different implementations can be used to determine whether each time new instance is created or an existing instance is returned.

For performance reasons there should only be one instance of the JAXBContext used throughout the application. The context can than be used to create marshaller and un-marshaller instances. Since the marshallers and un-marshallers are not thread safe one instance should only be used within one thread or synchronization should be applied to avoid threading issues.

When application is marshalling and un-marshalling larger numbers of small objects, the creation of marshallers and un-marshallers can become an expansive operation. In those cases performance can be approved by sharing marshallers and un-marshallers between multiple threads.

  • Method Summary

    Modifier and Type
    Method
    Description
    jakarta.xml.bind.Marshaller
    buildMarshaller()
    Returns a Marshaller implementation.
    jakarta.xml.bind.Unmarshaller
    buildUnmarshaller()
    Returns a Unmarshaller implementation.
    String
    getEncoding()
    Gets the configured character encoding for the builder.

  • Method Details

    • buildMarshaller

      jakarta.xml.bind.Marshaller buildMarshaller() throws ProtocolException
      Returns a Marshaller implementation.
      Returns:
      The created Marshaller instance.
      Throws:
      ProtocolException - the marshaller could not be build

    • buildUnmarshaller

      jakarta.xml.bind.Unmarshaller buildUnmarshaller() throws ProtocolException
      Returns a Unmarshaller implementation.
      Returns:
      The created Unmarshaller instance.
      Throws:
      ProtocolException - The unmarshaller could not be build

    • getEncoding

      String getEncoding()
      Gets the configured character encoding for the builder.
      Returns:
      - a string, i.e. UTF-8