L05DOCBST-38 add get_hits method

src/library/Webquery.php

@@ -343,6 +343,22 @@ class Webquery {
     }
 
 
+    /**
+     * return value of the hits element in search response
+     * @return number of hits or false if there is no valid search reponse
+     */
+    public function get_hits() {
+
+        $resp_xml = $this->get_resp_xml();
+        if (!isset($resp_xml)) {
+            return false;
+        }
+
+        $hits = $resp_xml->xpath("//hits");
+        return empty($hits) ? false : (string) $hits[0];
+    }
+
+
     /**
      * @return boolean true if response contains next element
      */

tests/library/WebqueryTest.php

@@ -140,6 +140,7 @@ EOT;
         $this->assertEquals($expect, $records, '1st: search response records');
         $this->assertEquals('', $wq->get_error_code(), '1st: search response error code');
         $this->assertEquals('', $wq->get_error_message(), '1st: search response error message');
+        $this->assertEquals(1, $wq->get_hits(), '1st: search response hits');
 
         // second request fails
         $wq->set_query('record=nothing');
@@ -160,6 +161,7 @@ EOT;
         $this->assertEquals($expect, $records, '2nd: search response records');
         $this->assertEquals('WQW_NO_HITS', $wq->get_error_code(), '2nd: search response error code');
         $this->assertEquals('nothing found', $wq->get_error_message(), '2nd: search response error message');
+        $this->assertEquals(false, $wq->get_hits(), '2nd: search response hits');
 
         $this->assertEquals(2, count($request_history), 'request history count');
         // check first request