openGionopenGion
5.1.7.0

org.opengion.fukurou.util
クラス AbstractConnect

java.lang.Object
  上位を拡張 org.opengion.fukurou.util.AbstractConnect
すべての実装されたインタフェース:
ConnectIF
直系の既知のサブクラス:
FTPConnect, SFTPConnect, SMBConnect

public abstract class AbstractConnect
extends java.lang.Object
implements ConnectIF

AbstractConnect.java は、共通的に使用される ファイル伝送関連の基本機能を実装した、Abstractクラスです。 -host=サーバー -user=ユーザー -passwd=パスワード -remoteFile=接続先のファイル名 を必須設定します。 -localFile=ローカルのファイル名は、必須ではありませんが、-command=DEL の場合にのみ不要であり、 それ以外の command の場合は、必要です。 -command=[GET/PUT/DEL/GETDIR/PUTDIR/DELDIR] は、サーバーに対しての処理の方法を指定します。 GET:サーバーからローカルにファイル転送します。(初期値) PUT:ローカルファイルをサーバーに PUT(STORE、SAVE、UPLOAD、などと同意語)します。 DEL:サーバーの指定のファイルを削除します。この場合のみ、-localFile 属性の指定は不要です。 GETDIR,PUTDIR,DELDIR:指定のフォルダ以下のファイルを処理します。 -mkdirs=[true/false] は、受け側のファイル(GET時:LOCAL、PUT時:サーバー)に取り込むファイルのディレクトリが 存在しない場合に、作成するかどうかを指定します。(初期値:true) 通常、サーバーに、フォルダ階層を作成してPUTする場合、動的にフォルダ階層を作成したいケースで便利です。 逆に、フォルダは確定しており、指定フォルダ以外に PUT するのはバグっていると事が分かっている場合には false に設定して、存在しないフォルダにPUT しようとすると、エラーになるようにします。 引数文字列中に空白を含む場合は、ダブルコーテーション("") で括って下さい。 引数文字列の 『=』の前後には、空白は挟めません。必ず、-key=value の様に 繋げてください。

形式サンプル:
 XXXConnect -host=サーバー -user=ユーザー -passwd=パスワード -remoteFile=接続先のファイル名 [-localFile=ローカルのファイル名]
                   [-command=[GET/PUT/DEL/GETDIR/PUTDIR/DELDIR] ] [-display=[true/false] ] ・・・・

    -host=サーバー                    :接続先のサーバーのアドレスまたは、サーバー名
    -user=ユーザー                    :接続するユーザー名
    -passwd=パスワード                :接続するユーザーのパスワード
    -remoteFile=接続先のファイル名    :接続先のサーバー側のファイル名。PUT,GET 関係なくFTP側として指定します。
   [-localFile=ローカルのファイル名]  :ローカルのファイル名。PUT,GET 関係なくローカルファイルを指定します。
   [-port=ポート ]                    :接続するサーバーのポートを指定します。
   [-command=[GET/PUT/DEL] ]          :サーバー側での処理の方法を指定します。
             [GETDIR/PUTDIR/DELDIR]]          GET:FTP⇒LOCAL、PUT:LOCAL⇒FTP への転送です。(初期値:GET)
                                              DEL:FTPファイルを削除します。
                                              GETDIR,PUTDIR,DELDIR 指定のフォルダ以下のファイルを処理します。
   [-mkdirs=[true/false]  ]           :受け側ファイル(GET時:LOCAL、PUT時:サーバー)にディレクトリを作成するかどうか。(初期値:true)
                                              (false:ディレクトリが無ければ、エラーにします。)
   [-encode=エンコード名 ]            :日本語ファイル名などのエンコード名を指定します。(初期値:Windows-31J)
   [-timeout=タイムアウト[秒] ]       :Dataタイムアウト。(初期値:600 [秒])
   [-display=[false/true] ]           :trueは、検索状況を表示します。(初期値:false)
   [-debug=[false|true]   ]           :デバッグ情報を標準出力に表示する(true)かしない(false)か(初期値 false:表示しない)
変更履歴:
5.1.6.0 (2010/05/01) 新規追加
バージョン
5.0
作成者
Kazuhiko Hasegawa
導入されたバージョン:
JDK5.0,

フィールドの概要
static java.lang.String CR
           
static boolean FLAG_NG
           
static boolean FLAG_OK
           
protected  java.lang.String host
           
protected  boolean isDebug
           
protected  boolean isDisplay
           
protected  boolean isMkdirs
           
protected  java.lang.String passwd
           
protected  java.lang.String port
           
protected  int timeout
           
static int TIMEOUT
           
protected  java.lang.String user
           
 
コンストラクタの概要
AbstractConnect()
           
 
メソッドの概要
 void action(java.lang.String command, java.lang.String localFile, java.lang.String remoteFile)
          command , localFile , remoteFile を元に、FTP処理を行います。
protected abstract  void actionDEL(java.lang.String remoteFile)
          command="DEL" が指定されたときの処理を行います。
protected abstract  void actionDELdir(java.lang.String remoteDir)
          command="DELDIR" が指定されたときの処理を行います。
protected abstract  void actionGET(java.lang.String localFile, java.lang.String remoteFile)
          command="GET" が指定されたときの処理を行います。
protected abstract  void actionGETdir(java.lang.String localDir, java.lang.String remoteDir)
          command="GETDIR" が指定されたときの処理を行います。
protected abstract  void actionPUT(java.lang.String localFile, java.lang.String remoteFile)
          command="PUT" が指定されたときの処理を行います。
protected  void actionPUTdir(java.lang.String localDir, java.lang.String remoteDir)
          command="PUTDIR" が指定されたときの処理を行います。
protected  java.lang.String addFile(java.lang.String dir, java.lang.String file)
          ディレクトリとファイル名を合成します。
abstract  void connect()
          サーバーへの接続、ログインを行います。
abstract  void disconnect()
          サーバーとの接続をクローズします。
protected  void errAppend(java.lang.Object... msgs)
          処理中に発生したエラーメッセージをセットします。
protected  void errAppend(java.lang.Object msg)
          処理中に発生したエラーメッセージをセットします。
 java.lang.String getErrMsg()
          処理中に発生したエラーメッセージを取り出します。
protected  java.lang.String getPort()
          ポートを取得します。
protected  int getPort(int defPort)
          ポートを取得します。
protected  void makeLocalDir(java.lang.String localFile)
          ローカルファイルのディレクトリを作成します。
 void setDebug(boolean isDebug)
          デバッグ情報の表示可否 を設定します。
 void setDisplay(boolean isDisplay)
          実行状況の表示可否 を設定します。
 void setHostUserPass(java.lang.String host, java.lang.String user, java.lang.String passwd)
          サーバーの、ホスト、ユーザー、パスワードを設定します。
 void setMkdirs(boolean isMkdirs)
          それぞれの受け側ファイルにディレクトリを作成するかどうか。
 void setPort(java.lang.String port)
          接続に利用するポート番号を設定します。
 void setTimeout(int timeout)
          タイムアウトを秒で指定します。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

CR

public static final java.lang.String CR

FLAG_OK

public static final boolean FLAG_OK
関連項目:
定数フィールド値

FLAG_NG

public static final boolean FLAG_NG
関連項目:
定数フィールド値

TIMEOUT

public static final int TIMEOUT
関連項目:
定数フィールド値

host

protected java.lang.String host

user

protected java.lang.String user

passwd

protected java.lang.String passwd

port

protected java.lang.String port

isMkdirs

protected boolean isMkdirs

timeout

protected int timeout

isDisplay

protected boolean isDisplay

isDebug

protected boolean isDebug
コンストラクタの詳細

AbstractConnect

public AbstractConnect()
メソッドの詳細

connect

public abstract void connect()
サーバーへの接続、ログインを行います。

定義:
インタフェース ConnectIF 内の connect

action

public void action(java.lang.String command,
                   java.lang.String localFile,
                   java.lang.String remoteFile)
command , localFile , remoteFile を元に、FTP処理を行います。 このメソッドは、connect( String , String , String )メソッド、および、 paramInit() 実行後に、呼び出す必要があります。

定義:
インタフェース ConnectIF 内の action
パラメータ:
command - String GET:HOST⇒LOCAL 、PUT:LOCAL⇒HOST 、DEL:HOSTファイルを削除
localFile - String ローカルのファイル名
remoteFile - String HOST接続先のファイル名
例外:
java.lang.RuntimeException

disconnect

public abstract void disconnect()
サーバーとの接続をクローズします。 ログインされている場合は、ログアウトも行います。 コネクトされている場合は、ディスコネクトします。

定義:
インタフェース ConnectIF 内の disconnect

actionGET

protected abstract void actionGET(java.lang.String localFile,
                                  java.lang.String remoteFile)
                           throws java.lang.Exception
command="GET" が指定されたときの処理を行います。 接続先のサーバー側のファイル名をローカルにダウンロードします。

パラメータ:
localFile - String ローカルのファイル名
remoteFile - String 接続先のファイル名
例外:
java.io.IOException
java.lang.Exception

actionGETdir

protected abstract void actionGETdir(java.lang.String localDir,
                                     java.lang.String remoteDir)
                              throws java.lang.Exception
command="GETDIR" が指定されたときの処理を行います。 接続先のサーバー側のディレクトリ以下をローカルディレクトリに階層構造のままダウンロードします。

パラメータ:
localDir - String ローカルのディレクトリ名
remoteDir - String 接続先のディレクトリ名
例外:
java.io.IOException
java.lang.Exception

actionPUT

protected abstract void actionPUT(java.lang.String localFile,
                                  java.lang.String remoteFile)
                           throws java.lang.Exception
command="PUT" が指定されたときの処理を行います。 ローカルファイルを、接続先のサーバー側にアップロードします。

パラメータ:
localFile - String ローカルのファイル名
remoteFile - String 接続先のファイル名
例外:
java.io.IOException
java.lang.Exception

actionPUTdir

protected void actionPUTdir(java.lang.String localDir,
                            java.lang.String remoteDir)
                     throws java.lang.Exception
command="PUTDIR" が指定されたときの処理を行います。 ローカルファイルのディレクトリ以下を、接続先のサーバー側のディレクトリに階層構造のままアップロードします。

パラメータ:
localDir - String ローカルのディレクトリ名
remoteDir - String 接続先のディレクトリ名
例外:
java.io.IOException
java.lang.Exception

actionDEL

protected abstract void actionDEL(java.lang.String remoteFile)
                           throws java.lang.Exception
command="DEL" が指定されたときの処理を行います。 接続先のサーバー側のファイル名を削除します。

パラメータ:
remoteFile - String 接続先のファイル名
例外:
java.io.IOException
java.lang.Exception

actionDELdir

protected abstract void actionDELdir(java.lang.String remoteDir)
                              throws java.lang.Exception
command="DELDIR" が指定されたときの処理を行います。 接続先のサーバー側のディレクトリ名を削除します。

パラメータ:
remoteDir - String 接続先のディレクトリ名
例外:
java.io.IOException
java.lang.Exception

makeLocalDir

protected void makeLocalDir(java.lang.String localFile)
                     throws java.io.IOException
ローカルファイルのディレクトリを作成します。 引数のファイル名は、ファイル名です。作成するディレクトリは、そのファイルオブジェクトの getParentFile() で取得されるディレクトリまでを作成します。

パラメータ:
localFile - String ローカルのファイル名
例外:
java.io.IOException - , RuntimeException

addFile

protected java.lang.String addFile(java.lang.String dir,
                                   java.lang.String file)
ディレクトリとファイル名を合成します。 単純に、ディレクトリの最後と、ファイルの最初の、"/" をチェックし、 存在すれば、そのまま、結合し、存在しなければ、"/" を追加します。 両方に存在する場合は、片方をはずします。

パラメータ:
dir - String ディレクトリ名
file - String ファイル名
戻り値:
String 合成されたファイル名

setHostUserPass

public void setHostUserPass(java.lang.String host,
                            java.lang.String user,
                            java.lang.String passwd)
サーバーの、ホスト、ユーザー、パスワードを設定します。

定義:
インタフェース ConnectIF 内の setHostUserPass
パラメータ:
host - String サーバー
user - String ユーザー
passwd - String パスワード

setPort

public void setPort(java.lang.String port)
接続に利用するポート番号を設定します。

定義:
インタフェース ConnectIF 内の setPort
パラメータ:
port - String 接続に利用するポート番号

getPort

protected java.lang.String getPort()
ポートを取得します。 設定されている生のport属性(nullもありうる) を返します。

戻り値:
String ポート

getPort

protected int getPort(int defPort)
ポートを取得します。 設定されているport属性が、nullの場合は、defPortを返します。

パラメータ:
defPort - int port が null の場合の初期値
戻り値:
int ポート

setMkdirs

public void setMkdirs(boolean isMkdirs)
それぞれの受け側ファイルにディレクトリを作成するかどうか。(初期値:true:作成する) -mkdirs=[true/false] は、受け側のファイル(GET時:LOCAL、PUT時:サーバー)に取り込むファイルのディレクトリが 存在しない場合に、作成するかどうかを指定します。(初期値:true) 通常、サーバーに、フォルダ階層を作成してPUTする場合、動的にフォルダ階層を作成したいケースで便利です。 逆に、フォルダは確定しており、指定フォルダ以外に PUT するのはバグっていると事が分かっている場合には false に設定して、存在しないフォルダにPUT しようとすると、エラーになるようにします。

定義:
インタフェース ConnectIF 内の setMkdirs
パラメータ:
isMkdirs - boolean 受け側ファイルにディレクトリを作成するかどうか。true:作成する

setTimeout

public void setTimeout(int timeout)
タイムアウトを秒で指定します。(初期値:600 [秒]) オリジナルの FTPClient#setDataTimeout( int ) は、ミリ秒でセット しますが、ここのメソッドでは、秒でセットします。

定義:
インタフェース ConnectIF 内の setTimeout
パラメータ:
timeout - int タイムアウト[秒]

setDisplay

public void setDisplay(boolean isDisplay)
実行状況の表示可否 を設定します。(初期値 false:表示しない)

定義:
インタフェース ConnectIF 内の setDisplay
パラメータ:
isDisplay - boolean 実行状況の表示可否

setDebug

public void setDebug(boolean isDebug)
デバッグ情報の表示可否 を設定します。(初期値 false:表示しない)

定義:
インタフェース ConnectIF 内の setDebug
パラメータ:
isDebug - boolean デバッグ情報の表示可否

errAppend

protected void errAppend(java.lang.Object msg)
処理中に発生したエラーメッセージをセットします。

パラメータ:
msg - Object

errAppend

protected void errAppend(java.lang.Object... msgs)
処理中に発生したエラーメッセージをセットします。

パラメータ:
msgs - Object...

getErrMsg

public java.lang.String getErrMsg()
処理中に発生したエラーメッセージを取り出します。

定義:
インタフェース ConnectIF 内の getErrMsg
戻り値:
String エラーメッセージ

openGion 5.1.7.0

Webアプリケーションフレームワーク openGion
SourceForge.JPCopyright (c) 2009 The openGion Project.