CreditCardValidator

Пакет	mx.validators
Класс	public class CreditCardValidator
Наследование	CreditCardValidator Validator EventDispatcher Object

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Класс CreditCardValidator проверяет длину номера кредитной карточки, правильный префикс и передачу алгоритма Luhn mod10 для указанного типа карты. Это средство проверки не проверяет фактическое существование активного счета кредитной карты.

Указать вводимые данные в CreditCardValidator можно двумя способами:

Используйте свойства cardNumberSource и cardNumberProperty для определения местоположения номера кредитной карты и свойства cardTypeSource и cardTypeProperty для определения местоположения типа проверяемой кредитной карты.
Используйте свойства source и property для определения одного объекта. Объект должен содержать следующие поля:
- cardType: указывает тип проверяемой кредитной карты.
  В MXML используются значения: American Express, Diners Club, Discover, MasterCard или Visa.
  
  В ActionScript используются статические константы CreditCardValidatorCardType.MASTER_CARD, CreditCardValidatorCardType.VISA или CreditCardValidatorCardType.AMERICAN_EXPRESS CreditCardValidatorCardType.DISCOVER или CreditCardValidatorCardType.DINERS_CLUB.
- cardNumber: указывает номер проверяемой карты.

Для выполнения проверки используются следующие рекомендации:

Длина:

Visa: 13 или 16 цифр
MasterCard: 16 цифр
Discover: 16 цифр
American Express: 15 цифр
Diners Club: 14 цифр или 16 цифр, если она функционирует так же, как MasterCard

Префикс:

Visa: 4
MasterCard: 51 – 55
Discover: 6011
American Express: 34 или 37
Diners Club: 300 – 305, 36 или 38, 51 – 55

Синтаксис MXML expanded

Скрыть синтаксис MXML

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." 
  />

Посмотреть примеры

Связанные элементы API

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
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object
		enabled : Boolean Установка этого значения на false помешает выполнению проверки средством проверки.	Validator
		invalidCharError : String Сообщение об ошибке при обнаружении поля cardNumber с недопустимыми символами.	CreditCardValidator
		invalidNumberError : String Сообщение об ошибке при обнаружении недопустимого номера кредитной карты.	CreditCardValidator
		listener : Object Указывает прослушиватель проверки.	Validator
		noNumError : String Сообщение об ошибке при обнаружении пустого поля cardNumber.	CreditCardValidator
		noTypeError : String Сообщение об ошибке при обнаружении пустого поля cardType.	CreditCardValidator
		property : String Строка с именем свойства для объекта source, содержащего проверяемое значение.	Validator
		required : Boolean = true Значение true указывает на то, что ошибка проверки вызвана отсутствующим или пустым значением.	Validator
		requiredFieldError : String Сообщение об ошибке, если значение отсутствует, а свойство required имеет значение true.	Validator
		source : Object Указывает объект, содержащий проверяемое свойство.	Validator
		trigger : IEventDispatcher Указывает компонент, генерирующий запускающее средство проверки событие.	Validator
		triggerEvent : String Указывает запускающее проверку событие.	Validator
		wrongLengthError : String Сообщение об ошибке при обнаружении поля cardNumber с неправильным количеством цифр для указанного типа кредитной карты.	CreditCardValidator
		wrongTypeError : String Сообщение об ошибке при обнаружении поля cardType с недопустимым типом кредитной карты.	CreditCardValidator

Защищенные свойства

Скрыть унаследованные защищенные свойства

Показать унаследованные защищенные свойства

	Свойство		Определено
		actualListeners : Array [только для чтения] Содержит массив объектов прослушивателей при их наличии или исходный объект.	Validator
		actualTrigger : IEventDispatcher [только для чтения] Содержит объект-триггер при его наличии или исходный объект.	Validator
		resourceManager : IResourceManager [только для чтения] Ссылка на объект, управляющий всеми локализованными ресурсами приложения.	Validator
		subFields : Array Массив строк, содержащий имена свойств из объекта value, переданного в метод validate().	Validator

Общедоступные методы

Скрыть унаследованные общедоступные методы

Показать унаследованные общедоступные методы

	Метод		Определено
		CreditCardValidator() Конструктор.	CreditCardValidator
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.	EventDispatcher
		dispatchEvent(event:Event):Boolean Посылает событие в поток событий.	EventDispatcher
		hasEventListener(type:String):Boolean Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.	EventDispatcher
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		initialized(document:Object, id:String):void Вызывается автоматически компилятором MXML при создании класса Validator с помощью тега MXML.	Validator
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Удаляет прослушиватель из объекта EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строковое представление заданного объекта.	Object
		validate(value:Object = null, suppressEvents:Boolean = false):ValidationResultEvent Выполняет проверку и дополнительно оповещает прослушиватели результата.	Validator
		validateAll(validators:Array):Array [статические] Вызывает все средства проверки в массиве validators.	Validator
		validateCreditCard(validator:CreditCardValidator, value:Object, baseField:String):Array [статические] Удобный метод для выполнения вызова средства проверки.	CreditCardValidator
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object
		willTrigger(type:String):Boolean Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.	EventDispatcher

Защищенные методы

Скрыть унаследованные защищенные методы

Показать унаследованные защищенные методы

	Метод		Определено
		addListenerHandler():void Настраивает все прослушиватели на события valid и invalid, передаваемые из средства проверки.	Validator
		doValidation(value:Object):Array [переопределить] Переопределяет метод базового класса doValidation() для проверки номера кредитной карты.	CreditCardValidator
		getValueFromSource():Object Возвращает проверяемый объект.	Validator
		handleResults(errorResults:Array):ValidationResultEvent Возвращает ValidationResultEvent из массива результатов ошибки.	Validator
		isRealValue(value:Object):Boolean Возвращает true, если value не имеет значения null.	Validator
		removeListenerHandler():void Отключает все прослушиватели для событий valid и invalid, передаваемых из средства проверки.	Validator
		resourcesChanged():void Этот метод вызывается при создании класса Validator и каждый раз при отправке ResourceManager события change для указания изменения локализованных ресурсов сходным образом.	Validator

События

Дополнительные сведения о событиях

Скрыть унаследованные события

Показать унаследованные события

	Сводка	Определено
activate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.	EventDispatcher
deactivate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.	EventDispatcher
invalid	Передается при сбое проверки.	Validator
valid	Передается при успешном завершении проверки.	Validator

Защищенные константы

Скрыть унаследованные защищенные константы

Показать унаследованные защищенные константы

	Константа		Определено

Сведения о свойстве

allowedFormatChars

свойство

allowedFormatChars:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Набор символов форматирования, допустимых в поле cardNumber.

Значением по умолчанию является " -" (space and dash).

Реализация
public function get allowedFormatChars():String
public function set allowedFormatChars(value:String):void

cardNumberListener

свойство

cardNumberListener:IValidatorListener

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Компонент, прослушивающий результат проверки подчиненного поля карты. Если он не указан, используется значение, указанное в свойстве cardNumberSource.

Реализация
public function get cardNumberListener():IValidatorListener
public function set cardNumberListener(value:IValidatorListener):void

cardNumberProperty

свойство

public var cardNumberProperty:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Имя свойства проверяемой кредитной карты. Этот атрибут является необязательным, но если указано свойство cardNumberSource, следует указать также и это свойство.

cardNumberSource

свойство

cardNumberSource:Object

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Объект, содержащий значение поля номера карты. Если для этого свойства указано значение, следует также определить значение свойства cardNumberProperty. Не используйте это свойство, если определены свойства source и property.

Реализация
public function get cardNumberSource():Object
public function set cardNumberSource(value:Object):void

cardTypeListener

свойство

cardTypeListener:IValidatorListener

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Компонент, прослушивающий результат проверки подчиненного поля типа карты. Если он не указан, то используется значение, указанное в свойстве cardTypeSource.

Реализация
public function get cardTypeListener():IValidatorListener
public function set cardTypeListener(value:IValidatorListener):void

cardTypeProperty

свойство

public var cardTypeProperty:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Имя свойства проверяемого типа карты. Этот атрибут является необязательным, но если определено свойство cardTypeSource, следует также указать это свойство.

В MXML допустимыми значениями являются:

American Express
Diners Club
Discover
MasterCard
Visa

В ActionScript для определения этого свойства можно использовать следующие константы:

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

Связанные элементы API

mx.validators.CreditCardValidatorCardType

cardTypeSource

свойство

cardTypeSource:Object

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Объект, содержащий значение поля типа карты. Если для этого свойства указано значение, следует также определить значение свойства cardTypeProperty. Не используйте это свойство, если определены свойства source и property.

Реализация
public function get cardTypeSource():Object
public function set cardTypeSource(value:Object):void

invalidCharError

свойство

invalidCharError:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Сообщение об ошибке при обнаружении поля cardNumber с недопустимыми символами.

Значением по умолчанию является "Invalid characters in your credit card number. (Enter numbers only.)".

Реализация
public function get invalidCharError():String
public function set invalidCharError(value:String):void

invalidNumberError

свойство

invalidNumberError:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Сообщение об ошибке при обнаружении недопустимого номера кредитной карты.

Значением по умолчанию является "The credit card number is invalid.".

Реализация
public function get invalidNumberError():String
public function set invalidNumberError(value:String):void

noNumError

свойство

noNumError:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Сообщение об ошибке при обнаружении пустого поля cardNumber.

Значением по умолчанию является "No credit card number is specified.".

Реализация
public function get noNumError():String
public function set noNumError(value:String):void

noTypeError

свойство

noTypeError:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Сообщение об ошибке при обнаружении пустого поля cardType.

Значением по умолчанию является "No credit card type is specified or the type is not valid.".

Реализация
public function get noTypeError():String
public function set noTypeError(value:String):void

wrongLengthError

свойство

wrongLengthError:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Сообщение об ошибке при обнаружении поля cardNumber с неправильным количеством цифр для указанного типа кредитной карты.

Значением по умолчанию является "Your credit card number contains the wrong number of digits.".

Реализация
public function get wrongLengthError():String
public function set wrongLengthError(value:String):void

wrongTypeError

свойство

wrongTypeError:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Сообщение об ошибке при обнаружении поля cardType с недопустимым типом кредитной карты. Для поля cardType следует использовать предопределенные константы: CreditCardValidatorCardType.MASTER_CARD, CreditCardValidatorCardType.VISA, CreditCardValidatorCardType.AMERICAN_EXPRESS, CreditCardValidatorCardType.DISCOVER или CreditCardValidatorCardType.DINERS_CLUB.

Значением по умолчанию является "Incorrect card type is specified.".

Реализация
public function get wrongTypeError():String
public function set wrongTypeError(value:String):void

Сведения о конструкторе

()

Конструктор

public function CreditCardValidator()

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Конструктор.

Сведения о методе

doValidation

()

метод

override protected function doValidation(value:Object):Array

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Переопределяет метод базового класса doValidation() для проверки номера кредитной карты.

Этот метод не вызывается напрямую; Flex вызывает его как часть выполнения проверки. Этот метод необходимо реализовать при создании пользовательского класса Validator.

Параметры

value:Object — проверяемый объект.

Возвращает

Array — Массив объектов ValidationResult с одним объектом ValidationResult для каждого поля, проверенного средством проверки.

validateCreditCard

()

метод

public static function validateCreditCard(validator:CreditCardValidator, value:Object, baseField:String):Array

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Удобный метод для выполнения вызова средства проверки. Каждое стандартное средство проверки 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 с одним объектом ValidationResult для каждого поля, проверенного средством проверки.

Связанные элементы API

mx.validators.ValidationResult

Примеры Использование этого примера

CreditCardValidatorExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the CreditCardValidator. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
        xmlns:s="library://ns.adobe.com/flex/spark"
        xmlns:mx="library://ns.adobe.com/flex/mx">

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

    <fx:Declarations>
        <!-- Define model for the credit card data. -->
        <fx:Model id="creditcard">
            <card>
                <cardType>{cardTypeCombo.selectedItem.data}</cardType>
                <cardNumber>{cardNumberInput.text}</cardNumber>
            </card>
        </fx: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!');"/>
    </fx:Declarations>

    <s:Panel title="CreditCardValidator Example"
            width="75%" height="75%"
            horizontalCenter="0" verticalCenter="0">
        <mx:Form id="creditCardForm" left="10" right="10" top="10" bottom="10">
            <mx:FormItem label="Card Type">
                <mx:ComboBox id="cardTypeCombo">
                    <mx:dataProvider>
                        <fx:Object label="American Express" data="American Express"/>
                        <fx:Object label="Diners Club" data="Diners Club"/>
                        <fx:Object label="Discover" data="Discover"/>
                        <fx:Object label="MasterCard" data="MasterCard"/>
                        <fx:Object label="Visa" data="Visa"/>
                    </mx:dataProvider>
                </mx:ComboBox>
            </mx:FormItem>
            <mx:FormItem label="Credit Card Number">
                <s:TextInput id="cardNumberInput"/>
            </mx:FormItem>
            <mx:FormItem>
                <s:Button id="myButton" label="Check Credit"/>
            </mx:FormItem>
        </mx:Form>
    </s:Panel>

</s:Application>

Юридическая информация | Политика конфиденциальности онлайн

CreditCardValidator - AS3 Flex

Пакетыx

Элементы языка

Приложения

Пакет mx.validators

allowedFormatChars

cardNumberListener

cardNumberProperty

cardNumberSource

cardTypeListener

cardTypeProperty

cardTypeSource

invalidCharError

invalidNumberError

noNumError

noTypeError

wrongLengthError

wrongTypeError