candidateuri.html

用JAVA编写的,在做实验的时候留下来的,本来想删的,但是传上来,大家分享吧

<a name="538" href="#538">538</a>         getAList().putInt(key, value);
<a name="539" href="#539">539</a>     }
<a name="540" href="#540">540</a>     
<a name="541" href="#541">541</a>     <strong>public</strong> <strong>boolean</strong> containsKey(String key) {
<a name="542" href="#542">542</a>         <strong>return</strong> getAList().containsKey(key);
<a name="543" href="#543">543</a>     }
<a name="544" href="#544">544</a>     
<a name="545" href="#545">545</a>     <strong>public</strong> <strong>void</strong> remove(String key) {
<a name="546" href="#546">546</a>         getAList().remove(key);
<a name="547" href="#547">547</a>     }
<a name="548" href="#548">548</a>     
<a name="549" href="#549">549</a>     <strong>public</strong> Iterator keys() {
<a name="550" href="#550">550</a>         <strong>return</strong> getAList().getKeys();
<a name="551" href="#551">551</a>     }
<a name="552" href="#552">552</a>     
<a name="553" href="#553">553</a>     <em>/**<em>*</em></em>
<a name="554" href="#554">554</a> <em>     * @return True if this CandidateURI was result of a redirect:</em>
<a name="555" href="#555">555</a> <em>     * i.e. Its parent URI redirected to here, this URI was what was in </em>
<a name="556" href="#556">556</a> <em>     * the 'Location:' or 'Content-Location:' HTTP Header.</em>
<a name="557" href="#557">557</a> <em>     */</em>
<a name="558" href="#558">558</a>     <strong>public</strong> <strong>boolean</strong> isLocation() {
<a name="559" href="#559">559</a>         <strong>return</strong> <strong>this</strong>.pathFromSeed != <strong>null</strong> &amp;&amp; <strong>this</strong>.pathFromSeed.length() > 0 &amp;&amp;
<a name="560" href="#560">560</a>             <strong>this</strong>.pathFromSeed.charAt(<strong>this</strong>.pathFromSeed.length() - 1) ==
<a name="561" href="#561">561</a>                 Link.REFER_HOP;
<a name="562" href="#562">562</a>     }
<a name="563" href="#563">563</a> 
<a name="564" href="#564">564</a>     <em>/**<em>*</em></em>
<a name="565" href="#565">565</a> <em>     * Custom serialization writing 'uuri' and 'via' as Strings, rather</em>
<a name="566" href="#566">566</a> <em>     * than the bloated full serialization of their object classes, and </em>
<a name="567" href="#567">567</a> <em>     * an empty alist as 'null'. Shrinks serialized form by 50% or more</em>
<a name="568" href="#568">568</a> <em>     * in short tests. </em>
<a name="569" href="#569">569</a> <em>     * </em>
<a name="570" href="#570">570</a> <em>     * @param stream</em>
<a name="571" href="#571">571</a> <em>     * @throws IOException</em>
<a name="572" href="#572">572</a> <em>     */</em>
<a name="573" href="#573">573</a>     <strong>private</strong> <strong>void</strong> writeObject(ObjectOutputStream stream)
<a name="574" href="#574">574</a>         throws IOException {
<a name="575" href="#575">575</a>         stream.defaultWriteObject();
<a name="576" href="#576">576</a>         stream.writeUTF(uuri.toString());
<a name="577" href="#577">577</a>         stream.writeObject((via == <strong>null</strong>) ? <strong>null</strong> : via.getURI());
<a name="578" href="#578">578</a>         stream.writeObject((alist==<strong>null</strong>) ? <strong>null</strong> : alist);
<a name="579" href="#579">579</a>     }
<a name="580" href="#580">580</a> 
<a name="581" href="#581">581</a>     <em>/**<em>*</em></em>
<a name="582" href="#582">582</a> <em>     * Custom deserialization to reconstruct UURI instances from more</em>
<a name="583" href="#583">583</a> <em>     * compact Strings. </em>
<a name="584" href="#584">584</a> <em>     * </em>
<a name="585" href="#585">585</a> <em>     * @param stream</em>
<a name="586" href="#586">586</a> <em>     * @throws IOException</em>
<a name="587" href="#587">587</a> <em>     * @throws ClassNotFoundException</em>
<a name="588" href="#588">588</a> <em>     */</em>
<a name="589" href="#589">589</a>     <strong>private</strong> <strong>void</strong> readObject(ObjectInputStream stream)
<a name="590" href="#590">590</a>         throws IOException, ClassNotFoundException {
<a name="591" href="#591">591</a>         stream.defaultReadObject();
<a name="592" href="#592">592</a>         uuri = readUuri(stream.readUTF());
<a name="593" href="#593">593</a>         via = readUuri((String)stream.readObject());
<a name="594" href="#594">594</a>         alist = (AList) stream.readObject();
<a name="595" href="#595">595</a>     }
<a name="596" href="#596">596</a> 
<a name="597" href="#597">597</a>     <em>/**<em>*</em></em>
<a name="598" href="#598">598</a> <em>     * Read a UURI from a String, handling a null or URIException</em>
<a name="599" href="#599">599</a> <em>     * </em>
<a name="600" href="#600">600</a> <em>     * @param u String or null from which to create UURI</em>
<a name="601" href="#601">601</a> <em>     * @return the best UURI instance creatable</em>
<a name="602" href="#602">602</a> <em>     */</em>
<a name="603" href="#603">603</a>     <strong>protected</strong> <a href="../../../../org/archive/net/UURI.html">UURI</a> readUuri(String u) {
<a name="604" href="#604">604</a>         <strong>if</strong> (u == <strong>null</strong>) {
<a name="605" href="#605">605</a>             <strong>return</strong> <strong>null</strong>;
<a name="606" href="#606">606</a>         }
<a name="607" href="#607">607</a>         <strong>try</strong> {
<a name="608" href="#608">608</a>             <strong>return</strong> UURIFactory.getInstance(u);
<a name="609" href="#609">609</a>         } <strong>catch</strong> (URIException ux) {
<a name="610" href="#610">610</a>             <em class="comment">// simply continue to next try</em>
<a name="611" href="#611">611</a>         }
<a name="612" href="#612">612</a>         <strong>try</strong> {
<a name="613" href="#613">613</a>             <em class="comment">// try adding an junk scheme</em>
<a name="614" href="#614">614</a>             <strong>return</strong> UURIFactory.getInstance(<span class="string">"invalid:"</span> + u);
<a name="615" href="#615">615</a>         } <strong>catch</strong> (URIException ux) {
<a name="616" href="#616">616</a>             ux.printStackTrace();
<a name="617" href="#617">617</a>             <em class="comment">// ignored; method continues</em>
<a name="618" href="#618">618</a>         }
<a name="619" href="#619">619</a>         <strong>try</strong> {
<a name="620" href="#620">620</a>             <em class="comment">// return total junk</em>
<a name="621" href="#621">621</a>             <strong>return</strong> UURIFactory.getInstance(<span class="string">"invalid:"</span>);
<a name="622" href="#622">622</a>         } <strong>catch</strong> (URIException e) {
<a name="623" href="#623">623</a>             e.printStackTrace();
<a name="624" href="#624">624</a>             <strong>return</strong> <strong>null</strong>;
<a name="625" href="#625">625</a>         }
<a name="626" href="#626">626</a>     }
<a name="627" href="#627">627</a>     
<a name="628" href="#628">628</a>     <em class="comment">//</em>
<a name="629" href="#629">629</a>     <em class="comment">// Reporter implementation</em>
<a name="630" href="#630">630</a>     <em class="comment">//</em>
<a name="631" href="#631">631</a> 
<a name="632" href="#632">632</a>     <strong>public</strong> String singleLineReport() {
<a name="633" href="#633">633</a>         <strong>return</strong> ArchiveUtils.singleLineReport(<strong>this</strong>);
<a name="634" href="#634">634</a>     }
<a name="635" href="#635">635</a>     
<a name="636" href="#636">636</a>     <strong>public</strong> <strong>void</strong> singleLineReportTo(PrintWriter w) {
<a name="637" href="#637">637</a>         String className = <strong>this</strong>.getClass().getName();
<a name="638" href="#638">638</a>         className = className.substring(className.lastIndexOf(<span class="string">"."</span>)+1);
<a name="639" href="#639">639</a>         w.print(className);
<a name="640" href="#640">640</a>         w.print(<span class="string">" "</span>);
<a name="641" href="#641">641</a>         w.print(getUURI().toString());
<a name="642" href="#642">642</a>         w.print(<span class="string">" "</span>);
<a name="643" href="#643">643</a>         w.print(pathFromSeed);
<a name="644" href="#644">644</a>         w.print(<span class="string">" "</span>);
<a name="645" href="#645">645</a>         w.print(flattenVia());
<a name="646" href="#646">646</a>     }
<a name="647" href="#647">647</a> 
<a name="648" href="#648">648</a>     <em class="comment">/*<em class="comment"> (non-Javadoc)</em></em>
<a name="649" href="#649">649</a> <em class="comment">     * @see org.archive.util.Reporter#singleLineLegend()</em>
<a name="650" href="#650">650</a> <em class="comment">     */</em>
<a name="651" href="#651">651</a>     <strong>public</strong> String singleLineLegend() {
<a name="652" href="#652">652</a>         <strong>return</strong> <span class="string">"className uri hopsPath viaUri"</span>;
<a name="653" href="#653">653</a>     }
<a name="654" href="#654">654</a>     
<a name="655" href="#655">655</a>     <em class="comment">/*<em class="comment"> (non-Javadoc)</em></em>
<a name="656" href="#656">656</a> <em class="comment">     * @see org.archive.util.Reporter#getReports()</em>
<a name="657" href="#657">657</a> <em class="comment">     */</em>
<a name="658" href="#658">658</a>     <strong>public</strong> String[] getReports() {
<a name="659" href="#659">659</a>         <em class="comment">// none but default: empty options</em>
<a name="660" href="#660">660</a>         <strong>return</strong> <strong>new</strong> String[] {};
<a name="661" href="#661">661</a>     }
<a name="662" href="#662">662</a> 
<a name="663" href="#663">663</a>     <em class="comment">/*<em class="comment"> (non-Javadoc)</em></em>
<a name="664" href="#664">664</a> <em class="comment">     * @see org.archive.util.Reporter#reportTo(java.lang.String, java.io.Writer)</em>
<a name="665" href="#665">665</a> <em class="comment">     */</em>
<a name="666" href="#666">666</a>     <strong>public</strong> <strong>void</strong> reportTo(String name, PrintWriter writer) {
<a name="667" href="#667">667</a>         singleLineReportTo(writer);
<a name="668" href="#668">668</a>         writer.print(<span class="string">"\n"</span>);
<a name="669" href="#669">669</a>     }
<a name="670" href="#670">670</a> 
<a name="671" href="#671">671</a>     <em class="comment">/*<em class="comment"> (non-Javadoc)</em></em>
<a name="672" href="#672">672</a> <em class="comment">     * @see org.archive.util.Reporter#reportTo(java.io.Writer)</em>
<a name="673" href="#673">673</a> <em class="comment">     */</em>
<a name="674" href="#674">674</a>     <strong>public</strong> <strong>void</strong> reportTo(PrintWriter writer) throws IOException {
<a name="675" href="#675">675</a>         reportTo(<strong>null</strong>,writer);
<a name="676" href="#676">676</a>     }
<a name="677" href="#677">677</a> 
<a name="678" href="#678">678</a>     <em>/**<em>* Make the given key 'heritable', meaning its value will be </em></em>
<a name="679" href="#679">679</a> <em>     * added to descendant CandidateURIs. Only keys with immutable</em>
<a name="680" href="#680">680</a> <em>     * values should be made heritable -- the value instance may </em>
<a name="681" href="#681">681</a> <em>     * be shared until the AList is serialized/deserialized. </em>
<a name="682" href="#682">682</a> <em>     * </em>
<a name="683" href="#683">683</a> <em>     * @param key to make heritable</em>
<a name="684" href="#684">684</a> <em>     */</em>
<a name="685" href="#685">685</a>     <strong>public</strong> <strong>void</strong> makeHeritable(String key) {
<a name="686" href="#686">686</a>         List heritableKeys = (List) getObject(A_HERITABLE_KEYS);
<a name="687" href="#687">687</a>         <strong>if</strong>(heritableKeys==<strong>null</strong>) {
<a name="688" href="#688">688</a>             heritableKeys = <strong>new</strong> ArrayList();
<a name="689" href="#689">689</a>             heritableKeys.add(A_HERITABLE_KEYS);
<a name="690" href="#690">690</a>             putObject(A_HERITABLE_KEYS,heritableKeys);
<a name="691" href="#691">691</a>         }
<a name="692" href="#692">692</a>         heritableKeys.add(key);
<a name="693" href="#693">693</a>     }
<a name="694" href="#694">694</a>     
<a name="695" href="#695">695</a>     <em>/**<em>* Make the given key non-'heritable', meaning its value will </em></em>
<a name="696" href="#696">696</a> <em>     * not be added to descendant CandidateURIs. Only meaningful if</em>
<a name="697" href="#697">697</a> <em>     * key was previously made heritable.  </em>
<a name="698" href="#698">698</a> <em>     * </em>
<a name="699" href="#699">699</a> <em>     * @param key to make non-heritable</em>
<a name="700" href="#700">700</a> <em>     */</em>
<a name="701" href="#701">701</a>     <strong>public</strong> <strong>void</strong> makeNonHeritable(String key) {
<a name="702" href="#702">702</a>         List heritableKeys = (List) getObject(A_HERITABLE_KEYS);
<a name="703" href="#703">703</a>         <strong>if</strong>(heritableKeys==<strong>null</strong>) {
<a name="704" href="#704">704</a>             <strong>return</strong>;
<a name="705" href="#705">705</a>         }
<a name="706" href="#706">706</a>         heritableKeys.remove(key);
<a name="707" href="#707">707</a>         <strong>if</strong>(heritableKeys.size()==1) {
<a name="708" href="#708">708</a>             <em class="comment">// only remaining heritable key is itself; disable completely</em>
<a name="709" href="#709">709</a>             remove(A_HERITABLE_KEYS);
<a name="710" href="#710">710</a>         }
<a name="711" href="#711">711</a>     }
<a name="712" href="#712">712</a> }
</pre>
<hr/><div id="footer">This page was automatically generated by <a href="http://maven.apache.org/">Maven</a></div></body>
</html>