javax.jnlp
インタフェース FileSaveService

public interface FileSaveService

FileSaveService サービスを使用すると、信頼できない実行環境で実行されているアプリケーションの場合でも、ユーザはローカルファイルシステムにファイルを保存することができます。JNLP クライアントは仲介の役目を果たしているため、可能な場合は、このサービスの固有の実装を行います。

このサービスは、ほとんどのブラウザが提供する「名前を付けて保存」機能とほぼ同じ機能を備えています。

バージョン:

1.0

関連項目:

FileOpenService, FileContents

メソッドの概要

FileContents	saveAsFileDialog(java.lang.String pathHint, java.lang.String[] extensions, FileContents contents) ユーザにファイルを保存するよう要求します。
FileContents	saveFileDialog(java.lang.String pathHint, java.lang.String[] extensions, java.io.InputStream stream, java.lang.String name) ユーザにファイルを保存するよう要求します。

メソッドの詳細

saveFileDialog

public FileContents saveFileDialog(java.lang.String pathHint,
                                   java.lang.String[] extensions,
                                   java.io.InputStream stream,
                                   java.lang.String name)
                            throws java.io.IOException

ユーザにファイルを保存するよう要求します。

パラメータ:

pathHint - アプリケーションから、使用されるデフォルトのディレクトリへのヒント。JNLP クライアントではこれが無視される場合がある

extensions - ファイルチューザで表示するデフォルトのエクステンションのリスト。たとえば、String[] { "txt", "java" }。JNLP クライアントではこれらが無視される場合がある。

stream - InputStream として保存するファイルの内容

name - 推奨ファイル名。JNLP クライアントではこの名前を無視する場合がある

戻り値:

保存が正常に行われた場合は保存されたファイルの FileContents オブジェクト、ユーザが要求を取り消した場合は null

例外:

IOException - 当該ユーザだけがファイルの保存を行っているのに要求が失敗した場合

saveAsFileDialog

public FileContents saveAsFileDialog(java.lang.String pathHint,
                                     java.lang.String[] extensions,
                                     FileContents contents)
                              throws java.io.IOException

ユーザにファイルを保存するよう要求します。

パラメータ:

pathHint - アプリケーションから、使用されるデフォルトのディレクトリへのヒント。JNLP クライアントではこれが無視される場合がある

extensions - ファイルチューザで表示するデフォルトのエクステンションのリスト。たとえば、String[] { "txt", "java" }。JNLP クライアントではこれらが無視される場合がある

filecontents - 推奨ファイル名で保存するファイルの内容。JNLP クライアントでは推奨ファイル名を無視する場合がある

戻り値:

保存が正常に行われた場合は保存されたファイルの FileContents オブジェクト、ユーザが要求を取り消した場合は null

例外:

IOException - 当該ユーザだけがファイルの保存を行なっているのに、要求が失敗したとき