パッケージmx.validators
クラスpublic class CreditCardValidator
継承CreditCardValidator Inheritance Validator Inheritance EventDispatcher Inheritance Object

CreditCardValidator クラスは、クレジットカード番号が正しい長さで、かつ正しい接頭辞で始まっていることを検証し、指定されたカードタイプ用の Luhn mod10 アルゴリズムを渡します。 検証では、クレジットカードが実際に有効なクレジットカードアカウントであるかどうかはチェックされません。

CreditCardValidator への入力を次の 2 通りの方法で行うことができます。

検証時には、次のガイドラインが使用されます。

長さ：

  1. Visa：13 または 16 桁
  2. MasterCard：16 桁
  3. Discover：16 桁
  4. American Express：15 桁
  5. DinersClub：14 桁、MasterCard としても機能する場合は 16 桁
接頭辞：
  1. Visa：4
  2. MasterCard：51 ～ 55
  3. Discover：6011
  4. American Express：34 または 37
  5. Diners Club：300 ～ 305、36 または 38、51 ～ 55

MXML のシンタックスexpandedMXML シンタックスを隠す

The <mx:CreditCardValidator> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:CreditCardValidator
    allowedFormatChars=" -" 
    cardNumberListener="Object specified by cardNumberSource"
    cardNumberProperty="No default"
    cardNumberSource="No default"
    cardTypeListener="Object specified by cardTypeSource"
    cardTypeProperty="No default"
    cardTypeSource="No default"
    invalidCharError= "Invalid characters in your credit card number. (Enter numbers only.)"
    invalidNumberError="The credit card number is invalid." 
    noNumError="No credit card number is specified."
    noTypeError="No credit card type is specified or the type is not valid." 
    wrongLengthError="Your credit card number contains the wrong number of digits." 
    wrongTypeError="Incorrect card type is specified." 
  />

例を表示

関連項目

mx.validators.CreditCardValidatorCardType

パブリックプロパティ
 プロパティ定義元
  allowedFormatChars : String
cardNumber フィールドで使用できる書式文字のセットを表します。
CreditCardValidator
  cardNumberListener : IValidatorListener
カード番号サブフィールドの検証結果をリッスンするコンポーネントを表します。
CreditCardValidator
  cardNumberProperty : String
検証するカード番号プロパティの名前を表します。
CreditCardValidator
  cardNumberSource : Object
カード番号フィールドの値を含むオブジェクトを表します。
CreditCardValidator
  cardTypeListener : IValidatorListener
カードの種類を示すサブフィールドの検証結果をリッスンするコンポーネントを表します。
CreditCardValidator
  cardTypeProperty : String
検証するカードの種類を示すプロパティの名前を表します。
CreditCardValidator
  cardTypeSource : Object
カードの種類を指定するフィールドの値を含むオブジェクトを表します。
CreditCardValidator
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
 Inheritedenabled : Boolean
この値を false に設定すると、バリデータによる検証が行えなくなります。
Validator
  invalidCharError : String
cardNumber フィールドに無効な文字が含まれている場合に発生するエラーメッセージを表します。
CreditCardValidator
  invalidNumberError : String
クレジットカード番号が無効になっている場合に発生するエラーメッセージを表します。
CreditCardValidator
 Inheritedlistener : Object
検証のリスナーを指定します。
Validator
  noNumError : String
cardNumber フィールドが空の場合に発生するエラーメッセージを表します。
CreditCardValidator
  noTypeError : String
cardType フィールドが空の場合に発生するエラーメッセージを表します。
CreditCardValidator
 Inheritedproperty : String
検証する値を含む source オブジェクトのプロパティの名前を指定するストリングを表します。
Validator
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
 Inheritedrequired : Boolean = true
true の場合、検証エラーの原因となる欠損値または空値を指定します。
Validator
 InheritedrequiredFieldError : String
値が欠損し、required プロパティが true の場合に発生するエラーメッセージです。
Validator
 Inheritedsource : Object
検証するプロパティを含むオブジェクトを指定します。
Validator
 Inheritedtrigger : IEventDispatcher
バリデータをトリガするイベントの生成を行うコンポーネントを指定します。
Validator
 InheritedtriggerEvent : String
検証をトリガするイベントを指定します。
Validator
  wrongLengthError : String
指定されたクレジットカードの種類に対応していない桁数の番号が cardNumber フィールドに含まれる場合に発生するエラーメッセージを表します。
CreditCardValidator
  wrongTypeError : String
cardType フィールドに無効なクレジットカードの種類が含まれる場合に発生するエラーメッセージを表します。
CreditCardValidator
プロテクトプロパティ
 プロパティ定義元
 InheritedactualListeners : Array
[読み取り専用] リスナーオブジェクトが存在する場合はリスナーオブジェクトを含みます。そうでない場合は、ソースオブジェクトを含みます。
Validator
 InheritedactualTrigger : IEventDispatcher
[読み取り専用] トリガオブジェクトが存在する場合はトリガオブジェクトを含みます。そうでない場合は、ソースオブジェクトを含みます。
Validator
 InheritedresourceManager : IResourceManager
[読み取り専用] アプリケーションのローカライズされたすべてのリソースを管理するオブジェクトへの参照です。
Validator
 InheritedsubFields : Array
validate() メソッドに渡された value オブジェクトに含まれるプロパティ名を含むストリングの配列です。
Validator
パブリックメソッド
 メソッド定義元
  
CreditCardValidator()
コンストラクタです。
CreditCardValidator
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
EventDispatcher
 Inherited
dispatchEvent(event:Event):Boolean
イベントをイベントフローに送出します。
EventDispatcher
 Inherited
hasEventListener(type:String):Boolean
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
initialized(document:Object, id:String):void
MXML タグを使用してバリデータを作成したときに、MXML コンパイラによって自動的に呼び出されます。
Validator
 Inherited
isPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
toString():String
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
validate(value:Object = null, suppressEvents:Boolean = false):ValidationResultEvent
検証を実行し、リスナーに任意で結果を通知します。
Validator
 Inherited
validateAll(validators:Array):Array
[静的] validators 配列に含まれるすべてのバリデータを呼び出します。
Validator
  
validateCreditCard(validator:CreditCardValidator, value:Object, baseField:String):Array
[静的] バリデータを呼び出す上で便利なメソッドです。
CreditCardValidator
 Inherited
valueOf():Object
指定されたオブジェクトのプリミティブな値を返します。
Object
 Inherited
willTrigger(type:String):Boolean
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
プロテクトメソッド
 メソッド定義元
 Inherited
addListenerHandler():void
バリデータから送出された valid イベントおよび invalid イベントのすべてのリスナーを設定します。
Validator
  
doValidation(value:Object):Array
[override] クレジットカード番号の妥当性を検証する上で基本クラスの doValidation() メソッドをオーバーライドします。
CreditCardValidator
 Inherited
getValueFromSource():Object
検証するオブジェクトを返します。
Validator
 Inherited
handleResults(errorResults:Array):ValidationResultEvent
エラー結果の配列から ValidationResultEvent を返します。
Validator
 Inherited
isRealValue(value:Object):Boolean
value が null でない場合、true を返します。
Validator
 Inherited
removeListenerHandler():void
バリデータから送出された valid イベントおよび invalid イベントのすべてのリスナーを切断します。
Validator
 Inherited
resourcesChanged():void
このメソッドは、バリデータが作成されたときと、ResourceManager が "change" イベントを送出してローカライズされたリソースが何らかの点で変更されたことを示すときに再び呼び出されます。
Validator
イベント
 イベント 概要 定義元
 Inherited
activate
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
 Inherited
deactivate
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
 Inherited
invalid
検証が失敗すると送出されます。Validator
 Inherited
valid
検証が正常に完了すると送出されます。Validator
プロテクト定数
 定数定義元
 InheritedDECIMAL_DIGITS : String = "0123456789"
[静的] 0 から 9 の 10 進数字を含むストリングです。
Validator
 InheritedROMAN_LETTERS : String = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz"
[静的] ローマ字アルファベットの大文字と小文字を含む（"A" から "Z"、および "a" から "z"）ストリングです。
Validator
プロパティの詳細
allowedFormatCharsプロパティ
allowedFormatChars:String

cardNumber フィールドで使用できる書式文字のセットを表します。

デフォルト値 : " -" (スペースとダッシュ).



実装
    public function get allowedFormatChars():String
    public function set allowedFormatChars(value:String):void
cardNumberListenerプロパティ 
cardNumberListener:IValidatorListener

カード番号サブフィールドの検証結果をリッスンするコンポーネントを表します。 何も指定されていない場合、cardNumberSource プロパティに指定された値が使用されます。



実装
    public function get cardNumberListener():IValidatorListener
    public function set cardNumberListener(value:IValidatorListener):void
cardNumberPropertyプロパティ 
public var cardNumberProperty:String

検証するカード番号プロパティの名前を表します。 この属性はオプションですが、cardNumberSource プロパティを指定する場合は、このプロパティも設定する必要があります。

cardNumberSourceプロパティ 
cardNumberSource:Object

カード番号フィールドの値を含むオブジェクトを表します。 このプロパティの値を指定する場合は、cardNumberProperty プロパティにも値を指定する必要があります。 source プロパティおよび property プロパティを設定する場合は、このプロパティを使用しないでください。



実装
    public function get cardNumberSource():Object
    public function set cardNumberSource(value:Object):void
cardTypeListenerプロパティ 
cardTypeListener:IValidatorListener

カードの種類を示すサブフィールドの検証結果をリッスンするコンポーネントを表します。 何も指定されていない場合、cardTypeSource プロパティに指定された値が使用されます。



実装
    public function get cardTypeListener():IValidatorListener
    public function set cardTypeListener(value:IValidatorListener):void
cardTypePropertyプロパティ 
public var cardTypeProperty:String

検証するカードの種類を示すプロパティの名前を表します。 この属性はオプションですが、cardTypeSource プロパティを指定する場合は、このプロパティも設定する必要があります。

MXML で、次の値を指定できます。

ActionScript では、このプロパティを設定するために次の定数を使用できます。

CreditCardValidatorCardType.AMERICAN_EXPRESS,、CreditCardValidatorCardType.DINERS_CLUB、 CreditCardValidatorCardType.DISCOVER、CreditCardValidatorCardType.MASTER_CARD および CreditCardValidatorCardType.VISA。

関連項目

mx.validators.CreditCardValidatorCardType
cardTypeSourceプロパティ 
cardTypeSource:Object

カードの種類を指定するフィールドの値を含むオブジェクトを表します。 このプロパティの値を指定する場合は、cardTypeProperty プロパティにも値を指定する必要があります。 source プロパティおよび property プロパティを設定する場合は、このプロパティを使用しないでください。



実装
    public function get cardTypeSource():Object
    public function set cardTypeSource(value:Object):void
invalidCharErrorプロパティ 
invalidCharError:String

cardNumber フィールドに無効な文字が含まれている場合に発生するエラーメッセージを表します。

デフォルト値 : "クレジットカード番号の文字が無効です(数値のみを入力してください)。".



実装
    public function get invalidCharError():String
    public function set invalidCharError(value:String):void
invalidNumberErrorプロパティ 
invalidNumberError:String

クレジットカード番号が無効になっている場合に発生するエラーメッセージを表します。

デフォルト値 : "クレジットカード番号が無効です。".



実装
    public function get invalidNumberError():String
    public function set invalidNumberError(value:String):void
noNumErrorプロパティ 
noNumError:String

cardNumber フィールドが空の場合に発生するエラーメッセージを表します。

デフォルト値 : "クレジットカード番号が指定されていません。".



実装
    public function get noNumError():String
    public function set noNumError(value:String):void
noTypeErrorプロパティ 
noTypeError:String

cardType フィールドが空の場合に発生するエラーメッセージを表します。

デフォルト値 : "クレジットカードの種類が指定されていないか、有効ではありません。".



実装
    public function get noTypeError():String
    public function set noTypeError(value:String):void
wrongLengthErrorプロパティ 
wrongLengthError:String

指定されたクレジットカードの種類に対応していない桁数の番号が cardNumber フィールドに含まれる場合に発生するエラーメッセージを表します。

デフォルト値 : "クレジットカード番号の桁数が正しくありません。".



実装
    public function get wrongLengthError():String
    public function set wrongLengthError(value:String):void
wrongTypeErrorプロパティ 
wrongTypeError:String

cardType フィールドに無効なクレジットカードの種類が含まれる場合に発生するエラーメッセージを表します。 cardType フィールドには、あらかじめ定義された次の定数を使用する必要があります。CreditCardValidatorCardType.MASTER_CARD、CreditCardValidatorCardType.VISA、CreditCardValidatorCardType.AMERICAN_EXPRESS、CreditCardValidatorCardType.DISCOVER または CreditCardValidatorCardType.DINERS_CLUB。

デフォルト値 : "指定されたカードの種類が正しくありません。".



実装
    public function get wrongTypeError():String
    public function set wrongTypeError(value:String):void
コンストラクタの詳細
CreditCardValidator()コンストラクタ
public function CreditCardValidator()

コンストラクタです。

メソッドの詳細
doValidation()メソッド
override protected function doValidation(value:Object):Array

クレジットカード番号の妥当性を検証する上で基本クラスの doValidation() メソッドをオーバーライドします。

このメソッドはユーザーが直接呼び出すものではなく、妥当性を検証する際に Flex から呼び出されます。 Validator クラスをカスタムで作成する場合は、このメソッドを実装する必要があります。

パラメータ

value:Object — 検証するオブジェクトです。

戻り値
Array — ValidationResult オブジェクトの配列です。このオブジェクトは、検証が行われるフィールドごとに 1 つ含まれます。
validateCreditCard()メソッド 
public static function validateCreditCard(validator:CreditCardValidator, value:Object, baseField:String):Array

バリデータを呼び出す上で便利なメソッドです。 他の標準 Flex バリデータにもそれぞれ同様の便利なメソッドがあります。

パラメータ

validator:CreditCardValidator — CreditCardValidator インスタンスを表します。
 
value:Object — 検証するフィールドであり、その次のフィールドを含む必要があります。
  • cardType - 検証するクレジットカードの種類を指定します。 静的定数 CreditCardValidatorCardType.MASTER_CARD、CreditCardValidatorCardType.VISA、CreditCardValidatorCardType.AMERICAN_EXPRESS、CreditCardValidatorCardType.DISCOVER または CreditCardValidatorCardType.DINERS_CLUB を使用します。
  • cardNumber - 検証するカードの番号を指定します。
 
baseField:String — value パラメータで指定したサブフィールドのテキストの型を表します。 例えば、value パラメータで value.date を指定する場合、baseField の値は "date" です。

戻り値
Array — ValidationResult オブジェクトの配列です。このオブジェクトは、検証が行われるフィールドごとに 1 つ含まれます。

関連項目

mx.validators.ValidationResult
例 例の使用法
CreditCardValidatorExample.mxml
<?xml version="1.0"?>
<!-- Simple example to demonstrate the CreditCardValidator. -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">

    <mx:Script>
        import mx.controls.Alert;
    </mx:Script>

    <!-- Define model for the credit card data. -->
    <mx:Model id="creditcard">
        <card>    
            <cardType>{cardTypeCombo.selectedItem.data}</cardType>
            <cardNumber>{cardNumberInput.text}</cardNumber>
        </card>
    </mx:Model>

    <mx:CreditCardValidator id="ccV" 
        cardTypeSource="{creditcard}" cardTypeProperty="cardType"
        cardNumberSource="{creditcard}" cardNumberProperty="cardNumber"
        trigger="{myButton}" triggerEvent="click"
        cardTypeListener="{cardTypeCombo}"
        cardNumberListener="{cardNumberInput}"
        valid="Alert.show('Validation Succeeded!');"/>
  
    <mx:Panel title="CreditCardValidator Example" width="75%" height="75%" 
        paddingTop="10" paddingLeft="10" paddingRight="10" paddingBottom="10">

        <mx:Form id="creditCardForm">
            <mx:FormItem label="Card Type">    
                <mx:ComboBox id="cardTypeCombo">
                    <mx:dataProvider>
                        <mx:Object label="American Express" data="American Express"/>
                        <mx:Object label="Diners Club" data="Diners Club"/>
                        <mx:Object label="Discover" data="Discover"/>
                        <mx:Object label="MasterCard" data="MasterCard"/>
                        <mx:Object label="Visa" data="Visa"/>
                    </mx:dataProvider>
                </mx:ComboBox>
            </mx:FormItem>
            <mx:FormItem label="Credit Card Number">
                <mx:TextInput id="cardNumberInput"/>
            </mx:FormItem>
            <mx:FormItem>
                <mx:Button id="myButton" label="Check Credit"/>
            </mx:FormItem>
        </mx:Form>     
        
    </mx:Panel>    
</mx:Application>



© 2009 Adobe Systems Incorporated. All rights reserved.
Thu Mar 19 2009, 08:51 PM -07:00
 

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/mx/validators/CreditCardValidator.html