2.1.1 升级 2.1.5 指导

org.apache.servicecomb.swagger.invocation.Response 属性 headers 类型调整

为了更好的和 HTTP 协议标准保持兼容， 将 Response 的 headers 类型由 org.apache.servicecomb.swagger.invocation.response.Headers 修改为 io.vertx.core.MultiMap， 同时删除了类 org.apache.servicecomb.swagger.invocation.response.Headers 以支持大小写无关的 HTTP header。 修改前 header 的 key 是区分大小写的， 修改后， 不区分大小写。 该调整也涉及到和 header 操作有关的 getter， setter 方法的调整，使用了老方法的地方会编译出错， 修改为对应的新方法即可。

swagger-generator-spring-data 调整

这个模块提供了 Page、Pagable、Order 等接口的序列化支持。2.1.5 升级了 spring boot 版本， 这些接口存在变更，因此序列化 结果发生了改变。 如果产品使用了这些类作为外部接口，需要考虑前端返回的 json 格式的变化对产品功能的影响。

foudation-common 调整

这个模块提供了将时间类型数据格式化的功能。在2.1.5版本中，升级了jackson-bom版本从2.10.5到2.12.1，导致时间数据类型格式化结果 产生了变更。例如：升级前格式化时间为2017-07-21T17:32:28.000+0000，升级后为2017-07-21T17:32:28.000+00:00。如果产品 使用了该类型数据，需要考虑升级后数据类型的变更，对原有业务逻辑的影响。

servicestage-environment 调整

这个模块只有一个 mapping.xml 文件，提供环境变量映射。原来的内容为：

PAAS_CSE_ENDPOINT:
  - servicecomb.service.registry.address
  - servicecomb.config.client.serverUri
PAAS_CSE_SC_ENDPOINT:
  - servicecomb.service.registry.address
PAAS_CSE_CC_ENDPOINT:
  - servicecomb.config.client.serverUri
PAAS_PROJECT_NAME:
  - servicecomb.credentials.project

CAS_APPLICATION_NAME:
  - servicecomb.service.application
CAS_COMPONENT_NAME:
  - servicecomb.service.name
CAS_INSTANCE_VERSION:
  - servicecomb.service.version

调整为

PAAS_CSE_ENDPOINT:
  - servicecomb.service.registry.address
  - servicecomb.config.client.serverUri
PAAS_CSE_SC_ENDPOINT:
  - servicecomb.service.registry.address
PAAS_CSE_CC_ENDPOINT:
  - servicecomb.config.client.serverUri
PAAS_PROJECT_NAME:
  - servicecomb.credentials.project

做这个调整是因为大部分业务场景，不需要覆盖应用名称、微服务名称和版本。 另外，微服务引擎还提供了 APP_MAPPING、SERVICE_MAPPING、VERSION_MAPING 来支持应用名称、微服务名称和版本的覆盖。