/Users/andrea/_magisterarbeit/korpus/clean/testkorpus/29/file19.html NN ----------------------------------------- : Overview NN Package NN Class NN Tree NN Serialized VVD Deprecated VVN Index NN Help NN PREV NP PACKAGE NN NEXT IN PACKAGE NN FRAMES NNS NO DT FRAMES NNS Package NN javax NN . SENT xml NN . SENT transform VV This DT package NN defines VVZ the DT generic JJ APIs NP for IN processing VVG transformation NN instructions NNS , , and CC performing VVG a DT transformation NN from IN source NN to TO result VV . SENT See VV . SENT Description NN Interface NP Summary NN ErrorListener NP To TO provide VV customized JJ error NN handling NN , , implement VV this DT interface NN and CC use VV the DT setErrorListener JJR method NN to TO register VV an DT instance NN of IN the DT implmentation NN with IN the DT Transformer NN . SENT Result VV An DT object NN that WDT implements VVZ this DT interface NN contains VVZ the DT information NN needed VVD to TO build VV a DT transformation NN result NN tree NN . SENT Source NN An DT object NN that WDT implements VVZ this DT interface NN contains VVZ the DT information NN needed VVD to TO act VV as IN source NN input NN XML NP source NN or CC transformation NN instructions NNS . SENT SourceLocator NN This DT interface NN is VBZ primarily RB for IN the DT purposes NNS of IN reporting VVG where WRB an DT error NN occurred VVD in IN the DT XML NP source NN or CC transformation NN instructions NNS . SENT Templates NNS An DT object NN that WDT implements VVZ this DT interface NN is VBZ the DT runtime NN representation NN of IN processed JJ transformation NN instructions NNS . SENT URIResolver NP An DT object NN that WDT implements VVZ this DT interface NN that WDT can MD be VB called VVN by IN the DT processor NN to TO turn VV a DT URI NP used VVD in IN document NN , , xsl NN . SENT import NN , , or CC xsl NN . SENT include VV into IN a DT Source NN object NN . SENT Class NN Summary NN OutputKeys NNS Provides VVZ string NN constants NNS that WDT can MD be VB used VVN to TO set VV output NN properties NNS for IN a DT Transformer NN , , or CC to TO retrieve VV output NN properties NNS from IN a DT Transformer NN or CC Templates NNS object VVP . SENT Transformer NN An DT instance NN of IN this DT abstract JJ class NN can MD transform VV a DT source NN tree NN into IN a DT result NN tree NN . SENT TransformerFactory NP A NP TransformerFactory NP instance NN can MD be VB used VVN to TO create VV Transformer NN and CC Templates NNS objects NNS . SENT Exception NN Summary NN TransformerConfigurationException NN Indicates VVZ a DT serious JJ configuration NN error NN . SENT TransformerException NN This DT class NN specifies VVZ an DT exceptional JJ condition NN that WDT occured VVD during IN the DT transformation NN process NN . SENT Error NN Summary NN TransformerFactoryConfigurationError NP Thrown VVN when WRB a DT problem NN with IN configuration NN with IN the DT Transformer NN Factories NNS exists VVZ . SENT Package NN javax NN . SENT xml NN . SENT transform VV Description NN This DT package NN defines VVZ the DT generic JJ APIs NP for IN processing VVG transformation NN instructions NNS , , and CC performing VVG a DT transformation NN from IN source NN to TO result VV . SENT These DT interfaces NNS have VHP no DT dependencies NNS on IN SAX NN or CC the DT DOM NN standard NN , , and CC try VVP to TO make VV as IN few JJ assumptions NNS as IN possible JJ about IN the DT details NNS of IN the DT source NN and CC result NN of IN a DT transformation NN . SENT It PP achieves VVZ this DT by IN defining VVG Source NN and CC Result NN interfaces NNS . SENT To TO define VV concrete JJ classes NNS for IN the DT user NN , , the DT API NP defines VVZ specializations NNS of IN the DT interfaces NNS found VVN at IN the DT root NN level NN . SENT These DT interfaces NNS are VBP found VVN in IN javax NN . SENT xml NN . SENT transform VV . SENT sax NN , , javax NN . SENT xml NN . SENT transform VV . SENT dom NN , , and CC javax NN . SENT xml NN . SENT transform VV . SENT stream NN . SENT Creating VVG Objects NNS The DT API NP allows VVZ a DT concrete JJ TransformerFactory JJ object NN to TO be VB created VVN from IN the DT static JJ function NN TransformerFactory NN . SENT newInstance NN . SENT Specification NN of IN Inputs NNS and CC Outputs NNS This DT API NP defines VVZ two CD interface NN objects NNS called VVD Source NN and CC Result NN . SENT In IN order NN to TO pass VV Source NN and CC Result NN objects NNS to TO the DT interfaces NNS , , concrete JJ classes NNS must MD be VB used VVN . SENT Three CD concrete JJ representations NNS are VBP defined VVN for IN each DT of IN these DT objects NNS . SENT StreamSource NP and CC StreamResult NP , , SAXSource NP and CC SAXResult NP , , and CC DOMSource NP and CC DOMResult NP . SENT Each DT of IN these DT objects NNS defines VVZ a DT FEATURE NN string NN which WDT is VBZ i NP the DT form NN of IN a DT URL NP , , which WDT can MD be VB passed VVN into IN TransformerFactory NP . SENT getFeature NP java NP . SENT lang JJ . SENT String NN to TO see VV if IN the DT given VVN type NN of IN Source NN or CC Result NN object NN is VBZ supported VVN . SENT For IN instance NN , , to TO test VV if IN a DT DOMSource NP and CC a DT StreamResult NP is VBZ supported VVN , , you PP can MD apply VV the DT following VVG test NN . SENT TransformerFactory JJ tfactory NN TransformerFactory NN . SENT newInstance NN . SENT if IN tfactory NN . SENT getFeature NP DOMSource NP . SENT FEATURE NN tfactory NN . SENT getFeature NP StreamResult NP . SENT FEATURE NN . SENT . SENT . SENT Qualified JJ Name NN Representation NN Namespaces NP present JJ something NN of IN a DT problem NN area NN when WRB dealing VVG with IN XML NP objects NNS . SENT Qualified JJ Names NNS appear VVP in IN XML JJ markup NN as IN prefixed VVN names NNS . SENT But CC the DT prefixes NNS themselves PP do VVP not RB hold VV identity NN . SENT Rather RB , , it PP is VBZ the DT URIs NP that IN they PP contextually RB map VVP to TO that RB hold VV the DT identity NN . SENT Therefore RB , , when WRB passing VVG a DT Qualified JJ Name NN like IN xyz NP . SENT foo NP among IN Java NP programs NNS , , one PP must MD provide VV a DT means VVZ to TO map VV xyz NN to TO a DT namespace NN . SENT One CD solution NN has VHZ been VBN to TO create VV a DT QName NP object NN that WDT holds VVZ the DT namespace NN URI NP , , as RB well RB as IN the DT prefix NN and CC local JJ name NN , , but CC this DT is VBZ not RB always RB an DT optimal JJ solution NN , , as RB when WRB , , for IN example NN , , you PP want VVP to TO use VV unique JJ strings NNS as IN keys NNS in IN a DT dictionary NN object NN . SENT Not RB having VHG a DT string NN representation NN also RB makes VVZ it PP difficult JJ to TO specify VV a DT namespaced JJ identity NN outside IN the DT context NN of IN an DT XML NP document NN . SENT In IN order NN to TO pass VV namespaced JJ values NNS to TO transformations NNS , , for IN instance NN when WRB setting VVG a DT property NN or CC a DT parameter NN on IN a DT Transformer NN object NN , , this DT specification NN defines VVZ that IN a DT String NP qname NN object NN parameter NN be VB passed VVN as IN two CD part NN string NN , , the DT namespace NN URI NP enclosed VVN in IN curly JJ braces NNS , , followed VVN by IN the DT local JJ name NN . SENT If IN the DT qname NN has VHZ a DT null JJ URI NP , , then RB the DT String NP object NN only RB contains VVZ the DT local JJ name NN . SENT An DT application NN can MD safely RB check VV for IN a DT non JJ null NN URI NP by IN testing VVG to TO see VV if IN the DT first JJ character NN of IN the DT name NN is VBZ a DT character NN . SENT For IN example NN , , if IN a DT URI NP and CC local JJ name NN were VBD obtained VVN from IN an DT element NN defined VVN with IN xyz NP . SENT foo NP xmlns NNS . SENT xyz NN http NN . SENT xyz NP . SENT foo NP . SENT com NN yada NP baz NP . SENT html NN , , then RB the DT Qualified JJ Name NN would MD be VB http JJ . SENT xyz NP . SENT foo NP . SENT com NN yada NP baz NP . SENT html NP foo NP . SENT Note NN that IN the DT prefix NN is VBZ lost VVN . SENT Result NN Tree NN Serialization NN Serialization NN of IN the DT result NN tree NN to TO a DT stream NN can MD be VB controlled VVN with IN the DT Transformer NN . SENT setOutputProperties NNS java NP . SENT util NP . SENT Properties NNS and CC the DT Transformer NN . SENT setOutputProperty NP java NP . SENT lang JJ . SENT String NN , , java NP . SENT lang JJ . SENT String NN methods NNS . SENT These DT properties NNS only RB apply VVP to TO stream NN results NNS , , they PP have VHP no DT effect NN when WRB the DT result NN is VBZ a DT DOM NN tree NN or CC SAX NN event NN stream NN . SENT Strings NNS that WDT match VVP the DT XSLT JJ specification NN for IN xsl NN . SENT output NN attributes NNS can MD be VB referenced VVN from IN the DT OutputKeys NNS class NN . SENT Other JJ strings NNS can MD be VB specified VVN as RB well RB . SENT If IN the DT transformer NN does VVZ not RB recognize VV an DT output NN key NN , , a DT IllegalArgumentException NN is VBZ thrown VVN , , unless IN the DT key JJ name NN is VBZ namespace RB qualified VVN . SENT Output NN key NN names NNS that WDT are VBP namespace RB qualified VVN are VBP always RB allowed VVN , , although IN they PP may MD be VB ignored VVN by IN some DT implementations NNS . SENT If IN all DT that WDT is VBZ desired VVN is VBZ the DT simple JJ identity NN transformation NN of IN a DT source NN to TO a DT result NN , , then RB TransformerFactory NP provides VVZ a DT TransformerFactory NN . SENT newTransformer JJR method NN with IN no DT arguments NNS . SENT This DT method NN creates VVZ a DT Transformer NN that WDT effectively RB copies NNS the DT source NN to TO the DT result NN . SENT This DT method NN may MD be VB used VVN to TO create VV a DT DOM NN from IN SAX NN events NNS or CC to TO create VV an DT XML NP or CC HTML NP stream NN from IN a DT DOM NN or CC SAX NN events NNS . SENT Exceptions NNS and CC Error NN Reporting NP The NP transformation NN API NP throw VVP three CD types NNS of IN specialized JJ exceptions NNS . SENT A DT TransformerFactoryConfigurationError NP is VBZ parallel JJ to TO the DT FactoryConfigurationError NP , , and CC is VBZ thrown VVN when WRB a DT configuration NN problem NN with IN the DT TransformerFactory NP exists VVZ . SENT This DT error NN will MD typically RB be VB thrown VVN when WRB the DT transformation NN factory NN class NN specified VVN with IN the DT javax NN . SENT xml NN . SENT transform VV . SENT TransformerFactory JJ system NN property NN cannot NN be VB found VVN or CC instantiated VVN . SENT A DT TransformerConfigurationException NN may MD be VB thrown VVN if IN for IN any DT reason NN a DT Transformer NN can MD not RB be VB created VVN . SENT A DT TransformerConfigurationException NN may MD be VB thrown VVN if IN there EX is VBZ a DT syntax NN error NN in IN the DT transformation NN instructions NNS , , for IN example NN when WRB TransformerFactory JJ . SENT newTransformer NN javax NN . SENT xml NN . SENT transform VV . SENT Source NN is VBZ called VVN . SENT TransformerException NP is VBZ a DT general JJ exception NN that WDT occurs VVZ during IN the DT course NN of IN a DT transformation NN . SENT A DT transformer NN exception NN may MD wrap VV another DT exception NN , , and CC if IN any DT of IN the DT TransformerException NN . SENT printStackTrace NN methods NNS are VBP called VVN on IN it PP , , it PP will MD produce VV a DT list NN of IN stack NN dumps NNS , , starting VVG from IN the DT most RBS recent JJ . SENT The DT transformer NN exception NN also RB provides VVZ a DT SourceLocator NN object NN which WDT indicates VVZ where WRB in IN the DT source NN tree NN or CC transformation NN instructions NNS the DT error NN occurred VVD . SENT TransformerException NN . SENT getMessageAndLocation NN may MD be VB called VVN to TO get VV an DT error NN message NN with IN location NN info NN , , and CC TransformerException NP . SENT getLocationAsString NN may MD be VB called VVN to TO get VV just RB the DT location NN string NN . SENT Transformation NN warnings NNS and CC errors NNS are VBP sent VVN to TO an DT ErrorListener NP , , at IN which WDT point NN the DT application NN may MD decide VV to TO report VV the DT error NN or CC warning NN , , and CC may MD decide VV to TO throw VV an DT Exception NN for IN a DT non JJ fatal JJ error NN . SENT The DT ErrorListener NP may MD be VB set VVN via IN TransformerFactory NP . SENT setErrorListener JJR javax NN . SENT xml NN . SENT transform VV . SENT ErrorListener NP for IN reporting VVG errors NNS that WDT have VHP to TO do VV with IN syntax NN errors NNS in IN the DT transformation NN instructions NNS , , or CC via IN Transformer NN . SENT setErrorListener JJR javax NN . SENT xml NN . SENT transform VV . SENT ErrorListener JJR to TO report VV errors NNS that WDT occur VVP during IN the DT transformation NN . SENT The DT ErrorListener NP on IN both DT objects NNS will MD always RB be VB valid JJ and CC non JJ null NN , , whether IN set VVN by IN the DT application NN or CC a DT default NN implementation NN provided VVN by IN the DT processor NN . SENT The DT default NN implementation NN provided VVN by IN the DT processor NN will MD report VV all DT warnings NNS and CC errors NNS to TO System NP . SENT err VV and CC does VVZ not RB throw VV any DT Exceptions NNS . SENT Applications NNS are VBP strongly RB encouraged VVN to TO register VV and CC use VV ErrorListeners NNS that WDT insure VVP proper JJ behavior NN for IN warnings NNS and CC errors NNS . SENT Resolution NP of IN URIs NP within IN a DT transformation NN The DT API NP provides VVZ a DT way NN for IN URIs NP referenced VVD from IN within IN the DT stylesheet NN instructions NNS or CC within IN the DT transformation NN to TO be VB resolved VVN by IN the DT calling VVG application NN . SENT This DT can MD be VB done VVN by IN creating VVG a DT class NN that WDT implements VVZ the DT URIResolver NP interface NN , , with IN its PP$ one CD method NN , , URIResolver NP . SENT resolve VV java NP . SENT lang JJ . SENT String NN , , java NP . SENT lang JJ . SENT String NN , , and CC use VV this DT class NN to TO set VV the DT URI NP resolution NN for IN the DT transformation NN instructions NNS or CC transformation NN with IN TransformerFactory NP . SENT setURIResolver NN javax NN . SENT xml NN . SENT transform VV . SENT URIResolver NN or CC Transformer NN . SENT setURIResolver NN javax NN . SENT xml NN . SENT transform VV . SENT URIResolver NP . SENT The DT URIResolver NP . SENT resolve NN method NN takes VVZ two CD String NP arguments NNS , , the DT URI NP found VVD in IN the DT stylesheet NN instructions NNS or CC built VVN as IN part NN of IN the DT transformation NN process NN , , and CC the DT base NN URI NP against IN which WDT the DT first JJ argument NN will MD be VB made VVN absolute JJ if IN the DT absolute JJ URI NP is VBZ required VVN . SENT The DT returned VVN Source NN object NN must MD be VB usable JJ by IN the DT transformer NN , , as RB specified VVN in IN its PP$ implemented VVN features NNS . SENT Overview NN Package NN Class NN Tree NN Serialized VVD Deprecated VVN Index NN Help NN PREV NP PACKAGE NN NEXT IN PACKAGE NN FRAMES NNS NO DT FRAMES NNS Copyright NN 1999 CD 2005 CD Apache NP XML NP Project NP . SENT All DT Rights NP Reserved NP . SENT