<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <!-- NewPage --> <html lang="en"> <head> <!-- Generated by javadoc (1.8.0_265) on Tue Aug 25 19:30:51 UTC 2020 --> <title>Metacat (MetaCat API)</title> <meta name="date" content="2020-08-25"> <link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style"> <script type="text/javascript" src="../../../../../script.js"></script> </head> <body> <script type="text/javascript"><!-- try { if (location.href.indexOf('is-external=true') == -1) { parent.document.title="Metacat (MetaCat API)"; } } catch(err) { } //--> var methods = {"i0":6,"i1":6,"i2":6,"i3":6,"i4":6,"i5":6,"i6":6,"i7":6,"i8":6,"i9":6,"i10":6,"i11":6,"i12":6,"i13":6,"i14":6,"i15":6,"i16":6,"i17":6,"i18":6,"i19":6,"i20":6,"i21":6,"i22":6,"i23":6}; var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],4:["t3","Abstract Methods"]}; var altColor = "altColor"; var rowColor = "rowColor"; var tableTab = "tableTab"; var activeTableTab = "activeTableTab"; </script> <noscript> <div>JavaScript is disabled on your browser.</div> </noscript> <!-- ========= START OF TOP NAVBAR ======= --> <div class="topNav"><a name="navbar.top"> <!-- --> </a> <div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div> <a name="navbar.top.firstrow"> <!-- --> </a> <ul class="navList" title="Navigation"> <li><a href="../../../../../overview-summary.html">Overview</a></li> <li><a href="package-summary.html">Package</a></li> <li class="navBarCell1Rev">Class</li> <li><a href="class-use/Metacat.html">Use</a></li> <li><a href="package-tree.html">Tree</a></li> <li><a href="../../../../../deprecated-list.html">Deprecated</a></li> <li><a href="../../../../../index-all.html">Index</a></li> <li><a href="../../../../../help-doc.html">Help</a></li> </ul> </div> <div class="subNav"> <ul class="navList"> <li><a href="../../../../../edu/ucsb/nceas/metacat/client/InsufficientKarmaException.html" title="class in edu.ucsb.nceas.metacat.client"><span class="typeNameLink">Prev Class</span></a></li> <li><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatAuthException.html" title="class in edu.ucsb.nceas.metacat.client"><span class="typeNameLink">Next Class</span></a></li> </ul> <ul class="navList"> <li><a href="../../../../../index.html?edu/ucsb/nceas/metacat/client/Metacat.html" target="_top">Frames</a></li> <li><a href="Metacat.html" target="_top">No Frames</a></li> </ul> <ul class="navList" id="allclasses_navbar_top"> <li><a href="../../../../../allclasses-noframe.html">All Classes</a></li> </ul> <div> <script type="text/javascript"><!-- allClassesLink = document.getElementById("allclasses_navbar_top"); if(window==top) { allClassesLink.style.display = "block"; } else { allClassesLink.style.display = "none"; } //--> </script> </div> <div> <ul class="subNavList"> <li>Summary: </li> <li>Nested | </li> <li>Field | </li> <li>Constr | </li> <li><a href="#method.summary">Method</a></li> </ul> <ul class="subNavList"> <li>Detail: </li> <li>Field | </li> <li>Constr | </li> <li><a href="#method.detail">Method</a></li> </ul> </div> <a name="skip.navbar.top"> <!-- --> </a></div> <!-- ========= END OF TOP NAVBAR ========= --> <!-- ======== START OF CLASS DATA ======== --> <div class="header"> <div class="subTitle">edu.ucsb.nceas.metacat.client</div> <h2 title="Interface Metacat" class="title">Interface Metacat</h2> </div> <div class="contentContainer"> <div class="description"> <ul class="blockList"> <li class="blockList"> <dl> <dt>All Known Implementing Classes:</dt> <dd><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatClient.html" title="class in edu.ucsb.nceas.metacat.client">MetacatClient</a></dd> </dl> <hr> <br> <pre>public interface <span class="typeNameLabel">Metacat</span></pre> <div class="block">This interface provides methods for initializing and logging in to a Metacat server, and then querying, reading, transforming, inserting, updating and deleting documents from that server.</div> </li> </ul> </div> <div class="summary"> <ul class="blockList"> <li class="blockList"> <!-- ========== METHOD SUMMARY =========== --> <ul class="blockList"> <li class="blockList"><a name="method.summary"> <!-- --> </a> <h3>Method Summary</h3> <table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation"> <caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd"> </span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd"> </span></span><span id="t3" class="tableTab"><span><a href="javascript:show(4);">Abstract Methods</a></span><span class="tabEnd"> </span></span></caption> <tr> <th class="colFirst" scope="col">Modifier and Type</th> <th class="colLast" scope="col">Method and Description</th> </tr> <tr id="i0" class="altColor"> <td class="colFirst"><code>java.lang.String</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../edu/ucsb/nceas/metacat/client/Metacat.html#delete-java.lang.String-">delete</a></span>(java.lang.String docid)</code> <div class="block">Delete an XML document in the repository.</div> </td> </tr> <tr id="i1" class="rowColor"> <td class="colFirst"><code>java.lang.String</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../edu/ucsb/nceas/metacat/client/Metacat.html#getAccessControl-java.lang.String-">getAccessControl</a></span>(java.lang.String docid)</code> </td> </tr> <tr id="i2" class="altColor"> <td class="colFirst"><code>java.util.Vector</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../edu/ucsb/nceas/metacat/client/Metacat.html#getAllDocids-java.lang.String-">getAllDocids</a></span>(java.lang.String scope)</code> <div class="block">return a list of all docids that match a given scope.</div> </td> </tr> <tr id="i3" class="rowColor"> <td class="colFirst"><code>java.lang.String</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../edu/ucsb/nceas/metacat/client/Metacat.html#getEncoding--">getEncoding</a></span>()</code> <div class="block">Returns the character encoding used used when communicating with Metacat.</div> </td> </tr> <tr id="i4" class="altColor"> <td class="colFirst"><code>java.lang.String</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../edu/ucsb/nceas/metacat/client/Metacat.html#getLastDocid-java.lang.String-">getLastDocid</a></span>(java.lang.String scope)</code> <div class="block">Return the highest document id for a given scope.</div> </td> </tr> <tr id="i5" class="rowColor"> <td class="colFirst"><code>java.lang.String</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../edu/ucsb/nceas/metacat/client/Metacat.html#getloggedinuserinfo--">getloggedinuserinfo</a></span>()</code> <div class="block">Get the logged in user for this session.</div> </td> </tr> <tr id="i6" class="altColor"> <td class="colFirst"><code>int</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../edu/ucsb/nceas/metacat/client/Metacat.html#getNewestDocRevision-java.lang.String-">getNewestDocRevision</a></span>(java.lang.String docId)</code> <div class="block">The method will return the latest revision in metacat server for a given document id.</div> </td> </tr> <tr id="i7" class="rowColor"> <td class="colFirst"><code>java.lang.String</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../edu/ucsb/nceas/metacat/client/Metacat.html#getSessionId--">getSessionId</a></span>()</code> <div class="block">Get the session identifier for this session.</div> </td> </tr> <tr id="i8" class="altColor"> <td class="colFirst"><code>java.lang.String</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../edu/ucsb/nceas/metacat/client/Metacat.html#insert-java.lang.String-java.io.Reader-java.io.Reader-">insert</a></span>(java.lang.String docid, java.io.Reader xmlDocument, java.io.Reader schema)</code> <div class="block">Insert an XML document into the repository, making it available for searching using the query() methods.</div> </td> </tr> <tr id="i9" class="rowColor"> <td class="colFirst"><code>boolean</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../edu/ucsb/nceas/metacat/client/Metacat.html#isRegistered-java.lang.String-">isRegistered</a></span>(java.lang.String docid)</code> <div class="block">return true of the given docid is registered, false if not</div> </td> </tr> <tr id="i10" class="altColor"> <td class="colFirst"><code>java.lang.String</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../edu/ucsb/nceas/metacat/client/Metacat.html#login-java.lang.String-java.lang.String-">login</a></span>(java.lang.String username, java.lang.String password)</code> <div class="block">Method used to log in to a metacat server.</div> </td> </tr> <tr id="i11" class="rowColor"> <td class="colFirst"><code>java.lang.String</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../edu/ucsb/nceas/metacat/client/Metacat.html#logout--">logout</a></span>()</code> <div class="block">Method used to log out a metacat server.</div> </td> </tr> <tr id="i12" class="altColor"> <td class="colFirst"><code>java.io.Reader</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../edu/ucsb/nceas/metacat/client/Metacat.html#query-java.io.Reader-">query</a></span>(java.io.Reader xmlQuery)</code> <div class="block">Query the metacat document store with the given metacat-compatible query document, and return the result set as a Reader.</div> </td> </tr> <tr id="i13" class="rowColor"> <td class="colFirst"><code>java.io.Reader</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../edu/ucsb/nceas/metacat/client/Metacat.html#query-java.io.Reader-java.lang.String-">query</a></span>(java.io.Reader xmlQuery, java.lang.String qformat)</code> <div class="block">Query the metacat document store with the given metacat-compatible query document and qformat, and return the result set as a Reader.</div> </td> </tr> <tr id="i14" class="altColor"> <td class="colFirst"><code>java.io.InputStream</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../edu/ucsb/nceas/metacat/client/Metacat.html#read-java.lang.String-">read</a></span>(java.lang.String docid)</code> <div class="block">Read an XML document from the metacat server session, accessed by docid, and returned as a Reader.</div> </td> </tr> <tr id="i15" class="rowColor"> <td class="colFirst"><code>java.io.InputStream</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../edu/ucsb/nceas/metacat/client/Metacat.html#readInlineData-java.lang.String-">readInlineData</a></span>(java.lang.String inlinedataid)</code> <div class="block">Read inline data from the metacat server session, accessed by inlinedataid, and returned as a Reader.</div> </td> </tr> <tr id="i16" class="altColor"> <td class="colFirst"><code>java.lang.String</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../edu/ucsb/nceas/metacat/client/Metacat.html#setAccess-java.lang.String-java.lang.String-">setAccess</a></span>(java.lang.String docid, java.lang.String accessBlock)</code> </td> </tr> <tr id="i17" class="rowColor"> <td class="colFirst"><code>java.lang.String</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../edu/ucsb/nceas/metacat/client/Metacat.html#setAccess-java.lang.String-java.lang.String-java.lang.String-java.lang.String-java.lang.String-">setAccess</a></span>(java.lang.String docid, java.lang.String principal, java.lang.String permission, java.lang.String permType, java.lang.String permOrder)</code> <div class="block">set the access on an XML document in the repository.</div> </td> </tr> <tr id="i18" class="altColor"> <td class="colFirst"><code>void</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../edu/ucsb/nceas/metacat/client/Metacat.html#setEncoding-java.lang.String-">setEncoding</a></span>(java.lang.String encoding)</code> <div class="block">Returns the character encoding used used when communicating with Metacat.</div> </td> </tr> <tr id="i19" class="rowColor"> <td class="colFirst"><code>void</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../edu/ucsb/nceas/metacat/client/Metacat.html#setMetacatUrl-java.lang.String-">setMetacatUrl</a></span>(java.lang.String metacatUrl)</code> <div class="block">When the MetacatFactory creates an instance it needs to set the MetacatUrl to which connections should be made.</div> </td> </tr> <tr id="i20" class="altColor"> <td class="colFirst"><code>void</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../edu/ucsb/nceas/metacat/client/Metacat.html#setSessionId-java.lang.String-">setSessionId</a></span>(java.lang.String sessionId)</code> <div class="block">Set the session identifier for this session.</div> </td> </tr> <tr id="i21" class="rowColor"> <td class="colFirst"><code>java.lang.String</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../edu/ucsb/nceas/metacat/client/Metacat.html#update-java.lang.String-java.io.Reader-java.io.Reader-">update</a></span>(java.lang.String docid, java.io.Reader xmlDocument, java.io.Reader schema)</code> <div class="block">Update an XML document in the repository by providing a new version of the XML document.</div> </td> </tr> <tr id="i22" class="altColor"> <td class="colFirst"><code>java.lang.String</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../edu/ucsb/nceas/metacat/client/Metacat.html#upload-java.lang.String-java.io.File-">upload</a></span>(java.lang.String docid, java.io.File file)</code> <div class="block">Upload a data document into the repository.</div> </td> </tr> <tr id="i23" class="rowColor"> <td class="colFirst"><code>java.lang.String</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../edu/ucsb/nceas/metacat/client/Metacat.html#upload-java.lang.String-java.lang.String-java.io.InputStream-int-">upload</a></span>(java.lang.String docid, java.lang.String fileName, java.io.InputStream fileData, int size)</code> <div class="block">Upload a data document into the repository.</div> </td> </tr> </table> </li> </ul> </li> </ul> </div> <div class="details"> <ul class="blockList"> <li class="blockList"> <!-- ============ METHOD DETAIL ========== --> <ul class="blockList"> <li class="blockList"><a name="method.detail"> <!-- --> </a> <h3>Method Detail</h3> <a name="login-java.lang.String-java.lang.String-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>login</h4> <pre>java.lang.String login(java.lang.String username, java.lang.String password) throws <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatAuthException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatAuthException</a>, <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a></pre> <div class="block">Method used to log in to a metacat server. Implementations will need to cache a cookie value to make the session persistent. Each time a call is made to one of the other methods (e.g., read), the cookie will need to be passed back to the metacat server along with the request.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>username</code> - the username of the user, like an LDAP DN</dd> <dd><code>password</code> - the password for that user for authentication</dd> <dt><span class="returnLabel">Returns:</span></dt> <dd>the response string from metacat in XML format</dd> <dt><span class="throwsLabel">Throws:</span></dt> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatAuthException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatAuthException</a></code> - when the username/password could not be authenticated</dd> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a></code></dd> </dl> </li> </ul> <a name="logout--"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>logout</h4> <pre>java.lang.String logout() throws <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a>, <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a></pre> <div class="block">Method used to log out a metacat server. The Metacat server will end the session when this call is invoked.</div> <dl> <dt><span class="returnLabel">Returns:</span></dt> <dd>the response string from metacat in XML format</dd> <dt><span class="throwsLabel">Throws:</span></dt> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a></code> - when the metacat server can not be reached or does not respond</dd> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a></code></dd> </dl> </li> </ul> <a name="read-java.lang.String-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>read</h4> <pre>java.io.InputStream read(java.lang.String docid) throws <a href="../../../../../edu/ucsb/nceas/metacat/client/InsufficientKarmaException.html" title="class in edu.ucsb.nceas.metacat.client">InsufficientKarmaException</a>, <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a>, <a href="../../../../../edu/ucsb/nceas/metacat/client/DocumentNotFoundException.html" title="class in edu.ucsb.nceas.metacat.client">DocumentNotFoundException</a>, <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a></pre> <div class="block">Read an XML document from the metacat server session, accessed by docid, and returned as a Reader.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>docid</code> - the identifier of the document to be read</dd> <dt><span class="returnLabel">Returns:</span></dt> <dd>a Reader for accessing the document</dd> <dt><span class="throwsLabel">Throws:</span></dt> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/InsufficientKarmaException.html" title="class in edu.ucsb.nceas.metacat.client">InsufficientKarmaException</a></code> - when the user has insufficent rights for the operation</dd> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a></code> - when the metacat server can not be reached or does not respond</dd> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a></code> - when the metacat server generates another error</dd> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/DocumentNotFoundException.html" title="class in edu.ucsb.nceas.metacat.client">DocumentNotFoundException</a></code></dd> </dl> </li> </ul> <a name="readInlineData-java.lang.String-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>readInlineData</h4> <pre>java.io.InputStream readInlineData(java.lang.String inlinedataid) throws <a href="../../../../../edu/ucsb/nceas/metacat/client/InsufficientKarmaException.html" title="class in edu.ucsb.nceas.metacat.client">InsufficientKarmaException</a>, <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a>, <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a></pre> <div class="block">Read inline data from the metacat server session, accessed by inlinedataid, and returned as a Reader.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>inlinedataid</code> - the identifier of the document to be read</dd> <dt><span class="returnLabel">Returns:</span></dt> <dd>a Reader for accessing the document</dd> <dt><span class="throwsLabel">Throws:</span></dt> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/InsufficientKarmaException.html" title="class in edu.ucsb.nceas.metacat.client">InsufficientKarmaException</a></code> - when the user has insufficent rights for the operation</dd> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a></code> - when the metacat server can not be reached or does not respond</dd> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a></code> - when the metacat server generates another error</dd> </dl> </li> </ul> <a name="query-java.io.Reader-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>query</h4> <pre>java.io.Reader query(java.io.Reader xmlQuery) throws <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a>, java.io.IOException</pre> <div class="block">Query the metacat document store with the given metacat-compatible query document, and return the result set as a Reader.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>xmlQuery</code> - a Reader for accessing the XML version of the query</dd> <dt><span class="returnLabel">Returns:</span></dt> <dd>a Reader for accessing the result set</dd> <dt><span class="throwsLabel">Throws:</span></dt> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a></code></dd> <dd><code>java.io.IOException</code></dd> </dl> </li> </ul> <a name="query-java.io.Reader-java.lang.String-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>query</h4> <pre>java.io.Reader query(java.io.Reader xmlQuery, java.lang.String qformat) throws <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a>, java.io.IOException</pre> <div class="block">Query the metacat document store with the given metacat-compatible query document and qformat, and return the result set as a Reader.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>xmlQuery</code> - a Reader for accessing the XML version of the query</dd> <dd><code>qformat</code> - the format of return doc. It can be xml, knb, lter and etal.</dd> <dt><span class="returnLabel">Returns:</span></dt> <dd>a Reader for accessing the result set</dd> <dt><span class="throwsLabel">Throws:</span></dt> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a></code></dd> <dd><code>java.io.IOException</code></dd> </dl> </li> </ul> <a name="insert-java.lang.String-java.io.Reader-java.io.Reader-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>insert</h4> <pre>java.lang.String insert(java.lang.String docid, java.io.Reader xmlDocument, java.io.Reader schema) throws <a href="../../../../../edu/ucsb/nceas/metacat/client/InsufficientKarmaException.html" title="class in edu.ucsb.nceas.metacat.client">InsufficientKarmaException</a>, <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a>, java.io.IOException, <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a></pre> <div class="block">Insert an XML document into the repository, making it available for searching using the query() methods.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>docid</code> - the docid to insert the document</dd> <dd><code>xmlDocument</code> - a Reader for accessing the XML document to be inserted</dd> <dd><code>schema</code> - a Reader for accessing the DTD or XML Schema for the document</dd> <dt><span class="returnLabel">Returns:</span></dt> <dd>the metacat response message</dd> <dt><span class="throwsLabel">Throws:</span></dt> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/InsufficientKarmaException.html" title="class in edu.ucsb.nceas.metacat.client">InsufficientKarmaException</a></code> - when the user has insufficent rights for the operation</dd> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a></code> - when the metacat server can not be reached or does not respond</dd> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a></code> - when the metacat server generates another error</dd> <dd><code>java.io.IOException</code> - when there is an error reading the xml document</dd> </dl> </li> </ul> <a name="update-java.lang.String-java.io.Reader-java.io.Reader-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>update</h4> <pre>java.lang.String update(java.lang.String docid, java.io.Reader xmlDocument, java.io.Reader schema) throws <a href="../../../../../edu/ucsb/nceas/metacat/client/InsufficientKarmaException.html" title="class in edu.ucsb.nceas.metacat.client">InsufficientKarmaException</a>, <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a>, java.io.IOException, <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a></pre> <div class="block">Update an XML document in the repository by providing a new version of the XML document. The new version is placed in the search index, and older versions are archived (accessible by read(), but not in the search index).</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>docid</code> - the docid to update</dd> <dd><code>xmlDocument</code> - a Reader for accessing the XML text to be updated</dd> <dd><code>schema</code> - a Reader for accessing the DTD or XML Schema for the document</dd> <dt><span class="returnLabel">Returns:</span></dt> <dd>the metacat response message</dd> <dt><span class="throwsLabel">Throws:</span></dt> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/InsufficientKarmaException.html" title="class in edu.ucsb.nceas.metacat.client">InsufficientKarmaException</a></code> - when the user has insufficent rights for the operation</dd> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a></code> - when the metacat server can not be reached or does not respond</dd> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a></code> - when the metacat server generates another error</dd> <dd><code>java.io.IOException</code> - when there is an error reading the xml document</dd> </dl> </li> </ul> <a name="upload-java.lang.String-java.io.File-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>upload</h4> <pre>java.lang.String upload(java.lang.String docid, java.io.File file) throws <a href="../../../../../edu/ucsb/nceas/metacat/client/InsufficientKarmaException.html" title="class in edu.ucsb.nceas.metacat.client">InsufficientKarmaException</a>, <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a>, java.io.IOException, <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a></pre> <div class="block">Upload a data document into the repository. Data files are stored on metacat and may be in any format (binary or text), but they are all treated as if they were binary. Data files are not searched by the query() methods because they are not loaded into the XML store because they are not XML documents. The File parameter is used to determine a name for the uploaded document.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>docid</code> - the identifier to be used for the document</dd> <dd><code>file</code> - the File to be uploaded</dd> <dd><code>document</code> - a InputStream containing the data to be uploaded</dd> <dt><span class="returnLabel">Returns:</span></dt> <dd>the metacat response message</dd> <dt><span class="throwsLabel">Throws:</span></dt> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/InsufficientKarmaException.html" title="class in edu.ucsb.nceas.metacat.client">InsufficientKarmaException</a></code> - when the user has insufficent rights for the operation</dd> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a></code> - when the metacat server can not be reached or does not respond</dd> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a></code> - when the metacat server generates another error</dd> <dd><code>java.io.IOException</code> - when there is an error reading the xml document</dd> </dl> </li> </ul> <a name="upload-java.lang.String-java.lang.String-java.io.InputStream-int-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>upload</h4> <pre>java.lang.String upload(java.lang.String docid, java.lang.String fileName, java.io.InputStream fileData, int size) throws <a href="../../../../../edu/ucsb/nceas/metacat/client/InsufficientKarmaException.html" title="class in edu.ucsb.nceas.metacat.client">InsufficientKarmaException</a>, <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a>, java.io.IOException, <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a></pre> <div class="block">Upload a data document into the repository. Data files are stored on metacat and may be in any format (binary or text), but they are all treated as if they were binary. Data files are not searched by the query() methods because they are not loaded into the XML store because they are not XML documents. The name for the document is set explicitly using the filename parameter.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>docid</code> - the identifier to be used for the document</dd> <dd><code>filename</code> - the name to be used in the MIME description of the uploaded file</dd> <dd><code>document</code> - a InputStream containing the data to be uploaded</dd> <dt><span class="returnLabel">Returns:</span></dt> <dd>the metacat response message</dd> <dt><span class="throwsLabel">Throws:</span></dt> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/InsufficientKarmaException.html" title="class in edu.ucsb.nceas.metacat.client">InsufficientKarmaException</a></code> - when the user has insufficent rights for the operation</dd> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a></code> - when the metacat server can not be reached or does not respond</dd> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a></code> - when the metacat server generates another error</dd> <dd><code>java.io.IOException</code> - when there is an error reading the xml document</dd> </dl> </li> </ul> <a name="delete-java.lang.String-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>delete</h4> <pre>java.lang.String delete(java.lang.String docid) throws <a href="../../../../../edu/ucsb/nceas/metacat/client/InsufficientKarmaException.html" title="class in edu.ucsb.nceas.metacat.client">InsufficientKarmaException</a>, <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a>, <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a></pre> <div class="block">Delete an XML document in the repository.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>docid</code> - the docid to delete</dd> <dt><span class="returnLabel">Returns:</span></dt> <dd>the metacat response message</dd> <dt><span class="throwsLabel">Throws:</span></dt> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/InsufficientKarmaException.html" title="class in edu.ucsb.nceas.metacat.client">InsufficientKarmaException</a></code> - when the user has insufficent rights for the operation</dd> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a></code> - when the metacat server can not be reached or does not respond</dd> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a></code> - when the metacat server generates another error</dd> </dl> </li> </ul> <a name="getAccessControl-java.lang.String-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>getAccessControl</h4> <pre>java.lang.String getAccessControl(java.lang.String docid) throws <a href="../../../../../edu/ucsb/nceas/metacat/client/InsufficientKarmaException.html" title="class in edu.ucsb.nceas.metacat.client">InsufficientKarmaException</a>, <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a>, <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a></pre> <dl> <dt><span class="throwsLabel">Throws:</span></dt> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/InsufficientKarmaException.html" title="class in edu.ucsb.nceas.metacat.client">InsufficientKarmaException</a></code></dd> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a></code></dd> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a></code></dd> </dl> </li> </ul> <a name="setAccess-java.lang.String-java.lang.String-java.lang.String-java.lang.String-java.lang.String-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>setAccess</h4> <pre>java.lang.String setAccess(java.lang.String docid, java.lang.String principal, java.lang.String permission, java.lang.String permType, java.lang.String permOrder) throws <a href="../../../../../edu/ucsb/nceas/metacat/client/InsufficientKarmaException.html" title="class in edu.ucsb.nceas.metacat.client">InsufficientKarmaException</a>, <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a>, <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a></pre> <div class="block">set the access on an XML document in the repository.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>_docid</code> - the docid of the document for which the access should be applied.</dd> <dd><code>_principal</code> - the document's principal</dd> <dd><code>_permission</code> - the access permission to be applied to the docid {e.g. read,write,all}</dd> <dd><code>_permType</code> - the permission type to be applied to the document {e.g. allow or deny}</dd> <dd><code>_permOrder</code> - the order that the document's permissions should be processed {e.g. denyFirst or allowFirst}</dd> <dt><span class="returnLabel">Returns:</span></dt> <dd>the metacat response message</dd> <dt><span class="throwsLabel">Throws:</span></dt> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/InsufficientKarmaException.html" title="class in edu.ucsb.nceas.metacat.client">InsufficientKarmaException</a></code> - when the user has insufficent rights for the operation</dd> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a></code> - when the metacat server can not be reached or does not respond</dd> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a></code> - when the metacat server generates another error</dd> </dl> </li> </ul> <a name="setAccess-java.lang.String-java.lang.String-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>setAccess</h4> <pre>java.lang.String setAccess(java.lang.String docid, java.lang.String accessBlock) throws <a href="../../../../../edu/ucsb/nceas/metacat/client/InsufficientKarmaException.html" title="class in edu.ucsb.nceas.metacat.client">InsufficientKarmaException</a>, <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a>, <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a></pre> <dl> <dt><span class="throwsLabel">Throws:</span></dt> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/InsufficientKarmaException.html" title="class in edu.ucsb.nceas.metacat.client">InsufficientKarmaException</a></code></dd> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a></code></dd> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a></code></dd> </dl> </li> </ul> <a name="setMetacatUrl-java.lang.String-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>setMetacatUrl</h4> <pre>void setMetacatUrl(java.lang.String metacatUrl)</pre> <div class="block">When the MetacatFactory creates an instance it needs to set the MetacatUrl to which connections should be made.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>metacatUrl</code> - the URL for the metacat server</dd> </dl> </li> </ul> <a name="getSessionId--"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>getSessionId</h4> <pre>java.lang.String getSessionId()</pre> <div class="block">Get the session identifier for this session.</div> </li> </ul> <a name="setSessionId-java.lang.String-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>setSessionId</h4> <pre>void setSessionId(java.lang.String sessionId)</pre> <div class="block">Set the session identifier for this session. This identifier was previously established with a call to login. To continue to use the same session, set the session id before making a call to one of the metacat access methods (e.g., read, query, insert, etc.).</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>String</code> - the sessionId from a previously established session</dd> </dl> </li> </ul> <a name="getloggedinuserinfo--"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>getloggedinuserinfo</h4> <pre>java.lang.String getloggedinuserinfo() throws <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a></pre> <div class="block">Get the logged in user for this session.</div> <dl> <dt><span class="throwsLabel">Throws:</span></dt> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatInaccessibleException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatInaccessibleException</a></code></dd> </dl> </li> </ul> <a name="getNewestDocRevision-java.lang.String-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>getNewestDocRevision</h4> <pre>int getNewestDocRevision(java.lang.String docId) throws <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a></pre> <div class="block">The method will return the latest revision in metacat server for a given document id. If some error happens, this method will throw an exception.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>docId</code> - String the given docid you want to use. the docid it self can have or haven't revision number</dd> <dt><span class="throwsLabel">Throws:</span></dt> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a></code></dd> </dl> </li> </ul> <a name="getLastDocid-java.lang.String-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>getLastDocid</h4> <pre>java.lang.String getLastDocid(java.lang.String scope) throws <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a></pre> <div class="block">Return the highest document id for a given scope. This is used by clients to make it easier to determine the next free identifier in a sequence for a given scope.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>scope</code> - String the scope to use for looking up the latest id</dd> <dt><span class="throwsLabel">Throws:</span></dt> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a></code> - when an error occurs</dd> </dl> </li> </ul> <a name="getAllDocids-java.lang.String-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>getAllDocids</h4> <pre>java.util.Vector getAllDocids(java.lang.String scope) throws <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a></pre> <div class="block">return a list of all docids that match a given scope. if scope is null return all docids registered in the system</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>scope</code> - String the scope to use to limit the docid query</dd> <dt><span class="throwsLabel">Throws:</span></dt> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a></code> - when an error occurs</dd> </dl> </li> </ul> <a name="isRegistered-java.lang.String-"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>isRegistered</h4> <pre>boolean isRegistered(java.lang.String docid) throws <a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a></pre> <div class="block">return true of the given docid is registered, false if not</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>scope</code> - String the scope to use to limit the docid query</dd> <dt><span class="throwsLabel">Throws:</span></dt> <dd><code><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatException.html" title="class in edu.ucsb.nceas.metacat.client">MetacatException</a></code> - when an error occurs</dd> </dl> </li> </ul> <a name="getEncoding--"> <!-- --> </a> <ul class="blockList"> <li class="blockList"> <h4>getEncoding</h4> <pre>java.lang.String getEncoding()</pre> <div class="block">Returns the character encoding used used when communicating with Metacat.</div> <dl> <dt><span class="returnLabel">Returns:</span></dt> <dd>character encoding name</dd> </dl> </li> </ul> <a name="setEncoding-java.lang.String-"> <!-- --> </a> <ul class="blockListLast"> <li class="blockList"> <h4>setEncoding</h4> <pre>void setEncoding(java.lang.String encoding)</pre> <div class="block">Returns the character encoding used used when communicating with Metacat.</div> <dl> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>encoding</code> - The encoding (i.e. "UTF-8")</dd> </dl> </li> </ul> </li> </ul> </li> </ul> </div> </div> <!-- ========= END OF CLASS DATA ========= --> <!-- ======= START OF BOTTOM NAVBAR ====== --> <div class="bottomNav"><a name="navbar.bottom"> <!-- --> </a> <div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div> <a name="navbar.bottom.firstrow"> <!-- --> </a> <ul class="navList" title="Navigation"> <li><a href="../../../../../overview-summary.html">Overview</a></li> <li><a href="package-summary.html">Package</a></li> <li class="navBarCell1Rev">Class</li> <li><a href="class-use/Metacat.html">Use</a></li> <li><a href="package-tree.html">Tree</a></li> <li><a href="../../../../../deprecated-list.html">Deprecated</a></li> <li><a href="../../../../../index-all.html">Index</a></li> <li><a href="../../../../../help-doc.html">Help</a></li> </ul> </div> <div class="subNav"> <ul class="navList"> <li><a href="../../../../../edu/ucsb/nceas/metacat/client/InsufficientKarmaException.html" title="class in edu.ucsb.nceas.metacat.client"><span class="typeNameLink">Prev Class</span></a></li> <li><a href="../../../../../edu/ucsb/nceas/metacat/client/MetacatAuthException.html" title="class in edu.ucsb.nceas.metacat.client"><span class="typeNameLink">Next Class</span></a></li> </ul> <ul class="navList"> <li><a href="../../../../../index.html?edu/ucsb/nceas/metacat/client/Metacat.html" target="_top">Frames</a></li> <li><a href="Metacat.html" target="_top">No Frames</a></li> </ul> <ul class="navList" id="allclasses_navbar_bottom"> <li><a href="../../../../../allclasses-noframe.html">All Classes</a></li> </ul> <div> <script type="text/javascript"><!-- allClassesLink = document.getElementById("allclasses_navbar_bottom"); if(window==top) { allClassesLink.style.display = "block"; } else { allClassesLink.style.display = "none"; } //--> </script> </div> <div> <ul class="subNavList"> <li>Summary: </li> <li>Nested | </li> <li>Field | </li> <li>Constr | </li> <li><a href="#method.summary">Method</a></li> </ul> <ul class="subNavList"> <li>Detail: </li> <li>Field | </li> <li>Constr | </li> <li><a href="#method.detail">Method</a></li> </ul> </div> <a name="skip.navbar.bottom"> <!-- --> </a></div> <!-- ======== END OF BOTTOM NAVBAR ======= --> <p class="legalCopy"><small><i>Copyright © 2020 Regents of the University of California. All Rights Reserved.</i></small></p> </body> </html>