java冪等

① java介面文檔怎麼寫

一些剛開始寫介面文檔的服務端同學，很容易按著代碼的思路去編寫介面文檔，這讓客戶端同學或者是服務對接方技術人員經常吐槽，看不懂介面文檔。這篇文章提供一個常規介面文檔的編寫方法，給大家參考。

推薦使用的是docway寫介面文檔，方便保存和共享，支持導出PDF MARKDOWN，支持團隊項目管理。

一、請求參數

1. 請求方法

• GET

用於獲取數據

• POST

用於更新數據，可與PUT互換，語義上PUT支持冪等

• PUT

用於新增數據，可與POST互換，語義上PUT支持冪等

• DELETE

用於刪除數據

• 其他

其他的請求方法在一般的介面中很少使用。如：PATCH HEAD OPTIONS

2. URL

url表示了介面的請求路徑。路徑中可以包含參數，稱為地址參數，如**/user/{id}**，其中id作為一個參數。

3. HTTP Header

HTTP Header用於此次請求的基礎信息，在介面文檔中以K-V方式展示，其中Content-Type則是一個非常必要的header，它描述的請求體的數據類型。

常用的content-type：

• application/x-www-form-urlencoded

請求參數使用「&」符號連接。

• application/json

內容為json格式

• application/xml

內容為xml格式

• multipart/form-data

內容為多個數據組成，有分隔符隔開

4. HTTP Body

描述http body，依賴於body中具體的數據類型。如果body中的數據是對象類型。則需要描述對象中欄位的名稱、類型、長度、不能為空、默認值、說明。以表格的方式來表達最好。

示例：



五、介面工具

推薦使用的是http://docway.net（以前叫小幺雞） 寫介面文檔，方便保存和共享，支持導出PDF MARKDOWN，支持團隊項目管理。

② java程序領取優惠卷,高並發下怎麼避免領取量超過預發量

基本思路是：鎖+冪等性

具體實現：

使用redis的decr （對key對應的數字做減1操作。如果key不存在，那麼在操作之前，這個key對應的值會被置為0。如果key有一個錯誤類型的value或者是一個不能表示成數字的字元串，就返回錯誤。這個操作最大支持在64位有符號的整型數字。）可以實現原子性的遞增遞減操作控制優惠碼不超送，然後給每個用戶維護一個userid+優惠碼活動的key保證冪等性，只要redis存在這種key，那就代表已經領取了，具體的優惠碼分發可以非同步執行。為了避免競爭（同一個用戶，多個設備同時領取），參考：網頁鏈接

③ 正則表達式原理

首先先講解下正則表達式的基礎知識：

1.字元串的組成

對於字元串」123「而言，包括三個字元四個位置。如下圖所示：

2.佔有字元和零寬度

正則表達式匹配過程中，如果子表達式匹配到東西，而並非是一個位置，並最終保存到匹配的結果當中。這樣的就稱為佔有字元，而只匹配一個位置，或者是匹配的內容並不保存到匹配結果中，這種就稱作零寬度，後續會講到的零寬度斷言等。佔有字元是互斥的，零寬度是非互斥的。也就是一個字元，同一時間只能由一個子表達式匹配，而一個位置，卻可以同時由多個零寬度的子表達式匹配。

3.控制權和傳動

正則表達式由左到右依次進行匹配，通常情況下是由一個表達式取得控制權，從字元串的的某個位置進行匹配，一個子表達式開始嘗試匹配的位置，是從前一子表達匹配成功的結束位置開始的（例如：（表達式一）（表達式二）意思就是表達式一匹配完成後才能匹配表達式二，而匹配表達式二的位置是從表達式一的位置匹配結束後的位置開始）。如果表達式一是零寬度，那表達式一匹配完成後，表達式二匹配的位置還是原來表達式以匹配的位置。也就是說它匹配開始和結束的位置是同一個。

舉一個簡單的例子進行說明：正則表達式：123

源數據：123

講解：首先正則表達式是從最左側開始進行匹配，也就是位置0處進行匹配，首先得到控制權的是正則表達式中的「1」，而不是源數據中的「1」，匹配源數據中的「1」，匹配成功，將源數據的「1」進行保存到匹配的結果當中，這就表明它佔有了一個字元，接下來就將控制權傳給正則表達式中的「2」，匹配的位置變成了位置1，匹配源數據中的「2」，匹配成功，將控制權又傳動給了正則表達式的「3」，這時候匹配的位置變成了位置2，這時候就會將源數據中的「3」進行匹配。又有正則表達式「3」進行傳動控制權，發現已經到了正則表達式的末尾，正則表達式結束。

④ 如何判斷請求的冪等性 java

x請求的報文頭不一樣，通過如下

Java代碼
String requestType = request.getHeader("X-Requested-With");

如果requestType能拿到值，並且值為XMLHttpRequest,表示客戶端的請求為非同步請求，那自然是ajax請求了，反之如果為null,則是普通的請求

⑤ JAVA中Get和Post請求的區別收集整理

一 原理區別

一般在瀏覽器中輸入網址訪問資源都是通過GET方式；在FORM提交中，可以通過Method指定提交方式為GET或者POST，默認為GET提交

Http定義了與伺服器交互的不同方法，最基本的方法有4種，分別是GET，POST，PUT，DELETE

URL全稱是資源描述符，我們可以這樣認為：一個URL地址，它用於描述一個網路上的資源，而HTTP中的GET，POST，PUT，DELETE就對應著對這個資源的查，改，增，刪4個操作。到這里，大家應該有個大概的了解了，GET一般用於獲取/查詢資源信息，而POST一般用於更新資源信息(個人認為這是GET和POST的本質區別，也是協議設計者的本意，其它區別都是具體表現形式的差異)。

根據HTTP規范，GET用於信息獲取，而且應該是安全的和冪等的。

1.所謂安全的意味著該操作用於獲取信息而非修改信息。換句話說，GET請求一般不應產生副作用。就是說，它僅僅是獲取資源信息，就像資料庫查詢一樣，不會修改，增加數據，不會影響資源的狀態。

* 注意：這里安全的含義僅僅是指是非修改信息。

2.冪等的意味著對同一URL的多個請求應該返回同樣的結果。這里我再解釋一下冪等這個概念：

冪等（idempotent、idempotence）是一個數學或計算機學概念，常見於抽象代數中。
冪等有以下幾種定義：
對於單目運算，如果一個運算對於在范圍內的所有的一個數多次進行該運算所得的結果和進行一次該運算所得的結果是一樣的，那麼我們就稱該運算是冪等的。 比如絕對值運算就是一個例子，在實數集中，有abs(a)=abs(abs(a))。
對於雙目運算，則要求當參與運算的兩個值是等值的情況下，如果滿足運算結果與參與運算的兩個值相等，則稱該運算冪等，如求兩個數的最大值的函數，有在實數集中冪等，即max(x,x)=x。

看完上述解釋後，應該可以理解GET冪等的含義了。

但在實際應用中，以上2條規定並沒有這么嚴格。引用別人文章的例子：比如，新聞站點的頭版不斷更新。雖然第二次請求會返回不同的一批新聞，該操作仍然被認為是安全的和冪等的，因為它總是返回當前的新聞。從根本上說，如果目標是當用戶打開一個鏈接時，他可以確信從自身的角度來看沒有改變資源即可。

根據HTTP規范，POST表示可能修改變伺服器上的資源的請求。繼續引用上面的例子：還是新聞以網站為例，讀者對新聞發表自己的評論應該通過POST實現，因為在評論提交後站點的資源已經不同了，或者說資源被修改了。

上面大概說了一下HTTP規范中，GET和POST的一些原理性的問題。但在實際的做的時候，很多人卻沒有按照HTTP規范去做，導致這個問題的原因有很多，比如說：

1.很多人貪方便，更新資源時用了GET，因為用POST必須要到FORM（表單），這樣會麻煩一點。

2.對資源的增，刪，改，查操作，其實都可以通過GET/POST完成，不需要用到PUT和DELETE。

3.另外一個是，早期的但是Web MVC框架設計者們並沒有有意識地將URL當作抽象的資源來看待和設計。還有一個較為嚴重的問題是傳統的Web MVC框架基本上都只支持GET和POST兩種HTTP方法，而不支持PUT和DELETE方法。

* 簡單解釋一下MVC：MVC本來是存在於Desktop程序中的，M是指數據模型，V是指用戶界面，C則是控制器。使用MVC的目的是將M和V的實現代碼分離，從而使同一個程序可以使用不同的表現形式。

以上3點典型地描述了老一套的風格（沒有嚴格遵守HTTP規范），隨著架構的發展，現在出現REST(Representational State Transfer)，一套支持HTTP規范的新風格，這里不多說了，可以參考《RESTful Web Services》。

二 表現形式區別

搞清了兩者的原理區別，我們再來看一下他們實際應用中的區別：

為了理解兩者在傳輸過程中的不同，我們先看一下HTTP協議的格式：

HTTP請求：
<requestline>//http請求行
<headers>//http請求消息報頭
<blankline>//回車換行
[<request-body>]//http請求正文

在HTTP請求中，第一行必須是一個請求行（request line），用來說明請求類型、要訪問的資源以及使用的HTTP版本。緊接著是一個首部（header）小節，用來說明伺服器要使用的附加信息。在首部之後是一個空行，再此之後可以添加任意的其他數據[稱之為主體（body）]。

GET與POST方法實例：

GET/books/?sex=man&name=ProfessionalHTTP/1.1
Host:www.wrox.com
User-Agent:Mozilla/5.0(Windows;U;WindowsNT5.1;en-US;rv:1.7.6)
Gecko/20050225Firefox/1.0.1
Connection:Keep-Alive

POST/HTTP/1.1
Host:www.wrox.com
User-Agent:Mozilla/5.0(Windows;U;WindowsNT5.1;en-US;rv:1.7.6)
Gecko/20050225Firefox/1.0.1
Content-Type:application/x-www-form-urlencoded
Content-Length:40
Connection:Keep-Alive
（----此處空一行----）
name=Professional%20Ajax&publisher=Wiley

有了以上對HTTP請求的了解和示例，我們再來看兩種提交方式的區別：

（1）GET提交，請求的數據會附在URL之後（就是把數據放置在HTTP協議頭中），以?分割URL和傳輸數據，多個參數用&連接；例 如：login.action?name=hyddd&password=idontknow&verify=%E4%BD%A0 %E5%A5%BD。如果數據是英文字母/數字，原樣發送，如果是空格，轉換為+，如果是中文/其他字元，則直接把字元串用BASE64加密，得出如： %E4%BD%A0%E5%A5%BD，其中％XX中的XX為該符號以16進製表示的ASCII。

POST提交：把提交的數據放置在是HTTP包的包體中。上文示例中紅色字體標明的就是實際的傳輸數據

因此，GET提交的數據會在地址欄中顯示出來，而POST提交，地址欄不會改變

(2)傳輸數據的大小：首先聲明：HTTP協議沒有對傳輸的數據大小進行限制，HTTP協議規范也沒有對URL長度進行限制。

而在實際開發中存在的限制主要有：

GET:特定瀏覽器和伺服器對URL長度有限制，例如 IE對URL長度的限制是2083位元組(2K+35)。對於其他瀏覽器，如Netscape、FireFox等，理論上沒有長度限制，其限製取決於操作系 統的支持。

因此對於GET提交時，傳輸數據就會受到URL長度的 限制。

POST:由於不是通過URL傳值，理論上數據不受 限。但實際各個WEB伺服器會規定對post提交數據大小進行限制，Apache、IIS6都有各自的配置。

(3)安全性：

POST的安全性要比GET的安全性高。注意：這里所說的安全性和上面GET提到的「安全」不是同個概念。上面 「安全」的含義僅僅是不作數據修 改，而這 里安全的含義是真正的Security的含義，比如：通過GET提交數據，用戶名和密碼將明文出現在URL上，因為(1)登錄頁面有可能被瀏覽器緩存， (2)其他人查看瀏覽器的歷史紀錄，那麼別人就可以拿到你的賬號和密碼了，除此之外，使用GET提交數據還可能會造成Cross-site request forgery攻擊

（4）Http get,post,soap協議都是在http上運行的
1）get：請求參數是作為一個key/value對的序列（查詢字元串）附加到URL上的
查詢字元串的長度受到web瀏覽器和web伺服器的限制（如IE最多支持2048個字元），不適合傳輸大型數據集同時，它很不安全
2）post：請求參數是在http標題的一個不同部分（名為entity body）傳輸的，這一部分用來傳輸表單信息，因此必須將Content-type設置為:application/x-www-form- urlencoded。post設計用來支持web窗體上的用戶欄位，其參數也是作為key/value對傳輸。
但是：它不支持復雜數據類型，因為post沒有定義傳輸數據結構的語義和規則。
3）soap：是http post的一個專用版本，遵循一種特殊的xml消息格式
Content-type設置為: text/xml 任何數據都可以xml化

三 HTTP響應
1．HTTP響應格式：

<statusline>//http響應狀態行
<headers>//http響應消息報頭
<blankline>//回車換行
[<response-body>]//http響應正文

在響應中唯一真正的區別在於第一行中用狀態信息代替了請求信息。狀態行（status line）通過提供一個狀態碼來說明所請求的資源情況。

HTTP響應實例：

HTTP/1.1200OKDate:Sat,31Dec200523:59:59GMTContent-Type:text/html;charset=ISO-8859-1Content-Length:122

＜html＞
＜head＞
＜title＞WroxHomepage＜/title＞
＜/head＞
＜body＞＜!--bodygoeshere--＞＜/body＞
＜/html＞

2．最常用的狀態碼有：

◆200(OK):找到了該資源，並且一切正常。
◆304(NOTMODIFIED):該資源在上次請求之後沒有任何修改。這通常用於瀏覽器的緩存機制。
◆401(UNAUTHORIZED):客戶端無權訪問該資源。這通常會使得瀏覽器要求用戶輸入用戶名和密碼，以登錄到伺服器。
◆403(FORBIDDEN):客戶端未能獲得授權。這通常是在401之後輸入了不正確的用戶名或密碼。
◆404(NOTFOUND):在指定的位置不存在所申請的資源.

四 完整示例

例子：

HTTPGET發送

GET/DEMOWebServices2.8/Service.asmx/CancelOrder?UserID=string&PWD=string&OrderConfirmation=stringHTTP/1.1
Host:api.efxnow.com

Response:

HTTP/1.1200OK
Content-Type:text/xml;charset=utf-8
Content-Length:length
<?xmlversion="1.0"encoding="utf-8"?>
<objPlaceOrderResponsexmlns="https://api.efxnow.com/webservices2.3">
<Success>boolean</Success>
<ErrorDescription>string</ErrorDescription>
<ErrorNumber>int</ErrorNumber>
<CustomerOrderReference>long</CustomerOrderReference>
<OrderConfirmation>string</OrderConfirmation>
<CustomerDealRef>string</CustomerDealRef>
</objPlaceOrderResponse>

Http Post 發送

POST/DEMOWebServices2.8/Service.asmx/CancelOrderHTTP/1.1
Host:api.efxnow.com
Content-Type:application/x-www-form-urlencoded
Content-Length:length
UserID=string&PWD=string&OrderConfirmation=string

Response:

HTTP/1.1200OK
Content-Type:text/xml;charset=utf-8
Content-Length:length
<?xmlversion="1.0"encoding="utf-8"?>
<objPlaceOrderResponsexmlns="https://api.efxnow.com/webservices2.3">
<Success>boolean</Success>
<ErrorDescription>string</ErrorDescription>
<ErrorNumber>int</ErrorNumber>
<CustomerOrderReference>long</CustomerOrderReference>
<OrderConfirmation>string</OrderConfirmation>
<CustomerDealRef>string</CustomerDealRef>
</objPlaceOrderResponse>

SOAP 1.2

發送

POST/DEMOWebServices2.8/Service.asmxHTTP/1.1
Host:api.efxnow.com
Content-Type:application/soap+xml;charset=utf-8
Content-Length:length
<?xmlversion="1.0"encoding="utf-8"?>
<soap12:Envelopexmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:xsd="http://www.w3.org/2001/XMLSchema"xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<CancelOrderxmlns="https://api.efxnow.com/webservices2.3">
<UserID>string</UserID>
<PWD>string</PWD>
<OrderConfirmation>string</OrderConfirmation>
</CancelOrder>
</soap12:Body>
</soap12:Envelope>

Response:

HTTP/1.1200OK
Content-Type:application/soap+xml;charset=utf-8
Content-Length:length
<?xmlversion="1.0"encoding="utf-8"?>
<soap12:Envelopexmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:xsd="http://www.w3.org/2001/XMLSchema"xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<CancelOrderResponsexmlns="https://api.efxnow.com/webservices2.3">
<CancelOrderResult>
<Success>boolean</Success>
<ErrorDescription>string</ErrorDescription>
<ErrorNumber>int</ErrorNumber>
<CustomerOrderReference>long</CustomerOrderReference>
<OrderConfirmation>string</OrderConfirmation>
<CustomerDealRef>string</CustomerDealRef>
</CancelOrderResult>
</CancelOrderResponse>
</soap12:Body>
</soap12:Envelope>

1. get是從伺服器上獲取數據，post是向伺服器傳送數據。 get 和 post只是一種傳遞數據的方式，get也可以把數據傳到伺服器，他們的本質都是發送請求和接收結果。只是組織格式和數據量上面有差別，http協議裡面有介紹

2. get是把參數數據隊列加到提交表單的ACTION屬性所指的URL中，值和表單內各個欄位一一對應，在URL中可以看到。post是通過HTTP post機制，將表單內各個欄位與其內容放置在HTML HEADER內一起傳送到ACTION屬性所指的URL地址。用戶看不到這個過程。
因為get設計成傳輸小數據，而且最好是不修改伺服器的數據，所以瀏覽器一般都在地址欄裡面可以看到，但post一般都用來傳遞大數據，或比較隱私的數據，所以在地址欄看不到，能不能看到不是協議規定，是瀏覽器規定的。
3. 對於get方式，伺服器端用Request.QueryString獲取變數的值，對於post方式，伺服器端用Request.Form獲取提交的數據。
沒明白，怎麼獲得變數和你的伺服器有關，和get或post無關，伺服器都對這些請求做了封裝
4. get傳送的數據量較小，不能大於2KB。post傳送的數據量較大，一般被默認為不受限制。但理論上，IIS4中最大量為80KB，IIS5中為100KB。
post基本沒有限制，我想大家都上傳過文件，都是用post方式的。只不過要修改form裡面的那個type參數
5. get安全性非常低，post安全性較高。
如果沒有加密，他們安全級別都是一樣的，隨便一個監聽器都可以把所有的數據監聽到，不信你自己下一個監聽網路資源的軟體，