com.sun.org.apache.xerces.internal.xs.ItemPSVI Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of org.apache.servicemix.bundles.jaxp-ri
Show all versions of org.apache.servicemix.bundles.jaxp-ri
This OSGi bundle wraps ${pkgArtifactId} ${pkgVersion} jar file.
The newest version!
/*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
*
* Copyright (c) 1997-2010 Oracle and/or its affiliates. All rights reserved.
*
* The contents of this file are subject to the terms of either the GNU
* General Public License Version 2 only ("GPL") or the Common Development
* and Distribution License("CDDL") (collectively, the "License"). You
* may not use this file except in compliance with the License. You can
* obtain a copy of the License at
* https://glassfish.dev.java.net/public/CDDL+GPL_1_1.html
* or packager/legal/LICENSE.txt. See the License for the specific
* language governing permissions and limitations under the License.
*
* When distributing the software, include this License Header Notice in each
* file and include the License file at packager/legal/LICENSE.txt.
*
* GPL Classpath Exception:
* Oracle designates this particular file as subject to the "Classpath"
* exception as provided by Oracle in the GPL Version 2 section of the License
* file that accompanied this code.
*
* Modifications:
* If applicable, add the following below the License Header, with the fields
* enclosed by brackets [] replaced by your own identifying information:
* "Portions Copyright [year] [name of copyright owner]"
*
* Contributor(s):
* If you wish your version of this file to be governed by only the CDDL or
* only the GPL Version 2, indicate your decision by adding "[Contributor]
* elects to include this software in this distribution under the [CDDL or GPL
* Version 2] license." If you don't indicate a single choice of license, a
* recipient has the option to distribute your version of this file under
* either the CDDL, the GPL Version 2 or to extend the choice of license to
* its licensees as provided above. However, if you add GPL Version 2 code
* and therefore, elected the GPL Version 2 license, then the option applies
* only if the new code is made subject to such option by the copyright
* holder.
*
*
* This file incorporates work covered by the following copyright and
* permission notice:
*
* 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.xs;
/**
* Represents an abstract PSVI item for an element or an attribute
* information item.
*/
public interface ItemPSVI {
/**
* Validity value indicating that validation has either not been performed
* or that a strict assessment of validity could not be performed.
*/
public static final short VALIDITY_NOTKNOWN = 0;
/**
* Validity value indicating that validation has been strictly assessed
* and the item in question is invalid according to the rules of schema
* validation.
*/
public static final short VALIDITY_INVALID = 1;
/**
* Validation status indicating that schema validation has been performed
* and the item in question is valid according to the rules of schema
* validation.
*/
public static final short VALIDITY_VALID = 2;
/**
* Validation status indicating that schema validation has been performed
* and the item in question has specifically been skipped.
*/
public static final short VALIDATION_NONE = 0;
/**
* Validation status indicating that schema validation has been performed
* on the item in question under the rules of lax validation.
*/
public static final short VALIDATION_PARTIAL = 1;
/**
* Validation status indicating that full schema validation has been
* performed on the item.
*/
public static final short VALIDATION_FULL = 2;
/**
* The nearest ancestor element information item with a
* [schema information]
property (or this element item
* itself if it has such a property). For more information refer to
* element validation context and attribute validation context .
*/
public String getValidationContext();
/**
* [validity]
: determines the validity of the schema item
* with respect to the validation being attempted. The value will be one
* of the constants: VALIDITY_NOTKNOWN
,
* VALIDITY_INVALID
or VALIDITY_VALID
.
*/
public short getValidity();
/**
* [validation attempted]
: determines the extent to which
* the schema item has been validated. The value will be one of the
* constants: VALIDATION_NONE
,
* VALIDATION_PARTIAL
or VALIDATION_FULL
.
*/
public short getValidationAttempted();
/**
* [schema error code]
: a list of error codes generated from
* the validation attempt or an empty StringList
if no
* errors occurred during the validation attempt.
*/
public StringList getErrorCodes();
/**
* [schema normalized value]
: the normalized value of this
* item after validation.
*/
public String getSchemaNormalizedValue();
/**
* [schema normalized value]
: Binding specific actual value
* or null
if the value is in error.
* @exception XSException
* NOT_SUPPORTED_ERR: Raised if the implementation does not support this
* method.
*/
public Object getActualNormalizedValue()
throws XSException;
/**
* The actual value built-in datatype, e.g.
* STRING_DT, SHORT_DT
. If the type definition of this
* value is a list type definition, this method returns
* LIST_DT
. If the type definition of this value is a list
* type definition whose item type is a union type definition, this
* method returns LISTOFUNION_DT
. To query the actual value
* of the list or list of union type definitions use
* itemValueTypes
. If the actualNormalizedValue
* is null
, this method returns UNAVAILABLE_DT
* .
* @exception XSException
* NOT_SUPPORTED_ERR: Raised if the implementation does not support this
* method.
*/
public short getActualNormalizedValueType()
throws XSException;
/**
* In the case the actual value represents a list, i.e. the
* actualNormalizedValueType
is LIST_DT
, the
* returned array consists of one type kind which represents the itemType
* . For example:
* <simpleType name="listtype"> <list
* itemType="positiveInteger"/> </simpleType> <element
* name="list" type="listtype"/> ... <list>1 2 3</list>
*
* The schemaNormalizedValue
value is "1 2 3", the
* actualNormalizedValueType
value is LIST_DT
,
* and the itemValueTypes
is an array of size 1 with the
* value POSITIVEINTEGER_DT
.
*
If the actual value represents a list type definition whose item
* type is a union type definition, i.e. LISTOFUNION_DT
,
* for each actual value in the list the array contains the
* corresponding memberType kind. For example:
* <simpleType
* name='union_type' memberTypes="integer string"/> <simpleType
* name='listOfUnion'> <list itemType='union_type'/>
* </simpleType> <element name="list" type="listOfUnion"/>
* ... <list>1 2 foo</list>
* The
* schemaNormalizedValue
value is "1 2 foo", the
* actualNormalizedValueType
is LISTOFUNION_DT
* , and the itemValueTypes
is an array of size 3 with the
* following values: INTEGER_DT, INTEGER_DT, STRING_DT
.
* @exception XSException
* NOT_SUPPORTED_ERR: Raised if the implementation does not support this
* method.
*/
public ShortList getItemValueTypes()
throws XSException;
/**
* [type definition]
: an item isomorphic to the type
* definition used to validate the schema item.
*/
public XSTypeDefinition getTypeDefinition();
/**
* [member type definition]
: if and only if that type
* definition is a simple type definition with {variety} union, or a
* complex type definition whose {content type} is a simple type
* definition with {variety} union, then an item isomorphic to that
* member of the union's {member type definitions} which actually
* validated the schema item's normalized value.
*/
public XSSimpleTypeDefinition getMemberTypeDefinition();
/**
* [schema default]
: the canonical lexical representation of
* the declaration's {value constraint} value. For more information
* refer to element schema default and attribute schema default.
*/
public String getSchemaDefault();
/**
* [schema specified]
: if true, the value was specified in
* the schema. If false, the value comes from the infoset. For more
* information refer to element specified and attribute specified.
*/
public boolean getIsSchemaSpecified();
}