发表于 | 分类于 | | 阅读次数:
字数统计: 3,519 | 阅读时长 ≈ 13

微服务下的API设计原则

目的：
规范团队乃至公司的API设计。
主要参考： Github API

1. 为了安全，请使用HTTPS

与API设计无关、为了安全请使用HTTPS。公网API,强制使用HTTPS。内网API可酌情选择。

2. API 地址和版本

在 url 中指定 API 的版本是个很好地做法。
如果 API 变化比较大，可以把API设计为子域名，比如 https://api.ke.com/v3；
也可以简单地把版本放在路径中，比如 https://ke.com/api/v1。
不建议放入Header，不直观。

3. schema请使用JSON

对于响应返回的格式，JSON 因为它的可读性、紧凑性以及多种语言支持等优点，成为了 HTTP API 最常用的返回格式。因此，最好采用JSON作为返回内容的格式。

不推荐其他格式，如果必须使用，比如 xml，应该在请求头部 Accept 中指定。
对于不支持的格式，服务端需要返回正确的 status code，并给出详细的说明。

阅读全文 »

发表于 | 分类于 | | 阅读次数:
字数统计: 2,824 | 阅读时长 ≈ 13

前言：

spring-data-redis使得Spring项目可以快速简单的通过RedisTemplate来操作Redis。而spring-boot-starter-data-redis更是让redis集成更加的方便。

SpringBoot如何与Redis集成，作为cache

application.xml里如下配置：

spring:
     redis:
       host: 127.0.0.1
       port: 6379
       database: 0
       timeout: 1000
       pool:
             max-idle: 200
             min-idle: 0
             max-active: 200
             max-wait: 1000

spring boot可以自动组装相关配置，注意其中使用到了jedis pool，用于提升性能，非必须。
通过以下的annotation加入方法名上，可以无侵入的使用cache。

  • @Cacheable 缓存
  • @CachePut 设置缓存
  • @CacheEvict 失效或更新缓存

  • @Caching 组合操作

    以上annotation不做详细展开。

    阅读全文 »

发表于 | 分类于 | | 阅读次数:
字数统计: 229 | 阅读时长 ≈ 1

最近公司内项目，需要开发接口给ios,android客户端去调用。因此，做了一些思考，主要是关于如何更好的定义接口以及联调。

使用RESTFul接口

RESTFul接口作为一个通行的标准，当然是优先使用的。项目都是基于Spring的，因此采用的是Spring MVC.

解决接口联调的苦难

作为一个技术人员，写文档是一大令人头疼的事情。况且即使把文档写好了，也可能导致在以后的修修补补中，导致不一致的情况。
因此，考虑采用文档自动生成的方式。最终选用了Swagger来自动为Spring MVC生成文档。

  • swagger-maven-plugin
  • swagger-ui

项目中遇到的一些教训

作为技术负责人

  • 提前制定接口，方便联调
  • 提前规划返回接口类型，统一字段名称。

发表于 | 分类于 | | 阅读次数:
字数统计: 4,206 | 阅读时长 ≈ 21

Spring MVC本身对Restful支持非常好。它的@RequestMapping、@RequestParam、@PathVariable、@ResponseBody注解很好的支持了REST。18.2 Creating RESTful services

1. @RequestMapping

Spring uses the @RequestMapping method annotation to define the URI Template for the request. 类似于struts的action-mapping。 可以指定POST或者GET。

2. @PathVariable

The @PathVariable method parameter annotation is used to indicate that a method parameter should be bound to the value of a URI template variable. 用于抽取URL中的信息作为参数。（注意，不包括请求字符串，那是@RequestParam做的事情。）

@RequestMapping("/owners/{ownerId}", method=RequestMethod.GET)
public String findOwner(@PathVariable String ownerId, Model model) {
        // ...
}

如果变量名与pathVariable名不一致，那么需要指定：

@RequestMapping("/owners/{ownerId}", method=RequestMethod.GET)
public String findOwner(@PathVariable("ownerId") String theOwner, Model model) {
    // implementation omitted
}

Tip

method parameters that are decorated with the @PathVariable annotation can be of any simple type such as int, long, Date… Spring automatically converts to the appropriate type and throws a TypeMismatchException if the type is not correct.

阅读全文 »

发表于 | 分类于 | | 阅读次数:
字数统计: 1,115 | 阅读时长 ≈ 4

最近常有数据库和网络设备升级和搬迁等事情，而各个应用都是基于数据库连接池做的，大部分都是基于C3P0，数据库或网络状况的变动都会导致客户端连接池中的connection失效，如何剔除这些blocked connection就和C3P0的各个配置息息相关。

1）C3P0容错和自动重连与以下配置参数有关：

breakAfterAcquireFailure ：true表示pool向数据库请求连接失败后标记整个pool为block并close，就算后端数据库恢复正常也不进行重连，客户端对pool的请求都拒绝掉。false表示不会标记 pool为block，新的请求都会尝试去数据库请求connection。默认为false。因此，如果想让数据库和网络故障恢复之后，pool能继续请求正常资源必须把此项配置设为false

阅读全文 »

发表于 | 分类于 | | 阅读次数:
字数统计: 2,534 | 阅读时长 ≈ 9

当使用Solr来构建搜索引擎的时候，你可能经常会遇到这样的场景：你有一个同义词列表，并且你想用户查询也能够命中到同义词。听起来很简单不是吗？为什么搜索“dog”的时候，不能命中包含“hound(猎犬)”或者“pooch(狗)”的文档呢？甚至包含“Rover(流浪者)”和“canis familiaris(犬)”?

小狗

叫Rover或者其他名字，可能只是为了让小狗听起来很可爱。

事实证明，Solr的同义词扩展没有你想象的那么简单。但是我们有很多好的方法来搬石头砸自己的脚。

阅读全文 »

发表于 | 分类于 | | 阅读次数:
字数统计: 496 | 阅读时长 ≈ 2

软件版本

  • Ubuntu Linux
  • mahout-0.9,本文写作的时候的最新版本
  • Sogou语料库精简版
  • ik-analyzer, 这个版本是专门为了在mahout中进行分词而单独做的版本，源码从官方拿来。只更改了停用词，以及适配lucene4.6.1版本。maven化更方便使用。

Sogou语料库处理

下载后的预料库，文档都是GB2312编码的。虽然mahout支持不同的编码方式，但是为了更方便的放到Hadoop里跑，还是建议先转化为标准的UTF-8.
语料库解压后，是sogou目录。我们执行以下代码进行转化，转换后的在utf/sogou目录下：

find sogou -type d -exec mkdir -p utf/{} \;
find sogou -type f -exec iconv -f GB2312 -t UTF-8 {} -o utf/{} \;

使用mahout生成sequence file

进入utf/sogou目录，执行：

mahout seqdirectory -i sogou -o sogou-seq -c UTF-8 -ow

生成的sequence file存放在sogou-seq目录内。
可以通过seqdumper命令查看：

阅读全文 »

发表于 | 分类于 | | 阅读次数:
字数统计: 561 | 阅读时长 ≈ 2

　在工作中，经常会遇到使用操作系统不一样的环境，从而导致在不同环境下的文件编辑的编码是不一样的，Windows默认是GBK编码格式，Linux默认是UTF-8的格式，这样就会出现把GBK编码的文件拷贝到Linux下出现乱码情况，很是让人头疼，下面给大家介绍下GBK->UTF-8文件编码批量转换。

Linux命令-enca 查看文件的编码

Enca语法

Usage:  enca [-L LANGUAGE] [OPTION]... [FILE]...
        enconv [-L LANGUAGE] [OPTION]... [FILE]...
        Detect encoding of text files and convert them if required.

Enca用法

$ enca -L zh_CN file 检查文件的编码
$ enca -L zh_CN -x UTF-8 file 将文件编码转换为"UTF-8"编码
$ enca -L zh_CN -x UTF-8 file1 file2 如果不想覆盖原文件可以这样

除了有检查文件编码的功能以外，”enca”还有一个好处就是如果文件本来就是你要转换的那种编码，它不会报错，还是会print出结果来， 而”iconv”则会报错。这对于脚本编写是比较方便的事情。

阅读全文 »

发表于 | 分类于 | | 阅读次数:
字数统计: 799 | 阅读时长 ≈ 4

安装需求

  • Java 1.6
  • ssh,sshd正常安装

确保可以ssh到localhost，并且不需要密码

ssh localhost

如果报错，connect to host localhost port 22:Connection refused。说明ssh-server未安装或者未启动。
运行：

ps -ef | grep sshd

查看sshd进程是否存在，如果不存在，说明没有安装。那么进行安装。

sudo apt-get install openssh-server

然后再执行ssh localhost,如果不能无密码登陆，需要做一下操作：

ssh-keygen -t dsa -P '' -f ~/.ssh/id_dsa
cat ~/.ssh/id_dsa.pub >> ~/.ssh/authorized_keys
阅读全文 »