com.sap.mw.jco.jra

Interface XMLConverter

public interface XMLConverter

Casting on this interface provides possibility to convert JCA Records to/from XML

Method Summary

void	fromXML(String xmlDocument) This method is not currently implemented and throws NotSupportedException.
String	toXML() Returns the whole record in XML format.

Method Detail

toXML

String toXML()
             throws SQLException,
                    NotSupportedException

Returns the whole record in XML format.

Note: Field names in SAP system may contain characters which are illegal in XML element names.
Legal elements names however can be assembled by using the following transformation rules:

The characters 'A'-'Z', 'a'-'z', or '_' are not mapped.

The characters '0'-'9' or '.' are not mapped unless they appear as the first character in a element name.

'/' is mapped to '-_'

Any other ASCII character is mapped to the sequence '_--XX', where XX is the 2-digit hexadecimal code of the ASCII character
(e.g. '&' is represented as '_--26').
The value part of an element may contain the following mappings:

The characters '<', '&', and '>' are being mapped to '&#60;', '&#38;', and '&#62;', respectively.

Returns:

the record as an XML document

Throws:

SQLException - thrown if the record could not be converted to an XML document

NotSupportedException

fromXML

void fromXML(String xmlDocument)
             throws SQLException,
                    NotSupportedException

This method is not currently implemented and throws NotSupportedException. Parses the specified XML document and fills in those fields of the map whose names coincide with the tags in the XML document.

Parameters:

xmlDocument - the the xml document

Throws:

SQLException - thrown if an error occurred

NotSupportedException - if not supported in this release Note, it is currently not supported If you use IDoc library with Java Resource Adapter then you can make XML conversion over com.sap.conn.idoc.IDocXMLProcessor. See javadoc to this interface for details

Access Rights

This class can be accessed from:

SC	DC	Public Part	ACH
[sap.com] ENGFACADE	[sap.com] tc/bl/jra/api	api	BC-JAS