public class HttpConnect
extends java.lang.Object
HttpConnect は、指定のURL にアクセスして、データを取得します。 URL へのアクセスにより、エンジンでは各種処理を実行させることが可能になります。 例えば、帳票デーモンの起動や、長時間かかる処理の実行などです。 なお、URLに引数が付く場合は、ダブルコーテーションで括って下さい。 URL の指定は、先頭に何もつけませ。指定の順番も関係ありません。 - 付き引数は、指定順番は、関係ありません。 先頭が # の引数は、コメントと判断します。Usage: java org.opengion.fukurou.util.HttpConnect [-post=キー:ファイル名] … url [user:passwd] args[A] : url URLを指定します。GETの場合、パラメータは ?KEY=VALです args[*] : [-param=key:value] POST/GET時のパラメータのキーと値を:で区切って指定します。(複数回指定可) args[*] : [-header=key:value] ヘッダーに設定するパラメータのキーと値を:で区切って指定します。(複数回指定可) args[*] : [-auth=user:pass] BASIC認証のエリアへのアクセス時のユーザーとパスワードを指定します args[*] : [-proxy=host:port] proxy を使用する場合のホストとポートを指定します。 args[*] : [-timeout=3] 接続タイムアウト時間を(秒)で指定します(初期値:無指定) args[*] : [-encode=UTF-8] エンコードを指定します。(初期値は UTF-8) args[*] : [-out=ファイル名] 結果をファイルに出力します。初期値は標準出力です args[*] : [-download=ファイル名] ファイル名を指定して、ダウンロードします args[*] : [-upload=ファイル名] ファイル名を指定して、multipart/form-dataでファイルアップロードします args[*] : [-errEx=true/false] trueの場合、レスポンスコードが、4XX,5XX の時に RuntimeException を投げます(初期値:false) args[*] : [#・・・・] コメント引数。(BATファイル上に残しておきたいが、使用したくない場合など) args[*] : [-debug=true/false] trueの場合、適度にデバッグ用のメッセージを出力します(初期値:false)※ URLConnect との違い。 -info/-data 等の区別の廃止。(実質、-info がなくなる。) setDownloadFile(String) 追加(-binaryの代用) setUploadFile(String) 追加 proxy 設定の変更
6.9.0.0 (2018/01/31) 新規作成 |
修飾子とタイプ | フィールドと説明 |
---|---|
static java.lang.String |
DEFAULT_AGENT
User-Agentの初期値 "openGion with Apache HttpClient"
|
static java.lang.String |
DEFAULT_CHARSET
エンコードの初期値 "UTF-8"
|
static java.lang.String |
DEFAULT_LANG
言語の初期値 "ja-JP"
|
static int |
MAX_GET_LENGTH
GETで指定するときのURLの長さ制限 2000 (IEの場合は、2,083文字)
|
コンストラクタと説明 |
---|
HttpConnect(java.lang.String url,
java.lang.String userPass)
接続先URLと、認証用ユーザー:パスワードを指定する、コンストラクター
認証が必要ない場合は、userPass は、null でかまいません。
|
修飾子とタイプ | メソッドと説明 |
---|---|
void |
addHeaderProperty(java.lang.String key,
java.lang.String val)
Header として、HttpClient にセットするデータを設定します。
|
void |
addRequestProperty(java.lang.String key,
java.lang.String val)
接続先に使用する引数(パラメータ)を追加します。
|
static java.lang.String |
code2Message(int code)
HttpURLConnection のレスポンスコードに対応するメッセージ文字列を返します。
|
int |
getCode()
実行結果のステータスコード 情報を取得します。
|
java.lang.String |
getMessage()
メッセージ 情報を取得します。
|
static void |
main(java.lang.String[] args)
サンプル実行用のメインメソッド
Usage: java org.opengion.fukurou.util.HttpConnect [-post=キー:ファイル名] … url [user:passwd]
args[A] : url URLを指定します。
|
java.lang.String |
readData()
URL接続先のデータを取得します。
|
void |
setCharset(java.lang.String chset)
エンコード情報を設定します。
|
void |
setDebug(boolean isDebug)
trueの場合、適度にデバッグ用のメッセージを出力します(初期値:false)。
|
void |
setDownloadFile(java.lang.String dwldFile)
URL接続先のバイナリファイルをダウンロード取得します。
|
void |
setProxy(java.lang.String host,
int port)
指定のURLに対して、コネクトするのに使用するプロキシ設定を行います。
|
void |
setTimeout(int tout)
接続タイムアウト時間を(秒)で指定します
実際には、org.apache.http.client.config.RequestConfig に対して、
.setConnectTimeout( timeout * 1000 )
.setSocketTimeout( timeout * 1000 )
のように、 1000倍して設定しています。
|
void |
setUploadFile(java.lang.String upldFile)
URL接続先のバイナリファイルをアップロードします。
|
public static final java.lang.String DEFAULT_CHARSET
public static final java.lang.String DEFAULT_LANG
public static final java.lang.String DEFAULT_AGENT
public static final int MAX_GET_LENGTH
public HttpConnect(java.lang.String url, java.lang.String userPass)
url
- 接続するアドレスを指定します。(http://server:port/dir/file.html)userPass
- ユーザー:パスワード(認証接続が必要な場合)6.9.0.0 (2018/01/31) 新規作成 |
public java.lang.String readData() throws java.io.IOException, java.net.MalformedURLException
java.io.IOException
- 入出力エラーが発生したときjava.net.MalformedURLException
- URLの形式が間違っている場合6.9.0.0 (2018/01/31) 新規作成 |
public void addRequestProperty(java.lang.String key, java.lang.String val)
key
- パラメータキー(nullの場合は、登録しません)val
- パラメータ値6.9.0.0 (2018/01/31) 新規作成 |
public void setProxy(java.lang.String host, int port)
host
- 接続するプロキシのホスト名(nullの場合は、登録しません)port
- 接続するプロキシのポート番号6.9.0.0 (2018/01/31) 新規作成 |
public void addHeaderProperty(java.lang.String key, java.lang.String val)
key
- パラメータキー(nullの場合は、登録しません)val
- パラメータ値(nullの場合は、登録しません)6.9.0.0 (2018/01/31) 新規作成 |
public void setDownloadFile(java.lang.String dwldFile) throws java.io.IOException
dwldFile
- ダウンロードするファイル名。java.io.IOException
- 入出力エラーが発生したとき6.9.0.0 (2018/01/31) 新規作成 |
public void setUploadFile(java.lang.String upldFile) throws java.io.IOException
upldFile
- アップロードするファイル名。java.io.IOException
- 入出力エラーが発生したとき6.9.0.0 (2018/01/31) 新規作成 |
public void setCharset(java.lang.String chset)
chset
- エンコード情報(nullの場合は、初期値:UTF-8 になります)6.9.0.0 (2018/01/31) 新規作成 |
public void setTimeout(int tout)
tout
- タイムアウト時間(秒) (ゼロは、無制限)6.9.0.0 (2018/01/31) 新規作成 |
public void setDebug(boolean isDebug)
isDebug
- true:デバッグ用のメッセージを出力/false:通常6.9.0.0 (2018/01/31) 新規作成 |
public int getCode()
readData()
6.9.0.0 (2018/01/31) 新規作成 |
public java.lang.String getMessage()
6.9.0.0 (2018/01/31) 新規作成 |
public static java.lang.String code2Message(int code)
code
- HTTPレスポンスコードHttpURLConnection.HTTP_ACCEPTED
6.9.0.0 (2018/01/31) 新規作成 |
public static void main(java.lang.String[] args) throws java.io.IOException
Usage: java org.opengion.fukurou.util.HttpConnect [-post=キー:ファイル名] … url [user:passwd] args[A] : url URLを指定します。GETの場合、パラメータは ?KEY=VALです args[*] : [-param=key:value] POST/GET時のパラメータのキーと値を:で区切って指定します。(複数回指定可) args[*] : [-header=key:value] ヘッダーに設定するパラメータのキーと値を:で区切って指定します。(複数回指定可) args[*] : [-auth=user:pass] BASIC認証のエリアへのアクセス時のユーザーとパスワードを指定します args[*] : [-proxy=host:port] proxy を使用する場合のホストとポートを指定します。 args[*] : [-timeout=3] 接続タイムアウト時間を(秒)で指定します(初期値:無指定) args[*] : [-encode=UTF-8] エンコードを指定します。(初期値は UTF-8) args[*] : [-out=ファイル名] 結果をファイルに出力します。初期値は標準出力です args[*] : [-download=ファイル名] ファイル名を指定して、ダウンロードします args[*] : [-upload=ファイル名] ファイル名を指定して、multipart/form-dataでファイルアップロードします args[*] : [-errEx=true/false] trueの場合、レスポンスコードが、4XX,5XX の時に RuntimeException を投げます(初期値:false) args[*] : [#・・・・] コメント引数。(BATファイル上に残しておきたいが、使用したくない場合など) args[*] : [-debug=true/false] trueの場合、適度にデバッグ用のメッセージを出力します(初期値:false)
args
- コマンド引数配列java.io.IOException
- 入出力エラーが発生したとき6.9.0.0 (2018/01/31) 新規作成 |
Webアプリケーションフレームワーク openGionCopyright (c) 2009 The openGion Project.