PHP基础知识讲座：第2课，如何在HTML页面中嵌入PHP代码

累点滴，汇成江海。咱们从最最基础的PHP知识开始学习，一步一个脚印的开启PHP的学习旅途吧。

请点击右上角“关注”按钮关注我们哟：跟着木辛老师学习PHP编程知识，变身快乐的编程达人吧~

同学们好呀！木辛老师又来了。

咱们在开始PHP的学习之前，需要先准备一个可以提供PHP服务的Web服务器。我们就复用木辛老师专栏中的一个教程，使用Homestead本地开发环境进行学习呗。

传送门：《Laravel第一课：搭建Laravel开发环境》

也可以关注木辛老师的Laravel专栏哟：

大家配置好本地开发环境以后，还需要稍微设置一下，针对这个项目，在Homestead配置文件中作如下设置，

添加指向当前项目根目录的配置：

sites:
 - map: learning_php.test to: /Code/zyoo/learning_php
 to: /Code/zyoo/learning_php

另外还需要在本机hosts文件中添加一个域名指向：

sudo vim /etc/hosts

并添加如下记录：

192.168.10.10 learning_php.test

最后，添加一个测试文件：

php代码

然后，打开浏览器，访问域名查看页面结果

执行效果

大家可以看到，我们已经可以成功的访问到测试用的PHP文件了。

好了，万事俱备，只需要学习了。那么，咱们开始吧~

创建示例应用：木辛老师的图书馆

几乎绝大部分服务器端的脚本语言最初设计的应用场景之一就是处理HTML表单。木辛老师要翻出家底，将自己最心爱的在线图书商城，用来作为学习PHP基础知识的场景吧。

创建订购图书用的订单表单

通过这个表单页面，我们可以知道顾客订购的商品，订单的金额以及其他一些附属信息。HTML代码请看下方：

<html>
 <head>
 <title>木辛老师的PHP基础入门教程</title>
 </head>
 <body>
 <form action="processorder.php" method="POST">
 <table style="border: 0px;">
 <tr style="background: #cccccc">
 <td style="width: 150px;text-align:center;">图书名称</td>
 <td style="width: 50px;text-align:center;">数量</td>
 </tr>
 <tr>
 <td>PHP入门指南</td>
 <td><input type="text" name=“book_name_01" size="3" maxlength="3"/></td>
 </tr>
 <tr>
 <td>PHP和MySQL开发</td>
 <td><input type="text" name="book_name_02" size="3" maxlength="3"/></td>
 </tr>
 <tr>
 <td>Laravel入门</td>
 <td><input type="text" name="book_name_03" size="3" maxlength="3"/></td>
 </tr>
 <tr>
 <td colspan="2" style="text-align: center;">
 <input type="submit" value="提交订单"/>
 </td>
 </tr>
 </table>
 </form>
 </body>
</html>

咱么直接通过浏览器访问这个HTML页面，看看效果：

页面显示

哈，简单的页面，我们已经开启Web开发神秘旅程了。继续加油！

大家可能注意到了一个细节：在html代码的form表单部分，action属性我们指向了一个php脚本：

<form action="processorder.php" method="POST”>

具体的PHP脚本的学习我们很快就能看到。这里只是稍微提一下，这个action属性值就是用户点击“提交订单”按钮时将要请求的URL。

用户在表单中输入的数据，会以POST的方式，发送给URL指向的PHP文件进行处理。

表单处理

那如何处理这个表单呢？又如何让PHP代码起作用的？

要处理这个表单，我们需要创建一个php文件，它的名字需要和form中action属性的值保持一致。

那么，我们就创建一个名字叫做processorder.php的文件吧。

代码可以先这么写，看看是否能起作用哈：

<html>
 <head>
 <title>订单处理结果</title>
 </head>
 <body>
 <h1> 木辛老师的在线图书馆</h1>
 <h2> 订单处理结果通知</h2>
 <?php echo '<p>订单已处理完成</p>'; // 这里是PHP的代码 ?>
 </body>
</html>

保持文件，并刷新页面。这个时候我们点击“提交订单”按钮，效果如下：

php执行结果

大家可以看到，红框部分就是通过PHP代码输出的结果。这样，我们就实现了通过Web方式执行了PHP代码的需求，这么一看PHP还是非常简单的吧。

我们顺便在看看这个页面的源代码吧，看一下PHP代码如何在HTML页面中完成任务的吧：

源代码

通过页面源码，我们发现刚才写的PHP代码已经不见了，取而代之的是

<p>订单已处理完成</p>

这是怎么回事呢？

这是因为PHP解释器在脚本运行的时候，将该脚本的输出替代了脚本自身的代码，通过这种方式，就可以生成可以在任何浏览器上运行的HTML页面了。也就是说，浏览器是不需要学会PHP的。

通过这段代码，我们可以学习一些PHP的基础知识：

PHP标记
PHP语句
如何空格
添加注释

PHP标记

第一种情况：在HTML中混写PHP和HTML代码，需要为php添加标记。PHP代码会以“<?php”作为开始，以“?>”作为结束。这些符号就叫做PHP标记，它们主要用来告诉服务器PHP代码的开始和截止，在这两个起止符号之间的任何代码，服务器都会以PHP语法来解析。

另一种情况：之后，我们写纯PHP的时候，每个文件也需要添加PHP标记。不过呢，结束标记可以省略，这也是很大一部分PHPer默认遵守的规则。

PHP语句

在PHP的开始和截止标记之间，就是PHP语句了，通过这些内容可以告诉PHP解释器应该进行如何的操作，在我们这个例子里，通过：

echo '<p>订单已处理完成</p>’;

使用echo语句完成了一个非常简单的操作，仅是将echo后边的字符串原样打印到浏览器中。这里需要特别注意的一点就是每个PHP语句后边都需要添加英文的分号作为语句的结束符，否则会出现错误，但是在这个html页面中，因为只有一句代码，忽略掉分号也是不会报错的。

但是还是强烈建议大家养成习惯：每句PHP代码结束都要以分号结尾哟！

空格

一般情况下，为了让代码更加清晰和整洁，在编码的过程中会添加一些空格，这些空格包括：回车换行、空格、制表符等都被认为是空格。

当然了，浏览器并不会在意你是否输入了空格，同样的PHP服务器端解析器也会忽略这些，这些空格仅是给编写代码的人看的。

但是，木辛老师还是再次强烈建议，在代码的适当位置添加空格或者空行，这样做可以很有效的提升代码的可阅读性，方便后期的维护工作。

注释

最后在讲讲注释，理论上在编程中出现频率非常高的一个知识点。

为什么说理论上呢，因为这么重要的一个要点，在实际开发中很容易被广大开发者忽略呢！

由于种种原因吧，开发者很不习惯在开发过程中写非常详尽的注释，而且有时候在Git提交时也是草草的一笔带过。这样做的后果就是，若干时间后，当你再次拿到这段代码，可能会花费更多的时间梳理它。

所以，善于写注释，也是提高生产效率的一种有效手段。

PHP解释器同样会在执行的时候忽略掉注释，也就是说就好比像空格一样，PHP解析器会跳过注释，它只负责执行PHP代码！

PHP脚本中的注释比较丰富，有很多类似C语言的风格，比如：

多行注释：

/* 这是
 一个
 多行
 注释
/*

可以看出来，多行注释以 /*开始，以*/结束。同样的和C语言是一样的，多行注释是不能嵌套的。

当然了，除了多行注释之外，也支持单行注释：

echo '<p>订单已处理完成</p>'; // 这里是PHP的代码

或者这种：

echo '<p>订单已处理完成</p>’; #这里是PHP的代码

不论采取哪种风格的注释，在注释符号之后的所有内容，PHP解释器都会认识不需要处理的，这一点一定要注意呀！

好了，今天的课程咱就先讲到这里。

小朋友们不要忘记关注我们哟，下期课程更精彩，请大家一起期待吧~

快乐编程，快乐成长，拜拜！

者 | Lyndsey Padget

译者 |月满西楼

本文来自公众号“EAWorld”，ID：eaworld

今天我们来聊聊 Java中的微服务。虽说 Java EE提供了一个强大的平台，供我们创建、部署和管理企业级微服务，但在本文中，我将展示如何创建一个尽可能小的 RESTful微服务。

放心，在这个过程中，我们不会浪费时间精力去重复做些数据处理之类的事情。我们会通过 JBoss RESTEasy来进行搭建。而确保该微服务的轻量级，目的是为了向大家展示，在一个全新或者现存的微服务前端，建立一个 RESTful接口，真的非常简单。

与此同时，我会进一步证明，通过 RESTEasy构建的微服务具备很大的灵活性，不仅可以兼容包括 JSON，XML在内的多种数据传输格式，还支持将其部署到 Apache Tomcat[1]服务器而非 JBoss企业应用平台 (EAP)[2]上。诚然，每个工具都有自己的优势，但是我认为先在 KISS原则 [3]下探讨技术可用性会很有帮助，然后才是根据软件的长期目标和需求来决定应该为服务架构添加哪些特性。

本文中提到的代码示例都可以在 GitHub[4]上查阅，包括“starter” 和 “final”这两个分支。下面是我采用的环境，当然你的实际情况可能有所不同:

Java Development Kit[5] (JDK)1.8.0-131 (amd64)
apache Tomcat[6] 9
apache Maven[7] 3.5.0
Eclipse Java EE IDE[8] 4.7.0 (Oxygen)
Linux Mint[9] 18.2 (Sonya)64位

就技术而言...

微服务 [10]是一种体积小、更为精炼的服务，其目标是“做好一件事”。微服务之间通过一些接口进行交互是很普遍的现象。如果该接口可以通过 web访问 (使用 HTTP)，那么它就是一个 web服务。部分 web服务是基于 RESTful这种架构风格的，另一些则不是。注意，微服务并不都是 web服务，web服务并不都是 RESTful web服务，RESTful web服务也并不都是微服务！

REST和 XML……能否共存？

如果你此前在使用 RESTful web服务时，没用过除 JSON 以外的文本数据交换格式 [11]来进行内容传输，那么你可能会认为二者是不相关的。但是回想下，REST是定义 API的一种架构风格，REST和 JSON这两者又碰巧一起流行起来 (注意，这并非偶然)。XML多年的发展使其拥有大量的客户群，能够接纳和提供 XML数据传输格式的 RESTful web服务, 不管是对那些已经依赖于这类内容交互系统的组织，还是对仅仅是更熟悉 XML的用户来说，都非常有用。当然，通常情况下，JSON依然是首选，因为其消息体更小，但有时 XML只是一个更简单的“sell”。拥有一个能同时支持这两种格式的 RESTful微服务是最理想的 ;从部署的角度来说，它不仅简洁，具备可扩展性，还有足够的灵活性，可以支持不同类型的内容，从而满足那些其他有调用需求的应用程序。

为什么选择 RESTEasy？

RESTEasy[12]是 Jboss的一个框架，可以用来构建 RESTful web服务。通过 RESTEasy构建的 RESTful web服务，可以根据四个函数库来实现对 XML和 JSON这两种数据传输格式的支持：

resteasy-jaxrs，实现了 JAX-RS 2.0 (用于 RESTful Web服务的 Java API) [13]
resteasy-jaxb-provider，其 JAXB[14]绑定能有效支持 XML
resteasy-jettison-provider，用 Jettison[15]将 XML转换为 JSON
resteasy-servlet-initializer，将服务部署到 Servlet 3.0容器 (在 Tomcat服务器上)

首先，创建一个内含 pom.xml数据包的 web服务项目:

<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.lyndseypadget</groupId> <artifactId>resteasy</artifactId> <packaging>war</packaging> <version>0.0.1-SNAPSHOT</version> <name>resteasy</name> <repositories> <repository> <id>org.jboss.resteasy</id> <url>http://repository.jboss.org/maven2/</url> </repository> </repositories> <dependencies> <dependency> <groupId>org.jboss.resteasy</groupId> <artifactId>resteasy-jaxrs</artifactId> <version>3.1.4.Final</version> </dependency> <dependency> <groupId>org.jboss.resteasy</groupId> <artifactId>resteasy-jaxb-provider</artifactId> <version>3.1.4.Final</version> </dependency> <dependency> <groupId>org.jboss.resteasy</groupId> <artifactId>resteasy-jettison-provider</artifactId> <version>3.1.4.Final</version> </dependency> <dependency> <groupId>org.jboss.resteasy</groupId> <artifactId>resteasy-servlet-initializer</artifactId> <version>3.1.4.Final</version> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>2.0.2</version> <configuration> <source>1.8</source> <target>1.8</target> </configuration> </plugin> </plugins> <finalName>resteasy</finalName> </build> </project>

（左右滑动可查看全部代码，下同）

这些数据库的大小大概在 830KB。当然，这些直接的依赖环境（dependency），运用 Maven一起构建项目也会带来部分传递性依赖。

接下来，我将用“Maven方法”来构建这个项目，例如在 src/main/java中，使用 Maven构建命令等，不想用 Maven的话，你也可以直接从下载页面 [16]下载 RESTEasy jar数据包。下载的时候不用理会 RESTEasy站点上弹出的这个提示:JBoss仅仅是在尝试引导你采用更“企业化”的方法。你只需点击“继续下载”，来开展后面的操作。

项目设计

下面这个微服务可以用非常简单的方法来演示一些基本概念。如下图所示，它包括 5个等级。

此处，FruitApplication是微服务的切入点。FruitService提供了主要的路径 (/fruits)，同时它也充当了路由器的功能。苹果和水果都是模型；水果包含一些抽象的功能，苹果则会具体地扩展它的功能。

和你设想一致的是，FruitComparator可以提供比较功能。不熟悉 Java comparator的读者，可以在这篇文章中了解一下对象的等同性和比较，这里我用字符来取代。虽然 FruitComparator不是一个模型，但我更喜欢将比较器与它想要比较的对象类型保持相类似的命名。

模型

让我们从 Fruit这级开始

package com.lyndseypadget.resteasy.model; import javax.xml.bind.annotation.XmlElement; public abstract class Fruit { private String id; private String variety; @XmlElement public String getId { return id; } public void setId(String id) { this.id = id; } @XmlElement public String getVariety { return variety; } public void setVariety(String variety) { this.variety = variety; } }

然后 Apple这级对其展开：

package com.lyndseypadget.resteasy.model; import javax.xml.bind.annotation.XmlElement; import javax.xml.bind.annotation.XmlRootElement; @XmlRootElement(name = "apple") public class Apple extends Fruit { private String color; @XmlElement public String getColor { return color; } public void setColor(String color) { this.color = color; } }

以上并不是什么特别惊人的代码，你可能会觉得都不值得拿出来炫耀，就是一个 Java继承的简单实例。但重点在于这两个注释 @XmlElement 和 @XmlRootElement，它们定义了 XML apple结构的样子:

<apple> <id>1</id> <variety>Golden delicious</variety> <color>yellow</color> </apple>

因为没有约定明显的构造函数:Java使用了隐式的、无参数的默认构造函数，所以一些更微妙的事情在发生。这个无参数的构造函数对 JAXB 施展魔法般效果的工作是十分必要的（本文解释了这一点，以及必要的话，如何用 XMLAdapter来让它工作）。

现在我们有了一个对象：被定义的苹果。它有三个属性: ID、多样性和颜色。

服务

FruitService 被用来作为与微服务交互的主要路径 (/fruits)。在本例中，我使用 @path注释直接在该层级中定义了第一个路径，/fruits/apples。随着 RESTful微服务的扩展，你可能希望在自己的层级中定义多个最终路径 (例如 /apples, /bananas, /oranges)。

package com.lyndseypadget.resteasy; import java.util.ArrayList; import java.util.Collections; import java.util.Comparator; import java.util.List; import java.util.Map; import java.util.TreeMap; import javax.ws.rs.GET; import javax.ws.rs.Path; import javax.ws.rs.Produces; import javax.ws.rs.core.MediaType; import com.lyndseypadget.resteasy.model.Apple; import com.lyndseypadget.resteasy.model.FruitComparator; @Path("/fruits") public class FruitService { private static Map<String, Apple> apples = new TreeMap<String, Apple>; private static Comparator comparator = new FruitComparator; @GET @Path("/apples") @Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON }) public List getApples { List retVal = new ArrayList(apples.values); Collections.sort(retVal, comparator); return retVal; } }

这张苹果的地图帮助我们根据 id跟踪苹果的数据，从而模拟某些类型的数据持久层。利用 getApples方法（常用的 HTTP请求方式）将会返回地图跟踪到的相关苹果数据。GET /apples route是用 @GET和 @path注释定义的，它可以生成数据传输格式 XML或 JSON的内容。

这个方法需要返回一个 List< apple >对象，然后用这个比较器按品种属性来对列表进行排序。

FruitComparator看起来是像这样的:

package com.lyndseypadget.resteasy.model; import java.util.Comparator; public class FruitComparator implements Comparator { public int compare(F f1, F f2) { return f1.getVariety.compareTo(f2.getVariety); } }

注意，如果想要对苹果的一个特定属性进行排序，比如颜色，我们就必须创建一个新的比较器去取代，并取个名字，比如 AppleComparator。

应用程序

在 RESTEasy3.1.x中, 你需要定义一个扩展应用的层级。RESTEasy示例文档说明这是一个单例模式注册表（singleton registry），如下所示:

package com.lyndseypadget.resteasy; import javax.ws.rs.core.Application; import java.util.HashSet; import java.util.Set; public class FruitApplication extends Application { HashSet singletons = new HashSet; public FruitApplication { singletons.add(new FruitService); } @Override public Set<Class> getClasses { HashSet<Class> set = new HashSet<Class>; return set; } @Override public Set getSingletons { return singletons; } }

如果仅为了说明本例，就不需要对这个层级做太多工作，但是我们需要在 web.xml文件中将它连接起来，这会在后面的章节“web服务连接”中进行介绍。

对象的构建集合

GET /apples调用将返回如下数据：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <collection> <apple> <id>1</id> <variety>Golden delicious</variety> <color>yellow</color> </apple> </collection>

[ { "apple": { "id": 1, "variety": "Golden delicious", "color": "yellow" } } ]

但是，我们可以将数据更改成看起来稍有点不同：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <apples> <apple> <id>1</id> <variety>Golden delicious</variety> <color>yellow</color> </apple> </apples>

 { "apples": { "apple": { "id": 1, "variety": "Golden delicious", "color": "yellow" } } }

第二个选项在 XML中看起来更好一些，但是对 JSON产生了不太好的影响。如果你喜欢这个结构，可以用它自己的类型打包 List< Apple >，并修改 FruitService.getApples方法来返回这种类型:

package com.lyndseypadget.resteasy.model; import java.util.ArrayList; import java.util.Collection; import java.util.Collections; import java.util.Comparator; import java.util.List; import javax.xml.bind.annotation.XmlAccessType; import javax.xml.bind.annotation.XmlAccessorType; import javax.xml.bind.annotation.XmlElement; import javax.xml.bind.annotation.XmlRootElement; @XmlAccessorType(XmlAccessType.FIELD) @XmlRootElement(name = "apples") public class Apples { private static Comparator comparator = new FruitComparator; @XmlElement(name = "apple", type = Apple.class) private List apples; public List getApples { Collections.sort(apples, comparator); return apples; } public void setApples(Collection apples) { this.apples = new ArrayList(apples); } }

这些注释有效地“重新标记”了根元素，即 collection/list。通过读取用于 javax.xml.bind.annotation的 javadoc文档，你可以尝试用它和不同的 XML Schema映射注释。

当然，如果实在不能搞定一般的方法签名（method signature），则可以编码写入不同的方法——一个用于 XML，另一个用于 JSON。

一些 web服务连接

从将该服务部署到 Tomcat开始，我用一个放在 src/main/webapp/web inf/web.xml的 web应用部署描述符文件。它所包含的内容如下：

<?xml version="1.0"?> <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd"> <web-app> <display-name>resteasy</display-name> <context-param> <param-name>javax.ws.rs.core.Application</param-name> <param-value>com.lyndseypadget.resteasy.FruitApplication</param-value> </context-param> <context-param> <param-name>resteasy.servlet.mapping.prefix</param-name> <param-value>/v1</param-value> </context-param> <listener> <listener-class> org.jboss.resteasy.plugins.server.servlet.ResteasyBootstrap </listener-class> </listener> <servlet> <servlet-name>Resteasy</servlet-name> <servlet-class>org.jboss.resteasy.plugins.server.servlet.HttpServletDispatcher</servlet-class> </servlet> <servlet-mapping> <servlet-name>Resteasy</servlet-name> <url-pattern>/v1/*</url-pattern> </servlet-mapping> </web-app>

没错，“servlet-name”表示 servlet(即 Service)的名称是 Resteasy。servlet-mapping url-pattern (/v1/*)要求 Tomcat服务器将包含该模式的传入请求传输到 Resteasy服务。关于如何建立这个文件的更多信息，以及可用的不同选项，请参阅 Tomcat的应用程序部署文档 [17]。

构建及部署

从项目的根目录中，可以运行以下内容来构建 WAR(web application resource，web应用程序资源)文件:

mvn clean install

这将在 target文件夹中创建一个包含 WAR文件的新文件夹。虽然用 Maven或其他工具来部署该文件也可以，但我只用一个简单的复制命令就可以。需要注意的是，每次将 WAR重新部署到 Tomcat服务器时，应该首先暂停服务器运行，并删除服务应用程序文件夹 (在本例中，是这个文件夹：< tomcatDirectory >/webapps/resteasy)和旧的 WAR文件 (< tomcatDirectory >/webapps/resteasy.war)。

[sudo] cp target/resteasy.war <tomcatDirectory>/webapps/resteasy.war

如果此时 Tomcat服务器正在运行，那么会即刻部署 web服务。如果不是，下次服务器启动时，该服务也会被自动部署上去。然后,就可以通过如下地址访问 web服务：http://< tomcatHost >:< tomcatPort >/resteasy/v1/fruits/apples。我的范例中是这个地址 http://localhost:8080/resteasy/v1/fruits/apples。

通过“内容协商（Content negotiation）”测试服务

内容协商（Content negotiation）是一种机制，它可以提供不同资源 (URI)的表现形式。最基本的，这意味着可以:

详细设置 Accept header，以指示希望从服务中接受的内容类型
详细设置 Content-Type header，以指示发送给服务的内容类型

要获取更多关于内容协商（Content negotiation）和 header的信息，请参阅 RFC 2616[18]的第 12和 14章。在本例中，你真正需要了解的是:

@Produces annotation（注释）指明了该方法能够生成哪些内容 (这将尝试匹配请求上的 Accept header)。
@Consumes annotation（注释）指明了该方法能够使用哪些内容 (这将尝试匹配请求的 content-type header)。

如果您试图对一个有效端点进行 HTTP调用，但是内容不能被协商，这意味着没有 @Produces匹配该 Accept数据，或者没有 @Consumes匹配 Content-Type数据，将被返回 HTTP状态码 415:不支持的数据传输格式。

返回常见数据传输格式的 GET调用实际上可以直接进入浏览器。对于 GET /apples这样的调用，默认情况下您将获得 XML:

不过，使用像 Postman[19]这类工具可能会更有帮助，因为它明确地指定 Accept header作为 application/xml:

这两种方法都返回了一些有效但没有多大意义的 XML，即一个空的苹果列表。但是这里有一些很酷的东西。将 Accept header更改为 application/json，太好了，瞧！JSON*生效*了:

不只是“读取”

你可能会发现，很多 RESTful web服务的例子，都是只读的，部分也不会有进一步的提示，比如如何去创建、更新和删除这些操作。虽然我们现在已经有了 web服务的框架，但这是一个不能更改的空列表，这并没多大意义。所以我们应该运用一些其他方法，将苹果添加到这个列表中或从列表中将其删除。

package com.lyndseypadget.resteasy; import java.util.ArrayList; import java.util.Collections; import java.util.Comparator; import java.util.List; import java.util.Map; import java.util.TreeMap; import javax.ws.rs.Consumes; import javax.ws.rs.DELETE; import javax.ws.rs.GET; import javax.ws.rs.POST; import javax.ws.rs.Path; import javax.ws.rs.PathParam; import javax.ws.rs.Produces; import javax.ws.rs.core.MediaType; import javax.ws.rs.core.Response; import com.lyndseypadget.resteasy.model.Apple; import com.lyndseypadget.resteasy.model.FruitComparator; @Path("/fruits") public class FruitService { private static Comparator comparator = new FruitComparator; private static Map apples = new TreeMap; private static int appleCount = 0; @GET @Path("/apples") @Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON }) public List getApples { List retVal = new ArrayList(apples.values); Collections.sort(retVal, comparator); return retVal; } @GET @Path("/apples/{id}") @Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON }) public Response getApple(@PathParam("id") String id) { Apple found = apples.get(id); if(found == ) { return Response.status(404).build; } return Response.ok(found).build; } @DELETE @Path("/apples/{id}") public Response deleteApple(@PathParam("id") String id) { apples.remove(id); return Response.status(200).build; } @POST @Path("/apples") @Consumes({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON }) public Response createApple(Apple apple) { String newId = Integer.toString(++appleCount); apple.setId(newId); apples.put(newId, apple); return Response.status(201).header("Location", newId).build; } }

如此，就增加了一些新的功能:

通过 id检索苹果数据 (如果在地图中没有找到，则返回状态代码 404)
通过 id删除苹果数据
创建新的苹果数据 (如果成功的话，返回状态代码 201)

这些方法完善了很多功能，确保了服务可以按照预期工作。更新苹果 (使用 @PUT和 /或 @PATCH)，以及更多的关于端点、逻辑和管理持久性方面的功能操作，都留给读者你们来练习吧。

当我们再次进行构建和部署时会发现 (如果用 Maven或者 Tomcat来进行设置，请参阅上文“构建和部署”)，现在已经可以在服务中创建、检索和删除苹果了。而且即使不在服务器上做任何重新配置，也可以在 XML和 JSON之间进行选择性调用。

来创建一个拥有“application/json”内容类型和 JSON主体的苹果，如下图所示:

这是另一个例子:创建一个具有“application/xml”内容类型和 XML主体的苹果。

在 XML中检索所有的苹果数据:

在 JSON中通过 id检索 apple 2的数据：

通过 id删除 apple 1的数据：

在 JSON中检索所有苹果的数据：

小结

在此我们已经探讨了 RESTEasy架构如何在 Java web服务中无缝支持 XML和 JSON数据传输格式。我还解释了 REST、Media type(数据传输格式)、web服务和微服务之间的技术差异，因为在这些术语中有很多容易混淆的灰色地带。

我这里列举的例子可能有点勉强，生活中我其实从来没有真正需要过水果相关的数据，我也没有在食品行业工作过。之所以用水果来举例，是因为我觉得这个“规模”能有助于大家理解微服务的概念，你也可以想象其他例如蔬菜，罐头或海鲜这样的微服务是如何共同构成一个食物分配系统。现实世界中，食品杂货店的食物分配系统实际上非常复杂，它必须考虑到包括销售、优惠券、过期日期、营养信息等各方面的问题。

当然，你可以选择其他方式去对系统进行分割，但当你需要一种快速高效、轻量级工具来支持多种数据格式时，RESTEasy真的是个非常不错的选择。

参考地址：

[1]、[2]、[6] https://tomcat.apache.org/

[3] https://en.wikipedia.org/wiki/KISS_principle

[4] https://github.com/lyndseypadget/resteasy-demo

[5] http://www.oracle.com/technetwork/java/javase/downloads/index.html

[7] https://maven.apache.org/

[8] https://www.eclipse.org/downloads/

[9] https://linuxmint.com/edition.php?id=237

[10] https://stackify.com/what-are-microservices/

[11] https://www.iana.org/assignments/media-types/media-types.xhtml

[12] http://resteasy.jboss.org/

[13] https://jcp.org/aboutJava/communityprocess/final/jsr339/index.html

[14] http://www.oracle.com/technetwork/articles/javase/index-140168.html

[15] https://github.com/jettison-json/jettison

[16] http://resteasy.jboss.org/downloads

[17] https://tomcat.apache.org/tomcat-9.0-doc/appdev/deployment.html

[18] https://www.ietf.org/rfc/rfc2616.txt

[19] https://www.getpostman.com/

期望得到更多优质技术干货，欢迎加入 EAWorld社区，与近万名技术人一起成长。入群暗号：328

述 | 杨晓兵

编辑 | 伍杏玲

出品 | CSDN（ID：CSDNnews）

编者前记：

编译器是连接人类世界与机器世界之间的一座桥梁，它可将程序员理解的高级语言，转换成程序高效执行的机器码。在 C/C++ 编译器里，有 VC、Borland C++、GCC、Watcom C/C++ 等国外热门编译器，但属于国内自主研发的编译器较少。

毕竟开发一款实用的编译器不易，涉及前端词法、语法分析、语意分析、大量的编译优化等工作。而有一支团队，不惜花费十余年精力完全自主研发出一款 YC 编译器和 YC 浏览器内核。

为何他们不遗余力地自主研发编译器和浏览器内核？这款编译器有何优点呢？下面由 YC 编译器的主要作者之一——杨晓兵，来讲述这背后十多年来的漫漫研发路。

以下为杨晓兵自述：

初衷：“做一些对软件行业进步有帮助的东西”

十多年前，我在中国科学院电子学研究所工作，参与设计一些硬件电路。当时我对硬件的兴趣远超软件，后创业专门从事软件工作。

我在创业的过程中发现，做此类软件虽能赚钱，但无论做得怎样，对软件科学的进步都无丝毫作用。尽管付出很多，却无成就感。

操作系统、数据库、编译器以及浏览器内核是不需要特殊专业知识的、开发难度非常大、最基础的软件产品。

我想从这几种软件中选择其中一项来自主研发，虽然不能肯定做出什么成就，但我有希望能做出一些对软件行业进步有所帮助的东西，使自己不枉踏入软件这个行业。根据当时的情况，我发现可先从浏览器内核下手，于是我除了维护原有产品外，把主要精力都投入到浏览器的研发中。

创新将 C 代码内嵌到 HTML

两年后，我们研发完成浏览器内核的基本功能，如 HTML 的解析和显示、JavaScript 脚本的执行等。

此时，我们发现 HTML 的标准越来越复杂，导致开发难度越来越大，如果按照这样的发展，浏览器内核将无法走入市场。

于是我重新思考：如果把 C 语言处理成像 JavaScript 脚本嵌入到 HTML 中，用内嵌 C 代码的 HTML 超文本做软件的人机交互界面，这款内核应该会有点竞争优势。

于是我们花费两年半的时间将标准 C 语言以 JavaScript 相似的方式在 HTML 中执行，并扩展了一个 HTML 标签：<user>，每个 user 标签都可以用属性 src 指定一个 C 源码文件，user标签的显示界面和所有行为都由它的 C 代码决定。

同时将 C 编译器做成一个函数，用该函数编译生成 C 程序的可执行代码，执行代码可被存入文件或直接执行。此时，我们将编译器取名为 YC 编译器，浏览器内核取名为 YC 浏览器。

三年又三年，漫漫研发路

随后，我们继续完善浏览器内核，将其中的一些内核代码独立出来用内嵌编译器动态编译执行，并将大部分内核源代码开源。

与此同时，我们又遇到一个问题：YC 编译器虽然编译速度较快，生成的却是字节码，执行速度慢，而且与原生代码相互调用（特别是回调函数）的处理相当繁琐。因此用当时的 YC 编译器难以胜任开源代码的编译工作。

为了解决自编译浏览器内核代码的问题，我们决定修改 YC 编译器，使它的字节码转换为原生的执行码，并扩展语法，使之具有少量的 C++ 语法。这个工作持续了三年。

三年后，YC 编译器功能增多，它提供一个函数像调用动态链接库一样直接调用 C 源码中的函数。此时，浏览器内核开源部分都可以用 YC 编译器实时编译执行了。

我们继续改进浏览器内核，将速度很慢的 JavaScript 字节码改为二进制原生代码，使 JavaScript 的执行速度约提高约 100 多倍。同时将浏览器内核代码全部模块化并开源，每个模块都用 YC 编译器动态编译执行，编译器的部分源码也开源（如内嵌汇编编译器源码、反汇编源码、C/C++ 字节码的执行源码等），所有的开源代码均由内嵌的 YC 编译器自动检测编译，动态执行。这个工作大概耗时四年。

开发至此，我想起谷歌和火狐浏览器都已开源，为什么不去看看它们的源代码呢？于是找到这两个浏览器的源码。

当时由于一些原因，我分析谷歌浏览器源码没有编译通过，而火狐的源码很顺利就编译成功了，于是我就走上了分析火狐源码之路。

下载的火狐源码由纯 C 代码和 C++ 代码两部分组成，经 Visual C++ 2013 编译生成一个 xul.dll 文件和一个 firefox.exe 文件。

我首先分析了它的 C 代码，将所有的输出函数全部改为类接口，并让 xul.dll 通过 YC 编译器函数 YC_cppLoad 进行实时编译，然后用类接口调用 C 源码中的函数。这一步进行得很顺利，若修改了火狐的 C 代码，只要重新运行火狐浏览器便可生效，无需其它操作。

曾经的办公桌

接下来开始分析火狐 C++ 代码。YC 编译器只实现了少数几个 C++ 语法，不能编译火狐 C++ 代码，故分析起来非常困难。

为什么火狐 C 代码容易分析，而它的 C++ 代码难以分析呢？原来我用 YC 编译器将它的 C 代码生成汇编代码文件、变量结构定义文件、宏定义文件和预编译文件，通过这几个文件，大大减少了分析难度。

因此我再次决定修改 YC 编译器，使之完全支持 C++11 标准，因为火狐 C++ 代码几乎使用了所有的 C++11 语法特性。先使用 STL 标准模板库代码进行编译器的修改和调试，出乎预料，这个过程竟用了三年时间！之后，我用 YC++ 编译器开始调试火狐 C++ 代码。原以为 STL 那么复杂的代码都可以编译通过并正确执行，火狐 C++ 代码应该能很快就编译通过。没想到，很多语法细节 STL 没有用到，而火狐 C++ 源码用到了。于是又继续修改 YC 编译器，对火狐 C++ 的各个模块进行编译，这个过程持续了一年多。

虽然 YC 编译器可以编译全部火狐 C++ 代码，但如何生成执行代码呢？先从主程序 Firefox.cpp 入手，经整理，这个程序可用 YC 编译器生成执行代码 Firefox.exe，并能顺利运行。

由于火狐 C++ 各模块耦合紧密，很难拆分，经过一个多月的工作，仍未能将其拆成多个独立的源码模块以便于用 YC 编译器实时编译，动态执行，这也许是我对火狐 C++ 源码的整体结构还不甚清楚之故，只见其树木不见其森林。

杨晓兵

当我准备对火狐 C++ 代码进行再一次总体分析时，有个偶然的机会参与到一个学校管理系统的开发中，因原有的管理系统经常出故障，操作极其不方便。尽管没有开发 Web 服务程序的经历，但我做的软件与 Web 服务器有极大关系。

经了解，要开发这种管理系统需要的软件有：Apache 或 Nginx 服务器，数据库 MySQL 或其它，编程工具 ASP 或 JSP 或 PHP 等，于是启发我们自己研发这些工具。YC 的 C/C++ 和 JavaScript 编译器和 HTML 解析器正好派上用场。

经过一段时间，一个稳定的、可任意扩展的、多线程高并发的 HTTP 服务器就完成了。该服务器处理 YSP 文件生成网页传给浏览器。

YSP 是我设计的与 ASP、JSP 和 PHP 功能相似的一种网页编程语言。YC 服务器执行 YSP 文件中的内嵌 C/C++ 或 JavaScript 代码，生成 HTML 超文本传给终端设备。工具做好后，不久便做出了管理系统的雏形，这个雏形在发布的 YC 编译器中可见到。

做了上述这些工作后，我想是时候该写本书介绍一下 YC 编译器了，经过一段时间编写的《YC编译器—多语言程序设计》（暂名）即将出版。

当我把书完成后，便立即投入64位的C/C++和JavaScript编译器的开发，目前开发进展顺利，已进入测试阶段。

编者后记：

三年时间，可将一个呱呱落地的婴儿变成蹦蹦跳跳的幼儿，可将一名懵懂的职场新人变成沉稳的老兵。而杨晓兵团队沉下心，迎难而上，花费三年又三年、再一年、两年、四年的时间只为突破一个个技术难点，最终自研出 YC 编译器和 YC 浏览器内核。

在这过程中，杨晓兵坦言最大的挑战不仅是技术，还有思维的高度。这期间不仅有大量的研发工作，还为了优化，多次重写代码，让他坚持下来的是想为计算机软件科学的发展做贡献的匠心。

目前杨晓兵团队正在开发 64 位 C/C++ 编译器，谈及未来，杨晓兵表示先在国内推广，再走向海外。祝福杨晓兵。

YC编译器传送门：http://www.ycbro.com

在线咨询

上一篇：css 渐变跟随鼠标光标按钮动画
下一篇：这里归纳总结全了：前端开发必须掌握的DOM对象操作

您的项目需求

*请认真填写需求信息，我们会在24小时内与您取得联系。

整合营销服务商