Home » xmlbeans-2.5.0-src » org.apache.xmlbeans.impl » values » [javadoc | source]
public interface: TypeStoreUser [javadoc | source] Represents the strongly-typed user of a typestore. A typestore is responsible for all the lexical aspects of XML, and a typestore user is responsible for all strongly-typed aspects. Where there is interaction between the two models, it is represented by the TypeStore and TypeStoreUser interfaces.
Method from org.apache.xmlbeans.impl.values.TypeStoreUser Summary:
attach_store,   build_nil,   build_text,   create_attribute_user,   create_element_user,   disconnect_store,   get_attribute_field,   get_attribute_type,   get_attributeflags,   get_default_attribute_text,   get_default_element_text,   get_element_ending_delimiters,   get_element_type,   get_elementflags,   get_schema_type,   get_store,   invalidate_element_order,   invalidate_nilvalue,   invalidate_value,   is_child_element_order_sensitive,   new_visitor,   uses_invalidate_value,   validate_now
Method from org.apache.xmlbeans.impl.values.TypeStoreUser Detail:
 public  void attach_store(TypeStore store)
    Called to attach to the given textStore. When a TypeStoreUser is attached, it is put into a completely invalidated state.
 public boolean build_nil()
    A store will call back on build_nil after you've called invalidate_nil and it needs to know what the nil value is.
 public String build_text(NamespaceManager nsm)
    A store will call back on build_text when it knows its own text is invalid and needs to fill it in. If forExternal is true, then the value returned will be used to replenish the store's cache of the value. Otherwise, the value is being computed for purposes other than validation, like persistence. Also, the only member on TypeStore which may be called while build_text is on the stack is find_prefix_for_nsuri which must have the forExternal state passed to it as it is passed here.
 public TypeStoreUser create_attribute_user(QName attrName)
    A typestore user can create a new TypeStoreUser instance for a given attribute child, based on the attribute name.
 public TypeStoreUser create_element_user(QName eltName,
    QName xsiType)
    A typestore user can create a new TypeStoreUser instance for a given element child name as long as you also pass the qname contained by the xsi:type attribute, if any. Note that we will ignore the xsiType if it turns out to be invalid.
 public  void disconnect_store()
    A store calls back on this call in order to force a disconnect. After this is done, the object should be considered invalid.
 public SchemaField get_attribute_field(QName attrName)
    Returns the schema field for an attribute
 public SchemaType get_attribute_type(QName attrName)
    Return the SchemaType which an attribute of this name would be.
 public int get_attributeflags(QName attrName)
    Returns the flags for an attribute.
 public String get_default_attribute_text(QName attrName)
    Returns the default attribute text for the attribute with the given name.
 public String get_default_element_text(QName eltName)
    Returns the default element text, if it's consistent. If it's not consistent, returns null, and requires a visitor walk.
 public QNameSet get_element_ending_delimiters(QName eltname)
    A typestore user can return the element sort order to use for insertion operations if needed. Settable elements should be stored in this order if possible.
 public SchemaType get_element_type(QName eltName,
    QName xsiType)
    Return the SchemaType which a child element of this name and xsi:type would be.
 public int get_elementflags(QName eltName)
    Returns the elementflags, if they're consistent. If they're not, returns -1, and requires a vistor walk.
 public SchemaType get_schema_type()
    Returns the schema type of this user
 public TypeStore get_store()
    Returns the store to which this typestoreuser is attached, or null if none.
 public  void invalidate_element_order()
    A store calls back on invalidate_element_order when a rearrangment of sibling elements to the left of this element means that the nillable value may no longer be valid.
 public  void invalidate_nilvalue()
    A store calls back on invalidate_nilvalue when the value of the xsi:nil tag has changed.
 public  void invalidate_value()
    A store will call back on invalidate_value when its text has changed and it therefore knows that any cached type value is invalid. It is the responsibilty of the type to call fetch_text and reparse next time the user does a strongly-typed get.
 public boolean is_child_element_order_sensitive()
    Returns false if child elements are insensitive to order; if it returns true, you're required to call invalidate_element_order on children to the right of any child order rearrangement.
 public TypeStoreVisitor new_visitor()
    A typestore user can return a visitor that is used to compute default text and elementflags for an arbitrary element.
 public boolean uses_invalidate_value()
    A store can call uses_invalidate_value to know if calls to invalidate_value will be fruitful. If uses_invalidate_value returns false, invalidate_value need never be called.
 public  void validate_now()
    A store will call back on validate_now to force us to look at the text if we're in an invalid state. This function is allowed and expected to throw an exception if the text isn't valid for our type.