翻译文献第二章 创建xml

外文原文CHAPTER2CREATINGXMLNOWTHATYOUHAVEAGREATERUNDERSTANDINGOFXML,HOWITCANBEUSED,ANDSOMEOFTHEJAVAAPISAVAILABLE,ITSTIMETOTURNCONCEPTSINTOPRACTICEALTHOUGHTHISBOOKISNOTBYANYMEANSADEFINITIVEGUIDETOXMLSYNTAX,OREVENANXMLREFERENCE,ITWOULDBEIMPOSSIBLETODISCUSSHOWTOPARSEANDMANIPULATEXMLDOCUMENTSWITHOUTFIRSTBEINGABLETOCREATETHOSEDOCUMENTSINADDITION,THEJAVAAPISFORHANDLINGXMLALLASSUMEAFAIRAMOUNTOFFAMILIARITYWITHXMLSYNTAXANDSTRUCTURE,ASWELLASWITHTHEDESIGNPATTERNSTHATGOINTOCREATINGANXMLDOCUMENT,CONSTRAININGIT,ANDTRANSFORMINGITTHEREFOREWELOOKATEACHOFTHESETASKSBEFOREDISCUSSINGTHECORRESPONDINGJAVAAPISTOBEGIN,WEWILLTAKEACLOSERLOOKATXMLSYNTAXINTHISCHAPTERSTARTINGWITHTHEVERYBASICXMLCONSTRUCTS,WEWILLDISCUSSWHATAWELLFORMEDXMLDOCUMENTISANDHOWTOCREATEONETHEVARIOUSXMLRULESANDSYNTACTICAL“GOTCHAS“WILLBECOVEREDTOHELPYOUBUILDXMLDOCUMENTSTHATARENOTONLYLEGAL,BUTCANBEUSEDINREALISTICAPPLICATIONSALLTHISWORKWILLSETTHESTAGEFORWRITINGOURFIRSTJAVAPROGRAMINTHENEXTCHAPTERTOUNDERSTANDHOWPARSINGXMLWORKS,ANDHOWJAVAPROVIDESCALLBACKSINTOTHEPARSINGPROCESSIFYOUHAVEEVERREADACHAPTEROREVENABOOKONAPROGRAMMINGLANGUAGESSYNTAX,YOUPROBABLYREALIZEITISUSUALLYPRETTYDRYREADINGTOTRYANDAVOIDTHIS,WEWILLLOOKATSYNTAXINABITOFADIFFERENTLIGHTTHANYOUMAYBEUSEDTORATHERTHANSTARTINGWITHASIMPLEONEORTWOLINEXMLFILEANDADDINGTOIT,WHICHTYPICALLYMAKESFORALENGTHY,USELESSFILEATTHEENDOFTHEEXERCISE,WEWILLLOOKATACOMPLETE,USABLE,RELATIVELYCOMPLEXXMLFILETHEFILEWEWILLUSEISAPORTIONOFTHEACTUALXMLDOCUMENTTHATREPRESENTSTHETABLEOFCONTENTSPAGEFORTHISBOOKWEWILLWALKTHROUGHTHISDOCUMENTLINEBYLINE,EXAMININGTHEDIFFERENTCONSTRUCTSWHATALOTOFSYNTACTICALDISCUSSIONSIGNOREISTHATINTHEREALWORLD,YOUALMOSTNEVERGETTOSEETHESIMPLEFILESTHATARESOOFTENUSEDASEXAMPLESINSTEAD,YOUSEECOMPLEXFILESTHATDONTMAKEANYSENSETOYOU,EVENAFTERREADINGABOOKYOUSHOULDGETUSEDTOSEEINGANXMLFILEWITHALLITSCONSTRUCTS,ANDBEGINTOLEARNITSSTRUCTURETHROUGHPRACTICALEXAMPLESHOPEFULLYTHISMAKESTHEDISCUSSIONATLEASTALITTLEMOREAPPLICABLEFORYOU,IFNOTSOMEWHATLESSDRYBEFOREWEBEGIN,ONEFINALOBSERVATIONTHISCHAPTERDOESNTTRYTOBEAREFERENCEINOTHERWORDS,ITDOESNTHAVEEACHTERMWITHADEFINITION,ANDITDOESNTHAVEANUTSHELLTYPEENTRYSYSTEMINSTEAD,ITISAPROGRESSIVECHAPTERDEFINITIONSAREGIVENINCONTEXTOFTHEEXAMPLESANDWHATHASALREADYBEENSAIDABOUTOTHERCONSTRUCTS,RATHERTHANEACHDEFINITIONSTANDINGALONEYOUSHOULDHAVEAGOODXMLREFERENCENEARBYFORTHERESTOFTHISBOOK,ASWEWILLNOTEXPLAINCONSTRUCTSWEGOOVERINTHISCHAPTERAGAININTHELATTERPARTOFTHEBOOK,SOWECANGETTOMOREADVANCEDTOPICSYOUMIGHTWANTTOPICKUPTHEXMLPOCKETREFERENCEBYROBERTECKSTEINOREILLY22THECONTENTWITHOURHEADERWORKEDOUT,WENOWCANMOVEONTOTHEACTUALDATACONTENTINOURXMLDOCUMENTTHISCONSISTSOFALLTHEELEMENTS,ATTRIBUTES,ANDTEXTUALDATAWITHINTHESECONSTRUCTS221THEROOTELEMENTTHEROOTELEMENTISTHEHIGHESTLEVELELEMENTINTHEXMLDOCUMENT,ANDMUSTBETHEFIRSTOPENINGTAGANDTHELASTCLOSINGTAGWITHINTHEDOCUMENTITPROVIDESAREFERENCEPOINTTHATENABLESANXMLPARSERORXMLAWAREAPPLICATIONTORECOGNIZEABEGINNINGANDENDTOANXMLDOCUMENTINOUREXAMPLE,THEROOTELEMENTISTHISTAGANDITSMATCHINGCLOSINGTAGSURROUNDALLOTHERDATACONTENTWITHINTHEXMLDOCUMENTXMLSPECIFIESTHATTHEREMAYONLYBEONEROOTELEMENTINADOCUMENTINOTHERWORDS,THEROOTELEMENTMUSTENCLOSEALLOTHERELEMENTSWITHINTHEDOCUMENTASIDEFROMTHISREQUIREMENT,AROOTELEMENTDOESNOTDIFFERFROMANYOTHERXMLELEMENTITSIMPORTANTTOUNDERSTANDTHIS,BECAUSEXMLDOCUMENTSCANREFERENCEANDINCLUDEOTHERXMLDOCUMENTSINTHESECASES,THEROOTELEMENTOFTHEREFERENCEDDOCUMENTBECOMESANENCLOSEDELEMENTINTHEREFERRINGDOCUMENT,ANDMUSTBEHANDLEDNORMALLYBYANXMLPARSERDEFININGROOTELEMENTSASSTANDARDXMLELEMENTSWITHOUTSPECIALPROPERTIESORBEHAVIORALLOWSDOCUMENTINCLUSIONTOWORKSEAMLESSLY222IDENTIFYINGXMLWITHNAMESPACESALTHOUGHWEWILLNOTDELVEDEEPLYINTOXMLNAMESPACESHERE,YOUSHOULDNOTETHEUSEOFANAMESPACEINTHEROOTELEMENTYOUPROBABLYOBSERVEDTHATALLOFTHEXMLELEMENTSNAMESAREPREFIXEDWITHJAVAXMLINOURXMLEXAMPLE,ITMAYBENECESSARYLATERTOINCLUDEPORTIONSOFOTHEROREILLYBOOKSBECAUSEEACHOFTHESEBOOKSMAYALSOHAVE,ORTAGS,THEDOCUMENTMUSTBEDESIGNEDANDCONSTRUCTEDINAWAYTOAVOIDNAMESPACECOLLISIONPROBLEMSWITHOTHERDOCUMENTSTHEXMLNAMESPACESSPECIFICATIONNICELYSOLVESTHISPROBLEMBECAUSEOURXMLDOCUMENTREPRESENTSASPECIFICBOOK,ANDNOOTHERXMLDOCUMENTSHOULDREPRESENTTHESAMEBOOK,USINGAPREFIXLIKEJAVAXMLCANASSOCIATETHEELEMENTTOANAMESPACETHENAMESPACESPECIFICATIONREQUIRESTHATAUNIQUEURIBEASSOCIATEDWITHTHEPREFIXTODISTINGUISHTHEELEMENTSINTHENAMESPACEFROMELEMENTSINOTHERNAMESPACESAURLISRECOMMENDED,WHICHISWHATISSUPPLIEDHEREHTTP/WWWOREILLYCOM/CATALOG/JAVAXML,THEWEBSITEFORTHEBOOKONCETHENAMESPACEISDEFINEDLIKETHIS,ITCANTHENBEREFERENCEDBYANYOTHERELEMENTWITHINTHEXMLDOCUMENTINOURCASE,WEUSEITFORALLOFTHEELEMENTSBECAUSETHEYAREALLPARTOFTHEBOOKSNAMESPACETHEPROPERWAYTOASSOCIATEANELEMENTWITHANAMESPACEISTOPREFIXTHENAMEOFTHEELEMENTWITHTHENAMESPACEPREFIXANDACOLONINTRODUCTIONWHATISITHOWDOIUSEITWHYSHOULDIUSEITWHATSNEXTEACHOFTHESEELEMENTSISTREATEDBYTHEXMLPARSERASPARTOFTHEHTTP/WWWOREILLYCOM/CATALOG/JAVAXML/NAMESPACE,ANDWILLNOTRESULTINCOLLISIONSWITHANYOTHERELEMENTSNAMEDCHAPTER,HEADING,ORTOPICWITHINOTHERNAMESPACESMULTIPLENAMESPACEDECLARATIONSCANBEINCLUDEDINTHESAMEDOCUMENT,ALLWITHINTHESAMEELEMENTALTHOUGHTHISISALEGALDECLARATION,BEVERYCAREFULWHENUSINGMULTIPLENAMESPACESWITHINONEDOCUMENTOFTEN,THEBENEFITSOFUSINGNAMESPACESCANBEOUTWEIGHEDBYTHEADDITIONALCLUTTERANDTEXTUALDATATHEYADDTOTHEDOCUMENTGENERALLY,ASINGLENAMESPACEFORASINGLEDOCUMENTPROVIDESACLEAR,CLEANXMLDOCUMENTWHILESTILLAVOIDINGNAMESPACECOLLISIONSTHEONLYNOTABLEEXCEPTIONISWHENANOTHERXMLSPECIFICATIONSUCHASXMLSCHEMAISUSEDANDTHATNAMESPACEMUSTBEREFERENCEDAFINALINTERESTINGANDSOMEWHATCONFUSINGPOINTXMLSCHEMA,WHICHWEWILLTALKABOUTMOREINCHAPTER4,REQUIRESTHESCHEMAOFANXMLDOCUMENTTOBESPECIFIEDINAMANNERTHATLOOKSVERYSIMILARTOASETOFNAMESPACEDECLARATIONSSEEEXAMPLE22EXAMPLE22XMLDOCUMENTUSINGXMLSCHEMABRETTMCLAUGHLINBRETTMCLAUGHLINEARTHLINKNETEDDIEBALUCCIEDDIEBFREEWORLDNETSEVERALTHINGSHAPPENHERE,ANDITISIMPORTANTTOUNDERSTANDEACHFIRST,THEXMLSCHEMAINSTANCENAMESPACEISDEFINEDANDASSOCIATEDWITHAURLTHISNAMESPACE,ABBREVIATEDXSI,ISUSEDFORSPECIFYINGINFORMATIONINXMLDOCUMENTSABOUTASCHEMA,EXACTLYASWEAREDOINGHERETHUS,OURFIRSTLINEMAKESTHEELEMENTSINTHEXMLSCHEMAINSTANCEAVAILABLETOOURDOCUMENTFORUSETHENEXTLINEDEFINESTHENAMESPACEFORTHEXMLDOCUMENTITSELFBECAUSETHEDOCUMENTDOESNOTUSEANEXPLICITNAMESPACE,LIKEJAVAXMLINEARLIEREXAMPLES,THEDEFAULTNAMESPACEISDECLAREDTHEXMLNAMESPACESSPECIFICATIONDICTATESTHATEVERYELEMENTINANXMLDOCUMENTISINANAMESPACETHEDEFAULTNAMESPACEISTHENAMESPACETHATANELEMENTISASSOCIATEDWITHIFNOOTHERNAMESPACEISSPECIFIEDTHISMEANSTHATALLELEMENTSWITHOUTANEXPLICITNAMESPACEANDASSOCIATEDPREFIXALLOFTHEM,INTHISEXAMPLEWILLBEASSOCIATEDWITHTHISDEFAULTNAMESPACEWITHBOTHTHEDOCUMENTANDXMLSCHEMAINSTANCENAMESPACESDEFINEDLIKETHIS,WECANTHENACTUALLYDOWHATWEWANT,WHICHISTOASSOCIATEASCHEMAWITHTHISDOCUMENTTHESCHEMALOCATIONATTRIBUTE,WHICHBELONGSTOTHEXMLSCHEMAINSTANCENAMESPACE,ISUSEDTOACCOMPLISHTHISWEPREFACETHISATTRIBUTEWITHITSNAMESPACEXSI,WHICHWEJUSTDEFINEDTHEARGUMENTTOTHISATTRIBUTEISACTUALLYTWOURISTHEFIRSTSPECIFYINGTHENAMESPACEBEINGASSOCIATEDWITHASCHEMA,ANDTHESECONDTHEURIOFTHESCHEMATOREFERTOINOUREXAMPLE,THISRESULTSINTHEFIRSTURIBEINGTHEDEFAULTNAMESPACEWEJUSTDECLARED,ANDTHESECONDAFILEONTHELOCALFILESYSTEMCALLEDMYSCHEMAXSDLIKEANYOTHERXMLATTRIBUTE,THISENTIREPAIRISENCLOSEDINASINGLESETOFQUOTATIONMARKSANDASSIMPLEASTHAT,YOUHAVEREFERENCEDASCHEMAINYOURXMLDOCUMENTSERIOUSLY,THISISNOTSIMPLE,ANDISTODATEONEOFTHEMOSTMISUNDERSTOODPORTIONSOFUSINGNAMESPACESANDXMLSCHEMAWEWILLLOOKMOREATTHEMECHANICSUSEDHEREASWECONTINUEFORNOW,TRYTOUNDERSTANDHOWNAMESPACESALLOWELEMENTSFROMVARIOUSGROUPINGSTOBEUSED,YETREMAINIDENTIFIEDASAPARTOFTHEIRSPECIFICGROUPING223XMLDATAELEMENTSSOFARWEHAVEGLOSSEDOVERDEFININGWHATANACTUALELEMENTISNOWWEWILLTAKEANINDEPTHLOOKATELEMENTS,WHICHAREREPRESENTEDBYARBITRARYNAMESANDMUSTBEENCLOSEDINANGLEBRACKETSTHEREARESEVERALDIFFERENTVARIATIONSOFELEMENTSINTHESAMPLEDOCUMENT,ASSHOWNHEREWEBPUBLISHINGFRAMEWORKSTHEFIRSTRULEINCREATINGELEMENTSISTHATTHEIRNAMESMUSTSTARTWITHALETTERORUNDERSCORE,ANDTHENMAYCONTAINANYNUMBEROFLETTERS,NUMBERS,UNDERSCORES,HYPHENS,ORPERIODSTHEYMAYNOTCONTAINEMBEDDEDSPACESTHEFOLLOWINGISNOTWELLFORMEDXMLXMLELEMENTNAMESAREALSOCASESENSITIVEGENERALLY,USINGTHESAMERULESTHATGOVERNJAVAVARIABLENAMINGWILLRESULTINSOUNDXMLELEMENTNAMINGUSINGANELEMENTNAMEDTOREPRESENTTELECOMMUNICATIONSBUSINESSOBJECTNOTAGOODIDEABECAUSEITISCRYPTIC,WHILEANOVERLYVERBOSETAGNAMELIKEJUSTCLUTTERSUPADOCUMENTKEEPINMINDTHATYOURXMLDOCUMENTSWILLPROBABLYBESEENBYOTHERDEVELOPERSANDCONTENTAUTHORS,SOSELFDOCUMENTATIONTHROUGHGOODNAMINGISESSENTIALEVERYOPENEDELEMENTMUSTINTURNBECLOSEDTHEREARENOEXCEPTIONSTOTHISRULEASTHEREAREINMANYOTHERMARKUPLANGUAGES,LIKEHTMLANENDINGELEMENTTAGCONSISTSOFTHEFORWARDSLASHANDTHENTHEELEMENTNAMEBETWEENANOPENINGANDCLOSINGTAG,THERECANBEANYNUMBEROFADDITIONALELEMENTSORTEXTUALDATAHOWEVER,YOUCANNOTMIXTHEORDEROFNESTEDTAGSTHEFIRSTOPENEDELEMENTMUSTALWAYSBETHELASTCLOSEDELEMENTIFANYOFTHERULESFORXMLSYNTAXARENOTFOLLOWEDINANXMLDOCUMENT,THEDOCUMENTISNOTWELLFORMEDAWELLFORMEDDOCUMENTISONEINWHICHALLXMLSYNTAXRULESAREFOLLOWED,ANDALLELEMENTSANDATTRIBUTESARECORRECTLYPOSITIONEDHOWEVER,AWELLFORMEDDOCUMENTISNOTNECESSARILYVALID,WHICHMEANSTHATITFOLLOWSTHECONSTRAINTSSETUPONADOCUMENTBYITSDTDORSCHEMATHEREISASIGNIFICANTDIFFERENCEBETWEENAWELLFORMEDDOCUMENTANDAVALIDONETHERULESWEDISCUSSINTHISCHAPTERENSURETHATYOURDOCUMENTISWELLFORMED,WHILETHERULESDISCUSSEDINCHAPTER4ALLOWYOURDOCUMENTTOBEVALIDASANEXAMPLEOFADOCUMENTTHATISNOTWELLFORMED,CONSIDERTHISXMLFRAGMENTTHEORDEROFNESTINGOFTAGSISINCORRECT,ASTHEOPENEDISNOTFOLLOWEDBYACLOSINGWITHINTHESURROUNDINGTAG1ELEMENTHOWEVER,IFTHESESYNTAXERRORSARECORRECTED,THEREISNOGUARANTEETHATTHEDOCUMENTWILLBEVALIDTHISISANIMPORTANTDIFFERENCETOUNDERSTAND,ANDWEWILLREVISITTHESUBJECTINCHAPTER4WHILETHISEXAMPLEOFADOCUMENTTHATISNOTWELLFORMEDMAYSEEMSILLYANDTRIVIAL,REMEMBERTHATTHISWOULDBEACCEPTABLEHTML,ANDCOMMONLYOCCURSINLARGETABLESWITHINANHTMLDOCUMENTINOTHERWORDS,HTMLANDMANYOTHERMARKUPLANGUAGESDONOTREQUIREWELLFORMEDXMLDOCUMENTSXMLSSTRICTADHERENCETOORDERINGANDNESTINGRULESALLOWSDATATOBEPARSEDANDHANDLEDMUCHMOREQUICKLYTHANWHENUSINGMARKUPLANGUAGESWITHOUTTHESECONSTRAINTSTHELASTRULEWELOOKATISTHESLIGHTLYODDCASEOFEMPTYELEMENTSWEALREADYSAIDTHATXMLTAGSMUSTALWAYSBEPAIREDANOPENINGTAGANDACLOSINGTAGCONSTITUTEACOMPLETEXMLELEMENTTHEREARECASESWHEREANELEMENTISUSEDPURELYBYITSELF,LIKEAFLAGSTATINGACHAPTERISINCOMPLETE,ORWHEREANELEMENTHASATTRIBUTESBUTNOTEXTUALDATA,LIKEANIMAGEDECLARATIONINHTMLTHESEWOULDHAVETOBEREPRESENTEDASTHISISOBVIOUSLYABITSILLY,ANDALSOADDSMORECLUTTERTOWHATCANOFTENBEVERYLARGEXMLDOCUMENTSTHEXMLSPECIFICATIONPROVIDESAMEANSTOSIGNIFYBOTHANOPENINGANDCLOSINGELEMENTTAGWITHINONEELEMENTTHISNICELYSOLVESTHEPROBLEMOFUNNECESSARYCLUTTER,ANDSTILLFOLLOWSTHERULETHATEVERYXMLELEMENTMUSTHAVEAMATCHINGENDTAGITSIMPLYCONSOLIDATESBOTHSTARTANDENDTAGINTOASINGLETAG224ELEMENTATTRIBUTESINADDITIONTOTEXTCONTAINEDWITHINANELEMENTSTAGS,ANELEMENTCANALSOHAVEATTRIBUTESATTRIBUTESAREINCLUDEDWITHTHEIRRESPECTIVEVALUESWITHINTHEELEMENTSOPENINGDECLARATIONWHICHCANALSOBEITSCLOSINGDECLARATIONFOREXAMPLE,INTHEJAVAXMLCHAPTERTAG,THEFOCUSOFTHECHAPTERWASPARTWHATOFWASNOTEDINANATTRIBUTEINTHISEXAMPLE,FOCUSISTHEATTRIBUTENAMETHEVALUEISTHEFOCUSOFTHECHAPTER,XMLANDJAVA,RESPECTIVELYATTRIBUTENAMESMUSTFOLLOWTHESAMERULESASXMLELEMENTNAMES,ANDATTRIBUTEVALUESMUSTBEWITHINQUOTATIONMARKSALTHOUGHBOTHSINGLEANDDOUBLEQUOTESAREALLOWED,USINGDOUBLEQUOTESISAWIDELYUSEDSTANDARDANDRESULTSINXMLDOCUMENTSTHATMODELJAVAPROGRAMMINGPRACTICESADDITIONALLY,SINGLEANDDOUBLEQUOTATIONMARKSMAYBEUSEDINATTRIBUTEVALUESSURROUNDINGTHEVALUEINDOUBLEQUOTESALLOWSSINGLEQUOTESTOBEUSEDASPARTOFTHEVALUE,ANDSURROUNDINGTHEVALUEINSINGLEQUOTESALLOWSDOUBLEQUOTESTOBEUSEDASPARTOFTHEVALUETHISISGOODPRACTICE,THOUGH,ASXMLPARSERSANDPROCESSORSOFTENUNIFORMLYCONVERTTHEQUOTESROUNDANATTRIBUTESVALUETOALLDOUBLEORALLSINGLEQUOTES,POSSIBLYINTRODUCINGUNEXPECTEDRESULTSINADDITIONTOHOWTOUSEATTRIBUTES,THEREISANISSUEOFWHENTOUSEATTRIBUTESBECAUSEXMLALLOWSSUCHVARIETYOFDATAFORMATTING,ITISRARETHATANATTRIBUTECANNOTBEREPRESENTEDBYANELEMENT,ORTHATELEMENTCOULDNOTEASILYBECONVERTEDTOANATTRIBUTEALTHOUGHTHEREISNOSPECIFICATIONORWIDELYACCEPTSTANDARDFORDETERMININGWHENTOUSEANATTRIBUTEANDWHENTOUSEANELEMENT,HEREISAGOODRULEOFTHUMBUSEELEMENTSFORPRESENTABLEDATAANDATTRIBUTESFORSYSTEMDATAIFHAVEAPIECEOFDATATHATISGOINGTOBEPRESENTEDTOACLIENT,ORANAPPLICATION,ORUSEDASPARTOFFORMULA,THEDATAMOSTLIKELYBELONGSINANELEMENTITCANTHENBETREATEDPRIMARILYASAPPLICATIONDATAANDISEASILYSEARCHABLEANDUSABLEEXAMPLESARETHETITLESOFABOOKSCHAPTERS,THEPRICEOFFURNITURE,ORTHEURLOFACOMPANYSWEBSITEHOWEVER,IFTHEDATAISUSEDASAGROUPING,LETANAPPLICATIONKNOWHOWTOHANDLEAPORTIONOFDATA,ORISNEVERDIRECTLYVISIBLETOACLIENTORXMLAWAREAPPLICATION,ITMOSTLIKELYBELONGSASANATTRIBUTEEXAMPLESOFGOODCANDIDATESFORATTRIBUTEARETHESECTIONOFACHAPTERWHILETHESECTIONITEMITSELFMIGHTBEANELEMENTANDHAVEITSOWNTITLE,THEGROUPINGOFCHAPTERSWITHINASECTIONISEASILYREPRESENTEDBYASECTIONATTRIBUTEWITHINTHEJAVAXMLCHAPTERELEMENTTHISATTRIBUTEWOULDALLOWEASYGROUPINGANDINDEXINGOFCHAPTERS,BUTWOULDNEVERBEDIRECTLYDISPLAYEDTOTHEUSERANOTHERGOODEXAMPLEOFAPIECEOFDATATHATCOULDBEREPRESENTEDINXMLASANATTRIBUTEISIFAPARTICULARTABLEORCHAIRISONLAYAWAYTHISINSTRUCTIONCOULDLETANXMLAPPLICATIONUSEDTOGENERATEABROCHUREORFLYERKNOWNOTTOINCLUDEITEMSONLAYAWAYINCURRENTSTOCKAGAIN,THEAPPLICATIONCLIENTWOULDNEVERDIRECTLYSEETHISINFORMATION,BUTTHEDATAWOULDBEUSEDINPROCESSINGANDHANDLINGTHEXMLDOCUMENTIFAFTERALLOFTHISANALYSISYOUARESTILLUNSURE,YOUCANALWAYSPLAYITSAFEANDUSEANELEMENTYOUMAYHAVEALREADYCOMEUPWITHALTERNATEWAYSTOREPRESENTTHESEVARIOUSEXAMPLES,USINGDIFFERENTAPPROACHESFOREXAMPLE,RATHERTHANUSINGASECTIONATTRIBUTE,ITMIGHTMAKESENSETONESTJAVAXMLCHAPTERELEMENTSWITHINAJAVAXMLSECTIONELEMENTPERHAPSANEMPTYTAG,MIGHTBEMOREUSEFULTOMARKFURNITURETHATISONLAYAWAYINXML,THEREISRARELYONLYONEWAYTOPERFORMDATAREPRESENTATION,ANDOFTENSEVERALGOODWAYSTOACCOMPLISHTHESAMETASKMOSTOFTENTHEAPPLICATIONANDUSEOFTHEDATADICTATESWHATMAKESTHEMOSTSENSERATHERTHANTRYTOTELLYOUHOWTOWRITEXML,WHICHWOULDBEDIFFICULT,WEWILLUSEXML,ANDINTHATUSEYOUWILLHOPEFULLYGAININSIGHTINTOHOWDIFFERENTDATAFORMATSCANBEHANDLEDANDUSEDTHISWILLTHENGIVEYOUTHEKNOWLEDGETOMAKEYOUROWNDECISIONSABOUTFORMATTINGXMLDOCUMENTS225REFERRINGTOXML“CONSTANTS“ONEITEMWEHAVENOTDISCUSSEDISESCAPINGCHARACTERS,ORREFERRINGTOOTHERCONSTANTTYPEDATAVALUESFOREXAMPLE,ACOMMONWAYTOREPRESENTAPATHTOANINSTALLATIONDIRECTORYISORINBOTHTHESECASES,THEUSERWOULDREPLACETHETEXTWITHTHEAPPROPRIATECHOICEOFINSTALLATIONDIRECTORYINOUREXAMPLE,THECHAPTERTHATDISCUSSESWEBAPPLICATIONSNEEDSTOGIVESOMEDETAILSONINSTALLINGANDUSINGAPACHECOCOON,ANDMIGHTNEEDTOREPRESENTTHISDATAWITHINANELEMENTINSTALLINGCOCOONLOCATETHECOCOONPROPERTIESFILEINTHE/BINDIRECTORYTHEPROBLEMWITHTHISISTHATXMLPARSERSWILLATTEMPTTOHANDLETHISDATAASANXMLTAG,ANDTHENGENERATEANERRORBECAUSETHEREISNOCLOSINGTAGTHISISACOMMONPROBLEM,ASANYUSEOFANGLEBRACKETSRESULTSINTHISBEHAVIORENTITYREFERENCESPROVIDEAWAYTOOVERCOMETHESEPROBLEMSANENTITYREFERENCEISASPECIALDATATYPEINXMLTHATISUSEDTOREFERTOANOTHERPIECEOFDATATHEENTITYREFERENCECONSISTSOFAUNIQUENAME,PRECEDEDBYANAMPERSANDANDFOLLOWEDBYASEMICOLONWHENANXMLPARSERSEESANENTITYREFERENCE,THESUBSTITUTIONVALUESPECIFIEDISINSERTEDANDNOPROCESSINGOFTHATVALUEOCCURSXMLDEFINESFIVEENTITIESTOADDRESSTHEPROBLEMDISCUSSEDINTHEEXAMPLEFORTHELESSTHANBRACKET,FORTHEGREATERTHANBRACKET,FORTHEAMPERSANDSIGNITSELF,FORADOUBLEQUOTATIONMARK,ANDFORASINGLEQUOTATIONMARKORAPOSTROPHEUSINGTHESESPECIALREFERENCES,WECOULDTHENACCURATELYREPRESENTOURINSTALLATIONDIRECTORYREFERENCEASINSTALLINGCOCOONLOCATETHECOCOONPROPERTIESFILEINTHEPATHTOCOCOON/BINDIRECTORYONCETHISDOCUMENTISPARSED,THEDATAWILLBEINTERPRETEDASANDTHEDOCUMENTWILLSTILLBECONSIDEREDWELLFORMEDALSOBEAWARETHATENTITYREFERENCESAREUSERDEFINABLETHISALLOWSASORTOFSHORTCUTMARKUPINTHEXMLEXAMPLEWEHAVEBEENWALKINGTHROUGH,WEREFERENCEANEXTERNALSHAREDCOPYRIGHTTEXTBECAUSETHECOPYRIGHTISUSEDFORMULTIPLEOREILLYBOOKS,WEDONTWANTTOINCLUDETHETEXTWITHINTHISXMLDOCUMENTHOWEVER,IFTHECOPYRIGHTISCHANGED,OURDOCUMENTSHOULDREFLECTTHESECHANGESYOUMAYNOTICETHATTHESYNTAXUSEDINTHEXMLDOCUMENTLOOKSLIKETHEPREDEFINEDXMLENTITYREFERENCESALTHOUGHWEWONTSEEHOWTHEXMLPARSERISTOLDWHATTOREFERENCEWHENITSEESUNTILOURSECTIONONDTDS,YOUSHOULDSEETHATTHEREAREMOREUSESOFENTITYREFERENCESTHANJUSTREPRESENTINGDIFFICULTORUNUSUALCHARACTERSWITHINDATA226UNPARSEDDATATHELASTXMLCONSTRUCTTOLOOKATISTHECDATASECTIONMARKERACDATASECTIONISUSEDWHENASIGNIFICANTAMOUNTOFDATASHOULDBEPASSEDONTOTHECALLINGAPPLICATIONWITHOUTANYXMLPARSINGTHISCANBEUSEDWHENANUNUSUALLYLARGEAMOUNTOFCHARACTERSWOULDHAVETOBEESCAPEDUSINGENTITYREFERENCES,ORWHENSPACINGMUSTBEPRESERVEDINANXMLDOCUMENT,ACDATASECTIONLOOKSLIKETHISINSTALLCOCOONTO“/USR/LIB/COCOON“LOCATETHECORRECTPROPERTIESFILEDOWNLOADANTFROM“HTTP/JAKARTAAPACHEORG“USECVSFORTHISINTHISEXAMPLE,ALLOFTHEINFORMATIONWITHINTHECDATASECTIONDOESNOTHAVETOUSEENTITYREFERENCESOROTHERMECHANISMSTOALERTTHEPARSERTHATRESERVEDCHARACTERSAREBEINGUSEDINSTEAD,THEXMLPARSERPASSESTHEMUNCHANGEDTOTHEWRAPPINGPROGRAMORAPPLICATIONATTHISPOINT,WEHAVELOOKEDATTHEMAJORCOMPONENTSOFXMLDOCUMENTSALTHOUGHEACHHASONLYBEENLOOKEDATSOMEWHATINPASSING,THISSHOULDGIVEYOUENOUGHCOMFORTANDFAMILIARITYTORECOGNIZEXMLTAGSWHENYOUSEETHEMANDKNOWTHEIRGENERALPURPOSEASYOUUSEXMLDATAANDDOCUMENTSTHROUGHOUTTHISBOOK,YOUWILLGAINADDITIONALKNOWLEDGEABOUTTHESECONSTRUCTSTHROUGHTHEIRUSE,WHICHISAMUCHMOREEFFECTIVETEACHERTHANANYAMOUNTOFDRYDOCUMENTATION23WHATSNEXTWITHTHISPRIMERONCREATINGXMLDOCUMENTS,WEAREREADYTOBEGINWRITINGOURFIRSTJAVACODEINTHENEXTCHAPTER,WEWILLTAKEALOOKATUSINGTHESIMPLEAPIFORXMLSAXSTARTINGWITHASIMPLEPROGRAMTOPARSETHROUGHOURXMLDOCUMENT,WEWILLLEARNHOWPIS,ELEMENTS,ATTRIBUTES,ANDOTHERXMLCONSTRUCTSAREHANDLEDWITHINTHEXMLPARSINGPROCESSALONGWITHEACHSTEP,WEWILLPROVIDEJAVACODETOPERFORMSPECIFICACTIONS,BEGINNINGWITHASIMPLEPROGRAMTOPRINTOUTOURXMLDOCUMENTTHISWILLSTARTTHEEXTENSIVEPROCESSOFLEARNINGHOWTOMANIPULATEALLOFTHEVARIOUSCOMPONENTSOFANXMLDOCUMENT,ANDHOWTOUSETHISINFORMATIONWITHINJAVAAPPLICATIONS中文翻译第二章创建XML既然你已经对XML有了比较多的了解，诸如它的一些使用方法和可用的JAVAAPI，现在是转向实践的时候了。尽管这丰书从某种意义上来说并非是一本XML语法指南，也不是什么XML参考手册，但如果首先不会创建XML文档，那就不可能去讨论如何对XML文档进行解析和使用。此外，用于处理XML的JAVAAPI都假定你对XML语告和结构有相当程度的熟悉，井假定你还熟悉创建一个XML文档、对其进行限制、转换XML文档的设计方住。因此在讨论相应的JAVAAPI之前，需要先研究下这些工作。首先，在本章中要进一步地讨论XML语法。我们从非常基础的XML结构开始，讨论“什么是一个良构的XML文档“以及如何创建一个文档。我们将会涉及到各种XML规则和句法，以帮助你能够创建一些合盐而且可以应用在实际应用程序中的XML文档。所有这些工作都是为了在下一章中编写JAVA程序做准备的，以便你能够理解XML解析是如何工作的，以及JAVA是如何向解析过程提供回调函数的。如果你曾经读过一些有关编程