<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html 
     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html>
<head>
  <title>read (Metacat)</title>
  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
</head>
<body class="standalone-code">
  <pre><span class="ruby-comment cmt"># File lib/metacat.rb, line 199</span>
  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">read</span>(<span class="ruby-identifier">docid</span>, <span class="ruby-identifier">options</span> = {}, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>) <span class="ruby-comment cmt"># :yields: xml or data_table fragment</span>
    <span class="ruby-identifier">data</span> = {
      <span class="ruby-value str">'action'</span>  =<span class="ruby-operator">&gt;</span>  <span class="ruby-value str">'read'</span>,
      <span class="ruby-value str">'qformat'</span> =<span class="ruby-operator">&gt;</span>  <span class="ruby-value str">'xml'</span>,
      <span class="ruby-value str">'docid'</span>   =<span class="ruby-operator">&gt;</span>  <span class="ruby-identifier">docid</span>
    }
    <span class="ruby-identifier">metacat_get</span>(<span class="ruby-identifier">data</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">response</span><span class="ruby-operator">|</span>
      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">response</span>.<span class="ruby-identifier">content_type</span> <span class="ruby-operator">==</span> <span class="ruby-value str">'text/xml'</span>
        <span class="ruby-identifier">doc</span> = <span class="ruby-constant">REXML</span><span class="ruby-operator">::</span><span class="ruby-constant">Document</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">response</span>.<span class="ruby-identifier">read_body</span>)
        <span class="ruby-keyword kw">if</span>(<span class="ruby-identifier">doc</span>.<span class="ruby-identifier">root</span>.<span class="ruby-identifier">name</span> <span class="ruby-operator">==</span> <span class="ruby-value str">'error'</span>)
          <span class="ruby-keyword kw">if</span>(<span class="ruby-identifier">doc</span>.<span class="ruby-identifier">root</span>.<span class="ruby-identifier">text</span>.<span class="ruby-identifier">match</span>(<span class="ruby-value str">'permission'</span>))
            <span class="ruby-identifier">raise</span> <span class="ruby-constant">MetacatPermissionDenied</span>, <span class="ruby-identifier">doc</span>.<span class="ruby-identifier">root</span>.<span class="ruby-identifier">text</span>
          <span class="ruby-keyword kw">elsif</span>(<span class="ruby-identifier">doc</span>.<span class="ruby-identifier">root</span>.<span class="ruby-identifier">text</span>.<span class="ruby-identifier">match</span>(<span class="ruby-value str">'does not exist'</span>))
            <span class="ruby-comment cmt"># Nothing found, return nil</span>
            <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
          <span class="ruby-keyword kw">else</span>
            <span class="ruby-identifier">raise</span> <span class="ruby-value str">'Unrecognized response from metacat: '</span><span class="ruby-operator">+</span><span class="ruby-identifier">doc</span>.<span class="ruby-identifier">root</span>.<span class="ruby-identifier">text</span>
          <span class="ruby-keyword kw">end</span>
        <span class="ruby-keyword kw">else</span> <span class="ruby-comment cmt"># xml data</span>
          <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">doc</span>
        <span class="ruby-keyword kw">end</span>
      <span class="ruby-keyword kw">else</span> <span class="ruby-comment cmt"># probably a data table</span>
        <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">options</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-value str">'only_eml'</span>) <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">options</span>[<span class="ruby-value str">'only_eml'</span>] <span class="ruby-operator">==</span> <span class="ruby-keyword kw">true</span>)
          <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span>
        <span class="ruby-keyword kw">else</span>
          <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
            <span class="ruby-identifier">response</span>.<span class="ruby-identifier">read_body</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">buffer</span><span class="ruby-operator">|</span> <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">buffer</span> }
          <span class="ruby-keyword kw">else</span>
            <span class="ruby-identifier">response</span>.<span class="ruby-identifier">read_body</span>
          <span class="ruby-keyword kw">end</span>
        <span class="ruby-keyword kw">end</span>
      <span class="ruby-keyword kw">end</span>      
    <span class="ruby-keyword kw">end</span>
  <span class="ruby-keyword kw">end</span></pre>
</body>
</html>