Merge pull request #145 from einorler/parent_inner_hits

Parent inner hits

docs/InnerHits/Parent.md

+# Parent Inner Hits
+
+> More info about inner hits is in the [official elasticsearch docs][1]
+
+The `parent/child` inner_hits can be used to include parent or child. 
+The usage of parent inner hits is very similar to that of nested [inner hits](Nested.md), the only
+difference is that in stead of passing the `path` to the nested object, the parent/child `type` 
+needs to be passed to the `$path` variable. 
+
+## Simple example
+
+```JSON
+{
+    "inner_hits" : {
+        "children" : {
+            "type" : {
+                "article" : {
+                    "query" : {
+                        "match" : {"title" : "[actual query]"}
+                    }
+                }
+            }
+        }
+    }
+}
+```
+
+And now the query via DSL:
+
+```php
+$matchQuery = new MatchQuery('title', '[actual query]');
+$innerHit = new ParentInnerHit('children', 'article', $matchQuery);
+
+$search = new Search();
+$search->addInnerHit($innerHit);
+$search->toArray();
+```
+
+[1]: https://www.elastic.co/guide/en/elasticsearch/reference/current/search-request-inner-hits.html

src/InnerHit/ParentInnerHit.php

+<?php
+
+namespace ONGR\ElasticsearchDSL\InnerHit;
+
+class ParentInnerHit extends NestedInnerHit
+{
+    /**
+     * {@inheritdoc}
+     */
+    public function getType()
+    {
+        return 'parent';
+    }
+}

tests/InnerHit/ParentInnerHitTest.php

+<?php
+
+namespace ONGR\ElasticsearchDSL\Tests\InnerHit;
+
+use ONGR\ElasticsearchDSL\InnerHit\ParentInnerHit;
+use ONGR\ElasticsearchDSL\Query\TermQuery;
+
+class ParentInnerHitTest extends \PHPUnit_Framework_TestCase
+{
+    public function testToArray()
+    {
+        $query = new TermQuery('foo', 'bar');
+        $hit = new ParentInnerHit('test', 'acme', $query);
+        $expected = [
+            'type' => [
+                'acme' => [
+                    'query' => $query->toArray(),
+                ],
+            ],
+        ];
+        $this->assertEquals($expected, $hit->toArray());
+    }
+}