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 3. SAX

XML is fundamentally about data; programming with XML, then, has to be fundamentally about getting at that data. That process, called parsing, is the basic task of the APIs I’ll cover in the next several chapters. This chapter describes how an XML document is parsed, focusing on the events that occur within this process. These events are important, as they are all points where application-specific code can be inserted and data manipulation can occur.

I’m also going to introduce you to one of the two core XML APIs in Java: SAX, the Simple API for XML (http://www.saxproject.org). SAX is what makes insertion of this application-specific code into events possible. The interfaces provided in the SAX package are an important part of any programmer’s toolkit for handling XML. Even though the SAX classes are small and few in number, they provide a critical framework for Java and XML to operate within. Solid understanding of how they help in accessing XML data is critical to effectively leveraging XML in your Java programs.

Tip

For the impatient, the other of those two core APIs is DOM. Coverage of DOM begins in Chapter 5.

Setting Up SAX

I’m increasingly of the “learning is best done by doing” philosophy, so I’m not going to hit you with a bunch of concept and theory before getting to code. SAX is a simple API, so you only need to understand its basic model, and how to get the API on your machine; beyond that, code will be your best teacher.