/*
 * Copyright (c) 2001 World Wide Web Consortium,
 * (Massachusetts Institute of Technology, Institut National de
 * Recherche en Informatique et en Automatique, Keio University). All
 * Rights Reserved. This program is distributed under the W3C's Software
 * Intellectual Property License. This program is distributed in the
 * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
 * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
 * PURPOSE.
 * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
 */

package org.apache.xerces.dom3.as;

Deprecated:

The content model of a declared element.
See also the Document Object Model (DOM) Level 3 Abstract Schemas and Load
and Save Specification./**
 * @deprecated

 * The content model of a declared element.
 * <p>See also the <a href='http://www.w3.org/TR/2001/WD-DOM-Level-3-ASLS-20011025'>Document Object Model (DOM) Level 3 Abstract Schemas and Load
and Save Specification</a>.
 */
public interface ASContentModel extends ASObject {
    
Signifies unbounded upper limit. The MAX_VALUE value is 
0xFFFFFFFF FFFFFFFF. This needs to be better defined in 
the generated bindings.
/**
     * Signifies unbounded upper limit. The MAX_VALUE value is 
     * <code>0xFFFFFFFF FFFFFFFF</code>. This needs to be better defined in 
     * the generated bindings.
     */
    public static final int AS_UNBOUNDED              = Integer.MAX_VALUE;
    // ASContentModelType
    
This constant value signifies a sequence operator. For example, in a 
DTD, this would be the ',' operator.
/**
     * This constant value signifies a sequence operator. For example, in a 
     * DTD, this would be the '<code>,</code>' operator.
     */
    public static final short AS_SEQUENCE               = 0;
    
This constant value signifies a choice operator. For example, in a DTD, 
this would be the '|' operator.
/**
     * This constant value signifies a choice operator. For example, in a DTD, 
     * this would be the '<code>|</code>' operator.
     */
    public static final short AS_CHOICE                 = 1;
    
All of the above.
/**
     * All of the above.
     */
    public static final short AS_ALL                    = 2;
    
None of the above, i.e., neither a choice nor sequence operator.
/**
     * None of the above, i.e., neither a choice nor sequence operator.
     */
    public static final short AS_NONE                   = 3;

    
 One of AS_CHOICE, AS_SEQUENCE, 
AS_ALL or AS_NONE. The operator is applied 
to all the components(ASObjects) in the subModels. For 
example, if the list operator is AS_CHOICE and the 
components in subModels are a, b and c then the abstract schema for 
the element being declared is (a|b|c). 
/**
     *  One of <code>AS_CHOICE</code>, <code>AS_SEQUENCE</code>, 
     * <code>AS_ALL</code> or <code>AS_NONE</code>. The operator is applied 
     * to all the components(ASObjects) in the <code>subModels</code>. For 
     * example, if the list operator is <code>AS_CHOICE</code> and the 
     * components in subModels are a, b and c then the abstract schema for 
     * the element being declared is <code>(a|b|c)</code>. 
     */
    public short getListOperator();
    
 One of AS_CHOICE, AS_SEQUENCE, 
AS_ALL or AS_NONE. The operator is applied 
to all the components(ASObjects) in the subModels. For 
example, if the list operator is AS_CHOICE and the 
components in subModels are a, b and c then the abstract schema for 
the element being declared is (a|b|c). 
/**
     *  One of <code>AS_CHOICE</code>, <code>AS_SEQUENCE</code>, 
     * <code>AS_ALL</code> or <code>AS_NONE</code>. The operator is applied 
     * to all the components(ASObjects) in the <code>subModels</code>. For 
     * example, if the list operator is <code>AS_CHOICE</code> and the 
     * components in subModels are a, b and c then the abstract schema for 
     * the element being declared is <code>(a|b|c)</code>. 
     */
    public void setListOperator(short listOperator);

    
min occurrence for this content particle. Its value may be 0 or a 
positive integer. 
/**
     * min occurrence for this content particle. Its value may be 0 or a 
     * positive integer. 
     */
    public int getMinOccurs();
    
min occurrence for this content particle. Its value may be 0 or a 
positive integer. 
/**
     * min occurrence for this content particle. Its value may be 0 or a 
     * positive integer. 
     */
    public void setMinOccurs(int minOccurs);

    
 maximum occurrence for this content particle. Its value may be 
0, a positive integer, or AS_UNBOUNDED to 
indicate that no upper limit has been set. 
/**
     *  maximum occurrence for this content particle. Its value may be 
     * <code>0</code>, a positive integer, or <code>AS_UNBOUNDED</code> to 
     * indicate that no upper limit has been set. 
     */
    public int getMaxOccurs();
    
 maximum occurrence for this content particle. Its value may be 
0, a positive integer, or AS_UNBOUNDED to 
indicate that no upper limit has been set. 
/**
     *  maximum occurrence for this content particle. Its value may be 
     * <code>0</code>, a positive integer, or <code>AS_UNBOUNDED</code> to 
     * indicate that no upper limit has been set. 
     */
    public void setMaxOccurs(int maxOccurs);

    
Pointers to ASObjects such as 
 ASElementDeclarations and further 
ASContentModels. 
/**
     * Pointers to <code>ASObject</code>s such as 
     * <code> ASElementDeclaration</code>s and further 
     * <code>ASContentModel</code>s. 
     */
    public ASObjectList getSubModels();
    
Pointers to ASObjects such as 
 ASElementDeclarations and further 
ASContentModels. 
/**
     * Pointers to <code>ASObject</code>s such as 
     * <code> ASElementDeclaration</code>s and further 
     * <code>ASContentModel</code>s. 
     */
    public void setSubModels(ASObjectList subModels);

    
Removes the ASObject in the submodel. Nodes that already 
exist in the list are moved as needed. 
Params:
oldNode – The node to be removed./**
     * Removes the <code>ASObject</code> in the submodel. Nodes that already 
     * exist in the list are moved as needed. 
     * @param oldNode The node to be removed.
     */
    public void removesubModel(ASObject oldNode);

    
Inserts a new node in the submodel. Nodes that already exist in the 
list are moved as needed. 
Params:
newNode – The new node to be inserted.
Throws:
DOMASException – 
   DUPLICATE_NAME_ERR: Raised if a element declaration 
  already exists with the same name within an AS_CHOICE 
  operator./**
     * Inserts a new node in the submodel. Nodes that already exist in the 
     * list are moved as needed. 
     * @param newNode The new node to be inserted.
     * @exception DOMASException
     *    <code>DUPLICATE_NAME_ERR</code>: Raised if a element declaration 
     *   already exists with the same name within an <code>AS_CHOICE</code> 
     *   operator. 
     */
    public void insertsubModel(ASObject newNode)
                               throws DOMASException;

    
Appends a new node to the end of the list representing the
subModels.
Params:
newNode – The new node to be appended.
Throws:
DOMASException – 
   DUPLICATE_NAME_ERR: Raised if a element declaration 
  already exists with the same name within an AS_CHOICE 
  operator. 
  
 TYPE_ERR: Raised if type is neither an 
  ASContentModel nor an ASElementDeclaration
  .
Returns:
the length of the subModels./**
     * Appends a new node to the end of the list representing the
     * <code>subModels</code>.
     * @param newNode The new node to be appended.
     * @return the length of the <code>subModels</code>.
     * @exception DOMASException
     *    <code>DUPLICATE_NAME_ERR</code>: Raised if a element declaration 
     *   already exists with the same name within an <code>AS_CHOICE</code> 
     *   operator. 
     *   <br> <code>TYPE_ERR</code>: Raised if type is neither an 
     *   <code>ASContentModel</code> nor an <code>ASElementDeclaration</code>
     *   . 
     */
    public int appendsubModel(ASObject newNode)
                              throws DOMASException;

}