如何優雅的使用介面

嗯，6.1剛過完，我們不在是寶寶了，來吧，擼一篇介面的文章(interface).

在程式設計的過程中我們應該學會如何使用介面來給變我們的生活，極大的提升自我能力。
介面不是新特性，但是非常重要，下面我們來擼個介面的小例子。

虛構一個DocumentStore的類，這個類負責從不同的資源收集文字。可以從遠端url讀取html，也可以讀取資源，也可以收集終端命令輸出。

定義DocumentStore類

class DocumentStore{
    protected $data = [];
    
    public function addDocument(Documenttable $document){
        $key = $document->getId();
        $value = $document->getContent();
        $this->data[key] = $value;        
    }
    
    public function getDocuments(){
        return $this->data;
    }
    
}

既然addDocument()方法的引數只能是Documenttable的類的例項，這樣定義DocumentStore的類怎麼行呢? 其實Documenttable不是類，是介面；

定義Documenttable

interface Documenttable{
    public function getId();
    public function getContent(); 
   
}

這個介面定義表名，實現Documenttable介面的任何物件都必須提供一個公開的getId()方法和一個公開的getContent()方法。

可是這麼做有什麼用呢？這麼做的好處就是，我們可以分開定義獲取穩定的類，而且能使用十分不同的方法。下面是一種實現方式，這種方式使用curl從遠端url獲取html。

定義HtmlDocument類

class HtmlDocument implements Documenttable{

    protected $url;

    public function __construct($url)
    {
        $this->url = $url;
    }

    public function getId(){
        return $this->url;
    }

    public function getContent(){
        $ch = curl_init();
        curl_setopt($ch,CURLOPT_URL,$this->url);
        curl_setopt($ch,CURLOPT_RETURNTRANSFER,1);
        curl_setopt($ch,CURLOPT_CONNECTTIMEOUT,3);
        curl_setopt($ch,CURLOPT_FOLLOWLOCATION,1);
        curl_setopt($ch,CURLOPT_MAXREDIRS,3);
        curl_close($ch);
        return $thml;
    }
}

下面一個方法是獲取流資源。

class StreamDocument implements Documenttable{
    protected $resource;
    protected $buffer;

    public function __construct($resource,$buffer = 4096)
    {
        $this->resource=$resource;
        $this->buffer=$buffer;
    }

    public function getId(){

        return `resource-` .(int)$this->resource;
    }

    public function getContent(){
        $streamContent = ``;
        rewind($this->resource);
        while (feof($this->resource) === false){
            $streamContent .= fread($this->resource,$this->buffer);
        }
        return $streamContent;
    }
}

下面一個類是獲取終端命令列的執行結果。

class CommandOutDocument implements Documenttable{
    protected $command;
    public function __construct($command)
    {
        $this->command=$command;
    }
    
    public function getId(){
        return $this->command;
    }

    public function getContent(){
        return shell_exec($this->command);
    }

}

下面我們來演示一下藉助上面的三個類來實現DocumentStore類。

$documentStore = new DocumentStore();

//新增html文件
$htmlDoc = new HtmlDocument(`https:// www.i360.me`);

$documentStore->addDocument($htmlDoc);

//新增流文件

$streamDOC = new StreamDocument(fopen(`stream.txt`,`rb`));

$documentStore->addDocument($streamDOC);

//新增終端命令文件

$cmdDoc = new CommandOutDocument(`cat /etc/hosts`);

$documentStore->addDocument($command);

print_r($documentStore->getDocuments());die;

這裡HtmlDocument，StreamDocument，CommandOutDocument這三個類沒有任何共同點，只是實現了同一個介面。