book

Java and XML, Second Edition

by Brett McLaughlin

August 2001

Intermediate to advanced

528 pages

14h 35m

English

O'Reilly Media, Inc.

Read now

Unlock full access

Organization
XML MattersPortabilityInteroperabilityIt Doesn’t Matter
Low-Level APIsHigh-Level APIsXML-Based Applications
An Operating System and JavaA ParserAPIsApplication Software

The BasicsXML 1.0The root elementElementsAttributesEntity references and constantsUnparsed dataNamespaces
DTDsElementsAttributesEntitiesXML SchemaElements and attributesMultiple namespaces
XSLXSL and treesFormatting objectsXSLTXPathTemplate matchingLoopingCopying
Getting PreparedObtaining a ParserGetting the SAX Classes and InterfacesHave an XML Document on Hand
Instantiating a ReaderParsing the DocumentUsing an InputSource
The Document LocatorThe Beginning and the End of a DocumentProcessing InstructionsNamespace CallbacksElement CallbacksElement DataIgnorable WhitespaceEntitiesThe Results
WarningsNonfatal ErrorsFatal ErrorsBreaking the Data
My Parser Doesn’t Support SAX 2.0The SAX XMLReader: Reused and ReentrantThe Misplaced LocatorGetting Ahead of the Data
Properties and FeaturesSetting Properties and FeaturesSAX Properties and FeaturesValidationNamespacesInterning and entitiesDOM nodes and literal stringsProprietary Properties and Features
Using an EntityResolverUsing a DTDHandlerThe DefaultHandler Class
XMLFiltersXMLWriter
LexicalHandlerDeclHandler
Return Values from an EntityResolverDTDHandler and ValidationParsing on the Reader Instead of the Filter
The Document Object ModelLanguage BindingsThe BasicsWhy Not SAX?SAX is sequentialSAX siblingsWhy use SAX at all?
Getting a DOM ParserDOM Parser OutputDOMSerializerGetting startedLaunching serializationWorking with nodesThe Results
Memory, Performance, and Deferred DOMsPolymorphism and the Node InterfaceDOM Parsers Throwing SAX Exceptions
ChangesCreating a New DOM TreeModifying a DOM Tree
Branching OutTraversalNodeIteratorTreeWalkerRangeEvents, Views, and StyleEventsViewsStyleHTMLOdds and Ends
The XML DeclarationNode ComparisonsBootstrapping
The Dreaded WRONG DOCUMENT ExceptionCreating, Appending, and Inserting
The BasicsJava Collections SupportConcrete Classes and FactoriesInput and Output
Java Properties FilesConverting to XMLCreating XML with JDOMOutputting XML with JDOM
Storing XMLLoading XMLTaking a Test DriveBacktracking
JDOM as a JSRSAX and DOM as Standards
JDOM isn’t DOMNull Return ValuesDOMBuilder
Helpful JDOM InternalsThe Text ClassThe EntityRef ClassThe Namespace Class
Creating a FactoryBuilding with Custom Classes
JDOMNodeImplementing ClassesProviding Support for XPathEndgame
More on SubclassingCreating Invalid XML
API or AbstractionSun’s JAXP and ParserThe Old and the New
Starting with SAXA look at the SAXParserFactory classWorking with the SAXParser classDealing with DOMA look at the DOM parser factoryWorking with the DOM parserChanging the Parser
Updating the StandardsThe road to SAX 2.0Changes in SAX classesUpdates to the DOMThe TrAX APIWorking with the factoryTransforming XMLOdds and ends
Default Parsers and JAXP ImplementationsFeatures on Factories, Properties on Parsers
Selecting a FrameworkStabilityIntegration with Other XML Tools and APIsProduction PresenceMaking the Decision
Source Code or BinariesConfiguring the Servlet Engine
Viewing XML Converted to HTMLViewing PDFs from XMLBrowser-Dependent StylingWAP and XML
Creating an XSP PageUsing XSP Tag Libraries
Servlet Engine MappingsThe SitemapProducers and Processors
RPC Versus RMIWhat Is RMI?What Is RPC?XML-RPC
XML-RPC LibrariesWriting the HandlerWriting the ServerWriting the ClientTalk to Me
A Shared HandlerA Configurable ServerA Useful ClientTalk to Me (Again)
Where’s the XML in XML-RPC?Shared InstancesTo Servlet or Not To Servlet
Starting OutThe EnvelopeEncodingInvocation
Other OptionsWhat about IBM SOAP4J?Isn’t Microsoft a player?What’s Axis?InstallationThe clientThe serverThe router servlet and admin client
RPC or Messaging?An RPC ServiceCode artifactsDeployment descriptorsDeploying the serviceAn RPC Client
Custom Parameter TypesBetter Error Handling
Web Services
A Messaging ServiceRegistering with UDDISearching a UDDI RegistryWSDLWriting a ClientWhere Do I Go From Here?
The Foobar Public LibraryEvaluating the RequirementsEntering the BooksProviding a Listing of Available Books
Filtering XML DataXSLT from a Servlet
Rich Site SummaryCreating an XML RSS DocumentTaking a Test DriveWhat Happened to Netcenter?
First PrinciplesClass GenerationUnmarshallingMarshallingUse Cases
InstallationSource GenerationMarshalling and Unmarshalling
InstallationClass GenerationMarshalling and Unmarshalling
InstallationClass GenerationMarshalling and Unmarshalling
XLink
SAX 2.0Package: org.xml.saxAttributeList [deprecated]AttributesContentHandlerDocumentHandlerDTDHandlerEntityResolverErrorHandlerHandlerBaseInputSourceLocatorParserSAXExceptionSAXNotRecognizedExceptionSAXNotSupportedExceptionSAXParseExceptionXMLFilterXMLReaderPackage: org.xml.sax.extDeclHandlerLexicalHandlerPackage: org.xml.sax.helpersAttributeListImplAttributesImplDefaultHandlerLocatorImplNamespaceSupportParserAdapterParserFactoryXMLFilterImplXMLReaderAdapterXMLReaderFactory
Package: org.w3c.domAttrCDATASectionCharacterDataCommentDocumentDocumentFragmentDocumentTypeDOMExceptionDOMImplementationElementEntityEntityReferenceNamedNodeMapNodeNodeListNotationProcessingInstructionText
Package: javax.xml.parsersDocumentBuilderDocumentBuilderFactoryFactoryConfigurationErrorParserConfigurationExceptionSAXParserSAXParserFactoryPackage: javax.xml.transformErrorListenerOutputKeysResultSourceSourceLocatorTemplatesTransformerTransformerFactoryURIResolverPackage: javax.xml.transform.domPackage: javax.xml.transform.saxPackage: javax.xml.transform.stream
Package: org.jdomAttributeCDATACommentDocTypeDocumentElementEntityRefJDOMExceptionNamespaceProcessingInstructionTextPackage: org.jdom.adaptersAbstractDOMAdapterDOMAdapterPackage: org.jdom.inputBuilderErrorHandlerDOMBuilderJDOMFactorySAXBuilderPackage: org.jdom.output
Core FeaturesNamespace ProcessingNamespace Prefix ReportingString InterningValidationProcess External Entities (General)Process External Entities (Parameter)
Lexical HandlerDeclaration HandlerDOM NodeLiteral (XML) String

Content preview from Java and XML, Second Edition

Castor

The first data binding framework I will discuss is Castor, hosted online at http://castor.exolab.org. This framework has been around for quite a while, and the latest release as of this writing was Version 0.92. First, it should be made clear that Castor provides quite a bit more than just XML data binding. The package provides bindings in Java for more than just XML; you can also work with LDAP objects, OQL for mapping SQL queries to objects, as well as Java Data Objects (JDO), a fairly new specification from Sun dealing with Java-to-RDBMS (relational database management system) persistence. However, this is an XML book, so I’m only going to talk about the XML bindings.

Installation

To get ready to use Castor, you’ll need to download a release from the download page: http://castor.exolab.org/download.html. That page has links to the Exolab FTP site (or you can FTP in manually, as I did), and lists the files available. I’d recommend getting the full release (in the event you want to play with OQL or JDO later), named castor-0.9.2.zip or castor-0.9.2.tgz. Extract the jar files from that archive, add them to your classpath, and you’re ready to go.^[27]

Note

In this and subsequent examples, I’ve assumed that you still have a SAX-compliant XML parser, like Xerces, on your classpath in addition to the libraries discussed in this chapter. If you don’t, add xerces.jar or your parser’s jar file(s) to the classpath in addition to the data binding framework you are using.