RFC4154 日本語訳
4154 Voucher Trading System Application Programming Interface(VTS-API). M. Terada, K. Fujimura. September 2005. (Format: TXT=61629 bytes) (Status: INFORMATIONAL)
プログラムでの自動翻訳です。
英語原文
Network Working Group M. Terada
Request for Comments: 4154 NTT DoCoMo
Category: Informational K. Fujimura
NTT
September 2005
Teradaがコメントのために要求するワーキンググループM.をネットワークでつないでください: 4154年のNTTドコモカテゴリ: 情報のK.藤村NTT2005年9月
Voucher Trading System Application Programming Interface (VTS-API)
バウチャーの取り引きシステム応用プログラミングインターフェース(VTS-アピ)
Status of This Memo
このメモの状態
This memo provides information for the Internet community. It does not specify an Internet standard of any kind. Distribution of this memo is unlimited.
このメモはインターネットコミュニティのための情報を提供します。 それはどんな種類のインターネット標準も指定しません。 このメモの分配は無制限です。
Copyright Notice
版権情報
Copyright (C) The Internet Society (2005).
Copyright(C)インターネット協会(2005)。
IESG Note
IESG注意
This document is not a candidate for any level of Internet Standard. This document specifies the Voucher Trading System Application Programming Interface (VTS-API), which assumes that the VTS plug-in is trusted by its user. The application making calls to VTS-API ought to authenticate the VTS plug-in and securely bind the plug-in with the VTS provider information specified in the Voucher Component. However, this document does not specify an approach to application authentication. The VTS-API should not be used without being augmented by an application authentication mechanism.
このドキュメントはインターネットStandardのどんなレベルの候補ではありません。 このドキュメントはVoucher Trading System Application Programming Interface(VTS-API)を指定します。(Voucher Trading System Application Programming Interfaceは、VTSプラグインがユーザによって信じられると仮定します)。 VTS-APIに電話をかけるアプリケーションは、VTSプラグインを認証して、VTSプロバイダー情報がVoucher Componentで指定されている状態で、しっかりとプラグインを縛るべきです。 しかしながら、このドキュメントはアプリケーション認証へのアプローチを指定しません。 アプリケーション認証機構によって増大されないで、VTS-APIを使用するべきではありません。
Abstract
要約
This document specifies the Voucher Trading System Application Programming Interface (VTS-API). The VTS-API allows a wallet or other application to issue, transfer, and redeem vouchers in a uniform manner independent of the VTS implementation. The VTS is a system for securely transferring vouchers; e.g., coupons, tickets, loyalty points, and gift certificates. This process is often necessary in the course of payment and/or delivery transactions.
このドキュメントはVoucher Trading System Application Programming Interface(VTS-API)を指定します。 VTS-APIで、財布か他のアプリケーションが、一定の方法でVTS実装の如何にかかわらずバウチャーを発行して、移して、身請けします。 VTSはしっかりとバウチャーを移すシステムです。 例えば、クーポン、チケット、ロイヤルティポイント、および商品券。 このプロセスが支払い、そして/または、配送トランザクションの間にしばしば必要です。
Terada & Fujimura Informational [Page 1] RFC 4154 VTS-API September 2005
[1ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
Table of Contents
目次
1. Introduction ................................................. 3
2. Processing Model ............................................. 4
3. Design Overview .............................................. 6
4. Concepts ..................................................... 6
5. Interface Definitions ........................................ 8
5.1. VTSManager .............................................. 8
5.1.1. getParticipantRepository ......................... 8
5.1.2. getVoucherComponentRepository .................... 8
5.2. ParticipantRepository ................................... 9
5.2.1. lookup ........................................... 9
5.3. Participant ............................................. 9
5.3.1. getIdentifier .................................... 10
5.3.2. getVTSAgent ...................................... 10
5.4. VTSAgent ................................................ 10
5.4.1. login ............................................ 11
5.4.2. logout ........................................... 12
5.4.3. prepare .......................................... 12
5.4.4. issue ............................................ 13
5.4.5. transfer ......................................... 14
5.4.6. consume .......................................... 15
5.4.7. present .......................................... 16
5.4.8. cancel ........................................... 17
5.4.9. resume ........................................... 18
5.4.10. create .......................................... 18
5.4.11. delete .......................................... 19
5.4.12. getContents ..................................... 19
5.4.13. getSessions ..................................... 19
5.4.14. getLog .......................................... 20
5.4.15. addReceptionListener ............................ 20
5.4.16. removeReceptionListener ......................... 21
5.5. Session ................................................. 21
5.5.1. getIdentifier .................................... 21
5.5.2. getVoucher ....................................... 22
5.5.3. getSender ........................................ 22
5.5.4. getReceiver ...................................... 22
5.5.5. isPrepared ....................................... 22
5.5.6. isActivated ...................................... 23
5.5.7. isSuspended ...................................... 23
5.5.8. isCompleted ...................................... 23
5.6. Voucher ................................................. 23
5.6.1. getIssuer ........................................ 23
5.6.2. getPromise ....................................... 24
5.6.3. getCount ......................................... 24
5.7. VoucherComponentRepository .............................. 24
5.7.1. register ......................................... 24
5.8. VoucherComponent ........................................ 25
1. 序論… 3 2. 処理モデル… 4 3. 概要を設計してください… 6 4. 概念… 6 5. 定義を連結してください… 8 5.1. VTSManager… 8 5.1.1getParticipantRepository… 8 5.1.2getVoucherComponentRepository… 8 5.2. ParticipantRepository… 9 5.2.1ルックアップ… 9 5.3. 関係者… 9 5.3.1getIdentifier… 10 5.3.2getVTSAgent… 10 5.4. VTSAgent… 10 5.4 .1 ログインしてください… 11 5.4 .2 ログアウトしてください… 12 5.4 .3 準備します。 12 5.4.4号… 13 5.4 .5 移してください… 14 5.4 .6 消費します。 15 5.4.7プレゼント… 16 5.4 .8 取り消してください… 17 5.4 .9 再開してください… 18 5.4 .10 作成します。 18 5.4 .11 削除します。 19 5.4.12getContents… 19 5.4.13getSessions… 19 5.4.14getLog… 20 5.4.15addReceptionListener… 20 5.4.16removeReceptionListener… 21 5.5. セッション… 21 5.5.1getIdentifier… 21 5.5.2getVoucher… 22 5.5.3getSender… 22 5.5.4getReceiver… 22 5.5 .5はisPreparedされました… 22 5.5 .6はisActivatedされました… 23 5.5 .7はisSuspendedされました… 23 5.5 .8はisCompletedされました… 23 5.6. バウチャー… 23 5.6.1getIssuer… 23 5.6 .2はgetPromiseされます… 24 5.6.3getCount… 24 5.7. VoucherComponentRepository… 24 5.7 .1 登録してください… 24 5.8. VoucherComponent… 25
Terada & Fujimura Informational [Page 2] RFC 4154 VTS-API September 2005
[2ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
5.8.1. getIdentifier .................................... 25
5.8.2. getDocument ...................................... 26
5.9. ReceptionListener ....................................... 26
5.9.1. arrive ........................................... 26
5.10. Exceptions ............................................. 27
6. Example Code ................................................. 28
7. Security Considerations ...................................... 29
8. Acknowledgements ............................................. 30
9. Normative References ......................................... 30
10. Informative References ....................................... 30
5.8.1. getIdentifier… 25 5.8.2getDocument… 26 5.9. ReceptionListener… 26 5.9 .1 到着してください… 26 5.10. 例外… 27 6. 例のコード… 28 7. セキュリティ問題… 29 8. 承認… 30 9. 標準の参照… 30 10. 有益な参照… 30
1. Introduction
1. 序論
This document specifies the Voucher Trading System Application Programming Interface (VTS-API). The motivation and background of the Voucher Trading System (VTS) are described in Requirements for Generic Voucher Trading [VTS].
このドキュメントはVoucher Trading System Application Programming Interface(VTS-API)を指定します。 Voucher Trading System(VTS)の動機とバックグラウンドはGeneric Voucher Trading[VTS]のためにRequirementsで説明されます。
A voucher is a logical entity that represents a certain right, and it is logically managed by the VTS. A voucher is generated by the issuer, traded among users, and finally collected using VTS. The terminology and model of the VTS are also described in [VTS].
バウチャーはある右を表す論理的な実体です、そして、それはVTSによって論理的に管理されます。 バウチャーは、VTSを使用することで発行人によって生成されて、ユーザの中で取り引きされて、最終的に集められます。 また、VTSの用語とモデルは[VTS]で説明されます。
VTSes can be implemented in different ways, such as a centralized VTS, which uses a centralized online server to store and manage all vouchers, or a distributed VTS, which uses per-user smartcards to maintain the vouchers owned by each user. However, the VTS-API allows a caller application to issue, transfer, and redeem vouchers in a uniform manner independent of the VTS implementation. Several attempts have been made to provide a generic payment API. Java Commerce Client [JCC] and Generic Payment Service Framework [GPSF], for example, introduce a modular wallet architecture that permits diverse types of payment modules to be added as plug-ins and supports both check-like/cash-like payment models. This document is inspired by these approaches but its scope is limited to the VTS model, in which the cash-like payment model is assumed and vouchers are directly or indirectly transferred between the sender (transferor) and receiver (transferee) via the VTS. This document is not intended to support API for SET, e-check, or other payment schemes that do not fit the VTS model.
異なった方法でVTSesを実装することができます、集結されたVTSや分配されたVTSなどのように。(VTSは、すべてのバウチャーを保存して、管理するのに集結されたオンラインサーバを使用します)。(VTSは、各ユーザによって所有されていたバウチャーを維持するのに1ユーザあたりのスマートカードを使用します)。 VTS-APIで、訪問者アプリケーションはしかしながら、移して、一定の方法でVTS実装の如何にかかわらずバウチャーを身請けするように発行できます。 ジェネリック支払いAPIを提供するのをいくつかの試みをしました。 例えば、Java Commerce Client[JCC]とGeneric Payment Service Framework[GPSF]はさまざまのタイプの支払いモジュールがプラグインとして加えられることを許可して、両方がチェックのようであるか現金のような支払いモデルであるとサポートするモジュールの財布アーキテクチャを紹介します。 このドキュメントはこれらのアプローチで奮い立たせられますが、範囲はVTSモデルに制限されます。そこでは、現金のような支払いモデルが思われて、バウチャーはVTSを通して直接か間接的に送付者(譲渡人)と受信機(譲受人)の間に移されます。 このドキュメントがSET(VTSモデルに合わない電子チェックであるか、または他の支払い体系)のためにAPIをサポートすることを意図しません。
Unlike the APIs provided in JCC and GPSF, which are designed to transfer only monetary values, this API enables the transfer of a wide range of values through the use of XML-based Generic Voucher Language [GVL]. The monetary meaning of the voucher is interpreted by the upper application layer using the information described in the language. This approach makes it possible to provide a simpler API in the voucher-transfer layer and enhances runtime efficiency. The
金銭価値だけを移すように設計されているJCCとGPSFに提供されたAPIと異なって、このAPIはXMLベースのGeneric Voucher Language[GVL]の使用によるさまざまな値の転送を可能にします。 バウチャーの通貨の意味は、上側の応用層によって言語で説明された情報を使用することで解釈されます。 このアプローチは、バウチャー転送層により簡単なAPIを供給するのを可能にして、ランタイム効率を高めます。 The
Terada & Fujimura Informational [Page 3] RFC 4154 VTS-API September 2005
[3ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
API specification in this document is described in the Java language syntax. Bindings for other programming languages may be completed in a future version of this document or in separate related specifications.
API仕様はジャバ言語構文で本書では説明されます。 他のプログラミング言語のための結合はこのドキュメントの将来のバージョンか別々の関連する仕様で終了するかもしれません。
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [RFC2119]
キーワード“MUST"、「必須NOT」が「必要です」、“SHALL"、「」、“SHOULD"、「「推薦され」て、「5月」の、そして、「任意」のNOTは中で説明されるように本書では解釈されることであるべきです。[RFC2119]
2. Processing Model
2. 処理モデル
This section provides the processing model in which the VTS-API is used. A part of the text in this section has been taken from the Generic Voucher Language specification [GVL].
このセクションはVTS-APIが使用されている処理モデルを提供します。 このセクションのテキストの一部がGeneric Voucher Language仕様[GVL]から抜粋されました。
There are several ways to implement VTS. For discount coupons or event tickets, for example, a smartcard-based distributed offline VTS is often preferred, whereas for bonds or securities, a centralized online VTS is preferred. While distributed VTSes would utilize public (asymmetric) key-based or shared (symmetric) key-based cryptographic challenge-and-response protocols to trade vouchers securely, centralized VTSes would utilize transactions that rewrite ownerships of vouchers on their database. Therefore, it is impractical to define standard protocols for issuing, transferring, or redeeming vouchers at this time.
VTSを実装するいくつかの方法があります。 割引券かイベントチケットに関しては、集結されたオンラインVTSは債券か証券で好まれますが、例えば、スマートカードベースの分配されたオフラインVTSはしばしば好まれます。 分配されたVTSesがしっかりとバウチャーを取り引きするのに公共(非対称の)のキーベースの、または、共有された(左右対称の)キーベースの暗号の挑戦と応答プロトコルを利用しているだろうという間、集結されたVTSesは彼らのデータベースでバウチャーの所有権を書き直すトランザクションを利用するでしょう。 したがって、このときバウチャーを発行するか、移すか、または身請けするために標準プロトコルを定義するのは非実用的です。
To provide implementation flexibility, this document assumes a modular wallet architecture that allows multiple VTSes to be added as plug-ins. In this architecture, instead of specifying a standard voucher transfer protocol, two specifications, Voucher Component and VTS-API, are standardized (Figure 1).
実装の柔軟性を提供するために、このドキュメントは複数のVTSesがプラグインとして加えるモジュールの財布アーキテクチャを仮定します。 このアーキテクチャでは、標準のバウチャー転送プロトコルを指定することの代わりに、2つの仕様(Voucher ComponentとVTS-API)が、標準化されます(図1)。
Terada & Fujimura Informational [Page 4] RFC 4154 VTS-API September 2005
[4ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
Sender wallet/Issuing system Receiver wallet/Collecting system +---------------------------+ +---------------------------+ | | | | | | Voucher Component | | | | (Specifies VTS Provider and Promise) | | | |-------------------------------------------------------->| | | | | | | | | | Intention to receive and payment (option) | | | |<- - - - - - - - - - - - - - - - - - - - - - - - - - - - | | | | | | | | | | | | | | | | Issue/transfer/ VTS | | VTS Register | | | | redeem request plug-in | plug-in Listener(*1)| | | |------------------>| | | |<------------------| | | | (VTS API) |<- - - - - - - ->| (VTS API) | | | | | VTS-specific | | | | | | protocol if VTS | | | | | | is distributed | | | | | Result |<- - - - - - - ->| Notify(*2) | | | |<------------------| | | |------------------>| | +---------------------------+ +---------------------------+
送付者財布/発行システムReceiver財布/収集システム+---------------------------+ +---------------------------+ | | | | | | バウチャーコンポーネント| | | | (VTSプロバイダーと約束を指定します) | | | |-------------------------------------------------------->| | | | | | | | | | 受信するという意志と支払い(オプション)| | | | <、- - - - - - - - - - - - - - - - - - - - - - - - - - - - | | | | | | | | | | | | | | | | 問題/転送/VTS| | VTSは登録します。| | | | 要求プラグインを救ってください。| プラグインListener(*1)| | | |、-、-、-、-、-、-、-、-、-、-、-、-、-、-、-、-、--、>|、|、| | <、-、-、-、-、-、-、-、-、-、-、-、-、-、-、-、-、--、|、|、|、| (VTSアピ) | <、- - - - - - - ->| (VTSアピ) | | | | | VTS特有です。| | | | | | VTSであるなら、議定書を作ってください。| | | | | | 分配にされる| | | | | 結果| <、- - - - - - - ->| (*2)に通知してください。| | | | <、-、-、-、-、-、-、-、-、-、-、-、-、-、-、-、-、--、|、|、| |、-、-、-、-、-、-、-、-、-、-、-、-、-、-、-、-、--、>|、| +---------------------------+ +---------------------------+
(*1) Registration is optional. Note also that the VTS plug-ins are
usually pre-registered when the wallet or collecting system
is started.
(*1) 登録は任意です。 また、財布か収集システムが始動されるとき、通常、VTSプラグインがあらかじめ登録されることに注意してください。
(*2) If a listener is registered.
(*2)はリスナーであるなら登録されています。
Figure 1. Wallet architecture with VTS plug-ins
図1。 VTSプラグインがある財布アーキテクチャ
In this architecture, a VTS provides a logical view of vouchers called a Valid Voucher Set (VVS), which is a set that includes the vouchers <I,P,H> managed by the VTS [VTS]. A user's wallet can access (e.g., view, transfer, and redeem) the subset of the VVS that includes a set of vouchers owned by the user by interacting with the VTS plug-in via the VTS-API. Likewise, an issuing system can issue a voucher and add it to the VVS, and a collecting system can be notified of the redemption of vouchers via the VTS-API.
このアーキテクチャに、VTSはバウチャー<Iを含んでいるセットであるValid Voucher Set(VVS)と呼ばれるバウチャーの論理的な意見を提供します、P、VTS[VTS]によって管理されたH>。 ユーザの財布がアクセスできる、(例えば、見て、移して、償却、)、VTS-APIを通してVTSプラグインと対話することによってユーザによって所有されていた1セットのバウチャーを含んでいるVVSの部分集合。 同様に、発行システムは、伝票を切って、VVSにそれを加えることができます、そして、VTS-APIを通してバウチャーの償却について収集システムに通知できます。
After a sender and a receiver agree on what vouchers are to be traded and which VTS is to be used, the issuing system or wallet system requests the corresponding VTS plug-in to permit the issue, transfer, or redemption transactions to be performed via the VTS-API. The VTS then logically rewrites the ownership of the vouchers on the VVS using the VTS-specific protocol. Since the VTS is responsible for preventing illegal acts on vouchers like forgery or reproduction, as required in [VTS], the protocol would include a cryptographic challenge-and-response (in a distributed VTS) or a transactional
送付者と受信機が使用されるためにバウチャーが何に関して取り引きされることになっているか、そして、VTSがどれであるかに同意した後に、発行システムか財布システムが、問題、転送、または償却トランザクションがVTS-APIを通して実行されることを許可するよう対応するVTSプラグインに要求します。 そして、VTSは、VVSでVTS特有のプロトコルを使用することでバウチャーの所有権を論理的に書き直します。 VTSは偽造や再現のようなバウチャーの上で不法な行為を防ぐのに責任があるので、必要に応じて、[VTS]ではプロトコルが暗号の挑戦と応答(分配されたVTSの)を含んでいるだろう、a取引
Terada & Fujimura Informational [Page 5] RFC 4154 VTS-API September 2005
[5ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
database manipulation with adequate access controls (in a centralized VTS). Finally, a completion event is sent to the wallet systems or issuing/collecting systems.
適切なアクセスによるデータベース操作は制御されます(集結されたVTSで)。 最終的に、完成イベントは、システムを財布システムに送るか、支給するか、または集めることです。
This document describes the VTS-API specification. See [GVL] for the Voucher Component specification that gives the syntax and semantics for describing and interpreting the meaning of vouchers.
このドキュメントはVTS-API仕様を説明します。 バウチャーの意味を説明して、解釈するために構文と意味論を与えるVoucher Component仕様に関して[GVL]を見てください。
3. Design Overview
3. デザイン概要
We have adopted the following approach to specify the VTS-API.
私たちは、VTS-APIを指定するために以下のアプローチを取りました。
1) Provide an abstract and uniform API that encapsulates the VTS
implementation. For example, a common API is provided for both
centralized and distributed VTSes. Issuers and application
developers have more freedom in VTS selection.
1) VTS実装をカプセル化する抽象的で一定のAPIを提供してください。 例えば、集結されて分配の両方にされたVTSesに一般的なAPIを提供します。 発行人とアプリケーション開発者には、VTS選択における、より多くの自由があります。
2) To provide an abstract and uniform API, this document
introduces an interface called VTSAgent that is associated with
a holder and provides methods to manipulate vouchers held by
its holder. Vouchers are accessed through the methods provided
by the VTSAgent.
2) このドキュメントは、抽象的で一定のAPIを提供するために、所有者に関連しているVTSAgentと呼ばれるインタフェースを導入して、所有者によって保持されたバウチャーを操るメソッドを提供します。 VTSAgentによって提供されたメソッドでバウチャーはアクセスされます。
3) Use existing standards for the VTS branding mechanism
(negotiation). This document assumes that the VTS to be used
for sending a voucher has settled the VTS-APIs are called.
Negotiation can be done within the upper application layer
using other standards (e.g., [IOTP] or [ECML]), if necessary.
3) メカニズム(交渉)に商標を付けるVTSの既存の規格を使用してください。 このドキュメントは、バウチャーを送るのに使用されるべきVTSが、VTS-APIが呼ばれるのに決着をつけたと仮定します。 上側の応用層の中で必要なら、他の規格(例えば、[IOTP]か[ECML])を使用することで交渉できます。
4) Support only the push-type voucher transfer interface, in which
the voucher transfer session is initiated by the transferor
side. A pull-type voucher transfer interface can be
implemented on top of the push-type VTS interface at the
application level.
4) プッシュ・タイプバウチャー転送インタフェースだけをサポートしてください。そこでは、バウチャー転送セッションが譲渡人側によって開始されます。 アプリケーションレベルにおけるプッシュ・タイプVTSインタフェースの上で牽引力タイプバウチャー転送インタフェースを実装することができます。
4. Concepts
4. 概念
The VTS-API consists of the following interfaces. A VTS is required to implement all of the interfaces except ReceptionListener, which is intended to be implemented by wallets or other applications that use VTS.
VTS-APIは以下のインタフェースから成ります。 VTSが、ReceptionListener以外のインタフェースのすべてを実装するのに必要です。ReceptionListenerはVTSを使用する財布か他のアプリケーションで実装されるつもりです。
VTSManager
Provides the starting point for using a VTS plug-in. All of
the objects needed to manipulate vouchers can be directly or
indirectly acquired via the VTSManager. A VTSManager maintains
the two repositories: a ParticipantRepository and a
VoucherComponentRepository, both of which are described below.
VTSManager Provides、VTSプラグインを使用するための出発点。 VTSManagerを通して直接か間接的にバウチャーを操るのが必要であるオブジェクトのすべてを取得できます。 VTSManagerは2つの倉庫を維持します: ParticipantRepositoryとVoucherComponentRepository。それの両方が以下で説明されます。
Terada & Fujimura Informational [Page 6] RFC 4154 VTS-API September 2005
[6ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
ParticipantRepository
Provides the access points of participants that are to be
trading partners. A ParticipantRepository maintains
Participants and acts as an "address book" of trading partners.
ParticipantRepository Provides、貿易相手国であることになっている関係者のアクセスポイント。 ParticipantRepositoryは貿易相手国の「アドレス帳」としてParticipantsを維持して、機能します。
Participant
Represents a participant (such as an issuer, a holder, or a
collector). A Participant interface knows how to obtain the
corresponding VTSAgent described below.
関与しているRepresents a関係者(発行人、所有者、またはコレクタなどの)。 Participantインタフェースは以下で説明された対応するVTSAgentを入手する方法を知っています。
VTSAgent (extends Participant)
Provides the access point of vouchers in the Valid Voucher Set
(VVS) that is logically managed by the VTS. A VTSAgent
provides a means of manipulating vouchers held by its holder
according to basic trading methods; i.e., issue, transfer,
consume, and present. Before calling trading methods, the
application must create a Session, which is described below.
VTSAgent(Participantを広げている)はVTSによって論理的に管理されるValid Voucher Set(VVS)にバウチャーのアクセスポイントを供給します。 VTSAgentは基本的な貿易方法によると、所有者によって保持されたバウチャーを操る手段を提供します。 すなわち、問題、転送は、消費して、提示します。 貿易方法と呼ぶ前に、アプリケーションはSessionを作成しなければなりません。(Sessionは以下で説明されます)。
Session
Represents the logical connection established by the trade. A
Session has references to two Participant interfaces; i.e.,
those of the sender and the receiver. After trading methods
are called using a Session, the Session holds a reference to
the Vouchers to be traded.
論理的な接続が取り引きで設立したセッションRepresents。 Sessionには、2つのParticipantインタフェースの参照があります。 すなわち. 後貿易方法が呼ばれるSessionを使用する送付者と受信機のものであり、Sessionは、取り引きするためにVouchersの参照を保持します。
Voucher
Represents one or more vouchers in which all of the issuer and
promise parts of the vouchers are the same. A Voucher holds
references to the Participant interface who issued the voucher
(issuer) and to a VoucherComponent (promise), which is
described below.
バウチャーの発行人と約束部分のすべてが同じであるバウチャーRepresents1か、より多くのバウチャー。 Voucherはバウチャー(発行人)を発行したParticipantインタフェースとVoucherComponent(約束)の参照を保持します。(VoucherComponentは以下で説明されます)。
VoucherComponent
Represents a Voucher Component, described in [GVL]. It defines
the promise part of the voucher.
Voucher Componentであって、[GVL]で説明されたVoucherComponent Represents。 それはバウチャーの約束部分を定義します。
VoucherComponentRepository
Provides the access points of VoucherComponents. A
VoucherComponentRepository maintains VoucherComponents and acts
as a "voucher type book" managed by the VTS. This document
assumes that a set of VoucherComponents has been acquired and
stored in this repository. Delivery of VoucherComponents is
beyond the scope of this document. It may be delivered within
the VTS from the trading partners or manually acquired from a
trusted third party (see Section 3 of [GVL]).
VoucherComponentRepository Provides、VoucherComponentsのアクセスポイント。 「バウチャータイプの本」がVTSによって管理されたので、VoucherComponentRepositoryはVoucherComponentsを維持して、行動します。 このドキュメントは、VoucherComponentsの1セットがこの倉庫に入手されて、保存されたと仮定します。 VoucherComponentsの配送はこのドキュメントの範囲を超えています。 それをVTSの中で貿易相手国から提供するか、または信頼できる第三者機関から手動で取得するかもしれません([GVL]のセクション3を見てください)。
Terada & Fujimura Informational [Page 7] RFC 4154 VTS-API September 2005
[7ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
ReceptionListener
Provides a listener function with regard to the receipt of a
voucher by a VTSAgent to wallets or other applications that
implement this interface. (This interface may not be
implemented as part of the VTS.)
このインタフェースを実装する財布か他のアプリケーションへのVTSAgentによるバウチャーの領収書に関するReceptionListener Provides aリスナー機能。 (このインタフェースはVTSの一部として実装されないかもしれません。)
5. Interface Definitions
5. インターフェース定義
The interfaces defined in this document reside in the package named "org.ietf.vts". Wallets or other applications that use this API, should import this package as "import org.ietf.vts.*;".
本書では定義されたインタフェースは"org.ietf.vts"というパッケージの中に住んでいます。 このAPIを使用して、「輸入org.ietf.vts*」としてこのパッケージを意味するべきである財布か他のアプリケーション。
5.1. VTSManager
5.1. VTSManager
public interface VTSManager
公共のインタフェースVTSManager
Provides the starting point for using a VTS plug-in.
VTSプラグインを使用するための出発点を提供します。
All of the objects needed to manipulate vouchers can be directly
or indirectly acquired via a VTSManager so that wallets or other
applications can make the VTS available by instantiating an object
implementing this interface.
VTSが財布か他のアプリケーションでオブジェクトを例示することによって利用可能になる場合があるように、このインタフェースを実装しながら、VTSManagerを通して直接か間接的にバウチャーを操るのが必要であるオブジェクトのすべてを取得できます。
A class that implements the VTSManager interface must have a
public default constructor (a constructor without any parameters).
The VTS provides a name for such a constructor so that the
implementation class can bootstrap the interface.
VTSManagerインタフェースを実装するクラスには、公共のデフォルト建設者(少しもパラメタのない建設者)がいなければなりません。 VTSは、実装のクラスがインタフェースを独力で進むことができるように、そのような建設者に名前を提供します。
5.1.1. getParticipantRepository
5.1.1. getParticipantRepository
public ParticipantRepository getParticipantRepository()
公共のParticipantRepository getParticipantRepository()
Returns a repository that maintains Participants.
Participantsを維持する倉庫を返します。
Returns:
リターン:
the ParticipantRepository of the VTS, or null if no
ParticipantRepository is available.
VTSのParticipantRepository、ヌルはParticipantRepositoryでないなら利用可能です。
5.1.2. getVoucherComponentRepository
5.1.2. getVoucherComponentRepository
public VoucherComponentRepository getVoucherComponentRepository()
公共のVoucherComponentRepository getVoucherComponentRepository()
Returns a repository that maintains VoucherComponents.
VoucherComponentsを維持する倉庫を返します。
Terada & Fujimura Informational [Page 8] RFC 4154 VTS-API September 2005
[8ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
Returns:
リターン:
the VoucherComponentRepository of the VTS, or null if no
VoucherComponentRepository is available.
VTSのVoucherComponentRepository、ヌルはVoucherComponentRepositoryでないなら利用可能です。
5.2. ParticipantRepository
5.2. ParticipantRepository
public interface ParticipantRepository
公共のインタフェースParticipantRepository
Provides the access points of Participants. A
ParticipantRepository maintains Participants and acts as an
"address book" of trading partners.
Participantsのアクセスポイントを提供します。 ParticipantRepositoryは貿易相手国の「アドレス帳」としてParticipantsを維持して、機能します。
The object implementing this interface maintains Participants (or
holds a reference to an object maintaining Participants), which
are to be trading partners.
このインタフェースを実装するオブジェクトは貿易相手国であることであるParticipants(または、Participantsを維持するオブジェクトの参照を保持する)を維持します。
The implementation of a ParticipantRepository may be either (an
adaptor to) "yellow pages", which is a network-wide directory
service like LDAP, or "pocket address book", which maintains only
personal acquaintances.
(それは、LDAPのようにネットワーク全体のディレクトリサービスです)。ParticipantRepositoryの実装がどちらかであるかもしれない、(アダプター、)、「職業別広告欄」、または「ポケットアドレス帳。」(それは、知合筋だけを維持します)。
5.2.1. lookup
5.2.1. ルックアップ
public Participant lookup(String id)
公共のParticipantルックアップ(ストリングイド)
Retrieves the participant that has the specified id.
指定されたイドを持っている関係者を救済します。
Returns:
リターン:
the participant associated with the specified id, or null if the
id is null or the corresponding participant cannot be found.
関係者は指定されたイドと交際できませんでしたか、イドがヌルか対応する関係者であるならヌルを見つけることができません。
5.3. Participant
5.3. 関係者
public interface Participant
公共のインタフェースParticipant
Represents the participants (such as issuers, holders, and
collectors).
関係者(発行人や、所有者や、コレクタなどの)の代理をします。
This interface is used as a representation of the trade partners
and issuers of vouchers. Anyone can retrieve objects that
implement Participants from the participant repository.
このインタフェースは貿易相手の表現とバウチャーの発行人として使用されます。 だれでも関与している倉庫からParticipantsを実装するオブジェクトを検索できます。
Terada & Fujimura Informational [Page 9] RFC 4154 VTS-API September 2005
[9ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
5.3.1. getIdentifier
5.3.1. getIdentifier
public String getIdentifier()
公共のString getIdentifier()
Returns the identifier of the participant. Each participant must
have a unique identifier.
関係者の識別子を返します。 各関係者には、ユニークな識別子がなければなりません。
The identifier can be used for looking up and retrieving the
participant via the ParticipantRepository.
ParticipantRepositoryを通して関係者を訪ねて、救済するのに識別子を使用できます。
The format of the identifier is implementation-specific.
識別子の形式は実装特有です。
Returns:
リターン:
the identifier string of the participant.
関係者の識別子ストリング。
5.3.2. getVTSAgent
5.3.2. getVTSAgent
VTSAgent getVTSAgent()
VTSAgent getVTSAgent()
Returns a VTSAgent, whose identifier is the same as the identifier
of the participant.
識別子が関係者の識別子と同じであるVTSAgentを返します。
Returns:
リターン:
an object that implements the VTSAgent.
VTSAgentを実装するオブジェクト。
5.4. VTSAgent
5.4. VTSAgent
public interface VTSAgent extends Participant
公共のインタフェースVTSAgentはParticipantを広げています。
Represents contact points to access vouchers in a Valid Voucher
Set (VVS) that is managed by the VTS.
VTSによって管理されるValid Voucher Set(VVS)でバウチャーにアクセスするために接点を表します。
Each VTSAgent is associated with a holder and provides a means for
managing vouchers owned by the holder. The holder must be
authenticated using the login() method before being called by any
other method, otherwise, a VTSSecurityException will be issued.
各VTSAgentは所有者に関連していて、所有者によって所有されていたバウチャーを管理するのに手段を提供します。 いかなる他のメソッドでも呼ばれる前にログイン()メソッドを使用することで所有者を認証しなければなりません。さもなければ、VTSSecurityExceptionは発行されるでしょう。
Before any trading method is called, e.g., issue(), transfer(),
consume(), and present(), the application must establish a session
by the prepare() method.
例えば、どんな貿易方法も呼ばれる前に()を発行してください、そして、()を移してください、そして、()を消費してください、そして、()を提示してください、とアプリケーションがセッションを証明しなければならない、() メソッドを用意してください。
Due to network failure, sessions may often be suspended when the
voucher is sent via a network. The suspended sessions can be
restarted by the resume() method. Details on the state management
of a session are described in Section 5.5.
ネットワーク失敗のため、ネットワークを通してバウチャーを送るとき、セッションをしばしば中断させるかもしれません。 履歴書()メソッドで吊したセッションを再開できます。 セッションの国家管理に関する詳細はセクション5.5で説明されます。
Terada & Fujimura Informational [Page 10] RFC 4154 VTS-API September 2005
[10ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
Some VTSAgents may not have all of the trading methods; a voucher
collecting system doesn't require its VTSAgent to provide a method
for issuing or creating vouchers. A VTSAgent returns a
FeatureNotAvailableException when an unsupported method is
invoked.
いくつかのVTSAgentsには、貿易方法のすべてがないかもしれません。 バウチャー収集システムは、VTSAgentがバウチャーを発行するか、または創造するためのメソッドを提供するのを必要としません。 サポートされないメソッドが呼び出されるとき、VTSAgentはFeatureNotAvailableExceptionを返します。
5.4.1. login
5.4.1. ログイン
public void login(String passphrase)
throws VTSException
公共の空のログイン(ストリングパスフレーズ)はVTSExceptionを投げます。
Authenticates the VTSAgent. The passphrase is specified if the
VTS requires it for authentication, otherwise it must be null.
Nothing is performed if the VTSAgent has already been logged-in.
The authentication scheme is implementation-specific. Examples of
the implementation are as follows:
VTSAgentを認証します。 VTSが認証のためにそれを必要とするなら、パスフレーズは指定されます。さもなければ、それはヌルであるに違いありません。 VTSAgentが既にログインされたなら、何も実行されません。 認証体系は実装特有です。 実装の例は以下の通りです:
1) Vouchers are managed on a remote centralized server
(centralized VTS), which requires a password to login. In this
case, the application may prompt the user to input the password
and the password can be given to the VTSAgent through this
method. For further information, see the Implementation Notes
below.
1) バウチャーはリモート集結されたサーバ(VTSを集結する)で管理されます。(それは、ログインするためにパスワードを必要とします)。 この場合、アプリケーションは、ユーザがパスワードを入力するようにうながすかもしれません、そして、このメソッドでパスワードをVTSAgentに与えることができます。 詳しくは以下のImplementation Notesを見てください。
2) Vouchers are managed on a remote centralized server
(centralized VTS), which requires challenge-and-response
authentication using smartcards held by users. In this case,
the passphrase may be null because access to the smartcard can
be done without contacting the application or user (i.e., the
VTSAgent receives the challenge from the server, sends the
challenge to the smartcard (within the VTS), and returns the
response from the smartcard to the server). Note that a PIN to
unlock the smartcard may be given through this method,
depending on the implementation.
2) バウチャーはリモート集結されたサーバ(VTSを集結する)で管理されます。(それは、ユーザによって持たれていたスマートカードを使用することで挑戦と応答認証を必要とします)。 この場合、パスフレーズは、アプリケーションかユーザに連絡しないでスマートカードにアクセスできるので(すなわち、VTSAgentはサーバから挑戦を受けて、スマートカード(VTSの中の)に挑戦を送って、スマートカードからサーバまでの応答を返します)、ヌルであるかもしれません。 実現によって、スマートカードをアンロックする暗証番号がこの方法で与えられるかもしれないことに注意してください。
3) Each user holds their own smartcard in which their own vouchers
are stored (distributed VTS). In this case, the passphrase may
be null because no authentication is required. Note that a PIN
to unlock the smartcard may be given, though this depends on
the implementation.
3) 各ユーザはそれら自身のバウチャーが格納されるそれら自身のスマートカード(分配されたVTS)を持っています。 認証は全く必要でないので、この場合、パスフレーズはヌルであるかもしれません。 これは実現によりますが、スマートカードをアンロックする暗証番号が与えられるかもしれないことに注意してください。
Implementation Notes:
実現注意:
A VTS is responsible for providing secure ways for users to
login(). It is strongly recommended that secure communication
channels such as [TLS] be used if secret or private information
is sent via networks. Fake server attacks, including the so-
called MITM (man-in-the-middle), must be considered as well.
VTSはユーザのための安全な方法をログイン()に提供するのに責任があります。 ネットワークを通して秘密の、または、個人的な情報を送るなら[TLS]などの安全な通信チャネルを使用することが強く勧められます。 また、そのように呼ばれたMITM(中央の男性)を含むにせのサーバ攻撃を考えなければなりません。
Terada & Fujimura Informational [Page 11] RFC 4154 VTS-API September 2005
[11ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
Throws:
一投:
VTSSecurityException - if authentication fails.
VTSSecurityException--認証が失敗するなら。
5.4.2. logout
5.4.2. ログアウトしてください。
public void logout()
throws VTSException
公共の空間がログアウトする、()はVTSExceptionを投げます。
Voids the authentication performed by the login() method.
ログイン()方法で実行された認証を欠如させます。
After this method is called, calling any other method (except
login()) will cause a VTSSecurityException.
いかなる他のも方法と呼んで、この後、方法は呼ばれます。(ログイン())を除いて、VTSSecurityExceptionを引き起こすでしょう。
The VTSAgent can login again by the login() method.
VTSAgentは再びログイン()方法でログインできます。
Throws:
一投:
VTSSecurityException - if the VTSAgent is not authenticated
correctly.
VTSSecurityException--VTSAgentが正しく認証されないなら。
5.4.3. prepare
5.4.3.、準備
public Session prepare(Participant receiver)
throws VTSException
Sessionが準備させる公衆(関与している受信機)はVTSExceptionを投げます。
Establishes a session that is required for trading vouchers. The
trading partner who receives the vouchers is specified as the
receiver. The vouchers to be traded will be specified later (when
a trading method is called).
取り引きバウチャーに必要であるセッションを確立します。 バウチャーを受ける貿易相手国は受信機として指定されます。取り引きされるべきバウチャーは後で指定されるでしょう(貿易方法が呼ばれるとき)。
The establishment of a session is implementation-specific. A
centralized VTS implementation may start a transaction, while a
distributed VTS implementation may get the challenge needed to
create an authentic response from the receiver in the following
trading method.
セッションの設立は実現特有です。 集結されたVTS実現は取引を始めるかもしれません、分配されたVTS実現が受信機から以下の貿易方法で正統の応答を作成するのに必要である挑戦を得るかもしれませんが。
If the VTSAgent does not have the ability to establish a session
with the specified receiver (permanent error), the VTSAgent throws
an InvalidParticipantExeption. If the VTSAgent cannot establish a
session due to network failure (transient error), the VTSAgent
throws a CannotProceedException.
VTSAgentに指定された受信機(永続エラー)とのセッションを確立する能力がないなら、VTSAgentはInvalidParticipantExeptionを投げます。 VTSAgentがネットワーク失敗(一時的エラー)によるセッションを確立できないなら、VTSAgentはCannotProceedExceptionを投げます。
Parameters:
パラメタ:
receiver - the trading partner who receives vouchers.
受信機--バウチャーを受ける貿易相手国。
Terada & Fujimura Informational [Page 12] RFC 4154 VTS-API September 2005
[12ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
Returns:
リターン:
an established session whose state is "prepared" (see Section
5.5).
状態が「準備されている」(セクション5.5を見ます)確立したセッション。
Throws:
一投:
CannotProceedException - if the preparation of the session is
aborted (e.g., network failures).
CannotProceedException--セッションの準備が中止されるなら(例えば、ネットワーク失敗)。
FeatureNotAvailableException - if the VTSAgent does not provide
any trading methods.
FeatureNotAvailableException--VTSAgentが少しの貿易方法も提供しないなら。
InvalidParticipantException - if the specified participant is
invalid.
InvalidParticipantException--指定された関係者が無効であるなら。
VTSSecurityException - if the VTSAgent cannot be authenticated
correctly.
VTSSecurityException--正しくVTSAgentを認証できないなら。
5.4.4. issue
5.4.4. 問題
public void issue(Session session,
VoucherComponent promise,
java.lang.Number num)
throws VTSException
公共の空の問題(セッションセッション、VoucherComponentの約束、java.lang.Number num)はVTSExceptionを投げます。
Issues vouchers. This method creates the specified number of
vouchers <this, promise, receiver> and adds them to the VVS. If
the VTS is distributed, this method would create a "response" that
corresponds to the challenge received in the prepare() method and
send it to the receiver. Note that the receiver is specified when
prepare() is called. Nothing is performed if the specified number
is 0.
バウチャーを発行します。 そして、この方法がバウチャー<の指定された数を作成する、これ、約束、受信機>、VVSに彼らを加えます。 () 方法を用意してください、そして、それを受信機に送ってください。いつが()を準備するか。VTSが分配されているなら、この方法が受け取られた挑戦に対応する「応答」を作成するだろう、受信機が指定されることに注意してください、呼ばれます。 何も指定された数が0であるなら実行されません。
The session MUST be "prepared" when calling this method. The
state of the session will be "activated" when the vouchers are
created, and it will be "completed" when the transaction is
successfully completed or "suspended" if the transaction is
interrupted abnormally (e.g., network failures).
これを方法と呼ぶとき、セッションは「準備されなければなりません」。 バウチャーが創造されるとき、セッションの状態は「動かされ」て、取引が異常(例えば、ネットワーク失敗)に中断されるなら、取引が首尾よく終了されているか、または「中断する」とき、それは「完成されるでしょう」。
Parameters:
パラメタ:
session - the session used by the issue transaction.
セッション--問題取引で使用されるセッション。
promise - the promise part of the voucher.
約束してください--バウチャーの約束部分。
num - the number of vouchers to be issued.
num--発行されるバウチャーの数。
Terada & Fujimura Informational [Page 13] RFC 4154 VTS-API September 2005
[13ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
Throws:
一投:
CannotProceedException - if the transaction cannot be successfully
completed.
CannotProceedException--首尾よく取引を完了されることができないなら。
FeatureNotAvailableException - if the VTSAgent does not provide a
means of issuing vouchers.
FeatureNotAvailableException--VTSAgentがバウチャーを発行する手段を提供しないなら。
InvalidStateException - if the session is not "prepared".
InvalidStateException--セッションが「準備されていない」なら。
VTSSecurityException - if the VTSAgent cannot be authenticated
correctly.
VTSSecurityException--正しくVTSAgentを認証できないなら。
5.4.5. transfer
5.4.5. 転送
public void transfer(Session session,
Participant issuer,
VoucherComponent promise,
java.lang.Number num)
throws VTSException
公共の空の転送(セッションセッション、Participant発行人、VoucherComponentの約束、java.lang.Number num)はVTSExceptionを投げます。
Transfers vouchers. This method rewrites the specified number of
vouchers <issuer, promise, this> to <issuer, promise, receiver> in
the VVS; i.e., deletes the vouchers from the sender and stores
them for the receiver. Similar to issue(), this method would
create and send the response to the receiver if the VTS is
distributed. The VTSAgent must have sufficient vouchers in the
VVS. Nothing is performed if the specified number is 0.
バウチャーを移します。 この方法はバウチャー<発行人、約束、この>の指定された数を<発行人、約束、VVSの受信機>に書き直します。 すなわち、送付者と店からバウチャーを削除する、()を発行するために同様の受信機のためのそれら、VTSが分配されているなら、この方法は応答を受信機に作成して、送るでしょう。 VTSAgentには、十分なバウチャーがVVSになければなりません。 何も指定された数が0であるなら実行されません。
The session MUST be "prepared" when calling this method. The
state of the session will be "activated" when the voucher are
retrieved from the sender, and it will be "completed" when the
transaction is successfully completed or "suspended" if the
transaction is interrupted abnormally (e.g., network failures).
これを方法と呼ぶとき、セッションは「準備されなければなりません」。 バウチャーが送付者から救済されるとき、セッションの状態は「動かされ」て、取引が異常(例えば、ネットワーク失敗)に中断されるなら、取引が首尾よく終了されているか、または「中断する」とき、それは「完成されるでしょう」。
If null is specified for the issuer parameter, it indicates "any
issuer". This method selects vouchers to be transferred from the
set of vouchers returned by the getContents(null, promise).
ヌルが発行人パラメタに指定されるなら、それは「どんな発行人も」を示します。 この方法は、バウチャーがgetContents(ヌル、約束)によって返されたバウチャーのセットから移されるのを選択します。
Terada & Fujimura Informational [Page 14] RFC 4154 VTS-API September 2005
[14ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
Parameters:
パラメタ:
session - the session used by the transfer transaction.
セッション--振替取引で使用されるセッション。
issuer - the issuer part of the voucher, or null.
発行人--バウチャー、またはヌルの発行人部分。
promise - the promise part of the voucher.
約束してください--バウチャーの約束部分。
num - the number of vouchers to be transferred.
num--移されるべきバウチャーの数。
Throws:
一投:
CannotProceedException - if the transaction cannot be successfully
completed.
CannotProceedException--首尾よく取引を完了されることができないなら。
FeatureNotAvailableException - if the VTSAgent does not provide a
means of transferring vouchers.
FeatureNotAvailableException--VTSAgentがバウチャーを移す手段を提供しないなら。
InsufficientVoucherException - if the VTSAgent does not have a
sufficient number of vouchers to transfer.
InsufficientVoucherException--VTSAgentに移す十分な数のバウチャーがないなら。
InvalidStateException - if the session is not "prepared".
InvalidStateException--セッションが「準備されていない」なら。
VTSSecurityException - if the VTSAgent cannot be authenticated
correctly.
VTSSecurityException--正しくVTSAgentを認証できないなら。
5.4.6. consume
5.4.6.、消費
public void consume(Session session,
Participant issuer,
VoucherComponent promise,
java.lang.Number num)
throws VTSException
公共の空間は一投VTSExceptionを消費します(セッションセッション、Participant発行人、VoucherComponentの約束、java.lang.Number num)。
Consumes vouchers. This method deletes the specified number of
vouchers <issuer, promise, this> from the VVS and notifies the
receiver of the deletion. Similar to issue() and transfer(), the
response would be created and sent to the receiver if the VTS is
distributed so that the receiver can obtain proof of the deletion.
The VTSAgent must have a sufficient number of vouchers in the VVS.
Nothing is performed if the specified number is 0.
バウチャーを消費します。 この方法は、VVSからバウチャー<発行人、約束、この>の指定された数を削除して、削除の受信機に通知します。 ()を発行して、()を移すために同様です、受信機が削除の証拠を得ることができるようにVTSが分配しているなら、応答を受信機に作成して、送るでしょう。 VTSAgentには、十分な数のバウチャーがVVSになければなりません。 何も指定された数が0であるなら実行されません。
The session MUST be "prepared" when this method is called. The
state of the session will be "activated" when the vouchers are
deleted, and it will be "completed" when the transaction is
successfully completed or "suspended" if the transaction is
interrupted abnormally (e.g., network failures).
この方法が呼ばれるとき、セッションは「準備されなければなりません」。 バウチャーが削除されるとき、セッションの状態は「動かされ」て、取引が異常(例えば、ネットワーク失敗)に中断されるなら、取引が首尾よく終了されているか、または「中断する」とき、それは「完成されるでしょう」。
Terada & Fujimura Informational [Page 15] RFC 4154 VTS-API September 2005
[15ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
If null is specified for the issuer parameter, it indicates "any
issuer". This method selects vouchers to be consumed from the set
of vouchers returned by the getContents(null, promise).
ヌルが発行人パラメタに指定されるなら、それは「どんな発行人も」を示します。 この方法は、バウチャーがgetContents(ヌル、約束)によって返されたバウチャーのセットから疲れているのを選択します。
Parameters:
パラメタ:
session - the session used by the consume transaction.
セッション--、セッションが使用した、取引を消費してください。
issuer - the issuer part of the voucher, or null.
発行人--バウチャー、またはヌルの発行人部分。
promise - the promise part of the voucher.
約束してください--バウチャーの約束部分。
num - the number of vouchers to be consumed.
num--消費されるべきバウチャーの数。
Throws:
一投:
CannotProceedException - if the transaction cannot be successfully
completed.
CannotProceedException--首尾よく取引を完了されることができないなら。
FeatureNotAvailableException - if the VTSAgent does not provide a
means of consuming vouchers.
FeatureNotAvailableException--VTSAgentがバウチャーを消費する手段を提供しないなら。
InsufficientVoucherException - if the VTSAgent does not have a
sufficient number of vouchers to consume.
InsufficientVoucherException--VTSAgentに消費する十分な数のバウチャーがないなら。
InvalidStateException - if the session is not "prepared".
InvalidStateException--セッションが「準備されていない」なら。
VTSSecurityException - if the VTSAgent cannot be authenticated
correctly.
VTSSecurityException--正しくVTSAgentを認証できないなら。
5.4.7. present
5.4.7. 存在しています。
public void present(Session session,
Participant issuer,
VoucherComponent promise,
java.lang.Number num)
throws VTSException
公共の空のプレゼント(セッションセッション、Participant発行人、VoucherComponentの約束、java.lang.Number num)はVTSExceptionを投げます。
Presents vouchers. This method shows that the sender has the
specified number of vouchers <issuer, promise, this> in the VVS to
the receiver of the session; no modification is performed to the
VVS. However, the response would be sent to the receiver as well
as consume() in order to prove that the VTS has been distributed.
The VTSAgent must have a sufficient number of vouchers in the VVS.
Nothing is performed if the specified number is 0.
バウチャーを紹介します。 この方法は、送付者にはバウチャー<発行人の指定された数があるのを示します、約束、セッションの受信機へのVVSのこの>。 変更は全くVVSに実行されません。 しかしながら、応答は、VTSが分配されたと立証するために受信機に送られて、()を消費するでしょう。 VTSAgentには、十分な数のバウチャーがVVSになければなりません。 何も指定された数が0であるなら実行されません。
The session MUST be "prepared" when this method is called. The
state of the session will be "activated" when the vouchers are
この方法が呼ばれるとき、セッションは「準備されなければなりません」。 バウチャーが動かされるとき、セッションの状態は「動かされるでしょう」。
Terada & Fujimura Informational [Page 16] RFC 4154 VTS-API September 2005
[16ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
retrieved, and it will be "completed" when the transaction is
successfully completed or "suspended" if the transaction is
interrupted abnormally (e.g., by network failures).
検索、取引が異常(例えば、ネットワーク失敗で)に中断されるなら、取引が首尾よく終了されているか、または「中断する」とき、それは「完成されるでしょう」。
If null is specified for the issuer parameter, it indicates "any
issuer". This method selects vouchers to be presented from the
set of vouchers returned by the getContents(null, promise).
ヌルが発行人パラメタに指定されるなら、それは「どんな発行人も」を示します。 この方法は、バウチャーがgetContents(ヌル、約束)によって返されたバウチャーのセットから紹介されるのを選択します。
Parameters:
パラメタ:
session - the session used by the present transaction.
セッション--現在の取引で使用されるセッション。
issuer - the issuer part of the voucher, or null.
発行人--バウチャー、またはヌルの発行人部分。
promise - the promise part of the voucher.
約束してください--バウチャーの約束部分。
num - the number of the voucher to be presented.
num--紹介されるバウチャーの数。
Throws:
一投:
CannotProceedException - if the transaction cannot be successfully
completed.
CannotProceedException--首尾よく取引を完了されることができないなら。
InsufficientVoucherException - if the VTSAgent does not have a
sufficient number of vouchers to present.
InsufficientVoucherException--VTSAgentに紹介する十分な数のバウチャーがないなら。
InvalidStateException - if the session is not "prepared".
InvalidStateException--セッションが「準備されていない」なら。
FeatureNotAvailableException - if the VTSAgent does not provide a
means of presenting vouchers.
FeatureNotAvailableException--VTSAgentがバウチャーを紹介する手段を提供しないなら。
VTSSecurityException - if the VTSAgent cannot be authenticated
correctly.
VTSSecurityException--正しくVTSAgentを認証できないなら。
5.4.8. cancel
5.4.8. キャンセル
public void cancel(Session session)
throws VTSException
公共の空のキャンセル(セッションセッション)はVTSExceptionを投げます。
Releases the session. "Prepared" sessions MUST be canceled. An
implementation MAY be permitted to cancel "activated" or
"suspended" sessions.
セッションをリリースします。 「準備された」セッションを中止しなければなりません。 実現が「活性」の、または、「吊した」セッションを中止することが許可されるかもしれません。
Throws:
一投:
InvalidStateException - if the state of the session cannot be
canceled.
InvalidStateException--セッションの状態を取り消すことができないなら。
Terada & Fujimura Informational [Page 17] RFC 4154 VTS-API September 2005
[17ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
VTSSecurityException - if the VTSAgent cannot be authenticated
correctly.
VTSSecurityException--正しくVTSAgentを認証できないなら。
5.4.9. resume
5.4.9. 履歴書
public void resume(Session session)
throws VTSException
公共の空の履歴書(セッションセッション)はVTSExceptionを投げます。
Restarts the session. Only "suspended" sessions can be resumed.
The state of the session will be re-"activated" immediately, and
it will be "completed" when the transaction is successfully
completed or "suspended" again if the transaction is interrupted
abnormally (e.g., network failures).
セッションを再開します。 「吊した」セッションしか再開できません。 セッションの状態がすぐに、再「動かされ」て、取引が異常(例えば、ネットワーク失敗)に中断されると、それは、取引が首尾よく完了されるとき、「完成される」か、または再び「中断するでしょう」。
Throws:
一投:
CannotProceedException - if the transaction cannot be successfully
completed.
CannotProceedException--首尾よく取引を完了されることができないなら。
InvalidStateException - if the session is not "suspended".
InvalidStateException--セッションが「吊していない」なら。
VTSSecurityException - if the VTSAgent cannot be authenticated
correctly.
VTSSecurityException--正しくVTSAgentを認証できないなら。
5.4.10. create
5.4.10.、作成
public void create(VoucherComponent promise, java.lang.Number num)
throws VTSException
公共の空間は一投VTSExceptionを作成します(java.lang.Number num、VoucherComponentは約束します)。
Creates vouchers where the issuer is the VTSAgent itself. This
method creates the specified number of vouchers <this, promise,
this> and adds them to the VVS. Nothing is performed if the
specified number is 0.
発行人がVTSAgent自身であるところでバウチャーを創造します。 そして、この方法がバウチャー<の指定された数を作成する、これ、約束、この>、VVSに彼らを加えます。 何も指定された数が0であるなら実行されません。
Throws:
一投:
FeatureNotAvailableException - if the VTSAgent does not provide a
means of creating vouchers.
FeatureNotAvailableException--VTSAgentがバウチャーを創造する手段を提供しないなら。
VTSSecurityException - if the VTSAgent cannot be authenticated
correctly.
VTSSecurityException--正しくVTSAgentを認証できないなら。
Terada & Fujimura Informational [Page 18] RFC 4154 VTS-API September 2005
[18ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
5.4.11. delete
5.4.11.、削除
public void delete(Participant issuer, VoucherComponent promise,
java.lang.Number num)
throws VTSException
公共の空間は一投VTSExceptionを削除します(関与している発行人、VoucherComponentの約束、java.lang.Number num)。
Deletes vouchers. This method deletes the specified number of
vouchers <issuer, promise, this> from the VVS. The VTSAgent must
have sufficient vouchers in the VVS. Nothing is performed if the
specified number is 0.
バウチャーを削除します。 この方法はVVSからバウチャー<発行人、約束、この>の指定された数を削除します。 VTSAgentには、十分なバウチャーがVVSになければなりません。 何も指定された数が0であるなら実行されません。
Throws:
一投:
InsufficientVoucherException - if the VTSAgent does not have a
sufficient number of vouchers to delete.
InsufficientVoucherException--VTSAgentに削除する十分な数のバウチャーがないなら。
VTSSecurityException - if the VTSAgent cannot be authenticated
correctly.
VTSSecurityException--正しくVTSAgentを認証できないなら。
5.4.12. getContents
5.4.12. getContents
public java.util.Set getContents(Participant issuer,
VoucherComponent promise)
throws VTSException
公共のjava.util.Set getContents(関与している発行人、VoucherComponentの約束)はVTSExceptionを投げます。
Returns the set of vouchers whose issuer and promise both match
the issuer and promise specified in the parameters.
発行人と約束がともに発行人に合っているバウチャーとパラメタで指定された約束のセットを返します。
If null is specified for the issuer or promise parameter, it
indicates "any issuer" or "any promise", respectively. If null is
specified for both parameters, this method selects all vouchers
owned by the holder from the VVS.
ヌルが発行人か約束パラメタに指定されるなら、それはそれぞれ「どんな発行人も」か「どんな約束」を示します。 ヌルが両方のパラメタに指定されるなら、この方法はVVSから所有者によって所有されていたすべてのバウチャーを選びます。
Returns:
リターン:
the set of vouchers held by the holder of the VTSAgent.
バウチャーのセットはVTSAgentの所有者を固守しました。
Throws:
一投:
VTSSecurityException - if the VTSAgent cannot be authenticated
correctly.
VTSSecurityException--正しくVTSAgentを認証できないなら。
5.4.13. getSessions
5.4.13. getSessions
public java.util.Set getSessions()
throws VTSException
公共のjava.util.Set getSessions()はVTSExceptionを投げます。
Returns a set of incomplete sessions prepared by the VTSAgent.
1セットの不完全なセッションがVTSAgentで準備したリターン。
Terada & Fujimura Informational [Page 19] RFC 4154 VTS-API September 2005
[19ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
Returns:
リターン:
the set of sessions prepared by the VTSAgent that are not yet
completed.
まだ完成していないVTSAgentによって準備されたセッションのセット。
Throws:
一投:
VTSSecurityException - if the VTSAgent cannot be authenticated
correctly.
VTSSecurityException--正しくVTSAgentを認証できないなら。
5.4.14. getLog
5.4.14. getLog
public java.util.Set getLog()
throws VTSException
公共のjava.util.Set getLog()はVTSExceptionを投げます。
Returns a set of completed sessions prepared or received by the
VTSAgent. This set represents the trading log of the VTSAgent. A
VTS may delete an old log eventually, so that the entire log may
not be returned; the amount of the log kept by the VTSAgent is
implementation-specific.
1セットの完成したセッションがVTSAgentで準備したか、または受けたリターン。 このセットはVTSAgentの取り引きログを表します。 VTSは結局、全体のログが返されないように、古いログを削除するかもしれません。 VTSAgentによって保たれたログの量は実現特有です。
Returns:
リターン:
the set of completed sessions prepared or received by the
VTSAgent.
完成したセッションのセットは、準備したか、またはVTSAgentのそばで受信されました。
Throws:
一投:
VTSSecurityException - if the VTSAgent cannot be authenticated
correctly.
VTSSecurityException--正しくVTSAgentを認証できないなら。
5.4.15. addReceptionListener
5.4.15. addReceptionListener
public void addReceptionListener(ReceptionListener l)
throws VTSException
公共の空のaddReceptionListener(ReceptionListener l)はVTSExceptionを投げます。
Adds a ReceptionListener to the listener list.
リスナーリストにReceptionListenerを追加します。
After a ReceptionListener l is registered by this method,
l.arrive() will be called whenever the VTSAgent receives a
voucher.
ReceptionListener lがこの方法で登録された後にl.は到着します。() VTSAgentがバウチャーを受けるときはいつも、呼ばれるでしょう。
Nothing is performed if the specified listener is null.
指定されたリスナーがヌルであるなら、何も実行されません。
Throws:
一投:
VTSSecurityException - if the VTSAgent cannot be authenticated
correctly.
VTSSecurityException--正しくVTSAgentを認証できないなら。
Terada & Fujimura Informational [Page 20] RFC 4154 VTS-API September 2005
[20ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
5.4.16. removeReceptionListener
5.4.16. removeReceptionListener
public void removeReceptionListener(ReceptionListener l)
throws VTSException
公共の空のremoveReceptionListener(ReceptionListener l)はVTSExceptionを投げます。
Removes a ReceptionListener from the listener list.
リスナーリストからReceptionListenerを取り外します。
Nothing is performed when the specified listener is null or not
registered.
何も、指定されたリスナーがヌルであるときに、実行されるか、または登録されません。
Throws:
一投:
VTSSecurityException - if the VTSAgent cannot be authenticated
correctly.
VTSSecurityException--正しくVTSAgentを認証できないなら。
5.5. Session
5.5. セッション
public interface Session
公共のインタフェースSession
Represents the logical connection established by the trade.
Sessions are established by VTSAgent#prepare().
取り引きによって確立された論理的な接続の代理をします。 セッションは#、が()を準備するVTSAgentによって確立されます。
A session has four states: prepared, activated, suspended, and
completed. The initial state of a session is "prepared", and the
session will be "activated" immediately when any of the trading
methods of VTSAgent is called. The "activated" session will be
"completed" after the trading method is successfully completed.
If the trading method fails transiently (e.g., network failure),
the session will be "suspended". Suspended sessions can be re-
"activated" and restarted by calling VTSAgent#resume().
セッションには、4つの州があります: 準備されて、活性で、吊していて、完成しています。 セッションの初期状態は「準備されています」、そして、すぐVTSAgentの貿易方法のどれかが呼ばれるとき、セッションは「動かされるでしょう」。 貿易方法が首尾よく完成した後に「活性」のセッションは「完成されるでしょう」。 貿易方法がはかなく(例えば、ネットワーク失敗)に失敗すると、セッションは「中断するでしょう」。 VTSAgent#を履歴書()と呼ぶことによって、吊したセッションを再「動かし」て、再開できます。
A completed session may disappear from the VTSAgent; the session
will be collected by the GC unless other objects keep its
reference.
完成したセッションはVTSAgentから見えなくなるかもしれません。 他の物が参照を保たないと、セッションはGCによって集められるでしょう。
5.5.1. getIdentifier
5.5.1. getIdentifier
public String getIdentifier()
公共のString getIdentifier()
Returns the identifier of the session. The generation scheme of
the identifier is implementation-specific. An implementation may
use a transaction ID as the identifier of the session.
セッションに関する識別子を返します。 識別子の世代計画は実現特有です。 実現はセッションに関する識別子として取引IDを使用するかもしれません。
Returns:
リターン:
the string of the identifier of the session.
セッションに関する識別子のストリング。
Terada & Fujimura Informational [Page 21] RFC 4154 VTS-API September 2005
[21ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
5.5.2. getVoucher
5.5.2. getVoucher
public Voucher getVoucher()
公共のVoucher getVoucher()
Returns the voucher to be traded using the session, or returns
null if the session has not been activated.
取り引きするためにセッションを使用することでバウチャーを返すか、またはセッションが起動されていないなら、ヌルを返します。
Returns:
リターン:
the voucher to be traded, or null if the state of the session is
"prepared".
バウチャー、取り引きしているか、またはヌルであるためにセッションの状態がそうであるなら「準備されて」。
5.5.3. getSender
5.5.3. getSender
public Participant getSender()
公共のParticipant getSender()
Returns the sender of the session (i.e., the creator who prepared
the session).
セッション(すなわち、セッションを準備した創造者)の送付者を返します。
Returns:
リターン:
the sender of the session.
セッションの送付者。
5.5.4. getReceiver
5.5.4. getReceiver
public Participant getReceiver()
公共のParticipant getReceiver()
Returns the receiver of the session (i.e., the participant
specified when preparing the session (by the VTSAgent#prepare()
method)).
セッション(セッションを準備するとき、すなわち、関係者は指定しました(VTSAgent#で、() 方法を用意する))の受信機を返します。
Returns:
リターン:
the receiver of the session.
セッションの受信機。
5.5.5. isPrepared
5.5.5. isPreparedされています。
public boolean isPrepared()
公共の論理演算子isPrepared()
Verifies if the session is "prepared".
セッションが「準備されているかどうか」確かめます。
Returns:
リターン:
true if the session is in the "prepared" state, otherwise, false.
セッションであるならコネが「準備」であるというそうでなければ、そして、虚偽本当の状態。
Terada & Fujimura Informational [Page 22] RFC 4154 VTS-API September 2005
[22ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
5.5.6. isActivated
5.5.6. isActivatedされています。
public boolean isActivated()
公共の論理演算子isActivated()
Verifies if the session is "activated".
セッションが「活性であるかどうか」確かめます。
Returns:
リターン:
true if the session is in the "activated" state, otherwise, false.
セッションであるならコネが「活性」であるというそうでなければ、そして、虚偽本当の状態。
5.5.7. isSuspended
5.5.7. isSuspendedされています。
public boolean isSuspended()
公共の論理演算子isSuspended()
Verifies if the session is "suspended".
セッションが「吊しているかどうか」確かめます。
Returns:
リターン:
true if the session is in the "suspended" state, otherwise, false.
セッションであるならコネが「吊している」であるというそうでなければ、そして、虚偽本当の状態。
5.5.8. isCompleted
5.5.8. isCompletedされています。
public boolean isCompleted()
公共の論理演算子isCompleted()
Verifies if the session is "completed".
セッションが「完成されるかどうか」確かめます。
Returns:
リターン:
true if the session is in the "completed" state, otherwise, false.
セッションであるならコネが「完成する」であるというそうでなければ、そして、虚偽本当の状態。
5.6. Voucher
5.6. バウチャー
public interface Voucher
公共のインタフェースVoucher
Represents voucher(s) described in [VTS]. An object implementing
this interface can represent more than one voucher if all of the
issuer part and the promise part of the vouchers are the same.
[VTS]で説明されたバウチャーの代理をします。 発行人部分のすべてとバウチャーの約束部分が同じであるなら、このインタフェースを実行する物は1つ以上のバウチャーの代理をすることができます。
5.6.1. getIssuer
5.6.1. getIssuer
public Participant getIssuer()
公共のParticipant getIssuer()
Returns the issuer part of the voucher(s).
バウチャーの発行人部分を返します。
Returns:
リターン:
the participant who issued the voucher(s).
バウチャーを発行した関係者。
Terada & Fujimura Informational [Page 23] RFC 4154 VTS-API September 2005
[23ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
5.6.2. getPromise
5.6.2.、getPromise
public VoucherComponent getPromise()
公共のVoucherComponent getPromise()
Returns the promise part of the voucher(s).
バウチャーの約束部分を返します。
Returns:
リターン:
the voucher component that defines the promise of the voucher.
バウチャーの約束を定義するバウチャーコンポーネント。
5.6.3. getCount
5.6.3. getCount
public java.lang.Number getCount()
公共のjava.lang.Number getCount()
Returns the number of the voucher(s).
バウチャーの数を返します。
Returns:
リターン:
the positive (>0) number of the voucher(s).
バウチャーの正(>0)の数。
5.7. VoucherComponentRepository
5.7. VoucherComponentRepository
public interface VoucherComponentRepository
公共のインタフェースVoucherComponentRepository
Maintains VoucherComponents.
VoucherComponentsであることを支持します。
An object implementing VoucherComponentRepository provides a means
of retrieving the voucher components that are the promises of
vouchers in the VVS.
VoucherComponentRepositoryを実行する物はVVSでのバウチャーの約束であるバウチャーコンポーネントを検索する手段を提供します。
Before issuing a voucher, the promise of the voucher must be
registered with this repository. The repository can be
implemented as either a network-wide directory service or personal
storage like the ParticipantRepository.
伝票を切る前に、この倉庫にバウチャーの約束を登録しなければなりません。 ParticipantRepositoryのようにネットワーク全体の電話番号案内か個人的な格納のどちらかとして倉庫を実行できます。
5.7.1. register
5.7.1. レジスタ
public VoucherComponent register(org.w3c.dom.Document document)
公共のVoucherComponentは登録します。(org.w3c. dom.Documentドキュメント)
Creates a voucher component associated with the specified DOM
object and registers the voucher component with the repository.
指定されたDOM物に関連づけられたバウチャーコンポーネントを作成して、バウチャーコンポーネントを倉庫に示します。
A voucher component of the voucher to be issued must be registered
using this method.
この方法を使用することで発行されるバウチャーのバウチャーコンポーネントを示さなければなりません。
Nothing is performed (and the method returns null) if the
specified document is null or the syntax of the document does not
conform to the VTS.
指定されたドキュメントがヌルである、またはドキュメントの構文がVTSに従わないなら、何も実行されません(方法はヌルを返します)。
Terada & Fujimura Informational [Page 24] RFC 4154 VTS-API September 2005
[24ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
The method returns the registered voucher component if the
specified DOM object has been already registered (no new voucher
component is created in this case).
指定されたDOM物が既に登録されたなら(どんな新しいバウチャーコンポーネントもこの場合作成されません)、方法は登録されたバウチャーコンポーネントを返します。
Returns:
リターン:
a registered voucher component associated with the specified
document, or null if the document is null or has wrong syntax.
コンポーネントがドキュメントであるなら指定されたドキュメント、またはヌルに関連づけた登録されたバウチャーは、ヌルである、または間違った構文を持っています。
5.8. VoucherComponent
5.8. VoucherComponent
public interface VoucherComponent
公共のインタフェースVoucherComponent
Represents the voucher component that defines the promise of the
voucher.
バウチャーの約束を定義するバウチャーコンポーネントを表します。
Each VoucherComponent object has its own unique identifier and is
associated with an XML document that describes the promise made by
the issuer of the voucher (e.g., goods or services can be claimed
in exchange for redeeming the voucher).
それぞれのVoucherComponent物は、それ自身のユニークな識別子を持っていて、バウチャーの発行人によってされた約束について説明するXMLドキュメントに関連しています(バウチャーを身請けすることと引き換えに例えば、商品かサービスを要求できます)。
This interface can be implemented as sort of a "smart pointer" to
the XML document. An implementation may have a reference to a
voucher component repository instead of the voucher component, and
it may retrieve the document dynamically from the repository when
the getDocument() method is called.
ちょっとXMLへの「賢いポインタ」ドキュメントとしてこのインタフェースを実行できます。 実現には、バウチャーコンポーネントの代わりにバウチャーコンポーネント倉庫の参照があるかもしれません、そして、getDocument()方法が呼ばれるとき、それは倉庫からドキュメントをダイナミックに検索するかもしれません。
5.8.1. getIdentifier
5.8.1. getIdentifier
public String getIdentifier()
公共のString getIdentifier()
Returns the identifier of the voucher component. Each voucher
component must have a unique identifier. The identifier may be
used to check for equivalence of voucher components.
バウチャーコンポーネントに関する識別子を返します。 それぞれのバウチャーコンポーネントには、ユニークな識別子がなければなりません。 識別子は、バウチャーコンポーネントの等価性がないかどうかチェックするのに使用されるかもしれません。
The format of the identifier is implementation-specific, however,
it is RECOMMENDED that the hash value of the voucher component in
the identifier be included to assure uniqueness. For generating
the hash value, it is desirable to use a secure hash function
(e.g., [SHA-1]) and to apply a canonicalization function (e.g.,
[EXC-C14N]) before applying the hash function to minimize the
impact of insignificant format changes to the voucher component,
(e.g., line breaks or character encoding).
識別子の形式が実現特有である、しかしながら、識別子のバウチャーコンポーネントのハッシュ値がユニークさを保証するために含まれているのは、RECOMMENDEDです。 ハッシュ値を発生させるのに、安全なハッシュ関数(例えば、[SHA-1])を使用して、バウチャーコンポーネントか、(例えば、ラインブレイクかキャラクタコード化)へのわずかな形式変化の衝撃を最小にするためにハッシュ関数を適用する前にcanonicalization機能(例えば、[EXC-C14N])を適用するのは望ましいです。
Returns:
リターン:
the identifier string of the voucher component.
バウチャーコンポーネントの識別子ストリング。
Terada & Fujimura Informational [Page 25] RFC 4154 VTS-API September 2005
[25ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
5.8.2. getDocument
5.8.2. getDocument
public org.w3c.dom.Document getDocument()
公共のorg.w3c. dom.Document getDocument()
Returns a Document Object Model [DOM] representation of the
document associated with the voucher component by the
VoucherComponentRepository#register() method.
ドキュメントのDocument Object Model[DOM]表現がバウチャーコンポーネントに関連づけたリターンはVoucherComponentRepository#で() 方法を登録します。
The DOM object to be returned may be retrieved from a
VoucherComponentRepository on demand, instead of the
VoucherComponent always keeping a reference to the DOM object.
返されるDOM物はオンデマンドのVoucherComponentRepositoryから検索されるかもしれません、いつもDOM物の参照を保つVoucherComponentの代わりに。
The VTS must guarantee that the getDocument method will eventually
return the DOM object, provided that the voucher associated with
the corresponding voucher component exists in the VVS.
VTSは、getDocument方法が結局DOM物を返すのを保証しなければなりません、対応するバウチャーコンポーネントに関連しているバウチャーがVVSに存在していれば。
Returns:
リターン:
a DOM representation of the document associated with the voucher
component.
ドキュメントのDOM表現はバウチャーコンポーネントと交際しました。
Throws:
一投:
DocumentNotFoundException - if the associated DOM object cannot be
retrieved.
DocumentNotFoundException--関連DOM物を検索できないなら。
5.9. ReceptionListener
5.9. ReceptionListener
public interface ReceptionListener extends java.util.EventListener
公共のインタフェースReceptionListenerはjava.util.EventListenerを広げています。
Provides a listener interface with a notification that a VTSAgent
has received a voucher.
VTSAgentがバウチャーを受けたという通知をリスナーインタフェースに提供します。
When a voucher arrives at the VTSAgent, the VTSAgent invokes the
arrive() method of each registered ReceptionListener.
ReceptionListeners can obtain a Session object, which contains
information about the received voucher and the sender of the
voucher.
到着してください。バウチャーがVTSAgent、VTSAgentに到着する、呼び出し、() それぞれの方法はReceptionListenerを登録しました。 ReceptionListenersはSession物を入手できます。(それは、容認されたバウチャーとバウチャーの送付者の情報を含みます)。
This interface is intended to provide a means of notifying a
wallet that "You have new vouchers", so that this interface may be
implemented by wallets or other applications that use VTS.
このインタフェースが「あなたには、新しいバウチャーがあります」ように財布に通知する手段を提供することを意図します、VTSを使用する財布か他のアプリケーションでこのインタフェースを実行できるように。
5.9.1. arrive
5.9.1. 到着してください。
public void arrive(Session session)
公共の空間は到着します。(セッションセッション)
Provides notification of the arrival of a voucher.
バウチャーの到着の通知を提供します。
Terada & Fujimura Informational [Page 26] RFC 4154 VTS-API September 2005
[26ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
After the listener is registered to a VTSAgent (by the
VTSAgent#addReceptionListener() method), the VTSAgent invokes this
method whenever it receives a voucher.
リスナーがVTSAgent(VTSAgent#addReceptionListener()方法による)に登録された後に、バウチャーを受けるときはいつも、VTSAgentはこの方法を呼び出します。
The specified session is equivalent to the session used by the
sender to trade the voucher. The state of the session is
"completed" when this method is called.
指定されたセッションはバウチャーを取り引きするのに送付者によって使用されたセッションに同等です。 この方法が呼ばれるとき、セッションの状態は「完成されます」。
5.10. Exceptions
5.10. 例外
java.lang.Exception
+-- VTSException
+-- CannotProceedException
+-- DocumentNotFoundException
+-- FeatureNotAvailableException
+-- InsufficientVoucherException
+-- InvalidParticipantException
+-- InvalidStateException
+-- VTSSecurityException
java.lang.Exception+--VTSException+--CannotProceedException+--DocumentNotFoundException+--FeatureNotAvailableException+--InsufficientVoucherException+--InvalidParticipantException+--InvalidStateException+--VTSSecurityException
VTSException
This is the superclass of all exceptions thrown by the methods in
the interfaces that construct the VTS-API.
VTSException ThisはVTS-APIを組み立てるインタフェースの方法で投げられたすべての例外の「スーパー-クラス」です。
CannotProceedException
This exception is thrown when a trading is interrupted by network
failures or other errors.
取り引きがネットワーク失敗か他の誤りで中断されるとき、CannotProceedException This例外は投げられます。
DocumentNotFoundException
This exception is thrown when the document associated with a
voucher component cannot be found.
バウチャーコンポーネントに関連しているドキュメントを見つけることができないとき、DocumentNotFoundException This例外は投げられます。
FeatureNotAvailableException
This exception is thrown when the invoked method is not supported.
呼び出された方法が支持されないとき、FeatureNotAvailableException This例外は投げられます。
InsufficientVoucherException
This exception is thrown when the number of the voucher is less
than the number specified for trading.
バウチャーの数が数が取り引きするのに指定したより少ないときに、InsufficientVoucherException This例外は投げられます。
InvalidParticipantException
This exception is thrown when the specified participant cannot be
located.
指定された関係者の見つけることができないとき、InvalidParticipantException This例外は投げられます。
InvalidStateException
This exception is thrown when the state of the session is invalid
and the operation cannot proceed.
セッションの状態が無効であり、操作が続くことができないとき、InvalidStateException This例外は投げられます。
Terada & Fujimura Informational [Page 27] RFC 4154 VTS-API September 2005
[27ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
VTSSecurityException
This exception is thrown when authentication fails, or when a
method that requires authentication in advance is called without
authentication.
認証が失敗するか、またはあらかじめ認証を必要とする方法が認証なしで呼ばれるとき、VTSSecurityException This例外は投げられます。
6. Example Code
6. 例のコード
// Issue a voucher
//は伝票を切ります。
VTSManager vts = new FooVTSManager(); ParticipantRepository addrBook = vts.getParticipantRepository(); VoucherComponentRepository vcr = vts.getVoucherComponentRepository();
VTSManager vtsは新しいFooVTSManager()と等しいです。 ParticipantRepository addrBookはvts.getParticipantRepository()と等しいです。 VoucherComponentRepository vcrはvts.getVoucherComponentRepository()と等しいです。
Participant you = addrBook.lookup("http://example.org/foo");
// looks up a trading partner identified as
// "http://example.org/foo".
VTSAgent me = addrBook.lookup("myName").getVTSAgent();
// a short-cut name may be used if VTS implementation allows.
関係者あなた=addrBook.lookup(" http://example.org/foo ")。 //" http://example.org/foo "として特定された貿易相手国への//一見。 VTSAgent addrBook.lookup私=("myName").getVTSAgent()。 ショートカットが命名する//はVTS実現であるなら使用されるかもしれません。許容します。
VoucherComponent promise = vcr.register(anXMLVoucherDocument);
// registers a voucher component that corresponds to the voucher
// to be issued.
VoucherComponentの約束はvcr.register(anXMLVoucherDocument)と等しいです。 //は発行されるバウチャー//に対応するバウチャーコンポーネントを示します。
try {
me.login();
// sets up the issuer's smartcard (assuming distributed VTS).
s = me.prepare(you);
// receives a challenge from the partner.
me.issue(s, promise, 1);
// sends a voucher using the received challenge.
me.logout();
} catch (VTSException e) {
// if an error (e.g., a network trouble) occurs...
System.err.println("Sorry.");
e.printStackTrace();
// this example simply prints a stack trace, but a real wallet
// may prompt the user to retry (or cancel).
}
me.login(); //が. パートナーme.issue(s、約束、1)から挑戦を受けるという//が. 容認された挑戦me.logout()を使用しているバウチャーに送る発行人のスマートカード(分配されたVTSを仮定する). s=me.prepare(あなた)への//セット;キャッチ(VTSException e)を試みてください。//は誤り(例えば、ネットワーク問題)であるなら起こります… System.err.println(「すみません」。); e.printStackTrace(); 再試行する(取り消してください)単に印刷しかし、スタックトレース、本当の財布//がそうするこの例がユーザをうながす//
// Transfer all my vouchers
//は私のすべてのバウチャーを移します。
VTSManager vts = new FooVTSManager(); ParticipantRepository addrBook = vts.getParticipantRepository();
VTSManager vtsは新しいFooVTSManager()と等しいです。 ParticipantRepository addrBookはvts.getParticipantRepository()と等しいです。
Participant you = addrBook.lookup("8f42 5aab ffff cafe babe...");
// some VTS implementations would use a hash value of a public key
// (aka fingerprint) as an identifier of a participant.
VTSAgent me = addrBook.lookup("myName").getVTSAgent();
関係者あなた=addrBook.lookup(「8f42 5aab ffffカフェベイブ」)。 いくつかのVTS実現がそうする//は関係者の識別子として公開鍵//(別名指紋)のハッシュ値を使用します。 VTSAgent addrBook.lookup私=("myName").getVTSAgent()。
Terada & Fujimura Informational [Page 28] RFC 4154 VTS-API September 2005
[28ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
try {
me.login();
Iterator i = me.getContents(null, null).iterator();
トライ、me.login(); 繰返し子iはme.getContentsの(ヌルと、ヌル)の.iterator()と等しいです。
while (i.hasNext()) {
Voucher v = (Voucher) i.next();
s = me.prepare(you);
me.transfer(s, v.getIssuer(), v.getPromise(), v.getCount());
}
(i.hasNext())バウチャーvが次の(); s=me.prepare(あなた); (バウチャー)i.me.transferと等しい、(getIssuer()対getPromise()へのs v.getCount())。
me.logout();
} catch (VTSException e) {
System.err.println("Sorry.");
e.printStackTrace();
}
me.logout()。 (VTSException e)を捕らえてください。System.err.println(「すみません」。)。 e.printStackTrace()。 }
// Register an incoming voucher notifier (biff)
//は入って来るバウチャーnotifierを登録します。(一撃)
VTSManager vts = new FooVTSManager();
VTSManager vtsは新しいFooVTSManager()と等しいです。
ParticipantRepository addrBook = vts.getParticipantRepository();
VTSAgent me = addrBook.lookup("myName").getVTSAgent();
ParticipantRepository addrBookはvts.getParticipantRepository()と等しいです。 VTSAgent addrBook.lookup私=("myName").getVTSAgent()。
ReceptionListener listener = new ReceptionListener() {
public void arrive(Session s) {
System.out.println("You got a new voucher.");
}
};
ReceptionListenerリスナー=の新しいReceptionListener()、公共の空間が到着する、(セッションs)System.out.println(「あなたは新しいバウチャーを得ました」。);、。
try {
me.login();
me.addReceptionListener(listener);
me.logout();
} catch (VTSException e) {
System.err.println("Sorry.");
e.printStackTrace();
}
トライ、me.login(); me.addReceptionListener(リスナー);me.logout();、(VTSException e)を捕らえてください。System.err.println(「すみません」。)(e.printStackTrace())
7. Security Considerations
7. セキュリティ問題
Security is very important for trading vouchers. VTS implementations are responsible for preventing illegal acts upon vouchers (as described in [VTS]), as well as preventing malicious access from invalid users and fake server attacks, including man-in-the-middle attacks.
取り引きバウチャーに、セキュリティは非常に重要です。 VTS実現は無効のユーザとにせのサーバ攻撃から悪意があるアクセスを防ぐことと同様にバウチャーで不法な行為を防ぐのに([VTS]で説明されるように)原因となります、介入者攻撃を含んでいて。
The means to achieve the above requirements are not specified in this document because they depend on VTS implementation. However,
上記の要件を達成する手段は、本書ではVTS実現によるので、指定されません。 しかしながら
Terada & Fujimura Informational [Page 29] RFC 4154 VTS-API September 2005
[29ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
securing communication channels (e.g., using TLS) between client VTS plug-ins and the central server in a centralized VTS (as described in 5.4.1 login()), and applying cryptographic challenge-and-response techniques in a distributed VTS are likely to be helpful and are strongly recommended to implement a secure VTS.
aで通信チャネル(例えば、TLSを使用する)をクライアントVTSプラグインとセントラルサーバーの間に保証すると、VTSは集中しました。(5.4.1ログイン())、および適用暗号で説明されるように、分配されたVTSの挑戦と応答のテクニックは、役立っているのがありそうであり、安全なVTSを実行することが強く勧められます。
This document assumes that the VTS plug-in is trusted by its user. The caller application of a VTS should authenticate the VTS plug-in and bind it securely using the VTS Provider information specified in the Voucher Component. This document, however, does not specify any application authentication scheme and it is assumed to be specified by other related standards. Until various VTS systems are deployed, it is enough to manually check and install VTS plug-ins like other download applications.
このドキュメントは、VTSプラグインがユーザによって信じられると仮定します。 VTSの訪問者アプリケーションは、しっかりとVoucher Componentで指定されたVTS Provider情報を使用することでVTSプラグインを認証して、それを縛るべきです。 しかしながら、このドキュメントはどんなアプリケーション認証計画も指定しません、そして、他の関連する規格によって指定されると思われます。 様々なVTSシステムが配備されるまで、手動で他のダウンロードアプリケーションのようなVTSプラグインをチェックして、インストールするのは十分です。
8. Acknowledgements
8. 承認
The following persons, in alphabetic order, contributed substantially to the material herein:
以下の人々はアルファベット順に実質的にここに材料に貢献しました:
Donald Eastlake 3rd
Iguchi Makoto
Yoshitaka Nakamura
Ryuji Shoda
ドナルドイーストレーク第3Iguchi誠嘉孝中村龍治Shoda
9. Normative References
9. 引用規格
[DOM] V. Apparao, S. Byrne, M. Champion, S. Isaacs, I. Jacobs,
A. Le Hors, G. Nicol, J. Robie, R. Sutor, C. Wilson, and
L. Wood. "Document Object Model (DOM) Level 1
Specification", W3C Recommendation, October 1998,
<http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/>
[DOM] V.Apparao、S.バーン、M.チャンピオン、S.アイザックス、I.ジェイコブズ、A.Le Hors、G.ニコル、J.ロービー、R.Sutor、C.ウィルソン、およびL.木。 「文書オブジェクト・モデル(DOM)レベル1 仕様」、W3C推薦、1998年10月、<REC-DOM http://www.w3.org/TR/1998/レベル1-19981001/>。
[GVL] Fujimura, K. and M. Terada, "XML Voucher: Generic Voucher
Language", RFC 4153, September 2005.
[GVL] 藤村、K.、およびM.Terada、「XMLバウチャー:」 「一般的なバウチャー言語」、RFC4153、2005年9月。
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
[RFC2119] ブラドナー、S.、「Indicate Requirement LevelsへのRFCsにおける使用のためのキーワード」、BCP14、RFC2119、1997年3月。
10. Informative References
10. 有益な参照
[ECML] Eastlake 3rd, D., "Electronic Commerce Modeling Language
(ECML) Version 2 Specification", RFC 4112, June 2005.
[ECML] イーストレーク3番目、D.、「電子通商モデル言語(ECML)バージョン2仕様」、RFC4112、2005年6月。
[EXC-C14N] J. Boyer, D. Eastlake, and J. Reagle, "Exclusive XML
Canonicalization Version 1.0", W3C Recommendation, July
2002, <http://www.w3.org/TR/2002/REC-xml-exc-c14n-
20020718/>
[EXC-C14N] J.ボワイエ、D.イーストレーク、およびJ.Reagle、「排他的なXML Canonicalization、バージョン1インチ、W3C推薦、2002年7月、<http://www.w3.org/TR/2002/REC-xml-exc-c14n20020718/>、」
Terada & Fujimura Informational [Page 30] RFC 4154 VTS-API September 2005
[30ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
[GPSF] G. Lacoste, B. Pfitzmann, M. Steiner, and M. Waidner
(Eds.), "SEMPER - Secure Electronic Marketplace for
Europe," LNCS 1854, Springer-Verlag, 2000.
[GPSF] G.ラコステ、B.Pfitzmann、M.スタイナー、およびM.Waidner(Eds)、「ゼムパー--ヨーロッパにeマーケットプレイスを保証してください」、LNCS1854、追出石-Verlag、2000。
[IOTP] Burdett, D., "Internet Open Trading Protocol - IOTP
Version 1.0", RFC 2801, April 2000.
[IOTP]バーデット、D.、「インターネットの開いている取り引きプロトコル--、IOTP、バージョン1インチ、RFC2801、2000インチ年4月。
[JCC] T. Goldstein, "The Gateway Security Model in the Java
Electronic Commerce Framework", Proc. of Financial
Cryptography '97, 1997.
[JCC]T.ゴールドスティーン、「Java電子通商枠組みにおけるゲートウェイ機密保護モデル」Proc財政的な暗号1997 97年について。
[SHA-1] Department of Commerce/National Institute of Standards and
Technology, "FIPS PUB 180-1. Secure Hash Standard. U.S.",
<http://csrc.nist.gov/publications/fips/fips180-2/
fips180-2withchangenotice.pdf>
[SHA-1]商務省/米国商務省標準技術局、「FIPSパブ180-1。」 細切れ肉料理規格を保証してください。 「米国」、<http://csrc.nist.gov/刊行物/fips/fips180-2/fips180-2withchangenotice.pdf>。
[TLS] Dierks, T. and C. Allen, "The TLS Protocol Version 1.0",
RFC 2246, January 1999.
[TLS] Dierks、T.、およびC.アレン、「TLSは1999年1月にバージョン1インチ、RFC2246について議定書の中で述べます」。
[VTS] Fujimura, K. and D. Eastlake, "Requirements and Design for
Voucher Trading System (VTS)", RFC 3506, March 2003.
[VTS] 藤村、K.、およびD.イーストレーク、「バウチャー取引システム(VTS)のための要件とデザイン」(RFC3506)は2003を行進させます。
Authors' Addresses
作者のアドレス
Masayuki Terada NTT DoCoMo, Inc. 3-5 Hikari-no-oka, Yokosuka-shi, Kanagawa, 239-8536 JAPAN
光ノー、がokaしているMasayuki Terada株式会社NTTドコモ3-5横須賀市、239-8536神奈川(日本)
Phone: +81-(0)46-840-3809 Fax: +81-(0)46-840-3705 EMail: te@rex.yrp.nttdocomo.co.jp
以下に電話をしてください。 +81(0)46-840-3809Fax: +81 -(0) 46-840-3705 メールしてください: te@rex.yrp.nttdocomo.co.jp
Ko Fujimura NTT Corporation 1-1 Hikari-no-oka, Yokosuka-shi, Kanagawa, 239-0847 JAPAN
光ノー、がokaしているコー藤村NTT社1-1の横須賀市、239-0847神奈川(日本)
Phone: +81-(0)46-859-3053 Fax: +81-(0)46-859-1730 EMail: fujimura.ko@lab.ntt.co.jp
以下に電話をしてください。 +81(0)46-859-3053Fax: +81 -(0) 46-859-1730 メールしてください: fujimura.ko@lab.ntt.co.jp
Terada & Fujimura Informational [Page 31] RFC 4154 VTS-API September 2005
[31ページ]RFC4154VTS-API2005年9月の情報のTeradaと藤村
Full Copyright Statement
完全な著作権宣言文
Copyright (C) The Internet Society (2005).
Copyright(C)インターネット協会(2005)。
This document is subject to the rights, licenses and restrictions contained in BCP 78, and except as set forth therein, the authors retain all their rights.
このドキュメントはBCP78に含まれた権利、ライセンス、および制限を受けることがあります、そして、そこに詳しく説明されるのを除いて、作者は彼らのすべての権利を保有します。
This document and the information contained herein are provided on an "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
このドキュメントと「そのままで」という基礎と貢献者、その人が代表する組織で提供するか、または後援されて、インターネット協会とインターネット・エンジニアリング・タスク・フォースはすべての保証を放棄します、と急行ORが含意したということであり、他を含んでいて、ここに含まれて、情報の使用がここに侵害しないどんな保証も少しもまっすぐになるという情報か市場性か特定目的への適合性のどんな黙示的な保証。
Intellectual Property
知的所有権
The IETF takes no position regarding the validity or scope of any Intellectual Property Rights or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; nor does it represent that it has made any independent effort to identify any such rights. Information on the procedures with respect to rights in RFC documents can be found in BCP 78 and BCP 79.
IETFはどんなIntellectual Property Rightsの正当性か範囲、実現に関係すると主張されるかもしれない他の権利、本書では説明された技術の使用またはそのような権利の下におけるどんなライセンスも利用可能であるかもしれない、または利用可能でないかもしれない範囲に関しても立場を全く取りません。 または、それはそれを表しません。どんなそのような権利も特定するためのどんな独立している努力もしました。 BCP78とBCP79でRFCドキュメントの権利に関する手順に関する情報を見つけることができます。
Copies of IPR disclosures made to the IETF Secretariat and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementers or users of this specification can be obtained from the IETF on-line IPR repository at http://www.ietf.org/ipr.
IPR公開のコピーが利用可能に作られるべきライセンスの保証、または一般的な免許を取得するのが作られた試みの結果をIETF事務局といずれにもしたか、または http://www.ietf.org/ipr のIETFのオンラインIPR倉庫からこの仕様のimplementersかユーザによるそのような所有権の使用のために許可を得ることができます。
The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights that may cover technology that may be required to implement this standard. Please address the information to the IETF at ietf- ipr@ietf.org.
IETFはこの規格を実行するのに必要であるかもしれない技術をカバーするかもしれないどんな著作権もその注目していただくどんな利害関係者、特許、特許出願、または他の所有権も招待します。 ietf ipr@ietf.org のIETFに情報を記述してください。
Acknowledgement
承認
Funding for the RFC Editor function is currently provided by the Internet Society.
RFC Editor機能のための基金は現在、インターネット協会によって提供されます。
Terada & Fujimura Informational [Page 32]
Teradaと藤村Informationalです。[32ページ]
一覧
スポンサーリンク
