海门企业微信公众号小程序开发公司、海门企业网页设计方案、海门做网站开发价格、海门微信公众号制作运营报价明细表、海门网站设计公司费用、海门网站推广大概需要多少钱

海门企业微信公众号小程序开发公司、海门企业网页设计方案、海门做网站开发价格、海门微信公众号制作运营报价明细表、海门网站设计公司费用、海门网站推广大概需要多少钱

海门区，隶属江苏省南通市，位于江苏省东南部，长江北岸，东北濒临黄海，南靠长江，全境总面积1148.71平方千米， [1]  截至2020年，海门区户籍人口98.87万人。 [14]  截至2020年6月，海门区下辖3个街道9个镇。 [2]  海门区人民政府驻海门街道北京中路600号。 [3] 

后周显德五年（958年），置海门县，属通州辖领。 [4]  2020年，撤销海门市，设立海门区。 [3]  海门文化属吴越文化，海门人主要使用吴语，属江浙民系。 [5-7]  海门区境内地势平坦，沟河纵横。 [1]  属北亚热带季风气候区，四季分明。 [8] 

海门区是全国双拥模范县 [9]  、国家生态文明建设示范区 [10]  、国家卫生城市 [11]  、中国特色农产品优势区 [12]  、革命文物保护利用片区分县 [13]  、国家知识产权示范城市。

2020年，海门区地区生产总值1442.57亿元，比上年增长5.5%。其中，第一产业增加值68.73亿元，第二产业增加值710.13亿元，第三产业增加值663.71亿元，增长6.8%，三次产业结构为4.8：49.2：46.0。

• 返回结果 对应接口类成员函数的@return注释，可以有多组，格式为：@return 返回类型 返回字段 说明。这里是：

  /**
   * @return int      goods_id    商品ID
   * @return string   goods_name  商品名称 
   * @return int      goods_price 商品价格
   * @return string   goods_image 商品图片
   */public function snapshot() {复制代码

• 异常情况 对应@exception注释，可以有多组，格式为：@exception 错误码 错误描述信息。例如，我们可以在此示例中补充异常情况。

  /**
   * @exception 406 签名失败
   */public function snapshot() {复制代码

  刷新后，可以看到新增的异常情况说明。

图3-6 添加了异常情况后的效果

以上获取商品快照信息接口服务的参数规则和注释，完整的代码为：

// $ vim ./Shop/Api/Goods.php <?phpclass Api_Goods extends PhalApi_Api {

    public function getRules() {
        return array(
            'snapshot' => array(
                'id' => array('name' => 'id', 'require' => true, 'type' => 'int', 'min' => 1, 'desc' => '商品ID'),
            ),
        );
    }

    /**
     * 获取商品快照信息
     * @desc 获取商品基本和常用的信息
     * @return int      goods_id    商品ID
     * @return string   goods_name  商品名称 
     * @return int      goods_price 商品价格
     * @return string   goods_image 商品图片
     * @exception 406 签名失败
     */
    public function snapshot() {
        ... ...
    }}复制代码

公共注释

对于当前类的全部函数成员的公共@exception异常情况注释和@return返回结果注释，可在类注释中统一放置。而对于多个类公共的@exception和@return```注释，则可以在父类的类注释中统一放置。

也就是说，通过把@exception注解和@return注解移到类注释，可以添加全部函数成员都适用的注解。例如，Api_User类的全部接口都返回code字段，且都返回400和500异常，则可以：

<?php/**
 * @return int code 操作码，0表示成功
 * @exception 400 参数传递错误
 * @exception 500 服务器内部错误
 */class Api_User extends PhalApi_Api {复制代码

这样就不需要在每个函数成员的注释中重复添加注解。此外，也可以在父类的注释中进行添加。对于相同异常码的@exception注解，子类的注释会覆盖父类的注释，方法的注释会覆盖类的注释；而对于相同的返回结果@return注释，也一样。

3.4 接口查询语言与SDK包

3.4.1 用一句话来描述接口请求

为了统一规范客户端请求调用接口服务的使用，在尽量保证简单易懂的前提下也兼顾使用的流畅性，为此我们专门设计了内部领域特定语言：接口查询语言（Api Structured Query Language）。通过接口查询语言，最后可以用一句话来描述接口请求。

从外部DSL的角度来看此接口查询的操作，可总结为创建、初始化、重置、参数设置和请求等操作。

createwithHost host
withFilter filter
withParser parserreset   #特别注意：重复查询时须重置请求状态withService service
withParams paramName1 paramValue1
withParams paramName2 paramValue2
withParams ... ...withTimeout timeoutrequest复制代码

根据此设计理念，任何语言都可实现此接口查询的具体操作。

海门企业微信公众号小程序开发公司、海门企业网页设计方案、海门做网站开发价格、海门微信公众号制作运营报价明细表、海门网站设计公司费用、海门网站推广大概需要多少钱