dedalozzo / eoc-client

   * @retval string The document's revision.

   * @see http://docs.couchdb.org/en/latest/api/document/attachments.html#db-doc-attachment

   */

  public function getAttachmentInfo($dbName, $fileName, $path, $docId, $rev = NULL) {

    $this->validateDocPath($path, TRUE);

    $this->validateAndEncodeDocId($docId);

    $path = "/".rawurlencode($this->prefix.$dbName)."/".$path.$docId."/".$fileName;

    $request = new Request(Request::HEAD_METHOD, $path);

    // In case we want retrieve a specific document revision.

    if (!empty($rev))

      $request->setQueryParam("rev", (string)$rev);

    return $this->send($request);

  }

  /**

   * @see http://docs.couchdb.org/en/latest/api/document/attachments.html#http-range-requests

   * @todo Add support for Range request, using header "Range: bytes=0-12".

   */

  public function getAttachment($dbName, $fileName, $path, $docId, $rev = NULL) {

    $this->validateDocPath($path, TRUE);

    $this->validateAndEncodeDocId($docId);

    $path = "/".rawurlencode($this->prefix.$dbName)."/".$path.$docId."/".$fileName;

    $request = new Request(Request::GET_METHOD, $path);

    // In case we want retrieve a specific document revision.

    if (!empty($rev))

      $request->setQueryParam("rev", (string)$rev);

    return $this->send($request)->getBody();

  }

  /**

   * @param[in] string $rev The document's revision.

   * @see http://docs.couchdb.org/en/latest/api/document/attachments.html#delete--db-docid-attname

   */

  public function deleteAttachment($dbName, $fileName, $path, $docId, $rev) {

    $this->validateDocPath($path, TRUE);

    $this->validateAndEncodeDocId($docId);

    $path = "/".rawurlencode($this->prefix.$dbName)."/".$path.$docId."/".rawurlencode($fileName);

    $request = new Request(Request::DELETE_METHOD, $path);

    $request->setQueryParam("rev", (string)$rev);

    return $this->send($request);

  }

  //!@}