<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--NewPage-->
<HTML>
<HEAD>
<!-- Generated by javadoc (build 1.6.0_18) on Fri Dec 09 20:48:46 GMT 2011 -->
<TITLE>
XQDataFactory
</TITLE>
<META NAME="date" CONTENT="2011-12-09">
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
<SCRIPT type="text/javascript">
function windowTitle()
{
if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="XQDataFactory";
}
}
</SCRIPT>
<NOSCRIPT>
</NOSCRIPT>
</HEAD>
<BODY BGCOLOR="white" onload="windowTitle();">
<HR>
<!-- ========= START OF TOP NAVBAR ======= -->
<A NAME="navbar_top"><!-- --></A>
<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_top_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
<TR ALIGN="center" VALIGN="top">
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../javax/xml/xquery/XQConstants.html" title="class in javax.xml.xquery"><B>PREV CLASS</B></A>
<A HREF="../../../javax/xml/xquery/XQDataSource.html" title="interface in javax.xml.xquery"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../index.html?javax/xml/xquery/XQDataFactory.html" target="_top"><B>FRAMES</B></A>
<A HREF="XQDataFactory.html" target="_top"><B>NO FRAMES</B></A>
<SCRIPT type="text/javascript">
<!--
if(window==top) {
document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
}
//-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>
</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_top"></A>
<!-- ========= END OF TOP NAVBAR ========= -->
<HR>
<!-- ======== START OF CLASS DATA ======== -->
<H2>
<FONT SIZE="-1">
javax.xml.xquery</FONT>
<BR>
Interface XQDataFactory</H2>
<DL>
<DT><B>All Known Subinterfaces:</B> <DD><A HREF="../../../javax/xml/xquery/XQConnection.html" title="interface in javax.xml.xquery">XQConnection</A></DD>
</DL>
<DL>
<DT><B>All Known Implementing Classes:</B> <DD><A HREF="../../../net/sf/saxon/xqj/SaxonXQConnection.html" title="class in net.sf.saxon.xqj">SaxonXQConnection</A>, <A HREF="../../../net/sf/saxon/xqj/SaxonXQDataFactory.html" title="class in net.sf.saxon.xqj">SaxonXQDataFactory</A></DD>
</DL>
<HR>
<DL>
<DT><PRE>public interface <B>XQDataFactory</B></DL>
</PRE>
<P>
This interface represents a factory to obtain sequences,
item objects and types.
<p>
The items, sequences and types obtained through this interface are
independent of any connection. <p>
The items and sequences created are immutable. The <code>close</code> method can
be called to close the item or sequence and release all resources associated
with this item or sequence.<p>
<P>
<P>
<HR>
<P>
<!-- ========== METHOD SUMMARY =========== -->
<A NAME="method_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Method Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createAtomicType(int)">createAtomicType</A></B>(int basetype)</CODE>
<BR>
Creates a new <code>XQItemType</code> object representing an XQuery atomic type.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createAtomicType(int, javax.xml.namespace.QName, java.net.URI)">createAtomicType</A></B>(int basetype,
<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> typename,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net">URI</A> schemaURI)</CODE>
<BR>
Creates a new <code>XQItemType</code> object representing an XQuery atomic type.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createAttributeType(javax.xml.namespace.QName, int)">createAttributeType</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> nodename,
int basetype)</CODE>
<BR>
Creates a new <code>XQItemType</code> object representing the XQuery
<code>attribute(<i>nodename</i>, <i>basetype</i>)</code> type
with the given node name and base type.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createAttributeType(javax.xml.namespace.QName, int, javax.xml.namespace.QName, java.net.URI)">createAttributeType</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> nodename,
int basetype,
<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> typename,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net">URI</A> schemaURI)</CODE>
<BR>
Creates a new <code>XQItemType</code> object representing the XQuery
<code>attribute(<i>nodename</i>,<i>basetype</i>,<i>typename</i>,<i>schemaURI</i>)</code> type,
with the given node name, base type, schema type name and schema URI.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createCommentType()">createCommentType</A></B>()</CODE>
<BR>
Creates a new <code>XQItemType</code> object representing the XQuery
<code>comment()</code> type.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createDocumentElementType(javax.xml.xquery.XQItemType)">createDocumentElementType</A></B>(<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> elementType)</CODE>
<BR>
Creates a new <code>XQItemType</code> object representing the XQuery
<code>document-node(<i>elementType</i>)</code> type containing a single element.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createDocumentSchemaElementType(javax.xml.xquery.XQItemType)">createDocumentSchemaElementType</A></B>(<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> elementType)</CODE>
<BR>
Creates a new <code>XQItemType</code> object representing the XQuery
<code>document-node(<i>elementType</i>)</code> type containing a single
<code>schema-element(...)</code>.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createDocumentType()">createDocumentType</A></B>()</CODE>
<BR>
Creates a new <code>XQItemType</code> object representing the XQuery
<code>document-node()</code> type.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createElementType(javax.xml.namespace.QName, int)">createElementType</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> nodename,
int basetype)</CODE>
<BR>
Creates a new <code>XQItemType</code> object representing the XQuery
<code>element(<i>nodename</i>, <i>basetype</i>)</code> type, with the
given node name and base type.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createElementType(javax.xml.namespace.QName, int, javax.xml.namespace.QName, java.net.URI, boolean)">createElementType</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> nodename,
int basetype,
<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> typename,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net">URI</A> schemaURI,
boolean allowNill)</CODE>
<BR>
Creates a new <code>XQItemType</code> object representing the XQuery
<code>element(<i>nodename</i>,<i>basetype</i>,<i>typename</i>,<i>schemaURI</i>,
<i>allowNill</i>)</code> type, given the node name, base type, schema type
name, schema URI, and nilled check.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createItem(javax.xml.xquery.XQItem)">createItem</A></B>(<A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A> item)</CODE>
<BR>
Creates a copy of the specified <code>XQItem</code>.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createItemFromAtomicValue(java.lang.String, javax.xml.xquery.XQItemType)">createItemFromAtomicValue</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)</CODE>
<BR>
Creates an item from a given value.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createItemFromBoolean(boolean, javax.xml.xquery.XQItemType)">createItemFromBoolean</A></B>(boolean value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)</CODE>
<BR>
Creates an item from a given value.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createItemFromByte(byte, javax.xml.xquery.XQItemType)">createItemFromByte</A></B>(byte value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)</CODE>
<BR>
Creates an item from a given value.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createItemFromDocument(java.io.InputStream, java.lang.String, javax.xml.xquery.XQItemType)">createItemFromDocument</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</A> value,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> baseURI,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)</CODE>
<BR>
Creates an item from the given value.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createItemFromDocument(java.io.Reader, java.lang.String, javax.xml.xquery.XQItemType)">createItemFromDocument</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/io/Reader.html?is-external=true" title="class or interface in java.io">Reader</A> value,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> baseURI,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)</CODE>
<BR>
Creates an item from the given value.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createItemFromDocument(javax.xml.transform.Source, javax.xml.xquery.XQItemType)">createItemFromDocument</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Source.html?is-external=true" title="class or interface in javax.xml.transform">Source</A> value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)</CODE>
<BR>
Creates an item from the given <code>Source</code>.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createItemFromDocument(java.lang.String, java.lang.String, javax.xml.xquery.XQItemType)">createItemFromDocument</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> value,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> baseURI,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)</CODE>
<BR>
Creates an item from the given value.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createItemFromDocument(javax.xml.stream.XMLStreamReader, javax.xml.xquery.XQItemType)">createItemFromDocument</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/stream/XMLStreamReader.html?is-external=true" title="class or interface in javax.xml.stream">XMLStreamReader</A> value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)</CODE>
<BR>
Creates an item from the given value.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createItemFromDouble(double, javax.xml.xquery.XQItemType)">createItemFromDouble</A></B>(double value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)</CODE>
<BR>
Creates an item from a given value.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createItemFromFloat(float, javax.xml.xquery.XQItemType)">createItemFromFloat</A></B>(float value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)</CODE>
<BR>
Creates an item from a given value.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createItemFromInt(int, javax.xml.xquery.XQItemType)">createItemFromInt</A></B>(int value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)</CODE>
<BR>
Creates an item from a given value.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createItemFromLong(long, javax.xml.xquery.XQItemType)">createItemFromLong</A></B>(long value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)</CODE>
<BR>
Creates an item from a given value.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createItemFromNode(org.w3c.dom.Node, javax.xml.xquery.XQItemType)">createItemFromNode</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/org/w3c/dom/Node.html?is-external=true" title="class or interface in org.w3c.dom">Node</A> value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)</CODE>
<BR>
Creates an item from a given value.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createItemFromObject(java.lang.Object, javax.xml.xquery.XQItemType)">createItemFromObject</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)</CODE>
<BR>
Creates an item from a given value.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createItemFromShort(short, javax.xml.xquery.XQItemType)">createItemFromShort</A></B>(short value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)</CODE>
<BR>
Creates an item from a given value.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createItemFromString(java.lang.String, javax.xml.xquery.XQItemType)">createItemFromString</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)</CODE>
<BR>
Creates an item from a given value.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createItemType()">createItemType</A></B>()</CODE>
<BR>
Creates a new <code>XQItemType</code> object representing the XQuery item type.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createNodeType()">createNodeType</A></B>()</CODE>
<BR>
Creates a new <code>XQItemType</code> object representing the XQuery <code>node()</code>
type.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createProcessingInstructionType(java.lang.String)">createProcessingInstructionType</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> piTarget)</CODE>
<BR>
Creates a new <code>XQItemType</code> object representing the XQuery
<code>processing-instruction(<i>piTarget</i>)</code> type.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createSchemaAttributeType(javax.xml.namespace.QName, int, java.net.URI)">createSchemaAttributeType</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> nodename,
int basetype,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net">URI</A> schemaURI)</CODE>
<BR>
Creates a new <code>XQItemType</code> object representing the XQuery
<code>schema-attribute(<i>nodename</i>,<i>basetype</i>,<i>schemaURI</i>)</code> type,
with the given node name, base type, and schema URI.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createSchemaElementType(javax.xml.namespace.QName, int, java.net.URI)">createSchemaElementType</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> nodename,
int basetype,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net">URI</A> schemaURI)</CODE>
<BR>
Creates a new <code>XQItemType</code> object representing the XQuery
<code>schema-element(<i>nodename</i>,<i>basetype</i>,<i>schemaURI</i>)</code>
type, given the node name, base type, and the schema URI.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQSequence.html" title="interface in javax.xml.xquery">XQSequence</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createSequence(java.util.Iterator)">createSequence</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util">Iterator</A> i)</CODE>
<BR>
Creates an <code>XQSequence</code>, containing all the items from the
iterator.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQSequence.html" title="interface in javax.xml.xquery">XQSequence</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createSequence(javax.xml.xquery.XQSequence)">createSequence</A></B>(<A HREF="../../../javax/xml/xquery/XQSequence.html" title="interface in javax.xml.xquery">XQSequence</A> s)</CODE>
<BR>
Creates a copy of the specified <code>XQSequence</code>.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQSequenceType.html" title="interface in javax.xml.xquery">XQSequenceType</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createSequenceType(javax.xml.xquery.XQItemType, int)">createSequenceType</A></B>(<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> item,
int occurence)</CODE>
<BR>
Creates a new sequence type from an item type and occurence indicator.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xquery/XQDataFactory.html#createTextType()">createTextType</A></B>()</CODE>
<BR>
Creates a new <code>XQItemType</code> object representing the XQuery
<code>text()</code> type.</TD>
</TR>
</TABLE>
<P>
<!-- ============ METHOD DETAIL ========== -->
<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Method Detail</B></FONT></TH>
</TR>
</TABLE>
<A NAME="createItemFromAtomicValue(java.lang.String, javax.xml.xquery.XQItemType)"><!-- --></A><H3>
createItemFromAtomicValue</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A> <B>createItemFromAtomicValue</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates an item from a given value. The value is converted into an
instance of the specified type according to the casting from
<code>xs:string</code> rules outlined in
<a href="http://www.w3.org/TR/xpath-functions/#casting-from-strings">
<i>17.1.1 Casting from xs:string and xs:untypedAtomic, XQuery 1.0 and
XPath 2.0 Functions and Operators</i></a>. If the cast fails
an <code>XQException</code> is thrown.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - the lexical string value of the type<DD><CODE>type</CODE> - the item type
<DT><B>Returns:</B><DD><code>XQItem</code> representing the resulting item
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if (1) any of the arguments are <code>null</code>,
(2) given type is not an atomic type,
(3) the conversion of the value to an XDM
instance failed, or (4) the underlying object
implementing the interface is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createItemFromString(java.lang.String, javax.xml.xquery.XQItemType)"><!-- --></A><H3>
createItemFromString</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A> <B>createItemFromString</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates an item from a given value. The value is converted into an
instance of the specified type, which must represent an
<code>xs:string</code> or a type derived by restriction from
<code>xs:string</code>. If the specified type is <code>null</code>, it
defaults to <code>xs:string</code>.<br>
Subsequently the value is converted into an instance of the specified
type according to the rule defined in <i>14.2 Mapping a Java Data Type to
an XQuery Data Type, XQuery API for Java (XQJ) 1.0</i>. If the
conversion fails, an <code>XQException</code> will be thrown.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - the value to be converted, cannot be
<code>null</code><DD><CODE>type</CODE> - the type of the value to be bound to the
external variable. The default type,
<code>xs:string</code>, is used in case
<code>null</code> is specified
<DT><B>Returns:</B><DD><code>XQItem</code> representing the resulting
item
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if (1) the <code>value</code> argument is
<code>null</code>, (2) the conversion of the
value to an XDM instance failed, or (3) the
underlying object implementing the interface
is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createItemFromDocument(java.lang.String, java.lang.String, javax.xml.xquery.XQItemType)"><!-- --></A><H3>
createItemFromDocument</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A> <B>createItemFromDocument</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> value,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> baseURI,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates an item from the given value.
<br>
<br>
If the value represents a well-formed XML document, it will be parsed
and results in a document node.
The kind of the input type must be <code>null</code>,
<code>XQITEMKIND_DOCUMENT_ELEMENT</code>, or
<code>XQITEMKIND_DOCUMENT_SCHEMA_ELEMENT</code>.
<br>
<br>
The value is converted into an instance of the specified type according
to the rules defined in <i>14.3 Mapping a Java XML document to an
XQuery document node, XQuery API for Java (XQJ) 1.0</i>.
<br>
<br>
If the value is not well formed, or if a kind of the input type other
than the values list above is specified, behavior is implementation
defined and may raise an exception.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - the value to be converted, cannot be
<code>null</code><DD><CODE>baseURI</CODE> - an optional base URI, can be <code>null</code>. It can
be used, for example, to resolve relative URIs and to
include in error messages.<DD><CODE>type</CODE> - the type of the value for the created
document node. If <code>null</code> is specified,
it behaves as if
<code>XQDataFactory.createDocumentElementType(
XQDataFactory.createElementType(null,
XQItemType.XQBASETYPE_XS_UNTYPED))</code> were passed in
as the type parameter. That is, the type represents the
XQuery sequence type <code>document-node(element(*, xs:untyped))</code>
<DT><B>Returns:</B><DD><code>XQItem</code> representing the resulting
item
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if (1) the value argument is <code>null</code>,
(2) the conversion of the value to an XDM instance
failed, or (3) the underlying object
implementing the interface is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createItemFromDocument(java.io.Reader, java.lang.String, javax.xml.xquery.XQItemType)"><!-- --></A><H3>
createItemFromDocument</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A> <B>createItemFromDocument</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/io/Reader.html?is-external=true" title="class or interface in java.io">Reader</A> value,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> baseURI,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates an item from the given value.
<br>
<br>
If the value represents a well-formed XML document, it will be parsed
and results in a document node.
The kind of the input type must be <code>null</code>,
<code>XQITEMKIND_DOCUMENT_ELEMENT</code>, or
<code>XQITEMKIND_DOCUMENT_SCHEMA_ELEMENT</code>.
<br>
<br>
The value is converted into an instance of the specified type according
to the rules defined in <i>14.3 Mapping a Java XML document to an
XQuery document node, XQuery API for Java (XQJ) 1.0</i>.
<br>
<br>
If the value is not well formed, or if a kind of the input type other
than the values list above is specified, behavior is implementation
defined and may raise an exception.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - the value to be converted, cannot be
<code>null</code><DD><CODE>baseURI</CODE> - an optional base URI, can be <code>null</code>. It can
be used, for example, to resolve relative URIs and to
include in error messages.<DD><CODE>type</CODE> - the type of the value for the created
document node. If <code>null</code> is specified,
it behaves as if
<code>XQDataFactory.createDocumentElementType(
XQDataFactory.createElementType(null,
XQItemType.XQBASETYPE_XS_UNTYPED))</code> were passed in
as the type parameter. That is, the type represents the
XQuery sequence type <code>document-node(element(*, xs:untyped))</code>
<DT><B>Returns:</B><DD><code>XQItem</code> representing the resulting
item
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if (1) the value argument is <code>null</code>,
(2) the conversion of the value to an XDM instance
failed, or (3) the underlying object
implementing the interface is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createItemFromDocument(java.io.InputStream, java.lang.String, javax.xml.xquery.XQItemType)"><!-- --></A><H3>
createItemFromDocument</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A> <B>createItemFromDocument</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</A> value,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> baseURI,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates an item from the given value.
<br>
<br>
If the value represents a well-formed XML document, it will be parsed
and results in a document node.
The kind of the input type must be <code>null</code>,
<code>XQITEMKIND_DOCUMENT_ELEMENT</code>, or
<code>XQITEMKIND_DOCUMENT_SCHEMA_ELEMENT</code>.
<br>
<br>
The value is converted into an instance of the specified type according
to the rules defined in <i>14.3 Mapping a Java XML document to an
XQuery document node, XQuery API for Java (XQJ) 1.0</i>.
<br>
<br>
If the value is not well formed, or if a kind of the input type other
than the values list above is specified, behavior is implementation
defined and may raise an exception.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - the value to be converted, cannot be
<code>null</code><DD><CODE>baseURI</CODE> - an optional base URI, can be <code>null</code>. It can
be used, for example, to resolve relative URIs and to
include in error messages.<DD><CODE>type</CODE> - the type of the value for the created
document node. If <code>null</code> is specified,
it behaves as if
<code>XQDataFactory.createDocumentElementType(
XQDataFactory.createElementType(null,
XQItemType.XQBASETYPE_XS_UNTYPED))</code> were passed in
as the type parameter. That is, the type represents the
XQuery sequence type <code>document-node(element(*, xs:untyped))</code>
<DT><B>Returns:</B><DD><code>XQItem</code> representing the resulting
item
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if (1) the value argument is <code>null</code>,
(2) the conversion of the value to an XDM instance
failed, or (3) the underlying object
implementing the interface is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createItemFromDocument(javax.xml.stream.XMLStreamReader, javax.xml.xquery.XQItemType)"><!-- --></A><H3>
createItemFromDocument</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A> <B>createItemFromDocument</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/stream/XMLStreamReader.html?is-external=true" title="class or interface in javax.xml.stream">XMLStreamReader</A> value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates an item from the given value.
<br>
<br>
If the value represents a well-formed XML document, it results in a
document node. The kind of the input type must be <code>null</code>,
<code>XQITEMKIND_DOCUMENT_ELEMENT</code> or <code>XQITEMKIND_DOCUMENT_SCHEMA_ELEMENT</code>.
<br>
<br>
The value is converted into an instance of the specified type according
to the rules defined in <i>14.3 Mapping a Java XML document to an
XQuery document node, XQuery API for Java (XQJ) 1.0</i>.
<br>
<br>
If the value is not well formed, or if a kind of the input type other
than the values list above is specified, behavior is implementation
defined and may raise an exception.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - the value to be converted, cannot be <code>null</code><DD><CODE>type</CODE> - the type of the value for the created
document node. If <code>null</code> is specified,
it behaves as if
<code>XQDataFactory.createDocumentElementType(
XQDataFactory.createElementType(null,
XQItemType.XQBASETYPE_XS_UNTYPED))</code> were passed in
as the type parameter. That is, the type represents the
XQuery sequence type <code>document-node(element(*, xs:untyped))</code>
<DT><B>Returns:</B><DD><code>XQItem</code> representing the resulting
item
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if (1) the value argument is <code>null</code>, (2)
the conversion of the value to an XDM instance failed,
or (3) the underlying object implementing the interface
is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createItemFromDocument(javax.xml.transform.Source, javax.xml.xquery.XQItemType)"><!-- --></A><H3>
createItemFromDocument</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A> <B>createItemFromDocument</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Source.html?is-external=true" title="class or interface in javax.xml.transform">Source</A> value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates an item from the given <code>Source</code>. An XQJ
implementation must at least support the following implementations:
<ul>
<li><code>javax.xml.transform.dom.DOMSource</code></li>
<li><code>javax.xml.transform.sax.SAXSource</code></li>
<li><code>javax.xml.transform.stream.StreamSource</code></li>
</ul>
<br>
<br>
If the value represents a well-formed XML document, it will result in a
document node. The kind of the input type must be <code>null</code>,
<code>XQITEMKIND_DOCUMENT_ELEMENT</code>, or
<code>XQITEMKIND_DOCUMENT_SCHEMA_ELEMENT</code>.
<br>
<br>
The value is converted into an instance of the specified type according
to the rules defined in <i>14.3 Mapping a Java XML document to an
XQuery document node, XQuery API for Java (XQJ) 1.0</i>.
<br>
<br>
If the value is not well formed, or if a kind of the input type other
than the values list above is specified, behavior is implementation
defined and may raise an exception.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - the value to be converted, cannot be <code>null</code><DD><CODE>type</CODE> - the type of the value for the created
document node. If <code>null</code> is specified,
it behaves as if
<code>XQDataFactory.createDocumentElementType(
XQDataFactory.createElementType(null,
XQItemType.XQBASETYPE_XS_UNTYPED))</code> were passed in
as the type parameter. That is, the type represents the
XQuery sequence type <code>document-node(element(*, xs:untyped))</code>
<DT><B>Returns:</B><DD><code>XQItem</code> representing the resulting
item
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if (1) the value argument is <code>null</code>, (2)
the conversion of the value to an XDM instance failed,
or (3) the underlying object implementing the interface
is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createItemFromObject(java.lang.Object, javax.xml.xquery.XQItemType)"><!-- --></A><H3>
createItemFromObject</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A> <B>createItemFromObject</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates an item from a given value. The value is converted into an
instance of the specified type according to the rule defined in
<i>14.2 Mapping a Java Data Type to an XQuery Data Type, XQuery API for
Java (XQJ) 1.0</i>. If the converstion fails, an
<code>XQException</code> will be thrown.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - the value to be converted, cannot be
<code>null</code><DD><CODE>type</CODE> - the type of the value to be bound to
the external variable. The default type of
the value is used in case <code>null</code> is
specified
<DT><B>Returns:</B><DD><code>XQItem</code> representing the resulting item
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if (1) the <code>value</code> argument is
<code>null</code>, (2) the conversion of the value
to an XDM instance failed, or (3) the underlying object
implementing the interface is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createItemFromBoolean(boolean, javax.xml.xquery.XQItemType)"><!-- --></A><H3>
createItemFromBoolean</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A> <B>createItemFromBoolean</B>(boolean value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates an item from a given value. The value is converted into an
instance of the specified type according to the rule defined in
<i>14.2 Mapping a Java Data Type to an XQuery Data Type, XQuery API for
Java (XQJ) 1.0</i>. If the converstion fails, an
<code>XQException</code> will be thrown.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - the value to be converted<DD><CODE>type</CODE> - the type of the value to be bound to
the external variable. The default type of
the value is used in case <code>null</code> is
specified
<DT><B>Returns:</B><DD><code>XQItem</code> representing the resulting item
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - (1) the conversion of the value
to an XDM instance failed, or (2) the underlying object
implementing the interface is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createItemFromByte(byte, javax.xml.xquery.XQItemType)"><!-- --></A><H3>
createItemFromByte</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A> <B>createItemFromByte</B>(byte value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates an item from a given value. The value is converted into an
instance of the specified type according to the rule defined in
<i>14.2 Mapping a Java Data Type to an XQuery Data Type, XQuery API for
Java (XQJ) 1.0</i>. If the converstion fails, an
<code>XQException</code> will be thrown.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - the value to be converted<DD><CODE>type</CODE> - the type of the value to be bound to
the external variable. The default type of
the value is used in case <code>null</code> is
specified
<DT><B>Returns:</B><DD><code>XQItem</code> representing the resulting item
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - (1) the conversion of the value
to an XDM instance failed, or (2) the underlying object
implementing the interface is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createItemFromDouble(double, javax.xml.xquery.XQItemType)"><!-- --></A><H3>
createItemFromDouble</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A> <B>createItemFromDouble</B>(double value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates an item from a given value. The value is converted into an
instance of the specified type according to the rule defined in
<i>14.2 Mapping a Java Data Type to an XQuery Data Type, XQuery API for
Java (XQJ) 1.0</i>. If the converstion fails, an
<code>XQException</code> will be thrown.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - the value to be converted<DD><CODE>type</CODE> - the type of the value to be bound to
the external variable. The default type of
the value is used in case <code>null</code> is
specified
<DT><B>Returns:</B><DD><code>XQItem</code> representing the resulting item
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - (1) the conversion of the value
to an XDM instance failed, or (2) the underlying object
implementing the interface is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createItemFromFloat(float, javax.xml.xquery.XQItemType)"><!-- --></A><H3>
createItemFromFloat</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A> <B>createItemFromFloat</B>(float value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates an item from a given value. The value is converted into an
instance of the specified type according to the rule defined in
<i>14.2 Mapping a Java Data Type to an XQuery Data Type, XQuery API for
Java (XQJ) 1.0</i>. If the converstion fails, an
<code>XQException</code> will be thrown.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - the value to be converted<DD><CODE>type</CODE> - the type of the value to be bound to
the external variable. The default type of
the value is used in case <code>null</code> is
specified
<DT><B>Returns:</B><DD><code>XQItem</code> representing the resulting item
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - (1) the conversion of the value
to an XDM instance failed, or (2) the underlying object
implementing the interface is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createItemFromInt(int, javax.xml.xquery.XQItemType)"><!-- --></A><H3>
createItemFromInt</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A> <B>createItemFromInt</B>(int value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates an item from a given value. The value is converted into an
instance of the specified type according to the rule defined in
<i>14.2 Mapping a Java Data Type to an XQuery Data Type, XQuery API for
Java (XQJ) 1.0</i>. If the converstion fails, an
<code>XQException</code> will be thrown.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - the value to be converted<DD><CODE>type</CODE> - the type of the value to be bound to
the external variable. The default type of
the value is used in case <code>null</code> is
specified
<DT><B>Returns:</B><DD><code>XQItem</code> representing the resulting item
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - (1) the conversion of the value
to an XDM instance failed, or (2) the underlying object
implementing the interface is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createItemFromLong(long, javax.xml.xquery.XQItemType)"><!-- --></A><H3>
createItemFromLong</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A> <B>createItemFromLong</B>(long value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates an item from a given value. The value is converted into an
instance of the specified type according to the rule defined in
<i>14.2 Mapping a Java Data Type to an XQuery Data Type, XQuery API for
Java (XQJ) 1.0</i>. If the converstion fails, an
<code>XQException</code> will be thrown.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - the value to be converted<DD><CODE>type</CODE> - the type of the value to be bound to
the external variable. The default type of
the value is used in case <code>null</code> is
specified
<DT><B>Returns:</B><DD><code>XQItem</code> representing the resulting item
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - (1) the conversion of the value
to an XDM instance failed, or (2) the underlying object
implementing the interface is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createItemFromNode(org.w3c.dom.Node, javax.xml.xquery.XQItemType)"><!-- --></A><H3>
createItemFromNode</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A> <B>createItemFromNode</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/org/w3c/dom/Node.html?is-external=true" title="class or interface in org.w3c.dom">Node</A> value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates an item from a given value. The value is converted into an
instance of the specified type according to the rule defined in
<i>14.2 Mapping a Java Data Type to an XQuery Data Type, XQuery API for
Java (XQJ) 1.0</i>. If the converstion fails, an
<code>XQException</code> will be thrown.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - the value to be converted, cannot be
<code>null</code><DD><CODE>type</CODE> - the type of the value to be bound to
the external variable. The default type of
the value is used in case <code>null</code> is
specified
<DT><B>Returns:</B><DD><code>XQItem</code> representing the resulting item
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if (1) the <code>value</code> argument is
<code>null</code>, (2) the conversion of the value
to an XDM instance failed, or (3) the underlying object
implementing the interface is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createItemFromShort(short, javax.xml.xquery.XQItemType)"><!-- --></A><H3>
createItemFromShort</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A> <B>createItemFromShort</B>(short value,
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> type)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates an item from a given value. The value is converted into an
instance of the specified type according to the rule defined in
<i>14.2 Mapping a Java Data Type to an XQuery Data Type, XQuery API for
Java (XQJ) 1.0</i>. If the converstion fails, an
<code>XQException</code> will be thrown.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - the value to be converted<DD><CODE>type</CODE> - the type of the value to be bound to
the external variable. The default type of
the value is used in case <code>null</code> is
specified
<DT><B>Returns:</B><DD><code>XQItem</code> representing the resulting item
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - (1) the conversion of the value
to an XDM instance failed, or (2) the underlying object
implementing the interface is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createItem(javax.xml.xquery.XQItem)"><!-- --></A><H3>
createItem</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A> <B>createItem</B>(<A HREF="../../../javax/xml/xquery/XQItem.html" title="interface in javax.xml.xquery">XQItem</A> item)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates a copy of the specified <code>XQItem</code>. This method can be used, for
example, to copy an <code>XQResultItem</code> object so that the new item is not
dependant on the connection.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>item</CODE> - the <code>XQItem</code> to copy
<DT><B>Returns:</B><DD><code>XQItem</code> independent of any underlying
<code>XQConnection</code> is created
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if (1) the specified item is <code>null</code>,
(2) the underlying object implementing the interface is
closed, (3) the specified item is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createSequence(javax.xml.xquery.XQSequence)"><!-- --></A><H3>
createSequence</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQSequence.html" title="interface in javax.xml.xquery">XQSequence</A> <B>createSequence</B>(<A HREF="../../../javax/xml/xquery/XQSequence.html" title="interface in javax.xml.xquery">XQSequence</A> s)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates a copy of the specified <code>XQSequence</code>. The newly created
<code>XQSequence</code> is scrollable and independent of any underlying
<code>XQConnection</code>. The new <code>XQSequence</code> will contain all
items from the specified <code>XQSequence</code> starting from its current
position. The copy process will implicitly perform next operations on the
specified sequence to read the items. All items are consumed, the current
position of the cursor is set to point after the last item.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>s</CODE> - input sequence
<DT><B>Returns:</B><DD><code>XQSequence</code> representing a copy of
the input sequence
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if (1) there are errors accessing the items in
the specified sequence, (2) the specified sequence
is closed, (3) in the case of a forward only
sequence, a get or write method has already
been invoked on the current item, (4)
the <code>s</code> parameter is <code>null</code>,
or (5) the underlying object implementing the
interface is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createSequence(java.util.Iterator)"><!-- --></A><H3>
createSequence</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQSequence.html" title="interface in javax.xml.xquery">XQSequence</A> <B>createSequence</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util">Iterator</A> i)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates an <code>XQSequence</code>, containing all the items from the
iterator. The newly created <code>XQSequence</code> is scrollable and
independent of any underlying <code>XQConnection</code>.
If the iterator returns an <code>XQItem</code>, it is added to the
sequence. If the iterator returns any other object, an item is added to the
sequence following the rules from <i>14.2 Mapping a Java Data Type
to an XQuery Data Type, XQuery API for Java (XQJ) 1.0</i>.
If the iterator does not return any items, then an empty sequence is created.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>i</CODE> - input iterator
<DT><B>Returns:</B><DD><code>XQSequence</code> representing the sequence
containing all items from the input iterator
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if (1) the conversion of any of the objects in the
iterator to item fails, (2)
the <code>i</code> parameter is <code>null</code>,
or (3) underlying object implementing the interface
is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createAtomicType(int)"><!-- --></A><H3>
createAtomicType</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> <B>createAtomicType</B>(int basetype)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates a new <code>XQItemType</code> object representing an XQuery atomic type.
The item kind of the item type will be <code>XQItemType.XQITEMKIND_ATOMIC</code>.
<br>
Example -
<pre>
XQConnection conn = ...;
// to create xs:integer item type
conn.createAtomicType(XQItemType.XQBASETYPE_INTEGER);
</pre>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>basetype</CODE> - one of the <code>XQItemType.XQBASETYPE_*</code>
constants. All basetype constants except the
following are valid:
<pre>
XQItemType.XQBASETYPE_UNTYPED
XQItemType.XQBASETYPE_ANYTYPE
XQItemType.XQBASETYPE_IDREFS
XQItemType.XQBASETYPE_NMTOKENS
XQItemType.XQBASETYPE_ENTITIES
XQItemType.XQBASETYPE_ANYSIMPLETYPE
</pre>
<DT><B>Returns:</B><DD>a new <code>XQItemType</code> representing the atomic type
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if (1) an invalid <code>basetype</code> value is
passed in, or (2) the underlying object implementing
the interface is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createAtomicType(int, javax.xml.namespace.QName, java.net.URI)"><!-- --></A><H3>
createAtomicType</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> <B>createAtomicType</B>(int basetype,
<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> typename,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net">URI</A> schemaURI)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates a new <code>XQItemType</code> object representing an XQuery atomic type.
The item kind of the item type will be <code>XQItemType.XQITEMKIND_ATOMIC</code>.
<br>
Example -
<pre>
XQConnection conn = ...;
// to create po:hatsize atomic item type
conn.createAtomicType(XQItemType.XQBASETYPE_INTEGER,
new QName("http://www.hatsizes.com", "hatsize","po"),
new URI("http://hatschema.com"));
</pre>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>basetype</CODE> - one of the <code>XQItemType.XQBASETYPE_*</code>
constants. All basetype constants except the
following are valid:
<pre>
XQItemType.XQBASETYPE_UNTYPED
XQItemType.XQBASETYPE_ANYTYPE
XQItemType.XQBASETYPE_IDREFS
XQItemType.XQBASETYPE_NMTOKENS
XQItemType.XQBASETYPE_ENTITIES
XQItemType.XQBASETYPE_ANYSIMPLETYPE
</pre><DD><CODE>typename</CODE> - the <code>QName</code> of the type. If the <code>QName</code>
refers to a predefinied type, it must match
the <code>basetype</code>. Can be <code>null</code><DD><CODE>schemaURI</CODE> - the URI to the schema. Can be <code>null</code>. This can
only be specified if the typename is also specified
<DT><B>Returns:</B><DD>a new <code>XQItemType</code> representing the atomic type
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if (1) an invalid <code>basetype</code> value is
passed in, (2) the underlying object implementing
the interface is closed, (3) the implementation does
not support user-defined XML schema types, or (4)
if the <code>typename</code> refers to a predefinied
type and does not match <code>basetype</code></DL>
</DD>
</DL>
<HR>
<A NAME="createAttributeType(javax.xml.namespace.QName, int)"><!-- --></A><H3>
createAttributeType</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> <B>createAttributeType</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> nodename,
int basetype)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates a new <code>XQItemType</code> object representing the XQuery
<code>attribute(<i>nodename</i>, <i>basetype</i>)</code> type
with the given node name and base type. This method can be used to create
item type for attributes with a pre-defined schema type.
<br>
<br>
Example -
<pre>
XQConnection conn = ..; // An XQuery connection
- attribute() // no node name, pass null for the node name
conn.createAttributeType(null, XQItemType.XQBASETYPE_ANYSIMPLETYPE);
- attribute (*) // equivalent to attribute()
conn.createAttributeType(null, XQItemType.XQBASETYPE_ANYSIMPLETYPE);
- attribute (person) // attribute of name person and any simple type.
conn.createAttributeType(new QName("person"), XQItemType.XQBASETYPE_ANYSIMPLETYPE);
- attribute(foo:bar) // node name foo:bar, type is any simple type
conn.createAttributeType(new QName("http://www.foo.com", "bar","foo"),
XQItemType.XQBASETYPE_ANYSIMPLETYPE);
- attribute(foo:bar, xs:integer) // node name foo:bar, type is xs:integer
conn.createAttributeType(new QName("http://www.foo.com", "bar","foo"),
XQItemType.XQBASETYPE_INTEGER);
</pre>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>nodename</CODE> - specifies the name of the node.<code>null</code>
indicates a wildcard for the node name<DD><CODE>basetype</CODE> - the base type of the attribute. One of the
<code>XQItemType.XQBASETYPE_*</code>
other than <code>XQItemType.XQBASETYPE_UNTYPED</code>
or <code>XQItemType.XQBASETYPE_ANYTYPE</code>
<DT><B>Returns:</B><DD>a new <code>XQItemType</code> representing the XQuery
<code>attribute(<i>nodename</i>, <i>basetype</i>)</code> type
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if (1) the underlying object implementing the interface is closed or
(2) if the base type is one of:
<code>XQItemType.XQBASETYPE_UNTYPED</code>
or <code>XQItemType.XQBASETYPE_ANYTYPE</code></DL>
</DD>
</DL>
<HR>
<A NAME="createAttributeType(javax.xml.namespace.QName, int, javax.xml.namespace.QName, java.net.URI)"><!-- --></A><H3>
createAttributeType</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> <B>createAttributeType</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> nodename,
int basetype,
<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> typename,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net">URI</A> schemaURI)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates a new <code>XQItemType</code> object representing the XQuery
<code>attribute(<i>nodename</i>,<i>basetype</i>,<i>typename</i>,<i>schemaURI</i>)</code> type,
with the given node name, base type, schema type name and schema URI. The type name can
reference either pre-defined simple types or user-defined simple types.
<br>
<br>
Example -
<pre>
XQConnection conn = ..; // An XQuery connection
- attribute (name, employeename) // attribute name of type employeename
conn.createAttributeType(new QName("name"), XQItemType.XQBASETYPE_ANYSIMPLETYPE,
new QName("employeename"), null);
- attribute (foo:bar, po:city)
where the prefix foo refers to the namespace http://www.foo.com and the
prefix po refers to the namespace "http://www.address.com"
conn.createAttributeType(new QName("http://www.foo.com", "bar","foo"),
XQItemType.XQBASETYPE_ANYSIMPLETYPE,
new QName("http://address.com", "address","po"), null);
- attribute (zip, zipcode) // attribute zip of type zipchode which derives from
// xs:string
conn.createAttributeType(new QName("zip"), XQItemType.XQBASETYPE_STRING,
new QName("zipcode"), null);
- attribute(foo:bar, po:hatsize)
where the prefix foo refers to the namespace http://www.foo.com and the
prefix po refers to the namespace "http://www.hatsizes.com"
with schema URI "http://hatschema.com"
conn.createAttributeType(new QName("http://www.foo.com", "bar","foo"),
XQItemType.XQBASETYPE_INTEGER,
new QName("http://www.hatsizes.com", "hatsize","po"),
new QName("http://hatschema.com"));
</pre>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>nodename</CODE> - specifies the name of the node.<code>null</code>
indicates a wildcard for the node name<DD><CODE>basetype</CODE> - the base type of the attribute. One of the
<code>XQItemTyupe.XQBASETYPE_*</code> constants
other than <code>XQItemType.XQBASETYPE_UNTYPED</code> or
<code>XQItemType.XQBASETYPE_ANYTYPE</code><DD><CODE>typename</CODE> - the <code>QName</code> of the type. If the <code>QName</code>
refers to a predefinied type, it must match
the <code>basetype</code>. Can be <code>null</code>.<DD><CODE>schemaURI</CODE> - the URI to the schema. Can be <code>null</code>. This can
only be specified if the typename is also specified
<DT><B>Returns:</B><DD>a new <code>XQItemType</code> representing the XQuery
<code>attribute(<i>nodename</i>,<i>basetype</i>,
<i>typename</i>,<i>schemaURI</i>)</code> type.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if (1) the underlying object implementing the interface is closed,
(2) if the base type is one of:
<code>XQItemType.XQBASETYPE_UNTYPED</code> or
<code>XQItemType.XQBASETYPE_ANYTYPE</code>,
(3) the schema URI is specified and the typename
is not specified, (4) the implementation does
not support user-defined XML schema types, or (5)
if the <code>typename</code> refers to a predefinied
type and does not match <code>basetype</code></DL>
</DD>
</DL>
<HR>
<A NAME="createSchemaAttributeType(javax.xml.namespace.QName, int, java.net.URI)"><!-- --></A><H3>
createSchemaAttributeType</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> <B>createSchemaAttributeType</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> nodename,
int basetype,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net">URI</A> schemaURI)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates a new <code>XQItemType</code> object representing the XQuery
<code>schema-attribute(<i>nodename</i>,<i>basetype</i>,<i>schemaURI</i>)</code> type,
with the given node name, base type, and schema URI.
<br>
<br>
Example -
<pre>
XQConnection conn = ..; // An XQuery connection
- schema-attribute (name) // schema-attribute name, found in the schema
// available at http://customerschema.com
conn.createSchemaAttributeType(new QName("name"),
XQItemType.XQBASETYPE_STRING,
new URI(http://customerschema.com));
</pre>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>nodename</CODE> - specifies the name of the node<DD><CODE>basetype</CODE> - the base type of the attribute. One of the
<code>XQItemTyupe.XQBASETYPE_*</code> constants
other than <code>XQItemType.XQBASETYPE_UNTYPED</code> or
<code>XQItemType.XQBASETYPE_ANYTYPE</code><DD><CODE>schemaURI</CODE> - the URI to the schema. Can be <code>null</code>
<DT><B>Returns:</B><DD>a new <code>XQItemType</code> representing the XQuery
<code>schema-attribute(<i>nodename</i>,<i>basetype</i>,
<i>schemaURI</i>)</code> type
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if (1) the node name is <code>null</code>,
(2) if the base type is one of:
<code>XQItemType.XQBASETYPE_UNTYPED</code> or
<code>XQItemType.XQBASETYPE_ANYTYPE</code>,
(3) the underlying object implementing the interface
is closed, or (4) the implementation does
not support user-defined XML schema types</DL>
</DD>
</DL>
<HR>
<A NAME="createCommentType()"><!-- --></A><H3>
createCommentType</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> <B>createCommentType</B>()
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates a new <code>XQItemType</code> object representing the XQuery
<code>comment()</code> type. The <code>XQItemType</code> object will have
the item kind set to <code>XQItemType.XQITEMKIND_COMMENT</code>.
<br>
<br>
Example -
<pre>
XQConnection conn = ..; // An XQuery connection
XQItemType cmttype = conn.createCommentType();
int itemkind = cmttype.getItemKind(); // will be XQItemType.XQITEMKIND_COMMENT
XQExpression expr = conn.createExpression();
XQSequence result = expr.executeQuery("<!-- comments -->");
result.next();
boolean pi = result.instanceOf(cmttype); // will be true
</pre>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>a new <code>XQItemType</code> representing the XQuery
<code>comment()</code> type
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if the underlying object implementing the interface is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createDocumentElementType(javax.xml.xquery.XQItemType)"><!-- --></A><H3>
createDocumentElementType</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> <B>createDocumentElementType</B>(<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> elementType)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates a new <code>XQItemType</code> object representing the XQuery
<code>document-node(<i>elementType</i>)</code> type containing a single element.
The <code>XQItemType</code> object will have the item kind set to
<code>XQItemType.XQITEMKIND_DOCUMENT_ELEMENT</code> and the
base type set to the item type of the input <code>elementType</code>.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>elementType</CODE> - an <code>XQItemType</code> object representing an XQuery
<code>element()</code> type, cannot be <code>null</code>
<DT><B>Returns:</B><DD>a new <code>XQItemType</code> representing the XQuery
<code>document-node(<i>elementType</i>)</code> type containing
a single element
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if (1) the underlying object implementing the interface is
closed or (2) the <code>elementType</code> has an item kind
different from <code>XQItemType.XQITEMKIND_ELEMENT</code>,
(3) the <code>elementType</code> argument is <code>null</code>,
or (4) the implementation does not support user-defined XML
schema types</DL>
</DD>
</DL>
<HR>
<A NAME="createDocumentSchemaElementType(javax.xml.xquery.XQItemType)"><!-- --></A><H3>
createDocumentSchemaElementType</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> <B>createDocumentSchemaElementType</B>(<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> elementType)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates a new <code>XQItemType</code> object representing the XQuery
<code>document-node(<i>elementType</i>)</code> type containing a single
<code>schema-element(...)</code>. The <code>XQItemType</code> object will
have the item kind set to <code>XQItemType.XQITEMKIND_DOCUMENT_SCHEMA_ELEMENT</code> and the
base type set to the item type of the input <code>elementType</code>.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>elementType</CODE> - an <code>XQItemType</code> object representing an XQuery
<code>schema-element(...)</code> type, cannot be <code>null</code>
<DT><B>Returns:</B><DD>a new <code>XQItemType</code> representing the XQuery
<code>document-node(<i>elementType</i>)</code> type containing
a single <code>schema-element(...)</code> element
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if (1) the underlying object implementing the interface is
closed or (2) the <code>elementType</code> has an item kind
different from <code>XQItemType.XQITEMKIND_SCHEMA_ELEMENT</code>,
(3) the <code>elementType</code> argument is <code>null</code>,
(4) the implementation does not support user-defined XML
schema types</DL>
</DD>
</DL>
<HR>
<A NAME="createDocumentType()"><!-- --></A><H3>
createDocumentType</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> <B>createDocumentType</B>()
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates a new <code>XQItemType</code> object representing the XQuery
<code>document-node()</code> type. The <code>XQItemType</code> object will have the item kind
set to <code>XQItemType.XQITEMKIND_DOCUMENT</code>.
<P>
<DD><DL>
<DT><B>Returns:</B><DD>a new <code>XQItemType</code> representing the XQuery
<code>document-node()</code> type
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if the underlying object implementing the interface is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createElementType(javax.xml.namespace.QName, int)"><!-- --></A><H3>
createElementType</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> <B>createElementType</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> nodename,
int basetype)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates a new <code>XQItemType</code> object representing the XQuery
<code>element(<i>nodename</i>, <i>basetype</i>)</code> type, with the
given node name and base type. This method can be used to create item
type for elements with a pre-defined schema type.
<br>
<br>
Example -
<pre>
XQConnection conn = ..; // An XQuery connection
- element() // no node name, pass null for the node name
conn.createElementType(null, XQItemType.XQBASETYPE_ANYTYPE);
- element (*) // equivalent to element()
conn.createElementType(null, XQItemType.XQBASETYPE_ANYTYPE);
- element(person) // element of name person and any type.
conn.createElementType(new QName("person"), XQItemType.XQBASETYPE_ANYTYPE);
- element(foo:bar) // node name foo:bar, type is anytype
conn.createElementType(new QName("http://www.foo.com", "bar","foo"),
XQItemType.XQBASETYPE_ANYTYPE);
- element(foo:bar, xs:integer) // node name foo:bar, type is xs:integer
conn.createElementType(new QName("http://www.foo.com", "bar","foo"),
XQItemType.XQBASETYPE_INTEGER);
</pre>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>nodename</CODE> - specifies the name of the node. <code>null</code>
indicates a wildcard for the node name<DD><CODE>basetype</CODE> - the base type of the item. One of the
<code>XQItemType.XQBASETYPE_*</code> constants
<DT><B>Returns:</B><DD>a new <code>XQItemType</code> representing the XQuery
<code>element(<i>nodename</i>, <i>basetype</i>)</code> type
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if (1) the underlying object implementing the interface
is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createElementType(javax.xml.namespace.QName, int, javax.xml.namespace.QName, java.net.URI, boolean)"><!-- --></A><H3>
createElementType</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> <B>createElementType</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> nodename,
int basetype,
<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> typename,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net">URI</A> schemaURI,
boolean allowNill)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates a new <code>XQItemType</code> object representing the XQuery
<code>element(<i>nodename</i>,<i>basetype</i>,<i>typename</i>,<i>schemaURI</i>,
<i>allowNill</i>)</code> type, given the node name, base type, schema type
name, schema URI, and nilled check. The type name can reference either pre-defined
schema types or user-defined types.
<br>
<br>
Example -
<pre>
XQConnection conn = ..; // An XQuery connection
- element (person, employee) // element person of type employee
conn.createElementType(new QName("person"), XQItemType.XQBASETYPE_ANYTYPE,
new QName("employee"), null ,false);
- element(person, employee ? ) // element person of type employee, whose nilled
// property may be true or false.
conn.createElementType(new QName("person"), XQItemType.XQBASETYPE_ANYTYPE,
new QName("employee"), null ,true);
- element(foo:bar, po:address)
where the prefix foo refers to the namespace http://www.foo.com and the
prefix po refers to the namespace "http://www.address.com"
conn.createElementType(new QName("http://www.foo.com", "bar","foo"),
XQItemType.XQBASETYPE_ANYTYPE,
new QName("http://address.com", "address","po"), null, false);
- element (zip, zipcode) // element zip of type zipchode which derives from
// xs:string
conn.createElementType(new QName("zip"), XQItemType.XQBASETYPE_STRING,
new QName("zipcode"), null, false);
- element (*, xs:anyType ?)
conn.createElementType(null, XQItemType.XQBASETYPE_ANYTYPE, null, null, true);
- element(foo:bar, po:hatsize)
where the prefix foo refers to the namespace http://www.foo.com and the
prefix po refers to the namespace "http://www.hatsizes.com"
with schema URI "http://hatschema.com"
conn.createElementType(new QName("http://www.foo.com", "bar","foo"),
XQItemType.XQBASETYPE_INTEGER,
new QName("http://www.hatsizes.com", "hatsize","po"),
new QName("http://hatschema.com"), false);
</pre>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>nodename</CODE> - specifies the name of the element. <code>null</code>
indicates a wildcard for the node name<DD><CODE>basetype</CODE> - the base type of the item. One of the
<code>XQItemType.XQBASETYPE_*</code> constants<DD><CODE>typename</CODE> - the <code>QName</code> of the type. If the <code>QName</code>
refers to a predefinied type, it must match
the <code>basetype</code>. Can be <code>null</code><DD><CODE>schemaURI</CODE> - the URI to the schema. Can be <code>null</code>. This can
only be specified if the typename is also specified<DD><CODE>allowNill</CODE> - the nilled property of the element
<DT><B>Returns:</B><DD>a new <code>XQItemType</code> representing the XQuery
<code>element(<i>nodename</i>,<i>basetype</i>,
<i>typename</i>,<i>schemaURI</i>,
<i>allowNill</i>)</code> type
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if (1) schemaURI is specified but the typename is not
specified, (2) the underlying object implementing the
interface is closed, (3) the implementation does
not support user-defined XML schema types, or
(4) if the <code>typename</code> refers to a predefinied
type and does not match <code>basetype</code></DL>
</DD>
</DL>
<HR>
<A NAME="createSchemaElementType(javax.xml.namespace.QName, int, java.net.URI)"><!-- --></A><H3>
createSchemaElementType</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> <B>createSchemaElementType</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> nodename,
int basetype,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/net/URI.html?is-external=true" title="class or interface in java.net">URI</A> schemaURI)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates a new <code>XQItemType</code> object representing the XQuery
<code>schema-element(<i>nodename</i>,<i>basetype</i>,<i>schemaURI</i>)</code>
type, given the node name, base type, and the schema URI.
<br>
<br>
Example -
<pre>
XQConnection conn = ..; // An XQuery connection
- schema-element (customer) // schema-element person, found in
// the schema available at http://customerschema.com
conn.createElementType(new QName("customer"), XQItemType.XQBASETYPE_ANYTYPE,
new URI("http://customerschema.com"));
</pre>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>nodename</CODE> - specifies the name of the element<DD><CODE>basetype</CODE> - the base type of the item. One of the
<code>XQItemType.XQBASETYPE_*</code> constants<DD><CODE>schemaURI</CODE> - the URI to the schema. Can be <code>null</code>
<DT><B>Returns:</B><DD>a new <code>XQItemType</code> representing the XQuery
<code>schema-element(<i>nodename</i>,<i>basetype</i>,
<i>schemaURI</i>)</code> type
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if (1) the node name is <code>null</code>,
(2) the underlying object implementing the
interface is closed, or (3) the implementation does
not support user-defined XML schema types</DL>
</DD>
</DL>
<HR>
<A NAME="createItemType()"><!-- --></A><H3>
createItemType</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> <B>createItemType</B>()
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates a new <code>XQItemType</code> object representing the XQuery item type.
The <code>XQItemType</code> object will have the item kind set to
<code>XQItemType.XQITEMKIND_ITEM</code>.
<br>
<br>
Example -
<pre>
XQConnection conn = ..; // An XQuery connection
XQItemType typ = conn.createItemType(); // represents the XQuery item type "item()"
</pre>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>a new <code>XQItemType</code> representing the XQuery
item type
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if the underlying object implementing the interface
is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createNodeType()"><!-- --></A><H3>
createNodeType</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> <B>createNodeType</B>()
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates a new <code>XQItemType</code> object representing the XQuery <code>node()</code>
type. The <code>XQItemType</code> object will have the item kind set to
<code>XQItemType.XQITEMKIND_NODE</code>.
<P>
<DD><DL>
<DT><B>Returns:</B><DD>a new <code>XQItemType</code> representing the
XQuery <code>node()</code> type
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if the underlying object implementing the interface
is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createProcessingInstructionType(java.lang.String)"><!-- --></A><H3>
createProcessingInstructionType</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> <B>createProcessingInstructionType</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> piTarget)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates a new <code>XQItemType</code> object representing the XQuery
<code>processing-instruction(<i>piTarget</i>)</code> type. The <code>XQItemType</code> object
will have the item kind set to <code>XQItemType.XQITEMKIND_PI</code>. A
string literal can be passed to match the PITarget of the processing instruction
as described in <a href="http://www.w3.org/TR/xquery/#id-matching-item">
<i>2.5.4.2 Matching an Item Type and an Item, XQuery 1.0: An XML Query Language</i></a>.
<br>
<br>
Example -
<pre>
XQConnection conn = ..; // An XQuery connection
XQItemType anypi = conn.createProcessingInstructionType();
XQItemType foopi = conn.createProcessingInstructionType("foo-format");
XQExpression expr = conn.createExpression();
XQSequence result = expr.executeQuery("<?format role="output" ?>");
result.next();
boolean pi = result.instanceOf(anypi); // will be true
pi = result.instanceOf(foopi); // will be false
XQExpression expr = conn.createExpression();
XQSequence result = expr.executeQuery("<?foo-format role="output" ?>");
result.next();
boolean pi = result.instanceOf(anypi); // will be true
pi = result.instanceOf(foopi); // will be true
</pre>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>piTarget</CODE> - the string literal to match the processing
instruction's PITarget. A <code>null</code> string
value will match all processing instruction nodes
<DT><B>Returns:</B><DD>a new <code>XQItemType</code> representing the XQuery
<code>processing-instruction(<i>piTarget</i>)</code> type
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if the underlying object implementing the interface is
closed</DL>
</DD>
</DL>
<HR>
<A NAME="createSequenceType(javax.xml.xquery.XQItemType, int)"><!-- --></A><H3>
createSequenceType</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQSequenceType.html" title="interface in javax.xml.xquery">XQSequenceType</A> <B>createSequenceType</B>(<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> item,
int occurence)
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates a new sequence type from an item type and occurence indicator.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>item</CODE> - the item type. This parameter must be <code>null</code> if
the occurance is <code>XQSequenceType.OCC_EMPTY</code>,
and cannot be <code>null</code> for any other
occurance indicator<DD><CODE>occurence</CODE> - The occurence of the item type, must be one of
<code>XQSequenceType.OCC_ZERO_OR_ONE</code>,
<code>XQSequenceType.OCC_EXACTLY_ONE</code>,
<code>XQSequenceType.OCC_ZERO_OR_MORE</code>,
<code>XQSequenceType.OCC_ONE_OR_MORE</code>,
<code>XQSequenceType.OCC_EMPTY</code>
<DT><B>Returns:</B><DD>a new <code>XQSequenceType</code> representing the
type of a sequence
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if (1) the <code>item</code> is <code>null</code>
and the occurance is not <code>XQSequenceType.OCC_EMPTY</code>,
(2) the <code>item</code> is not <code>null</code>
and the occurance is <code>XQSequenceType.OCC_EMPTY</code>,
(3) the occurence is not one of:
<code>XQSequenceType.OCC_ZERO_OR_ONE</code>,
<code>XQSequenceType.OCC_EXACTLY_ONE</code>,
<code>XQSequenceType.OCC_ZERO_OR_MORE</code>,
<code>XQSequenceType.OCC_ONE_OR_MORE</code>,
<code>XQSequenceType.OCC_EMPTY</code>
or (4) the underlying object implementing the
interface is closed</DL>
</DD>
</DL>
<HR>
<A NAME="createTextType()"><!-- --></A><H3>
createTextType</H3>
<PRE>
<A HREF="../../../javax/xml/xquery/XQItemType.html" title="interface in javax.xml.xquery">XQItemType</A> <B>createTextType</B>()
throws <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Creates a new <code>XQItemType</code> object representing the XQuery
<code>text()</code> type. The <code>XQItemType</code> object will have the
item kind set to <code>XQItemType.XQITEMKIND_TEXT</code>.
<P>
<DD><DL>
<DT><B>Returns:</B><DD>a new <code>XQItemType</code> representing the XQuery
<code>text()</code> type
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if the underlying object implementing the interface is
closed</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
<TR ALIGN="center" VALIGN="top">
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../javax/xml/xquery/XQConstants.html" title="class in javax.xml.xquery"><B>PREV CLASS</B></A>
<A HREF="../../../javax/xml/xquery/XQDataSource.html" title="interface in javax.xml.xquery"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../index.html?javax/xml/xquery/XQDataFactory.html" target="_top"><B>FRAMES</B></A>
<A HREF="XQDataFactory.html" target="_top"><B>NO FRAMES</B></A>
<SCRIPT type="text/javascript">
<!--
if(window==top) {
document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
}
//-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>
</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<HR>
Copyright (c) 2004-2011 Saxonica Limited. All rights reserved.
</BODY>
</HTML>
