book

Java and XML, 3rd Edition

by Brett McLaughlin, Justin Edelson

December 2006

Intermediate to advanced

479 pages

13h 52m

English

O'Reilly Media, Inc.

Read now

Unlock full access

OrganizationConventions Used in This BookUsing Code ExamplesWe’d Like Your Feedback!Safari® EnabledAcknowledgmentsBrett D. McLaughlinJustin Edelson
XML 1.0The Root ElementElementsAttributesNamespacesEntity ReferencesUnparsed DataXML 1.1XML TransformationsXSLXSL and treesFormatting objectsXSLTXPathTemplate matchingLoopingPerforming a transformAnd More...
DTDsDTD SemanticsElementsAttributesEntitiesGenerating DTDs from XML Instance DocumentsValidating XML Against a DTDXML SchemaXML Schema DefinitionsElements and attributesSimple typesExtending base typesGenerating XML Schemas from Instance DocumentsGenerating XML Schemas from a DTDValidating XML Against an XML SchemaReferencing a schema for nonnamespaced documentsReferencing a schema for namespaced documentsValidating against a schemaRELAX NGConstraining XML with RELAX NGElementsCardinality and recurrenceAttributesData typesGenerating RELAX NG from an XML InstanceConverting DTDs to RELAX NG SchemasConverting XML Schemas to RELAX NG SchemasValidating XML Against a RELAX NG Schema
Setting Up SAXCallbacks and Event-Based ProgrammingThe SAX APISAX Parsing SetupParsing with SAXInstantiating a ReaderParsing the DocumentUsing InputSource for inputNot much going on...Content HandlersThe Document LocatorThe Beginning and the End of a DocumentProcessing InstructionsNamespace CallbacksElement CallbacksElement DataSequencing mixupsWhitespaceIgnorable WhitespaceEntitiesThe ResultsError HandlersWarningsNonfatal ErrorsFatal ErrorsBreaking the Data
Properties and FeaturesSetting Properties and FeaturesError HandlingResolving EntitiesNotations and Unparsed EntitiesThe DefaultHandler ClassExtension InterfacesLexicalHandlerDeclHandlerAttributes2, Locator2, and EntityResolver2Filters and WritersXMLFiltersXMLWriter
The Document Object ModelDOM Levels and ModulesDOM ConceptsWhen SAX SucksSerializationGetting a DOM ParserThe DOM Document ObjectSerializer PreliminariesWorking with NodesDocument nodesAccessing the XML declarationElement nodesText and CDATA nodesComment nodesProcessing instruction nodesDocumentType nodesEntity Reference nodesThe ResultsModifying and Creating XMLSetting Up an Input ServletCreating a New DOM TreeBootstrapping with DOM Level 3Modifying a DOM TreeTraversing a DOM TreeNamespaces
Checking for Module SupportRequesting Feature Support in DOM Level 3DOM Level 2 ModulesTraversalSelecting nodesWalking filtered DOM treesRangeEvents, Views, and StyleEventsViewsStyleHTMLDOM Level 3 ModulesLoad and SaveReading XML documentsWriting XML documentsValidationNode types supporting validationEnforcing validity as you workChecking for valid operationsChecking for state validity
More Than an APIXML Parsing and ValidationXSL ProcessingXPathParsing XMLReading XML with SAXCreating a parser factoryConfiguring the factoryObtaining a parserParsing with JAXP and SAXAccessing XMLReader directly From SAXParserFactory to DOMBuilderFactoryDOM factory configuration optionsChanging the Parser ImplementationProcessing XSLBasic TransformationsCreating a transformerThe Identity TransformationCaching Transformation InstructionsChanging the Processor ImplementationXPathCreating an XPath InstanceXPath ExamplesNamespaces in XPathXPath VariablesXPath FunctionsXML ValidationCreating a SchemaFactoryRepresenting a Constraint Model in JavaValidating XMLFixing errors as they occurUsing ValidatorHandler to customize validation processingA Big Fat Caveat About JAXP Validation
StAX BasicsStAX Event TypesObtaining a StAX ImplementationStAX FactoriesParsing with StAXCreating a ReaderXMLStreamReaderThe START_DOCUMENT eventParsing the rest of the documentGetting character dataWhitespace handlingTwo more eventsXMLEventReaderXMLEventReader advantagesOther Traversal OptionsnextTag()require()peek()StAX FiltersDocument Output with StAXXMLStreamWriterNamespace supportXMLEventWriterFactory PropertiesBoolean Properties of XMLInputFactoryObject Properties of XMLInputFactoryXMLResolverXMLReporterXMLEventAllocatorXMLOutputFactoryCommon Issues with StAXXmlPull

The BasicsJava Collections SupportConcrete Classes and FactoriesUseful Return ValuesInput and OutputThe JDOM DistributionPropsToXMLJava Properties FilesConverting to XMLCreating XML with JDOMOutputting XML with JDOMThe Format classOther uses of XMLOutputterXMLPropertiesStoring XMLLoading XMLTaking a Test DriveBacktrackingMore JDOM ClassesThe Namespace ClassXSL Transformations with JDOMXPath and JDOMJDOM FiltersElementFilterContentFilterNegateFilterOrFilter and AndFilterThe EntityRef ClassJDOM and FactoriesCreating a FactoryBuilding with Custom ClassesUncheckedJDOMFactoryCommon Issues with JDOMWhat Parser Am I Using?JDOM Isn’t DOMNull Return ValuesNodes Have Only One ParentMore on SubclassingCreating Invalid XML
OverviewCore dom4jFactoriesdom4j FeaturesXPath supportSupport for Visitor PatternObject-orientated transformation APIThe dom4j DistributionReading and Writing with dom4jParsing a DocumentCreating a Document ObjectNamespaces and qualified namesDocument OutputFormatting optionsOutputting to other APIsDocument TraversalIterator, Lists, and Index-Based AccessXPathUsing the Visitor PatternTransformationsTrAXRule-Based TransformationsSpecial-Purpose FactoriesDOMDocumentFactoryIndexedDocumentFactoryBeanDocumentFactory
Data Binding BasicsData Binding and SchemasWhen to (and When Not to) Use Data BindingIntroducing JAXBJAXB 1.0JAXB 2.0JAXB Reference ImplementationsJava WSDPDownloading Java WSDPDownloading JAXB 2.0 reference implementationContentsUsing JAXBJAXBContextCompiling a SchemaCompiling with xjcJAXB 1.0-generated filesJAXB 2.0-generated filesJAXB AnnotationsClass-level annotationsXmlRootElementXmlAccessorTypeXmlTypeField-level annotationsXmlElementXmlAttributePackage-level annotationsSchema generationMarshallingBidirectional DOM supportMarshaller propertiesUnmarshallingUnmarshall-time validationUnmarshaller propertiesValidationValidation eventsSchema Compilation CustomizationInline declarationsExternal declarationBinding declarationsJAXB CallbacksClass-defined callbacksExternal listenerOther Binding FrameworksXMLBeansCastor
What Is RSS?RSS VariantsRSS ModulesDublin CoreSyndicationContentCommentAPIiTunesAtomCreating an RSS FeedIntroducing ROMEROME data modelsOutputting a ROME feedCreating a Feed with ROMEReading an RSS FeedFeed Input with ROMEBuilding a Simple AggregatorModules with ROMECreating a Podcast RSS FeediTunes categoriesCreating a ROME ModuleThe ICBM module
XML and the Model-View-Controller PatternXML in MVC Web ApplicationsTransforming to HTML with JSPJSTL XML TagsUsing XSLTPerforming Client-Side TransformationsUsing processing instructionsTransforming with JavaScriptPerforming Server-Side TransformationsTransforming in a filterTransforming with JSTLAjaxXMLHttpRequestUsing DOM with AjaxUsing XSLT with AjaxPosting XML to the ServerCreating an XML document in JavaScriptSubmitting the XML documentFlashActionScriptFlexXML in ActionScript 3.0E4XXML data providersSending and loading XMLUsing Flash XML socketsCross-Domain Access
XML AppliancesXML DatabasesXQueryFast InfosetAnd Many More...
Core FeaturesExternal General Entity ProcessingExternal Parameter Entity ProcessingStandaloneParameter Entity ReportingNamespace ProcessingNamespace Prefix ReportingAbsolute URI Declaration ResolutionString InterningUnicode Normalization CheckingAttributes2 UsageLocator2 UsageEntityResolver2 UsageValidationReport Namespace on xmlns AttributesXML 1.1 SupportCore PropertiesDeclaration HandlerDocument VersionDOM NodeLexical HandlerLiteral (XML) String

Content preview from Java and XML, 3rd Edition

Chapter 10. dom4j

Like JDOM, which was explored in the last chapter, dom4j is designed to be a Java-specific alternative to DOM—a document object model that is targeted only at Java (thus the repeated use of the letter J) and isn’t constrained by language neutrality in the way DOM is. Since dom4j and JDOM share this common goal, portions of the APIs look similar. However, the two APIs do differ on a key design principal in that dom4j is built around a set of core interfaces, whereas JDOM is class-orientated. What this means in practice is that there are various implementations of the core dom4j interfaces that provide different functionality. Through this, dom4j’s behavior can be tuned to match the needs of your application.

Also like JDOM, dom4j is an open source project with a vibrant user community that you can join to receive assistance with the API and contribute to the future of dom4j. Full details on dom4j can be found at http://www.dom4j.org.

Overview

With that brief introduction to dom4j, let us begin by looking at the interfaces and classes that make up dom4j. We’ll start with the core interfaces and then examine some of the special features those interfaces have that set dom4j apart from other similar APIs.

Core dom4j

As I mentioned above, dom4j is built around a set of core interfaces. These interfaces describe the structure and content of an XML document. Figure 10-1 contains a UML model of these core interfaces.

Figure 10-1. UML model of dom4j core interfaces

As you can ...