GroovyのURL#getTextや#getBytesでヘッダなどを設定する方法

　Groovyでは、URLクラスを使って簡単にファイルをダウンロードできたり、Web APIのレスポンスをテキストファイルとして保存できたりします。

　このようにです。

new File(imageName) << new URL(imageUrl).getBytes()
new File(tempName) << new URL(url).getText()

　さて、これらのメソッドでヘッダなどの設定はできないのでしょうか？

　実はURL#getTextとURL#getBytesには次のMapを引数にとるオーバーロードがあります。

• URL#getBytes(java.util.Map)
• URL#getText(java.util.Map)

　それぞれのドキュメントによると、Mapの要素として次のものが有効なようです。

connectTimeout : the connection timeout
readTimeout : the read timeout
useCaches : set the use cache property for the URL connection
allowUserInteraction : set the user interaction flag for the URL connection
requestProperties : a map of properties to be passed to the URL connection

　この部分のコードを見てみます。

　requestPropertiesで渡したMapは、URL#getBytes(java.util.Map) or URL#getText(java.util.Map)の内部で生成しているURLConnectionのsetRequestPropertyの呼び出しに使われます。

　次のコードはUserAgentとAccept-Languageを設定して、URL#getText(java.util.Map)を呼び出すコードです。

new File(tempName) << new URL(url).getText(requestProperties: [
    "UserAgent": "YOUR USER AGENT",
    "Accept-Language", "jp"
])

• 参考 : Groovy Goodness: Use Connection Parameters to Get Text From URL