com.sun.xml.bind.v2.runtime.output
Class Pcdata

java.lang.Object
  extended by com.sun.xml.bind.v2.runtime.output.Pcdata
All Implemented Interfaces:
CharSequence
Direct Known Subclasses:
Base64Data, IntArrayData, IntData

public abstract class Pcdata
extends Object
implements CharSequence

Text data in XML.

This class is used inside the marshaller/unmarshaller to send/receive text data.

On top of CharSequence, this class has an ability to write itself to the XmlOutput. This allows the implementation to choose the most efficient way possible when writing to XML (for example, it can skip the escaping of buffer copying.) TODO: visitor pattern support?


Constructor Summary
Pcdata()
           
 
Method Summary
abstract  String toString()
           
 void writeTo(char[] buf, int start)
          Writes itself to the character array.
abstract  void writeTo(UTF8XmlOutput output)
          Writes itself to UTF8XmlOutput.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface java.lang.CharSequence
charAt, length, subSequence
 

Constructor Detail

Pcdata

public Pcdata()
Method Detail

writeTo

public abstract void writeTo(UTF8XmlOutput output)
                      throws IOException
Writes itself to UTF8XmlOutput.

This is the most performance critical path for the marshaller, so it warrants its own method.

Throws:
IOException

writeTo

public void writeTo(char[] buf,
                    int start)
Writes itself to the character array.

This method is used by most other XmlOutput. The default implementation involves in one extra char[] copying.

The caller must provide a big enough buffer that can hold enough characters returned by the CharSequence.length() method.


toString

public abstract String toString()
Specified by:
toString in interface CharSequence
Overrides:
toString in class Object