PHP基礎(chǔ)知識講座：第2課，如何在HTML頁面中嵌入PHP代碼

累點滴，匯成江海。咱們從最最基礎(chǔ)的PHP知識開始學(xué)習(xí)，一步一個腳印的開啟PHP的學(xué)習(xí)旅途吧。

請點擊右上角“關(guān)注”按鈕關(guān)注我們喲：跟著木辛老師學(xué)習(xí)PHP編程知識，變身快樂的編程達人吧~

同學(xué)們好呀！木辛老師又來了。

咱們在開始PHP的學(xué)習(xí)之前，需要先準備一個可以提供PHP服務(wù)的Web服務(wù)器。我們就復(fù)用木辛老師專欄中的一個教程，使用Homestead本地開發(fā)環(huán)境進行學(xué)習(xí)唄。

傳送門：《Laravel第一課：搭建Laravel開發(fā)環(huán)境》

也可以關(guān)注木辛老師的Laravel專欄喲：

大家配置好本地開發(fā)環(huán)境以后，還需要稍微設(shè)置一下，針對這個項目，在Homestead配置文件中作如下設(shè)置，

添加指向當前項目根目錄的配置：

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代碼

然后，打開瀏覽器，訪問域名查看頁面結(jié)果

執(zhí)行效果

大家可以看到，我們已經(jīng)可以成功的訪問到測試用的PHP文件了。

好了，萬事俱備，只需要學(xué)習(xí)了。那么，咱們開始吧~

創(chuàng)建示例應(yīng)用：木辛老師的圖書館

幾乎絕大部分服務(wù)器端的腳本語言最初設(shè)計的應(yīng)用場景之一就是處理HTML表單。木辛老師要翻出家底，將自己最心愛的在線圖書商城，用來作為學(xué)習(xí)PHP基礎(chǔ)知識的場景吧。

創(chuàng)建訂購圖書用的訂單表單

通過這個表單頁面，我們可以知道顧客訂購的商品，訂單的金額以及其他一些附屬信息。HTML代碼請看下方：

<html>
 <head>
 <title>木辛老師的PHP基礎(chǔ)入門教程</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;">數(shù)量</td>
 </tr>
 <tr>
 <td>PHP入門指南</td>
 <td><input type="text" name=“book_name_01" size="3" maxlength="3"/></td>
 </tr>
 <tr>
 <td>PHP和MySQL開發(fā)</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頁面，看看效果：

頁面顯示

哈，簡單的頁面，我們已經(jīng)開啟Web開發(fā)神秘旅程了。繼續(xù)加油！

大家可能注意到了一個細節(jié)：在html代碼的form表單部分，action屬性我們指向了一個php腳本：

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

具體的PHP腳本的學(xué)習(xí)我們很快就能看到。這里只是稍微提一下，這個action屬性值就是用戶點擊“提交訂單”按鈕時將要請求的URL。

用戶在表單中輸入的數(shù)據(jù)，會以POST的方式，發(fā)送給URL指向的PHP文件進行處理。

表單處理

那如何處理這個表單呢？又如何讓PHP代碼起作用的？

要處理這個表單，我們需要創(chuàng)建一個php文件，它的名字需要和form中action屬性的值保持一致。

那么，我們就創(chuàng)建一個名字叫做processorder.php的文件吧。

代碼可以先這么寫，看看是否能起作用哈：

<html>
 <head>
 <title>訂單處理結(jié)果</title>
 </head>
 <body>
 <h1> 木辛老師的在線圖書館</h1>
 <h2> 訂單處理結(jié)果通知</h2>
 <?php echo '<p>訂單已處理完成</p>'; // 這里是PHP的代碼 ?>
 </body>
</html>

保持文件，并刷新頁面。這個時候我們點擊“提交訂單”按鈕，效果如下：

php執(zhí)行結(jié)果

大家可以看到，紅框部分就是通過PHP代碼輸出的結(jié)果。這樣，我們就實現(xiàn)了通過Web方式執(zhí)行了PHP代碼的需求，這么一看PHP還是非常簡單的吧。

我們順便在看看這個頁面的源代碼吧，看一下PHP代碼如何在HTML頁面中完成任務(wù)的吧：

源代碼

通過頁面源碼，我們發(fā)現(xiàn)剛才寫的PHP代碼已經(jīng)不見了，取而代之的是

<p>訂單已處理完成</p>

這是怎么回事呢？

這是因為PHP解釋器在腳本運行的時候，將該腳本的輸出替代了腳本自身的代碼，通過這種方式，就可以生成可以在任何瀏覽器上運行的HTML頁面了。也就是說，瀏覽器是不需要學(xué)會PHP的。

通過這段代碼，我們可以學(xué)習(xí)一些PHP的基礎(chǔ)知識：

PHP標記
PHP語句
如何空格
添加注釋

PHP標記

第一種情況：在HTML中混寫PHP和HTML代碼，需要為php添加標記。PHP代碼會以“<?php”作為開始，以“?>”作為結(jié)束。這些符號就叫做PHP標記，它們主要用來告訴服務(wù)器PHP代碼的開始和截止，在這兩個起止符號之間的任何代碼，服務(wù)器都會以PHP語法來解析。

另一種情況：之后，我們寫純PHP的時候，每個文件也需要添加PHP標記。不過呢，結(jié)束標記可以省略，這也是很大一部分PHPer默認遵守的規(guī)則。

PHP語句

在PHP的開始和截止標記之間，就是PHP語句了，通過這些內(nèi)容可以告訴PHP解釋器應(yīng)該進行如何的操作，在我們這個例子里，通過：

echo '<p>訂單已處理完成</p>’;

使用echo語句完成了一個非常簡單的操作，僅是將echo后邊的字符串原樣打印到瀏覽器中。這里需要特別注意的一點就是每個PHP語句后邊都需要添加英文的分號作為語句的結(jié)束符，否則會出現(xiàn)錯誤，但是在這個html頁面中，因為只有一句代碼，忽略掉分號也是不會報錯的。

但是還是強烈建議大家養(yǎng)成習(xí)慣：每句PHP代碼結(jié)束都要以分號結(jié)尾喲！

空格

一般情況下，為了讓代碼更加清晰和整潔，在編碼的過程中會添加一些空格，這些空格包括：回車換行、空格、制表符等都被認為是空格。

當然了，瀏覽器并不會在意你是否輸入了空格，同樣的PHP服務(wù)器端解析器也會忽略這些，這些空格僅是給編寫代碼的人看的。

但是，木辛老師還是再次強烈建議，在代碼的適當位置添加空格或者空行，這樣做可以很有效的提升代碼的可閱讀性，方便后期的維護工作。

注釋

最后在講講注釋，理論上在編程中出現(xiàn)頻率非常高的一個知識點。

為什么說理論上呢，因為這么重要的一個要點，在實際開發(fā)中很容易被廣大開發(fā)者忽略呢！

由于種種原因吧，開發(fā)者很不習(xí)慣在開發(fā)過程中寫非常詳盡的注釋，而且有時候在Git提交時也是草草的一筆帶過。這樣做的后果就是，若干時間后，當你再次拿到這段代碼，可能會花費更多的時間梳理它。

所以，善于寫注釋，也是提高生產(chǎn)效率的一種有效手段。

PHP解釋器同樣會在執(zhí)行的時候忽略掉注釋，也就是說就好比像空格一樣，PHP解析器會跳過注釋，它只負責(zé)執(zhí)行PHP代碼！

PHP腳本中的注釋比較豐富，有很多類似C語言的風(fēng)格，比如：

多行注釋：

/* 這是
 一個
 多行
 注釋
/*

可以看出來，多行注釋以 /*開始，以*/結(jié)束。同樣的和C語言是一樣的，多行注釋是不能嵌套的。

當然了，除了多行注釋之外，也支持單行注釋：

echo '<p>訂單已處理完成</p>'; // 這里是PHP的代碼

或者這種：

echo '<p>訂單已處理完成</p>’; #這里是PHP的代碼

不論采取哪種風(fēng)格的注釋，在注釋符號之后的所有內(nèi)容，PHP解釋器都會認識不需要處理的，這一點一定要注意呀！

好了，今天的課程咱就先講到這里。

小朋友們不要忘記關(guān)注我們喲，下期課程更精彩，請大家一起期待吧~

快樂編程，快樂成長，拜拜！

者 | Lyndsey Padget

譯者 |月滿西樓

本文來自公眾號“EAWorld”，ID：eaworld

今天我們來聊聊 Java中的微服務(wù)。雖說 Java EE提供了一個強大的平臺，供我們創(chuàng)建、部署和管理企業(yè)級微服務(wù)，但在本文中，我將展示如何創(chuàng)建一個盡可能小的 RESTful微服務(wù)。

放心，在這個過程中，我們不會浪費時間精力去重復(fù)做些數(shù)據(jù)處理之類的事情。我們會通過 JBoss RESTEasy來進行搭建。而確保該微服務(wù)的輕量級，目的是為了向大家展示，在一個全新或者現(xiàn)存的微服務(wù)前端，建立一個 RESTful接口，真的非常簡單。

與此同時，我會進一步證明，通過 RESTEasy構(gòu)建的微服務(wù)具備很大的靈活性，不僅可以兼容包括 JSON，XML在內(nèi)的多種數(shù)據(jù)傳輸格式，還支持將其部署到 Apache Tomcat[1]服務(wù)器而非 JBoss企業(yè)應(yīng)用平臺 (EAP)[2]上。誠然，每個工具都有自己的優(yōu)勢，但是我認為先在 KISS原則 [3]下探討技術(shù)可用性會很有幫助，然后才是根據(jù)軟件的長期目標和需求來決定應(yīng)該為服務(wù)架構(gòu)添加哪些特性。

本文中提到的代碼示例都可以在 GitHub[4]上查閱，包括“starter” 和 “final”這兩個分支。下面是我采用的環(huán)境，當然你的實際情況可能有所不同:

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位

就技術(shù)而言...

微服務(wù) [10]是一種體積小、更為精煉的服務(wù)，其目標是“做好一件事”。微服務(wù)之間通過一些接口進行交互是很普遍的現(xiàn)象。如果該接口可以通過 web訪問 (使用 HTTP)，那么它就是一個 web服務(wù)。部分 web服務(wù)是基于 RESTful這種架構(gòu)風(fēng)格的，另一些則不是。注意，微服務(wù)并不都是 web服務(wù)，web服務(wù)并不都是 RESTful web服務(wù)，RESTful web服務(wù)也并不都是微服務(wù)！

REST和 XML……能否共存？

如果你此前在使用 RESTful web服務(wù)時，沒用過除 JSON 以外的文本數(shù)據(jù)交換格式 [11]來進行內(nèi)容傳輸，那么你可能會認為二者是不相關(guān)的。但是回想下，REST是定義 API的一種架構(gòu)風(fēng)格，REST和 JSON這兩者又碰巧一起流行起來 (注意，這并非偶然)。XML多年的發(fā)展使其擁有大量的客戶群，能夠接納和提供 XML數(shù)據(jù)傳輸格式的 RESTful web服務(wù), 不管是對那些已經(jīng)依賴于這類內(nèi)容交互系統(tǒng)的組織，還是對僅僅是更熟悉 XML的用戶來說，都非常有用。當然，通常情況下，JSON依然是首選，因為其消息體更小，但有時 XML只是一個更簡單的“sell”。擁有一個能同時支持這兩種格式的 RESTful微服務(wù)是最理想的 ;從部署的角度來說，它不僅簡潔，具備可擴展性，還有足夠的靈活性，可以支持不同類型的內(nèi)容，從而滿足那些其他有調(diào)用需求的應(yīng)用程序。

為什么選擇 RESTEasy？

RESTEasy[12]是 Jboss的一個框架，可以用來構(gòu)建 RESTful web服務(wù)。通過 RESTEasy構(gòu)建的 RESTful web服務(wù)，可以根據(jù)四個函數(shù)庫來實現(xiàn)對 XML和 JSON這兩種數(shù)據(jù)傳輸格式的支持：

resteasy-jaxrs，實現(xiàn)了 JAX-RS 2.0 (用于 RESTful Web服務(wù)的 Java API) [13]
resteasy-jaxb-provider，其 JAXB[14]綁定能有效支持 XML
resteasy-jettison-provider，用 Jettison[15]將 XML轉(zhuǎn)換為 JSON
resteasy-servlet-initializer，將服務(wù)部署到 Servlet 3.0容器 (在 Tomcat服務(wù)器上)

首先，創(chuàng)建一個內(nèi)含 pom.xml數(shù)據(jù)包的 web服務(wù)項目:

<?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>

（左右滑動可查看全部代碼，下同）

這些數(shù)據(jù)庫的大小大概在 830KB。當然，這些直接的依賴環(huán)境（dependency），運用 Maven一起構(gòu)建項目也會帶來部分傳遞性依賴。

接下來，我將用“Maven方法”來構(gòu)建這個項目，例如在 src/main/java中，使用 Maven構(gòu)建命令等，不想用 Maven的話，你也可以直接從下載頁面 [16]下載 RESTEasy jar數(shù)據(jù)包。下載的時候不用理會 RESTEasy站點上彈出的這個提示:JBoss僅僅是在嘗試引導(dǎo)你采用更“企業(yè)化”的方法。你只需點擊“繼續(xù)下載”，來開展后面的操作。

項目設(shè)計

下面這個微服務(wù)可以用非常簡單的方法來演示一些基本概念。如下圖所示，它包括 5個等級。

此處，F(xiàn)ruitApplication是微服務(wù)的切入點。FruitService提供了主要的路徑 (/fruits)，同時它也充當了路由器的功能。蘋果和水果都是模型；水果包含一些抽象的功能，蘋果則會具體地擴展它的功能。

和你設(shè)想一致的是，F(xiàn)ruitComparator可以提供比較功能。不熟悉 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結(jié)構(gòu)的樣子:

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

因為沒有約定明顯的構(gòu)造函數(shù):Java使用了隱式的、無參數(shù)的默認構(gòu)造函數(shù)，所以一些更微妙的事情在發(fā)生。這個無參數(shù)的構(gòu)造函數(shù)對 JAXB 施展魔法般效果的工作是十分必要的（本文解釋了這一點，以及必要的話，如何用 XMLAdapter來讓它工作）。

現(xiàn)在我們有了一個對象：被定義的蘋果。它有三個屬性: ID、多樣性和顏色。

服務(wù)

FruitService 被用來作為與微服務(wù)交互的主要路徑 (/fruits)。在本例中，我使用 @path注釋直接在該層級中定義了第一個路徑，/fruits/apples。隨著 RESTful微服務(wù)的擴展，你可能希望在自己的層級中定義多個最終路徑 (例如 /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; } }

這張?zhí)O果的地圖幫助我們根據(jù) id跟蹤蘋果的數(shù)據(jù)，從而模擬某些類型的數(shù)據(jù)持久層。利用 getApples方法（常用的 HTTP請求方式）將會返回地圖跟蹤到的相關(guān)蘋果數(shù)據(jù)。GET /apples route是用 @GET和 @path注釋定義的，它可以生成數(shù)據(jù)傳輸格式 XML或 JSON的內(nèi)容。

這個方法需要返回一個 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); } }

注意，如果想要對蘋果的一個特定屬性進行排序，比如顏色，我們就必須創(chuàng)建一個新的比較器去取代，并取個名字，比如 AppleComparator。

應(yīng)用程序

在 RESTEasy3.1.x中, 你需要定義一個擴展應(yīng)用的層級。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文件中將它連接起來，這會在后面的章節(jié)“web服務(wù)連接”中進行介紹。

對象的構(gòu)建集合

GET /apples調(diào)用將返回如下數(shù)據(jù)：

<?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" } } ]

但是，我們可以將數(shù)據(jù)更改成看起來稍有點不同：

<?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產(chǎn)生了不太好的影響。如果你喜歡這個結(jié)構(gòu)，可以用它自己的類型打包 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服務(wù)連接

從將該服務(wù)部署到 Tomcat開始，我用一個放在 src/main/webapp/web inf/web.xml的 web應(yīng)用部署描述符文件。它所包含的內(nèi)容如下：

<?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服務(wù)器將包含該模式的傳入請求傳輸?shù)?Resteasy服務(wù)。關(guān)于如何建立這個文件的更多信息，以及可用的不同選項，請參閱 Tomcat的應(yīng)用程序部署文檔 [17]。

構(gòu)建及部署

從項目的根目錄中，可以運行以下內(nèi)容來構(gòu)建 WAR(web application resource，web應(yīng)用程序資源)文件:

mvn clean install

這將在 target文件夾中創(chuàng)建一個包含 WAR文件的新文件夾。雖然用 Maven或其他工具來部署該文件也可以，但我只用一個簡單的復(fù)制命令就可以。需要注意的是，每次將 WAR重新部署到 Tomcat服務(wù)器時，應(yīng)該首先暫停服務(wù)器運行，并刪除服務(wù)應(yīng)用程序文件夾 (在本例中，是這個文件夾：< tomcatDirectory >/webapps/resteasy)和舊的 WAR文件 (< tomcatDirectory >/webapps/resteasy.war)。

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

如果此時 Tomcat服務(wù)器正在運行，那么會即刻部署 web服務(wù)。如果不是，下次服務(wù)器啟動時，該服務(wù)也會被自動部署上去。然后,就可以通過如下地址訪問 web服務(wù)：http://< tomcatHost >:< tomcatPort >/resteasy/v1/fruits/apples。我的范例中是這個地址 http://localhost:8080/resteasy/v1/fruits/apples。

通過“內(nèi)容協(xié)商（Content negotiation）”測試服務(wù)

內(nèi)容協(xié)商（Content negotiation）是一種機制，它可以提供不同資源 (URI)的表現(xiàn)形式。最基本的，這意味著可以:

詳細設(shè)置 Accept header，以指示希望從服務(wù)中接受的內(nèi)容類型
詳細設(shè)置 Content-Type header，以指示發(fā)送給服務(wù)的內(nèi)容類型

要獲取更多關(guān)于內(nèi)容協(xié)商（Content negotiation）和 header的信息，請參閱 RFC 2616[18]的第 12和 14章。在本例中，你真正需要了解的是:

@Produces annotation（注釋）指明了該方法能夠生成哪些內(nèi)容 (這將嘗試匹配請求上的 Accept header)。
@Consumes annotation（注釋）指明了該方法能夠使用哪些內(nèi)容 (這將嘗試匹配請求的 content-type header)。

如果您試圖對一個有效端點進行 HTTP調(diào)用，但是內(nèi)容不能被協(xié)商，這意味著沒有 @Produces匹配該 Accept數(shù)據(jù)，或者沒有 @Consumes匹配 Content-Type數(shù)據(jù)，將被返回 HTTP狀態(tài)碼 415:不支持的數(shù)據(jù)傳輸格式。

返回常見數(shù)據(jù)傳輸格式的 GET調(diào)用實際上可以直接進入瀏覽器。對于 GET /apples這樣的調(diào)用，默認情況下您將獲得 XML:

不過，使用像 Postman[19]這類工具可能會更有幫助，因為它明確地指定 Accept header作為 application/xml:

這兩種方法都返回了一些有效但沒有多大意義的 XML，即一個空的蘋果列表。但是這里有一些很酷的東西。將 Accept header更改為 application/json，太好了，瞧！JSON*生效*了:

不只是“讀取”

你可能會發(fā)現(xiàn)，很多 RESTful web服務(wù)的例子，都是只讀的，部分也不會有進一步的提示，比如如何去創(chuàng)建、更新和刪除這些操作。雖然我們現(xiàn)在已經(jīng)有了 web服務(wù)的框架，但這是一個不能更改的空列表，這并沒多大意義。所以我們應(yīng)該運用一些其他方法，將蘋果添加到這個列表中或從列表中將其刪除。

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檢索蘋果數(shù)據(jù) (如果在地圖中沒有找到，則返回狀態(tài)代碼 404)
通過 id刪除蘋果數(shù)據(jù)
創(chuàng)建新的蘋果數(shù)據(jù) (如果成功的話，返回狀態(tài)代碼 201)

這些方法完善了很多功能，確保了服務(wù)可以按照預(yù)期工作。更新蘋果 (使用 @PUT和 /或 @PATCH)，以及更多的關(guān)于端點、邏輯和管理持久性方面的功能操作，都留給讀者你們來練習(xí)吧。

當我們再次進行構(gòu)建和部署時會發(fā)現(xiàn) (如果用 Maven或者 Tomcat來進行設(shè)置，請參閱上文“構(gòu)建和部署”)，現(xiàn)在已經(jīng)可以在服務(wù)中創(chuàng)建、檢索和刪除蘋果了。而且即使不在服務(wù)器上做任何重新配置，也可以在 XML和 JSON之間進行選擇性調(diào)用。

來創(chuàng)建一個擁有“application/json”內(nèi)容類型和 JSON主體的蘋果，如下圖所示:

這是另一個例子:創(chuàng)建一個具有“application/xml”內(nèi)容類型和 XML主體的蘋果。

在 XML中檢索所有的蘋果數(shù)據(jù):

在 JSON中通過 id檢索 apple 2的數(shù)據(jù)：

通過 id刪除 apple 1的數(shù)據(jù)：

在 JSON中檢索所有蘋果的數(shù)據(jù)：

小結(jié)

在此我們已經(jīng)探討了 RESTEasy架構(gòu)如何在 Java web服務(wù)中無縫支持 XML和 JSON數(shù)據(jù)傳輸格式。我還解釋了 REST、Media type(數(shù)據(jù)傳輸格式)、web服務(wù)和微服務(wù)之間的技術(shù)差異，因為在這些術(shù)語中有很多容易混淆的灰色地帶。

我這里列舉的例子可能有點勉強，生活中我其實從來沒有真正需要過水果相關(guān)的數(shù)據(jù)，我也沒有在食品行業(yè)工作過。之所以用水果來舉例，是因為我覺得這個“規(guī)?！蹦苡兄诖蠹依斫馕⒎?wù)的概念，你也可以想象其他例如蔬菜，罐頭或海鮮這樣的微服務(wù)是如何共同構(gòu)成一個食物分配系統(tǒng)。現(xiàn)實世界中，食品雜貨店的食物分配系統(tǒng)實際上非常復(fù)雜，它必須考慮到包括銷售、優(yōu)惠券、過期日期、營養(yǎng)信息等各方面的問題。

當然，你可以選擇其他方式去對系統(tǒng)進行分割，但當你需要一種快速高效、輕量級工具來支持多種數(shù)據(jù)格式時，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/

期望得到更多優(yōu)質(zhì)技術(shù)干貨，歡迎加入 EAWorld社區(qū)，與近萬名技術(shù)人一起成長。入群暗號：328

述 | 楊曉兵

編輯 | 伍杏玲

出品 | CSDN（ID：CSDNnews）

編者前記：

編譯器是連接人類世界與機器世界之間的一座橋梁，它可將程序員理解的高級語言，轉(zhuǎn)換成程序高效執(zhí)行的機器碼。在 C/C++ 編譯器里，有 VC、Borland C++、GCC、Watcom C/C++ 等國外熱門編譯器，但屬于國內(nèi)自主研發(fā)的編譯器較少。

畢竟開發(fā)一款實用的編譯器不易，涉及前端詞法、語法分析、語意分析、大量的編譯優(yōu)化等工作。而有一支團隊，不惜花費十余年精力完全自主研發(fā)出一款 YC 編譯器和 YC 瀏覽器內(nèi)核。

為何他們不遺余力地自主研發(fā)編譯器和瀏覽器內(nèi)核？這款編譯器有何優(yōu)點呢？下面由 YC 編譯器的主要作者之一——楊曉兵，來講述這背后十多年來的漫漫研發(fā)路。

以下為楊曉兵自述：

初衷：“做一些對軟件行業(yè)進步有幫助的東西”

十多年前，我在中國科學(xué)院電子學(xué)研究所工作，參與設(shè)計一些硬件電路。當時我對硬件的興趣遠超軟件，后創(chuàng)業(yè)專門從事軟件工作。

我在創(chuàng)業(yè)的過程中發(fā)現(xiàn)，做此類軟件雖能賺錢，但無論做得怎樣，對軟件科學(xué)的進步都無絲毫作用。盡管付出很多，卻無成就感。

操作系統(tǒng)、數(shù)據(jù)庫、編譯器以及瀏覽器內(nèi)核是不需要特殊專業(yè)知識的、開發(fā)難度非常大、最基礎(chǔ)的軟件產(chǎn)品。

我想從這幾種軟件中選擇其中一項來自主研發(fā)，雖然不能肯定做出什么成就，但我有希望能做出一些對軟件行業(yè)進步有所幫助的東西，使自己不枉踏入軟件這個行業(yè)。根據(jù)當時的情況，我發(fā)現(xiàn)可先從瀏覽器內(nèi)核下手，于是我除了維護原有產(chǎn)品外，把主要精力都投入到瀏覽器的研發(fā)中。

創(chuàng)新將 C 代碼內(nèi)嵌到 HTML

兩年后，我們研發(fā)完成瀏覽器內(nèi)核的基本功能，如 HTML 的解析和顯示、JavaScript 腳本的執(zhí)行等。

此時，我們發(fā)現(xiàn) HTML 的標準越來越復(fù)雜，導(dǎo)致開發(fā)難度越來越大，如果按照這樣的發(fā)展，瀏覽器內(nèi)核將無法走入市場。

于是我重新思考：如果把 C 語言處理成像 JavaScript 腳本嵌入到 HTML 中，用內(nèi)嵌 C 代碼的 HTML 超文本做軟件的人機交互界面，這款內(nèi)核應(yīng)該會有點競爭優(yōu)勢。

于是我們花費兩年半的時間將標準 C 語言以 JavaScript 相似的方式在 HTML 中執(zhí)行，并擴展了一個 HTML 標簽：<user>，每個 user 標簽都可以用屬性 src 指定一個 C 源碼文件，user標簽的顯示界面和所有行為都由它的 C 代碼決定。

同時將 C 編譯器做成一個函數(shù)，用該函數(shù)編譯生成 C 程序的可執(zhí)行代碼，執(zhí)行代碼可被存入文件或直接執(zhí)行。此時，我們將編譯器取名為 YC 編譯器，瀏覽器內(nèi)核取名為 YC 瀏覽器。

三年又三年，漫漫研發(fā)路

隨后，我們繼續(xù)完善瀏覽器內(nèi)核，將其中的一些內(nèi)核代碼獨立出來用內(nèi)嵌編譯器動態(tài)編譯執(zhí)行，并將大部分內(nèi)核源代碼開源。

與此同時，我們又遇到一個問題：YC 編譯器雖然編譯速度較快，生成的卻是字節(jié)碼，執(zhí)行速度慢，而且與原生代碼相互調(diào)用（特別是回調(diào)函數(shù)）的處理相當繁瑣。因此用當時的 YC 編譯器難以勝任開源代碼的編譯工作。

為了解決自編譯瀏覽器內(nèi)核代碼的問題，我們決定修改 YC 編譯器，使它的字節(jié)碼轉(zhuǎn)換為原生的執(zhí)行碼，并擴展語法，使之具有少量的 C++ 語法。這個工作持續(xù)了三年。

三年后，YC 編譯器功能增多，它提供一個函數(shù)像調(diào)用動態(tài)鏈接庫一樣直接調(diào)用 C 源碼中的函數(shù)。此時，瀏覽器內(nèi)核開源部分都可以用 YC 編譯器實時編譯執(zhí)行了。

我們繼續(xù)改進瀏覽器內(nèi)核，將速度很慢的 JavaScript 字節(jié)碼改為二進制原生代碼，使 JavaScript 的執(zhí)行速度約提高約 100 多倍。同時將瀏覽器內(nèi)核代碼全部模塊化并開源，每個模塊都用 YC 編譯器動態(tài)編譯執(zhí)行，編譯器的部分源碼也開源（如內(nèi)嵌匯編編譯器源碼、反匯編源碼、C/C++ 字節(jié)碼的執(zhí)行源碼等），所有的開源代碼均由內(nèi)嵌的 YC 編譯器自動檢測編譯，動態(tài)執(zhí)行。這個工作大概耗時四年。

開發(fā)至此，我想起谷歌和火狐瀏覽器都已開源，為什么不去看看它們的源代碼呢？于是找到這兩個瀏覽器的源碼。

當時由于一些原因，我分析谷歌瀏覽器源碼沒有編譯通過，而火狐的源碼很順利就編譯成功了，于是我就走上了分析火狐源碼之路。

下載的火狐源碼由純 C 代碼和 C++ 代碼兩部分組成，經(jīng) Visual C++ 2013 編譯生成一個 xul.dll 文件和一個 firefox.exe 文件。

我首先分析了它的 C 代碼，將所有的輸出函數(shù)全部改為類接口，并讓 xul.dll 通過 YC 編譯器函數(shù) YC_cppLoad 進行實時編譯，然后用類接口調(diào)用 C 源碼中的函數(shù)。這一步進行得很順利，若修改了火狐的 C 代碼，只要重新運行火狐瀏覽器便可生效，無需其它操作。

曾經(jīng)的辦公桌

接下來開始分析火狐 C++ 代碼。YC 編譯器只實現(xiàn)了少數(shù)幾個 C++ 語法，不能編譯火狐 C++ 代碼，故分析起來非常困難。

為什么火狐 C 代碼容易分析，而它的 C++ 代碼難以分析呢？原來我用 YC 編譯器將它的 C 代碼生成匯編代碼文件、變量結(jié)構(gòu)定義文件、宏定義文件和預(yù)編譯文件，通過這幾個文件，大大減少了分析難度。

因此我再次決定修改 YC 編譯器，使之完全支持 C++11 標準，因為火狐 C++ 代碼幾乎使用了所有的 C++11 語法特性。先使用 STL 標準模板庫代碼進行編譯器的修改和調(diào)試，出乎預(yù)料，這個過程竟用了三年時間！之后，我用 YC++ 編譯器開始調(diào)試火狐 C++ 代碼。原以為 STL 那么復(fù)雜的代碼都可以編譯通過并正確執(zhí)行，火狐 C++ 代碼應(yīng)該能很快就編譯通過。沒想到，很多語法細節(jié) STL 沒有用到，而火狐 C++ 源碼用到了。于是又繼續(xù)修改 YC 編譯器，對火狐 C++ 的各個模塊進行編譯，這個過程持續(xù)了一年多。

雖然 YC 編譯器可以編譯全部火狐 C++ 代碼，但如何生成執(zhí)行代碼呢？先從主程序 Firefox.cpp 入手，經(jīng)整理，這個程序可用 YC 編譯器生成執(zhí)行代碼 Firefox.exe，并能順利運行。

由于火狐 C++ 各模塊耦合緊密，很難拆分，經(jīng)過一個多月的工作，仍未能將其拆成多個獨立的源碼模塊以便于用 YC 編譯器實時編譯，動態(tài)執(zhí)行，這也許是我對火狐 C++ 源碼的整體結(jié)構(gòu)還不甚清楚之故，只見其樹木不見其森林。

楊曉兵

當我準備對火狐 C++ 代碼進行再一次總體分析時，有個偶然的機會參與到一個學(xué)校管理系統(tǒng)的開發(fā)中，因原有的管理系統(tǒng)經(jīng)常出故障，操作極其不方便。盡管沒有開發(fā) Web 服務(wù)程序的經(jīng)歷，但我做的軟件與 Web 服務(wù)器有極大關(guān)系。

經(jīng)了解，要開發(fā)這種管理系統(tǒng)需要的軟件有：Apache 或 Nginx 服務(wù)器，數(shù)據(jù)庫 MySQL 或其它，編程工具 ASP 或 JSP 或 PHP 等，于是啟發(fā)我們自己研發(fā)這些工具。YC 的 C/C++ 和 JavaScript 編譯器和 HTML 解析器正好派上用場。

經(jīng)過一段時間，一個穩(wěn)定的、可任意擴展的、多線程高并發(fā)的 HTTP 服務(wù)器就完成了。該服務(wù)器處理 YSP 文件生成網(wǎng)頁傳給瀏覽器。

YSP 是我設(shè)計的與 ASP、JSP 和 PHP 功能相似的一種網(wǎng)頁編程語言。YC 服務(wù)器執(zhí)行 YSP 文件中的內(nèi)嵌 C/C++ 或 JavaScript 代碼，生成 HTML 超文本傳給終端設(shè)備。工具做好后，不久便做出了管理系統(tǒng)的雛形，這個雛形在發(fā)布的 YC 編譯器中可見到。

做了上述這些工作后，我想是時候該寫本書介紹一下 YC 編譯器了，經(jīng)過一段時間編寫的《YC編譯器—多語言程序設(shè)計》（暫名）即將出版。

當我把書完成后，便立即投入64位的C/C++和JavaScript編譯器的開發(fā)，目前開發(fā)進展順利，已進入測試階段。

編者后記：

三年時間，可將一個呱呱落地的嬰兒變成蹦蹦跳跳的幼兒，可將一名懵懂的職場新人變成沉穩(wěn)的老兵。而楊曉兵團隊沉下心，迎難而上，花費三年又三年、再一年、兩年、四年的時間只為突破一個個技術(shù)難點，最終自研出 YC 編譯器和 YC 瀏覽器內(nèi)核。

在這過程中，楊曉兵坦言最大的挑戰(zhàn)不僅是技術(shù)，還有思維的高度。這期間不僅有大量的研發(fā)工作，還為了優(yōu)化，多次重寫代碼，讓他堅持下來的是想為計算機軟件科學(xué)的發(fā)展做貢獻的匠心。

目前楊曉兵團隊正在開發(fā) 64 位 C/C++ 編譯器，談及未來，楊曉兵表示先在國內(nèi)推廣，再走向海外。祝福楊曉兵。

YC編譯器傳送門：http://www.ycbro.com

在線咨詢

上一篇：css 漸變跟隨鼠標光標按鈕動畫
下一篇：這里歸納總結(jié)全了：前端開發(fā)必須掌握的DOM對象操作

您的項目需求

*請認真填寫需求信息，我們會在24小時內(nèi)與您取得聯(lián)系。

整合營銷服務(wù)商

PHP基礎(chǔ)知識講座：第2課，如何在HTML頁面中嵌入PHP代碼