This page was saved using jaction on 2006-09-04 8:33:34.
Address: http://flexdocs.kr/docs/flex2/langref/mx/validators/CreditCardValidator.html
Title: mx.validators.CreditCardValidator (Flex™ 2 레퍼런스 가이드)  •  Size: 71820
Packagemx.validators
Classpublic class CreditCardValidator
InheritanceCreditCardValidator 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. Diners Club :MasterCard 라고 해도 사용할 수 있는 경우는, 14 자리수 또는 16 자리수입니다.
접두사 :
  1. Visa : 4
  2. MasterCard :52 ~ 55
  3. Discover : 6011
  4. American Express :34 또는 37
  5. Diners Club :300 ~ 305, 36, 또는 38, 51 ~ 55

MXML 문장구조법expandedMXML 문장구조법의 비표시

<mx:CreditCardValidator> 태그는, Super 클래스의 모든 태그 속성을 Inheritance해, 다음의 태그 속성을 추가합니다. 

 <mx:CreditCardValidator allowedFormatChars=" -" cardNumberListener="Object specified by cardNumberSource" cardNumberProperty="디폴트치 없음" cardNumberSource="디폴트치 없음" cardTypeListener="cardTypeSource 로 지정된 object" cardTypeProperty="디폴트치 없음" cardTypeSource="No default" invalidCharError= "Invalid characters in your credit card number. (Only enter numbers. )" invalidNumberError="The credit card number is invalid. " noNumError="No credit card number specified. " noTypeError="No credit card type specified or the type is not valid. " wrongLengthError="Your credit card number contains the wrong number of digits. " wrongTypeError="Incorrect card type specified. "/>

View the examples

See also

mx.validators.CreditCardValidatorCardType

Public property
 property정의
  allowedFormatChars : String
cardNumber 필드에서 사용할 수 있는 서식 캐릭터세트를 나타냅니다.
CreditCardValidator
  cardNumberListener : IValidatorListener
카드 번호 subfield의 검증 결과를 받는 컴퍼넌트를 나타냅니다.
CreditCardValidator
  cardNumberProperty : String
검증하는 카드 번호 property의 이름을 나타냅니다.
CreditCardValidator
  cardNumberSource : Object
카드 번호 필드의 값을 포함한 object를 나타냅니다.
CreditCardValidator
  cardTypeListener : IValidatorListener
카드의 종류를 나타내는 subfield의 검증 결과를 받는 컴퍼넌트를 나타냅니다.
CreditCardValidator
  cardTypeProperty : String
검증하는 카드의 종류를 나타내는 property의 이름을 나타냅니다.
CreditCardValidator
  cardTypeSource : Object
카드의 종류를 지정하는 필드의 값을 포함한 object를 나타냅니다.
CreditCardValidator
 Inheritedconstructor : Object
특정의 object 인스턴스의 클래스 object 또는 constructor　 　 함수에의 참조입니다.
Object
 Inheritedenabled : Boolean
이 값을 false 로 설정하면, 발리 데이터에 의한 검증을 실시할 수 없게 됩니다.
Validator
  invalidCharError : String
cardNumber 필드에 무효인 캐릭터가 포함되어 있는 경우에 발생하는 에러 메세지를 나타냅니다.
CreditCardValidator
  invalidNumberError : String
크레디트 카드 번호가 무효가 되어 있는 경우에 발생하는 에러 메세지를 나타냅니다.
CreditCardValidator
 Inheritedlistener : Object
검증의 listener를 지정합니다.
Validator
  noNumError : String
cardNumber 필드가 empty의 경우에 발생하는 에러 메세지를 나타냅니다.
CreditCardValidator
  noTypeError : String
cardType 필드가 empty의 경우에 발생하는 에러 메세지를 나타냅니다.
CreditCardValidator
 Inheritedproperty : String
검증하는 값을 포함한 source object의 property의 이름을 지정하는 string를 나타냅니다.
Validator
 Inheritedprototype : Object
[static] 클래스 또는 함수 object의 prototype object에의 참조입니다.
Object
 Inheritedrequired : Boolean
true 의 경우, 검증 에러의 원인이 되는 결손치 또는 거짓 가격을 지정합니다.
Validator
 InheritedrequiredFieldError : String
값이 결손해, 게다가 required property가 true 의 경우에 발생하는 에러 메세지입니다.
Validator
 Inheritedsource : Object
검증하는 property를 포함한 object를 지정합니다.
Validator
 Inheritedtrigger : IEventDispatcher
발리 데이터를 방아쇠 하는 이벤트의 생성을 실시하는 컴퍼넌트를 지정합니다.
Validator
 InheritedtriggerEvent : String
검증을 방아쇠 하는 이벤트를 지정합니다.
Validator
  wrongLengthError : String
지정된 크레디트 카드의 종류에 대응하고 있지 않는 자리수의 번호가 cardNumber 필드에 포함되는 경우에 발생하는 에러 메세지를 나타냅니다.
CreditCardValidator
  wrongTypeError : String
cardType 필드에 무효인 크레디트 카드의 종류가 포함되는 경우에 발생하는 에러 메세지를 나타냅니다.
CreditCardValidator
Protected property
 property정의
 InheritedactualListeners : Array
listener objects가 존재하는 경우는 listener objects를 포함합니다. 그렇지 않은 경우는, 소스 object를 포함합니다.
Validator
 InheritedactualTrigger : IEventDispatcher
방아쇠 object가 존재하는 경우는 방아쇠 object를 포함합니다. 그렇지 않은 경우는, 소스 object를 포함합니다.
Validator
 InheritedsubFields : Array
validate() Methods에게 건네진 value object에 포함되는 property명을 포함한 string의 배열입니다.
Validator
Public Methods
 Methods정의
  CreditCardValidator ()
constructor　 　.
CreditCardValidator
 InheritedaddEventListener (type:String , listener:Function , useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
event listener objects를 EventDispatcher object에 등록해, listener가 이벤트의 통지를 받도록(듯이) 합니다.
EventDispatcher
 InheriteddispatchEvent (event:Event ):Boolean
이벤트를 event 플로우(flow)에 dispatch합니다.
EventDispatcher
 InheritedhasEventListener (type:String ):Boolean
EventDispatcher object에, 특정의 event 타입에 대해서 등록된 listener가 있을지 어떨지를 확인합니다.
EventDispatcher
 InheritedhasOwnProperty (name:String ):Boolean
object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.
Object
 Inheritedinitialized (document:Object , id:String ):void
MXML 태그를 사용해 발리 데이터를 작성했을 때에, MXML 컴파일러에 의해 자동적으로 불려 갑니다.
Validator
 InheritedisPrototypeOf (theClass:Object ):Boolean
Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.
Object
 InheritedpropertyIsEnumerable (name:String ):Boolean
지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.
Object
 InheritedremoveEventListener (type:String , listener:Function , useCapture:Boolean = false):void
EventDispatcher object로부터 listener를 삭제합니다.
EventDispatcher
 InheritedsetPropertyIsEnumerable (name:String , isEnum:Boolean = true):void
루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.
Object
 InheritedtoString ():String
지정된 object의 string 표현을 돌려줍니다.
Object
 Inheritedvalidate (value:Object = null, suppressEvents:Boolean = false):ValidationResultEvent
검증을 실행해, 그 결과의 listener를 임의로 통지합니다.
Validator
 InheritedvalidateAll (validators:Array ):Array
[static] validators 배열에 포함되는 모든 발리 데이터를 호출합니다.
Validator
  validateCreditCard (validator:CreditCardValidator , value:Object , baseField:String ):Array
[static] 발리 데이터를 호출하는데 있어서 편리한 Methods입니다.
CreditCardValidator
 InheritedvalueOf ():Object
지정된 object의 원시적치를 돌려줍니다.
Object
 InheritedwillTrigger (type:String ):Boolean
지정된 event 타입에 대해, 이 EventDispatcher object 또는 그 조상에게 event listener가 등록되어 있는지 어떤지를 확인합니다.
EventDispatcher
Protected Methods
 Methods정의
 InheritedaddListenerHandler ():void
발리 데이터로부터 dispatch된 valid event 및 invalid 이벤트의 모든 listener를 설정합니다.
Validator
  doValidation (value:Object ):Array
크레디트 카드 번호의 타당성을 검증하는데 있어서 기본 클래스의 doValidation() Methods를 재정의(override) 합니다.
CreditCardValidator
 InheritedgetValueFromSource ():Object
검증하는 object를 돌려줍니다.
Validator
 InheritedhandleResults (errorResults:Array ):ValidationResultEvent
에러 결과의 배열로부터 ValidationResultEvent 를 돌려줍니다.
Validator
 InheritedisRealValue (value:Object ):Boolean
value 가 null 의 경우,true 를 돌려줍니다.
Validator
 InheritedremoveListenerHandler ():void
발리 데이터로부터 dispatch된 valid event 및 invalid 이벤트의 모든 listener를 절단 합니다.
Validator
이벤트
 이벤트일람정의
 Inheritedinvalid 검증이 실패하면 dispatch됩니다. Validator
 Inheritedvalid 검증이 정상적으로 완료하면 dispatch됩니다. Validator
Protected 정수
 정수정의
 InheritedDECIMAL_DIGITS : String = "0123456789"
[static] 0 에서 9 의 10 진수자를 포함한 string입니다.
Validator
 InheritedROMAN_LETTERS : String = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz"
[static] 로마자 알파벳의 대문자와 소문자를 포함한 string입니다 ("A" 로부터 "Z", 및 "a" 로부터 "z").
Validator
property의 상세
allowedFormatCharsproperty
allowedFormatChars:String   [read-write]

cardNumber 필드에서 사용할 수 있는 서식 캐릭터세트를 나타냅니다.

디폴트치" -" (space and dash).

Implements
    public function get allowedFormatChars():String
    public function set allowedFormatChars(value:String ):void
cardNumberListenerproperty 
cardNumberListener:IValidatorListener   [read-write]

카드 번호 subfield의 검증 결과를 받는 컴퍼넌트를 나타냅니다. 아무것도 지정되어 있지 않은 경우,cardNumberSource property로 지정된 값이 사용됩니다.

Implements
    public function get cardNumberListener():IValidatorListener
    public function set cardNumberListener(value:IValidatorListener ):void
cardNumberPropertyproperty 
public var cardNumberProperty:String

검증하는 카드 번호 property의 이름을 나타냅니다. 이 속성은 옵션입니다만,cardNumberSource property를 지정하는 경우는, 이 property도 설정할 필요가 있습니다.

cardNumberSourceproperty 
cardNumberSource:Object   [read-write]

카드 번호 필드의 값을 포함한 object를 나타냅니다. 이 property의 값을 지정하는 경우는,cardNumberProperty property에도 값을 지정할 필요가 있습니다. source property 및 property property를 사용하는 경우는, 이 property를 설정하지 말아 주세요.

Implements
    public function get cardNumberSource():Object
    public function set cardNumberSource(value:Object ):void
cardTypeListenerproperty 
cardTypeListener:IValidatorListener   [read-write]

카드의 종류를 나타내는 subfield의 검증 결과를 받는 컴퍼넌트를 나타냅니다. 아무것도 지정되어 있지 않은 경우,cardTypeSource property로 지정된 값이 사용됩니다.

Implements
    public function get cardTypeListener():IValidatorListener
    public function set cardTypeListener(value:IValidatorListener ):void
cardTypePropertyproperty 
public var cardTypeProperty:String

검증하는 카드의 종류를 나타내는 property의 이름을 나타냅니다. 이 속성은 옵션입니다만,cardTypeSource property를 지정하는 경우는, 이 property도 설정할 필요가 있습니다.

MXML 에서는, 다음의 값을 지정할 수 있습니다.

ActionScript 에서는, 이 property를 설정하기 위해서 다음의 정수를 사용할 수 있습니다.

CreditCardValidatorCardType.AMERICAN_EXPRESS,CreditCardValidatorCardType.DINERS_CLUB,CreditCardValidatorCardType.DISCOVER,CreditCardValidatorCardType.MASTER_CARD, 및 CreditCardValidatorCardType.VISA.

See also

mx.validators.CreditCardValidatorCardType
cardTypeSourceproperty 
cardTypeSource:Object   [read-write]

카드의 종류를 지정하는 필드의 값을 포함한 object를 나타냅니다. 이 property의 값을 지정하는 경우는,cardTypeProperty property에도 값을 지정할 필요가 있습니다. source property 및 property property를 사용하는 경우는, 이 property를 설정하지 말아 주세요.

Implements
    public function get cardTypeSource():Object
    public function set cardTypeSource(value:Object ):void
invalidCharErrorproperty 
public var invalidCharError:String

cardNumber 필드에 무효인 캐릭터가 포함되어 있는 경우에 발생하는 에러 메세지를 나타냅니다.

디폴트치"Invalid characters in your credit card number. (Enter numbers only. )".

invalidNumberErrorproperty 
public var invalidNumberError:String

크레디트 카드 번호가 무효가 되어 있는 경우에 발생하는 에러 메세지를 나타냅니다.

디폴트치"The credit card number is invalid. ".

noNumErrorproperty 
public var noNumError:String

cardNumber 필드가 empty의 경우에 발생하는 에러 메세지를 나타냅니다.

디폴트치"No credit card number is specified. ".

noTypeErrorproperty 
public var noTypeError:String

cardType 필드가 empty의 경우에 발생하는 에러 메세지를 나타냅니다.

디폴트치"No credit card type is specified or the type is not valid. ".

wrongLengthErrorproperty 
public var wrongLengthError:String

지정된 크레디트 카드의 종류에 대응하고 있지 않는 자리수의 번호가 cardNumber 필드에 포함되는 경우에 발생하는 에러 메세지를 나타냅니다.

디폴트치"Your credit card number contains the wrong number of digits. ".

wrongTypeErrorproperty 
public var wrongTypeError:String

cardType 필드에 무효인 크레디트 카드의 종류가 포함되는 경우에 발생하는 에러 메세지를 나타냅니다. cardType 필드에는, 미리 정의된 다음의 정수를 사용할 필요가 있습니다. CreditCardValidatorCardType.MASTER_CARD,CreditCardValidatorCardType.VISA,CreditCardValidatorCardType.AMERICAN_EXPRESS,CreditCardValidatorCardType.DISCOVER, 또는 CreditCardValidatorCardType.DINERS_CLUB.

디폴트치"Incorrect card type is specified. ".

constructor　 　 의 상세
CreditCardValidator()constructor　 　
public 함수 CreditCardValidator()

constructor　 　.

Methods의 상세
doValidation()Methods
protected override function doValidation(value:Object ):Array

크레디트 카드 번호의 타당성을 검증하는데 있어서 기본 클래스의 doValidation() Methods를 재정의(override) 합니다.

이 Methods는 유저가 직접 호출하는 것은 아니고, 타당성을 검증할 때에 Flex 로부터 불려 갑니다. Validator 클래스를 커스텀으로 작성하는 경우는, 이 Methods를 Implements할 필요가 있습니다.

Parameters
value:Object — 검증하는 object입니다.

반환값
Array — ValidationResult object의 배열입니다. 이 object는, 검증을 하는 필드 마다 1 개 포함됩니다.
validateCreditCard()Methods 
public static function validateCreditCard(validator:CreditCardValidator , value:Object , baseField:String ):Array

발리 데이터를 호출하는데 있어서 편리한 Methods입니다. 다른 표준 Flex 발리 데이터에도 각각 같은 편리한 Methods가 있습니다.

Parameters
validator:CreditCardValidator — CreditCardValidator 인스턴스를 나타냅니다.
 
value:Object — 검증하는 필드이며, 그 다음의 필드를 포함할 필요가 있습니다.
  • cardType - 검증하는 크레디트 카드의 종류를 지정합니다. 정적 정수 CreditCardValidatorCardType.MASTER_CARD,CreditCardValidatorCardType.VISA,CreditCardValidatorCardType.AMERICAN_EXPRESS,CreditCardValidatorCardType.DISCOVER, 또는 CreditCardValidatorCardType.DINERS_CLUB 를 사용합니다.
  • cardNumber - 검증하는 카드의 번호를 지정합니다.
 
baseField:String — value Parameters로 지정한 subfield의 텍스트의 형태를 나타냅니다. 예를 들어,value Parameters로 value.date 를 지정하는 경우,baseField 의 값은 "date" 입니다.

반환값
Array — ValidationResult object의 배열입니다. 이 object는, 검증을 하는 필드 마다 1 개 포함됩니다.

See also

mx.validators.ValidationResult
Examples
CreditCardValidatorExample
<? 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>



© 2004-2006 Adobe Systems Incorporated. All rights reserved.
2006.08. 17, 오후 11:21, GMT-07:00


 

코멘트가 추가되었을 경우, 메일로 받기. | 코멘트 리포트

현재의 페이지: http://flexdocs.kr/docs/flex2/langref/mx/validators/CreditCardValidator.html