站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > NetBeans API Javadoc (Current Development Version)

CheckXMLSupport (XML Tools API) - NetBeans API Javadoc (Current Development Version)

org.netbeans.api.xml/1 1.14

org.netbeans.spi.xml.cookies
Class CheckXMLSupport

java.lang.Object
  extended by org.netbeans.spi.xml.cookies.CheckXMLSupport
All Implemented Interfaces:
CheckXMLCookie, Node.Cookie

public class CheckXMLSupport
extends Object
implements CheckXMLCookie

CheckXMLCookie implementation support simplifing cookie providers based on InputSources representing XML documents and entities.

Primary use case in a DataObject subclass (which primary file is XML):

   CookieSet cookies = getCookieSet();
   InputSource in = DataObjectAdapters.inputSource(this);
   CheckXMLSupport cookieImpl = new CheckXMLSupport(in);
   cookies.add(cookieImpl);
 

Secondary use case: Subclasses can customize the class by customization protected methods. The customized subclass can be used according to primary use case.


Field Summary
static int CHECK_ENTITY_MODE
          General parsed entity strategy.
static int CHECK_PARAMETER_ENTITY_MODE
          Parameter parsed entity strategy.
static int DOCUMENT_MODE
          XML document entity strategy.
 
Constructor Summary
CheckXMLSupport(InputSource inputSource)
          Create new CheckXMLSupport for given data object using DOCUMENT_MODE strategy.
CheckXMLSupport(InputSource inputSource, int strategy)
          Create new CheckXMLSupport for given data object.
 
Method Summary
 boolean checkXML(CookieObserver l)
          Check XML parsed entity for syntax wellformedness.
protected  EntityResolver createEntityResolver()
          Parametrizes default parser creatin process.
protected  InputSource createInputSource()
          Create InputSource to be checked.
protected  XMLReader createParser(boolean validate)
          Create and preconfigure new parser.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

CHECK_ENTITY_MODE

public static final int CHECK_ENTITY_MODE
General parsed entity strategy. This strategy works well only for standalone (no entity reference) external entities.

See Also:
Constant Field Values

CHECK_PARAMETER_ENTITY_MODE

public static final int CHECK_PARAMETER_ENTITY_MODE
Parameter parsed entity strategy. This strategy is suitable for standalone (no undeclared parameter entity reference) external DTDs.

See Also:
Constant Field Values

DOCUMENT_MODE

public static final int DOCUMENT_MODE
XML document entity strategy. It is ordinary XML document processing mode.

See Also:
Constant Field Values
Constructor Detail

CheckXMLSupport

public CheckXMLSupport(InputSource inputSource)
Create new CheckXMLSupport for given data object using DOCUMENT_MODE strategy.

Parameters:
inputSource - Supported data object.

CheckXMLSupport

public CheckXMLSupport(InputSource inputSource,
                       int strategy)
Create new CheckXMLSupport for given data object.

Parameters:
inputSource - Supported data object.
strategy - One of *_MODE constants.
Method Detail

checkXML

public boolean checkXML(CookieObserver l)
Description copied from interface: CheckXMLCookie
Check XML parsed entity for syntax wellformedness.

Specified by:
checkXML in interface CheckXMLCookie
Parameters:
l - optional listener (null allowed) giving judgement details via XMLProcessorDetails.
Returns:
true if syntax check passes

createEntityResolver

protected EntityResolver createEntityResolver()
Parametrizes default parser creatin process. Default implementation takes user's catalog entity resolver.

Returns:
EntityResolver entity resolver or null

createInputSource

protected InputSource createInputSource()
                                 throws IOException
Create InputSource to be checked.

Returns:
InputSource never null
Throws:
IOException - if I/O error occurs.

createParser

protected XMLReader createParser(boolean validate)
Create and preconfigure new parser. Default implementation uses JAXP.

Parameters:
validate - true if validation module is required
Returns:
SAX reader that is used for command performing or null
See Also:
createEntityResolver()

org.netbeans.api.xml/1 1.14

Built on May 28 2007.  |  Portions Copyright 1997-2007 Sun Microsystems, Inc. All rights reserved.