整合營銷服務商
電腦端+手機端+微信端=數據同步管理
免費咨詢熱線：
電腦端+手機端+微信端=數據同步管理
免費咨詢熱線：
日常寫Java的時候，對于字符串的操作是非常普遍的，其中最常見的就是對字符串的組織。也因為這個操作非常普遍，所以誕生了很多方案，總下來大概有這么幾種：
下面，我們一起來學習一下Java 21中的新方案！如果您對于上面這些還不熟悉的話，建議可以先看一下這篇《Java自帶的4種字符串組織和格式化方法》，了解以前的機制，這樣與最新的處理方案做對比，理解會更深刻。
在Java 21中處理字符串的新方法稱為：Template Expressions，即：模版表達式。
模版表達式是Java語言中的一種新表達式。它可以執行字符串插值，幫助開發人員通過編程的方式安全高效地組織字符串。此外，模板表達式不僅僅可以用于組織字符串，它還可以根據特定模型的規則將結構化文本轉換為任何類型的對象。
下面通過一個簡單的案例來認識一下它：
|
上述代碼中的第2行就是一個模版表達式，其中主要包含三個部分：
當模版表達式運行的時候，模版處理器會將模版內容與內嵌表達式的值組合起來，生成結果，所以上面案例中的字符串str在運行時的結果為：My blog is blog.didispace.com。
還記得之前我們的Java新特性專欄中，介紹過Java 15中的文本塊特性嗎？類似下面這樣的寫法：
|
模版表達式也支持類似的多行字符串處理，所以開發者可以用它來方便的組織html、json、xml等字符串內容，比如下面這樣：
|
上面案例中我們所用的STR模版處理器中的內嵌表達式都采用了字符串內容，而實際上STR模版處理器還有更多的用途。
|
最終s字符串結果為：10 + 20 = 30
|
假設getMyBlog方法返回的內容為blog.didispace.com，那么最終s字符串結果為：My blog is blog.didispace.com。
|
最終s字符串結果為：didi的博客地址為：blog.didispace.com。
除了STR模版處理器之外，Java中還提供了另外一個模版處理器：FMT。FMT模版處理器除了與STR模版處理器一樣提供插值能力之外，還提供了左側的格式化處理。下面通過例子來直接理解FMT的功能：
|
上面這塊是由STR模版處理器組織字符串表格數據，從模版表達式來看是非常整齊的，但是由于模版中內嵌表達式的值長短不一，最終輸出結果很有可能差強人意，比如STR模版處理器處理后的結果是這樣的：
|
為了解決這個問題，就可以采用FMT模版處理器，在每一列左側定義格式
|
這樣的結果將是如下這樣，獲得一個整齊的結果：
|
關于Java 21中推出的String Templates特性還有很多高級能力，比如：自定義模版處理器等。因為該特性還處于Preview階段，所以DD也還沒有深入研究，僅嘗鮮了一下基本功能，如果您對其他高級能力感興趣，也可以通過官網學習。等該功能正式發布之后，我會在 Java新特性專欄 中更新解讀所有內容，歡迎關注與收藏。
者 | 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服務和微服務之間的技術差異，因為在這些術語中有很多容易混淆的灰色地帶。
我這里列舉的例子可能有點勉強，生活中我其實從來沒有真正需要過水果相關的數據，我也沒有在食品行業工作過。之所以用水果來舉例，是因為我覺得這個“規模”能有助于大家理解微服務的概念，你也可以想象其他例如蔬菜，罐頭或海鮮這樣的微服務是如何共同構成一個食物分配系統?，F實世界中，食品雜貨店的食物分配系統實際上非常復雜，它必須考慮到包括銷售、優惠券、過期日期、營養信息等各方面的問題。
當然，你可以選擇其他方式去對系統進行分割，但當你需要一種快速高效、輕量級工具來支持多種數據格式時，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
1.打開https://chrome.google.com/webstore/category/extensions網站，搜索Selenium IDE
2.進入Selenium IDE詳情頁，點擊Add to Chrome即可
3.點擊Chrome右上角的“擴展程序”按鈕，點擊Selenium IDE就可以打開軟件，錄制自動化腳本
1.搜索selenium插件
打開FireFox瀏覽器，打開設置->擴展和主題,然后輸入selenium點擊搜索
2.添加到FireFox
選擇搜索的插件并且添加到FireFox
3.點擊Chrome右上角的“擴展程序”按鈕，點擊Selenium IDE就可以打開軟件，錄制自動化腳本
1.插件使用
點擊selenium插件彈出插件selenium ide錄制插件
2.自動化錄制
點擊創建新的項目，并且輸入項目名稱
點擊開始錄制并輸入網址
打開百度，在輸入框中輸入"騰訊課堂"，選擇“騰訊課堂”的鏈接跳轉到騰訊課堂官網，然后再騰訊課堂的輸入框中輸入"車載測試"
3.腳本回放
<dependency>
<groupId>org.seleniumhq.selenium</groupId>
<artifactId>selenium-java</artifactId>
<version>4.9.1</version>
</dependency>// get(String url):訪問指定網址
driver.get("https://www.selenium.dev/selenium/web/web-form.html");
// getCurrentUrl():獲取當前網頁Url
webDriver.getCurrentUrl();
// getTitle():獲取當前頁面標題
webDriver.getTitle();
// getPageSource():獲取當前頁面源碼
webDriver.getPageSource();
// quit():關閉驅動對象以及所有相關的窗口
webDriver.quit();
// close():關閉當前窗口
webDriver.close();
// getWindowHandle():獲取當前頁面句柄
webDriver.getWindowHandle();
// getWindowHandles():獲取打開所有窗口的句柄
//-----------Options 相關API------------
webDriver.getWindowHandles();
// manage():瀏覽器options相關設置
Options options = webDriver.manage();
// 窗口操作
Window window = options.window();
// 窗口全屏
window.fullscreen();
// 窗口最大化
window.maximize();
// 窗口的大?。簩挾群透叨?Dimension dimension = window.getSize();
System.out.println("width"+dimension.getWidth()+" height:"+dimension.getHeight());
// 窗口位置；X,Y
Point point = window.getPosition();
System.out.println("x:"+point.getX()+" y:"+point.getY());
//------------navigate對象相關API----------
// 獲取navigate對象
Navigation navigation = webDriver.navigate();
// 訪問指定url
navigation.to(base_url);
// 刷新當前頁面
navigation.refresh();
// 瀏覽器回退
navigation.back();
// 瀏覽器前進
navigation.forward();
// 根據ID屬性獲取元素
webDriver.findElement(By.id("kw")).sendKeys("車載測試");// 根據name屬性獲取元素:有可能會重復
webDriver.findElement(By.name("wd")).sendKeys("車載測試");// 根據標簽名定位元素:不推薦使用，一般會定位到多個元素，有可能會定位不準確
webDriver.findElement(By.tagName("intput")).sendKeys("車載測試"); // 根據className定位元素:也有可能會定位到多個元素
webDriver.findElement(By.className("s_ipt")).sendKeys("車載測試");--javascripttypescriptbashsqljsonhtmlcssccppjavarubypythongorustmarkdown
// 根據超鏈接文本定位元素:完成文本
webDriver.findElement(By.linkText("新聞")).click();--javascripttypescriptbashsqljsonhtmlcssccppjavarubypythongorustmarkdown
// 根據超鏈接文本定位元素:部分或全部文本
webDriver.findElement(By.partialLinkText("123")).click();// 根據tagName
webDriver.findElement(By.cssSelector("input"));
// 根據ID
webDriver.findElement(By.cssSelector("#kw"));
//根據className:可以同時根據多個className定位
webDriver.findElement(By.cssSelector(".input.bg"));
// 根據標簽名和屬性名和值進行定位：intput[屬性名='值'][屬性名2='值']
webDriver.findElement(By.cssSelector("input[class='bg s_btn']"));3.2.8.xpath定位元素
// 1.相對路徑定位
// xpath定位方式:相對路徑。如果多個屬性時候使用" and "
webDriver.findElement(By.xpath("//input[@id='kw' and @class='s_btn']"));
// 根據元素文本值精確定位
webDriver.findElement(By.xpath("//a[text()='新聞']")).click();
// 根據元素文本值模糊定位
webDriver.findElement(By.xpath("//a[contains(text(),'123')]")).click();
// 2.絕對路徑定位
// xpath定位方式:絕對路徑，由于前段的調整導致絕對定位失敗，導致自動化腳本運行失敗，所以不常用，也不推薦使用
webDriver.findElement(By.xpath("/html/body/div[1]/div[1]/div[5]/div/div/form/span[1]/input")).sendKeys("車載測試");// sendKeys("") 設置值
webDriver.findElement(By.className("s_ipt")).sendKeys("車載測試");
// click() 元素點擊事件
webDriver.findElement(By.partialLinkText("123")).click();
// clear() 清空
webDriver.findElement(By.className("s_ipt")).clear();說明：程序在運行過程中太快了，導致數據加載未完成或者其他操作未完成導致自動化腳本運行過程中失敗，所以需要在自動化腳本中引入等待機制，在需要等待的地方加入等待機制保證腳本的正常運行
說明：固定時間長度等待。即使在等待時間內已經獲取到元素依然會等待，直到時間結束才會結束等待
Thread.sleep(1000);說明：在設置的超時范圍內不斷查找元素，直到找到元素或超時。優點：相對靈活，缺點:設置是全局的，在webDriver整個生命周期有效。會給所有的元素都添加超時機制
// 全局設置查找元素超時時間為5S，如果獲取到結束等待；如果沒有獲取到元素會嘗試重新獲取，直到超時
Duration duration = Duration.ofSeconds(5);
webDriver.manage().timeouts().implicitlyWait(duration);說明：用來等待某個條件發生后再繼續執行后面的代碼
// 給單個獲取元素操作添加等待。
// ExpectedConditions.visibilityOfElementLocated:元素可見
WebDriverWait wait = new WebDriverWait(webDriver, Duration.ofSeconds(implicitly_wait));
wait.until(ExpectedConditions.visibilityOfElementLocated(By.xpath("//a[text() = '騰訊課堂_專業的在線教育平臺']"))).click();說明：模態框是指用戶想要進行后續操作時，必須先點擊模態框的”確定“或”取消“按鈕關閉模態框。主要由alert和confirm
Alert alert = webDriver.switchTo().alert();
// 同意
alert.accept();
// 取消
alert.dismiss();
// 獲取文本內容
alert.getText();四種切換方式：
webDriver.switchTo().frame(index);
webDriver.switchTo().frame(nameOrId);
webDriver.switchTo().frame(frameElement);
切換之后，回到默認內容頁面，否則會找不到元素
webDriver.switchTo().defaultContent();
當你想要操作另外一個窗口元素時候，一定 要寫切換窗口。切換方式：傳入窗口句柄或窗口名進行切換
// 獲取當前窗口句柄
String currentWindowHandle = webDriver.getWindowHandle();
webDriver.switchTo().window(currentWindowHandle);
// 多個窗口同時開啟的時候要先獲取所有開啟窗口的句柄，然后循環切換并結合窗口的標題進行確定需要切換到的窗口
for (String handle : webDriver.getWindowHandles()) {
webDriver.switchTo().window(handle);
if(webDriver.getTitle().equals("aaaa")) {
break;
}
}
// 進行后續操作需要將web元素封裝成為Select對象，然后調用Select的api進行操作
Select select = new Select(webDriver.findElement(By.id("")));
// 獲取所有下拉元素
select.getOptions();
// 根據下標選擇元素
select.selectByIndex(1);
// 根據隱藏值選擇元素
select.selectByValue("");
// 根據現實文本選中元素
select.selectByVisibleText("");情況一：控件沒有限制手動輸入，可以直接調用sendKeys寫入時間數據
// 打開飛豬，在時間框中輸入“2023-06-04”時間
webDriver.findElement(By.xpath("//*[@id='J_FlightForm'] //input[@name='depDate']")).sendKeys("2023-06-04");情況二：控件限制輸入，那么只能通過js代碼來改變元素值
JavascriptExecutor exception = (JavascriptExecutor) webDriver;
// 執行js代碼移除元素的readonly屬性
exception.executeScript("document.getElementById('').removeAttribute('readonly')", "");
webDriver.findElement(By.id("")).sendKeys("2023-06-04");Actions actions = new Actions(webDriver);
// 鼠標拖拽
actions.clickAndHold(null).moveToElement(null).release().build().perform();
// 鼠標按下
actions.keyDown(null).release().build().perform();
// 鼠標彈起
actions.keyUp(null).release().build().perform();
// 鼠標雙擊
actions.doubleClick(null).release().build().perform();
// 鼠標滾動
actions.scrollToElement(null).release().build().perform();情況一：使用input標簽進行文件上傳。使用sendKeys方法寫入文件數據
// 獲取文件上傳input
webDriver.findElement(By.xpath("//input[@type='file' and @name]='file'")).sendKeys("文件路徑");
//點擊上傳按鈕
webDriver.findElement(By.id("submit")).click();情況二：使用第三方控件。必須使用一些第三方的工具
主要由3中處理方式：
一：去除驗證碼-測試環境時候
二：使用驗證碼識別庫進行識別-代碼復雜，效率低，成功率低，只適合簡單的驗證碼
三：使用萬能驗證碼(推薦)-后臺設置一個萬能驗證碼
*請認真填寫需求信息，我們會在24小時內與您取得聯系。
