/*
* reserved comment block
* DO NOT REMOVE OR ALTER!
*/
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.sun.org.apache.xerces.internal.impl.xs;
import java.io.IOException;
import java.io.StringReader;
import com.sun.org.apache.xerces.internal.dom.CoreDocumentImpl;
import com.sun.org.apache.xerces.internal.parsers.DOMParser;
import com.sun.org.apache.xerces.internal.parsers.SAXParser;
import com.sun.org.apache.xerces.internal.xs.XSAnnotation;
import com.sun.org.apache.xerces.internal.xs.XSConstants;
import com.sun.org.apache.xerces.internal.xs.XSNamespaceItem;
import org.w3c.dom.Document;
import org.w3c.dom.Element;
import org.w3c.dom.Node;
import org.xml.sax.ContentHandler;
import org.xml.sax.InputSource;
import org.xml.sax.SAXException;
This is an implementation of the XSAnnotation schema component.
@xerces.internal
/**
* This is an implementation of the XSAnnotation schema component.
*
* @xerces.internal
*/
public class XSAnnotationImpl implements XSAnnotation {
// Data
// the content of the annotation node, including all children, along
// with any non-schema attributes from its parent
private String fData = null;
// the grammar which owns this annotation; we get parsers
// from here when we need them
private SchemaGrammar fGrammar = null;
// constructors
public XSAnnotationImpl(String contents, SchemaGrammar grammar) {
fData = contents;
fGrammar = grammar;
}
Write contents of the annotation to the specified DOM object. If the
specified target
object is a DOM in-scope namespace
declarations for annotation
element are added as
attributes nodes of the serialized annotation
, otherwise
the corresponding events for all in-scope namespace declaration are
sent via specified document handler.
Params: - target – A target pointer to the annotation target object, i.e.
org.w3c.dom.Document
,
org.xml.sax.ContentHandler
. - targetType – A target type.
Returns: If the target
is recognized type and supported by
this implementation return true, otherwise return false.
/**
* Write contents of the annotation to the specified DOM object. If the
* specified <code>target</code> object is a DOM in-scope namespace
* declarations for <code>annotation</code> element are added as
* attributes nodes of the serialized <code>annotation</code>, otherwise
* the corresponding events for all in-scope namespace declaration are
* sent via specified document handler.
* @param target A target pointer to the annotation target object, i.e.
* <code>org.w3c.dom.Document</code>,
* <code>org.xml.sax.ContentHandler</code>.
* @param targetType A target type.
* @return If the <code>target</code> is recognized type and supported by
* this implementation return true, otherwise return false.
*/
public boolean writeAnnotation(Object target,
short targetType) {
if(targetType == XSAnnotation.W3C_DOM_ELEMENT || targetType == XSAnnotation.W3C_DOM_DOCUMENT) {
writeToDOM((Node)target, targetType);
return true;
} else if (targetType == SAX_CONTENTHANDLER) {
writeToSAX((ContentHandler)target);
return true;
}
return false;
}
A text representation of annotation.
/**
* A text representation of annotation.
*/
public String getAnnotationString() {
return fData;
}
// XSObject methods
The type
of this object, i.e.
ELEMENT_DECLARATION
.
/**
* The <code>type</code> of this object, i.e.
* <code>ELEMENT_DECLARATION</code>.
*/
public short getType() {
return XSConstants.ANNOTATION;
}
The name of type NCName
of this declaration as defined in
XML Namespaces.
/**
* The name of type <code>NCName</code> of this declaration as defined in
* XML Namespaces.
*/
public String getName() {
return null;
}
The [target namespace] of this object, or null
if it is
unspecified.
/**
* The [target namespace] of this object, or <code>null</code> if it is
* unspecified.
*/
public String getNamespace() {
return null;
}
A namespace schema information item corresponding to the target
namespace of the component, if it's globally declared; or null
otherwise.
/**
* A namespace schema information item corresponding to the target
* namespace of the component, if it's globally declared; or null
* otherwise.
*/
public XSNamespaceItem getNamespaceItem() {
return null;
}
// private methods
private synchronized void writeToSAX(ContentHandler handler) {
// nothing must go wrong with this parse...
SAXParser parser = fGrammar.getSAXParser();
StringReader aReader = new StringReader(fData);
InputSource aSource = new InputSource(aReader);
parser.setContentHandler(handler);
try {
parser.parse(aSource);
}
catch (SAXException e) {
// this should never happen!
// REVISIT: what to do with this?; should really not
// eat it...
}
catch (IOException i) {
// ditto with above
}
// Release the reference to the user's ContentHandler.
parser.setContentHandler(null);
}
// this creates the new Annotation element as the first child
// of the Node
private synchronized void writeToDOM(Node target, short type) {
Document futureOwner = (type == XSAnnotation.W3C_DOM_ELEMENT) ?
target.getOwnerDocument() : (Document)target;
DOMParser parser = fGrammar.getDOMParser();
StringReader aReader = new StringReader(fData);
InputSource aSource = new InputSource(aReader);
try {
parser.parse(aSource);
}
catch (SAXException e) {
// this should never happen!
// REVISIT: what to do with this?; should really not
// eat it...
}
catch (IOException i) {
// ditto with above
}
Document aDocument = parser.getDocument();
parser.dropDocumentReferences();
Element annotation = aDocument.getDocumentElement();
Node newElem = null;
if (futureOwner instanceof CoreDocumentImpl) {
newElem = futureOwner.adoptNode(annotation);
// adoptNode will return null when the DOM implementations are not compatible.
if (newElem == null) {
newElem = futureOwner.importNode(annotation, true);
}
}
else {
newElem = futureOwner.importNode(annotation, true);
}
target.insertBefore(newElem, target.getFirstChild());
}
}