Книга
← К списку книгЗагрузка разделов…
активнаАктивные записи участвуют в каталоге и синках. Неактивная книга скрыта, но не удалена из базы.
Книга
Глава 1. Основные понятия36
Глава 2. Условные операторы и циклы80
Глава 3. Пересмотр методов экземпляра100
Глава 4. Статические переменные и методы115
Глава 5. Функции126
Глава 6. Наследование141
Глава 7. Компиляция и выполнение программы172
Глава 8. Типы данных и проверка типов180
Глава 9. Интерфейсы203
Глава 10. Инструкции и операторы217
Глава 11. Массивы229
Глава 12. События и обработка событий246
Глава 13. Обработка исключений и ошибок288
Глава 14. Сборка мусора317
Глава 15. Динамические возможности языка ActionScript328
Глава 16. Область видимости345
Глава 17. Пространства имен354
Глава 18. Язык XML и расширение Е4Х407
Глава 19. Ограничения безопасности Flash Player467
Часть II. Отображение и интерактивность
Глава 20. API отображения и список отображения518
Глава 21. События и иерархии отображения564
Глава 22. Интерактивность596
Глава 23. Обновления экрана653
Глава 24. Программная анимация677
Глава 25. Рисование с помощью векторов698
Глава 26. Программирование растровой графики717
Глава 27. Отображение и ввод текста767
Глава 28. Загрузка внешних отображаемых элементов836
Часть III. Практическое применение ActionScript
Глава 29. Язык ActionScript и среда разработки Flash900
Глава 30. Минимальное приложение на языке MXML936
Глава 31. Распространение библиотеки классов941
Приложение. Окончательная версия программы «Зоопарк»956
Алфавитный указатель972
Оглавление
Предисловие16
Введение19
Для новичков19
Профессиональное руководство20
Структура книги20
Чего нет в этой книге21
Привязка к среде разработки21
Обзор языка ActionScript21
Файлы примеров26
Использование примеров кода26
Соглашения об обозначениях27
Как с нами связаться28
Safari® Enabled29
Благодарности30
От издательства34
Часть I. ActionScript с нуля
Глава 1. Основные понятия36
Инструменты для написания кода на языке ActionScript36
Клиентские среды выполнения Flash37
Компиляция38
Краткий обзор39
Классы и объекты 39
Создание программы41
Пакеты 42
Описание класса44
Краткий обзор приложения «Зоопарк»47
Методы-конструкторы;48
Создание объектов49
Переменные и значения53
Параметры и аргументы конструктора58
Выражения61
Присваивание одной переменной значения другой переменной62
Переменная экземпляра для нашего животного65
Методы экземпляра65
Члены и свойства77
Обзор программы по созданию виртуального зоопарка77
Глава 2. Условные операторы и циклы80
Условные операторы80
Циклы86
Булева логика94
Возвращение к классам и объектам99
Глава 3. Пересмотр методов экземпляра100
Исключение ключевого слова this101
Связанные методы103
Использование методов для получения и изменения состояния объекта105
Get- и set-методы110
Обработка неизвестного количества параметровИЗ
Далее: информация и поведение на уровне класса114
Глава 4. Статические переменные и методы115
Статические переменные115
Константы118
Статические методы120
Объекты Class123
Сравнение с терминологиями языков C++ и Java124
К функциям125
Глава 5. Функции126
Функции уровня пакета127
Вложенные функции129
Функции уровня исходного файла130
Доступ к описаниям из функции131
Функции в качестве значений132
Синтаксис литералов функций132
Рекурсивные функции134
Использование функций в программе «Зоопарк»136
Обратно к классам140
Глава 6. Наследование141
Пример наследования141
Перекрытие методов экземпляра145
Методы-конструкторы в подклассах149
Исключение возможности расширения классов и перекрытия методов153
Создание подклассов внутренних классов154
Теория наследования155
Отсутствие поддержки абстрактных классов и методов162
Применение наследования в программе по созданию виртуального зоопарка162
Код программы Virtual Zoo168
Первый запуск!171
Глава 7. Компиляция и выполнение программы172
Компиляция с помощью среды разработки Flash172
Компиляция с помощью приложения Flex Builder:173
Компиляция с помощью компилятора mxmlc175
Ограничения компиляторов176
Процесс компиляции и путь к классам176
Строгий режим компиляции в сравнении со стандартным режимом177
Далее: типы данных179
Глава 8. Типы данных и проверка типов180
Типы данных и аннотации типов181
Нетипизированные переменные, параметры, возвращаемые значения и выражения185
Три особых случая строгого режима186
Предупреждения об отсутствующих аннотациях типов188
Выявление ошибок обращения на этапе компиляции189
Приведение типов189
Преобразование в примитивные типы194
Значения переменных по умолчанию197
Значения null и undefined197
Типы данных в программе по созданию виртуального зоопарка198
Далее: дополнительное изучение типов данных202
Глава 9. Интерфейсы203
Аргумент в пользу интерфейсов203
Интерфейсы и классы с несколькими типами данных205
Синтаксис и использование интерфейсов206
Другой пример использования составных типов210
Впереди еще много важного216
Глава 10. Инструкции и операторы217
Инструкции217
Операторы219
Далее: управление списками данных228
Глава 11. Массивы229
Что такое массив?229
Анатомия массива229
Создание массивов230
Обращение к элементам массива232
Определение размера массива234
Добавление элементов в массив236
Удаление элементов из массива241
Проверка содержимого массива с помощью метода toString( )243
Многомерные массивы244
Переходим к событиям245
Глава 12. События и обработка событий246
Основы обработки событий в ActionScript246
Обращение к объекту получателя254
Обращение к объекту, зарегистрировавшему приемник256
Отмена стандартного поведения событий258
Приоритет приемника события259
Приемники событий и управление памятью261
Пользовательские события267
Недостаток проверки типов в событийной модели языка ActionScript280
Обработка событий между границами зон безопасности282
Что дальше?287
Глава 13. Обработка исключений и ошибок288
Механизм обработки исключений288
Обработка нескольких типов исключений291
Передача исключений вверх по иерархии объектов301
Блок finally306
Вложенные исключения309
Изменение хода выполнения программы в инструкции try/catch/finally313
Обработка предопределенного исключения315
Впереди еще одна скучная работа316
Глава 14. Сборка мусора317
Доступность объектов для сборки мусора317
Алгоритм поэтапных пометок и вычищений320
Намеренное освобождение объектов321
Деактивация объектов323
Сборка мусора в действии325
К задворкам языка ActionScript326
Глава 15. Динамические возможности языка ActionScript328
Динамические переменные экземпляра329
Динамическое добавление нового поведения в экземпляр333
Динамические обращения к переменным и методам335
Использование динамических переменных экземпляра для создания справочных таблиц336
Использование функций для создания объектов339
Использование объектов-прототипов для дополнения классов341
Цепочка прототипов342
Вперед!344
Глава 16. Область видимости345
Глобальная область видимости346
Область видимости класса347
Область видимости статического метода348
Область видимости метода экземпляра349
Область видимости функции349
Обзор областей видимости350
Детали реализации351
Расширение цепочки областей видимости с помощью оператора with352
К пространствам имен353
Глава 17. Пространства имен354
Словарь пространств имен354
Пространства имен в языке ActionScript355
Создание пространств имен357
Использование пространств имен для уточнения определений переменных и методов360
Уточненные идентификаторы363
Функциональный пример использования пространств имен365
Доступность пространств имен368
Видимость уточненных идентификаторов372
Сравнение уточненных идентификаторов374
Присваивание и передача значений пространств имен375
Пример использования значения пространства имен377
Открытые пространства имен и директива use namespace387
Пространства имен для модификаторов управления доступом391
Практические примеры использования пространств имен394
Последние основные темы406
Глава 18. Язык XML и расширение Е4Х407
Данные XML в виде иерархии407
Представление данных XML в расширении Е4Х409
Создание данных XML с помощью расширения Е4Х411
Обращение к данным XML413
Обработка данных XML с помощью циклов for-each-in и for-in432
Обращение к потомкам434
Фильтрация данных XML438
Обход деревьев XML441
Изменение или создание нового содержимого XML442
Загрузка XML-данных452
Использование пространств имен XML454
Преобразование объектов XML и XMLList в строки460
Определение равенства в расширении Е4Х463
Дальнейшее изучение466
Глава 19. Ограничения безопасности Flash Player467
Чего нет в этой главе468
Локальная область действия, удаленная область действия и удаленные регионы468
Типы безопасности песочниц469
Обобщения в вопросах безопасности вредны471
Ограничения на загрузку содержимого, обращение к содержимому в виде данных, кросс-скриптинг и загрузка данных472
Безопасность сокетов479
Примеры сценариев безопасности480
Выбор локального типа безопасности песочницы483
Разрешения распространителя (файлы политики безопасности)488
Разрешения создателя (allowDomain( ))504
Импортирующая загрузка506
Обработка нарушений безопасности508
Домены безопасности511
Две распространенные проблемы разработки, связанные с безопасностью513
К части II!515
Часть II. Отображение и интерактивность
Глава 20. API отображения и список отображения518
Обзор API отображения519
Список отображения523
Контейнеры и глубины530
События контейнеров549
Пользовательские графические классы561
Переходим к цепочке диспетчеризации событий563
Глава 21. События и иерархии отображения564
Иерархическая диспетчеризация событий564
Фазы диспетчеризации событий565
Приемники событий и цепочка диспетчеризации событий566
Использование цепочки диспетчеризации событий для централизации кода574
Определение текущей фазы события577
Отличие событий, получателем которых является некий объект, от событий, получателями которых являются его потомки580
Остановка процесса диспетчеризации события581
Приоритет и цепочка диспетчеризации событий586
Изменение иерархии отображения и цепочка диспетчеризации событий587
Пользовательские события и цепочка диспетчеризации события590
Переходим к событиям ввода595
Глава 22. Интерактивность596
События мыши597
События фокуса614
События ввода с клавиатуры621
События текстового ввода631
События ввода уровня приложения Flash Player646
Из программы на экран652
Глава 23. Обновления экрана653
Запланированные обновления экрана653
Постсобытийные обновления экрана663
Область перерисовки667
Оптимизация с использованием события Event.RENDER667
Заставим его двигаться!676
Глава 24. Программная анимация677
Никаких циклов677
Создание анимации с помощью события ENTER FRAME678
Создание анимации с использованием события TimerEvent.TIMER684
Выбор между классом Timer и событием Event.ENTER FRAME690
Обобщенный класс Animator691
Анимация, основанная на скорости695
Переходим к контурам и заливкам697
Глава 25. Рисование с помощью векторов698
Обзор класса Graphics698
Рисование линий699
Рисование кривых702
Рисование фигур703
Удаление векторного содержимого705
Пример: библиотека объектно-ориентированных фигур706
От линий к пикселам716
Глава 26. Программирование растровой графики717
Классы BitmapData и Bitmap718
Значения цвета пикселов718
Создание нового растрового изображения723
Загрузка внешнего растрового изображения725
Анализ растрового изображения727
Внесение изменений в растровое изображение734
Копирование графики в объект BitmapData742
Применение фильтров и эффектов757
Освобождение памяти, занимаемой растровыми изображениями765
Слова, слова, слова766
Глава 27. Отображение и ввод текста767
Создание и отображение текста769
Изменение содержимого текстового поля776
Форматирование текстовых полей779
Шрифты и отображение текста808
Отсутствующие шрифты и глифы822
Определение доступности шрифта823
Определение доступности глифа825
Отображение текста с помощью встраиваемых шрифтов826
Ввод через текстовые поля829
Текстовые поля и среда разработки Flash834
Загрузка... Пожалуйста, подождите835
Глава 28. Загрузка внешних отображаемых элементов836
Использование класса Loader для загрузки отображаемых элементов на этапе выполнения837
Проверка типов на этапе компиляции для динамически загружаемых элементов857
Обращение к элементам в многокадровых SWF-файлах867
Создание экземпляра элемента, загружаемого на этапе выполнения870
Использование сокетов для загрузки отображаемых элементов на этапе выполнения873
Удаление SWF-элементов, загруженных на этапе выполнения883
Встраивание отображаемых элементов на этапе компиляции885
К части III897
Часть III. Практическое применение ActionScript
Глава 29. Язык ActionScript и среда разработки Flash900
Документ Flash900
Временные шкалы и кадры901
Создание сценариев на временной шкале905
Класс документа907
Символы и экземпляры911
Связанные классы для символов Movie Clip (Клип)913
Обращение к созданным вручную экземплярам символов917
Обращение к созданному вручную тексту924
Программное управление временной шкалой925
Создание экземпляров символов среды разработки Flash из кода на языке ActionScript926
Имена экземпляров для отображаемых объектов, создаваемых программным путем927
Связывание нескольких символов с одним суперклассом928
Композиционный подход как альтернатива связанным классам931
Предварительная загрузка классов932
Далее в программе: использование платформы разработки Flex935
Глава 30. Минимальное приложение на языке MXML936
Общий подход936
Реальный пример применения компонентов пользовательского интерфейса939
Передача кода вашим друзьям940
Глава 31. Распространение библиотеки классов941
Совместное использование исходных файлов классов941
Распространение библиотеки классов в виде SWC-файла943
Распространение библиотеки классов в виде SWF-файла948
Неужели на этом все закончится?954
Приложение. Окончательная версия программы «Зоопарк»956
Алфавитный указатель972
Предисловие
Мы мечтаем о мире, в котором любое цифровое взаимодействие — в классе, офисе, квартире, аэропорту или машине — превращается в мощную, простую, эффективную и занимательную операцию. Для реализации подобных возможностей широко применяется приложение Flash Player, которое превратилось в сложную платформу, поддерживаемую различными браузерами, операционными системами и устройствами.
Один из основных стимулов для появления новаторских решений корпорации Adobe и разработки приложения Flash Player состоит в том, что разработчики постоянно расширяют границы реализуемых возможностей — эти возможности впоследствии становятся достоянием других разработчиков.
Если бы с помощью машины времени мы могли вернуться в 2001 год, мы бы обратили внимание на широкое распространение Интернета и первые свойства сайтов, содержащих не только страницы, но и интерактивные приложения. Эти приложения в основном использовали HTML-формы и полагались на веб-серверы, обрабатывавшие полученную информацию. Группа специалистов работала над реализацией более быстрого механизма взаимодействия, используя преимущества обработки данных на стороне клиента с помощью языка ActionScript технологии Flash. Одним из самых ранних примеров успешных интерактивных приложений была система бронирования номеров для отеля Broadmoor Hotel — вместо многостраничных HTML-форм в ней использовался одноэкранный, полностью интерактивный интерфейс, позволивший увеличить объем бронирования через Интернет на 89 %.
Очевидно, что скорость имеет значение. Она обеспечивает гораздо более эффективное и впечатляющее взаимодействие. Однако в 2001 году существовало множество проблем с производительностью, возможностями языка сценариев, простотой отладки и ограничениями дизайна в браузерах (которые создавались для просмотра страниц, а не для выполнения других приложений).
В своей компании мы провели множество «мозговых атак» и активно беседовали с разработчиками, и в итоге было решено приступить к реализации данного направления, получившего название «Многофункциональные интернет-приложения» (RIA — Rich Internet Applications). Для лучшей поддержки RIA-приложений мы должны были создать следующее.
Гораздо более быструю виртуальную машину в приложении Flash Player для языка ActionScript 3.0.
Платформу разработки под названием Flex, значительно упрощающую разработку RIA-приложений.
Среду, которая позволяла бы раскрыть все возможности многофункциональных интернет-приложений, — теперь она называется Adobe Integrated Runtime (AIR). В эпоху активного развития интернет-проектов мы зацепились за идею реализации этого будущего мира многофункциональных веб-приложений.
Мы продолжали инвестировать средства в создание целого ряда технологий и готовились к моменту, когда эта инновация станет востребованной. Затраты на иннова-
цию восполнились в полном объеме, и я счастлив наблюдать за появлением многофункциональных интернет-приложений вместе с технологией Web 2.0. Применяя множество технологий и платформ, разработчики создают приложения, которые предоставляют доступ к потенциалу Интернета, позволяют использовать преимущества HTML, Flash, Flex и AJAX и размещать одну часть логики приложения на клиенте, а другую — на сервере.
Вместе с приложением Flash Player 9 была разработана новая виртуальная машина, позволяющая значительно увеличить скорость выполнения приложений на языке ActionScript 3.0 и реализующая самые последние требования стандарта ЕСМА для языка OavaScript основан на этом же стандарте). По соглашению с сообществом Mozilla Foundation был открыт исходный код этой современной реализации (проект Tamarin), что позволило создателям приложения Flash Player сотрудничать с инженерами Mozilla с целью оптимизации виртуальной машины и реализации самых последних стандартов. Этот базовый движок выполнения сценариев со временем будет встроен в браузер Firefox, обеспечивая совместимость сценариев в HTML и Flash.
Кроме того, появилась платформа Flex, которая обеспечивает быструю разработку приложений с помощью распространенных шаблонов для взаимодействия и управления данными, а вся платформа встроена в язык ActionScript 3.0. Платформа разработки Flex доступна бесплатно и содержит исходный код, благодаря чему вы можете точно узнать, как она работает. Для написания кода, использующего возможности платформы Flex, можно применять любой редактор. Существует также специальная среда IDE под названием Adobe Flex Builder.
Наблюдая за появлением инноваций в Интернете, мы решили объединить усилия корпорации Adobe и компании Macromedia. В то время как компания Macromedia занималась развитием RIA-приложений на основе технологии Flash, корпорация Adobe вносила изменения в алгоритм передачи электронных документов и в другие области. Со временем мы увидели, что компания Macromedia собирается добавить поддержку электронных документов в RIA-приложения, а корпорация Adobe — наоборот, ввести возможности RIA-приложений в электронные документы. Чтобы не идти разными путями к одной цели и не изобретать заново велосипед, мы объединили усилия для реализации нашего видения следующего поколения документов и RIA-приложений, совместив лучшую мировую технологию для электронных документов и самую распространенную технологию для RIA-приложений. Это невероятно мощная комбинация.
После объявления об объединении наших компаний мы создали команду «чистой комнаты», чтобы разработать планы относительно нашего следующего поколения программного обеспечения, заимствуя все, что узнали до этого момента, а также потенциал объединения технологий Flash, PDF и HTML в новой среде Adobe AIR для RIA-приложений.
Проект AIR на самом деле является нашей третьей попыткой создать эту новую среду. Первые две попытки были частью экспериментального проекта Central под кодовыми названиями Mercury и Gemini (космическая программа Соединенных Штатов) и проекта AIR под кодовым названием Apollo. Мы узнали многое из этих проектов, и, о чем я люблю напоминать команде, экипаж Apollo первым высадился на Луну.
Среда AIR позволит вам использовать существующие навыки веб-разработки (Flash, Flex, HTML, JavaScript, AJAX) для создания и распространения RIA-приложений в виде настольных приложений. Как и в случае с публикацией интернет-прило- жений, позволяющей любому разработчику с базовыми знаниями языка HTML создать сайт, среда AIR позволит любому разработчику с базовыми навыками вебразработки создать настольное приложение.
Как разработчик, вы можете теперь входить в более близкий контакт с вашими пользователями. Использование браузера подразумевает быструю, отчасти непрочную связь с ними. Они открывают страницу и затем уходят. Среда AIR позволяет вам создавать приложения, которые могут поддерживать связь с пользователями длительное время. Как и любое настольное приложение, приложения AIR имеют значок на Рабочем столе, в меню Пуск операционной системы Windows или на панели инструментов операционной системы Mac OS X. Кроме того, когда вы выполняете веб-приложение, оно существует в отдельном от вашего компьютера мире. Вы не можете просто интегрировать локальные данные в свое приложение. Например, вы не можете просто перетащить контакты из программы Outlook в приложение с картой, чтобы получить маршрут к дому вашего друга. Хотя это можно сделать с помощью приложений AIR, которые создают мост между вашим компьютером и Интернетом.
Я верю, что среда AIR — это начало нового измерения. Эти приложения интересно создавать. Начав раньше, вы сможете реализовать в своих приложениях такие возможности, которых еще нет у других, особенно это касается улучшения представления вашего приложения на компьютере и установления связи между Интернетом и настольным приложением.
Основой RIA-приложений является язык ActionScript независимо от того, выполняются они во Flash Player в браузере, в виде настольного приложения в среде AIR или на мобильных устройствах. Каждое поколение языка ActionScript подробно описано Колином Муком (Colin Moock) в серии книг издательства O’Reilly — они стали справочниками, которыми пользуется большинство разработчиков на платформе Flash. С языком ActionScript 3.0 вы получаете беспрецедентную мощь для построения привлекательных приложений, а в этом справочнике вы найдете подробное описание эффективного использования этой мощи.
Я хочу увидеть созданные вами шедевры и с нетерпением ожидаю появления приложений следующего поколения. Продолжайте расширять границы возможного в Интернете, чтобы сделать приложения более привлекательными и эффективными для людей во всем мире, а мы будем делать все возможное, чтобы поставлять более выразительные и мощные инструменты, помогая вам в ваших усилиях.
Кевин Линч (Kevin Lynch), ведущий разработчик архитектуры ПО, корпорация Adobe
Сан-Франциско, 2007
Введение
ActionScript является официальным языком платформы Adobe Flash. Изначально ActionScript задумывался как простой инструмент для управления анимацией, но со временем он превратился в полноценный язык программирования, который сегодня используется для создания разнообразного содержимого и приложений для Интернета, мобильных устройств и настольных компьютеров. Основополагающие принципы, заложенные в язык ActionScript, делают его удобным средством решения разнообразных задач для программистов, работающих в разных сферах, и разработчиков содержимого. Например, аниматору нужно написать всего несколько строк кода на языке ActionScript, чтобы остановить воспроизведение анимации. Дизайнеру интерфейса потребуется несколько сот строк кода на языке ActionScript, чтобы добавить интерактивность в интерфейс мобильного телефона. А с помощью нескольких тысяч строк кода ActionScript разработчик приложений может создать полноценную программу для чтения электронной почты, которая будет работать в веб-браузере или автономно.
В этой книге представлена исчерпывающая информация по основам программирования на языке ActionScript, а стиль изложения материала отличается чрезвычайной доходчивостью и точностью. Такая непревзойденная точность и глубина материала являются результатом десятилетнего изучения языка ActionScript, использования практического опыта в области программирования и постоянного контакта с инженерами компании Adobe. Каждое слово этой книги было тщательно проверено — в большинстве случаев по нескольку раз — ключевыми фигурами инженерно-технического персонала компании Adobe, включая команды, работающие над созданием программ Flash Player, Flex Builder и среды разработки Flash. Дополнительную информацию можно найти в разд. «Благодарности».
Для новичков
Если у вас нет опыта программирования, начните чтение книги с главы 1. В ней вы познакомитесь с фундаментальными понятиями языка ActionScript: переменная, метод, класс и объект. После этого можете приступать к последовательному изучению остальных глав. Каждая глава базируется на концепциях предшествующих глав, представляя новые темы в виде одного длительного повествования, которое поможет вам овладеть мастерством разработки с использованием языка ActionScript.
Если же вы являетесь дизайнером, который просто хочет узнать, как управлять анимацией в среде разработки Flash, то вполне возможно, что эта книга не для вас. В данном случае ответы на все вопросы вы сможете найти в документации от компании Adobe. Эта книга принесет пользу, когда вы захотите узнать, как добавить в ваше содержимое логику и программируемое поведение.
Профессиональное руководство
Если у вас уже есть опыт программирования на языке ActionScript, эта книга поможет устранить пробелы в ваших знаниях, переосмыслить важные понятия, описанные формальными терминами, и понять сложные темы благодаря простому и точному языку. Считайте данную книгу профессионалом языка ActionScript, сидящим с вами за одним рабочим столом. Вы можете попросить его объяснить тонкости событийной архитектуры языка ActionScript, или распутать лабиринт системы безопасности приложения Flash Player, или продемонстрировать возможности встроенной поддержки языка XML (Е4Х). Кроме того, в этом издании вы можете найти информацию по таким недокументированным возможностям языка ActionScript, как, например, пространства имен, встроенные шрифты, доступ к загруженному содержимому, распространение библиотек классов, сборка мусора и обновления экрана.
Эта книга — настоящее руководство разработчика, содержащее практические пояснения, предупреждения, основанные на глубоком изучении предметной области, и полезные примеры кода, демонстрирующие способы правильного решения той или иной задачи.
Структура книги
Эта книга разделена на три части.
В части I «ActionScript с нуля» представлено подробное описание основ языка ActionScript, включая объектно-ориентированное программирование, классы, объекты, переменные, методы, функции, наследование, типы данных, массивы, события, исключения, область видимости, пространства имен, язык XML. Завершается часть I рассмотрением архитектуры безопасности приложения Flash Player.
В части II «Отображение и интерактивность» представлены методы отображения содержимого на экране и обработки событий ввода. К рассматриваемым темам относится интерфейс прикладного программирования (API) среды выполнения Flash, управляющий отображением содержимого на экране, иерархическая обработка событий, реализация интерактивности с использованием клавиатуры и мыши, анимация, векторная и растровая графика, текст и операции загрузки содержимого.
В части III «Практическое применение ActionScript» основное внимание уделяется вопросам применения кода, написанного на языке ActionScript. В этой части освещаются такие темы, как объединение кода ActionScript с ресурсами, созданными вручную в среде разработки Flash, использование платформы Flex Framework в программе Flex Builder и создание библиотеки пользовательского кода.
В качестве примера на протяжении всей книги создается с нуля и подробно анализируется полнофункциональная программа — виртуальный зоопарк.
Чего нет в этой книге
Экосистема языка ActionScript очень обширна. Охватить весь материал в одной книге просто невозможно. К вопросам, которые заслуживают внимания, но не рассматриваются подробно в этом издании, относятся:
язык MXML;
платформа Flex Framework;
Flex Data Services;
встроенные компоненты среды разработки Flash;
Flash Media Server;
Flash Remoting;.
□ поддержка регулярных выражений в языке ActionScript.
Информацию по перечисленным вопросам можно найти в документации от корпорации Adobe или на веб-странице Adobe Developer Library издательства O’Reilly по адресу http://www.oreilly.com/store/series/adl.csp.
Привязка к среде разработки
В этой книге рассматриваются базовые концепции программирования на языке ActionScript, применимые к любой среде разработки с использованием языка ActionScript 3.0 и к любой среде выполнения, поддерживающей ActionScript 3.0. По возможности я старался избегать вопросов, касающихся разработки кода с применением какого-либо конкретного инструмента, и уделял основное внимание концепциям программирования, а не использованию того или иного инструмента разработки. И все-таки в гл. 29 описывается использование языка ActionScript в среде разработки Flash, а в гл. 30 рассматриваются основы работы с платформой Flex Framework в приложении Flex Builder. Кроме того, в гл. 7 описывается процесс компиляции программы с использованием различных средств разработки (среды разработки Flash, приложения Flex Builder и компилятора mxmlc).
Сейчас обратим внимание на сам язык ActionScript. В следующих разделах представлена вводная техническая информация, касающаяся языка ActionScript 3.0, которая представляет интерес для опытных программистов. Если у вас нет опыта программирования, ознакомьтесь с разд. «Соглашения об обозначениях» и приступайте к изучению гл. 1.
Обзор языка ActionScript
ActionScript 3.0 представляет собой объектно-ориентированный язык программирования, применяемый для создания приложений и управляемого с помощью сценариев мультимедийного содержимого для воспроизведения в клиентских средах выполнения Flash (например, в приложениях Flash Player и Adobe AIR).
Благодаря синтаксису, напоминающему синтаксис языков Java и С#, базовый язык ActionScript наверняка покажется знакомым опытным программистам. Например, следующая строка кода создает переменную типа in t (этот тип означает целое число) с именем width, которой присваивается значение 25: var width:1nt = 25;
Следующий фрагмент кода демонстрирует цикл for с проходом до 10:
for (var 1:1nt = 1; 1 <= 10; 1++) {
// Расположенный здесь код будет выполнен 10 раз
}
А следующий фрагмент кода создает класс с именем Product:
// Описание класса
public class Product {
// Переменная экземпляра типа Number var price:Number;
// Метод-конструктор класса Product
public function Product ( ) {
// Расположенный здесь код инициализирует экземпляры класса Product
}
// Метод экземпляра
public function doSomethlng ( ):vo1d {
// Расположенный здесь код выполняется всякий раз при вызове
// метода doSometh1ng( )
}
}
Базовый язык
Базовый язык ActionScript 3.0 основан на четвертой редакции спецификации языка ECMAScript, которая на момент написания этой книги (май 2007 года) находилась в стадии разработки.
Со спецификацией языка ECMAScript 4 можно ознакомиться по адресу http://developer. mozilla.org/es4/spec/spec.html. Спецификация языка ActionScript 3.0 находится по адресу http://livedocs.macromedia.eom/specs/actionscript/3.
В будущем планируется реализовать язык ActionScript в полном соответствии со спецификацией языка ECMAScript 4. Помимо языка ActionScript, спецификация ECMAScript также лежит в основе JavaScript — популярного языка веб-браузеров. Ожидается, что в будущей версии браузера Firefox 3.0 будет реализована поддержка языка JavaScript 2.0 с использованием того же базового кода, который применяется для ActionScript. Этот код был передан организации Mozilla Foundation корпорацией Adobe в ноябре 2006 года (дополнительную информацию можно найти по адресу http.7/www.mozilla.org/projects/tamafin).
Спецификация языка ECMAScript 4 налагает ограничения на базовый синтаксис и грамматику языка ActionScript — код, применяемый для создания таких элемен-
тов, как выражения, инструкции, переменные, функции, классы и объекты. Кроме того, спецификация языка ECMAScript 4 определяет небольшой набор встроенных типов данных для работы с распространенными значениями (например, String, Number и Boolean).
Ниже перечислены некоторые ключевые возможности базового языка ActionScript версии 3.0.
Первоклассная поддержка наиболее распространенных объектно-ориентированных конструкций, например классов, объектов и интерфейсов.
Однопоточная модель исполнения кода.
Проверка типов на этапе выполнения.
Дополнительная проверка типов на этапе компиляции.
Динамические возможности, позволяющие, например, создавать новые методы- конструкторы и переменные на этапе выполнения.
Исключения, генерируемые на этапе выполнения.
Поддержка языка XML в качестве одного из встроенных типов данных.
Пакеты для организации библиотек кода.
Пространства имен для уточнения идентификаторов.
Регулярные выражения.
Все клиентские среды выполнения Flash, поддерживающие язык ActionScript 3.0, в целом реализуют возможности базового языка. В этой книге полностью рассматривается базовый язык, за исключением регулярных выражений.
Клиентские среды выполнения Flash
Для исполнения программ, разработанных с использованием языка ActionScript, могут использоваться три различные клиентские среды выполнения: Adobe AIR, Flash Player и Flash Lite.
Adobe AIR. Среда выполнения Adobe AIR исполняет Flash-приложения, предназначенные для развертывания на компьютере пользователя. Эта клиентская среда выполнения поддерживает содержимое в формате SWF, а также содержимое, подготовленное с использованием языков HTML и JavaScript. Среда выполнения Adobe AIR должна быть установлена на компьютере конечного пользователя на уровне операционной системы.
Дополнительную информацию можно получить по адресу http://www.adobe.com/ go/air.
Flash Player. Среда выполнения Flash Player исполняет Flash-содержимое и Flash-приложения, предназначенные для развертывания в Интернете. Это приложение является предпочтительной средой выполнения для содержимого в формате SWF, интегрированного в веб-страницу. Flash Player обычно устанавливается в качестве дополнительного модуля к браузеру, но при этом он может работать и в автономном режиме.
Flash Lite. Среда выполнения Flash Lite исполняет Flash-содержимое й Flash- приложения, предназначенные для развертывания на мобильных устройствах. Из-за ограниченной производительности мобильных устройств среда
выполнения Flash Lite обычно отстает от Flash Player и Adobe AIR как по скорости, так и по набору возможностей.
Рассмотренные клиентские среды выполнения Flash предоставляют общий базовый набор функциональных возможностей вместе со специфическими возможностями, которые удовлетворяют функциональным требованиям и требованиям безопасности для каждой конкретной среды выполнения. Например, во всех перечисленных средах выполнения Flash (Adobe AIR, Flash Player и Flash Lite) используется один и тот же синтаксис для создания переменной. Однако Adobe AIR включает интерфейсы прикладного программирования для управления окнами и работы с файловой системой, Flash Player налагает особые ограничения безопасности для защиты личной информации конечного пользователя в Интернете, a Flash Lite позволяет управлять функцией вибрации телефона.
API среды выполнения
Каждая клиентская среда выполнения Flash предоставляет собственный предопределенный набор функций, переменных, классов и объектов, который называется интерфейсом прикладного программирования (Application Programming Interface, API) среды выполнения. API каждой клиентской среды выполнения Flash имеет собственное имя. Например, API клиентской среды выполнения Flash, определяемый приложением Flash Player, называется Flash Player API.
Все API клиентской среды выполнения Flash определяют общий базовый набор функциональности. Например, каждая клиентская среда выполнения использует одинаковый набор классов для отображения содержимого на экране и обработки событий.
К ключевым возможностям, реализуемым всеми API клиентской среды выполнения Flash, относятся:
отображение графики и видео;
иерархическая событийная архитектура;
отображение и ввод текста;
управление с помощью мыши и клавиатуры;
сетевые операции для загрузки данных из внешних источников и взаимодействия с серверными приложениями;
воспроизведение аудио;
печать;
взаимодействие с внешними локальными приложениями;
инструменты программирования.
В этой книге рассматриваются первые пять возможностей из приведенного списка. Информацию по другим специфическим API клиентской среды выполнения Flash можно найти в соответствующей документации по продукту.
Компоненты
Помимо API клиентской среды выполнения Flash, корпорация Adobe предоставляет два различных набора компонентов для выполнения общих задач програм-
мирования и построения пользовательского интерфейса. Приложение Flex Builder и бесплатный инструментарий разработчика Flex 2 SDK включают платформу Flex Framework, определяющую полный набор элементов управления пользовательского интерфейса, например RadioButton, CheckBox и List. Среда разработки Flash предоставляет аналогичный набор компонентов пользовательского интерфейса. Компоненты среды разработки Flash объединяют код и созданные вручную графические элементы, которые могут быть изменены разработчиками и дизайнерами, работающими в этой среде.
И набор компонентов платформы Flex Framework, и набор компонентов среды разработки Flash написаны полностью на языке ActionScript 3.0. Компоненты пользовательского интерфейса платформы Flex Framework в основном обладают более широкими возможностями по сравнению с компонентами среды разработки Flash и поэтому имеют больший файловый размер.
Компоненты пользовательского интерфейса платформы Flex Framework не могут быть использованы в среде разработки Flash, однако компоненты пользовательского интерфейса среды Flash могут быть использованы (и с юридической, и с технической точки зрения) в приложении Flex Builder и откомпилированы с помощью компилятора mxmlc.
В этой книге не рассматривается использование или создание компонентов с применением языка ActionScript. Информацию по компонентам можно найти в соответствующей документации по продукту.
Файловый формат Flash (SWF)
Код на языке ActionScript должен быть скомпилирован в SWF-файл для воспроизведения в одной из клиентских сред выполнения Flash. SWF-файл может содержать как байт-код ActionScript, так и включенные мультимедийные элементы (графику, звук, видео и шрифты). Одни SWF-файлы содержат только мультимедийные элементы без кода, а другие — только код без мультимедийных данных. Программа на языке ActionScript может размещаться как в одном SWF-файле, так и в нескольких. Когда программа разбита на несколько SWF-файлов, один определенный SWF-файл содержит точку входа программы и по мере необходимости загружает другие SWF-файлы. Разбиение сложной программы на несколько SWF-файлов упрощает ее дальнейшее сопровождение и, что касается приложений, размещаемых в Интернете, может обеспечить более быстрый доступ к различным частям программы.
Инструменты разработки приложений на языке ActionScript
Корпорация Adobe предлагает следующие инструменты для разработки приложений на языке ActionScript.
Adobe Flash (http://www.adobe.com/go/flash/). Визуальное средство для дизайна и программирования, применяемое с целью создания мультимедийного содержимого, включающего графику, видео, аудио, анимацию и интерактивность. Программа Adobe Flash используется программистами для создания приложений
и мультимедийного содержимого путем объединения кода на языке ActionScript с нарисованными от руки изображениями, анимацией и мультимедийными элементами. Приложение Adobe Flash также называется средой разработки Flash. На момент написания этой книги (в июне 2007 года) самой последней, девятой, версией среды разработки Flash была CS3.
Adobe Flex Builder (http://www.adobe.com/products/flex/productinfo/overview/). Инструмент разработки для создания содержимого с использованием либо чистого языка ActionScript, либо MXML — языка, основанного на XML и применяемого для описания пользовательских интерфейсов. В состав приложения Flex Builder входит платформа разработки, называемая Flex Framework, которая предоставляет широкий набор средств программирования и библиотеку элементов управления пользовательского интерфейса с изменяемым дизайном и стилями. Приложение Flex Builder, основанное на приложении Eclipse — популярном инструменте программирования с открытым кодом, — может использоваться как в режиме ручного написания кода, так и в режиме визуальной разработки (подобный режим применяется в приложении Visual Basic от корпорации Microsoft)..
Adobe Flex 2 SDK (http://www.adobe.com/products/flex/sdk/). Бесплатный инструментарий разработчика без графического интерфейса (работа осуществляется через командную строку) для создания содержимого с использованием либо чистого языка ActionScript 3.0, либо языка MXML. Инструментарий разработчика Flex 2 SDK включает в себя платформу Flex Framework и консольный компилятор mxmlc (эти компоненты также входят в состав приложения Adobe Flex Builder). Инструментарий Flex 2 SDK позволяет разработчикам бесплатно создавать содержимое в любом редакторе программного кода по их желанию. (Список инструментов и средств разработки приложений на языке ActionScript с открытым кодом можно найти по адресу http://osflash.org.)
Файлы примеров
Официальный сайт, осуществляющий поддержку этой книги на английском языке, доступен по адресу http://moock.org/eas3.
Загрузить файлы примеров для данной книги на английском языке можно по адресу http://moock.org/eas3/examples.
Обратите внимание, что большинство примеров в книге представлено в контексте объемлющего основного класса, который должен быть откомпилирован как FLA-файл класса документа (средство разработки Flash) или как заданный класс приложения проекта (приложение Flex Builder).
Использование примеров кода
Данная книга призвана помочь решить поставленные перед вами задачи. Вы можете использовать код из этой книги в своих программах и документации. Если вы не
воспроизводите значительную часть кода, вам не нужно связываться с нами для получения разрешения. Например, написание программы, в которой используется несколько фрагментов кода из этой книги, не требует получения разрешения. Ответ на вопрос путем цитирования текста и примера кода из этой книги также не требует получения разрешения. Включение значительной части примеров кода из данной книги в вашу документацию по продукту требует получения разрешения. Продажа или распространение дисков с примерами из книг издательства O’Reilly также требует получения разрешения.
Мы будем признательны за указание ссылки на цитируемый источник, хотя и не требуем этого.
Если вы считаете, что использование вами примеров кода исходя из перечисленных ситуаций не является законным, можете в любой момент обращаться к нам за консультацией по электронной почте: permissions@oreilly.com.
Соглашения об обозначениях
Чтобы выделить различные синтаксические компоненты языка ActionScript, в этой книге применяются следующие обозначения.
Команды меню. Команды меню записываются с использованием символа ►, например File ► Open (Файл ► Открыть). Кроме того, шрифт используется для обозначения ссылок.
Моноширинный шрифт. Обозначает примеры и фрагменты кода, имена переменных и параметров, а также имена функций, методов, классов и пакетов, имена файлов, типы данных, ключевые слова, объекты.
Шрифт с фиксированной шириной. Применяется для отображения примеров кода.
Полужирный шрифт с фиксированной шириной. Обозначает текст, который должен быть введен дословно при выполнении пошаговой процедуры. Кроме того, полужирный шрифт с фиксированной шириной иногда используется в примерах кода для создания логического ударения, например, чтобы выделить важную строку кода в большом примере.
Курсивный шрифт с фиксированной шириной. Обозначает код, который должен быть заменен подходящим значением (например, укажитеВашеИмя).
Это совет. Советы содержат полезную информацию по рассматриваемой теме, зачастую выделяя важные концепции или лучшие практические решения.
Это предупреждение. Предупреждения помогают решить возникающие проблемы и избежать их в дальнейшем. Вы можете игнорировать предупреждения на свой страх и риск.
Это примечание. Оно содержит полезную прикладную информацию по рассматриваемой теме. Кроме того в примечании выполняется сравнение и сопоставление версии 2.0 языка ActionScript с версией 3.0 с тем, чтобы помочь вам перейти на ActionScript 3.0 и понять важные различия между двумя версиями языка.
В книге применяются следующие соглашения по кодированию и терминологии.
Ключевое слово this записывается моноширинным шрифтом, поскольку оно является неявным параметром, передаваемым в методы и функции.
Вообще, при обращении к идентификаторам внутри методов экземпляра ключевое слово thi s не используется. Тем не менее оно применяется для устранения неоднозначности, когда имена переменных и методов экземпляра совпадают с именами параметров и локальных переменных.
При обсуждении методов-аксессоров и методов-мутаторов в этой книге не используются традиционные термины аксессор, мутатор, читатель и писатель. Вместо этого применяются неофициальные термины метод-получатель и ме- • mod-модификатор.
При описании класса, содержащего статические переменные, статические методы, переменные экземпляра, методы экземпляра и метод-конструктор, в этой книге сначала перечисляются статические переменные, затем указываются статические методы, переменные экземпляра, метод-конструктор класса и, наконец, методы экземпляра.
В этой книге имена констант записываются ПРОПИСНЫМИ БУКВАМИ.
При обращении к статическим переменным и статическим методам в этой книге всегда указывается имя класса, в котором определены данные переменная или метод.
Если не указано другое, вместо понятия замыкание функции используется более простое понятие функция. Описание различий между этими двумя понятиями можно найти в гл. 5.
В этой книге подразумевается, что компиляция кода осуществляется с применением строгого режима. Более того, после гл. 7 для всех переменных, параметров и возвращаемых значений будет использоваться объявление типов.
Для именования обработчиков событий в книге применяется следующий формат: имяСобытияЫзЬепег, где имяСобытия — это строковое имя события.
Как с нами связаться
Мы приложили максимум усилий, чтобы протестировать и проверить информацию, содержащуюся в этой книге, но, возможно, вы обнаружите некоторые неточности (или даже места, где мы ошиблись!). Пожалуйста, информируйте нас о любых обнаруженных ошибках, а также высказывайте ваши предложения для будущих редакций книги, используя следующую контактную информацию:•
O’Reilly Media, Inc.
1005 Gravenstein Highway North
Sebastopol, GA 95472
998-9938 (в Соединенных Штатах Америки или Канаде)
829-0515 (международный/местный)
829-0104 (факс)
Мы создали веб-страницу для этой книги, где представлен список опечаток, перечислены примеры и собрана другая дополнительная информация. Эта страница доступна по адресу http://www.oreilly.com/catalog/9780596526948.
Отправлять свои комментарии и технические вопросы, касающиеся этой книги, вы можете на следующий электронный адрес: bookquestions@oreilly.com.
Дополнительную информацию о наших книгах, конференциях, программном обеспечении, ресурсных центрах и сети издательства O’Reilly можно найти на нашем сайте по адресу http://www.oreilly.com.
Safari® Enabled
SafariSafariBOOK» ONLINEBOOK» ONLINEЕсли на обложке вашей любимой книги по компьютерным технологиям вы видите значок Safari® Enabled, это значит, что данная книга доступна в интернет-каталоге издательства O’Reilly — O’Reilly Network Safari Bookshelf.
Safari
Safari
BOOK» ONLINE
BOOK» ONLINE
Интернет-каталог Safari предлагает лучшее решение по сравнению с обычными книгами в электронном варианте. Это виртуальная библиотека, которая окажет неоценимую помощь в тех случаях, когда вам понадобится наиболее достоверная и актуальная информация. С ее помощью вы можете легко осуществлять поиск нужной информации среди тысяч ведущих книг по компьютерным технологиям, копировать и вставлять примеры кода, загружать главы и получать быстрые ответы на интересующие вас вопросы. Бесплатно ознакомиться с возможностями интер- нет-каталога Safari вы можете по адресу http://safari.oreilly.com.
Благодарности
Эта книга была написана благодаря оказанному доверию и активной поддержке как со стороны корпорации Adobe, так и со стороны издательства O’Reilly. Летом 2005 года на встрече со Стивом Вайссом (Steve Weiss), Лизой Фрэндли (Lisa Friendly) и Майком Чамберсом (Mike Chambers) я согласился написать книгу под названием «Essential ActionScript 3.0». Изначально предполагалось, что новая книга станет «небольшим обновлением книги "Essential ActionScript 2.0"». Но бурное развитие языка ActionScript 3.0 привело к тому, что книга «Essential ActionScript 3.0» переросла в самостоятельный продукт. Корпорация Adobe и издательство O’Reilly терпеливо и стойко наблюдали за бесконечным увеличением размеров книги и в итоге согласились перенести предельный срок публикации с девяти месяцев до двух лет. На протяжении всего времени я твердо верил, что мы сделали правильный выбор, и для меня большой честью является тот факт, что корпорация Adobe и издательство O’Reilly согласились с этим.
В процессе написания этой книги корпорация Adobe любезно предоставляла мне полный доступ к внутренним ресурсам и выделяла официальное инженерное время для технических рецензий. Я чрезвычайно благодарен Джу Ли Бардекину 0u Lee Burdekin) и Фрэнсису Чену (Francis Cheng) из команды разработки технической документации корпорации Adobe. ДжуЛи и Фрэнсис координировали мои усилия внутри корпорации Adobe и отвечали на бесконечный, как мне казалось, поток вопросов. Множество сотрудников корпорации Adobe предоставляли мне информацию и проводили инструктаж в процессе подготовки материала для будущей книги. Я крайне признателен каждому из них и хочу особо поблагодарить следующих людей.
Фрэнсис Чен был постоянным источником информации по базовому языку и оказал неоценимую помощь при рецензировании рукописи книги «Essential ActionScript 3.0». Фрэнсис входит в состав комитета, занимающегося разработкой спецификации языка ECMAScript 4, и является одним из авторов спецификации языка ActionScript 3.0.
Джефф Дайер 0eff Dyer) постоянно выкраивал время в своем графике для помощи в уточнении концепций базового языка и поиске ошибок. Джефф является одним из основных разработчиков компилятора языка ActionScript 3.0, основным автором спецификации языка ActionScript 3.0 и главным членом комитета, занимающегося разработкой спецификации языка ECMAScript 4.
Дене Мекета (Deneb Meketa) терпеливо выдерживал мое неправильное понимание системы безопасности клиентской среды выполнения Flash Player. Телефонные звонки и переписка по электронной почте в процессе интенсивных исследований, продолжавшихся более месяца, помогли внести ясность в гл. 19. Дене является инженером, отвечающим за реализацию системы безопасности в среде выполнения Flash Player.
Джефф Мотт 0eff Mott) — инженер среды выполнения Flash Player — постоянно давал исчерпывающие и практически мгновенные ответы на мои вопросы, касающиеся событийной системы языка ActionScript.
Джим Корбетт 0im Corbett), являющийся инженером среды выполнения Flash Player, помог мне понять многие тонкости дисплейного списка и процесса загрузки событий.
Ребекка Сан (Rebecca Sun) — инженер среды разработки Flash — ответила на множество вопросов, касающихся связей между компилятором языка ActionScript 3.0 и приложением Flash CS3. Кроме того, она приветливо выслушивала предложения и терпела мои частые спонтанные просьбы через систему обмена мгновенными сообщениями.
Ли Томасон (Lee Thomason) — системный архитектор среды Flash Player — прочитал мне персональную лекцию по механизму отображения текста в этой среде.
Роджер Гонзалез (Roger Gonzalez) — системный архитектор компилятора Flex — регулярно отвечал на мои вопросы, касающиеся процесса загрузки классов и компилятора Flex.
Вернер Шарп (Werner Sharp), являющийся инженером среды выполнения Flash Player, объяснил множество тонких моментов, связанных с обработкой растровых изображений в языке ActionScript.
Пол Бетлем (Paul Betlem) — ведущий руководитель команды разработчиков среды выполнения Flash Player — помог облегчить процесс технического рецензирования и лично просмотрел несколько глав.
Майк Чамберс (Mike Chambers) — ведущий менеджер по связям между разработчиками среды выполнения Adobe AIR — предоставлял актуальную техническую информацию и участвовал в развитии проекта «Essential ActionScript 3.0» со времени его появления.
Гари Гроссман (Gary Grossman), который является первым создателем языка ActionScript, научил меня многому из того, что я знаю о программировании для платформы Flash. В августе 2006 года Гари объединился с изобретателями платформы Flash (Джоном Гейем О on Gay) и Робертом Тацуми (Robert Tatsumi)), чтобы вместе основать новую компанию, Software as Art (http://www. softwareasart.com).
Для меня было честью познакомиться и работать с другими сотрудниками корпорации Adobe — бывшими и настоящими, — которые перечислены далее: Майк Дауни (Mike Downey), Кевин Линч (Kevin Lynch), Пол Бетлем, Эдвин Смит (Edwin Smith), Кристин Ярроу (Christine Yarrow), Джефф Камерер (Jeff Kamerer), Нигель Пегг (Nigel Pegg), Матт Вобенсмит (Matt Wobensmith), Томас Рейли (Thomas Reilly), Джетро Виллегас Qethro Villegas), Роб Диксон (Rob Dixon), Джефф Шварц (Jeff Swartz), Валид Анбар (Waleed Anbar), Крис Тилген (Chris Thilgen), Джилле Дрю (Gilles Drieu), Нивеш Райбхандари (Nivesh Rajbhandari), Тей Ота (Tei Ota), Акио Танака (Akio Tanaka), Суми Лим (Sumi Lim), Трой Эванс (Troy Evans), Джон Доуделл (John Dowdell), Бентли Вольф (Bentley Wolfe), Тиник Уро (Tinic Uro), Майкл Вильямс (Michael Williams), Шарон Селдон (Sharon Seldon), Джонатан Гэй Jonathan Gay), Роберт Тацуми (Robert Tatsumi), Пете Сантангели (Pete Santangeli), Марк Андерс (Mark Anders), Джон Нэк (John Nack), Матт Чотин (Matt Chotin), Алекс Харуй (Alex Harui), Гордон Смит (Gordon Smith), Шо Кувамото (Sho Kuwamoto), Крейг Гудман (Craig Goodman), Стефан Грюнведель (Stefan Gruenwedel), Дипа Субраманиам (Deepa Subramaniam), Этан Маласки (Ethan Malasky), Син Кранзберг
(Sean Kranzberg), Майкл Моррис (Michael Morris), Эрик Виттман (Eric Wittman), Джереми Кларк (Jeremy Clark) и Джанис Пирс (Janice Pearce).
Из табл. 0.1, в которой представлена статистическая информация, вы можете понять, насколько я благодарен официальным техническим рецензентам.
Таблица 0.1. Рецензенты корпорации Adobe
Рецензент
Должность
Просмотренные главы
Количество ответов на электронные письма
Дене Мекета
Специалист по компьютерным технологиям, платформа Flash
17
75
Эрика Нортон (Erica Norton)
Ведущий инженер по качеству, среда выполнения Flash Player
14, 19, 21, 22
3
Фрэнсис Чен
Ведущий технический писатель
1-11, 13, 15, 16, 18
334
Джефф Дайер
Системный архитектор компиляторов, группа разработки языка ActionScript
17
106
Джефф Мотт
Специалист по компьютерным технологиям, группа разработки среды выполнения Flash Player
12, 20-25
85
Джим Корбетт
Ведущий специалист по компьютерным технологиям, группа разработки среды выполнения Flash Player
20, 23, 24, 28
52
Ли Томасон
Системный архитектор, среда выполнения Flash Player
25, 27
33
Майк Чамберс
Ведущий менеджер по связям между разработчиками, среда выполнения Adobe AIR
1
89
Майк Ричардс (Mike Richards)
Специалист по компьютерным технологиям, мобильные телефоны и устройства
22-26
9
Пол Робертсон (Paul Robertson)
Разработчик/кодировщик языка ActionScript
1, 2, 24, 27-31
14
Пол Бетлем
Ведущий руководитель, группа разработки среды выполнения Flash Player
20, 27, 26
19
Ребекка Сан
Специалист по компьютерным технологиям, среда разработки Flash
7, 29, 31
60
Роберт Пеннер (Robert Penner)
Ведущий инженер, среда разработки Flash
18, 23-25
16
Роджер Гонзалез
Системный архитектор компилятора Нех
25, 30, 31
64
Вернер Шарп
Ведущий специалист по компьютерным технологиям, группа разработки среды выполнения Flash Player
18, 22
35
Спасибо Робину Томасу (Robyn Thomas) — редактору этой книги, — который просмотрел и «отполировал» рукопись с потрясающей скоростью и точностью. Спасибо и всем членам руководящего состава издательства O’Reilly, а также редакторского, производственного, декораторского и художественного отделов, отдела маркетинга и отдела сбыта, включая Тима О’Рейли (Tim O’Reilly), Стива Вайсса и Карена Монтгомери
(Karen Montgomery). Спасибо литературному редактору Филиппу Данглеру (Philip Dangler), который помог сделать текст связным, читабельным и безошибочным.
Помимо технического рецензирования сотрудниками корпорации Adobe, эта книга прошла проверку на ошибки и качество независимой группой читателей, куда входили Бретт Волкер (Brett Walker), Чафик Казун (Chafic Kazoun), Дерек МакКенна (Derek McKenna), Эдвин ван Рийком (Edwin van Rijkom), Грег Бурч (Greg Burch), Джим Армстронг 0im Armstrong), Джон Вильямс 0on Williams), Марк Джонкман (Markjonkman), Мэттью Кифи (Matthew Keefe), Мауро Ди Бласи (Mauro Di Blasi), Ральф Бокельберг (Ralf Bokelberg), Рик Евинг (Ric Ewing), Робин Дебрюил (Robin Debreuil) и Виктор Аллен (Victor Allen). Эти читатели оказали неоценимую помощь, обнаружив множество несоответствий и неявных ошибок в примерах кода. Хочется отдельно отметить Марка Джонкмана за его чрезвычайно тщательное изучение рукописи книги и примеров кода.
Еще хочу поблагодарить двух наставников, которые помогли мне стать программистом и писателем. Это Брюс Эпстейн (Bruce Epstein) и Дерек Клейтон (Derek Clayton). Брюс занимался редактированием всех моих предыдущих книг, и его ценные наставления до сих пор наполняют каждое слово, написанное мой. Дерек является создателем многопользовательского сервера Unity, размещенного на сайте moock.org (http://www.moock.org/unity), постоянным источником идей для программирования и просто хорошим другом.
И, конечно же, ни одна книга по языку, основанному на спецификации языка ECMAScript, не будет полной без слов благодарности в адрес Брендана Эйка (Brendan Eich) за создание языка JavaScript и за участие в продолжающейся разработке спецификации языка ECMAScript. Спасибо, Брендан!
В заключение хочу пожелать любви и согласия следующим людям за их любовь и дружескую поддержку: Джеймсу Портеру 0ames Porter), Грааму Бартону (Graham Barton), Джо Дуону 0ое Duong), Томми Якобсу (Tommy Jacobs), Венди Шаффер (Wendy Schaffer), Эндрю Харрису (Andrew Harris), Дейву Люкстону (Dave Luxton), Дэйву Комлосу (Dave Komlos), Марко Кроулею (Marco Crawley), Эрику Липхардту (Eric Liphardt), Кену Реддику (Ken Reddick), Майку Линковичу (Mike Linkovich), Матту Верну (Matt Wearn), Майку Добеллу (Mike Dobell), Майку «Найсу» (Mike «Nice»), Хоссу Гиффорду (Hoss Gifford), Эрику Нацке (ErikNatzke), Яреду Тарбеллу Qared Tarbell), Маркосу Вескампу (Marcos Weskamp), Дану Албриттону (Dan Albritton), Фрэнсису Бурре (Francis Bourre), Тийсу Тремстра (Thijs Triemstra), Веронике Бросье (Veronique Brossier), Сайме Хохар (Saima Khokhar), Амиту Питару (Amit Pitaru), Джеймсу Паттерсону Qames Patterson), Джошуа Дэвису Qoshua Davis), Брендену Холлу (Branden Hall), Роберту Ходгину (Robert Hodgin), Шину Мацумуре (Shin Matsumura), Юго Накамуре (Yugo Nakamura), Клаусу Валерсу (Claus Whalers), Даррону Шоллу (Darron Schall), Марио Клин- геману (Mario Klingeman), Фумио Нонаке (Fumio Nonaka), Роберту Рейнхардту (Robert Reinhardt), Грану Скиннеру (Grant Skinner) и семейству Муков.
Колин Мук Март 2007 года Торонто, Канада
От издательства
Ваши замечания, предложения и вопросы отправляйте по адресу электронной почты dgurski@minsk.piter.com (издательство «Питер», компьютерная редакция).
Мы будем рады узнать ваше мнение!
На сайте издательства http://www.piter.com вы найдете подробную информацию о наших книгах.
Actionscript с нуля
В части I представлено подробное описание языка ActionScript 3.0, включая принципы объектно-ориентированного программирования, классы, объекты, переменные, методы, функции, наследование, типы данных, массивы, события, исключения, области видимости, пространства имен и язык XML. В конце части рассматривается архитектура безопасности приложения Flash Player.
Прочитав часть I, вы получите глубокие знания основ языка ActionScript 3.0 и сможете применить их на практике, разрабатывая пример-приложение создания виртуального зоопарка.
Глава 1 «Основные понятия».
Глава 2 «Условные операторы и циклы».
Глава 3 «Пересмотр методов экземпляра».
Глава 4 «Статические переменные и методы».
Глава 5 «Функции».
Глава 6 «Наследование».
Глава 7 «Компиляция и выполнение программы».
Глава 8 «Типы данных и проверка типов».
Глава 9 «Интерфейсы».
Глава 10 «Инструкции и операторы».
Глава И «Массивы».
Глава 12 «События и обработка событий».
Глава 13 «Обработка исключений и ошибок».
Глава 14 «Сборка мусора».
Глава 15 «Динамические возможности языка ActionScript».
Глава 16 «Область видимости».
Глава 17 «Пространства имен».
Глава 18 «Язык XML и расширение Е4Х».
Глава 19 «Ограничения безопасности Flash Player».
Основные понятия
Программа — это набор команд, выполняемых (или исполняемых) компьютером или приложением. Текст программы, записанный в виде, удобном для восприятия человеком, называется исходным кодом, или просто кодом, а человек, который создает программу, — программистом, кодировщиком или разработчиком. Для написания программ используются определенные языки программирования. Они определяют синтаксис и грамматику, которые должны использовать программисты при написании инструкций к создаваемой программе. В настоящей книге подробно описываются особенности языка программирования ActionScript 3.0. Приготовьтесь приятно провести время.
Инструменты дня написания кода на языке Actionscript
Код на языке ActionScript представляет собой обычный текст, поэтому программы на его основе можно создать даже с помощью простейшего текстового редактора, например Блокнота операционной системы Windows или приложения TextEdit операционной системы Macintosh. Тем не менее в среде программистов ActionScript наиболее распространены два коммерческих приложения, являющиеся разработками корпорации Adobe Systems Incorporated: программа Flex Builder и среда разработки Flash.
Программа Flex Builder представляет собой интегрированную среду разработки, или IDE (Integrated Development Environment). IDE — это приложение, предназначенное для написания и управления кодом, во многом напоминающее текстовый процессор, предназначенный для создания печатных документов. Разработчики используют программу Flex Builder для создания приложений и мультимедийного содержимого с помощью языков ActionScript, MXML или их обоих. Язык MXML основан на языке XML и применяется для описания пользовательских интерфейсов.
В отличие от Flex Builder, среда разработки Flash — это инструмент, сочетающий в себе редакторы проекта, анимации и программный редактор. Она используется программистами для создания приложений и мультимедийного содержимого путем объединения кода на языке ActionScript с нарисованными от руки изображениями, анимацией и мультимедийными элементами.
Язык ActionScript 3.0 поддерживается программами Flex Builder и Flash CS3 (другое название среды разработки Flash версии 9) и их более поздними версиями.
Найти программу Flex Builder можно по адресу: http://www.adobe.com/products/flex/. Среда разработки Flash доступна по адресу: http://www.adobe.com/products/flash/.
Большая часть этой книги посвящена созданию приложений и мультимедийного содержимого с использованием исключительно кода ActionScript. В гл. 29 описывается использование языка ActionScript в среде разработки Flash. Рассмотрение языка MXML выходит за рамки данной книги. Ознакомиться с ним можно в книге «Programming Flex 2» (Kazoun and Lott, 2007) издательства O’Reilly или в документации по программе Adobe Flex Builder.
Клиентские среды выполнения Flash
Для выполнения программ, написанных на языке ActionScript, могут применяться три различных приложения, разработанные корпорацией Adobe: Flash Player, Apollo и Flash Lite.
Приложение Flash Player позволяет выполнять программы на ActionScript в браузере или в автономном режиме на Рабочем столе. Оно обладает крайне ограниченным доступом к операционной системе (например, выполняемая программа не может управлять файлами, контролировать окна или получать доступ к большинству аппаратных устройств компьютера).
Приложение Apollo позволяет выполнять программы на ActionScript на Рабочем столе и является полностью интегрированным с операционной системой (например, выполняемая программа может осуществлять любые операции, в том числе и те, доступ к которым невозможен при использовании приложения Flash Player: управлять файлами, контролировать окна и получать доступ к аппаратному обеспечению компьютера).
Приложение Flash Lite предназначено для использования на мобильных устройствах, например на сотовых телефонах. На момент издания этой книги приложение Flash Lite было способно выполнять программы, написанные только на языке ActionScript 2.0 (но не на языке ActionScript 3.0). В то же время приложения Flash Player и Apollo позволяют выполнять программы, написанные на языке ActionScript 3.0. Таким образом, методики, изложенные в этой книге, применимы только к приложениям Flash Player и Apollo (до тех пор пока в приложении Flash Lite не будет реализована поддержка языка ActionScript 3.0).
В общем смысле, приложения Flash Player, Apollo и Flash Lite называются клиентскими средами выполнения Flash (или сокращенно средами выполнения Flash), поскольку они управляют программами на ActionScript в процессе их выполнения, или «прогона». Среды выполнения Flash доступны для операционных систем Windows, Macintosh и Linux, а также для различных мобильных устройств. Поскольку программы на ActionScript выполняются средой выполнения Flash, а не конкретной операционной системы или аппаратного устройства, то любую программу на языке ActionScript можно считать переносимой, так как она может выполняться на различных аппаратных устройствах (телефонах, игровых приставках) и в операционных системах (Windows, Macintosh и Linux).
Зачастую термин «виртуальная машина ActionScript» используется как аналог термина «клиентском среда выполнения Flash». Однако на деле между этими двумя терминами существует разница и они не являются взаимозаменяемыми. Технически виртуальная машина ActionScript (AVM — ActionScript virtual machine) представляет собой программный модуль, являющийся частью приложений Flash Player, Apollo и Flash Lite, который выполняет программы на ActionScript. В то же время на любую среду выполнения Flash возлагаются и другие задачи, например отображение содержимого на экране, воспроизведение видео и аудио, взаимодействие с операционной системой. Версия виртуальной машины ActionScript, позволяющая выполнять код ActionScript 3.0, получила название A VM2. Версия виртуальной машины ActionScript, позволяющая выполнять код ActionScript 1.0 и ActionScript 2.0 (данные версии языка ActionScript не рассматриваются в этой книге), получила название A VM1.
Компиляция
Прежде чем программа, написанная на языке ActionScript, будет обработана средой выполнения Flash, код ActionScript 3.0 должен быть из формы, понятной программисту, преобразован в сжатый, двоичный формат, принятый в среде выполнения Flash и называемый байт-кодом ActionScript, или АВС. Однако сам по себе байт-код ActionScript не может быть исполнен средой Flash; он должен быть помещен в бинарный файл-контейнер с расширением SWF. Для хранения в SWF-файле байткода и всех включенных мультимедийных элементов, необходимых ActionScript, применяется формат файла Flash SWF. Процесс преобразования программы на ActionScript в байт-код называется компиляцией программы. Процесс генерации SWF-файла называется компиляцией SWF-файла или иногда — экспортированием или публикацией SWF-файла.
Для компиляции программ ActionScript 3.0 и SWF-файлов используется программный модуль, называемый компилятором. Компилятор, применяемый для преобразования кода ActionScript, называется компилятором ActionScript. Компилятор, применяемый для генерации SWF-файлов, называется компилятором SWF. Любой компилятор SWF, реализующий полную поддержку формата файла Flash, включает компилятор ActionScript. Естественно, компилятор SWF (и как следствие, компилятор ActionScript) входит в состав приложения Flex Builder и среды разработки Flash. Приложение Flex Builder и среда разработки Flash используют один и тот же компилятор ActionScript, но при этом имеют различные компиляторы SWF, называемые компилятором Нех и компилятором Flash соответственно. Кроме того, компилятор Flex доступен в виде отдельного консольного приложения mxmlc, которое входит в состав бесплатного инструментария разработчика корпорации Adobe — Flex 2 SDK, и может быть загружен по адресу: http://www.adobe. com/go/flex2_sdk.
Динамическая компиляция. В процессе выполнения программы на ActionScript среда Flash читает скомпилированный байт-код ActionScript и преобразует его в машинные команды, определенные для конкретного аппаратного обеспечения
компьютера, на котором выполняется данная программа. В большинстве случаев преобразованные машинные команды сохраняются в памяти для дальнейшего использования, благодаря чему отпадает необходимость в повторном преобразовании байт-кода ActionScript.
Как и процесс преобразования кода ActionScript 3.0 в байт-код, процесс преобразования байт-кода ActionScript в машинный код и его последующее сохранение для дальнейшего выполнения называется компиляцией. Таким образом, для большинства программ на ActionScript компиляция выполняется в два этапа.
На первом этапе разработчик компилирует код из удобного для чтения формата в формат, который понимает среда выполнения Flash (байт-код ActionScript). После этого среда выполнения Flash автоматически компилирует байт-код ActionScript в понятный конкретному аппаратному обеспечению формат, на котором выполняется программа (машинный код). Такой вид компиляции (байт-код в машинный код) называется динамической компиляцией, или JIT (Just-In-Time), поскольку она происходит непосредственно перед тем моментом, когда программе потребуется определенный фрагмент скомпилированного байт-кода. Динамическая компиляция иногда называется динамической трансляцией. Опытным программистам, возможно, будет интересно узнать, что динамическая компиляция не применяется для кода, находящегося на верхнем уровне описания класса (поскольку этот код выполняется всего один раз).
Краткий обзор
Выше было рассмотрено множество базовых понятий. Теперь подведем промежуточные итоги.
Программа, написанная на языке ActionScript, представляет собой набор инструкций, исполняемых одной из существующих сред выполнения Flash: приложением Flash Player, Apollo или Flash Lite. Программы на языке ActionScript можно создавать в обычном текстовом редакторе, в приложении Flex Builder или в среде разработки Flash. Перед выполнением программа должна быть скомпилирована в SWF-файл с помощью компилятора SWF, в качестве которого может выступать компилятор Flash, входящий в состав среды разработки Flash, или компилятор mxmlc, входящий в состав приложения Flex Builder и инструментария разработчика Flex 2 SDK.
Не волнуйтесь, если некоторые из понятий или терминов вам совершенно незнакомы. Вы сможете ознакомиться с ними в следующих разделах.
Теперь приступим к написанию кода.
Классы и объекты
Представьте, что вы собираетесь построить самолет. Обдумайте этапы предстоящей работы. Вряд ли вы сразу направитесь в магазин за металлом, чтобы приступить
к сварке. Для начала необходимо подготовить чертеж будущего самолета. На самом же деле, принимая во внимание тот факт, что вы строите самолет с нуля, необходимо подготовить не один, а несколько чертежей — но одному для каждой части самолета (колес, крыльев, кресел, тормозов и т. д.). Каждый чертеж должен в полной мере описывать определенную часть конструкции и соответствовать реальной детали в физической реализации. Для построения самолета необходимо изготовить каждую деталь по отдельности, а затем собрать готовые составляющие в соответствии с основным чертежом. Взаимодействие собранных частей самолета будет определять его поведение.
Если приведенные примеры понятны для вас, значит, у вас есть все необходимое, чтобы стать программистом на языке ActionScript. Выполняющаяся программа, как и самолет, летящий высоко в небе и представляющий собой совокупность взаимодействующих частей, разработанных по набору чертежей, является совокупностью взаимодействующих объектов, построенных из набора классов. В программе объекты ActionScript представляют собой как материальные предметы, так и неосязаемые понятия. Например, объект может представлять число в вычислении, интерактивную кнопку пользовательского интерфейса, момент времени на календаре или эффект размытия на изображении. Объекты являются воплощениями, или экземплярами, классов. Иначе говоря, классы — это чертежи, по которым создаются объекты.
Первый шаг в написании новой программы заключается в определении классов. Каждый класс с помощью кода описывает характеристики и поведение определенного типа объекта. Некоторые классы программы должны быть написаны с нуля, тогда как другие классы предоставляются языком ActionScript и различными средами выполнения Flash. Классы, написанные с нуля (называемые пользовательскими классами), используются для представления объектов специализированного типа, например формы заказа в интернет-магазине, автомобиля в гоночном симуляторе или сообщения в программе обмена текстовыми сообщениями. В отличие от этого, классы, предоставляемые языком ActionScript и различными средами выполнения Flash (называемые предопределенными классами), используются для выполнения фундаментальных задач, например для представления чисел и текста, воспроизведения звука, вывода изображений, обеспечения доступа к сети и формирования ответа на запрос пользователя.
Из классов, описанных в программе, мы формируем объекты (или создаем экземпляры), а затем управляем этими объектами, давая указания к выполнению тех или иных действий. Действия, выполняемые объектами, определяют поведение программы.
Процесс создания программы с помощью классов и объектов называется объектно-ориентированным программированием (ООП).
Прежде чем приступить к написанию программы, кратко рассмотрим важную группу классов, называемых собственными классами и являющихся частью языка ActionScript. Собственные классы, приведенные в табл. 1.1, применяются для работы с основными типами данных, например с числами и текстом. Логично предположить, что в каждой создаваемой программе вы будете использовать экземпляры
по крайней мере одного или двух собственных классов языка ActionScript — аналогично использованию готовых деталей от стороннего производителя при построении самолета. Изучите табл. 1.1, чтобы получить общее представление об этих классах. В следующих разделах собственные классы будут рассмотрены более подробно.
Таблица 1.1. Собственные классы языка ActionScript
Класс
Описание
String
Представляет текстовые данные (то есть строку или символы)
Boolean
Определяет логические состояния true (истина) или false (ложь)
Number
Представляет числа с плавающей запятой (то есть числа с дробной частью)
Int
Определяет целые числа (то есть числа без дробной части)
Uint
Представляет положительные целые числа
Array
Определяет упорядоченный список
Error
Представляет ошибку в программе (то есть проблему в вашем коде)
Date
Представляет определенный момент времени
Math
Содержит распространенные математические величины и операции
RegExp
Определяет инструменты для поиска и замены текста
Function
Представляет многократно используемый набор инструкций, которые могут быть вызваны и исполнены повторно
Object
Определяет базовые возможности всех объектов языка ActionScript
Теперь попробуем применить классы и объекты в примере программы — простом приложении, имитирующем зоопарк с виртуальными животными.
Й
Применение методики, называемой созданием сценариев на временной шкале, в среде разработки Flash позволяет создавать программы на ActionScript без предварительного определения класса (дополнительную информацию можно найти в гл. 29). Тем не менее, даже если в будущем вы не планируете создавать классы самостоятельно, я настоятельно рекомендую вам познакомиться с методиками, рассмотренными в этой главе. Знакомство с процессом создания классов позволит значительно углубить ваше понимание языка ActionScript в целом и поможет вам стать более профессиональным программистом.
Создание программы
Как уже было сказано, программы на языке ActionScript построены из классов, которые являются «чертежами» взаимодействующих между собой частей (объектов) программы. Обычно разработка новой программы на ActionScript начинается с фазы проектирования, в течение которой функциональные возможности программы разбиваются на логически связанные классы. Каждому классу присваивается имя, определяются его свойства и роль в создаваемой программе. Один класс назначается основным классом. Он содержит стартовую точку, то есть программную точку входа, для приложения. Для запуска новой программы в среде выполнения Flash автоматически создается экземпляр основного класса программы.
Основному классу нашего примера программы по созданию виртуального зоопарка мы присвоим имя Virtualzoo. Сначала создадим папку с именем virtualzoo
в файловой системе компьютера, внутри которой создадим вложенную папку src (сокращенно от слова source — «исходный код»). В ней будут храниться все файлы с расширением AS (то есть все файлы, содержащие исходный код).
Исходный код каждого основного класса программы должен размещаться в отдельном текстовом файле, имя которого состоит из имени основного класса и расширения AS. Таким образом, необходимо создать пустой текстовый файл с именем VirtualZoo. as. Нужно убедиться, что имя файла VirtualZoo. as полностью совпадает с именем класса VirtualZoo, поскольку в данном случае учитывается регистр символов. Далее поместим файл VirtualZoo. as в папку virtualzoo/src. Тогда текущая файловая структура для исходных файлов нашей программы будет иметь следующий вид:
virtual zoo
|- src
|- Virtual Zoo.as
Теперь, когда файл VirtualZoo. as создан, мы можем приступать к написанию класса VirtualZoo. Однако сначала нужно решить возможную проблему: если выбранное имя основного класса будет конфликтовать (то есть совпадать) с именем одного из предопределенных классов языка ActionScript, то компилятор языка ActionScript не позволит создать этот класс и программа не сможет быть выполнена. Чтобы избежать подобных проблем с именами, воспользуемся пакетами.
Й
Поскольку нам необходимо рассмотреть большой объем материала, мы не будем компилировать код нашей программы вплоть до гл. 7. Если вы все же решите самостоятельно откомпилировать примеры, представленные в гл. 1-6, то, скорее всего, столкнетесь с множеством различных предупреждений и ошибок при компиляции примеров. Внимательное изучение указанных глав позволит вам избежать многих из этих ошибок.
Пакеты
Как видно из названия, пакет — это общее определение блока, в который входят группы классов и, как будет сказано ниже, другие элементы программы. Каждый пакет определяет границы независимой физической области программы и присваивает этой области имя, называемое именем пакета. Чтобы отличать классы от пакетов, имена пакетов принято записывать со строчной буквы, а имена классов — с прописной.
Когда исходный код класса размещается внутри пакета, имя пакета автоматически становится частью имени класса подобно тому, как ребенок наследует фамилию своих родителей. Например, класс Player, размещенный в пакете game, получает имя game .Player. Обратите внимание, что сначала указывается имя пакета, которое отделяется от имени класса с помощью символа «точка» (.) (термин «символ» в среде программистов обозначает букву, цифру, знак препинания и т. д.). Имя пакета помогает отличить класс game. Player от других классов с именем Player, тем самым предотвращая конфликты имен между различными частями программы или между пользовательскими и предопределенными классами языка ActionScript.
Для создания нового пакета используется директива описания пакета. Рассмотрим этот термин. В языке ActionScript все инструкции программы обычно называются директивами. Описания — это один из типов директив; они создают или описывают, например, пакет или класс. В данном случае описываемым элементом является пакет, откуда и название термина — директива описания пакета.
ш Если описание создает какой-либо элемент в программе, то говорят, что оно определяет или объявляет этот элемент. Описания часто называют объявлениями.
В общем виде директива описания пакета записывается следующим образом: package имяПакета {
}
Все описания пакетов начинаются с ключевого слова: package. Ключевое слово — это имя команды, зарезервированное для использования в языке ActionScript. В данном случае ключевое слово package сообщает компилятору ActionScript о необходимости создания пакета. Сразу после ключевого слова package указывается желаемое имя пакета — в предыдущем примере оно заменено выражением имяПакета (здесь и далее код, выделенный подобным образом, например имяПакета, обозначает текст, который должен быть заменен программистом). Затем с помощью фигурных скобок { и } отмечаются начало и конец содержимого пакета. Чтобы добавить класс в пакет, необходимо записать исходный код класса между фигурными скобками, как показано в следующем примере:
package имяПакета {
Сюда помещается исходный код класса }
С технической точки зрения фигурные скобки в описании пакета являются своего рода оператором, называемым оператором блока. Как и описания, операторы относятся к директивам, или, иначе говоря, к базовым инструкциям программы. Оператор блока обозначает начало и конец группы директив, которые должны рассматриваться как логическое целое. Оператор блока описания пакета называется блоком пакета или иногда телом пакета.
Полный список операторов языка ActionScript указан в гл. 10.
Принято (но вовсе не обязательно) именам пакетов присваивать следующую иерархическую структуру:
доменное имя организации, которая занимается разработкой программы, записанное в обратном порядке;
точка (*);
общее описание содержимого пакета.
Например, пакету, содержащему классы для картографического приложения, разрабатываемого фирмой Acme Corp, (доменное имя acme.com), может быть присвоено имя com. acme. тар, как показано в следующем примере:
package com.acme.map { }
Обратите внимание, что имя домена верхнего уровня сот предшествует имени домена нижнего уровня acme (то есть в имени пакета составляющие доменного имени записываются в обратном порядке).
Й
Доменные имена гарантированно являются уникальными благодаря системе авторизованных регистраторов доменов верхнего уровня. Иными словами, использование доменного имени вашей организации в начале имени пакета позволит избежать конфликтов имен с кодом, разработанным другими организациями.
Теперь попытаемся воспользоваться пакетами в нашей программе создания виртуального зоопарка. Чтобы упростить пример, назовем пакет zoo, без указания доменного имени организации. Для описания пакета zoo добавим следующий код в файл VirtualZoo . as:
package zoo { }
После того как мы добавили пакет в файл VirtualZoo. as, необходимо изменить расположение файла в файловой системе, чтобы оно соответствовало имени созданного пакета. Вследствие требований, налагаемых всеми компиляторами языка ActionScript корпорации Adobe, исходный файл, содержащий класс (или другое описание) внутри пакета, должен размещаться в структуре папок, соответствующей имени пакета. Например, файл, содержащий пакет с именем com. gamecompany. zoo, должен размещаться в папке zoo, вложенной в папку gamecompany, которая, в свою очередь, вложена в папку сот (то есть com/gamecompany/zoo). Таким образом, мы создадим новую папку с именем zoo в файловой структуре нашей программы и перенесем файл VirtualZoo. as в эту папку. Файловая структура исходных файлов программы тогда будет выглядеть следующим образом:
virtual zoo
|- src
|- zoo
|- VirtualZoo.as
Теперь, когда у нас есть описание пакета, добавим в него класс VirtualZoo.
Описание класса
Для создания нового класса используется описание класса, как показано в следующем обобщенном коде:
class Идентификатор { }
Описание класса начинается с ключевого слова class, за которым указывается имя класса (в приведенном коде имя класса заменено выражением Идентифика тор). Термин «идентификатор» употребляется в значении «имя». Идентификаторы не должны содержать пробелы или тире и не могут начинаться с цифры. Каждое новое слово
в имени класса принято записывать с прописной буквы, как, например, в именах классов Date или Text Field (TextField — это предопределенный класс среды выполнения Flash, экземпляры которого представляют текст, отображаемый на экране).
Фигурные скобки ({ и }), следующие за выражением Идентификатор в предыдущем описании класса, являются оператором блока, точно так же, как и в примере описания пакета. Оператор блока описания класса называется блоком класса или иногда телом класса. Блок класса содержит директивы, описывающие характеристики и поведение класса и его экземпляров.
В следующем примере приводится описание класса VirtualZoo, являющегося основным классом для нашей игры-симулятора. Описание класса помещено в тело пакета, который описан в файле VirtualZoo. as:
package zoo {
class VirtualZoo {
}
}
Поскольку описание класса VirtualZoo находится в пакете zoo, полным именем класса (называемым полностью определенным именем класса) является zoo. VirtualZoo. Тем не менее в тексте мы будем использовать сокращенное, или неполное, имя класса — VirtualZoo.
Теперь, когда мы описали основной класс нашей программы, создадим еще один класс — VirtualPet. С его помощью мы создадим объекты, представляющие зверей в зоопарке.
Как и в случае с классом VirtualZoo, мы поместим код класса VirtualPet в пакет zoo, сохранив его в собственном файле VirtualPet. as внутри папки zoo. Исходный код из файла VirtualPet. as выглядит следующим образом: package zoo {
class VirtualPet {
}
}
Обратите внимание, что описание пакета может размещаться в нескольких исходных файлах. И хотя классы VirtualZoo и VirtualPet физически хранятся в разных AS-файлах, они принадлежат одному пакету zoo. Любой класс, описание которого принадлежит телу пакета с именем zoo, считается частью этого пакета независимо от имени файла размещения. В отличие же от описания пакета, описание класса не может находиться в нескольких файлах и должно полностью размещаться в одном файле.
Модификаторы управления доступом для классов. По умолчанию обращение к классу, входящему в состав определенного пакета, может осуществляться только из кода, принадлежащего тому же пакету. Чтобы класс был доступен для использования за пределами пакета, которому он принадлежит, мы должны описать этот класс с помощью атрибута public. Вообще говоря, атрибуты определяют порядок использования класса и его экземпляров в программе. Атрибуты указываются перед ключевым словом class в описании класса, как показано в приведенном ниже общем примере:
атрибут class ИдентификаторКласса { }
Например, чтобы добавить атрибут public к классу Virtual Pet, нужно использовать следующий код: package zoo {
public class Virtual Pet { }
Однако применение атрибута public в случае с классом Virtual Pet необязательно, поскольку класс VirtualPet используется только классом VirtualZoo, а тот, в свою очередь, может обращаться к классу VirtualPet (классы, принадлежащие одному пакету, могут всегда обращаться друг к другу). Таким образом, мы можем вернуться к исходному описанию класса VirtualPet, которое косвенным образом позволяет использовать этот класс только внутри пакета zoo: package zoo {
class VirtualPet {
}
Если мы хотим явно указать, что класс VirtualPet может быть использован только внутри пакета zoo, то в описание класса необходимо добавить атрибут internal, как показано ниже:
package zoo {
internal class VirtualPet {
Класс, описанный с помощью атрибута internal, может быть использован только внутри пакета, которому он принадлежит. Другим словами, описание класса с помощью атрибута internal совершенно не отличается от описания класса без использования каких-либо модификаторов управления доступом. Атрибут internal просто служит для однозначного толкования замысла программиста.
Атрибуты internal и public называются модификаторами управления доступом, поскольку управляют порядком доступа к областям внутри программы, в которых допускается использовать данный класс (к ним разрешен доступ данного класса).
В отличие от класса VirtualPet, класс VirtualZoo должен быть определен с помощью атрибута public, поскольку он является основным классом приложения.
Компиляторы, разработанные корпорацией Adobe, требуют, чтобы основной класс приложения был определен с помощью атрибута public.
Следующий код представляет обновленное описание класса VirtualZoo, содержащее обязательный атрибут public:
package zoo {
public class VirtualZoo {
Краткий обзор приложения «Зоопарк»
В настоящий момент наша игра состоит из двух классов: Virtual Zoo (основной класс) и VirtualPet (класс, представляющий зверей в виртуальном зоопарке). Оба класса принадлежат пакету zoo и хранятся в виде обычных текстовых файлов с именами VirtualZoo. as и VirtualPet. as соответственно.
Согласно требованию, предъявляемому компиляторами языка ActionScript корпорации Adobe, класс VirtualZoo описан с использованием атрибута public, поскольку является основным классом приложения. В отличие от класса VirtualZoo, класс VirtualPet может быть использован только внутри пакета zoo, поскольку описан с помощью атрибута internal.
В примере листинга 1.1 представлен весь имеющийся к настоящему времени код игры, а также кое-что новое — комментарии к исходному коду.
Комментарий к исходному коду — это примечание, которое предназначено только для программистов и не воспринимается компилятором в процессе компиляции кода.
Комментарии к исходному коду ActionScript бывают двух видов: однострочные, начинающиеся с двух слэшей (//), и многострочные, начинающиеся с последовательности /* и заканчивающиеся символами */.
Так выглядит однострочный комментарий:
// Эта информация только для нас. программистов
А так записывается многострочный комментарий:
/*
Эта информация только для нас, программистов */
Текущий код для нашей игры выглядит следующим образом.
Листинг 1.1. Игра «Зоопарк»
// Содержимое файла Virtual Zoo.as
package zoo {
public class VirtualZoo {
}
}
// Содержимое файла Virtual Pet.as
package zoo {
internal class VirtualPet {
}
}
Теперь приступим к разработке нашей программы, начав с метода-конструктора основного класса приложения — VirtualZoo.
Методы-конструкторы
Метод-конструктор (или сокращенно конструктор) — это отдельный набор инструкций, применяемых для инициализации экземпляров класса. Для создания метода-конструктора внутри блока класса помещается описание функции, как показано в следующем обобщенном коде:
class НекийКласс {
function НекийКласс ( ) {
}
Как видно из приведенного кода, описание метода-конструктора начинается с ключевого слова function. Затем следует имя метода-конструктора, которое должно полностью совпадать с именем класса (в том числе и регистр символов!). За именем метода-конструктора следует пара круглых скобок, в которых находится список параметров конструктора (они будут рассмотрены позднее). Фигурные скобки ({ и }), следующие за списком параметров, являются оператором блока — точно такие же операторы блока применяются в описаниях пакета и класса. Оператор блока метода-конструктора называется телом конструктора. Тело конструктора содержит директивы, используемые для инициализации экземпляров. Всякий раз, когда создается новый экземпляр класса НекийКласс, выполняются директивы, размещенные в теле конструктора (последовательно, сверху вниз). Процесс выполнения директив, размещенных в теле конструктора, называется выполнением конструктора.
Й
Методы-конструкторы описываются с использованием ключевого слова function, поскольку с технической точки зрения они являются определенным видом функций. Подробно функции будут рассмотрены в гл. 5.
Если метод-конструктор класса не описан явно, то компилятор языка ActionScript автоматически создает конструктор, не выполняющий никаких действий по инициализации новых экземпляров класса. Несмотря на это удобство, следуя хорошей практике программирования, желательно всегда включать конструктор в описание класса, даже если он не содержит никаких инструкций. Наличие пустого конструктора служит формальным признаком отсутствия конструктора в дизайне класса и создает необходимость включения в описание конструктора соответствующего комментария. Например:
class НекийКласс {
// Пустой конструктор. Для этого класса инициализация не требуется, function НекийКласс ( ) {
В отличие от прав доступа классов, права доступа методов-конструкторов не могут регулироваться при помощи модификаторов управления доступом. В языке ActionScript 3.0 все методы-конструкторы косвенно считаются открытыми (тем не менее, возможно, в будущих версиях языка будет включена поддержка и «за-
крытых» методов-конструкторов). В целях обеспечения однородности стиля в этой книге при описании методов-конструкторов используется модификатор управления доступом public, чем подчеркивается тот факт, что все методы-конструкторы должны быть открытыми. Пример использования этого правила приведен в следующем коде:
class НекийКласс {
public function НекийКласс ( ) {
Й
Причина, по которой в языке ActionScript 3.0 методы-конструкторы должны быть открытыми, обусловлена лимитом времени, выделенным на разработку спецификации языка ECMAScript 4, и непостоянством этой спецификации. Подробную информацию по этому вопросу можно найти в статье Шо Кувамото (Sho Kuwamoto) по адресу http://kuwamoto. org/2006/04/05/as3-on-the-lack-of-private-and-protected-constructors (Шо является руководителем команды разработчиков приложения Adobe Flex Builder).
Метод-конструктор основного класса приложения выполняет особую роль в программе. Он предоставляет возможность выполнения кода сразу после запуска приложения. По существу, метод-конструктор основного класса приложения считается точкой входа программы.
Следующий код содержит изменения, связанные с добавлением метода-конструктора в класс Virtual Zoo: package zoo {
public class Virtual Zoo {
public function Virtual Zoo ( ) {
}
}
}
Теперь у нашего приложения появилась служебная точка входа. В процессе запуска приложения среда выполнения Flash автоматически создаст экземпляр класса VirtualZoo и выполнит его метод-конструктор. Поскольку наше приложение создает виртуальный зоопарк, первое, что необходимо сделать в конструкторе класса VirtualZoo, — создать объект класса VirtualPet (то есть добавить животное в зоопарк). В следующем разделе мы рассмотрим процедуру создания объектов.
Создание объектов
Для создания объекта из класса (говоря техническим языком, создания экземпляра объекта) в сочетании с именем класса используется ключевое слово new. Ниже представлен обобщенный код, позволяющий описать данный подход:
new ИмяКласса
Например, чтобы создать объект из класса VirtualPet, используется следующий код:
new VirtualPet
Из одного класса можно создать несколько независимых объектов. В следующем примере описан код создания двух объектов VirtualPet:
new VirtualPet new VirtualPet
Синтаксис констант
Выше было сказано, что для создания нового объекта используется обобщенный синтаксис:
new ИмяКласса
Этот синтаксис применяется как к предопределенным, так и к пользовательским классам языка ActionScript. Например, следующий код демонстрирует создание нового экземпляра предопределенного класса Date, представляющего определенный момент времени:
new Date
Тем не менее для некоторых собственных классов язык ActionScript также предлагает альтернативный, более удобный способ создания экземпляров, называемый синтаксисом констант. К примеру, чтобы создать новый экземпляр класса Number, представляющий число с плавающей запятой 25,4, можно использовать удобную запись в виде константы:
25.4
Подобным же образом для создания нового экземпляра класса String, представляющего текст "hello", можно использовать запись в виде константы:
’’hello”
Наконец, чтобы создать новый экземпляр класса Boolean, представляющий логическое состояние true, можно также использовать запись в виде константы: true
Для создания нового экземпляра класса Boolean, представляющего логическое состояние false, снова применяется запись в виде константы:
false
Синтаксис констант также доступен для классов Ob j ect, Function, RegExp и XML. Синтаксис констант для класса Object приведен в гл. 15, для класса Function — в гл. 5, а для класса XML — в гл. 18. Информацию по синтаксису констант для класса RegExp можно найти в соответствующей документации корпорации Adobe.
Пример создания объекта: добавление животного в зоопарк
Теперь, когда нам известно, как создавать объекты, мы можем добавить объект класса VirtualPet в нашу программу по созданию виртуального зоопарка. Следующий код делает именно это: package zoo {
public class Virtual Zoo {
public function Virtual Zoo ( ) {
new Virtual Pet
}
}
}
Обратите внимание, что в этом коде обращение к классу VirtualPet происходит не по его уточненному имени zoo. VirtualPet, а по имени VirtualPet, являющемуся неуточненным, поскольку код из определенного пакета может обращаться к классам этого пакета по их неуточненным именам.
Однако код не может обращаться к классам в других пакетах. Чтобы получить доступ к открытому классу в другом пакете, необходимо использовать директиву import, которая записывается в следующем общем виде:
1mport имяПаке та.ИмяКласса;
В приведенном коде имяПакета — это имя пакета, которому принадлежит класс, а Имя - Класса — это имя открытого класса, который должен быть использован. Если указанный класс не является открытым, то его невозможно будет импортировать, поскольку классы, не являющиеся открытыми, не могут быть использованы за пределами пакета, которому принадлежат. Как только класс будет импортирован в программу, к нему можно обращаться по его неуточненному имени. Например, чтобы создать экземпляр предопределенного класса flash. media . Sound (который используется для загрузки и воспроизведения звуковых файлов), используется следующий код: import fl ash.media.Sound new Sound
Если импортировать класс на уровне пакета, то он будет доступен из любого места кода, принадлежащего телу пакета. Например, в следующем коде класс flash .media . Sound импортируется на уровне пакета, а затем создается экземпляр класса Sound в методе-конструкторе VirtualZoo: package zoo {
Import fl ash.media.Sound
public class VirtualZoo {
public function VirtualZoo ( ) {
new Sound ’
}
}
}
В случае возникновения конфликта между неуточненными именами классов для них необходимо использовать уточненные имена. Например, если собственный класс Sound описан в пакете zoo, обязательным является использование следующего кода, создающего экземпляр предопределенного класса flash. media. Sound (обратите внимание на использование уточненного имени):
new fl ash.media.Sound
Для создания же экземпляра класса Sound из пакета zoo нам бы пришлось использовать следующий код:
new zoo.Sound
Использование неуточненного имени класса (то есть Sound) само по себе приводит к ошибке, которая не позволяет откомпилировать программу. Ошибки, которые препятствуют компиляции, называются ошибками этапа компиляции.
Чтобы получить доступ ко всем открытым классам в другом пакете, необходимо использовать следующий обобщенный код:
Import имяПакета.*
Например, чтобы получить доступ ко всем открытым классам в пакете flash. media, используется такой код:
import fl ash.media.*
Обратите внимание, что классы, принадлежащие пакету без имени, помещаются в автоматически создаваемый пакет, который называется безымянным. Классы из безымянного пакета можно непосредственно использовать в любом месте кода программы, не применяя директиву import. Другими словами:
package {
// Классы, описанные здесь, принадлежат безымянному пакету
// и могут быть непосредственно использованы
// в любом месте кода программы
}
Тем не менее следует избегать размещения описаний классов в безымянном пакете, поскольку их имена могут конфликтовать с именами других классов (и других типов описаний), описанных в языке ActionScript, других программах или даже в других частях одной программы.
а
Говоря техническим языком, директива import открывает общедоступное пространство имен указанного пакета для текущей и всех вложенных областей видимости. Если вы новичок в программировании на языке ActionScript, то вам не стоит беспокоиться о техническом аспекте директивы import. Вся необходимая информация будет рассмотрена в следующих главах.
Теперь вернемся к нашей первоначальной задаче — созданию объектов в программе «Зоопарк». Вспомним следующий код, в котором создается новый объект класса VirtualPet:
package zoo {
public class Virtual Zoo {
public function Virtual Zoo ( ) {
new VirtualPet
}'
}
}
В приведенном коде успешно создается новый объект класса VirtualPet, но при этом возникает проблема: после создания объекта программа не имеет никакой возможности обращаться к нему. В результате она не может использовать новое животное или управлять им. Чтобы предоставить ей такую возможность — обращаться к объекту класса VirtualPet, — используются специальные переменные.
Переменные и значения
В языке ActionScript любой объект рассматривается как отдельный, независимый фрагмент данных (или информации), называемый значением. Не считая объектов, единственными допустимыми значениями в языке ActionScript являются специальные значения null и undefined, представляющие понятие «пустое значение». Переменная — это идентификатор (то есть имя), ассоциированный со значением. Например, переменной может являться идентификатор submits tn, который ассоциирован с объектом, представляющим кнопку на интерактивной странице в Интернете. Или переменной может быть идентификатор productDescr iption, ассоциированный с объектом String, описывающим некий продукт.
Переменные используются для отслеживания информации в программе. Они позволяют обращаться к объекту после его создания.
Существует четыре типа переменных: локальные переменные, переменные экземпляра, динамические переменные экземпляра и статические переменные. Первые два типа будут рассмотрены прямо сейчас, а остальные — далее в этой книге.
Локальные переменные
Локальные переменные применяются для временного отслеживания информации внутри метода-конструктора, метода экземпляра и статического метода или функции. Методы экземпляров и статические методы пока не рассматривались, поэтому сейчас сосредоточимся на использовании локальных переменных в методах-конструкторах.
Для создания локальной переменной внутри метода-конструктора используется описание переменной, как показано в следующем обобщенном коде. Обратите внимание, что описание начинается с ключевого слова va г и, как и все директивы, не содержащие операторов блока, завершается точкой с запятой. Точка с запятой обозначает конец директивы так же, как точка обозначает конец предложения в обычном языке: class НекийКласс {
public function НекийКласс ( ) {
van идентификатор = значение;
В этом коде идентификатор представляет имя локальной переменной, а значение — значение, ассоциированное с этой переменной. Знак равенства и элемент значение называют инициализатором переменной, поскольку они определяют исходное значение переменной.
Процесс ассоциирования переменной со значением называется присваиванием, установкой или записью значения переменной.
Если инициализатор переменной не указан, то компилятор языка ActionScript автоматически присваивает переменной значение по умолчанию, соответствующее ее типу. Эти значения будут рассмотрены в гл. 8.
Локальная переменная может быть использована только внутри того метода или функции, в которой она описана. После завершения выполнения метода или функции срок действия локальной переменной заканчивается и она больше не может быть использована в программе.
Для обращения к объекту класса VirtualPet, который был создан ранее в конструкторе класса Virtual Zoo, создадим локальную переменную. Локальной переменной присвоим имя pet, а для связывания объекта VirtualPet с этой переменной воспользуемся инициализатором. Привожу код:
package zoo {
public class Virtual Zoo {
public function Virtual Zoo ( ) { var pet = new VirtualPet;
Теперь, когда локальная переменная pet связана с объектом VirtualPet, она может быть использована для обращения к объекту и, следовательно, для управления им. Однако в настоящий момент объект Vi г tua 1 Ре t не может выполнять никакие действия, поскольку его функциональность еще не запрограммирована. Способы устранения этого недостатка будут рассмотрены в разд. «Параметры и аргументы конструктора», в котором я также расскажу, как предоставить животным возможность иметь имена.
Переменные экземпляра
Ранее было сказано, что класс используется для описания характеристик и поведения объекта определенного типа. В объектно-ориентированном программировании под характеристикой понимают определенную часть информации (то есть значение), которая описывает определенный аспект объекта, например ширину, скорость или цвет. Для отслеживания характеристик объекта применяются переменные экземпляра.
Переменная экземпляра — это переменная, принадлежащая определенному объекту. Обычно каждая переменная экземпляра описывает некую характеристику объекта, к которому принадлежит. Например, переменной экземпляра может являться идентификатор width, связанный со значением 150, которое определяет ширину кнопки интерфейса, или идентификатор shippingAddress, связанный со значением ул. Некая, 34, которое определяет адрес доставки объекта заказанного товара.
Как видно из следующего обобщенного кода, переменные экземпляра создаются с помощью размещаемых непосредственно в описании класса описаний переменных:
class НекийКласс {
var идентификатор = значение;
}
Добавление описания переменной экземпляра в описание класса приводит к автоматическому присоединению этой переменной к каждому экземпляру данно-
го класса. Как и в случае с локальными переменными, инициализатор описания переменной экземпляра задает исходное значение для создаваемой переменной. Однако, поскольку в переменных отдельно взятого экземпляра класса хранятся его собственные значения, исходное значение переменной экземпляра зачастую не указывается и присваивается позднее уже при выполнении программы.
В качестве примера добавим переменную экземпляра в класс VirtualPet. Она позволит отслеживать имя каждого объекта VirtualPet. Переменную экземпляра назовем именем petName:
package zoo {
Internal class VirtualPet {
var petName = "Unnamed Pet";
В результате использования приведенного кода переменная экземпляра petName будет автоматически присоединена к каждому новому экземпляру класса Viг tua 1 Реt. Исходным значением переменной petName для всех экземпляров класса Virtual Pet будет являться фраза Unnamed Ре t. Тем не менее после создания экземпляра класса VirtualPet переменной petName может быть присвоено новое, индивидуальное значение.
Для присвоения переменной экземпляра нового значения используется следующий обобщенный код:
объект.переменнаяЭкземпляра = значение
Здесь объект — это объект, переменной экземпляра которого присваивается значение; переменнаяЭкземпляра — это одна из переменных экземпляра объект (описанных в классе объекта); значение — это присваиваемое значение.
Воспользуемся описанной методикой, чтобы присвоить какое-либо имя объекту VirtualPet, созданному ранее в конструкторе класса VirtualZoo. Привожу код описания класса VirtualZoo, который содержит все предыдущие изменения:
package zoo {
public class VirtualZoo {
public function VirtualZoo ( ) {
var pet = new VirtualPet;
}
}
В соответствии с обобщенным кодом, используемым для присваивания нового значения переменной экземпляра, сначала необходимо обратиться к объекту. В данном случае для обращения к желаемому экземпляру класса VirtualPet применим локальную переменную pet:
pet
Затем ставится точка:
pet.
После этого записывается имя переменной экземпляра, значение которой нужно изменить — в данном случае petName:
pet.petName
В конце ставится знак = и указывается значение, которое необходимо присвоить переменной экземпляра. В нашем примере применим значение Stan:
pet.petName = "Stan"
Разве это не мило? Теперь у нашего животного появилась кличка. Мы делаем успехи.
Ниже приведен измененный код описания класса VirtualZoo:
package zoo {
public class VirtualZoo {
public function VirtualZoo ( ) {
var pet = new Virtual Pet:
pet.petName = "Stan";
Обратите внимание, что в предыдущем коде значение переменной экземпляра petName, описанной в классе Virtual Pet, присваивается через экземпляр класса VirtualPet, принадлежащего классу VirtualZoo. Следовательно, коду в классе VirtualZoo доступна переменная экземпляра petName. Когда класс разрешает доступ из других классов к своим переменным экземпляра, он позволяет этим классам вносить изменения в характеристики своих экземпляров.
Имя животного — это характеристика, которая естественным образом пригодна для внешнего изменения. Тем не менее некоторые переменные экземпляра могут представлять характеристики, которые не должны изменяться за пределами класса, содержащего описание данных переменных. Например, далее будет создана переменная экземпляра caloriesPerSecond, определяющая скорость, с которой у того или иного животного переваривается пища. Если переменной caloriesPerSecond присвоить слишком маленькое или слишком большое значение, то животное может постоянно хотеть есть или, наоборот, никогда не проголодаться. Поэтому, чтобы внешний код не смог присвоить неприемлемое значение переменной caloriesPerSecond, необходимо ограничить доступ к этой переменной. Для этого применяются модификаторы управления доступом.
Модификаторы управления доступом для переменных экземпляра. Модификатор управления доступом переменной экземпляра определяет уровень доступа к этой переменной в программе. Для описаний переменных экземпляра существуют следующие модификаторы управления доступом: public, internal, protected и private.
Модификаторы public и internal для переменных экземпляра обладают таким же эффектом, что и для классов. Переменная экземпляра, объявленная с использованием модификатора public, может быть доступна как внутри, так и снаружи пакета, в котором была описана; переменная экземпляра, объявленная с исполь-
зованием модификатора internal, может быть доступна только внутри пакета, в котором была описана.
Модификаторы protected и private накладывают еще большие ограничения, чем модификатор internal. Переменная экземпляра, объявленная с использованием модификатора protected, может быть доступна только для кода класса, содержащего описание этой переменной, или для кода потомков этого класса (мы еще не рассматривали наследование, поэтому, если вы незнакомы с объектно-ориентированным программированием, пока не обращайте внимания на этот модификатор). Переменная экземпляра, объявленная с использованием модификатора private, может быть доступна только для кода класса, содержащего описание этой переменной. Если при объявлении переменной никакой модификатор не указан, то используется модификатор internal (доступ внутри пакета).
Модификаторы управления доступом для переменных экземпляра перечислены в табл. 1.2.
Таблица 1.2. Модификаторы управления доступом переменной экземпляра
Атрибут
Размещение кода
public
internal
protected
private
Код в классе, содержащем описание переменной
Доступна
Доступна
Доступна
Доступна
Код в потомке класса, содержащего описание переменной
Доступна
Доступна
Доступна
Недоступна
Код в другом классе, принадлежащем пакету с описанием переменной
Доступна
Доступна
Недоступна
Недоступна
Код не принадлежит пакету с описанием переменной
Доступна
Недоступна
Недоступна
Недоступна
Если для описания переменных экземпляра класса использовать модификатор private, то информация каждого экземпляра будет полностью закрыта для случайного изменения, что позволит исключить зависимость внешнего кода от внутренней структуры класса и избежать случайного присваивания некорректных значений переменным экземпляра. Как правило, для каждой переменной экземпляра явно указывают модификатор управления доступом.
Использование модификатора public для описания переменных экземпляра является нежелательным, если это не заложено в архитектуру класса, однако если вы не уверены в том, какой модификатор управления доступом использовать, то его применение становится наиболее предпочтительным. Впоследствии, если понадобится, уровень доступа к переменной экземпляра может быть легко изменен, тем самым она станет более доступной. Если же переменная экземпляра будет описана с использованием модификатора public и внешний код уже использует эту переменную, то изменить модификатор управления доступом на private будет достаточно сложно.
В текущей версии нашего приложения, создающего виртуальный зоопарк, к переменной экземпляра petName происходит обращение как из класса VirtualPet, так и из класса Virtual Zoo, поэтому мы должны описать переменную petName
с использованием модификатора управления доступом internal, как показано в следующем коде:
package zoo {
internal class VirtualPet {
internal var petName = "Unnamed Pet";
}
}
Обратите внимание, что описание переменной экземпляра с использованием атрибута internal аналогично описанию переменной без использования какого- либо модификатора управления доступом (поскольку модификатор internal применяется по умолчанию).
В оставшейся части книги вы найдете множество примеров использования переменных экземпляра, ознакомиться с которыми можно будет позднее. Пока же вернемся к разработке программы создания виртуального зоопарка.
В настоящий момент структура класса Virtual Pet допускает возможность присваивания значения переменной petName каждого объекта Virtual Pet по желанию. Однако если необходимо гарантировать, что имя будет присвоено каждому животному, то можно использовать параметры конструктора, которые описываются в следующем разделе. .
Параметры и аргументы конструктора
Параметр конструктора — это особый тип локальной переменной, представляющий собой часть описания метода-конструктора. В отличие от обычных локальных переменных, исходное значение параметра конструктора может (или в некоторых случаях должно) задаваться из внешнего кода при создании нового экземпляра класса.
При создании параметров конструктора вместо ключевого слова var между круглыми скобками описания функции конструктора просто указывается желаемое имя и инициализатор переменной, как показано в следующем обобщенном коде: class Не кийКласс {
function НекийКласс (идентификатор = значение) {
В данном коде идентификатор — это имя параметра конструктора, а значение — исходное значение параметра.
Если возникает необходимость описать несколько параметров в методе-конструкторе, то их имена перечисляются через запятую, как показано в обобщенном коде ниже (обратите внимание на разрывы строк, которые не только допустимы, но и широко распространены):
class НекийКласс {
function НекийКласс (идентификатор! = значение!, идентификатор2 = значение2.
идентификаторЗ = значениеЗ) {
По умолчанию исходное значение параметра конструктора определяется значением, указанным в описании этого параметра. Однако значение параметра конструктора можно определить и при создании объекта, используя следующий обобщенный код: new НекийКласс(значение1. значениеЗ, значениеЗ)
В этом коде значение!, значениеЗ и значениеЗ — это значения, присваиваемые в указанном порядке параметрам метода-конструктора класса НекийКласс. Значение, присваиваемое параметру конструктора при создании объекта (как показано в предыдущем коде), называется аргументом конструктора. Использование аргумента конструктора в качестве значения параметра конструктора называется передачей этого значения конструктору.
Если описание параметра конструктора не содержит инициализатора переменной, то исходное значение этого параметра указывается через аргумент конструктора. Такой параметр называется обязательным параметром конструктора. Следующий обобщенный код демонстрирует создание класса с одним обязательным параметром конструктора (обратите внимание, что описание параметра не содержит инициализатора переменной): class НекийКласс {'
function НекийКласс (обязательныйПараметр) { }
Любой код, создающий экземпляр предыдущего класса, обязательно должен указывать значение параметра обязательныйПараметр с помощью аргумента конструктора, как показано ниже: -
new НекийКласс^значение)
Отсутствие аргумента конструктора для обязательного параметра приведет к ошибке либо на этапе компиляции программы (если для компиляции выбран строгий режим), либо на этапе выполнения программы (если программа была откомпилирована в стандартном режиме). Различия между строгим и стандартным режимами компиляции будут рассмотрены в гл. 7.
При создании нового объекта без аргументов конструктора некоторым программистам нравится оставлять пустые круглые скобки. Например, многие разработчики предпочитают записывать
new Virtual Pet( )
а не
new Virtual Pet
Выбор формата целиком и полностью является вопросом стиля. Язык Actionscript допускает использование обоих этих форматов. Тем не менее в среде программистов на языке ActionScript большее предпочтение отдается первому стилю (со скобками), нежели второму (без скобок). Поэтому начиная с этого момента при создании новых объектов в примерах кода из данной книги будут всегда использоваться круглые скобки, даже при отсутствии аргументов конструктора.
Используя в качестве примера предыдущий обобщенный код, описывающий метод-конструктор класса с параметром, добавим новый метод-конструктор в класс VirtualPet и опишем один обязательный параметр конструктора — name. Значение параметра name будет присвоено переменной экземпляра petName каждого объекта VirtualPet.
Рассмотрим основной код, содержащий описание нового метода-конструктора без каких-либо инструкций:
package zoo {
internal class VirtualPet {
Internal var petName = "Unnamed Pet";
public function VirtualPet (name) {
}
Поскольку параметр name является обязательным, его исходное значение должно определяться извне при создании объекта. В связи с этим мы должны обновить код, создающий объект VirtualPet в конструкторе VirtualZoo. До этого наш код выглядел так:
package zoo {
public class VirtualZoo {
public function VirtualZoo ( ) {
var pet = new VirtualPet;
pet.petName = "Stan";
}
}■
Это же обновленная версия, в которой значение Stan передается конструктору класса VirtualPet, а не присваивается переменной petName созданного экземпляра:
package zoo {
public class VirtualZoo {
public function VirtualZoo ( ) {
var pet = new V1rtualPet("Stan");
В этом коде при создании экземпляра класса VirtualPet выполняется конструктор этого класса и аргумент конструктора Stan присваивается параметру name. Из этого следует, что внутри конструктора класса VirtualPet параметр name можно использовать для присваивания значения Stan переменной экземпляра petName нового объекта VirtualPet. Для этого необходимо указать значение переменной petName, используя выражение идентификатора.
Выражения и выражения идентификатора рассматриваются в следующем разделе.
Выражения
Представление значения в исходном коде программы на ActionScript называется выражением. Например:
new Date( )
Здесь new — выражение, представляющее новый объект (в данном случае объект Date).
Подобным же образом следующий код демонстрирует константное выражение, представляющее объект Number со значением 2.5:
.5
Отдельные выражения с помощью операторов могут быть объединены в составное выражение, значение которого вычисляется на этапе выполнения программы. Оператор — это встроенная команда, позволяющая объединять, преобразовывать значения (называемые операндами оператора) или манипулировать ими. Каждый оператор записывается либо с помощью символа, например +, либо с помощью ключевого слова, например instanceof.
К примеру, оператор умножения, используемый для нахождения произведения двух чисел, записывается с помощью символа *. Следующий код демонстрирует составное выражение для умножения числа 4 на число 2,5:
* 2.5
При выполнении этого кода вычисляется результат произведения и все составное выражение (4 * 2.5) заменяется одним результатом вычисления (10). Процесс определения значения выражения называется его вычислением.
С полным списком операторов языка ActionScript можно ознакомиться в гл. 10.
Чтобы представить значения, неизвестные при компиляции программы (на этапе компиляции), однако указываемые или вычисляемые при выполнении программы (на этапе выполнения), применяются имена переменных. После вычисления программой выражения, содержащего имя переменной, это имя заменяется соответствующим значением переменной. Процесс замены имени переменной ее значением называется извлечением, получением или чтением значения переменной.
Для примера рассмотрим составное выражение, в котором два значения, представленные именами переменных, перемножаются: quantity * price
Переменные quantity и price являются своего рода контейнерами для значений, которые будут определены в процессе выполнения программы. Значение переменной quantity, например, может задаваться пользователем, а значение переменной price может быть получено из базы данных. Далее предположим, что переменной quantity присвоено значение 2, а переменной price — значение 4.99. При вычислении выражения quantity * price программа заменит имя переменной
quantity значением 2, а имя переменной price — значением 4.9 9. Таким образом, в процессе вычисления это выражение будет заменено следующим:
2 * 4.99
Окончательным результатом выражения является значение 9.98.
Говоря формальным языком, выражение, состоящее только из одного имени переменной, например quantity, называется выражением идентификатора.
Теперь попробуем применить выражение идентификатора в программе по созданию виртуального зоопарка.
Присваивание вдной переменной значения другой переменной
В процессе написания кода программы мы остановились на создании метода-конструктора для класса VirtualPet. Метод-конструктор описывает единственный параметр name, значение которого определяется во внешнем коде, отвечающем за создание объекта в классе VirtualZoo. Ниже представлен исходный код классов VirtualPet и VirtualZoo, включающий в себя все произведенные ранее изменения:
// Класс VirtualPet
package zoo {
Internal class VirtualPet {
internal var petName = "Unnamed Pet";
// Класс VirtualZoo package zoo {// Класс VirtualZoo package zoo {public function VirtualPet (name) { }
// Класс VirtualZoo package zoo {
// Класс VirtualZoo package zoo {
public class VirtualZoo {
public function VirtualZoo ( ) {
var pet = new VirtualPet("Stan");
Теперь, после того как мы ознакомились с процессом применения переменных в выражениях, параметр name может быть использован для присвоения значения Stan переменной экземпляра petName нового объекта VirtualPet.
Как нам уже известно, чтобы присвоить новое значение переменной экземпляра, используется следующий обобщенный код:
объект.переменнаяЭкземпляра = значение
В соответствии с этим кодом, чтобы присвоить значение переменной, сначала необходимо указать объект. В данном случае таким объектом является создаваемый экземпляр класса VirtualPet. Для обращения к нему используется ключевое слово this — автоматически передаваемый параметр, значением которого является создаваемый объект.
В теле метода-конструктора создаваемый объект называется текущим. Для обращения к нему применяется ключевое слово this.
После ключевого слова this ставится точка, а затем указывается имя переменной экземпляра, которой необходимо присвоить значение, — в данном случае petName.
this.petName
После чего ставится знак равенства и указывается значение, которое должно быть присвоено переменной экземпляра:
this.petName = value
В нашем случае присваиваемым значением является значение параметра name. • Таким образом, вместо слова value просто подставляется имя параметра name: this.petName = name
На этапе выполнения среда Flash (в которой выполняется программа) заменит параметр name из предыдущего кода значением, переданным конструктору класса VirtualPet. Это значение впоследствии будет присвоено переменной экземпляра petName.
Код класса VirtualPet с внесенными изменениями выглядит следующим образом:
package zoo {
Internal class VirtualPet {
Internal var petName = "Unnamed Pet";
public function VirtualPet (name) {
this.petName = name;
}
}
Теперь, когда значение переменной экземпляра petName присваивается в конструкторе класса VirtualPet, ненужное исходное значение Unnamed Pet, указанное в описании переменной petName, может быть удалено. Описание переменной petName до настоящего момента выглядело следующим образом:
Internal var petName = "Unnamed Pet":
После изменений описание этой переменной примет следующий вид (обратите внимание на отсутствие инициализатора переменной):
package zoo {
Internal class VirtualPet {
internal var petName;
public function VlrtualPet (name) { thls.petName = name;
}
Й
Выражение, которое используется для присваивания значения переменной, например thls.petName = name, называется выражением присваивания. В качестве знака равенства в таких выражениях применяется оператор, называемый оператором присваивания.
Копии и ссылки. В предыдущем разделе был описан процесс присваивания значения одной переменной другой. В частности, переменной экземпляра pet Name было присвоено значение параметра name. Вот этот код:
thls.petName = name;
Результат присваивания значения одной переменной другой зависит от типа присваиваемого значения.
В случаях, когда значением переменной-источника в выражении присваивания является экземпляр класса String, Boolean, Number, int или uint, среда выполнения создает копию этого значения и присваивает созданную копию целевой переменной. После окончания процедуры присваивания в системной памяти образуются две независимые версии исходного значения — само исходное значение и его копия. Переменная-источник указывает, или ссылается, на первоначальное значение в памяти. Целевая переменная ссылается на новое значение в памяти.
В других случаях, когда значением переменной-источника в выражении присваивания выступает экземпляр пользовательского класса или экземпляр предопределенного класса языка ActionScript, за исключением классов String, Boolean, Number, int или uint, программа связывает вторую переменную непосредственно со значением первой. После присваивания в памяти будет существовать только одна копия значения, на которую будут ссылаться обе переменные. В подобной ситуации говорят, что переменные совместно используют ссылку на один объект в памяти. Очевидно, что изменения, вносимые в объект через первую переменную, будут доступны и для второй переменной. Например, рассмотрим код, в котором создаются две локальные переменные — а и Ь, после чего значение переменной а присваивается переменной Ь.
van а = new V1rtualPet("Stan");
var b = a;
В процессе выполнения первой строки приведенного выше кода средой Flash будет создан новый объект класса VlrtualPet, после этого он будет записан в память и связан с локальной переменной а. В результате выполнения второй строки кода объект VlrtualPet, на который уже ссылается переменная а, будет связан с локальной переменной Ь. Изменения, вносимые в объект VlrtualPet через переменную а, будут естественным образом отражаться на переменной Ь, и наоборот. Например, если переменной экземпляра petName присвоить новое значение, используя код b. petName = "Tom", а затем обратиться к этой переменной с помощью конструкции a .petName, то будет получено то же значение — Тот.
Или, если переменной экземпляра petName присвоить значение, используя код а. petName = "Ken", а затем обратиться к данной переменной с помощью конструкции b. petName, будет получено то же значение — Кеп.
Переменная, связанная с объектом, не содержит этот объект, а лишь ссылается на него. Сам объект хранится в системной памяти, а его сохранением занимается среда выполнения.
Переменная экземпляра для нашего животного
В одном из предыдущих разделов было сказано, что в тот момент, когда метод или функция, в которой описана локальная переменная, перестает выполняться, данная переменная прекращает свое существование. Чтобы обеспечить доступность созданного экземпляра Virtual Pet в классе после выполнения конструктора VirtualZoo, внесем изменения в этот класс. Вместо того чтобы присваивать объект VirtualPet локальной переменной, присвоим этот объект переменной экземпляра pet. Она будет закрытой, поэтому обращаться к ней можно только из кода класса VirtualZoo. Ниже представлен код, отражающий описанные изменения:
package zoo {
public class VirtualZoo {
private var pet;
public function VirtualZoo ( ) {
this.pet = new V1rtualPet("Stan");
}
}
На протяжении нескольких предыдущих разделов мы рассматривали вопросы использования переменных экземпляра для наделения объектов характеристиками класса. Теперь сосредоточим свое внимание на использовании методов экземпляра для переноса поведения класса на его объекты.
Методы экземпляра
Метод экземпляра — это отдельный набор инструкций, выполняющих определенную задачу, связанную с данным объектом. По сути, методы экземпляра описывают действия, которые может выполнять тот или иной объект. Например, в предопределенном классе Sound (экземпляры которого представляют звуки в программе) описан метод экземпляра с именем play, который позволяет начать воспроизведение звука. Аналогичным образом в предопределенном классе TextField (экземпляры которого представляют текст на экране) описан метод с именем setselection, позволяющий изменять количество выделенных символов в текстовом поле.
Для создания метода экземпляра используется описание функции внутри блока класса, как показано в следующем обобщенном коде:
class НекийКласс {
function идентификатор ( ) {
В данном коде ключевое слово function обозначает начало описания метода экземпляра. Затем указывается имя метода экземпляра, которое может являться любым допустимым идентификатором (как уже упоминалось, имена идентификаторов не могут содержать пробелы или тире, а также не должны начинаться с цифры). За именем метода следует пара круглых скобок, содержащих список параметров метода, которые будут рассмотрены позднее. Фигурные скобки { и }, следующие за списком параметров, являются оператором блока. Оператор блока метода экземпляра называется телом метода. Оно содержит директивы, используемые для выполнения определенной задачи.
Поскольку методы с технической точки зрения являются определенным видом функций, при описании методов экземпляра используется ключевое слово function. Подробно функции рассматриваются в гл. 5.
Для выполнения кода, описанного в теле определенного метода, используется выражение вызова, как показано в следующем обобщенном коде. Обратите внимание на обязательное использование скобок ( ), следующих за именем метода.
объект.имяМетода( )
В этом коде имяМетода — это имя метода, код которого должен быть выполнен, а объ - ект — ссылка на определенный экземпляр, который будет использоваться для выполнения задачи, представленной указанным методом. Использование выражения вызова для выполнения кода, описанного в теле метода экземпляра, называется вызовом метода объекта (или вызовом метода через объект). Кроме того, применяется термин «активизация», обозначающий вызов.
При упоминании имени определенного метода в большинстве документации используется оператор круглых скобок (). Например, в обычной документации чаще пишут setSelection(), а не просто setselection. Использование оператора скобок помогает различать в тексте имена методов и переменных.
Теперь реализуем представленные концепции в нашей программе создания виртуального зоопарка.
Чтобы наделить наших животных способностью питаться, добавим новую переменную экземпляра и новый метод экземпляра в класс VirtualPet. Новая переменная экземпляра — currentcalories — будет отслеживать количество пищи, съеденной каждым животным, в виде числового значения. В новом методе экземпляра eat ( ) будет реализована концепция принятия пищи путем добавления 100 калорий к текущему значению переменной экземпляра currentcalories. В конечном счете метод eat ( ) будет вызываться в ответ на действие пользователя — кормление животного.
Следующий код демонстрирует описание переменной currentcalories. Для исключения возможности влияния внешнего кода на количество калорий, которым обладает каждый экземпляр Virtual Pet, переменная currentcalories описана с использованием модификатора private. Обратите внимание, что каждому новому экземпляру VirtualPet изначально присваивается 1000 калорий, package zoo {
Internal class VirtualPet {
internal var petName:
private var currentCalorles = 1000;
public function VirtualPet (name) { this.petName = name;
Следующий код демонстрирует описание метода экземпляра е a t ( ), тело которого пока не содержит никаких инструкций. Обратите внимание, что описания методов экземпляра размещаются после описания метода-конструктора класса, а описания переменных экземпляра — до описания метода-конструктора класса.
package zoo {
Internal class VirtualPet {
Internal var petName;
private var currentCalorles = 1000;
public function VirtualPet (name) { this.petName = name:
}
function eat ( ) {
}
}
Хотя тело метода eat ( ) пока не содержит никаких инструкций, подобного описания вполне достаточно, чтобы вызвать метод еаt ( ) для объекта Virtual Ре t, как показано в следующей обновленной версии класса Virtual Zoo:
package zoo {
public class VlrtualZoo { private var pet;
public function VlrtualZoo ( ) {
this.pet = new V1rtualPet("Stan");
// Вызов метода eat( ) для объекта VirtualPet, ссылка на который
// хранится в переменной pet this.pet.eat( );
Предположим, что в теле метода eat ( ) к значению переменной currentCalor ies того объекта, через который был вызван метод eat ( ), необходимо добавить 100. Для обращения к этому объекту используется ключевое слово this.
В теле метода экземпляра объект, через который был вызван данный метод, называется текущим объектом. Для обращения к текущему объекту используется ключевое слово this. Обратите внимание, что понятие «текущий объект» может применяться как к объекту, создаваемому в методе-конструкторе, так и к объекту, через который был вызван метод экземпляра.
Добавление числового значения (например, 100) к значению существующей переменной (например, currentcalories) включает в себя два этапа. Сначала вычисляется результат сложения значения переменной и числового значения, а затем полученная сумма присваивается переменной. Обобщенный код выглядит следующим образом:
некаяПеременная = некаяПеременная + числовоеЗначение
В случае с методом eat ( ) к значению переменной currentcalories текущего объекта (this) мы собираемся добавить 100. В результате получаем следующий код:
this.currentCalorles = this .currentCal ones + 100;
В качестве удобной альтернативы предыдущему коду язык ActionScript предлагает оператор сложения с присваиванием +=, который, если используется с числами, прибавляет значение, находящееся справа от оператора, к переменной, находящейся слева от него, как показано в следующем коде:
this.currentCalorles += 100;
Код класса VirtualPet теперь выглядит следующим образом:
package zoo {.
Internal class VirtualPet {
Internal var petName;
private var currentCalorles = 1000;
public function VirtualPet (name) { this.petName = name;
}
function eat ( ) {
this.currentCalorles += 100;
}
}
}
Начиная с текущего момента, при каждом вызове метода eat ( ) экземпляра VirtualPet значение переменной currentCalorles данного экземпляра будет увеличиваться на 100. Например, следующий код, взятый из конструктора класса VirtualZoo, увеличивает значение переменной currentCalorles экземпляра VirtualPet, ссылка на который хранится в переменной pet, до 1100 (поскольку
всем экземплярам VirtualPet изначально присваивается значение 1000 калорий).
this.pet = new V1rtualPet("Stan");
this.pet.eat( ):
Обратите внимание, что, несмотря на закрытость характеристики cur rentCalor ies класса VirtualPet, значение этой переменной может быть изменено в результате выполнения действия (принятия пищи), инициированного внешним кодом — экземпляром VirtualPet. Однако в некоторых случаях даже методы экземпляра должны быть закрытыми. Как и в случае с переменными экземпляра, чтобы контролировать уровень доступа методов экземпляра в программе, используются модификаторы управления доступом.
Модификаторы управления доступом для методов экземпляра
Для описаний методов экземпляра применяются те же модификаторы управления доступом, что и для переменных экземпляра: public, internal, protected и private. Доступ к методу экземпляра, объявленному с использованием модификатора public, может быть осуществлен как внешними командами по отношению к пакету, в котором метод создан, так и внутренними. Метод экземпляра, объявленный с использованием модификатора internal, доступен только для внутренних команд пакета, в котором он описан. Метод экземпляра, объявленный с использованием модификатора protected, может быть доступен только для кода класса, содержащего описание этого метода, или для кода потомков этого класса (мы еще не рассматривали наследование, поэтому, если вы незнакомы с объектно-ориентированным программированием, не обращайте внимания на этот модификатор). Метод экземпляра, объявленный с использованием модификатора private, может быть доступен только для кода класса, содержащего описание этого метода. В ситуации, когда при описании метода ни один из модификаторов не был указан, применяется модификатор internal (доступ внутри пакета).
Использование модификаторов управления доступом при описании методов класса позволяет реализовать на практике принцип «черного ящика». В объектно-ориентированном программировании каждый объект рассматривается как черный ящик, управляемый с помощью набора внешних смоделированных кнопок. Человек, испбльзующий эти кнопки, ничего не знает (и, впрочем, для него это неважно) о действиях, происходящих внутри объекта, — его интересует только то, чтобы объект выполнил желаемое действие. Открытые методы экземпляра класса являются теми самыми кнопками, с помощью которых программист может заставить объект выполнить определенную операцию. Закрытые методы экземпляра класса используются для выполнения других внутренних операций. Таким образом, чтобы заставить экземпляры данного класса выполнять определенные действия, в описании класса должны быть открыты только те методы, которые требуются внешнему коду. Методы, предназначенные для выполнения внутренних операций, должны быть описаны с использованием модификаторов private, protected или internal.
В качестве аналогии представьте себе, что объект — это автомобиль, водителем которого является программист, использующий объект, а производитель — это программист, создавший класс объекта. Чтобы управлять автомобилем, водителю совершенно не обязательно знать, как устроен двигатель. Он просто использует педаль газа, чтобы набирать скорость, и рулевое колесо, чтобы поворачивать. Задача ускорения автомобиля в ответ на нажатие педали газа решается производителем автомобиля, но никак не водителем.
При разработке собственных классов вопросам удобства их использования должно уделяться не меньше внимания, чем вопросам их внутренней реализации. Не забывайте регулярно ставить себя на место «водителя». В идеальном случае всякий раз, когда вносятся изменения во внутреннюю реализацию класса, открытые методы класса, используемые внешним кодом, должны изменяться незначительно или не изменяться совсем. Если на автомобиль устанавливается новый двигатель, то у водителя по-прежнему должна сохраняться возможность пользоваться педалью газа. По мере возможности изменяемые части классов необходимо держать «за кулисами», в закрытых методах.
wВ терминах объектно-ориентированного программирования открытые методы с открытыми
переменными экземпляра класса иногда называются внешним интерфейсом класса, или API класса (Application Programming Interface — программный интерфейс приложения). Термин API также используется для обозначения общих функций, предоставляемых целой группой классов. Например, предопределенные классы среды выполнения Flash, отвечающие за отображение содержимого на экране, называются экранным API. Подобным образом набор пользовательских классов, используемых для визуализации трехмерных объектов, может называться 3D API. Помимо классов в состав программных интерфейсов могут входить и другие программные описания (например, переменные и функции).
В языке Actionscript термин «интерфейс» имеет дополнительное техническое значение, которое мы рассмотрим в гл. 9. Во избежание путаницы для описания открытых методов и переменных экземпляра класса термин «интерфейс» в этой книге не применяется.
Теперь, возвращаясь к программе по созданию виртуального зоопарка, добавим модификатор управления доступом в описание метода eat ( ) класса VirtualPet. Поскольку метод eat ( ) является одним из служебных средств, с помощью которых внешний код может управлять объектами VirtualPet, он будет реализован как открытый. Привожу измененный код:
package zoo {
Internal class VirtualPet {
Internal var petName;
private var currentCalorles = 1000:
public function VirtualPet (name) {
this.petName = name:
}
public function eat ( ) { this.currentCalorles += 100;
}
}
}
В таком виде метод eat ( ) класса VirtualPet является жестким, поскольку всякий раз при вызове этого метода к значению переменной currentcalories прибавляется одно и то же количество калорий. В конечном счете необходимо добиться, чтобы количество добавляемых калорий изменялось динамически в зависимости от типа пищи, которую предлагает пользователь. Чтобы предоставить внешнему коду возможность указывать количество добавляемых в процессе кормления калорий при вызове метода е a t ( ), придется воспользоваться параметрами метода.
Параметры и аргументы метода
Как и в случае с параметрами конструктора, параметр метода — это особый тип локальной переменной, представляющий собой часть описания метода, но, в отличие от локальных переменных, исходное значение параметра метода может (или в некоторых случаях должно) задаваться из внешнего кода.
Для описания параметра метода применяется следующий обобщенный код (обратите внимание, что описание параметров метода имеет такую же структуру, как и при описании параметров конструктора):
function имяМетода (идентификатор! = значение!,
• идентификатор2 = значение2, идентификаторп = значениеп) {
}
В приведенном выше коде идентификатор! = значение!, идентификатор2 = значе- ние2, ... идентификаторп = значениеп — список имен параметров метода и их соответствующих исходных значений. По умолчанию исходным значением параметра метода является значение, указанное в описании этого параметра. Тем не менее значение параметра метода может быть дополнительно указано в выражении вызова, как показано в следующем обобщенном коде:
имяМетода(значение!, значение2... значениеп)
В данном коде имяМетода — это имя вызываемого метода, а значение! f значение2. . . valuen — это список значений, которые по порядку присваиваются параметрам метода имяМетода. Значение параметра метода, указанное через выражение вызова (как показано в предыдущем коде), называется аргументом метода. Использование аргумента метода для задания значения параметра метода называется передачей этого значения в метод.
Как и в случае с параметрами конструктора, исходное значение параметра метода, если его описание не содержит инициализатора переменной, должно быть указано через аргумент метода этого параметра. Такой параметр называется обязательным параметром метода.
Следующий обобщенный код демонстрирует описание метода с одним обязательным параметром (обратите внимание, что описание параметра не содержит инициализатора переменной):
function имяМетода (обязательныйПараметр) {
Любой код, вызывающий предыдущий метод, обязательно должен указывать значение параметра обязательныйПараметр с помощью аргумента метода, как показано в следующем обобщенном коде:
имяМетода(значение)
Отсутствие аргумента метода для обязательного параметра неизбежно приведет к ошибке либо на этапе компиляции программы (если для компиляции программы выбран строгий режим), либо на этапе ее выполнения (если программа была откомпилирована в стандартном режиме).
Теперь обновим описание метода eat ( ) класса VlrtualPet,включивобязательный параметр numbe rOfCalories. Вызов метода е a t ( ) всякий раз будет обеспечивать увеличение значения переменной currentcalories текущего объекта назначение параметра numberOf Calories. Привожу обновленный код метода eat ( ): package zoo {
Internal class Virtual Pet {
Internal var petName;
private var currentCalorles = 1000;
public function VlrtualPet (name) { this.petName = name;
}
public function eat (numberOfCalorles) { this.currentCalorles += numberOfCalorles;
} }
Поскольку параметр numberOfCalorles является обязательным, его исходное значение должно указываться во внешнем коде при вызове метода eat ( ). Попробуем реализовать это требование для объекта VlrtualPet, создаваемого в конструкторе VirtualZoo. До этого момента код конструктора VirtualZoo выглядел следующим образом: package zoo {
public class VirtualZoo { private var pet:
public function VirtualZoo ( ) {
this.pet = new VirtualPet("Stan"); this.pet.eat( );
}
}
}
Обновленная версия кода, где в метод eat ( ) передается значение 50, будет выглядеть так:
package zoo {
public class VirtualZoo {
private var pet;
public function Virtual Zoo ( ) {
this.pet = new V1rtualPet("Stan"):
this.pet.eat(50):
}
}
}
Поскольку выражение вызова из данного кода присваивает значение 5 0 параметру numberOf Calories метода eat ( ), его выполнение увеличивает значение переменной currentcalories экземпляра Virtual Pet, на который ссылается переменная ре t, на 5 0. Это значит, что после выполнения кода конструктора значение переменной currentcalories экземпляра, на который ссылается переменная pet, будет равно 1050.
Возвращаемые значения метода
Подобно тому, как методы могут принимать значения в виде аргументов, они также могут генерировать возвращаемые значения. Для возврата значения из метода используется оператор возврата, как показано в следующем обобщенном коде: function имяМетода ( ) { return значение;
}
ш Значение, возвращаемое методом, называется возвращаемым значением, или результатом, метода.
После выполнения метода его возвращаемое значение становится значением выражения вызова, с помощью которого был вызван этот метод.
Чтобы продемонстрировать использование возвращаемых значений метода, добавим новый метод в класс VirtualPet, который позволит определить возраст животного и вернуть получившийся результат. Для определения возраста животного нам понадобятся базовые знания о классе Date, экземпляры которого представляют определенные моменты времени. Для создания нового экземпляра класса Date используется следующий код: new Date( )
Для внутреннего представления времени в экземплярах класса Date используется «количество миллисекунд до или после полуночи 1 января 1970 года». Например, время «одна секунда после полуночи 1 января 1970 года» выражается числом 1000. Подобным образом, время «полночь 2 января 1970 года» выражается числом 86 400 000 (один день — это 1000 мс х 60 с х 60 мин х 24 ч). По умолчанию новый объект Date представляет текущее время на локальной системе.
Для обращения к числовому значению «миллисекунд с 1970 года» определенного объекта Date используется переменная экземпляра time. Например, в следующем коде создается новый экземпляр класса Date и затем возвращается значение его переменной time:
new Date( ).time:
В результате выполнения этого кода 24 января 2007 года в 17:20 было получено значение 1 169 677 183 875, представляющее точное количество миллисекунд между полночью 1 января 1970 года и временем выполнения кода (то есть 17:20 24 января 2007 года).
Теперь вернемся к классу Virtual Pet. Чтобы иметь возможность определять возраст объектов Virtual Pet, необходимо сохранить точное время создания каждого такого объекта. Для сохранения времени создания каждого объекта создадим экземпляр предопределенного класса Date в конструкторе класса VirtualPet и присвоим этот экземпляр переменной creationTime экземпляра класса VirtualPet. Привожу этот код:
package zoo {
Internal class VirtualPet {
Internal var petName;
private var currentCalorles = 1000;
private var creationTime;
public function VirtualPet (name) {
this.creationTime = new Date( );
this.petName = name;
}
public function eat (numberOfCalorles) { this.currentCalorles += numberOfCalorles;
}
}
}
Использование переменной creationTime позволяет определить возраст любого объекта VirtualPet путем вычитания времени создания объекта из текущего времени. Это вычисление производится с помощью нового метода get Аде ( ): public function getAge ( ) {
var currentTIme = new Date( );
var age = currentT1me.t1me - this.creationTime.time;
}.
Чтобы возвратить вычисленный возраст объекта, воспользуемся оператором возврата:
public function getAge ( ) {
var currentTIme = new Date( );
var age = currentTime.time - this.creationTime.time;
return age;
}
Следующий код демонстрирует описание метода ge t Аде ( ) в контексте описания класса VirtualPet:
package zoo {
Internal class VirtualPet {
Internal var petName;
private var currentCalorles = 1000;
private var creationTime;
public function VirtualPet (name) {
this.creationTime = new Date( );
this.petName = name;
}
public function eat (numberOfCalories) { this.currentCalorles += numberOfCalories;
}
public function getAge ( ) {
var currentTime = new Date( );
var age = currentTime.time - this.creationTime.time;
return age;
}
}
Теперь воспользуемся возвращенным значением метода getAge ( ) в конструкторе класса VirtualZoo. Выражение вызова метода getAge ( ) рассмотрим в следующей обновленной версии конструктора VirtualZoo:
package zoo {
public class VirtualZoo {
private var pet;
public function VirtualZoo ( ) {
this.pet = new VirtualPet("Stan");
this.pet.getAge( );
}
}
}
В приведенном коде выражение pet. getAge ( ) возвращает числовое значение, представляющее количество миллисекунд, прошедших с момента создания объекта VirtualPet, на который ссылается переменная pet. Чтобы впоследствии можно было обращаться к этому значению в программе, его необходимо присвоить переменной, как показано в следующем коде:
package zoo {
public class VirtualZoo {
private var pet;
public function VirtualZoo ( ) {
this.pet = new Virtual Pet("Stan");
var age = this.pet.getAge( );
}
}
}
Позже, в более полной версии программы по созданию виртуального зоопарка, возраст будет выводиться на экран.
Возвращаемые значения методов являются широко используемой составляющей объектно-ориентированного программирования. В книге будут постоянно описываться возвращаемые значения. Точно так же вы постоянно будете применять их при разработке собственных классов.
Обратите внимание, что выражение вызова можно объединять с остальными выражениями с помощью операторов. Например, в следующем коде для вычисления половины возраста животного используется оператор деления:
pet.getАде( ) / 2
Подобным же образом в следующем коде создаются два объекта класса Virtual Pet, выполняется сложение возрастов созданных объектов, и затем полученная сумма присваивается локальной переменной totalAge.
package zoo {
public class VirtualZoo {
private var petl;
private var pet2;
public function VirtualZoo ( ) {
this.petl = new VirtualPet("Sarah");
this.pet2 = new VirtualPetCLois"):
var totalAge = this.petl.getAge( ) + this.pet2.getAge( );
}
}
}
Обратите внимание, что, когда оператор возврата не возвращает никакого значения, он просто завершает выполнение текущего метода. Например:
public function некийМетод ( ) {
// Код, размещенный здесь (перед оператором возврата), будет выполнен
return;
// Код, размещенный здесь (после оператора возврата), выполнен не будет }
Значением выражения вызова, используемого для вызова метода, который не имеет возвращаемого значения (или вообще не имеет оператора возврата), является специальное значение undefined. Операторы возврата, не возвращающие никакого значения, обычно используются для завершения методов на основании некоторого условия.
Подписи методов
Иногда в документации и при обсуждении вопросов, связанных с объектно-ориентированным программированием, встречается понятие «подпись метода», обозначающее совокупность имени метода и списка его параметров. В языке ActionScript подпись метода также включает в себя тип данных каждого параметра и тип возвращаемого методом значения. Типы данных параметров и типы возвращаемых значений рассматриваются в гл. 8.
Например, подписью для метода eat ( ) является:
eat(numberOfCalories)
А подпись метода get Age ( ) представляет собой просто:
getAge( )
На этом закончим рассмотрение основных вопросов, связанных с методами экземпляров. Прежде чем завершить эту главу, рассмотрим последний вопрос, относящийся к терминам языка ActionScript.
Члены и свойства
В терминологии языка ActionScript 3.0 совокупность переменных и методов объекта называется свойствами объекта, где свойство означает «имя, связанное со значением или методом».
В некоторых справочниках по языку ActionScript (в основном это касается справочников от корпорации Adobe) понятие «свойство» также используется для обозначения переменной экземпляра. Для того чтобы избежать путаницы, вызванной данным противоречием, в настоящей книге понятие «свойство» употребляться не будет.
В случае необходимости будет использоваться традиционное понятие объектноориентированного программирования — члены экземпляра (или просто члены), — обозначающее совокупность методов и переменных экземпляра. К примеру, можно сказать, что «radius не является членом класса В ох», подразумевая, что в классе Box не описаны методы или переменные с именем radius.
Обзор программы по созданию виртуального зоопарка
В этой главе было введено большое количество новых концепций и понятий. Теперь попрактикуемся в их использовании, проанализировав программу «Зоопарк» последний раз в этой главе.
Приложение, имитирующее зоопарк, состоит из двух классов: VirtualZoo (основной класс) и virtual Pet (класс, представляющий животных в зоопарке).
Сразу же после запуска нашего приложения экземпляр класса VirtualZoo автоматически создается средой выполнения Flash (поскольку класс VirtualZoo является основным классом приложения). В результате создания экземпляра класса VirtualZoo выполняется метод-конструктор VirtualZoo. Метод-конструктор VirtualZoo создает экземпляр класса VirtualPet, передавая в качестве единственного аргумента конструктора значение Stan.’
В рассматриваемом классе VirtualPet описаны три переменных экземпляра: petName, currentcalories и creationTime. Эти переменные экземпляра
определяют кличку, количество пищи в желудке и дату рождения каждого животного.
С помощью константного выражения каждому новому объекту VirtualPet в качестве исходного значения переменной currentcalories присваивается 1000. Исходным значением переменной creationTime является объект класса Date, указывающий время создания объекта VirtualPet. При создании объекта VirtualPet переменной petName присваивается значение обязательного параметра конструктора name. Параметр конструктора name получает свое значение через аргумент конструктора, который указывается в выражении new, используемом для создания объекта VirtualPet.
В классе VirtualPet описаны два метода экземпляра: eat ( ) и getAge ( ). Метод eat ( ) увеличивает значение переменной currentcalories на указанную величину. Метод getAge ( ) вычисляет и возвращает возраст животного в миллисекундах.
Текущая версия программы по созданию виртуального зоопарка представлена в листинге 1.2.
Листинг 1.2. Программа «Зоопарк»
// Класс VirtualPet package zoo {
Internal class VirtualPet {
internal var petName;
private var currentCalories = 1000;
private var creationTime;
public function VirtualPet (name) {
this.creationTime = new Date( );
this.petName = name;
}
public function eat (numberOfCalories) {
this.currentCalories += numberOfCalories;
}
public function getAge ( ) {
var currentTime = new Date( );
var age = currentTime.time - this.creationTime.time; return age;
} }
}
// Класс Virtual Zoo
package zoo {
public class VirtualZoo {
private var pet;
public function Virtual Zoo ( ) { this.pet = new Virtual Pet("Stan");
}
}
}
В этой главе мы достигли больших успехов. Тем не менее еще многое предстоит узнать. Когда будете готовы приступить к дальнейшему изучению основ языка ActionScript 3.0, переходите к следующей главе.
Условные операторы и циклы
В этой главе мы отвлечемся от общих тем, касающихся классов и объектов. Вместо этого мы сосредоточимся на двух важнейших типах инструкций: условных операторах и циклах. Условные операторы используются для добавления логики в программу, а циклы применяются для выполнения повторяющихся задач. И условные операторы и циклы являются чрезвычайно распространенными, и их можно увидеть практически в каждой программе, написанной на языке Action Script. Как только мы рассмотрим условные операторы и циклы, мы вернемся к изучению классов и объектов и продолжим разработку нашей программы по созданию виртуального зоопарка.
Все примеры кода, представленные в этой главе, не принадлежат какому-либо функционирующему классу или программе. Тем не менее в реальной программе условные операторы и циклы могут использоваться внутри методов экземпляра, методов-конструкторов, статических методов, функций, непосредственно в теле класса или пакета и даже за пределами тела пакета.
Условные операторы
Условный оператор — это такой тип оператора, который исполняется только при выполнении определенного условия. Условные операторы позволяют программе выбирать один из нескольких возможных путей дальнейшего исполнения в зависимости от ее текущего состояния.
В языке ActionScript существует два различных условных оператора: оператор if и оператор switch. Кроме того, в языке ActionScript есть и простой условный оператор ? :, который кратко рассматривается в гл. 10. Подробную информацию об операторе ? : можно найти в справочнике по языку ActionScript корпорации Adobe.
Оператор if
Оператор if напоминает развилку на дороге. Он содержит два блока кода и выражение (называемое условным выражением?), которое определяет блок кода для дальнейшего выполнения. Для создания оператора if применяется следующий обобщенный код:
if (услов ноеВыражен ие) {
блокКода!
} else {
блокКода2
}
Когда при выполнении программы на языке ActionScript встречается оператор i f, среда выполнения Flash выполняет либо инструкции блокКода!, либо инструкции блокКода2 в зависимости от значения выражения условноеВыражение. Если результатом выраженияусловноеВыражение является значение true типа Boolean, то выполняется первый блок кода. Если результатом выраженияусловноеВыражение является значение false типа Boolean, то — второй блок кода. Если результатом выражения условноеВыражение является значение другого типа, отличного от Boolean, то среда выполнения Flash автоматически преобразует результат выражения услов - ноеВыражение в объект типа Boolean и использует результат преобразования при выборе блока кода для исполнения.
Правила преобразования значений различных типов в объект типа Boolean описаны в табл. 8.5.
Например, в следующем операторе i f результатом указанного условного выражения является значение true типа Boolean, поэтому переменной greeting присваивается значение Hello, а не Bon j our.
var greeting;
// Результатом условного выражения является значение true, поэтому... if (true) {
// ..-.выполняется этот код greeting = "Hello";
} else {
// Этот код не выполняется .
greeting = "Bonjour";
Конечно, условное выражение, использованное в предыдущем примере, в реальной программе применялось бы крайне редко, если вообще применялось бы, поскольку его результатом всегда является одно и то же значение. В подавляющем большинстве классов результат условного выражения определяется динамически в процессе выполнения на основании информации, вычисляемой программой или вводимой пользователем.
Например, предположим, что мы создаем общедоступный сайт, один из разделов которого посвящен азартным играм. Играть в них могут пользователи, возраст которых не менее 18 лет. Во время регистрации на сайте статус каждого пользователя загружается из базы данных. Загруженный статус присваивается переменной gamblingAuthorized. Если значением этой переменной является true, то возраст пользователя составляет 18 лет или более; значение false означает, что пользователю менее 18 лет.
Когда пользователь пытается войти в раздел с азартными играми, приложение использует следующий условный оператор, чтобы определить, можно ли предоставить доступ к этому разделу:
if (gamblingAuthorized) {
// Расположенный здесь код отображает интерфейс раздела с азартными играми } else {
// Представленный здесь код отображает сообщение
// "Доступ запрещен"
Зачастую условным выражением оператора if является либо выражение равенства, либо выражение отношения. Для сравнения двух значений и представления результата этого сравнения в виде значения типа Boolean (то есть либо true, либо false) в выражениях равенства и выражениях отношения используются операторы равенства и операторы отношения. Например, в следующем выражении равенства используется оператор равенства (==) для сравнения выражения Mike с выражением Margaret:
"Mike" == "Margaret"
Результатом предыдущего выражения является значение false типа Boolean, поскольку выражение Mike не равно выражению Margaret.
Подобным образом для сравнения значения 6 со значением 7 в следующем выражении отношения применяется оператор «меньше чем» (<):
б < 7
Результатом этого выражения является значение true типа Boolean, поскольку 6 меньше 7.
Как видно из предыдущих примеров, экземпляры класса String сравниваются по отдельным символам, а при сравнении экземпляров классов Number, int и uint сравниваются математические величины, хранящиеся в этих экземплярах. Обратите внимание, что при сравнении строк учитывается регистр, например выражение а не равно выражению А. Правила, используемые при сравнении значений (в каких случаях два значения равны между собой или одно значение больше или меньше другого), можно найти в описании операторов ==, ===, < и > в справочнике по языку ActionScript корпорации Adobe.
Теперь рассмотрим пример оператора if, в качестве условного выражения которого используется знак равенства. Предположим, что мы создаем программу для интернет-магазина с виртуальной корзиной для покупок. В программе создана переменная экземпляра numitems, отражающая текущее количество товаров в корзине пользователя. Если корзина пуста, то программа выдает сообщение Ваша корзина пуста. В ином случае программа выдает сообщение Количество товаров в вашей корзине: п (где п обозначает количество товаров в корзине).
В следующем примере кода показано, как в программе может быть создано сообщение о текущем статусе корзины пользователя. Присваиваемое значение переменной basketstatus зависит от значения переменной numitems.
var basketstatus;
if (numitems == 0) {
basketstatus = "Ваша корзина пуста";
} else {
basketstatus = "Количество товаров в вашей корзине; " + numitems;
}
Если значение переменной numitems в предыдущем примере кода равно нулю, то программа присваивает переменной basketstatus следующее выражение:
"Ваша корзина пуста"
В противном случае программа присваивает переменной basketstatus следующее выражение:
"Количество товаров в вашей корзине: " + numitems
Обратите внимание на использование оператора конкатенации (+) в предыдущем выражении. Он преобразует числовое значение, хранящееся в переменной numitems, в строку и объединяет ее со строкой "Количество товаров в вашей корзине: ”. Результирующим значением станет объединение двух выражений. Например, если значение переменной numitems равно 2, то результатом операции конкатенации будет следующая строка:
"Количество товаров в вашей корзине: 2"
Оператор if без условия else
Когда в условии else оператора i f нет необходимости, то его можно просто опустить. Предположим, что в нашем приложении для интернет-магазина необходимо реализовать следующую возможность: пользователь, заказавший более десяти товаров, получает скидку 10 %. При подсчете общей стоимости покупки в процессе оформления заказа мы можем использовать код, аналогичный следующему:
if (numitems > 10) {
totalPrlce = totalPrlce * .9: }
Если значение переменной numitems будет меньше И, то значение переменной totalPrlce останется неизмененным.
Цепочка операторов If
Когда необходимо выбрать один из более чем двух возможных путей выполнения программы, следует объединить вместе несколько операторов if, как показано в следующем обобщенном коде для условия с тремя возможными результатами: if (условноеВыражение!) { блокКода!
} else if СусловноеВыражение2) {
блокКода2 } else {
блокКодаЗ
Предположим, что нужно разработать многоязычное приложение, которое выводит приветствие для своих пользователей на одном из четырех языков: английском, японском, французском или немецком. При запуске программы мы просим пользователя выбрать язык и присваиваем соответствующей переменной language одно из следующих строковых значений: "english", ”japanese", "french" или "german" (обратите внимание, что названия языков начинаются со строчных букв; обычно при сравнении строк все буквы записываются либо в нижнем, либо
в ВЕРХНЕМ регистре). Чтобы создать приветствие на выбранном языке, используем следующий код:
var greeting;
if (language == "engllsh") { greeting = "Hello”:
} else 1f (language == "Japanese”) { greeting = "Konnichlwa”;
} else 1f (language == "french”) { greeting = "Bonjour":
} else 1f (language == "german") { greeting = "Guten tag";
} else {
// Расположенный здесь код может быть использован // для отображения сообщения об ошибке, // вызванной неправильно выбранным языком
Если при выполнении предыдущего кода значением переменной language является "english", то переменной greeting присваивается значение "Hello". Если значением переменной language является "japanese", "french" или "german", то переменной greeting присваивается значение "Konnichlwa", "Bonjour" или "Guten tag" соответственно. Если переменная language не имеет ни одного из перечисленных значений (возможно, из-за возникшей ошибки в программе) — "english", "japanese", "french" или "german", — то выполняется код, относящийся к последнему оператору else.
Теперь, когда мы познакомились с оператором if, рассмотрим оператор switch, предлагаемый языком ActionScript в качестве удобного способа создания условия с несколькими возможными результатами.
Поведение оператора switch можно реализовать и с помощью операторов if, однако, когда речь идет об условиях с несколькими возможными результатами, оператор switch считается более понятным, чем if.
Оператор switch
Оператор switch позволяет выполнять один из нескольких возможных блоков кода в зависимости от результата одного условного выражения. Оператор switch можно представить в следующем обобщенном виде:
switch (условноеВыражение) {
case выражение!;
блокКода!
break;
case выражение2:
• блокКода2 break;
default: блокКодаЗ
}
В предыдущем коде условноеВыражение — это выражение, которое среда выполнения Flash попытается последовательно сопоставить со всеми указанными выражениями case сверху вниз. Выражения case записываются с помощью оператора-метки case и завершаются двоеточием. Если результат выражения условноеВыражение совпадает со значением выражения case, то выполняются все инструкции, расположенные за данной меткой case, включая инструкции во всех последующих блоках этого оператора! Чтобы предотвратить выполнение последующих блоков, необходимо использовать оператор break в конце каждого блока. Если же мы хотим, чтобы несколько условий инициировали выполнение одного и того же блока кода, то оператор break можно опустить. Например, в следующем примере кода блокКода! выполняется в тех случаях, когда результат выраженияусловноеВыражение совпадает со значением либо выражения выражение!, либо выражения выражениеВ:
switch (условноеВыражение) {
case выражение!:
case выражениеВ:
блокКода!
break;
case выражениеЗ:
блокКодаЗ
break;
default;
блокКодаЗ
}
Если результат выражения условноеВыражение не совпадает ни с одним из значений выражений case, то выполняются все инструкции, расположенные за меткой default.
Метка default обычно указывается после всех выражений case, однако с технической точки зрения ее можно поместить в любом месте оператора switch. Более того, эта метка не является обязательным атрибутом рассматриваемого оператора. Если default не указана и результат выраженияусловноеВыражение не совпадает ни с одним из значений выражений case, то выполнение программы продолжается с инструкции, расположенной сразу за оператором switch (то есть код, размещенный внутри оператора switch, просто не выполняется).
Следующий пример кода демонстрирует реализацию условия для создания приветствия на нескольких языках, которое было рассмотрено в предыдущем разделе, с использованием оператора switch вместо цепочки операторов if. Оба подхода работают одинаково, однако можно утверждать, что код с использованием оператора switch легче для чтения и зрительного восприятия.
var greeting;
switch (language) {
case "engllsh":
greeting = "Hello";
break;
case "Japanese":
greeting = "Konn1ch1wa"; break;
case "french":
greeting = "Bonjour";
break;
case "german":
greeting = "Guten tag"; break;
default:
// Расположенный здесь код может быть использован для отображения
// сообщения об ошибке, вызванной неправильно выбранным языком
В операторе switch при сравнении результата выражения условноеВыражение со значениями выражений case неявно используется оператор строгого равенства (===), а не оператор равенства (==). Описание различий между этими операторами можно найти в справочнике по языку ActionScript корпорации Adobe.
Циклы
В предыдущем разделе мы узнали, что условный оператор позволяет единожды выполнить блок кода, если результатом его условного выражения является значение t rue. Цикл, в свою очередь, позволяет многократно выполнять блок до тех пор, пока результатом его условного выражения является значение true.
В языке ActionScript существует пять различных типов циклов: while, do-while, for, for-in и for-each-in. Первые три типа обладают схожей функциональностью, однако их синтаксис отличается. Оставшиеся два типа используются для доступа к динамическим переменным экземпляра объекта. Мы еще не рассматривали динамические переменные экземпляра, поэтому пока остановимся на первых трех типах циклов. Информацию по циклам f or-in и f or-each-in можно найти в гл. 15.
Оператор while
Структурно оператор while во многом напоминает if: основной оператор содержит блок кода, который выполняется только в том случае, если результатом заданного условного выражения является значение true:
while (условноеВыражение) {
блокКода
Если результатом выраженияусловноеВыражение является true, то выполняются инструкции из блока блокКода (называемого телом цикло?). Однако, в отличие от оператора i f, когда выполнение блока блокКода завершается, управление снова передается на начало оператора while (то есть среда выполнения Flash «возвращается» к его началу). Второе выполнение оператора while ничем не отличается от первого: вычисляется
результат выражения условноеВыражение и, если его значением является true, снова выполняется блок блокКода. Этот процесс будет продолжаться до тех пор, пока результатом выраженияусловноеВыражение не станет false, после чего выполнение программы будет продолжено с инструкции, расположенной сразу за оператором while.
Если выражениеусловноеВыражение никогда не возвращает значение false, то цикл будет выполняться бесконечно и среда выполнения Flash будет вынуждена сгенерировать ошибку, которая остановит цикл (а вместе с ним и весь исполняемый в данный момент код). Чтобы избежать подобной ситуации, в блок блокКода цикла while обычно включается инструкция, которая модифицирует выражение условноеВыражение, заставляя его вернуть значение false при выполнении определенного условия.
Например, рассмотрим следующий цикл, определяющий результат возведения числа 2 в третью степень (то есть 2 умножается на 2 и умножается на 2), — тело цикла выполняется два раза: var total = 2;'
var counter = 0;
while (counter < 2) {
total = total * 2;
counter = counter +
При выполнении предыдущего цикла while среда выполнения Flash сначала вычисляет результат условного выражения:
counter < 2
Поскольку значение переменной counter равно 0 и, соответственно, меньше 2, значением условного выражения является true; таким образом, Flash выполняет тело цикла:
total = total * 2; counter = counter + 1;
В теле цикла переменной total присваивается ее текущее значение, умноженное на 2, а к значению переменной counter прибавляется 1. С этого момента значением переменной total является 4, а переменной counter — 1. После выполнения тела цикла наступает время повторить его.
При выполнении цикла во второй раз среда Flash снова проверяет значение условного выражения. На этот раз значением переменной counter является 1, что по-прежнему меньше 2, поэтому значением условного выражения является true. Следовательно, Flash выполняет тело цикла во второй раз. Как и в предыдущий раз, переменной total присваивается ее текущее значение, умноженное на 2, а к значению переменной counter прибавляется 1. С этого момента значением переменной total является 8, а переменной counter — 2. После выполнения тела цикла снова наступает время повторить его. •
При выполнении цикла в третий раз среда Flash снова проверяет значение условного выражения. На этот раз значением переменной counter является 2, что уже не меньше 2, поэтому значением условного выражения является false и выполнение цикла прекращается. В процессе вычислений значение переменной total, которое
изначально равнялось 2, было дважды умножено на само себя, поэтому результатом является 8.
В реальном коде для выполнения экспоненциальных вычислений следует использовать функцию Math.pow(), а не оператор цикла. Например, для возведения 2 в третью степень используется конструкция Math.pow(2, 3).
Хотя предыдущий цикл не вызывает особого восторга, он обладает потрясающей гибкостью. Например, если бы мы хотели возвести, скажем, число 2 в степень 16, мы могли бы просто обновить значение в условном выражении, чтобы тело цикла выполнялось 15 раз, как показано в следующем примере: var total = 2;
var counter = 0;
while (counter < 15) {
total = total * 2;
counter = counter + 1;
// Здесь значение переменной total равно 65 536
Одно выполнение тела цикла называется итерацией. Соответственно, переменная, которая контролирует выполненное количество итераций данного цикла — в нашем случае это counter, — называется итератором или, реже, индексом цикла. Традиционно, для именования итераторов циклов используется буква i, как показано в следующем примере кода:
var total = 2;
var 1 = 0;
while (1 < 15) {
total = total * 2;
1=1+1:
}
Последняя строка в теле цикла из предыдущего примера называется корректором цикла, поскольку она до известной степени корректирует значение итератора, что в конечном счете приводит к завершению цикла. В данном случае корректор цикла прибавляет 1 к значению итератора. Эта операция является настолько распространенной, что для нее был создан собственный оператор: оператор инкремента, записываемый как ++. Оператор инкремента прибавляет 1 к значению своего операнда. Например, в следующем примере к значению переменной п прибавляется 1: var п = 0 ;
п++;// значение переменной п теперь равно 1
В следующем примере кода наш цикл реализован уже с использованием оператора инкремента:
var total = 2;
var 1 = 0;
while (1 < 15) {
total = total * 2;
Противоположностью оператора инкремента является оператор декремента, записываемый как —. Он вычитает 1 из значения своего операнда. Например, в следующем примере из значения переменной п вычитается 1: var п = 4;
п--;// значение переменной п теперь равно 3
Оператор декремента зачастую используется в циклах, где значение итератора цикла уменьшается от указанной величины, а не увеличивается (как это происходило в предыдущих примерах). На протяжении этой книги мы будем использовать как оператор инкремента, так и оператор декремента. Однако вообще первый используется гораздо чаще, чем второй.
Обработка списков с помощью циклов
Циклы обычно используются для обработки списков элементов.
Предположим, что мы создаем регистрационную форму, в которой пользователь должен указать адрес электронной почты. Перед отправкой формы на сервер мы хотим проверить, содержит ли указанный адрес электронной почты символ @. Если этого символа нет, мы предупредим пользователя, что введенный адрес электронной почты является неверным.
Обратите внимание, что в этом примере наша концепция «правильного» адреса является крайне упрощенной. Например, в нашем коде адреса, начинающиеся или заканчивающиеся символом @ либо содержащие несколько символов @, считаются корректными. Тем не менее пример демонстрирует первый скромный шаг в создании алгоритма проверки адресов электронной почты.
Чтобы проверить наличие символа @ в адресе электронной почты, мы используем цикл, трактующий адрес как список из отдельных символов. Перед выполнением цикла мы создадим переменную isValidAddress и присвоим ей значение false. Тело цикла будет выполняться один раз для каждого символа в адресе электронной почты. При выполнении тела цикла в первый раз проверяется, является ли первый символ адреса электронной почты символом @. Если является, то в теле цикла переменной is Vai idAddres s присваивается значение true, что указывает на корректность адреса электронной почты. При выполнении тела цикла во второй раз проверяется, является ли второй символ адреса электронной почты символом @. И снова, если этот символ найден, в теле цикла переменной isValidAddress присваивается значение true, что указывает на корректность адреса электронной почты.
Тело цикла продолжает проверять каждый символ в адресе электронной почты до тех пор, пока не останется ни одного символа. Если после выполнения цикла значение переменной isValidAddress по-прежнему равно false, значит, символ @ не был найден и, следовательно, адрес электронной почты считается некорректным. С другой стороны, если значение переменной isValidAddress равно true, значит, символ @ был найден и, следовательно, адрес электронной почты считается корректным.
Теперь взглянем на реальный код проверки. В настоящем приложении мы бы начали работу с получения адреса электронной почты, указанного пользователем.
Тем не менее, чтобы упростить этот пример, мы укажем адрес электронной почты вручную, как показано ниже: var address = "me@moock.org";
После этого мы создадим переменную isValidAddress и присвоим ей значение false:
var. isValidAddress = false;
Затем создадим итератор цикла:
var i = 0;•
Далее определим оператор while для нашего цикла. Мы хотим, чтобы тело цикла выполнялось один раз для каждого символа строки, хранящейся в переменной address. Для получения количества символов в строке используется переменная экземпляра length класса String. Например, значением выражения ”abc”. length является 3. Это значит, что строка abc состоит из трех символов. Таким образом, общая структура нашего цикла выглядит следующим образом:
while (1 < address.length) {
i++;
Всякий раз при выполнении тела цикла мы должны получить один из символов строки, хранящейся в переменной address, и сравнить его со строкой ”@”. Если полученный символ совпадает с ней, то присвоим переменной isValidAddress значение true. Чтобы получить определенный символ строки, воспользуемся методом экземпляра charAt ( ) собственного класса String. Название метода является сокращением фразы character at («символ в позиции»). Методу charAt ( ) необходимо передать один аргумент — число, указывающее позицию, или индекс, получаемого символа. Нумерация символов начинается с нуля. Например, результатом следующего выражения вызова является значение ”т”, поскольку именно этот символ находится в позиции 0:
address.charAt(0);.
Подобным образом результатом следующего выражения вызова является значение " @ ", поскольку в позиции 2 находится символ @:
address.charAt(2):
В теле цикла индекс получаемого символа задается динамически через итератор i, как показано в следующем примере кода:
while (i < address.length) {
if (address.charAt(i) == "@") { isValidAddress = true;
i++;
}.
Код проверки адреса электронной почты целиком:
var address = "me@moock.org";
var isValidAddress = false;
var i = 0;'
while (1 < address.length) {
1f (address. charAtd) == "@") {
IsValidAddress = true;
}
1++;
}
В качестве упражнения рассмотрим, как среда выполнения Flash будет выполнять предыдущий оператор while.
Сначала среда Flash вычисляет значение условного выражения:
1 < address.length
Здесь значение переменной i равно 0, а значение выражения address . length равно 12. Число 0 меньше 12, поэтому результатом условного выражения является true, среда выполнения Flash выполняет тело цикла:
1f (address.charAtd) == "@") {
IsValidAddress = true:
1++;
В теле цикла среда Flash сначала должна определить, нужно ли выполнять код в условном операторе:
1f (address.charAtd) == "@") {
IsValidAddress = true;
Чтобы определить, нужно ли выполнять код в предыдущем условном операторе, Flash проверяет, совпадает ли результат выражения вызова address . charAt (i) со строкой ”@”. При выполнении тела цикла в первый раз значение переменной i равно 0, поэтому выражение вызова address . charAt (i) преобразуется в выражение address . charAt (0), которое, как мы видели раньше, возвращает символ "т" (первый символ в адресе электронной почты). Символ ”т” не равен символу ” @ ”, поэтому среда Flash не выполняет код в условном операторе.
После этого Flash выполняет корректор цикла, увеличивая значение переменной i на 1:
1++;
После выполнения тела цикла наступает время повторить его.
При выполнении цикла во второй раз среда Flash снова проверяет значение условного выражения. На этот раз значение переменной i равно 1, а значение выражения address . length по-прежнему равно 12. Число 1 меньше 12, поэтому результатом условного выражения является значение true и Flash выполняет тело цикла во второй раз. Как и раньше, в теле цикла определяется, нужно ли выполнять код в условном операторе:
1f (address.charAtd) == "@") {
IsValidAddress = true;
}
Значение переменной i равно 1, поэтому выражение вызова address . charAt (i) преобразуется в выражение address . charAt (1), которое возвращает символ ”е”
(второй символ в адресе электронной почты). Символ ”е” вновь не равен символу " @ ", поэтому среда Flash не выполняет код в условном операторе.
После этого Flash выполняет корректор цикла, увеличивая значение переменной i до 2. И снова наступает время повторить цикл.
При выполнении цикла в третий раз Flash проверяет значение условного выражения. На этот раз значение переменной i равно 2, а значение выражения address . length по-прежнему равно 12. Число 2 меньше 12, поэтому результатом условного выражения является значение true и среда Flash выполняет тело цикла в третий раз. Как и раньше, в теле цикла определяется, нужно ли выполнять код в условном операторе:
if (address.charAt(1) == "@") {
1sValIdAddress = true;
}
Значение переменной i равно 2, поэтому выражение вызова address. char At (i) преобразуется в выражение addres s. charAt (2), которое возвращает символ "@". Символ ”@” равен символу ”@”, поэтому среда Flash выполняет код в условном операторе, присваивая переменной isValidAddress значение true. После этого Flash выполняет корректор цикла, увеличивая значение переменной i до 3.
Тело цикла будет выполнено еще девять раз. После завершения оператора цикла значением переменной isValidAddress будет являться true. Это сообщает программе, что адрес электронной почты можно с уверенностью отправлять на сервер для дальнейшей обработки.
Завершение цикла с помощью оператора break
Цикл, описанный в предыдущем разделе, был работоспособным, но неэффективным. В соответствии с упрощенной логикой гипотетического алгоритма проверки адреса, если адрес электронной почты содержит символ @, он считается корректным. Чтобы определить наличие символа @, в цикле из предыдущего раздела проверялся каждый отдельный символ в указанном адресе электронной почты. В случае с адресом me@mock.org тело цикла выполнялось целых 12 раз, хотя уже после проверки третьего символа было ясно, что адрес является корректным. Следовательно, девять раз тело цикла выполнялось без надобности.
Чтобы сделать цикл из предыдущего раздела более эффективным, можно воспользоваться оператором break, который сразу завершает выполнение цикла:
var address = "me@moock.org";
var IsValidAddress = false;
var i = 0;
while (i < address.length) {
if (address.charAt(1) == "@") { isValidAddress = true;
break;
i++;
}
В предыдущем примере кода, как только символ @ будет найден в строке, хранящейся в переменной address, переменной isValidAddress будет присвоено значение true, после чего оператор break завершит выполнение цикла.
П Если создаваемый вами цикл используется для поиска определенного элемента в списке, j то всегда применяйте оператор break для завершения цикла сразу после нахождения -14<; искомого элемента.
Упражнение: попробуйте модифицировать предыдущий цикл, чтобы адреса, начинающиеся или заканчивающиеся символом @ либо содержащие несколько символов @, считались некорректными. Кроме того, вы можете попробовать изменить цикл, чтобы некорректными считались и адреса, не содержащие ни одного символа . (точка).
Оператор do-while
Как уже отмечалось ранее, оператор while говорит среде выполнения Flash многократно выполнять блок кода до тех пор, пока результатом указанного условия является значение true. Из-за особенностей структуры цикла while его тело будет полностью пропущено, если при проверке условного выражения в первый раз его результатом не является значение true. Оператор do-while гарантирует, что тело цикла будет выполнено по крайней мере один раз с минимальными затратами. Синтаксис оператора do-while отчасти напоминает перевернутый синтаксис оператора while:
do {
блокКода
} while (условноеВыражение);
Описание цикла начинается с ключевого слова do, за которым следует блок блок- Кода тела цикла. При первом прохождении цикла do-while блок блокКода выполняется даже до проверки результата выражения условноеВыражение. Если после завершения блока блокКода результатом выражения условноеВыражение является значение true, то цикл начинается заново и блок блокКода выполняется снова. Цикл выполняется до тех пор, пока выражение условноеВыражение не примет значение false.
Оператор for
Цикл for, по существу, является синонимом цикла while, однако для его записи применяется более компактный синтаксис. Выражения инициализации и корректирования цикла размещаются вместе с условным выражением в верхней части цикла for. Вот его синтаксис:
for (инициализация; условноеВыражение; корректирование) {'
блокКода
}
Перед первой итерацией цикла for выполняется выражение инициализация (один, и только один раз). Обычно это выражение используется для присваивания исходного
значения одной или нескольким переменным итераторов. Как и в случае с другими циклами, если результатом выраженияусловноеВыражение является значение true, то блок блокКода выполняется. В противном случае цикл завершается. И хотя выражение корректирование размещается в заголовке цикла, оно выполняется в конце каждой итерации, перед очередной проверкой результата выражения условноеВыражение на допустимость продолжения цикла.
Вот пример цикла for, используемого для возведения числа 2 в степень 3:
var total = 2;
for (var 1 = 0; 1 < 2; 1++) {
total = total * 2;
}
Для сравнения приведем эквивалентный цикл while:
var total = 2; var 1=0;
while (1 < 2) {
total = total * 2;
i++;
Следующий цикл for используется для определения наличия символа @ в строке. С функциональной точки зрения этот цикл идентичен нашему предыдущему циклу while, который выполняет ту же задачу:
var address = "me@moock.org";
var IsValidAddress = false:
for (var 1 = 0; 1 < address.length; 1++) {
if (address.charAt(1) == "@") {
IsValidAddress = true; break;
}
Однажды применив на практике синтаксис цикла for, вы увидите, что он позволяет экономить место и в нем существует четкая грань между телом цикла и управляющими элементами.
Булева логика
Ранее в этой главе мы увидели, как принимаются логические решения с использованием условных выражений, которые возвращают логические значения. Решения принимались на основании одного фактора, например, «если значением переменной language является " eng lish”, отображать сообщение "Hello"». Но не вся программная логика настолько проста. В программах зачастую приходится рассматривать сразу несколько факторов в логике ветвлений (то есть принимать решение). Для объединения нескольких факторов в одном условном
выражении применяются логические операторы: | | (логическое ИЛИ) и && (логическое И).
Логическое ИЛИ
Оператор логического ИЛИ чаще всего применяется для инициирования определенного действия, когда выполняется по крайней мере одно из двух условий. Например, «если я голоден или испытываю жажду, я пойду на кухню». Оператор логического ИЛИ обозначается символами | |. Обычно символ | можно ввести, нажав одновременно клавишу Shift и клавишу с изображением обратного слэша (\), расположенную в правом верхнем углу большинства западных клавиатур. Оператор логического ИЛИ имеет следующий обобщенный вид:
выражение! || выражение2
Если оба выражения (выражение! и выражение2) или результаты вычисления этих выражений являются логическими значениями, то оператор логического ИЛИ возвращает значение true, когда результатом одного из выражений является true, а значение false только в том случае, когда результатом обоих выражений является false.
true || false false || true true || true false || falsetrue || false false || true true || true false || false// true, поскольку первый операнд равен true
true || false false || true true || true false || false
true || false false || true true || true false || false
// true, поскольку второй операнд равен true
// true (достаточно, чтобы любой операнд был равен true)
// false, поскольку оба операнда равны false
Когда результат выражения выражение! не является логическим значением, среда Flash сначала преобразует результат в логическое значение. Если результатом преобразования окажется значение true, то оператор логического ИЛИ вернет значение выражения выражение!. В противном случае оператор логического ИЛИ вернет значение выражения выражение2. Описанное правило продемонстрировано в следующих примерах:
О || "hi there!" // результат выражения выражение! не преобразуется // в значение true, поэтому оператор возвращает // значение выражения выражение2: "hi there!"
"hey" || "dude" // выражение выражение! представляет непустую строку.
// поэтому результат этого выражения преобразуется
// в значение true и оператор возвращает значение
// выражения выражение!: "hey"
false || 5 + 5// результат выражения выражение! не преобразуется
// в значение true, поэтому оператор возвращает // значение выражения выражение2 (то есть 10)
Результаты преобразования различных типов данных к логическим значениям перечислены в разд. «Преобразование в примитивные типы» гл. 8.
Возвращаемые оператором логического ИЛИ значения, которые не являются логическими, на практике используются редко. Вместо этого результат оператора ИЛИ обычно применяется в условных операторах для принятия логических решений. Рассмотрим следующий код:
var х = 10;
var у = 15; if (х || у) { // Этот блок кода выполняется в том случае, когда значение // одной из переменных х или у не равно 0
}
В третьей строке вместо логического значения условного выражения оператора if мы видим оператор логического ИЛИ (х | | у). Первый шаг в вычислении значения выражения х | | у заключается в преобразовании числа 10 (которое является значением первого операнда — х) в логическое значение. Любое ненулевое конечное число преобразуется в логическое значение true. Оператор логического ИЛИ возвращает значение переменной х, равное 10. Таким образом, для среды выполнения Flash оператор if выглядит следующим образом:
if (10) {
// Этот блок кода выполняется в том случае, когда значение
// одной из переменных х или у не равно О }
Однако 10 является числом, а не логическим значением. Что же происходит дальше? Оператор if преобразует результат выполнения оператора логического ИЛИ к логическому значению. В данном случае 10 преобразуется в логическое значение true и среда Flash представляет наш код следующим образом:
if (true) {
// Этот блок кода выполняется в том случае, когда значение
// одной из переменных х или у не равно О }
Вот и ответ. Результат условного выражения равен true, поэтому код, заключенный в фигурные скобки, выполняется.
Обратите внимание, что, если значение результата первого выражения оператора логического ИЛИ равно true, вычисление результата второго выражения является ненужным и, как следствие, неэффективным действием. По этой причине среда выполнения Flash вычисляет результат второго выражения только тогда, когда значение результата первого выражения равно false. Эту особенность полезно использовать в тех случаях, когда вы не хотите вычислять второе выражение до тех пор, пока результатом первого выражения не окажется f а 1 s е. В следующем примере выполняется проверка, входит ли указанное число в заданный диапазон. Если число слишком маленькое, нет необходимости в выполнении второй проверки, которая определяет, является ли число слишком большим.
if (xPosition < 0 || xPosition > 100) {
// Этот блок кода выполняется, если значение переменной
// xPosition находится в диапазоне от 1 до 100 включительно }
Заметьте, что переменная xPosition должна быть включена в каждое сравнение. Следующий код демонстрирует распространенную ошибку, когда пытаются проверить значение переменной xPosition дважды:
// Ой! Забыли включить переменную xPosition в сравнение со значением 100
if (xPos1t1on < 0 || > 100) {
// Этот блок кода выполняется, если значение переменной
// xPosItlon находится в диапазоне от 1 до 100 включительно
}
Логическое И
Как и оператор ИЛИ, оператор логического И в основном используется для условного исполнения блока кода — в данном случае, когда обязательно выполняются оба условия. Оператор логического И имеет следующий обобщенный вид: выражение! && выражение2
Выражения выражение! и выражение2 могут быть любыми допустимыми. В простейшем случае, когда результатами обоих выражений являются логические значения, оператор логического И возвращает f а 1 s е в тех случаях, когда результатом одного из выражений является значение false, a true — только в том случае, когда результатом обоих выражений является значение true.
true &&false//false,посколькурезультатвторого выражения равен false .
false &&true//false,посколькурезультатпервого выражения равен false
true &&true//true,поскольку результатыобоих выражений равны true
false &&false//false,посколькурезультаты обоих выражений равны false
// (достаточно, чтобы результат одного из выражений был // равен false)
Рассмотрим использование оператора логического И в двух примерах. В первом примере некоторый блок кода выполняется только в том случае, когда значения обеих переменных больше 50:
х = 100;
У = 51:
if (х>50 && у>50) {
// Этот блок кода выполняется только в том случае,
// когда значения переменных х и у больше 50
}
Теперь представим сайт с форумом, посвященным Новому году. Доступ к форуму пользователи могут получить только при вводе правильного пароля и только 1 января. Следующий код демонстрирует использование оператора логического И для проверки выполнения обоих условий (правильным паролем является слово fun):
var now = new Date( );
var day = now.getDate( );
// Создает новый объект Date
// Возвращает целое число в диапазоне
// от 1 до 31
var month = now.getMonth( );
// Возвращает целое число в диапазоне // от 0 до 11
if ( password=="fun" && (month + day)==l ) { // Позволить пользователю войти...
С технической точки зрения поведение оператора логического И очень похоже на поведение оператора логического ИЛИ. Сначала результат выражения выражение! преобразуется в логическое значение. Если результатом этого преобразования является false, то возвращается результат выражения выражение!. Если результатом преобразования является true, то возвращается результат выражения выражение2.
Как и в случае с оператором логического ИЛИ, если значение результата первого выражения оператора логического И равно false, нахождение результата второго выражения является ненужным и, как следствие, неэффективным действием. По этой причине среда выполнения Flash вычисляет результат второго выражения только тогда, когда значение результата первого выражения равно true. Эту особенность полезно использовать в тех случаях, когда вы не хотите вычислять второе выражение до тех пор, пока результатом первого выражения не окажется значение true. В следующем примере операция деления выполняется только в том случае, если делитель не равен нулю:
if ( numitems!=0 && totalCost/numltems>3 ) {
// Этот блок кода выполняется только в том случае, когда количество
// элементов не равно нулю и общая стоимость каждого элемента больше 3
}
Логическое НЕ
Оператор логического НЕ ( !) возвращает логическое значение, противоположное значению его единственного операнда. Этот оператор записывается в следующем обобщенном виде:
!выражение
Если результатом выражения выражение является значение true, то оператор логического НЕ возвращает false. Если результатом выражения выражение является значение false, то оператор логического НЕ возвращает true. Если результат выражения выражение не является логическим значением, то для упрощения вычислений полученный результат преобразуется в логическое значение, после чего возвращается его противоположное значение.
Как и оператор неравенства ( ! =), оператор логического НЕ удобен для проверки того, чем не является тот или иной объект, а не того, чем он является. Например,
тело следующего условного оператора выполняется только в том случае, если текущей датой не является 1 января. Обратите внимание на дополнительные скобки, с помощью которых задается требуемый порядок выполнения операций (приоритет), рассматриваемый в гл. 10.
var now = new Date( );van day = now.getDate( ):var month = now.getMonth(var now = new Date( );van day = now.getDate( ):var month = now.getMonth(// Создает новый объект Date
var now = new Date( );
van day = now.getDate( ):
var month = now.getMonth(
var now = new Date( );
van day = now.getDate( ):
var month = now.getMonth(
// Возвращает целое число в диапазоне // от 1 до 31
); // Возвращает целое число в диапазоне // от 0 до 11
if ( !( (month + day)==l) ) {
// Выполнение "непервоянварского" кода }
Оператор логического НЕ иногда также используется для переключения значения переменной с true на false и наоборот. Например, предположим, что у нас есть одна кнопка, включающая и выключающая звук приложения. Когда кнопка нажата, программа может использовать следующий код для включения или выключения воспроизведения аудио:
soundEnabled = 1soundEnabled // Переключение текущего состояния звука
if (soundEnabled) {
// Убедиться, что звуки слышны
} else {
// Выключить все звуки
}
Обратите внимание, что символ ! также используется в операторе неравенства (! =). В программировании этот символ обычно обозначает «не» или «противоположность». Он не имеет никакого отношения к символу !, обозначающему факториал в обычной системе математических обозначений.
Возвращение к классам и объектам
Наше знакомство с условными операторами и циклами подошло к концу, однако мы не рассмотрели примеры применения абсолютно всех возможностей на практике. На протяжении этой книги мы еще встретим множество примеров использования условных операторов и циклов в реальных ситуациях.
В следующей главе мы вернемся к общим темам, касающимся классов и объектов. Если вы соскучились по нашим виртуальным животным, продолжайте изучение материала.
Пересмотр методов экземпляра
Из гл. 1 мы узнали, как создавать методы экземпляра. В этой главе мы расширим полученные базовые знания, рассмотрев следующие дополнительные темы, касающиеся методов экземпляра:
исключение ключевого слова this;
связанные методы;
методы получения и изменения состояния;
get- и set-методы;
□ дополнительные аргументы.
В процессе изучения нового материала мы продолжим разрабатывать программу, создающую виртуальный зоопарк, начатую в гл. 1. Однако перед началом работы уделите несколько минут повторению уже пройденного материала. В листинге 3.1 продемонстрирована самая последняя версия кода на момент завершения гл. 1.
Листинг 3.1. Программа «Зоопарк»
// класс VlrtualPet
package zoo {
Internal class VlrtualPet {
Internal var petName:
private var currentCalorles = 1000:
private var creat1onT1me:
public function VlrtualPet (name) {
th1s.creat1onT1me = new Date( ):
this.petName = name:
}
public function eat (numberOfCalorles) {
this.currentCalorles += numberOfCalorles:
}
public function getAge ( ) {
var currentTIme = new Date( ):
var age = currentT1me.t1me - this.creatlonTime.time:
return age:
}
}'
}
// класс VirtualZoo package zoo {
public class Virtual Zoo {
private var pet:
public function Virtual Zoo ( ) {
this.pet = new VirtualPet("Stan"):
}
}
Исключение ключевого слова this
Как известно из гл. 1, ключевое слово this используется для обращения к текущему объекту внутри методов-конструкторов или методов экземпляра. Например, в следующем коде выражение thi s . petName = name говорит среде выполнения присвоить значение переменной экземпляра petName созданного объекта:
public function Virtual Pet (name) {
this.petName = name;
}
В следующем коде выражение this . currentcalories += numberOfCalories говорит среде выполнения присвоить значение переменной currentcalories того объекта, метод eat ( ) которого был вызван:
public function eat (numberOfCalories) {
this.currentcalories += numberOfCalories;
}
Использование ключевого слова this в коде, в котором происходит частое обращение к переменным и методам текущего объекта, может оказаться утомительным, а также приведет к загруженности кода. Для упрощения и улучшения читабельности кода язык ActionScript позволяет обращаться к переменным и методам экземпляра текущего объекта вообще без использования ключевого слова this.
Вот как это работает: когда среда выполнения Flash встречает идентификатор в выражении внутри метода-конструктора или метода экземпляра, она выполняет поиск локальной переменной, параметра или вложенной функции, чье имя совпадает с именем данного идентификатора (вложенные функции рассматриваются в гл. 5). Если ни одно из имен локальных переменных, параметров или вложенных функций не совпадает с именем идентификатора, среда Flash автоматически выполняет поиск переменной или метода экземпляра, чье имя совпадает с именем идентификатора. Если совпадение найдено, то в выражении будут использованы соответствующие переменная или метод экземпляра.
Например, рассмотрим, что произойдет, если мы уберем ключевое слово this из метода eat ( ), как показано в следующем коде:
public function eat (numberOfCalories) {
currentCalories += numberOfCalories;
}
При выполнении приведенного выше кода среда Flash встречает идентификатор numberOf Calories и пытается найти локальную переменную, параметр или вложенную функцию по данному имени. У метода есть параметр с таким именем, поэтому в выражении используется значение этого параметра (вместо идентификатора numberOf Calories).
После этого среда выполнения Flash встречает идентификатор currentcalories и пытается найти локальную переменную, параметр или вложенную функцию по данному имени. С именем currentcalories нет ни одной переменной, параметра или вложенной функции, поэтому среда Flash пытается найти переменную или метод экземпляра по данному имени. На этот раз поиск оказывается успешным: класс VirtualPet содержит переменную экземпляра с именем currentcalories, поэтому среда выполнения Flash использует эту переменную в выражении. В результате значение параметра numberOf Calories прибавляется к значению переменной экземпляра currentcalories.
Следовательно, внутри метода eat ( ) выражения this . currentcalories и currentcalories являются идентичными.
Для улучшения читабельности кода многие разработчики (это относится и к данной книге) избегают частого использования ключевого слова this. С этого момента при обращении к переменным и методам экземпляра мы будем опускать ключевое слово this. Тем не менее некоторые программисты предпочитают использовать его всегда лишь для того, чтобы отличать переменные и методы экземпляра от локальных переменных.
Обратите внимание, что использование ключевого слова this допустимо только внутри методов экземпляра, методов-конструкторов, функций и кода в глобальной области видимости (рассматривается в гл. 16). Применение ключевого слова thi s в любом другом месте программы приведет к ошибке на этапе компиляции.
Процесс поиска идентификаторов средой выполнения Flash называется разрешением идентификаторов. Как будет рассмотрено в гл. 16, разрешение идентификаторов выполняется с учетом области (или области видимости) программы, в которой они встречаются.
Разрешение конфликтов имен переменных/параметров. Когда переменная экземпляра и параметр метода имеют одинаковые имена, для обращения к переменной можно использовать ключевое слово this (это называется разрешением неоднозначности между переменной и параметром). Например, в следующей модифицированной версии класса VirtualPet представлен метод eat ( ) с параметром calories, имя которого совпадает (то есть конфликтует) с именем переменной экземпляра calories: package zoo {.
Internal class VirtualPet {
// Переменная экземпляра 'calories'
private var calories = 1000:
// Метод с параметром 'calories' public function eat (calories) {
this .calories += calories:
}
}
}
Внутри тела метода eat ( ) выражение calories (без ключевого слова this) ссылается на параметр метода, а выражение this . calories (с ключевым словом this) — на переменную экземпляра. В этом случае говорят, что параметр calories затеняет переменную экземпляра calories, поскольку сам по себе идентификатор calories ссылается на параметр, а не на переменную экземпляра. Обратиться к переменной экземпляра можно только с помощью ключевого слова this.
Обратите внимание, что, как и параметры, локальные переменные могут затенять переменные и методы экземпляра, чьи имена совпадают с именами локальных переменных. Локальная переменная также затеняет параметр метода с таким же именем, фактически переопределяя данный параметр и не оставляя программе никакого шанса обратиться к нему.
Многие программисты специально используют одинаковые имена для параметров и переменных экземпляра, полагаясь на ключевое слово this при разрешении неоднозначностей. Тем не менее, чтобы ваш код легко читался, вы можете просто избегать использования имен параметров, совпадающих с именами переменных, методов экземпляра или локальных переменных.
Теперь перейдем к рассмотрению следующего вопроса, касающегося методов экземпляра, — связанных методов.
Связанные методы
В языке ActionScript сам метод может рассматриваться как значение. Другими словами, метод может быть присвоен переменной, передан в функцию или другой метод, а также возвращен из функции или другого метода.
Например, в следующем коде создается новый объект класса VirtualPet, после чего локальной переменной consume присваивается метод eat ( ) созданного объекта. Обратите внимание, что в операторе присваивания после имени метода не ставятся круглые скобки ( ) вызова метода. В результате переменной consume присваивается сам метод, а не его возвращаемое значение.
package zoo {
public class Virtual Zoo {
private var pet:
public function VlrtualZoo ( ) {
pet = new VirtualPet("Stan"):’
// Присваивание переменной метода eat( ) var consume = pet.eat;
}
}
Метод, присвоенный переменной, может быть вызван через эту переменную стандартным оператором круглых скобок — ( ). Например, в следующем коде вызывается метод, на который ссылается переменная consume:
package zoo {
public class VlrtualZoo {
private var pet:
public function VlrtualZoo ( ) {
pet = new V1rtualPet("Stan"):
// Присваивание связанного метода переменной consume
var consume = pet.eat:
// Вызов метода, на который ссылается переменная consume consume(300);
}
}
}
При выполнении предыдущего кода, выделенного полужирным шрифтом, вызывается метод еаt ( ), в качестве аргумента которого передается значение 300. Вопрос заключается в том, какое животное принимает пищу? Или, говоря техническим языком, над каким объектом выполняется этот метод?
Когда метод присваивается переменной и затем вызывается через нее, код выполняется над тем объектом, который изначально использовался для обращения к методу. Например, в предыдущем коде, когда метод eat ( ) присваивается переменной consume, обращение к методу происходит через объект класса VirtualPet с именем "Stап". Таким образом, при вызове метода eat ( ) через переменную consume код будет выполняться над объектом класса VirtualPet с именем "Stan".
Метод, который присваивается переменной, передается в функцию или другой метод либо возвращается из функции или другого метода, называется связанным методом. Свое название связанные методы получили потому, что каждый такой метод навсегда связывается с объектом, через который изначально происходит обращение к методу. Связанные методы являются экземплярами собственного класса Function.•
При вызове связанного метода не нужно указывать объект, над которым должен выполняться данный метод. Вместо этого связанный метод будет автоматически выполнен над объектом, который изначально использовался при создании связи.
Внутри тела связанного метода ключевое слово this ссылается на объект, с которым связан данный метод. Например, внутри тела связанного метода, который был присвоен переменной consume, ключевое слово this ссылается на объект класса VirtualPet с именем "Stan".
Связанные методы используются в тех случаях, когда одна часть программы желает, чтобы другая часть выполнила определенный метод над заданным объектом. Примеры такого сценария можно найти в гл. 12, где рассматривается система обработки событий. Связанные методы нашли широкое применение в системе обработки событий языка ActionScript.
Продолжая тему разговора о методах экземпляра, в следующем разделе рассмотрим использование методов экземпляра для изменения состояния объекта.
Использование методов для получения и изменения состояния объекта
Ранее в этой книге мы узнали, что хорошей практикой объектно-ориентированного программирования является объявление переменных экземпляра с использованием модификатора private. Это значит, что их значения нельзя прочитать или изменить в коде за пределами класса, в котором они объявлены.
Хорошая практика объектно-ориентированного программирования также предписывает следующее: вместо того чтобы предоставлять возможность внешнему коду непосредственно изменять значения переменных экземпляра, мы должны определять методы экземпляра для получения или изменения состояния объекта.
Ранее мы определили переменную экземпляра с именем currentcalories в классе Virtual Pet. Концептуально эта переменная описывает степень голода каждого животного. Чтобы внешний код мог изменять степень голода животного, мы можем сделать переменную currentcalories открытой. В этом случае внешний код будет присваивать переменной, описывающей степень голода, любое произвольное значение, как показано в следующем коде:
somePet.currentCalones = 5000:
Тем не менее предыдущий подход обладает серьезным недостатком. Если внешний код сможет непосредственно изменять значение переменной currentcalories, то у класса VirtualPet не будет никакой возможности убедиться, что значение, присваиваемое переменной, является допустимым, или осмысленным. Например, внешний код может присвоить переменной currentCalories значение 1 000 000, позволив животному жить сотни лет, не испытывая голода. Или, если внешний код присвоит переменной currentcalories отрицательное значение, может произойти сбой программы.
Для того чтобы избежать подобных проблем, мы должны объявить переменную currentcalories закрытой (как мы сделали это раньше в классе VirtualPet). Вместо того чтобы позволять внешнему коду непосредственно изменять значение переменной currentcalories, мы добавим один или несколько открытых методов экземпляра, которые могут быть использованы для изменения степени голода каждого животного допустимым способом. Наш класс VirtualPet уже обладает методом eat ( ) для утоления голода животного. Тем не менее этот метод позволяет добавлять любое количество калорий к значению переменной currentcalories. Модифицируем метод eat ( ) класса VirtualPet таким образом, чтобы значение переменной currentcalories не могло превышать 2000:
public function eat (numberOfCalones) {
cur rentCal odes += numberOfCalones;
}
Чтобы ограничить максимальное значение переменной currentcalories числом 2 000, мы просто добавим оператор i f в метод е a t ( ), как показано в следующем коде:
public function eat (numberOfCalones) {
// Рассчитать новое предложенное количество калорий
// для данного животного
var newCurrentCalones = currentCalones + numberOfCalones;
// Если новое предложенное количество калорий для данного животного
// больше максимально допустимого значения (то есть 2000)...
1f (newCurrentCalones > 2000) {
// ...присвоить переменной currentCalones максимально
// допустимое значение (2000) currentCalones = 2000:
} else {
// ...в противном случае увеличить значение переменной currentCalones // на указанное количество калорий currentCalones = newCurrentCalones;
} }
Метод eat ( ) класса VirtualPet предоставляет внешнему коду безопасный способ'изменения степени голода выбранного объекта VirtualPet. Однако до сих пор класс VirtualPet не предоставлял внешнему коду никакой возможности для определения степени голода. Чтобы предоставить внешнему коду доступ к этой информации, определим метод getHunger ( ), возвращающий оставшееся количество калорий у объекта VirtualPet, выраженное в процентах. Код нового метода выглядит следующим образом:
public function getHunger ( ) {
return currentCalones / 2000;
}
Теперь у нас есть методы для получения и изменения текущей степени голода объекта VirtualPet (getHunger ( ) neat( ) ). В традиционной терминологии объектно-ориентированного программирования метод, который получает состояние объекта, называетсяметодом-аксессором, или, более неофициально,методом-читателем. С другой стороны, метод, который изменяет состояние объекта, называется методом-мутатором, или, более неофициально,методом-писателем. Тем не менее в языке ActionScript 3.0 термин «метод-аксессор» относится к особой разновидности методов, которые оформляются с использованием синтаксиса чтения и записи значения переменной и рассматриваются далее, в разд. «Get- и set-методы». Как отмечалось ранее, чтобы избежать путаницы в этой книге, мы не будем употреблять традиционные термины «аксессор», «мутатор», «читатель» и «писатель». Вместо этого мы воспользуемся неофициальными терминами метод-получатель и метод- модификатор при обсуждении методов-аксессоров и методов-мутаторов. Более
того, мы будем применять термины «get-метод» и «set-метод» только в отношении специальных автоматических методов языка ActionScript.
Чтобы немного попрактиковаться в использовании методов-получателей и методов-модификаторов, снова изменим класс Virtual Pet. Раньше для получения и присвоения имени объекту VirtualPet мы обращались непосредственно к переменной petName, как показано в следующем коде:
somePet.petName = "Erik";
Предыдущий подход тем не менее в дальнейшем может стать источником проблем в нашей программе. Он позволяет присваивать переменной petName очень длинные значения, которые могут не вместиться на экране при отображении имени животного. Кроме того, переменной petName может быть присвоена пустая строка (" ’’), которая вообще не отобразится на экране. Чтобы избежать описанных проблем, объявим переменную petName закрытой и определим метод-модификатор для задания имени животного. Наш метод-модификатор se tName ( ) ограничивает максимальную длину имени 20 символами и предотвращает попытки присвоить переменной petName пустую строку (’’"):
public function setName (newName) {
// Если длина заданного нового имени больше 20 символов...
1f (newName.length > 20) {
// ...обрезать имя. используя собственный метод String.substr( ).
// возвращающий указанную часть строки, над которой
// выполняется данный метод newName = newName.substr(0. 20):
} else 1f (newName == "") {
// ...в противном случае, если заданное новое имя является
// пустой строкой, завершить выполнение метода, не изменяя
// значения переменной petName return;
}
// Присвоить новое проверенное имя переменной petName petName = newName;
}
Теперь, когда мы объявили переменную petName закрытой, необходимо определить метод-получатель, с помощью которого внешний код сможет получить доступ к имени объекта VirtualPet. Мы присвоим нашему методу-получателю имя getName ( ). Пока этот метод будет просто возвращать значение переменной petName (зачастую возвращение значения переменной экземпляра является единственной задачей метода-получателя). Рассмотрим код метода:
public function getName ( ) {
return petName;
}
В настоящее время метод getName ( ) очень прост, однако он добавляет гибкость в нашу программу. Например, в будущем может понадобиться, чтобы имена животных формировались с учетом пола. Для этого мы просто обновим метод, как
показано далее (следующая гипотетическая версия метода getName ( ) предполагает, что в классе VirtualPet определена переменная экземпляра gender, хранящая пол каждого животного):
public function getName ( ) {
1f (gender == "male") {
return "Mr. " + petName:
} else {
return "Mrs. " + petName:
}
}
В листинге 3.2 продемонстрирован новый код класса VirtualPet, в который были добавлены определения методов getName ( ) и setName ( ). Для лучшей читабельности метод экземпляра getAge ( ) и переменная экземпляра creationTime были удалены из описания класса VirtualPet.
Листинг 3.2. Класс VirtualPet
package zoo {
Internal class VirtualPet {
private var petName:
private var currentCalorles = 1000:
public function VirtualPet (name) {
petName = name:
}'
public function eat (numberOfCalorles) {
var newCurrentCalorles = currentCalorles + numberOfCalorles:
1f (newCurrentCalorles > 2000) {
currentCalorles = 2000:
} else {
currentCalorles = newCurrentCalorles:
}
}
public function getHunger ( ) {
return currentCalorles / 2000;
}
public function setName (newName) {
// Если длина заданного нового имени больше 20 символов...
1f (newName.length > 20) {
// ...обрезать имя
newName = newName.substr(0. 20):
} else 1f (newName == "") {
// ...в противном случае, если заданное новое имя является
// пустой строкой, завершить выполнение метода, не изменяя
// значения переменной petName
return:
// Присвоить новое проверенное имя переменной petName petName = newName:
}
public function getName ( ) { return petName:
}
} }
Теперь рассмотрим пример использования наших новых методов getName ( ) и setName ( ):
package zoo {
public class Virtual Zoo {
private var pet:
public function Virtual Zoo ( ) {
pet = new VirtualPet("Stan"):
// Присвоить старое имя животного локальной переменной oldName
var oldName = pet.getName( );
// Дать животному новое имя
pet.setName("Marcos");
}
} }
Используя метод-модификатор для промежуточного присваивания значения переменной, мы можем разрабатывать приложения, способные адекватно реагировать на ошибки времени выполнения путем определения и обработки недопустимых или неподходящих значений. Значит ли это, что доступ ко всем переменным экземпляра должен осуществляться через методы? Например, рассмотрим метод- конструктор нашего класса Virtual Pet:
public function Virtual Pet (name) {
petName = name: }
Теперь, когда у нас появился метод для изменения значения переменной petName, должны ли мы модифицировать метод-конструктор класса Virtual Pet следующим образом?
public function Virtual Pet (name) {
setName(name):
}•
Ответ зависит от имеющихся условий. Вообще говоря, непосредственное обращение к закрытым переменным, описанным в данном классе, является вполне приемлемым. Тем не менее, если существует вероятность, что имя или роль переменной в будущем будут изменены, или если метод-модификатор или метод-получатель выполняют определенные действия при обращении к переменной (например, проверку на наличие ошибок), имеет смысл применять методы везде, даже внутри класса, в котором описана данная переменная. Например, в предыдущем
модифицированном методе-конструкторе класса VirtualPet разумно присваивать значение переменной petName именно через метод setName ( ), поскольку это гарантирует, что указанное имя не окажется слишком длинным или коротким. И все-таки, в тех случаях, когда решающим фактором является быстродействие, благоразумнее использовать непосредственный доступ к переменной (его получить всегда быстрее, чем доступ через метод).
Программисты, предпочитающие использовать стиль непосредственного доступа к переменным, но при этом не желающие отказываться от преимуществ методов- получателей и методов-модификаторов, обычно применяют автоматические get- и set-методы языка ActionScript, рассматриваемые в следующем разделе.
Get- и set-методы
В предыдущем разделе мы познакомились с методами-получателями и методами- модификаторами, которые представляют собой открытые методы для получения и изменения состояния объекта. Некоторые разработчики считают подобные методы громоздкими. Они утверждают, что конструкция:
pet. setNameCJeff"):
более неудобна в использовании, чем конструкция:
pet.name = "Jeff":
Чуть раньше мы убедились, что непосредственное присваивание значения переменной, например pet. name = "Jeff", не является идеальной практикой объектно-ориентированного программирования и переменной в конечном счете может быть присвоено некорректное значение. Чтобы устранить несогласованность между удобством использования синтаксиса непосредственного присваивания значения переменной и безопасностью методов-получателей и методов-модификаторов, язык ActionScript поддерживает get- и set-методы. Вызвать эти методы можно с помощью синтаксиса получения или присваивания значения переменной.
Для описания get-метода используется следующий обобщенный синтаксис:
function get имяМетода ( ) {
операторы
}
Здесь ключевое слово get указывает на то, что метод является get-методом, имяМетода представляет имя метода, а операторы — это ноль или более операторов, выполняемых при вызове метода (ожидается, что один из операторов возвращает значение, связанное с методом имяМетода).
Для описания set-метода используется следующий обобщенный синтаксис:
function set имяМетода (новоеЗначение) { операторы
}
Здесь ключевое слово set указывает на то, что метод является set-методом, имяМетода представляет имя метода, параметр новоеЗначение содержит значение, присваиваемое
внутренней переменной экземпляра, а операторы — это ноль или более операторов, выполняемых при вызове метода. Ожидается, что блок операторов операторы определит и внутренне сохранит значение, связанное с методом имяМетода. Обратите внимание, что в теле set-метода оператор return не должен применяться для возврата значения (однако сам по себе он может быть использован для завершения метода). Set-методы автоматически возвращают значение, что рассматривается далее.
Для вызова get- и set-методов применяется уникальный стиль, не требующий использования оператора вызова функции ( ). Get-метод х ( ) объекта оЬ j вызывается следующим образом:
obj.x:
Но не так:
obj.x( ):
Set-метод у ( ) объекта оЬ j вызывается следующим образом:
obj.y = value:
Но не так:
obj.y(value):
Здесь value является первым (и единственным) аргументом, передаваемым в метод у ( ).
Следовательно, get- и set-методы неким магическим образом позволяют преобразовать синтаксис обращения к переменным экземпляра в вызовы методов. В качестве примера (временно) добавим get-метод с именем name ( ) в наш класс VirtualPet:
public function get name ( ) {
return petName;
}
Теперь, когда в классе определен get-метод name ( ), все попытки получить значение переменной экземпляра name на самом деле приведут к вызову этого get-метода. Возвращаемое значение get-метода выглядит так, будто на самом деле было получено значение переменной name. Например, следующий код вызывает get- метод name ( ) и присваивает его возвращаемое значение переменной oldName: var oldName = pet.name:
Сейчас (временно) добавим set-метод с именем name ( ) в наш класс VirtualPet: public function set name (newName) {
// Если длина заданного нового имени больше 20 символов...
1f (newName.length > 20) {
// ...обрезать имя
newName = newName.substr(0. 20):
} else 1f (newName == "") {
// ...в противном случае, если заданное новое имя является
// пустой строкой, завершить выполнение метода, не изменяя
// значения переменной petName
return:
}
// Присвоить новое проверенное имя переменной petName petName = newName;
Теперь, когда в классе определен set-метод name ( ), попытки присвоить значение переменной экземпляра name приведут к вызову данного set-метода. Значение, используемое в операторе присваивания переменной name, передается в set-метод, который внутренне сохраняет это значение в закрытой переменной petName. Например, следующий код вызывает set-метод name ( ), который внутренне сохраняет значение "Andreas" в переменной petName:
pet.name = "Andreas":
После определения get- и set-метода с именем name ( ) переменная name становится всего лишь внешним фасадом. В действительности она не определена в классе, однако обращаться к ней можно так же, как и к любой другой существующей переменной. Таким образом, вы можете считать переменные экземпляра, сопровождаемые get- и set-методами (например, name), псевдопеременными.
Нельзя создавать реальную переменную с именем, совпадающим с названием get- или set-метода. Подобные попытки приведут к ошибке на этапе компиляции.
При вызове set-метода всегда вызывается соответствующий get-метод, результат которого возвращается из данного set-метода. Это позволяет программе использовать новое значение сразу после операции присваивания. Например, следующий код демонстрирует фрагмент приложения музыкального проигрывателя. Для выбора первой воспроизводимой песни используется set-метод. Благодаря вызову метода s t а г t ( ) над возвращаемым значением оператора присваивания переменной firstSong сразу начинается воспроизведение выбранной песни.
// Вызов метода start( ) над объектом new Song("dancehit.mp3") -
// возвращаемым значением set-метода f1rstSong( )
(musicPlayer.firstSong = new Song("danceh1t.mp3")).start( ):
Хотя возможность возвращения значений из set-методов в некоторых случаях оказывается удобной, она накладывает ограничения на get-методы: в частности, get- методы не должны выполнять задачи, которые не требуются для получения значения соответствующей внутренней переменной. Например, с помощью get-метода нельзя реализовать глобальный счетчик, отслеживающий количество обращений к переменной. Автоматический вызов get-метода из set-метода приведет к лишнему увеличению значения счетчика.
Псевдопеременную, обращение к которой происходит с помощью get- и set-метода, можно * N сделать доступной только для чтения — для этого нужно объявить get-метод и опустить объявление set-метода.
Выбор между использованием методов-получателей/-модификаторов и get-/set- методов — дело вкуса. В этой книге, например, get- и set-методы не используются, однако вы можете встретить этот подход в коде других программистов или в другой документации.
Чтобы завершить изучение методов экземпляра, рассмотрим, как обрабатывать неизвестное количество параметров. Для изучения материала следующего раздела необходимо иметь представление о массивах (упорядоченных списках значений), которые еще не рассматривались в этой книге. Если вы незнакомы с массивами, пока пропустите этот раздел и вернитесь к нему после прочтения гл. И.
Методики, описанные в следующем разделе, применимы не только к методам экземпляра, но и к статическим методам и функциям, которые будут рассмотрены в следующих главах.
Обработка неизвестного количества параметров
Как известно из гл. 1, нельзя вызвать метод, не указав аргументы для всех обязательных параметров. Нельзя также вызывать метод, если указано больше аргументов, чем требуется.
Чтобы определить метод, который принимает произвольное количество аргументов, используется параметр . . . (rest). Он описывает массив, содержащий все аргументы, передаваемые в данный метод. Этот параметр может использоваться как самостоятельно, так и в сочетании с именованными параметрами. Когда параметр ...(rest) используется отдельно, описание метода имеет следующий обобщенный вид: function имяМетода (...массивАргументов) {
В предыдущем коде имяМетода обозначает имя метода (или функции), а массивАргу- ментов представляет имя параметра, присваиваемое автоматически создаваемому массиву, который содержит все передаваемые в данный метод аргументы. Первый аргумент (крайний левый в выражении вызова) хранится под индексом 0, и обратиться к нему можно с помощью выражения массивАргументов\_^. Последующие аргументы сохраняются по порядку слева направо. Таким образом, для обращения ко второму аргументу используется выражение массивАргументовЩЛ, к третьему — выражение массивАргументовШ и т. д.
Параметр ...(rest) позволяет создавать очень гибкие функции, оперирующие произвольным количеством значений. Например, следующий код демонстрирует метод, который определяет среднее значение любых чисел, передаваемых в качестве аргументов:
public function getAverage (...numbers) {
var total = 0;
for (var 1 = 0: 1 < numbers.length: 1++) { total += numbers [1]:
return total / numbers.length;
Обратите внимание, что представленный метод getAverage ( ) работает только с числовыми аргументами. Чтобы защитить этот метод от использования нечисловых аргументов, можно применить оператор is, рассматриваемый в подразд. «Восходящее и нисходящее приведения типов» разд. «Приведение типов» гл. 8.
Параметр . . . (rest) также может использоваться в сочетании с именованными параметрами. В этом случае он должен быть последним в списке параметров. Например, рассмотрим метод initializeUser( ), применяемый для инициализации пользователя в гипотетическом социальном сетевом приложении. В описании метода определяется один обязательный параметр name, за которым следует параметр . . . (rest) с именем hobbies:
public function 1n1t1alIzeUser (name, ...hobbles) { }
При вызове метода initializeUser( ) мы обязаны указать аргумент для параметра name и при желании можем указать дополнительный список хобби, разделяя элементы списка запятыми. Внутри метода параметру name присваивается значение первого переданного аргумента, а параметру hobbies — массив всех оставшихся аргументов. Например, если вызвать данный метод следующим образом:
Initial1zeUser("Hoss", "video games", "snowboarding");
то параметру name будет присвоено значение "Hoss ”, а параметру hobbies — значение [” video games”, ”snowboarding”].
Далее: информация и поведение на уровне класса
Мы рассмотрели методы и переменные экземпляра. Как известно из гл. 1, они определяют поведение и характеристики объектов класса. Из следующей главы вы узнаете, как создавать поведение и управлять информацией, относящейся не к отдельным объектам, а ко всему классу.
Статические переменные и методы
Из гл. 1 вы узнали, как определять характеристики и поведение объекта с помощью переменных и методов экземпляра. В этой главе вы познакомитесь с тем, как организовывать информацию и создавать функциональность, относящуюся к самому классу, а не к его экземплярам.
Статические переменные
При изучении материала предыдущих глав мы немного попрактиковались в использовании переменных экземпляра, которые представляют собой переменные, связанные с определенным экземпляром класса. В отличие от них, статические переменные связаны с самим классом, а не с его определенным экземпляром. Статические переменные применяются для хранения информации, относящейся логически ко всему классу, в отличие от информации, которая меняется от одного экземпляра к другому. Например, в классе, представляющем окно, статическая переменная может использоваться для указания размера по умолчанию для новых экземпляров этого окна, а в классе, представляющем автомобиль в гоночной игре, с помощью статической переменной можно задать максимальную скорость для всех экземпляров этого автомобиля.
Подобно переменным экземпляра, для создания статических переменных применяются описания переменных, размещаемые внутри класса, однако описание статической переменной должно также*включать атрибут static, как показано в следующем обобщенном коде:
class НекийКласс {
static var идентификатор = значение;
}
Как и в случае с переменными экземпляра, для управления доступностью статических переменных в программе можно использовать модификаторы управления доступом. Такие модификаторы идентичны модификаторам, применяемым в описаниях переменных экземпляра, — public, internal, protected и private. Если в описании переменной никакой модификатор не задан, то используется модификатор internal (доступ внутри пакета). Указываемый модификатор обычно размещается перед атрибутом static, как показано в следующем коде:
class НекийКласс {
private static var идентификатор = значение;
}
Для доступа к статической переменной указывается имя класса, содержащего определение данной переменной, за которым следует точка (.) и имя переменной, как показано в следующем обобщенном коде:
НекийКласс.идентификатор = значение;
Внутри класса, в котором объявлена данная переменная, имя идентификатор может использоваться и самостоятельно (без лидирующего имени класса и точки). Например, в классе А, в котором определена статическая переменная v, выражение А. v идентично выражению v. Тем не менее, чтобы различать статические переменные и переменные экземпляра, многие разработчики (это относится и к примерам данной книги) включают лидирующее имя класса даже в тех случаях, когда его использование не является обязательным.
Статические переменные и переменные экземпляра с одинаковыми именами могут сосуществовать внутри одного класса. Если в классе А определена переменная экземпляра v и статическая переменная с таким же именем, то при вызове в виде v идентификатор будет ссылаться на переменную экземпляра, а не на статическую переменную. Обратиться к статической переменной можно только путем указания лидирующего имени класса: А. v. В этом случае говорят, что переменная экземпляра затеняет статическую переменную.
Теперь добавим несколько статических переменных в наш класс Virtual Pet. Как известно, статические переменные используются для хранения информации, которая логически относится ко всему классу и не меняется от одного экземпляра к другому. В нашем классе VirtualPet уже есть два примера подобной информации: максимальная длина имени животного и максимальное количество калорий, которое может принять данное животное. Для хранения этой информации добавим две новые статические переменные: maxNameLength и maxCalories. Мы не будем обращаться к нашим переменным за пределами класса VirtualPet, поэтому объявим их с использованием модификатора доступа private. Следующий код демонстрирует объявления переменных maxNameLength и maxCalories, при этом оставшаяся часть кода класса VirtualPet опущена ради краткости:
package zoo {
Internal class VirtualPet {
private static var maxNameLength = 20;
private static var maxCalories = 2000:
// Оставшаяся часть класса не показана...
} }
Теперь, когда у нас есть переменные maxNameLength и maxCalories, мы можем модифицировать методы getHunger ( ), еаt ( ) и setName ( ), чтобы воспользоваться этими переменными. В листинге 4.1 продемонстрирована последняя версия класса VirtualPet, в который были добавлены статические переменные. Изменения, внесенные в предыдущую версию кода, выделены полужирным шрифтом. Обратите внимание, что по соглашению статические переменные класса перечислены перед переменными экземпляра.
/
Листинг 4.1. Класс VirtualPet
package zoo {
Internal class VirtualPet {
private static var maxNameLength = 20;
private static var maxCalories = 2000;
private var petName;
// Изначально каждому животному дается 50 % от максимально
// возможного количества калорий.
private var currentCalorles = VirtualPet.maxCalor1es/2;
public function VirtualPet (name) {
setName(name):
}
public function eat (numberOfCalorles) {
var newCurrentCalorles = currentCalorles + numberOfCalorles;
1f (newCurrentCalorles > VirtualPet.maxCalories) { currentCalorles = Virtual Pet.maxCalories;.
} else { currentCalorles = newCurrentCalorles;
}
}
public function getHunger ( ) {
return currentCalorles / Virtual Pet.maxCalories; }
public function setName (newName) {
// Если длина заданного нового имени больше maxNameLength символов...
1f (newName.length > Virtual Pet.maxNameLength) {
// ...обрезать имя newName = newName.substr(0, VIrtualPet.maxNameLength);
} else if (newName == "") {
// ...в противном случае, если заданное новое имя является
// пустой строкой, завершить выполнение метода, не изменяя
// значения переменной petName return;-
}
// Присвоить новое проверенное имя переменной petName petName = newName;
}
public function getName ( ) {
return petName;
}
}
}
Если проанализировать листинг 4.1, то можно заметить, что наличие переменных maxNameLength и maxCalories помогает централизовать код. Например,
ранее, чтобы изменить максимально допустимое количество символов в имени, нам пришлось бы заменить число 20 в двух местах тела метода setName — этот процесс не только отнимает много времени, но и может привести к ошибке. Теперь, чтобы изменить максимально допустимое количество символов, нужно просто присвоить другое значение переменной maxNameLength, и весь класс обновится автоматически.
Необъяснимые константные значения, как, например, число 20 в предыдущей версии метода setName(), называются «магическими значениями», поскольку они играют некую важную роль, однако их назначение неочевидно. Избегайте использования магических значений в своем коде. В большинстве случаев статические переменные могут применяться для хранения значений, которые в противном случае будут «магическими».
Статические переменные зачастую используются для хранения установочных параметров, значения которых не должны изменяться после запуска программы. Чтобы исключить возможность изменения значения переменной, ее нужно объявить константой, о чем и пойдет речь в следующем разделе.
Константы
Константа — это переменная экземпляра, статическая или локальная переменная, значение которой после инициализации остается постоянным вплоть до завершения программы. Для создания константы применяется стандартный синтаксис описания переменной, однако вместо ключевого слова var используется ключевое слово const. По соглашению имена констант полностью состоят из прописных букв. Чтобы создать константную статическую переменную, прямо в теле класса можно использовать следующий обобщенный код:
static const ИДЕНТИФИКАТОР = значение
Для создания константной переменной экземпляра прямо в теле класса можно указать следующий обобщенный код:
const ИДЕНТИФИКАТОР = значение
Чтобы создать константную локальную переменную, в теле метода или функции можно использовать следующий обобщенный код:
const ИДЕНТИФИКАТОР = значение
В трех предыдущих примерах кода ИДЕНТИФИКАТОР обозначает имя константы, а значение — начальное значение переменной. В случае с константными статическими и константными локальными переменными, после того как значение значение, указанное в инициализаторе переменной, будет присвоено переменной, изменить ее будет невозможно.
При работе с константными переменными экземпляра, если программа откомпилирована в строгом режиме, после того как значение значение, указанное в инициализаторе переменной, будет присвоено переменной, изменить ее будет невозможно. Если программа откомпилирована в стандартном режиме, то после того,
как значение значение, указанное в инициализаторе переменной, будет присвоено переменной, изменить ее можно будет внутри функции конструктора того класса, в котором она объявлена, — после этого изменить значение переменной будет невозможно (различия между строгим и стандартным режимами компиляции будут рассмотрены в гл. 7).
Константы обычно используются для создания статических переменных, чьи фиксированные значения описывают варианты определенной настройки программы. Предположим, мы создаем программу будильника для ежедневной подачи сигнала. Подача сигнала может происходить в трех режимах: визуальном (моргающий значок), звуковом (зуммер) или визуальном и звуковом одновременно. Будильник представлен классом с именем AlarmClock. Для представления трех режимов подачи сигнала в классе AlarmClock определены три константные статические переменные: MODE_VISUAL, MODE_AUDIO и MODE_BOTH. Каждой константе присвоено числовое значение, определяющее соответствующий режим. Режим 1 считается визуальным, режим 2 — звуковым, а режим 3 — визуальным и звуковым одновременно. В следующем примере кода продемонстрированы описания констант режимов:
public class AlarmClock {
public static const MODE_VISUAL = 1;
public static const MODE_AUDIO = 2; public static const MODE_BOTH = 3;
}
В классе AlarmClock определена переменная экземпляра mode, которая позволяет хранить информацию о выбранном режиме для каждого экземпляра этого класса. Чтобы задать режим для объекта AlarmClock, необходимо присвоить одно из константных значений режимов (1,2 или 3) переменной экземпляра mo de. Следующий код устанавливает звуковой режим (режим 2) в качестве режима по умолчанию для новых объектов AlarmClock:
public class AlarmClock {
public static const MODE_VISUAL = 1;
public static const MODE_AUDIO = 2;
public static const MODE_BOTH = 3;
private var mode = AlarmClock.MODE_AUDIO;
}
Когда наступает время подачи сигнала, объект AlarmClock выполняет соответствующее действие в зависимости от текущего режима. Следующий код демонстрирует один из способов того, как объект AlarmClock мог бы использовать константы режимов для выбора подходящего действия:
public class AlarmClock {
public static const MODE_VISUAL = 1;
public static const MODE_AUDIO = 2;
public static const MODE_BOTH = 3;
private var mode = AlarmClock.MODE_AUDIO;
private function slgnalAlarm ( ) {
if (mode = MODE_VISUAL) {
// Отобразить значок
} else if (mode = MODE_AUDIO) {
// Воспроизвести звук
} else if (mode = MODEBOTH) {
// Отобразить значок и воспроизвести звук
}
}
}
Обратите внимание, что в предыдущем коде использование констант режимов с технической точки зрения не является обязательным. Собственно говоря, мы могли бы решить эту задачу с помощью константных числовых значений (магических значений). Тем не менее при использовании констант назначение числовых значений становится гораздо более понятным. Для сравнения, следующий код демонстрирует класс AlarmClock, реализованный без констант. Обратите внимание, что без комментариев в коде определить назначение каждого из трех значений режимов было бы достаточно сложно:
public class AlarmClock {
private var mode = 2;
private function slgnalAlarm ( ) {
1f (mode == 1) {
// Отобразить значок
} else if (mode == 2) {
// Воспроизвести звук
} else if (mode == 3) {
// Отобразить значок и воспроизвести звук
}
}
}
Теперь познакомимся с партнерами статических переменных — статическими методами.
Статические методы
В предыдущем разделе мы узнали, что статические переменные используются для хранения информации, которая относится ко всему классу. Подобным образом статические методы описывают функциональность, относящуюся ко всему классу, а не к отдельному экземпляру этого класса. Например, в состав API среды выполнения Flash входит класс Point, представляющий точку с координатами по оси X и по оси Y в декартовой системе координат. В классе Point определен статический метод polar ( ), который позволяет получить объект Point по заданной точке в полярной системе координат (то есть по расстоянию и углу). Преобразование точки в полярной системе координат в точку в декартовой системе координат является общей операцией, относящейся к точкам в декартовом пространстве вообще, а не к отдельному объекту Point. Именно поэтому данный метод определен как статический.
Как и методы экземпляра, статические методы создаются описанием функций внутри описаний классов, однако описания статических методов должны также включать атрибут static, как показано в следующем обобщенном коде:
class НекийКласс {
static function имяМетода (идентификатор! = значение!, идентификатор2 = значение2, идентификаторп = значениеп) {
}
}
Как и в случае с методами экземпляра, управлять доступностью статических методов в программе можно с помощью модификаторов управления доступом. В описаниях статических методов применяются те же модификаторы управления доступом, что и в описаниях методов экземпляра: public,internal,protectedHprivate. Если при описании метода не указан никакой модификатор доступа, то используется модификатор internal (доступ внутри пакета). При описании статического метода модификатор доступа обычно размещается перед атрибутом static, как показано в следующем обобщенном коде:
class НекийКласс {
public static function имяМетода (идентификатор! = значение!, идентификатор2 = значение2
идентификаторп = значениеп) {
} }
Для вызова статического метода используется следующий обобщенный код:
НекийКласс.имяМетода(значение!, значение2.. .значениеп)
В предыдущем коде НекийКласс обозначает класс, в котором определен статический метод, имяМетода — это имя статического метода, а значение!, значение2. . . значениеп — список, состоящий из нуля или более аргументов метода. Внутри класса, в котором определен данный метод, имя имяМетода может быть использовано самостоятельно (без лидирующего имени класса и точки). Например, в классе А, в котором определен статический метод ш, выражение А.ш ( ) идентично выражению m ( ). Тем не менее, чтобы различать статические методы и методы экземпляра, многие разработчики (это относится и к примерам данной книги) включают лидирующее имя класса даже в тех случаях, когда его использование не является обязательным. Некоторые классы существуют только ради определения статических методов, объединяя связанную функциональность, однако экземпляры таких классов никогда не создаются. Например, собственный класс Mouse существует только ради определения статических методов show ( ) и hide ( ) (используются для отображения или скрытия указателя мыши). Обращение к этим статическим методам происходит непосредственно через класс Mouse (как, например, Mouse. hide ( ) ), а не через экземпляр данного класса. Объекты класса Mouse никогда не создаются.
У статических методов есть два ограничения, которые отсутствуют у методов экземпляра. Во-первых, в методе класса нельзя использовать ключевое слово this.
Во-вторых, статический метод не может обращаться к переменным и методам экземпляра класса, в котором он определен (в отличие от методов экземпляра, которые, помимо переменных и других методов экземпляра, могут также обращаться к статическим переменным и статическим методам).
В целом, статические методы по сравнению со статическими переменными используются не часто. В нашей программе по созданию виртуального зоопарка статические методы не применяются вообще. Чтобы продемонстрировать применение статических методов на практике, вернемся к функции проверки адресов электронной почты, описанной в гл. 2. В этой функции мы создали цикл, который позволяет определить наличие или отсутствие символа @ в указанном адресе электронной почты. Теперь представим, что в результате активного развития нашего приложения было решено создать служебный класс для работы со строками. Назовем его StringUtils. Класс StringUtils не будет использоваться для создания объектов; он просто представляет коллекцию статических методов. В качестве примера мы определим один статический метод contains ( ), возвращающий значение типа Boolean — это значение определяет, содержит ли указанная строка выбранный символ. Рассмотрим код:
public class StringUtils {
public function contains (string, character) { for (var 1:1nt = 0; 1 <= string.length: 1++) {
1f (string.charAtd) == character) { return true;
}
}
return false;
}
}
В следующем примере кода показано, как наше приложение могло бы использовать метод contains( ), чтобы проверить, содержит ли указанный адрес электронной почты символ @:'
St г1ngUtl1s.centalns("me@moock.org", "@"):
Конечно, в реальном приложении адрес электронной почты вводил бы сам пользователь и метод contains ( ) определял бы допустимость отправки формы на сервер. Следующий код демонстрирует более реалистичную ситуацию:
1f (StringUtils.cental ns(userEmal1, "@")) {
// Этот код отправлял бы форму на сервер } else {
// Этот код отображал бы сообщение "Неправильные данные" для пользователя }
Помимо статических методов, которые создаются вручную, среда выполнения Flash автоматически создает для каждого класса один статический метод, называемый инициализатором класса. Познакомимся с ним поближе.
Инициализатор класса. После определения класса на этапе выполнения программы среда Flash автоматически создает и исполняет метод, называемый инициализатором класса. В нем среда Flash размещает все инициализаторы статических
переменных данного класса и весь код уровня класса, не относящийся к описаниям переменных или методов.
Инициализатор класса предоставляет возможность выполнять однократные задачи настройки сразу после определения класса, вызывая методы или обращаясь к переменным, являющимся внешними по отношению к текущему классу. Предположим, что мы создаем приложение для чтения электронной почты и хотим, чтобы внешний вид этого приложения соответствовал графическому стилю операционной системы. Чтобы определить, какая графическая тема должна быть использована в почтовом клиенте, в инициализаторе основного класса приложения Mail Re a de г проверяется текущая операционная система и присваивается соответствующее значение статической переменной theme. Переменная theme хранит информацию о графической теме, используемой в данном приложении. В следующем коде продемонстрирован инициализатор для класса MailReader. Для проверки операционной системы в классе MailReader используется статическая переменная os, определенная в собственном классе flash, system. Capabilities.
package {
Import flash.system.*;
public class MailReader {
static var theme;
1f (Capabilities.os == "MacOS") { theme = "MAC";
} else 1f (Capabilities.os == "Linux") { theme = "LINUX";
} else {
theme = "WINDOWS";
}
}
Код, размещаемый в инициализаторе класса, выполняется в режиме интерпретации, и JIT-компилятор не компилирует его. Динамически откомпилированный код выполняется гораздо быстрее интерпретируемого кода, поэтому в тех случаях, когда на первом месте стоит вопрос производительности, код, интенсивно использующий ресурсы процессора, следует выносить за пределы инициализатора класса.
Объекты Class
Как мы уже знаем, обращение к каждому статическому методу и к каждой статической переменной осуществляется через класс, в котором они определены. Например, для обращения к статической переменной maxCalories, заданной в классе VirtualPet, мы применяем следующий код:
V1rtualPet.maxCalories
Использование имени класса VirtualPet в предыдущем коде является не просто особенностью синтаксиса; на самом деле имя класса VirtualPet ссылается
на объект, в котором определена переменная maxCa lories. Объект, на которые ссылается имя класса Virtual Pet, является автоматически создаваемым экзем пляром собственного класса Class.
Во время выполнения программы каждый класс в языке ActionScript представляется экземпляром класса Class. С точки зрения программиста, объекты Class используются в основном для доступа к статическим переменным и методам класса. Тем не менее, как и любые другие объекты, они являются значениями которые могут быть присвоены переменным, переданы или возвращены из методов и функций. Например, в следующей модифицированной версии нашегс класса VirtualPet переменной vp присваивается объект Class, представляющий класс VirtualPet, после чего эта переменная используется для создания объекта VirtualPet:
package zoo {
public class VlrtualZoo {
private var pet;
public function VlrtualZoo ( ) {
var vp = VirtualPet;
pet = new vpCStan");
}
}
}
Описанная методика применяется в тех случаях, когда один SWF-файл желает обратиться к классам другого SWF-файла или когда мультимедийные элементы (например, изображения или шрифты) размещаются в другом SWF-файле. Обе описанные ситуации будут рассмотрены в части II.
Наше знакомство со статическими переменными и методами подошло к концу. Но перед тем, как перейти к следующей главе, сравним рассмотренные понятия с понятиями, применяемыми в языках C++ и Java.
Сравнение с терминологиями языков
C++ и Java
Концепции переменных экземпляра, методов экземпляра, статических переменных и статических методов присутствуют в большинстве объектно-ориентированных языков программирования. Для сравнения в табл. 4.1 перечислены эквивалентные понятия, применяемые в языках Java и C++.
Таблица 4.1. Сравнение терминологий
ActionScript
Java
C++
Переменная экземпляра
Поле или переменная экземпляра
Член данных
Метод экземпляра
Метод
Функция-член
Статическая переменная
Переменная класса
Статический член данных
Статический метод
Метод класса
Статическая функция-член
К функциям
Как мы уже знаем, методы экземпляра определяют поведение, которое относится к отдельному объекту, а статические методы — поведение, относящееся к отдельному классу. В следующей главе мы познакомимся с функциями, которые определяют независимые поведения, не относящиеся ни к объектам, ни к классам.
Функции
Функция, или замыкание функции, — это дискретный набор инструкций, выполняющих определенную задачу независимо от других классов или объектов. Для описания и использования замыканий функций применяется такой же базовый синтаксис, как и для методов экземпляра и статических методов. Функции описываются с помощью ключевого слова function и вызываются с помощью оператора круглых скобок, при необходимости функции могут возвращать значение, а внутри тела могут определяться локальные переменные. Тем не менее, в отличие от методов экземпляра (которые всегда связаны с объектом) и статических методов (которые всегда связаны с классом), замыкания функций создаются и используются самостоятельно либо в виде подзадачи в методе, либо в виде полезной процедуры, доступной в пакете или в любом месте программы.
Говоря на строгом профессиональном жаргоне спецификации языка ActionScript 3.0, и замыкания функций, и методы являются разновидностями функций, при этом термин «функция» вообще относится к вызываемому объекту, представляющему собой набор инструкций. Таким образом, замыкание функции является функцией, не связанной с объектом или классом, а метод — функцией, связанной с объектом (в случае с методами экземпляра) или классом (в случае со статическими методами). Тем не менее в лексиконе программистов и в подавляющем большинстве документации вместо термина «замыкание функции» используется его сокращенный вариант — «функция». Если вы не читаете спецификацию языка ActionScript 3.0 или текст, в котором указано обратное, можете смело предполагать, что функция означает замыкание функции. В оставшейся части этой книги термин «функция» обозначает замыкание функции, если не указано другое.
Для создания функции используется следующий обобщенный код, размещаемый в одном из перечисленных мест: внутри метода, непосредственно внутри описания пакета, непосредственно за пределами описания пакета или внутри другой функции. Обратите внимание, что используемый для описания функции код идентичен коду, применяемому для описания обычного метода экземпляра. На самом деле, если следующий код размещается непосредственно внутри тела класса, создается метод экземпляра, а не функция.
function идентификатор (параметр!, параметр2... параметра) { }
В этом коде идентификатор обозначает имя функции, а параметр!f параметр2. . . параметра — необязательный список параметров функции, которые используются точно так же, как и параметры метода, рассмотренные в гл. 1. Фигурные скобки, следующие за списком параметров, определяют начало и конец тела функции, содержащего инструкции, выполняемые при ее вызове.
Для вызова функции применяется следующий обобщенный код:
функция (значение!, значение2. .. значениеп)
В данном коде функция обозначает имя вызываемой функции, а значение!, значе- ние2. . . значениеп — список аргументов, которые связаны по порядку с параметрами функции функция.
Функции уровня пакета
Чтобы функция была доступна в пакете или в любой точке программы, ее описание должно размещаться непосредственно внутри тела пакета. Чтобы ограничить доступ к функции только тем пакетом, в котором она описана, перед описанием функции нужно указать модификатор управления доступом internal, как показано в следующем коде:
package имяПакета {
Internal function идентификатор ( ) {
}
}
Чтобы функция была доступна в любой точке программы, перед описанием функции нужно указать модификатор управления доступом public, как показано в следующем коде:
package имяПакета {
public function идентификатор ( ) {
}
}
Если никакой модификатор управления доступом не указан, то компилятор языка ActionScript автоматически использует модификатор internal.
Компиляторы, разработанные корпорацией Adobe, налагают два требования, затрагивающие функции уровня пакета, на исходные файлы (AS-файлы) программ, написанных на языке ActionScript.
Каждый исходный файл (AS-файл) программы должен содержать только одно описание, видимое извне. Это может быть описание класса, переменной, функции, интерфейса или пространства имен, определенное внутри тела пакета либо с помощью модификатора internal, либо с помощью модификатора public.
Имя каждого исходного файла программы должно совпадать с именем единственного видимого извне описания, которое содержится в этом файле.
Таким образом, если теоретически язык ActionScript и не налагает никаких ограничений на функции уровня пакета, то на практике компиляторы, разработанные корпорацией Adobe, требуют, чтобы каждая функция уровня пакета была определена либо с помощью модификатора internal, либо с помощью модификатора public и размещена в отдельном AS-файле, имя которого должно совпадать с именем функции. Дополнительную информацию об ограничениях, налагаемых компиляторами, можно найти в разд. «Ограничения компиляторов» гл. 7.
Следующий код создает функцию уровня пакета i sMa с ( ), возвращающую значение типа Boolean, которое указывает, является ли Macintosh текущей операционной
системой. Поскольку в описании функции i sMac ( ) указан модификатор управления доступом internal, эта функция будет доступна только внутри пакета utilities. Как было отмечено ранее, если для компиляции используется один из компиляторов, разработанных корпорацией Adobe, следующий код необходимо поместить в отдельный AS-файл с именем isMac. as.
package utilities {
import fl ash.system.*;
internal function isMac ( ) {
return Capabilities.os == "MacOS";
Чтобы функция isMac ( ) была доступна за пределами пакета utilities, необходимо заменить модификатор internal модификатором public, как показано в следующем коде: package utilities {
import fl ash.system.*;
public function isMac ( ) {
return Capabilities.os == "MacOS";
Тем не менее, чтобы иметь возможность использовать функцию isMac ( ) за пределами пакета utilities, ее сначала необходимо импортировать. Предположим, что функция isMac ( ) является частью большой программы с классом Welcome, входящим в пакет setup. Чтобы воспользоваться этой функцией в классе Welcome, в исходный файл этого класса должна быть импортирована функция utilities. isMac ( ), как показано в следующем коде: package setup {
// Импортировать функцию 1sMac( ). чтобы ее можно было использовать
// внутри тела этого пакета
import utilities.isMac;
public class Welcome {
public function Welcome ( ) {
// Воспользоваться функцией 1sMac( )
if (isMac( )) {
// Выполнить специфические для Macintosh действия }
Глобальные функции. Функции, определенные на уровне пакета и размещаемые внутри пакета без имени, называются глобальными, поскольку обращаться к ним можно глобально, из любой точки программы без необходимости использования оператора import. Например, следующий код определяет глобальную функцию isLinux ( ). Поскольку функция is Linux ( ) находится внутри пакета без имени, к ней можно обращаться из любого места кода данной программы.
package {
Import flash.system.*;
public function isLinux ( ) { return Capabilities.os == "Linux";
} }
Следующий код демонстрирует модифицированную версию класса Welcome из предыдущего раздела, в котором вместо функции isMac ( ) используется функция isLinux ( ). Обратите внимание, что перед применением функцию импортировать не нужно.
package setup {
public class Welcome {
public function Welcome ( ) {
// Воспользоваться функцией 1sLinux( )
if (1sLinux( )) {
// Выполнить специфические для Linux действия }
}
}
}
Многие функции уровня пакета и глобальные функции являются собственными для каждой отдельно взятой среды выполнения Flash. Список доступных функций можно найти в документации корпорации Adobe по интересуемой среде выполнения Flash.
Пожалуй, наиболее используемой собственной глобальной функцией является функция trace ( ), имеющая следующий обобщенный вид:
trace (аргумент!, аргумент2... аргумент)
Функция trace ( ) представляет собой простейший инструмент для поиска ошибок в программе (то есть для отладки). Она позволяет выводить указанные аргументы либо в окно среды разработки, либо в файл журнала. Например, при выполнении программы в тестовом режиме в среде разработки Flash с помощью команды Control ► Test Movie (Управление ► Проверка фильма) результаты всех вызовов функции trace ( ) появятся в окне Output (Вывод). Подобным образом при выполнении программы в тестовом режиме в приложении Flex Builder с помощью команды Run ► Debug (Выполнить ► Отладка) результаты всех вызовов функции trace ( ) появятся в окне Console (Консоль). Информацию по конфигурированию отладочной версии приложения Flash Player для вывода аргументов функции trace ( ) в текстовый файл можно найти по адресу http://livedocs.macromedia.com/ flex/2/docs/00001531.html.
Вложенные функции
Когда описание функции размещается внутри метода или другой функции, создается вложенная функция, которая доступна для использования только внутри содержащего ее метода или функции. По существу, вложенная функция описывает многократно используемую подзадачу, полностью принадлежащую тому методу
или функции, в которых она определена. Следующий код демонстрирует базовый пример вложенной функции b ( ), описанной внутри метода экземпляра а ( ). Вложенная функция b ( ) может быть использована только внутри метода а ( ); за пределами метода а ( ) функция b ( ) недоступна.
// Описание метода а( ) public function а ( ) {
// Вызов вложенной функции Ь( )
Ь( );
// Описание вложенной функции Ь( ) function b ( ) {
// Здесь должно размещаться тело функции•
}
}
В предыдущем коде стоит обратить внимание на то, что вложенная функция может вызываться в любом месте содержащего ее метода, даже до описания этой функции. Обращение к переменной или функции до того, как эта переменная или функция будут описаны, называется опережающим обращением. Помимо этого стоит отметить, что для вложенных функций невозможно использовать модификаторы управления доступом (public, internal и т. д.).
Следующий код демонстрирует более реальный пример метода, содержащего вложенную функцию. Метод getRandomPoint ( ) возвращает объект типа Point, который представляет произвольную точку в заданном прямоугольнике. Чтобы получить произвольную точку, этот метод использует вложенную функцию ge tRandoml ntедег ( ) для вычисления случайных координат по осям X и Y. Обратите внимание, что в функции getRandomlnteger ( ) применяются собственные статические методы Math. random ( ) и Math. floor ( ). Первый метод возвращает случайное число с плавающей запятой, большее либо равное 0, но меньшее 1. Второй метод устраняет дробную часть числа с плавающей запятой. Дополнительную информацию по статическим методам класса Math можно найти в справочнике по языку ActionScript корпорации Adobe.
public function getRandomPoint (rectangle) {
var randomX = getRandom!nteger(rectangle, left. rectangle.right);
var randomY = getRandom!nteger(rectangle.top, rectangle.bottom);
return new Point(randomX, randomY);
function getRandomlnteger (mln, max) {
return mln + Math.floor(Math.random( )*(max+l - mln));
}
}
Функции уровня исходного файла
Если описание функции размещается на верхнем уровне исходного файла за пределами тела пакета, то будет создана функция, доступная только внутри данно-
го исходного файла. В следующем примере представлено содержимое исходного файла А. as, включающее описание пакета, описание класса и описание функции уровня исходного файла. Поскольку функция определена за пределами оператора блока пакета, она может быть использована в любом месте кода внутри файла А. as, однако вне этого файла данная функция будет недоступна.
package {
// Функцию f( ) можно использовать здесь
class А {
// Функцию f( ) можно использовать здесь
public function А ( ) {
// Функцию f( ) можно использовать здесь
}
}
}
// Функцию f( ) можно использовать здесь.
function f ( ) {
}
В предыдущем коде обратите внимание на то, что описание функции f ( ) не содержит и не должно содержать никаких модификаторов управления доступом (publ i с, internal и т. д.).
Модификаторы управления доступом не должны применяться при описании функций уровня исходного файла.
Функции уровня исходного файла иногда используются для определения дополнительных модулей, относящихся к одному классу (как, например, к классу А в предыдущем коде). Тем не менее, поскольку дополнительные модули для класса можно определять и с помощью закрытых статических методов, функции уровня исходного файла редко используются в реальных программах на языке ActionScript.
Доступ к описаниям из функции
Место размещения функции в программе влияет на возможность обращения к описаниям этой программы из данной функции (то есть к классам, переменным, методам, пространствам имен, интерфейсам и другим функциям). Подробное описание того, к чему можно и к чему нельзя обращаться из кода функций, можно найти в разд. «Область видимости функций» гл. 16.
Обратите внимание, однако, что внутри замыкания функции ключевое слово this всегда ссылается на глобальный объект, независимо от места определения этой функции. Чтобы обратиться к текущему объекту внутри вложенной функции в методе экземпляра, присвойте ключевое слово this переменной, как показано в следующем коде:
public function m ( ) {
van currentobject = this:
function f ( ) {
// Здесь можно обращаться к переменной currentobject trace(currentObject): // Отображает объект, через который был // вызван метод т( )
}
}
Функции в качестве значений
В языке ActionScript любая функция представляется экземпляром класса Function. По существу, функция может быть присвоена переменной, передана в функцию или возвращена из нее точно так же, как и любое другое значение. Например, в следующем коде описывается функция а ( ), после чего она присваивается переменной Ь. Обратите внимание, что оператор круглых скобок ( ) опущен; в противном случае переменной Ь было бы просто присвоено возвращаемое значение функции а ( ).
function а ( ) {
}
var b = а;
Как только функция будет присвоена переменной, ее можно вызывать через эту переменную с помощью стандартного оператора круглых скобок ( ). Например, в следующем коде функция а ( ) вызывается через переменную Ь:
Ь( );
Функции-значения обычно используются при создании динамических классов и объектов, которые рассматриваются в разд. «Динамическое добавление нового поведения в экземпляр» и «Использование объектов-прототипов для дополнения классов» гл. 15.
Синтаксис литералов функций
Экземпляры класса Function, как и многих предопределенных классов языка ActionScript, можно создавать с помощью синтаксиса литералов. Он практически ничем не отличается от синтаксиса стандартного объявления функций, за исключением отсутствующего имени функции. Вот его общий вид:
function (параметр!, параметр2... параметра) { }
Здесь параметр!, параметр2. . . параметра — это необязательный список параметров.
Чтобы воспользоваться функцией, описанной с помощью литерала функции, за пределами выражения, в котором встречается данный литерал, мы можем присвоить эту функцию переменной, как показано в следующем коде:
var некаяПеременная = function (параметр!, параметр2. . . параметрп) { }
После этого вызывать функцию можно через данную переменную, как показано ниже:
некаяПеременная (аргумент!, аргумент2... аргумент)
Например, в следующем коде для создания функции, которая возводит число в квадрат, используется литерал функции, а созданная функция присваивается переменной square:.
var square = function (n) { return n * n;
}
Для вызова функции из предыдущего примера применяется следующий код:
// Возводит в квадрат число 5 и возвращает результат squareC 5)
Литералы функций иногда применяются совместно с собственной функцией flash. utils . set Interval ( ), которая имеет следующий вид:
setInterval(ФункцияИлиМетод, задержка)
Функция setinterval ( ) создает интервал, используемый для автоматического вызова указанной функции или метода (ФункцияИлиМетод) каждые задержка миллисекунд. Каждому создаваемому интервалу присваивается число, возвращаемое функцией set Interval ( ) и называемое идентификатором интервала. Идентификатор интервала может быть присвоен переменной, что в дальнейшем позволит удалить соответствующий интервал вызовом функции clear Interval ( ), как показано в следующем примере кода:
// Создать интервал, выполняющий функцию doSometh1ng( ) каждые
// 50 миллисекунд. Присвоить возвращаемый идентификатор интервала
// переменной Interval ID.
var Interval ID = set Interval(doSomethlng. 50):
// ...Далее в программе прекратить автоматический вызов функции
// doSomethlng( )
clearinterval(Interval ID);
"Класс Timer, рассматриваемый в разд. «Пользовательские события» гл. 12 и разд. «Создание
^ j „ анимации с использованием события TimerEventTIMER» гл. 24, предоставляет гораздо более
-3^ широкие возможности управления периодическим выполнением функций или методов.
В следующем коде продемонстрирован простейший класс Clock, который выводит отладочное сообщение "Tick! " один раз в секунду. Обратите внимание на использование литерала функции и собственных функций set Interval ( ) и trace ( ). package {
Import fl ash.utils.set Interval:
public class Clock {
public function Clock ( ) {
// Выполнять литерал функции один раз в секунду
setinterval(function ( ) {
traceCTick!");
}. 1000):
}
} }
Стоит отметить, что литералы функций используются исключительно ради удобства. Предыдущий код можно легко переписать с помощью вложенной функции, как показано далее:
package {
Import flash.utils.setinterval;
public class Clock {
public function Clock ( ) {
// Выполнять функцию t1ck( ) один раз в секунду setinterval(tick, 1000):
function tick ( ):void { traceCTick!");
}
}
}
}.
Можно утверждать, что версия класса Clock, реализованная с помощью вложенной функции, легче для чтения. Литералы широко используются при связывании функций с динамическими переменными экземпляра — этот вопрос рассматривается в разд. «Динамическое добавление нового поведения в экземпляр» гл. 15.
Рекурсивные функции
Рекурсивная функция — это функция, вызывающая саму себя. Следующий код демонстрирует простейший пример рекурсии. Всякий раз при выполнении функции trouble ( ) происходит ее повторный вызов:
function trouble ( ) {
troublet ): }
Если рекурсивная функция безусловно вызывает саму себя, как функция trouble ( ) в нашем случае, возникает бесконечная рекурсия (то есть такое состояние, когда функция не прекратит вызывать саму себя никогда). Без проверки условия бесконечная рекурсия теоретически привела бы к тому, что программа оказалась бы в бесконечном циклическом процессе выполнения функции. На практике, чтобы избежать подобной ситуации, рекурсивные функции вызывают сами себя только при выполнении заданного условия. Одним из классических примеров применения рекурсии является вычисление факториала, который представляет собой произведение всех целых положительных чисел, меньших либо равных данному числу. Например, факториал числа 3 (на математическом языке это записывается как 3!) равен 3 х 2 х 1, то есть 6. Факто-
риал числа 5 равен 5х4хЗх2х1,то есть 120. В листинге 5.1 продемонстрирована функция для вычисления факториала числа, реализованная с помощью рекурсии.
Листинг 5.1. Вычисление факториалов с помощью рекурсии
function factorial (n) {
1f (n < 0) {
return; И Неправильное число, завершаем работу
} else 1f (n <= 1) { return 1;
} else {
return n * factorial(n-1);
}
}
// Использование в программе:
factorial(3); // Возвращает: б
factorial(5); // Возвращает: 120
Вычислить факториал можно и с помощью цикла, полностью заменяющего рекурсию, как показано в листинге 5.2.
Листинг 5.2. Вычисление факториала без использования рекурсии
function factorial (n) {
1f (n < 0) {
return: И Неправильное число, завершаем работу
} else {
var result = 1;
for (var 1 = 1; 1 <= n; 1++) { result = result * 1;
}
return result;
}
}
В листингах 5.1 и 5.2 представлены два различных способа решения одной задачи. Рекурсивный подход гласит: «Факториал числа 6 равен числу 6, умноженному на факториал числа 5. Факториал числа 5 равен числу 5, умноженному на факториал числа 4...» и т. д. Нерекурсивный подход предполагает выполнение цикла для чисел от 1 до и, где происходит перемножение этих чисел, в результате чего получается одно большое число.
Использование рекурсивных функций считается элегантным подходом, поскольку оно обеспечивает простое решение сложных задач — циклический вызов одной и той же функции. Тем не менее повторяющиеся вызовы функции являются менее эффективными, чем итерации цикла. Нерекурсивный подход, применяемый для вычисления факториалов, во много раз эффективнее рекурсивного. Кроме того, нерекурсивный подход исключает достижение максимальной глубины рекурсии, равной по умолчанию 1000, которая, однако, может быть изменена аргументом компилятора default-script-limits.
В гл. 18 вы узнаете, что рекурсия иногда используется для обработки содержимого XML-документов с иерархической структурой.
Использование функций в программе «Зоопарк»
Применим наши новые знания функций к программе по созданию виртуального зоопарка (чтобы освежить в памяти существующий код программы, обратитесь к листингу 4.1, содержащему код класса VirtualPet).
Если помните, в последней версии нашей программы по созданию виртуального зоопарка животные могли только употреблять пищу (то есть накапливать калории), но не переваривать ее (то есть терять калории). Чтобы наши животные могли переваривать пищу, мы добавим новый метод digest ( ) в класс VirtualPet. Метод digest ( ) будет вычитать калории из того объекта VirtualPet, над которым осуществляется вызов данного метода. Чтобы имитировать переваривание пищи в течение времени, мы создадим интервал, используемый для вызова метода digest ( ) один раз в секунду. Количество калорий, потребляемых при каждом вызове метода digest ( ), будет определяться новой статической переменной caloriesPerSecond. Присвоим переменной caloriesPerSecond значение 100, позволяя животному прожить максимум 20 секунд на «полный желудок».
Следующий код демонстрирует описание переменной caloriesPerSecond:
private static var caloriesPerSecond = 100;
Далее представлено описание метода digest ( ). Обратите внимание, что, поскольку переваривание пищи является внутренним процессом, метод digest ( ) объявлен с использованием модификатора управления доступом private.
private function digest ( ) {
currentcalories -= VirtualPet.caloriesPerSecond;
}
Чтобы создать интервал, вызывающий метод digest ( ) один раз в секунду, воспользуемся собственной функцией setinterval ( ). Каждое животное должно приступать к перевариванию пищи сразу после его создания, поэтому поместим вызов функции setinterval ( ) в метод-конструктор класса Virtual Pet. Кроме того, сохраним идентификатор интервала, возвращаемый функцией setinterval ( ), в новой переменной экземпляра digestlntervallD, чтобы в дальнейшем при необходимости можно было удалить созданный интервал.
Следующий код демонстрирует описание переменной digestlntervallD:
private var digestlntervallD;
Измененный конструктор класса VirtualPet выглядит так:
public function VirtualPet (name) {
setName(name);
// Вызывать метод digestC ) один раз в секунду digestlntervallD = setinterval(digest, 1000);
}'
Теперь, когда объекты класса VirtualPet могут переваривать пищу, воспользуемся глобальной функцией t г а с е ( ), чтобы сообщать о текущем состоянии каждого животного в процессе отладки. Будет выдаваться сообщение о состоянии всякий
раз при выполнении методов digest ( ) или eat ( ). Обновленная версия метода digest ( ) выглядит следующим образом:
private function digest ( ) {
currentCalories -= VirtualPet.caloriesPerSecond;
trace(getName( ) + " digested some food. It now has " + currentCalories + " calories remaining.");
}
Обновленная версия метода eat ( ):
public function eat (numberOfCalories) {
var newCurrentCalories = currentCalories + numberOfCalories;
if (newCurrentCalories > VirtualPet.maxCalories) {
currentCalories = VirtualPet.maxCalories;
} else {
currentCalories = newCurrentCalories;
}
trace(getName( ) + " ate some food. It now has " + currentCalories + " calories remaining.");
}
Если бы мы запустили нашу программу «Зоопарк» прямо сейчас, то увидели бы следующие сообщения в окне Output (Вывод) (среда разработки Flash) или Console (Консоль) (Flex Builder):
Stan
digested
some food. It now
has
900
calories
remaining.
Stan
digested
some
food. It
now
has
800
calories
remaining.
Stan
digested
some
food. It
now
has
700
calories
remaining.
Stan
digested
some
food. It
now
has
600
calories
remaining.
Stan
digested
some
food. It
now
has
500
calories
remaining.
Stan
digested
some
food. It
now
has
400
calories
remaining.
Stan
digested
some
food. It
now
has
300
calories
remaining.
Stan
digested
some
food. It
now
has
200
calories
remaining.
Stan
digested
some
food. It
now
has
100
calories
remaining.
Stan
digested
some
food. It
now
has
0 calories remaining.
Stan
digested
some
food. It
now
has
-100 calories remaining
Stan
digested
some
food. It
now
has
-200 calories remaining
Stan
digested
some
food. It
now
has
-300 calories remaining
Но в чем же дело? Количество калорий у животных не должно принимать отрицательных значений. Вместо этого животные должны умирать, когда значение переменной currentCalories достигнет 0. В нашей программе состояние смерти будет выражаться следующим образом.
Если значение переменной currentCalories равно 0, программа будет игнорировать любые попытки увеличить значение переменной currentCalories путем вызова метода eat ( ).
Когда значение переменной currentCalories станет равным 0, программа удалит интервал, с помощью которого вызывается метод diges t ( ), и отобразит сообщение о «смерти животного».
Сначала модифицируем метод eat ( ). С поставленной задачей должен справиться простой условный оператор:
public function eat (numberOfCalones) {
// Если это животное мертво,
if (currentcalories = 0) {
// ...завершить метод, не изменяя значение переменной
// currentcalories
trace(getName( ) + " is dead. You can't feed it."); return;
}
var newCurrentCalorles = currentCalorles + numberOfCalones;
if (newCurrentCalorles > Virtual Pet.maxCalorles) { currentCalorles = Virtual Pet.maxCalorles;
} else {
currentCalorles = newCurrentCalorles;
}
trace(getName( ) + " ate some food. It now has " + currentCalorles + " calories remaining.");
}
Теперь мы должны остановить процесс вызова метода digest ( ), когда значение переменной currentcalories достигнет 0. Для этого воспользуемся функцией flash. utils . clearinterval ( ):
private function digest ( ) {
// Если в результате потребления очередной порции калорий значение
// переменной currentCalorles станет равным 0 или меньше...
1f (currentCalorles - V1rtualPet.calor1esPerSecond <= 0) {
// ...прекратить вызов метода d1gest( )
clearinterval(digestinterval ID);
// После чего очистить желудок животного
currentCalorles = 0;
// и сообщить о смерти животного trace(getName( ) + " has died.");
} else {
// ...иначе употребить оговоренное количество калорий currentCalorles -= V1rtualPet.calor1esPerSecond;
// и сообщить о новом состоянии животного
trace(getName( ) + " digested some food. It now has "
+ currentCalorles + " calories remaining.");
}
}
В листинге 5.3 представлен целиком весь код класса VirtualPet, включая все внесенные изменения.
Листинг 5.3. Класс VirtualPet
package zoo {
Import flash.utils.set Interval;
Import flash.utils.cl earinterval;
Internal class VlrtualPet {
private static var maxNameLength = 20;
private static var maxCalorles = 2000;
private static var calorlesPerSecond = 100;
private var petName;
private var currentCalorles = VlrtualPet.maxCalor1es/2;
private var digestinterval ID;
public function VlrtualPet (name) {
setName(name);
digestinterval ID = setinterval(digest, 1000);
public function eat (numberOfCalorles) {
1f (currentCalorles == 0) {
trace(getName( ) + " is dead. You can't feed it."); return;
}
var newCurrentCalorles = currentCalorles + numberOfCalorles;
if (newCurrentCalorles > Virtual Pet.maxCalorles) { currentCalorles = VlrtualPet.maxCalorles;
} else {
currentCalorles = newCurrentCalorles;
}
trace(getName( ) + " ate some food. It now has " + currentCalorles + " calories remaining.");
public function getHunger ( ) {
return currentCalorles / Virtual Pet.maxCalorles;
public function setName (newName) {
// Если длина заданного нового имени больше maxNameLength
// символов...
if (newName.length > Virtual Pet.maxNameLength) {
// ...обрезать имя
newName = newName.substr(0, VIrtualPet.maxNameLength);
} else if (newName == "") {
// ...в противном случае, если заданное новое имя является // пустой строкой, завершить выполнение метода, не изменяя // значения переменной petName return;
}
// Присвоить новое, проверенное имя переменной petName petName = newName;
public function getName ( ) { return petName;
}
private function digest ( ) {
// Если в результате потребления очередной порции калорий значение
// переменной currentCalorles животного станет равным 0 или меньше...
if (currentCalor1es - Virtual Pet.calorlesPerSecond <= 0) {
// ...прекратить вызов метода d1gest( ) clearinterval(digestinterval ID);
// После чего очистить желудок животного
currentCalorles = 0;
// и сообщить о смерти животного trace(getName( ) + " has died.");
} else {
// ...иначе употребить оговоренное количество калорий currentCalorles -= V1rtualPet.calor1esPerSecond:
// и сообщить о новом состоянии животного
trace(getName( ) + " digested some food. It now has " + currentCalorles + " calories remaining.");
}
}
}
}
Обратно к классам
Мы рассмотрели функции в языке ActionScript. В следующей главе мы вернемся к теме классов, уделив особое внимание наследованию при создания отношений между двумя или более классами. Разобравшись с вопросами наследования, мы сможем подготовить нашу программу по созданию виртуального зоопарка для компиляции и выполнения.
Наследование
В объектно-ориентированном программировании термин «наследование» обозначает формальное отношение между двумя или более классами, при котором один класс заимствует (или наследует) описания переменных и методов другого класса. С практической, или технической, точки зрения наследование просто позволяет использовать код одного класса в другом классе.
Однако наследование подразумевает нечто гораздо большее, чем повторное использование кода. Оно в равной мере является интеллектуальным и техническим инструментом и позволяет программистам концептуально представить группу классов в виде иерархических отношений. В биологии наследование представляет собой генетический процесс, при котором одно живое существо передает по наследству свои характерные черты другому существу. Вам говорят, что вы унаследовали глаза матери или нос отца, даже несмотря на то, что вы не похожи в точности ни на одного из родителей. В объектно-ориентированном программировании наследование имеет похожий смысл. Оно позволяет одному классу быть во многом подобным другому классу, но при этом обладать собственными уникальными свойствами.
Изучение этой главы мы начнем с рассмотрения синтаксиса и примеров использования наследования. Разобравшись с наследованием с практической точки зрения, мы рассмотрим его преимущества и альтернативы. И наконец, мы применим наследование к нашей программе по созданию виртуального зоопарка.
Пример наследования
Рассмотрим простой абстрактный пример, чтобы получить общее представление о том, как работает наследование (примеры практического применения наследования будут рассмотрены после того, как мы познакомимся с базовым синтаксисом). Существует класс А с одним методом экземпляра m ( ) и одной переменной экземпляра v:
public class А {
public var v = 10:.
public function m ( ) {
trace("Method m( ) was called"):
}
}
Как обычно, мы можем создать экземпляр класса А, вызвать метод m ( ) и обратиться к переменной v следующим образом:
var alnstance = new A( ):
alnstance.m( );// Выводит: Method m( ) was called
tracetalnstance.v); // Выводит: 10
Пока ничего нового. Теперь добавим второй класс В, который наследует метод m ( ) и переменную v класса А. Для создания отношения наследования между классами А и В используется ключевое слово extends:
public class В extends А {
// Никакие методы и переменные не определены }
Поскольку класс В расширяет (унаследован от) класс А, экземпляры класса В могут автоматически использовать метод m ( ) и переменную v (даже несмотря на то, что в самом классе В этот метод и переменная не определены):
var b!nstance:B = new В( );
blnstance.m( ):// Выводит: Method m( ) was called
tracetblnstance.v): // Выводит: 10
При выполнении инструкции blnstance. m ( ) среда Flash проверяет, определен ли метод m ( ) в классе В. Не найдя метода m ( ) в классе В, Flash продолжает его поиск в суперклассе класса В (то есть в том классе, который расширяется классом В). Среда выполнения находит метод m ( ) в классе А и вызывает его над переменной blnstance.
Обратите внимание, что в самом классе В не определены никакие методы или переменные. На практике определение класса, не добавляющего ничего нового в расширяемый класс, не имеет большого смысла, поэтому, как правило, это делать не рекомендуется. В обычном же случае, помимо методов и переменных, унаследованных от класса А, класс В определял бы свои собственные методы и/или переменные. Иными словами, подкласс на самом деле представляет собой расширенный набор возможностей, доступных в его суперклассе. Подкласс обладает всем, что доступно в суперклассе, а также дополнительными возможностями. Рассмотрим новую версию класса В, унаследовавшего метод m ( ) и переменную v от класса А и определяющего свой собственный метод п ( ):
public class В extends А {
public function n ( ) {
trace("Method n( ) was called"):
Теперь экземпляры класса В могут использовать все методы и переменные не только класса В, но и его суперкласса А:
var blnstance = new В( ):
// Вызов унаследованного метода, определенного в классе А blnstance.m( ):// Выводит: Method m( ) was called
// Вызов метода, определенного в классе В
blnstance.п( );// Выводит: Method n( ) was called
// Обращение к унаследованной переменной
tracetblnstance.v): // Выводит: 10
В данном случае говорят, что класс В специализирует класс А. Класс В использует возможности класса А в качестве своей основы, добавляя свои собственные возможности или даже — как мы увидим далее — перекрывая возможности класса А измененными для собственных нужд версиями. Таким образом, в отношении наследования между двумя классами расширяемый класс (в нашем случае А) называется базовым, а расширяющий класс (в нашем случае В) — производным. Иногда для обозначения базового и производного классов также используются понятия «предок» и «потомок» соответственно.
Наследование может (а зачастую так и происходит) включать больше чем два класса. Например, даже несмотря на то, что класс В унаследован от класса А, класс В может стать базовым для другого класса. Следующий код демонстрирует третий класс С, который расширяет класс В, а также определяет новый метод о ( ). Класс С может использовать все методы и переменные, определенные в нем самом и во всех его предках, то есть в его суперклассе (В) и суперклассе суперкласса (А).
public class С extends В {
public function о ( ) {
trace("Method o( ) was called");
}
}
// Использование:
van clnstance = new C( );
// Вызов метода, унаследованного от класса А
clnstance.m( ); // Выводит: Method m( ) was called
// Вызов метода, унаследованного от класса В
clnstance.п( ); // Выводит: Method n( ) was called
// Вызов метода, определенного в классе С
clnstance.о( ); // Выводит: Method о( ) was called
// Обращение к переменной, унаследованной от класса А.
trace(clnstance.v); // Выводит: 10
Более того, каждый суперкласс может иметь любое количество подклассов (однако у суперкласса нет никакой возможности узнать, какие подклассы расширяют его возможности). Следующий код добавляет в наш пример четвертый класс D. Как и В, класс D наследуется непосредственно от А. Класс D может использовать методы и переменные, определенные в нем самом и в его суперклассе А.
public class D extends A {
public function p ( ) {
trace("Method p( ) was called"):
}
}
Четыре класса из нашего примера образуют так называемое дерево наследования, или иерархию классов. Наглядно эта иерархия представлена на рис. 6.1. Обратите внимание, что подкласс не может иметь более одного непосредственного суперкласса.
Все приложения, разработанные с использованием объектно-ориентированного подхода, могут быть описаны с помощью диаграммы классов наподобие той, что
изображена на рис. 6.1. На самом деле многие разработчики перед тем, как приступить к написанию кода, создают диаграммы классов. Эти диаграммы могут быть неформальными, нарисованными в соответствии с собственной иконографией разработчика, или формальными, нарисованными в соответствии со спецификацией изображений диаграмм, к которой относится, например, язык UML (Unified Modeling Language) (дополнительную информацию можно получить по адресу http://www.uml.org).
Аналогично тому, как мы разрабатываем собственные иерархии классов для наших приложений, реализуемых с помощью объектно-ориентированного подхода, язык ActionScript тоже организует свои собственные классы в соответствии с иерархией. На самом деле любой класс в языке ActionScript (как собственный, так и пользовательский) унаследован прямо или косвенно от корневого элемента внутренней иерархии языка — класса Object. Класс Object определяет несколько базовых методов и переменных, доступных всем классам через наследование. Например, любой класс может воспользоваться методом Obj ect. toString ( ), возвращающим строковое представление объекта.
Статические методы и статические переменные не наследуются. В отличие от методов и переменных экземпляра, подкласс не наследует статические методы и статические переменные своего суперкласса.
Например, в следующем коде мы определяем статический метод s ( ) в классе А. Метод s ( ) не наследуется подклассом В класса А, и, следовательно, к этому методу нельзя обратиться в виде В. s ( ).
public class А {
public static function s ( ) { trace("A.s( ) was called");
}
public class В extends A {
public function В ( ) {
B.s( ); // Ошибка! Недопустимая попытка обращения
// к методу A.s( ) через класс В
}
Тем не менее в теле любого из классов А или в к статическим методам и переменным, определенным в классе А, можно обращаться непосредственно, не указывая имя класса, например s ( ) вместо А. s ( ). Но несмотря на это, при обращении к статическим методам или статическим переменным вообще разумно указывать имя класса. Когда указано имя класса, становится совершенно ясно, к какому классу относится метод или переменная.
Перекрытие методов экземпляра
В этой главе мы уже познакомились с такими методиками наследования, как повторное использование, когда подкласс использует методы и переменные своего суперкласса, и расширение, когда подкласс добавляет собственные методы и переменные. Сейчас мы рассмотрим еще одну методику — переопределение, при которой подкласс реализует альтернативную версию метода, определенного в его суперклассе.
Имейте в виду, что методики повторного использования, расширения и переопределения не являются взаимоисключающими. В подклассе могут применяться все три методики.
Переопределение позволяет приспособить существующий класс для решения специфической задачи путем дополнения, наложения ограничений или даже аннулирования одной или нескольких исходных возможностей. Переопределение метода на техническом языке называется перекрытием.
Язык ActionScript 3.0 позволяет переопределять методы экземпляра, но не допускает переопределения переменных экземпляра, статических переменных и статических методов.
Чтобы перекрыть метод экземпляра суперкласса, мы должны добавить в подкласс описание метода экземпляра с таким же именем, предварив его ключевым словом override. Например, рассмотрим следующий код, в котором создается класс А с методом экземпляра m ( ): public class А {
// Объявление метода экземпляра в суперклассе
public function m ( ) {
traceCA's m( ) was called");
}
Рассмотрим также следующий код, в котором создается класс В, унаследованный от класса А:
// Класс В является подклассом класса А public class В extends А {
}
Чтобы перекрыть метод m ( ) в классе В, мы используем следующий код: public class В extends А {
// Перекрытие метода суперкласса т( )
override public function m ( ) { traceCB's m( ) was called");
Обратите внимание, что версия метода m ( ) класса В обладает не только таким же именем, как у версии метода класса А, но и таким же модификатором управления доступом (то есть public).
Для успешного перекрытия метода необходимо, чтобы у перекрывающей версии метода м и у перекрываемого метода совпадали имя, модификатор управления доступом, список У параметров и возвращаемый тип (возвращаемые типы будут рассмотрены в гл. 8).
В противном случае произойдет ошибка.
Когда метод m ( ) вызывается через экземпляр класса А, среда выполнения Flash использует описание метода из класса А. Однако когда метод m ( ) вызывается через экземпляр класса В, среда Flash использует описание метода из класса В вместо описания из класса А:
var alnstance = new А( );
alnstance.m( ); // Выводит: A's m( ) was called
var blnstance = new B( );
blnstance.m( ); // Выводит: B's m( ) was called
Рассмотрим более реальный пример. Предположим, что мы разрабатываем геометрическую программу, отображающую прямоугольники и квадраты. Прямоугольники в нашей программе будет представлять класс Rectangle, продемонстрированный в следующем коде:
public class Rectangle {
protected var w = 0:
protected var h = 0:
public function setsize (newW, newH) {
w = newW;
h = newH;
}
public function getArea ( ) { return w * h;
}
Для представления квадратов в программе мы могли бы создать совершенно независимый класс Square. Однако квадрат на самом деле представляет собой не что иное, как прямоугольник с равными сторонами. Чтобы воспользоваться этим подобием, мы создадим класс Square, расширяющий класс Rectangle, но при этом модифицирующий метод set Size ( ) для предотвращения присваивания значений переменным w и h в тех случаях, когда значения параметров newW и newH не равны между собой. Это ограничение относится только к квадратам, а не к прямоугольникам вообще, поэтому оно не реализуется в классе Rectangle.
Рассмотрим код класса Square, в котором продемонстрирован перекрытый метод setSize ( ):
public class Square extends Rectangle {
override public function setSize (newW, newH) {
// Это ограничение, накладываемое классом Square
if (newW == newH) {
w = newW: h = newH;
}
При вызове метода set Size ( ) через экземпляр класса Square или Rectangle среда выполнения Flash использует ту версию метода, которая соответствует фактическому классу экземпляра. Например, в следующем коде мы вызываем метод s е t S i z е ( ) через экземпляр класса Rectangle. Среда Flash знает, что классом экземпляра является Rectangle, поэтому вызывается версия метода setSize ( ) из этого класса:
var г = new Rectangle( );
r.setSize(4,5);
trace(r.getArea( )); // Выводит: 20
В отличие от этого, в следующем коде мы вызываем метод setsize ( ) через экземпляр класса Square. На этот раз среда выполнения Flash знает, что классом экземпляра является Square, поэтому версия метода setSize ( ) вызывается именно из этого класса, а не из класса Rectangle:
var s = new Square( );
s.setSize(4,5);
trace (s.getArea( )); // Выводит: 0 (Метод setS1ze( ) предотвращает //присваивание недопустимых значений)
В предыдущем коде результат вызова метода s. getArea ( ) равен 0. Это говорит о том, что значения переменных w и h не были установлены при вызове метода s. setSize ( ). В версии метода setSize ( ) класса Square значения переменным w и h присваиваются только в том случае, когда значения параметров newW и newH равны между собой.
Вызов перекрытого метода экземпляра. Когда подкласс перекрывает метод экземпляра, версия этого метода, определенная в суперклассе, не теряется. Экземпляры подкласса могут обращаться к этой версии метода посредством оператора super, позволяющего вызывать перекрытый метод следующим образом:
super.имяМетода (аргумент!, аргумент2... аргумент);
В этом коде имяМетода обозначает имя вызываемого перекрытого метода, а аргумент!, аргумент2. . . аргумент — список аргументов, передаваемых в этот метод (другие варианты использования оператора super будут рассмотрены далее в этой главе).
В качестве примера вызова перекрытого метода вернемся к сценарию с классами Square и Rectangle. В предыдущем разделе наш метод Square. setSize ( ) без необходимости дублировал код метода Rectangle. setSize ( ). Рассмотрим версию метода, определенную в классе Rectangle:
public function setsize (newW, newH) {
w = newW;
h = newH;
В версии метода setsize ( ), определенной в классе Square, просто добавлен оператор if:
override public function setsize (newW, newH) {
1f (newW == newH) {
w = newW; h = newH;
}
}
Чтобы избежать дублирования кода, используемого в обоих методах для присваивания значений переменным w и h, мы можем воспользоваться оператором super, как показано в следующей модифицированной версии метода Square, setsize ( ):
override public function setsize (newW, newH) {.
if (newW == newH) {
// Вызов метода setSize( ) суперкласса над текущим экземпляром super.setSize(newW, newH);
}
}
Модифицированный метод setsize ( ) icnaccaSquare проверяет, одинаковы ли значения параметров newW и newH. Если значения одинаковы, то вызывается метод setsize ( ) класса Rectanqle над текущим экземпляром. Метод setsize ( ) класса Rectanqle позаботится о присваивании значений переменным w и h.
Приведенный пример с методом setsize ( ) демонстрирует, как подкласс может перекрывать метод для ограничения его поведения. Кроме того, подкласс может перекрывать метод для дополнения его поведения. Например, следующий код создает класс ScreenRectanqle, являющийся подклассом класса Rectanqle и отображающий на экране прямоугольник. Подкласс ScreenRectanqle перекрывает метод s е t S i z е ( ), сохраняя поведение перекрываемого метода, но при этом добавляя вызов метода draw ( ), в результате чего размеры прямоугольника на экране изменяются всякий раз при вызове метода s е t S i z е ( ):
public class ScreenRectangle extends Rectangle {
override public function setsize (newW, newH) {
// Вызов версии метода setSize( ) класса Rectangle super.setS1ze(newW, newH);
// Теперь отображаем прямоугольник на экране draw( );
}
public function draw ( ) {
// Здесь размещается код, отображающий прямоугольник на экране
Перекрытие можно использовать и для аннулирования поведения метода. Методика очень проста: версия перекрытого метода подкласса не выполняет никаких действий. Например, следующий код демонстрирует подкласс ReadOnlyRectangle, блокирующий метод set Size ( ) класса Re с tangle, в результате чего исключается возможность изменения размера для экземпляра этого подкласса:
public class ReadOnlyRectangle extends Rectangle {
// Следующее определение фактически блокирует метод setS1ze( )
// для экземляров класса ReadOnlyRectangle.
override public function setsize (newW, newH) {
// Никаких действий
Методы-конструкторы о подклассах
Теперь, когда мы рассмотрели поведение методов и переменных экземпляра относительно наследования, обратим наше внимание на методы-конструкторы.
Вспомним, что метод-конструктор инициализирует экземпляры класса следующими способами:
вызывая методы, которые выполняют задачи настройки;
присваивая значения переменным созданного объекта.
Когда происходит расширение класса, подкласс может определять собственный метод-конструктор. На конструктор подкласса возлагаются следующие функции:
выполнять задачи настройки, относящиеся к подклассу;
присваивать значения переменным, описанным в подклассе;*
вызывать метод-конструктор подкласса (иногда называемый суперконструктором).
Если в подклассе определен метод-конструктор, в нем обязательно должен вызываться конструктор суперкласса с помощью ключевого слова super. Более того, конструктор суперкласса должен вызываться до обращения к любой переменной или методу экземпляра. Если конструктор суперкласса не будет вызван явно, компилятор автоматически добавит вызов конструктора суперкласса без аргументов. И наконец, ключевое слово super не должно использоваться в методе-конструкторе более одного раза.
Запрещение использования ключевого слова super после того, как произошло обращение к любой переменной или методу экземпляра, имеет следующие преимущества:
исключается вызов методов над объектом, который еще не был проинициали- зирован;
устраняется доступ к переменным объекта, который еще не был проинициали- зирован;
исключается возможность перезаписи значений переменных, присвоенных в конструкторе подкласса, в результате последующего вызова конструктора суперкласса.
Не путайте две разновидности оператора super. Первая разновидность — super() — вызывает метод-конструктор суперкласса. Вторая разновидность — super.имяМетода() — вызывает метод суперкласса. Использование первой разновидности допустимо только в методе-конструкторе. Вторая разновидность может многократно применяться в любом месте метода-конструктора или метода экземпляра.
Рассмотрим применение оператора super для вызова метода-конструктора суперкласса в простейшем случае. Следующий код описывает класс А с пустым методом- конструктором:
public class А {
public function А ( ) {
}
Следующий код описывает класс В, который расширяет класс А. Внутри метода- конструктора класса В мы используем оператор super для вызова метода-конструктора класса А:
public class В extends А {
// Конструктор подкласса
public function В ( ) {
// Вызов метода-конструктора суперкласса.
super( );
С точки зрения функциональности следующие описания двух методов-конструкторов являются синонимами. В первом случае метод-конструктор суперкласса вызывается явно; во втором случае среда выполнения Flash вызывает метод-конструктор суперкласса неявно.
public function В ( ) {
// Явный вызов метода-конструктора суперкласса
super( );
public function В ( ) {
// Вызов конструктора отсутствует.
// Среда Flash вызовет конструктор автоматически
Если в подклассе метод-конструктор не определен вообще, то компилятор языка ActionScript автоматически создаст метод-конструктор и добавит в него одну инструкцию — вызов оператора super. Следующие два описания класса В функционально являются идентичными. Первое описание в явном виде представляет то, что для второго описания автоматически создает компилятор:
// Определение конструктора в явном виде
public class В extends А {
// Явное объявление конструктора
public function В ( ) {
// Явный вызов метода-конструктора суперкласса
super( );
}
}
// Позволить компилятору автоматически создать конструктор по умолчанию public class В extends А { }'
Метод-конструктор подкласса может (а зачастую так и происходит) иметь другие параметры, нежели его коллега из суперкласса. Например, в нашем классе Rectangle можно было бы определить конструктор с параметрами width и height, а класс Sguare мог бы иметь собственный конструктор с одним параметром side (у квадратов ширина и высота совпадает, поэтому не нужно указывать оба значения). В листинге 6.1 продемонстрирован этот код.
Листинг 6.1. Конструкторы классов Rectangle и Square
public class Rectangle {
protected var w = 0; protected var h = 0;
// Конструктор класса Rectangle
public function Rectangle (width, height) { setS1ze(w1dth. height);
}
public function setsize (newW, newH) {
w = newW; h = newH;
public function getArea ( ) { return w * h;
public class Square extends Rectangle {•
// Конструктор класса Square
public function Square (side) {
// Передаем параметр side в конструктор класса Rectangle super(s1de, side);
}
override public function setsize (newW, newH) {
1f (newW == newH) {
// Вызов метода setS1ze( ) суперкласса над текущим экземпляром super.setsize(newW, newH);
}'
}
Кстати, вы могли бы задаться вопросом, а не лучше ли определить метод s е t S i z е ( ) класса Sguare с одним параметром side, чем иметь два отдельных параметра width
и height. Это демонстрирует следующая версия метода setSize ( ) (обратите внимание, что в методе больше не нужна проверка значений параметров newW и newH на равенство).
override public function setSize (side) {
// Вызов метода setSize( ) суперкласса над текущим экземпляром super.setSize(side, side);
Хотя приведенная версия метода setsize ( ), несомненно, является более подходящей для класса Square, она приведет к ошибке, поскольку имеет меньшее количество параметров, чем версия метода setSize ( ) класса Rectangle (помните, что количество параметров, определенных в перекрывающем методе, должно совпадать с количеством параметров перекрываемого метода). Позднее, в подразд. «Наследование в сравнении с композицией» разд. «Теория наследования», мы рассмотрим альтернативный допустимый вариант реализации версии метода setSize ( ) с одним параметром в классе Square.
При определении метода-конструктора подкласса обязательно указывайте все требуемые аргументы для конструктора суперкласса. Метод-конструктор класса ColoredBall из следующего примера определен неправильно, поскольку в метод-конструктор суперкласса не передается необходимая информация:
public class Ball {
private var r;
public function Ball (radius) { r = radius;
public class ColoredBall extends Ball { private var c;
// Это проблематичный конструктор...
public function ColoredBall (color) {
// Ой! Отсутствует вызов оператора super( ). Здесь произойдет ошибка,
// поскольку в конструктор класса Ball необходимо передать аргумент
// для параметра radius
С = color;
}
}
Далее приводится исправленная версия класса ColoredBall, в которой требуемый аргумент передается в конструктор класса Ball:
public class ColoredBall extends Ball {
private var c;
// Все исправлено...
public function ColoredBall (radius, color) { super(radius);
c = color;
}
}
Обратите внимание, что, если придерживаться хорошего тона программирования, в конструкторе подкласса сначала перечисляются параметры суперкласса (в данном случае radius), а затем дополнительные аргументы конструктора подкласса (в данном случае color).
Исключение возможности расширения классов и перекрытия методов
Чтобы исключить возможность расширения класса или перекрытия метода, перед описанием класса или метода необходимо добавить атрибут final. Например, следующий код описывает класс А, не допускающий расширения:
final public class А {
}
Поскольку класс А описан с использованием атрибута final, попытка расширить этот класс следующим образом:
public class В extends А {
}
завершится ошибкой на этапе компиляции программы:
Base class 1s final. (Базовый класс является конечным.)
Подобным образом следующий код описывает метод m ( ), не допускающий перекрытия:
public class А {
final public function m ( ) {
}
}
Поскольку метод m ( ) описан с помощью атрибута fin а 1, попытка перекрыть этот метод следующим образом:
public class В extends А {
override public function m ( ) {
}
}
завершится ошибкой на этапе компиляции программы:
Cannot redefine a final method. (Невозможно переопределить конечный метод.)
В языке ActionScript атрибут final используется по нескольким причинам.
□ В некоторых ситуациях методы, описанные с помощью атрибута final, выполняются быстрее, чем методы, описанные без него. Если вы хотите улучшить производительность вашего приложения всеми возможными способами, попробуйте описать методы, используя атрибут final. Однако стоит отметить, что в будущих версиях среды выполнения Flash корпорация Adobe планирует увеличить скорость выполнения методов, описанных без использования атрибута final, в результате чего она не будет отличаться от скорости выполнения методов, описанных с помощью атрибута final.
□ Методы, описанные с помощью атрибута fin а 1, помогают скрыть детали внутренней реализации класса. Если описать класс или метод, используя этот атрибут, другие программисты не смогут расширить такой класс или перекрыть метод с целью изучения внутренней структуры класса. Такая мера предосторожности является одним из способов защиты приложения от вредоносного кода.
Если оставить в стороне проблемы эффективности и обеспечения безопасности, сообщество программистов разделилось на два лагеря в обсуждении вопроса, является ли описание методов и классов с помощью атрибута final хорошей практикой объектно-ориентированного программирования. С одной стороны, часть программистов утверждает, что методы и классы, описанные с помощью атрибута final, являются полезными, поскольку в данном случае можно быть уверенным в том, что объект будет вести себя в соответствии с четко определенным поведением, а не в соответствии с непредсказуемым (и потенциально проблематичным) перекрытым поведением. В то же время другие программисты утверждают, что методы и классы, описанные с помощью атрибута final, противоречат основному принципу объектно-ориентированного программирования — полиморфизму, который предполагает, что экземпляр подкласса может быть использован везде, где допустимо применение его суперкласса. С полиморфизмом мы познакомимся далее в этой главе.
Создание подклассов внутренних классов
Точно так же, как мы создаем подклассы для наших собственных классов, мы можем создавать подклассы для любого внутреннего класса, описанного без использования атрибута final, что позволит реализовать специализированную функциональность на базе существующего класса языка ActionScript. Пример расширения внутреннего класса Array можно найти в разделе Programming ActionScript 3.0 ► Core ActionScript 3.0 Data Types and Classes ► Working with Arrays ► Advanced Topics документации по программированию на языке ActionScript 3.0 корпорации Adobe. Пример расширения внутреннего класса Shape среды выполнения Flash можно найти в разд. «Пользовательские графические классы» гл. 20.
Некоторые внутренние классы языка ActionScript представляют собой простые коллекции методов и переменных класса, например классы Math, Keyboard и Mouse существуют только для хранения связанных методов и переменных (например, Math. random ( ) и Keyboard. ENTER). Такие классы называют библиотеками статических методов. Они объявляются в основном с использованием атрибута final.
Вместо того чтобы расширять эти классы, вы должны создавать свои собственные библиотеки статических методов. Например, вместо добавления метода factorial ( ) в подкласс класса Math следует создать собственный класс, скажем, AdvancedMath, который будет хранить ваш метод factorial ( ). Класс AdvancedMath не может быть связан с классом Math через отношение наследования.
Теория наследования
До настоящего момента основное внимание уделялось рассмотрению деталей практического применения наследования в языке ActionScript. Однако теория о том, где и когда применять наследование, гораздо глубже технической реализации. Рассмотрим несколько основных теоретических принципов, принимая во внимание тот факт, что для освещения этой темы целиком нескольких страниц явно недостаточно. Более подробное описание теории наследования можно найти по адресу http://archive.eiffel.com/doc/manuals/technology/oosc/inheritance-design/ page.html. Страница представляет собой онлайновую выдержку из книги «Object- Oriented Software Construction» (издательство Prentice Hall) Бертранда Мейера (Bertrand Meyer).
Почему наследование?
Наиболее очевидным преимуществом наследования является возможность повторного использования кода. Наследование позволяет отделять набор базовых возможностей от их специализированных версий. Код базовых возможностей хранится в суперклассе, а код специализаций полностью содержится в подклассе. Более того, суперкласс могут расширять несколько подклассов, благодаря чему одновременно может существовать несколько специализированных версий определенного набора возможностей. Если в суперклассе изменяется реализация некоторой возможности, все подклассы автоматически наследуют это изменение.
Кроме того, наследование позволяет выражать архитектуру приложения в иерархических терминах, отражающих реальный мир и человеческую психологию. Например, в реальном мире мы считаем, что растения отличаются от животных, но в то же время и тех и других мы относим к живым существам. Мы считаем, что автомобили отличаются от самолетов, но и те и другие являются средством передвижения. Соответствующим образом в приложении для управления кадрами может существовать суперкласс Employee с подклассами Manager, СЕО и Worker. В банковском приложении можно создать суперкласс BankAccount с подклассами CheckingAccount и SavingsAccount. Все эти канонические примеры демонстрируют одну из разновидностей наследования, иногда называемую наследованием подтипов, когда иерархия классов приложения моделирует ситуацию в реальном мире (называемую доменом или проблемной областью).
Несмотря на то что примеры классов Employee и BankAccount демонстрируют привлекательные возможности наследования, далеко не каждое наследование отражает реальный мир. На самом деле чрезмерный акцент на моделировании реального мира может привести к неправильному пониманию наследования и, как следствие, к его неправильному использованию. Например, в случае с классом Person мы могли бы поддаться искушению и создать подклассы Female и Male. В реальном мире данные категории являются логичными, но если бы эти классы использовались, скажем, в приложении для генерации отчетов в учебном заведении, нам пришлось бы создать классы MaleStudent и Femalestudent только для того, чтобы сохранить иерархию реального мира. В нашей программе операции,
описанные для студентов мужского пола, ничем не отличаются от операций, описанных для студентов женского пола, и, следовательно, должны использоваться одинаково. В данном случае иерархия реального мира конфликтует с иерархией нашего приложения. Если вам необходима информация о поле, лучше создать один класс Student и добавить переменную gender в класс Person. Насколько бы это ни было заманчивым, мы должны избегать создания структур наследования, основываясь исключительно на реальном мире, а не на требованиях нашей программы.
И наконец, помимо возможности повторного использования кода и создания логической иерархии, наследование позволяет применять различные типы объектов там, где требуется только один тип. Эта важная возможность, называемая полиморфизмом, заслуживает отдельного рассмотрения.
Полиморфизм и динамическое связывание
Полиморфизм — это возможность, присущая всем настоящим объектно-ориентированным языкам программирования, которая заключается в том, что экземпляр подкласса может быть использован везде, где допустимо применение экземпляра его суперкласса. Само по себе слово «полиморфизм» буквально обозначает «множество форм» — любой объект можно рассматривать как экземпляр собственного класса или как экземпляр любого из его суперклассов.
Напарником полиморфизма является динамическое связывание, гарантирующее, что в результате вызова метода над объектом будут выполнены именно те инструкции, которые определены в фактическом классе данного объекта.
В качестве канонического примера полиморфизма и динамического связывания можно привести графическое приложение, отображающее фигуры на экране. В этом приложении определен класс Shape с нереализованным методом draw ( ):
public class Shape {
public function draw ( ) {
// Реализация метода отсутствует. В некоторых других языках
// метод draw( ) был бы объявлен с помощью атрибута abstract,
// который синтаксически обязует подклассы класса Shape
// предоставить реализацию данного метода.
}
}
Класс Shape имеет несколько подклассов — Circle, Rectangle и Triangle, каждый из которых предоставляет собственное описание метода draw ( ):
public class Circle extends Shape {
override public function draw ( ) {
// Код для отрисовки окружности на экране не показан...
}
}
// Код для отрисовки прямоугольника на экране не показан... }
public class Triangle extends Shape { override public function draw ( ) {
// Код для отрисовки треугольника на экране не показан...
}
Чтобы нарисовать новую фигуру на экране, мы передаем экземпляр класса Circle, Rectangle или Triangle в метод addShape ( ) основного класса приложения DrawingApp. Код метода addShape ( ) класса DrawingApp выглядит следующим образом:
public function addShape (newShape) { newShape.draw( ):
// Оставшаяся часть метода (код не показан) занималась бы добавлением
// новой фигуры во внутренний список фигур, отображаемых // на экране
}
Теперь рассмотрим пример добавления фигуры, представленной классом Circle, на экран:
drawlngApp.addShape(new C1rcle( )):
Метод addShape ( ) вызывает метод draw ( ) для новой фигуры и добавляет эту фигуру во внутренний список фигур, отображаемых на экране. И самое главное — метод addShape ( ) вызывает метод draw ( ), не зная (и не заботясь о том), экземпляром какого класса является новая фигура — Circle, Rectangle или Triangle. Благодаря процессу динамического связывания, происходящему на этапе выполнения программы, среда Flash использует подходящую реализацию данного метода. Иными словами, если новая фигура является экземпляром класса Circle, то среда выполнения Flash вызовет метод Circle. draw ( ); если новая фигура является экземпляром класса Rectangle, то Flash вызовет метод Rectangle. draw ( ); если же новая фигура является экземпляром класса Triangle, то среда Flash вызовет метод Triangle. draw ( ). Важно отметить, что на этапе компиляции конкретный класс добавляемой фигуры неизвестен. По этой причине динамическое связывание часто называют поздним связыванием; вызов метода связывается с конкретной реализацией «с опозданием» (то есть на этапе выполнения).
Ключевым преимуществом динамического связывания и полиморфизма является возможность локализации изменений кода. Полиморфизм позволяет одной части приложения оставаться неизменной даже при изменении другой части. Например, рассмотрим, каким образом мы могли бы нарисовать фигуры, если бы полиморфизм не существовал. Во-первых, нам бы пришлось использовать уникальные имена для каждой версии метода draw ( ):
public class Circle extends Shape {
public function drawClrcle ( ) {
// Код для отрисовки окружности на экране не показан...
}
}
public class Rectangle extends Shape {
public function drawRectangle ( ) {
// Код для отрисовки прямоугольника на экране не показан...
}
}
public class Triangle extends Shape {
public function drawTrlangle ( ) {
// Код для отрисовки треугольника на экране не показан...
}
}
Далее внутри метода addShape ( ) класса DrawingApp нам бы пришлось использовать оператор is, чтобы вручную определять класс каждой новой фигуры и вызывать подходящий метод для отрисовки, как показано в следующем коде. Оператор is возвращает значение true в том случае, если указанное выражение принадлежит заданному типу данных; в противном случае возвращается значение false. Типы данных и оператор is будут рассмотрены в гл. 8.
public function addShape (newShape) {
1f (newShape 1s Circle) {
newShape.drawCIrde( );
} else if (newShape 1s Rectangle) { newShape.drawRectangle( );
} else if (newShape 1s Triangle) { newShape.drawTr1angle( );
}
// Оставшаяся часть метода (код не показан) занималась бы добавлением // новой фигуры во внутренний список фигур, отображаемых на экране }
Уже сейчас очевидны трудности выбранного подхода. Теперь представьте, что произойдет, если мы добавим 20 новых типов фигур. Для каждого нового типа нам придется вносить изменения в метод addShape ( ). В мире, где существует полиморфизм, нам не пришлось бы изменять код, вызывающий метод draw ( ) над каждым экземпляром класса Shape. Поскольку каждый подкласс класса Shape предоставляет собственное подходящее описание метода draw ( ), наше приложение будет «просто работать» без необходимости внесения других изменений.
Полиморфизм не только упрощает взаимодействие между программистами, но и позволяет применять и расширять библиотеки, не требуя при этом доступа к их исходному коду. Некоторые разработчики утверждают, что полиморфизм — это величайший вклад объектно-ориентированного программирования в компьютерную науку.
Наследование в сравнении с композицией
Композиция, представляющая альтернативный вид отношений между объектами, зачастую соперничает с наследованием в качестве методики объектно-ориентиро-
ванного дизайна. В композиции один класс (внешний) хранит экземпляр другого класса (внутреннего) в переменной экземпляра. Внешний класс поручает работу внутреннему классу, вызывая методы над этим экземпляром. Вот базовый подход, представленный обобщенным кодом:
// Внутренний класс является аналогом суперкласса в наследовании public class BackEnd {
public function doSomethlng ( ) {
}
}
// Внешний класс является аналогом подкласса в наследовании public class FrontEnd {
// Экземпляр внутреннего класса сохраняется в закрытой переменной
// экземпляра, в данном случае в закрытой пременной be private var be;
// Конструктор создает экземпляр внутреннего класса public function FrontEnd ( ) {
be = new BackEndt );
}
// Этот метод поручает работу методу doSometh1ng( ) класса BackEnd public function doSomethlng ( ) {
be.doSometh1ng( );
} }
Обратите внимание, что класс FrontEnd не расширяет класс BackEnd. Композиция не требует использования собственного особого синтаксиса, как это происходит с наследованием. Более того, внешний класс может использовать подмножество методов внутреннего класса, все методы или добавлять собственные несвязанные методы. Имена методов во внешнем классе могут полностью совпадать с именами методов во внутреннем классе или совершенно отличаться. Внешний класс может ограничивать, расширять или переопределять возможности внутреннего класса, играя такую же роль, как подкласс в наследовании.
Ранее в этой главе было описано, как с помощью наследования класс Square может ограничивать поведение класса Rectangle. В листинге 6.2 показано, как одно и то же отношение между классами может быть реализовано с использованием композиции вместо наследования. В предлагаемом коде класс Rectangle остался неизмененным. Однако на этот раз класс Square не расширяет Rectangle. Вместо этого в классе Square описана переменная г, содержащая экземпляр класса Rectangle. Фильтрация всех операций над экземпляром, хранящимся в переменной г, происходит через public-методы класса Square. Класс Square переадресует, или делегирует, вызовы методов экземпляру, хранящемуся в переменной г. Обратите внимание, что, поскольку метод setsize ( ) класса Square не перекрывает метод setsize ( ) класса Rectangle, сигнатура метода setsize ( ) класса Square не обязана совпадать с сигнатурой метода set Size ( ) класса Rectangle. В методе setsize ( ) класса Square можно определить один-единственный параметр, в отличие от метода setsize ( ) класса Rectangle, в котором определено два параметра.
Листинг 6.2. Пример отношения композиции
// Класс Rectangle
public class Rectangle {
protected var w = 0;
protected var h = 0;
public function Rectangle (width, height) { setS1ze(w1dth, height);
}
public function setsize (newW, newh) {
w = newW;
h = newh;
}
public function getArea ( ) { return w * h;
}
}
// Это новый класс Square
public class Square {
private var r;
public function Square (side) {
r = new Rectangle(s1de, side);
}
public function setsize (side) { r.setS1ze(side, side);
}
public function getArea ( ) { return r.getArea( );
}
}
Отношения «является», «имеет» и «использует». В разговорной речи отношение наследования, присущее объектно-ориентированным языкам программирования, называется отношением «является» (Is-А), поскольку экземпляр подкласса в буквальном смысле можно рассматривать как экземпляр его суперкласса (то есть экземпляр подкласса может быть использован везде, где это допустимо применением экземпляра его суперкласса). В предыдущем примере полиморфизма экземпляр класса Circle «является» экземпляром класса Shape, поскольку класс Circle унаследован от Shape и, следовательно, может использоваться везде, где используется Shape.
Отношение композиции называется отношением «имеет», поскольку внешний класс содержит экземпляр внутреннего класса. Не следует путать отношение «имеет» с отношением «использует», когда некоторый класс создает объект другого класса, но не присваивает созданный объект переменной экземпляра. В отношении «использует» класс использует объект, а затем выбрасывает его. Например, класс Circle мо-
жет хранить числовое значение цвета в переменной color («имеет» объект класса uint), но впоследствии может временно воспользоваться объектом класса Color, чтобы отобразить этот цвет на экране («использует» объект класса Color).
В листинге 6.2 класс Square «имеет» экземпляр класса Rectangle и налагает на него ограничения, которые фактически превращают класс Rectangle в Square. В случае с классами Square и Rectangle отношение «является» выглядит более естественным, однако можно использовать и отношение «имеет». В этой связи возникает вопрос: какое отношение лучше?
Когда использовать композицию вместо наследования. Листинг 6.2 поднимает серьезный вопрос проектирования. Как сделать выбор между композицией и наследованием? Вообще, достаточно легко определить ситуацию, в которой наследование неприменимо. Экземпляр класса Alert Dialog в приложении «имеет» кнопку ОК, но сам экземпляр класса AlertDialog кнопкой ОК не «является». Сложнее определить ситуацию, когда неприменимой оказывается композиция, поскольку наследование, используемое для создания отношения между двумя классами, всегда можно заменить композицией. Если в одной и той же ситуации применимы оба подхода, какой из них окажется лучшим выбором?
Для новичков в объектно-ориентированном программировании будет неожиданностью услышать, что зачастую при выборе стратегии проектирования приложений предпочтение отдают композиции, а не наследованию. На самом деле некоторые известные теоретики в области объектно-ориентированного проектирования недвусмысленно советуют использовать композицию вместо наследования (книга «Design Patterns: Elements of Reusable Object-Oriented Software» издательства Addison-Wesley, авторы Эрих Гамма (Erich Gamma) и др.). Таким образом, здравый смысл подсказывает нам хотя бы рассмотреть возможность применения композиции даже в том случае, когда выбор наследования кажется очевидным. И все-таки, вот несколько общих рекомендаций, которые помогут сделать выбор между наследованием и композицией:
если вы желаете воспользоваться преимуществом полиморфизма, рассмотрите возможность применения наследования;
когда классу необходимы сервисы другого класса, рассмотрите возможность использования отношения композиции;
□ если поведение разрабатываемого вами класса очень похоже на поведение существующего класса, рассмотрите возможность применения отношения наследования.
Дополнительные советы по выбору подхода проектирования между композицией и наследованием можно найти в прекрасной статье Java World Билла Веннера (Bill Venner), которая хранится в архиве на сайте автора: http://www.artima.com/ designtechniques/compoinh.html. Мистер Веннер приводит неоспоримые доказательства, что:
изменение кода, использующего композицию, влечет за собой меньше последствий, чем изменение кода, использующего наследование;
□ код, основанный на наследовании, зачастую выполняется быстрее, чем код, в основе которого лежит композиция.
Отсутствие поддержки абстрактных классов и методов
Во многих объектно-ориентированных проектах программ требуется использовать так называемые абстрактные классы. Абстрактным считается любой класс, в котором определены один или несколько абстрактных методов. Это методы, которые имеют имя, параметры и возвращаемый тип, но не имеют реализации (то есть не имеют тела метода). Класс, желающий расширить абстрактный класс, должен либо реализовать все абстрактные методы суперкласса, либо сам являться абстрактным классом; в противном случае на этапе компиляции произойдет ошибка. Подклассы абстрактного класса фактически обещают предоставить некий существующий код, который выполняет задачу, описанную абстрактным классом только в теории.
Абстрактные классы являются широко распространенной, важной частью проектов, в которых применяется полиморфизм. Например, ранее при обсуждении полиморфизма мы рассмотрели класс Shape и его подклассы Circle, Rectangle и Triangle. В обычной ситуации метод draw ( ) класса Shape был бы объявлен абстрактным методом, гарантируя, что:
каждый подкласс класса Shape предоставляет средства для его отображения на экране;
внешний код может безопасно вызывать метод draw ( ) над любым подклассом класса Shape (поскольку компилятор не позволит классу расширить класс Shape, не реализовав метод draw ( ) ).
К сожалению, язык ActionScript не поддерживает абстрактные классы и абстрактные методы. Объявление абстрактного метода в языке ActionScript заменяется простым описанием метода, который не содержит кода в своем теле, и указанием в документации, что этот метод является абстрактным. Позаботиться о том, чтобы все подклассы предполагаемого абстрактного класса реализовали соответствующие методы, должен программист (а не компилятор).
В большинстве случаев для реализации конкретной объектно-ориентированной архитектуры вместо абстрактных классов могут быть использованы интерфейсы языка ActionScript. О том, что такое интерфейсы, вы прочтете в гл. 9.
Мы рассмотрели понятие наследования. В конце этой главы применим полученные знания к программе по созданию виртуального зоопарка.
Применение наследования в программе по созданию виртуального зоопарка
В нашей программе «Зоопарк» наследование будет добавлено для решения двух различных задач. Во-первых, мы используем его для описания видов пищи, поглощаемой нашими животными, тем самым, заменив предыдущий подход, заключав-
шийся в добавлении определенного количества калорий животному с помощью метода eat ( ). Во-вторых, мы используем наследование, чтобы основной класс нашего приложения VirtualZoo мог отображаться на экране.
Создание видов пищи
До этого момента наша реализация процесса принятия пищи в программе по созданию виртуального зоопарка была чрезмерно упрощена. Чтобы накормить животное, мы просто вызывали метод eat ( ) над желаемым объектом класса Virtual Pet и указывали количество калорий, поглощаемое животным. Для реализма нашей имитации добавим в программу зоопарка виды пшци.
Чтобы не усложнять процесс, мы позволим животному принимать только два вида пищи: суши и яблоки. Суши будут представлены новым классом Sushi, а яблоки — классом Apple. Поскольку оба класса — Sushi и Apple — концептуально представляют пищу, они будут иметь почти одинаковую функциональность. Следовательно, в нашем приложении мы реализуем всю функциональность, необходимую обоим классам Sushi и Apple, в одном суперклассе Food. Классы Sushi и Apple расширят класс Food и через наследование получат доступ к его возможностям.
Класс Food описывает четыре простых метода для получения и изменения имени и значения калорий для заданного продукта. Рассмотрим его код:
package zoo {
public class Food {
private var calories;
private var name;
public function Food (1n111al Calor1es) {
setCalor1es(Initial Calor1es);
}
public function getCalorles ( ) { return calories;
}
public function setCalorles (newCalorles) { calories = newCalorles;
}
public function getName ( ) { return name;
}
public function setName (newName) { name = newName:
}
}
}
Класс Apple задаст количество калорий, используемое но умолчанию, для каждого объекта Apple и определяет название продукта для всех объектов Apple. Рассмотрим его код:
package zoo {
public class Apple extends Food {
// Количество калорий, используемое по умолчанию, для объекта
// Apple равно 100
private static var DEFAULT_CALORIES = 100:
public function Apple (1n1t1alCalor1es = 0) {
// Если для данного конкретного объекта количество калорий не указано
// или если было указано отрицательное число...
1f (1n1t1alCalor1es <= 0) {
// ...использовать значение по умолчанию
1n1t1alCalor1es = Apple.DEFAULT_CALORIES;
}
superdnitialCalories);
// Определить название продукта для всех объектов Apple setName(“Apple");
}
}
}
Класс Sushi задает количество калорий, используемое по умолчанию, для каждого объекта Sushi и определяет название продукта для всех объектов Sushi. Рассмотрим его код:
package zoo {
public class Sushi extends Food {
private static var DEFAULT_CALORIES = 500:
public function Sushi (1n111al Calor1es = 0) {
1f (1n1t1alCalorles <= 0) {
1n1t1alCalor1es = Sushi.DEFAULT_CALORIES;
}
super(1n111al Calor1es):
setNameC'Sushl");
}
Чтобы объекты класса VirtualPet могли есть яблоки и суши, мы должны модифицировать метод eat ( ) класса VirtualPet. Вот как выглядел метод eat ( ) до настоящего времени:
public function eat (numberOfCalorles) {
1f (currentCalorles == 0) {
trace(getName( ) + " 1s dead. You can't feed 1t."); return;
var newCurrentCalories = currentCalories + numberOfCalories;
if (newCurrentCalories > VirtualPet.maxCalories) {
currentCalories = VirtualPet.maxCalories;
} else {
currentCalories = newCurrentCalories;
}
trace(getName( ) + " ate some food. It now has " + currentCalories + " calories remaining.");
}
В новой версии метода eat ( ) мы переименуем параметр number Of Calories в fooditem, введя тем самым логическое соглашение, что аргументом метода eat ( ) должен быть экземпляр любого класса, унаследованного от класса Food (в гл. 8 будет рассмотрено, как обеспечить выполнение этого соглашения с помощью объявления типа?). Внутри метода eat ( ) значение переменной newCurrentCalories будет вычисляться путем сложения значения калорий принимаемого куска пищи (то есть fooditem, get Calories ( ) ) и существующего количества калорий у животного (то есть currentCalories). Наконец, при выводе информации о том, что животное съело пищу, мы воспользуемся методом getName ( ) класса Food, чтобы указать название съеденной пищи. Рассмотрим измененный метод eat ( ): public function eat (fooditem) {
if (currentCalories == 0) {
trace(getName( ) + " is dead. You can't feed it."); return;
}
var newCurrentCalories = currentCalories + fooditem.getCalories( );
if (newCurrentCalories > VirtualPet.maxCalories) { currentCalories = VirtualPet.maxCalories;
} else {
currentCalories = newCurrentCalories;
}
trace(getName( ) + " ate some " + foodltem.getNameC ) + "."
+ " It now has " + currentCalories + " calories remaining.");
}
Теперь попробуем покормить животное в конструкторе класса VirtualZoo. Код будет выглядеть следующим образом:
package zoo {
public class VirtualZoo {
private var pet;
public function VirtualZoo ( ) {
pet = new VirtualPet("Stan");
pet.eat(new Apple( )); // Дать Стэну яблоко
pet.eat(new Sushi( )); // Дать Стэну суши
}
}
В настоящий момент классы Sushi и Apple очень просты, однако они формируют основу для более сложного поведения. Например, сейчас, когда в нашей программе появились виды нищи, мы можем достаточно легко создать животных, которым нравятся только яблоки или которые едят суши только после шести часов вечера. Кроме того, мы можем легко изменить поведение каждого вида пищи. В качестве примера половину всех яблок в случайном порядке сделаем червивыми, при этом животные не должны есть такие яблоки.
Для хранения информации о том, является объект Apple «червивым» или нет, мы добавим новую переменную экземпляра wormlnApple в класс Apple:
private var wormlnApple:
Чтобы выбрать случайное число в диапазоне от 0 до 0,9999..., внутри конструктора класса Apple воспользуемся функцией Math. random ( ). Если число окажется равным или больше 0,5, присвоим переменной wormlnApple значение true, указывающее на то, что данный объект Apple является «червивым». В противном случае переменной wormlnApple будет присвоено значение false, указывающее на то, что данный объект Apple не является «червивым». Вот этот код:
wormlnApple = Math.random( ) >= .5:
Чтобы другие классы имели возможность определить, является ли объект Apple «червивым», опишем новый открытый метод hasWorm ( ), который просто возвращает значение переменной wormlnApple. Рассмотрим его код:
public function hasWorm ( ) {
return wormlnApple:
}
Наконец, чтобы животные не ели червивые яблоки, изменим метод eat ( ) класса VirtualPet. Вот фрагмент кода из метода eat ( ):
1f (fooditem 1s Apple) {
1f (fooditem.hasWorm( )) {
traceCThe " + fooditem.getName( ) + " had a worm. " + getName( )
+ " didn't eat it."):
return:
}
}
В предыдущем коде обратите внимание на использование оператора is, который проверяет, является ли объект экземпляром указанного класса или любого класса, унаследованного от него. Выражение fooditem is Apple возвращает значение true в том случае, когда параметр fooditem ссылается на экземпляр класса Apple (или любого класса, унаследованного от класса Apple). В противном случае возвращается false. Если параметр fooditem представляет объект класса Apple, а метод hasWorm ( ) этого объекта возвращает значение true, метод eat ( ) завершается, при этом значение переменной currentcalories не изменяется.
В программе по созданию виртуального зоопарка помимо создания видов пищи у наследования есть еще одно применение. Познакомимся с ним.
Подготовка класса VirtualZoo для отображения на экране
Поскольку язык ActionScript применяется для создания графического содержимого и пользовательских интерфейсов, основной класс любой программы на языке ActionScript должен расширять либо класс flash. display. Sprite, либо класс flash. display .MovieClip. И Sprite и MovieClip представляют собой контейнеры для графического содержимого, отображаемого на экране.
Класс MovieClip используется в тех случаях, когда основной класс программы связан с FLA-файлом (документ среды разработки Flash) (более подробную информацию можно найти в гл. 29). В остальных случаях используется класс Sprite.
При открытии нового SWF-файла среда выполнения Flash создает экземпляр основного класса этого файла и добавляет созданный экземпляр в иерархический список объектов, которые отображаются в данный момент на экране. Этот список называется списком отображения. Попав в список отображения, экземпляр класса может использовать унаследованные методы класса Displayobject (потомками которого являются классы Sprite и MovieClip) для добавления другого графического содержимого на экран.
Наша программа по созданию виртуального зоопарка в конечном итоге будет отображать графическое содержимое на экране. Однако перед этим придется многое узнать о списке отображения и программировании графики. Все эти темы подробно рассматриваются в части II книги.
Пока же, чтобы запустить нашу программу в ее текущем состоянии, мы должны выполнить требование, заключающееся в том, что основной класс любой программы на языке ActionScript должен расширять либо класс Sprite, либо класс MovieClip.
Наша программа не содержит никаких элементов среды разработки Flash, поэтому основной класс программы VirtualZoo расширяет класс Sprite:
package zoo {
Import flash.display.Sprite:
public class VirtualZoo extends Sprite {
private var pet:
public function VirtualZoo ( ) {
pet = new V1rtuaTPet("Stan"):
pet.eat(new Apple( )):
pet.eat(new Sushi( )):
}
}
}
В этой главе мы внесли много изменений в нашу программу, создающую виртуальный зоопарк. Рассмотрим весь код целиком.
Код программы Virtual Zoo
Листинг 6.3 демонстрирует код класса VirtualZoo — основного класса программы.
Листинг 6.3. Класс VirtualZoo
package zoo {
Import flash.display.Sprite;
public class VirtualZoo extends Sprite { private var pet;
public function VirtualZoo ( ) {
pet = new VirtualPet("Stan");
pet.eat(new Apple( ));
pet.eat(new Sushi( ));
}
}
}
Листинг 6.4 демонстрирует код класса Virtual Pet, экземпляры которого представляют животных в зоопарке.
Листинг 6.4. Класс VirtualPet
package zoo {
Import fl ash.utils.setinterval ;
Import flash.utils.clearinterval;.
Internal class VirtualPet {
private static var maxNameLength = 20;
private static var maxCalorles = 2000;
private static var calorlesPerSecond = 100;
private var petName;
private var currentCalorles = VirtualPet.maxCalor1es/2;
private var digestinterval ID;
public function VirtualPet (name) { setName(name);
digestinterval ID = setinterval(digest, 1000);
}
public function eat (fooditem) {
1f (currentCalorles == 0) { trace(getName( ) + " 1s dead. You can't feed it."); return;
}
1f (fooditem 1s Apple) {
1f (fooditem.hasWorm( )) {
traceCThe " + fooditem.getName( ) + " had a worm.." + getName( )
+ " didn't eat it."); return:
var newCurrentCalorles = currentCalorles + fooditem.getCalor1es( ):
1f (newCurrentCalorles > VirtualPet.maxCalorles) {
currentCalorles = Virtual Pet.maxCalorles:
} else {
currentCalorles = newCurrentCalorles:
}
trace(getName( ) + " ate some " + foodItem.getName( ) + "."
+ " It now has " + currentCalorles + " calories remaining."):
public function getHunger ( ) {
return currentCalorles / Virtual Pet.maxCalorles:
public function setName (newName) {
// Если длина заданного нового имени больше maxNameLength символов...
1f (newName.length > Virtual Pet.maxNameLength) {
// ...обрезать имя
newName = newName.substr(0, VirtualPet.maxNameLength);
} else if (newName == "") {
// ...в противном случае, если заданное новое имя является
// пустой строкой, завершить выполнение метода, не изменяя
// значения переменной petName return:
// Присвоить новое проверенное имя переменной petName petName = newName:
public function getName ( ) { return petName;
private function digest ( ) {
// Если в результате потребления очередной порции калорий
// значение переменной currentCalorles животного
// станет равным 0 или меньше...
1f (currentCalorles - VirtualPet.calorlesPerSecond <= 0) { // ...прекратить вызов метода d1gest( ) clearinterval(digestinterval ID);
// После чего очистить желудок животного
currentCalorles = 0:
// и сообщить о смерти животного trace(getName( ) + " has died."):
} else {
// ...иначе употребить оговоренное количество калорий currentCalorles -= V1rtualPet.calor1esPerSecond;
// и сообщить о новом состоянии животного
trace(getName( ) + " digested some food. It now has " + currentCalorles + " calories remaining.");
}
}
}
}
Листинг 6.5 демонстрирует код класса Food, являющегося суперклассом для различных видов пищи, принимаемой животными.
Листинг 6.5. Класс Food
package zoo {
public class Food {
private var calories;
private var name;
public function Food (1n1t1alCalor1es) {
setCalorles(Initial Calor1es);
}
public function getCalorles ( ) { return calories;
}
public function setCalorles (newCalorles) { calories = newCalorles;
}
public function getName ( ) { return name;
}
public function setName (newName) { name = newName;
}
}
}
Листинг 6.6 демонстрирует код класса Apple, представляющего конкретный вид пищи, принимаемой животными.
Листинг 6.6. Класс Apple
package zoo {
public class Apple extends Food {
private static var DEFAULT_CALORIES = 100;
private var wormlnApple;
public function Apple (1nlt1alCalor1es = 0) {
if (1n1t1alCalor1es <= 0) {
Initial Calories = Apple.DEFAULT_CALORIES:
}
super(1nlt1al Calor1es);
wormlnApple = Math.randomC ) >= .5;
setNameC'Apple");
}
public function hasWorm ( ) {
return wormlnApple;
}
}
}
Наконец, листинг 6.7 демонстрирует код класса Sushi, также представляющего конкретный вид пищи, принимаемой животными.
Листинг 6.7. Класс Sushi
package zoo {
public class Sushi extends Food {
private static var DEFAULT_CALORIES = 500;
public function Sushi (1n1t1alCalor1es = 0) {
1f (1n1t1alCalor1es <= 0) {
1n1t1alCalor1es = Sushi.DEFAULT_CALORIES;
}
super(1n111al Calor1es):
setNameCSushl");
}
Первый запуск!
Благодаря изменениям, внесенным в программу по созданию виртуального зоопарка в этой главе, наше приложение теперь готово к компиляции и выполнению. Надеюсь, что вы испытываете нескрываемое волнение в преддверии изучения следующей главы. Из нее вы узнаете, как запустить программу после того, как она будет скомпилирована с помощью среды разработки Flash, приложения Flex Builder или компилятора mxmlc.
Компиляция и выполнение программы
После напряженной работы над программой по созданию виртуального зоопарка мы готовы скомпилировать и выполнить наш код. В этой главе врассказывается, как скомпилировать программу с помощью среды разработки Flash, приложения Flex Builder и компилятора mxmlc. В каждом случае мы исходим из того, что компилируемая программа находится в папке /virtualzoo, а исходный код программы (то есть AS-файлы) размещается в папке /virtualzoo/src.
Приступим же к компиляции!
Компиляция с помощью среды разработки Flash
Для компиляции программы «Зоопарк» с помощью среды разработки Flash мы должны сначала связать основной класс программы с FLA-файлом, используя описанную последовательность действий.
В среде разработки Flash выберите команду меню File ► New (Файл ► Создать).
В появившемся окне New Document (Новый документ) выберите в списке пункт Flash File (ActionScript 3.0) и нажмите кнопку ОК.
Выберите команду меню File ► Save As (Файл ► Сохранить как).
В открывшемся окне Save as (Сохранить как) найдите папку /virtualzoo/src.
В поле File name (Имя файла) диалогового окна Save as (Сохранить как) введите Virtualzoo.fla и нажмите кнопку ОК.
На панели Properties (Свойства) в поле Document class (Класс документа) введите zoo.Virtualzoo.
Теперь, когда основной класс программы связан с FLA-файлом (как описано в предыдущих шагах), можно выбрать команду меню Control ► Test Movie (Управление ► Проверка фильма), чтобы скомпилировать программу и запустить полученный SWF-файл в отладочной версии приложения Flash Player непосредственно в среде разработки Flash. Когда программа выполняется в режиме Test Movie (Проверка фильма), сообщения, генерируемые функцией trace ( ), отображаются в окне Output (Вывод) среды разработки Flash.
Когда программа компилируется с помощью команды Test Movie (Проверка фильма), среда разработки Flash генерирует SWF-файл, имя которого совпадает с именем соответствующего FLA-файла. Например, если мы компилируем программу «Зоопарк» с помощью команды Test Movie (Проверка фильма), в папке /src по-
явится новый файл VirtualZoo . swf. Найти информацию о том, как изменить папку, в которую помещается сгенерированный SWF-файл, можно в разделе документации по среде разработки Flash, посвященном команде File ► Publish Settings (Файл ► Настройки публикации).
Если бы нам потребовалось опубликовать файл VirtualZoo. swf в Интернете, мы бы добавили его в HTML-страницу. Дополнительную информацию можно получить в разделе документации по среде Flash, посвященном команде File ► Publish (Файл ► Опубликовать). Для распространения файла VirtualZoo. swf в качестве настольного приложения нам потребуется включить его в инсталлируемый AIR- файл. Подробную информацию можно найти в документации по среде выполнения Adobe AIR.
Компиляция с помощью приложения
Flex Builder
Перед тем как скомпилировать программу по созданию виртуального зоопарка, используя приложение Flex Builder, мы должны внести некоторые изменения в наш код, чтобы выполнить требования, предъявляемые компилятором этого приложения. Компилятор приложения Flex Builder требует, чтобы основной класс программы принадлежал безымянному пакету. На данный момент пакет, которому принадлежит наш класс VirtualZoo, называется zoo.
Перемещение основного класса в безымянный пакет
Чтобы переместить класс VirtualZoo из zoo в безымянный пакет, мы должны выполнить такую последовательность действий.
* Сначала переместить файл VirtualZoo . as из папки /virtualzoo/src/zoo в папку /virtualzoo/src.
В файле VirtualZoo . as добавить следующий код прямо перед описанием класса VirtualZoo (этот код импортирует классы из пакета zoo):
Import zoo.*;
В файле VirtualZoo . as удалить имя пакета "zoo" из объявления пакета, то есть изменить этот код:
package zoo {
на следующий:.
package {
В файле VirtualPet. as изменить модификатор управления доступом для класса VirtualPet с internal на public, как показано ниже (это позволит классу VirtualZoo обращаться к классу VirtualPet):
public class VirtualPet {
После того как все описанные изменения будут внесены, мы сможем откомпилировать программу.
Компиляция программы
Чтобы откомпилировать программу по созданию виртуального зоопарка, мы сначала создадим новый проект ActionScript, как описано далее.
Выберите команду меню File ► New ► ActionScript Project (Файл ► Создать ► Проект ActionScript).
В появившемся окне New ActionScript Project (Новый проект ActionScript) в поле Project name (Название проекта) введите virtual zoo.
В области Project contents (Содержание проекта) снимите флажок Use default location (Использовать местоположение по умолчанию).
В поле Folder (Папка) области Project contents (Содержание проекта) укажите (или найдите с помощью кнопки Browse (Обзор)) местоположение папки virtualzoo на жестком диске вашего компьютера.
Нажмите кнопку Next (Далее).
В поле Main source folder (Основная папка с исходными файлами) введите sr с.
В поле Main application file (Основной файл приложения) введите название Virtualzoo. as.
Нажмите кнопку Finish (Готово).
Выполнение программы
Теперь, когда проект ActionScript создан, мы можем выполнить следующие шаги, чтобы запустить программу, имитирующую виртуальный зоопарк, в режиме отладки, при котором все сообщения, генерируемые функцией trace ( ), будут отображаться в окне Console (Консоль).
В окне Navigator (Навигация) выделите любой класс, принадлежащий проекту виртуального зоопарка.
Выберите команду меню Run ► Debug VirtualZoo (Выполнить ► Отладка Virtual Zoo). Если стандартные настройки не изменялись, программа запустится в браузере, используемом по умолчанию.
При компиляции приложение Flex Builder генерирует следующие файлы, которые размещаются в автоматически создаваемой папке /virtualzoo/bin.
SWF-файл Virtualzoo. swf.
SWF-файл VirtualZoo-debug. swf, используемый для отладки.
HTML-файл Virtualzoo . html, который внедряет файл Virtualzoo. swf для публикации в Интернете.
HTML-файл с именем VirtualZoo-debug.html, который внедряет файл VirtualZoo-debug. swf для отладки программы в браузере.
Несколько вспомогательных файлов, позволяющих из браузера определить наличие приложения Flash Player на компьютере пользователя и при необходимости установить его автоматически.
Чтобы опубликовать файл Virtualzoo. swf в Интернете, просто поместите все файлы из папки /bin — кроме VirtualZoo-debug.html и VirtualZoo-debug. swf —
в папку на общедоступном веб-сервере. Для распространения файла Virtual Zoo. swf в качестве настольного приложения обратитесь к документации по среде выполнения Adobe AIR.
Компиляция с помощью компилятора mxmlc
Как и компилятор приложения Flex Builder, mxmlc требует, чтобы основной класс программы принадлежал безымянному пакету. Таким образом, перед компиляцией программы по созданию виртуального зоопарка с помощью mxmlc мы должны переместить класс Virtual Zoo из пакета zoo в безымянный пакет, выполнив шаги из подразд. «Перемещение основного класса в безымянный пакет» предыдущего раздела.
После этого мы должны найти сам компилятор, имеющий имя mxmlc. ехе. Местоположение компилятора зависит от его версии и операционной системы. Обычно он находится в папке Flex SDK [версия]\Ып, однако вы должны самостоятельно определить его местоположение на своем компьютере, руководствуясь документацией по инструментарию Flex SDK. Для данного примера предположим, что мы компилируем программу в операционной системе Windows ХР и что компилятор находится по адресу С: \Flex SDK 2\bin\mxmlc.ехе.
Предположим также, что папка нашей программы /virtualzoo находится по адресу С:\data\virtualzoo\.
При компиляции программы «Зоопарк» с помощью компилятора mxmlc выполняется такая последовательность действий.
Используя меню Пуск операционной системы Windows, откройте окно командной строки, выбрав команду Пуск ► Все программы ► Стандартные ► Командная строка.
В окне командной строки перейдите к папке С: \Flex SDK 2 \Ып\, введя следующую команду:
cd C:\Flex SDK 2\bin
Далее в окне командной строки введите следующую команду и нажмите клавишу Enter:
mxmlc C:\data\virtualzoo\srcWi rtualZoo.as
В результате выполнения описанных шагов компилятор mxmlc откомпилирует программу и сгенерирует SWF-файл с именем Virtualzoo. swf, который будет помещен в папку virtualzoo\src. Стоит отметить, что компилятор mxmlc имеет множество параметров компиляции; подробную информацию можно получить в документации по инструментарию Flex SDK.
Чтобы запустить файл Virtualzoo . swf, сгенерированный компилятором mxmlc, просто откройте его в отдельной версии приложения Flash Player или в браузере, в котором установлено это приложение. Для просмотра сообщений программы, генерируемых функцией trace ( ), используйте отладочную версию приложения Flash Player (поставляемую в составе инструментария Flex SDK) и сконфигурируйте ее для вывода таких сообщений в файл журнала. Дополнительную информацию можно получить по адресу http://livedocs.adobe.com/flex/201/html/logging_125_07.html.
В результате компиляции программы, следуя описанным в этом разделе шагам, вы увидите ряд предупреждений компилятора наподобие var 'pet' has no type declaration (переменная 'var* не имеет объявления типа). Пока вы можете просто проигнорировать эти предупреждения. В следующей главе будет описано, почему они возникают.
Ограничения компиляторов
Компилируя программы, написанные на языке ActionScript, с помощью среды разработки Flash, приложения Flex Builder или компилятора mxmlc, нужно принимать во внимание следующие ограничения компиляторов.
Основной класс программы должен быть открытым.
Для приложения Flex Builder и компилятора mxmlc основной класс программы должен находиться в безымянном пакете.
Основной класс программы должен расширять либо класс Sprite, либо класс MovieClip, как было рассмотрено в гл. 6.
Любой файл с исходным кодом ActionScript (AS-файл) должен иметь только одно определение, видимое извне. Таким определением могут являться класс, переменная, функция, интерфейс или пространство имен, описанные с помощью модификатора управления доступом internal или public внутри тела пакета.
Название файла с исходным кодом ActionScript должно совпадать с именем единственного определения, видимого извне, которое находится в этом файле.
Например, следующий файл с исходным кодом будет считаться недопустимым, поскольку он содержит два класса, видимых извне:
package {
public class А {■
}
public class В {
}
}
Подобным образом следующий файл с исходным кодом будет считаться недопустимым, поскольку он не содержит ни одного определения, видимого извне.
class С {
}
Процесс компиляции и путь к классам
Когда экспортируется SWF-файл, компилятор языка ActionScript создает список всех классов, которые необходимы данному файлу. В частности, в список требуемых классов включаются следующие.
т
Все классы, явно или неявно связанные с основным классом программы.
Для среды разработки Flash все классы, явно или неявно связанные с исходным FLA-файлом экспортируемого SWF-файла (то есть со сценариями кадров).
Компилятор ищет все AS-файлы с исходным кодом, соответствующие связанным классам, и компилирует каждый исходный файл в формат байт-кода, после чего помещает этот двоичный код в SWF-файл. Набор папок, в которых компилятор осуществляет поиск AS-файлов, называется путем к классам.
Файлы классов, не требующиеся для данного SWF-файла, но хранящиеся в файловой системе, не будут компилироваться в SWF-файл, однако если не будет найден файл требуемого класса, возникнет ошибка на этапе компиляции.
Любая среда разработки на языке ActionScript автоматически включает в путь к классам несколько папок, а также позволяет пользователю самостоятельно указывать папки, которые должны быть включены в этот путь. Например, среда разработки Flash автоматически включает в путь к классам папку, содержащую исходный FLA-файл для данного SWF-файла. Подобным образом приложение Flex Builder и компилятор mxmlc автоматически включают в путь к классам папку, содержащую основной класс программы. Инструкции по включению дополнительных папок в путь к классам можно найти в соответствующей документации по продукту.
Путь к классам иногда называют путем сборки или исходным путем.
Строгий режим компиляции в сравнении со стандартным режимом
Для компиляции программы, написанной на языке ActionScript, можно использовать два различных режима: строгий и стандартный.
В строгом режиме компилятор сообщает о большем количестве ошибок по сравнению со стандартным режимом. Дополнительные ошибки, появляющиеся при компиляции программы в строгом режиме, призваны помочь программистам выявить потенциальные источники проблем еще до того, как будет запущена программа. По этой причине во всех компиляторах компании Adobe строгий режим включен по умолчанию. Программисты, которые желают использовать динамические возможности языка ActionScript (рассматриваемые в гл. 15) или просто предпочитают решать проблемы (то есть отлаживать программу) на этапе выполнения, а не на этапе компиляции программы, могут выполнять компиляцию в стандартном режиме.
Следующие непроверенные моменты при программировании приведут к ошибкам на этапе компиляции только в том случае, если используется строгий режим; в стандартном режиме эти ошибки не возникнут.
Передача в функцию неправильного количества параметров или параметров неверных типов (дополнительную информацию можно найти в гл. 8).
Определение двух переменных или методов с одинаковым именем.
Обращение к методам и переменным, не определенным на этапе компиляции (но которые могут быть определены на этапе выполнения с помощью методик, описанных в гл. 15).
Присваивание значения несуществующей переменной экземпляра объекта, чей класс не является динамическим.
Присваивание значения константной переменной за пределами инициализатора переменной или, в случае переменной экземпляра, за пределами метода-конструктора класса, содержащего определение данной переменной.
Попытка удалить (с помощью оператора delete) метод экземпляра, переменную экземпляра, статический метод или статическую переменную.
Сравнение двух выражений с несовместимыми типами (дополнительную информацию можно найти в разд. «Типы данных и аннотации типов» гл. 8).
Присваивание значения переменной с объявленным типом, когда присваиваемое значение не является членом указанного типа (исключения из этого правила можно найти в разд. «Три особых случая строгого режима» гл. 8).
Обращение к несуществующим пакетам.
Включение стандартного режима компиляции
в приложении Flex Builder
Выполните следующие шаги, чтобы включить стандартный режим компиляции для проекта в приложении Flex Builder.
В окне Navigator (Навигация) выделите папку проекта.
Выберите команду меню Project ► Properties (Проект ► Свойства).
На странице ActionScript Compiler (Компилятор ActionScript) снимите флажок Enable strict type checking (Включить строгую проверку типов).
Включение стандартного режима компиляции в среде разработки Flash
Выполните следующие действия, чтобы включить стандартный режим компиляции для документа в среде разработки Flash.
Выберите команду меню File ► Publish Settings (Файл ► Настройки публикации).
На вкладке Flash появившегося окна Publish Settings (Настройки публикации) нажмите кнопку Settings (Параметры).
В области Errors (Ошибки) появившегося окна ActionScript 3.0 Settings (Параметры ActionScript 3.0) снимите флажок Strict Mode (Строгий режим).
Чтобы включить стандартный режим компиляции для компилятора mxmlc, присвойте параметру компилятора strict значение false.
Далее: типы данных
Мы сумели откомпилировать и запустить нашу программу по созданию виртуального зоопарка, однако разработка программы еще далека от завершения. Чтобы сделать зоопарк полностью интерактивным, добавить в него графику и кнопки для кормления животных, мы должны продолжить наше изучение основ языка ActionScript. В следующей главе будет рассказано, как система проверки типов языка ActionScript помогает выявить распространенные ошибки в программе.
Типы данных и проверка типов
До сих пор мы разрабатывали наш виртуальный зоопарк, не допустив ни одной ошибки кодирования. Разработка без ошибок происходит в обучающих курсах и книгах — и больше нигде. При разработке реальных программ программисты всегда допускают ошибки. Например, при вызове метода eat ( ) над объектом Virtual Pet программист может допустить опечатку, как показано в следующем фрагменте кода (обратите внимание на лишнюю букву «t»):
pet.eatt(new Sushi( ))
Или же программист может сделать неправильное предположение о возможностях объекта. Например, он может по ошибке попытаться вызвать метод j ump ( ) над объектом VirtualPet, хотя в классе VirtualPet такой метод не определен: pet.jump( )
В обоих предыдущих случаях, если программа выполняется в отладочной версии среды выполнения Flash, произойдет ошибка обращения — она означает, что программа попыталась обратиться к несуществующей переменной или методу.
Ошибки, происходящие на этапе выполнения программы, называются исключениями. С исключениями и способами их обработки вы познакомитесь в гл. 13.
Когда ошибка возникает в разрабатываемой вами программе, вы должны быть счастливы. Ошибки указывают на точное место и причину какой-либо проблемы в вашей программе, которая в дальнейшем, скорее всего, приведет к сбою, если не будет вовремя исправлена. Например, в ответ на предыдущую опечатку eatt ( ) отладочная версия среды выполнения Flash отобразит на экране предупреждающее сообщение следующего содержания:
ReferenceError: Error #1069: Property eatt not found on zoo.Virtual Pet and there 1s no default value.
at V1rtualZoo$11n1t( )[C:\data\v1rtualzoo\src\V1rtualZoo.as:8]
Это можно перевести следующим образом: Ошибка обращения: Ошибка #1069: Свойство eatt не найдено в объекте zoo.VirtualPet, и не указано значение по умолчанию.
Обратите внимание, что в сообщении об ошибке для обозначения переменной или метода используется термин «свойство», рассмотренный в разд. «Члены и свойства» гл. 1.
Сообщение об ошибке указывает не только на имя файла, в котором возникла данная ошибка, но и на определенную строку кода, содержащую ошибку. Эта информация очень полезна.
Какими бы полезными ни были ошибки, происходящие на этапе выполнения, они обладают потенциальным недостатком. Данные ошибки возникают только
в тот момент, когда выполняется ошибочная строка кода. Таким образом, в очень большой программе до момента возникновения подобной ошибки может пройти слишком много времени. Например, если прохождение сюжетной компьютерной игры занимает 10 часов, то до появления ошибки, допущенной на последнем уровне, пройдет 10 часов!
К счастью, вместо того, чтобы ожидать возникновения ошибок обращения на этапе выполнения, мы можем поручить компилятору сообщать о таких ошибках на этапе компиляции еще до того, как будет запущена программа. Для этого используются аннотации типов в сочетании со строгим режимом компиляции.
Типы данных и аннотации типов
В языке ActionScript термин «тип данных» означает просто «набор значений». Язык ActionScript определяет три фундаментальных типа данных: Null, void и Object. Каждый из типов данных Null и void включает по одному значению — null и undefined соответственно (значения null и undefined рассматриваются далее в разд. «Значения null и undefined»). Тип данных Obj ect включает все экземпляры всех классов.
Кроме трех фундаментальных типов данных (Null, void и Object), любой внутренний или пользовательский класс формирует уникальный тип данных, набором значений которого являются непосредственные экземпляры данного класса и экземпляры его классов-потомков. Например, класс Food из нашей программы по созданию виртуального зоопарка формирует тип данных, набором значений которого являются все экземпляры класса Food и все экземпляры классов Apple и Sushi (поскольку оба класса Apple и Sushi унаследованы от класса Food). Таким образом, говорят, что экземпляры классов Apple и Sushi принадлежат типу данных Food.
Однако каждый из классов Apple и Sushi также формирует собственный тип данных. Например, набором значений типа данных Apple являются все экземпляры класса Apple и все экземпляры любого класса, унаследованного от него. Подобным образом набором значений типа данных Sushi являются все экземпляры класса Sushi и все экземпляры любого класса, унаследованного от него. По этой причине помимо того, что экземпляр класса Apple принадлежит типу данных Food, он также принадлежит типу данных Apple. Однако экземпляр класса Apple не принадлежит типу данных Sushi, поскольку класс Sushi не унаследован от Apple. Точно так же экземпляр класса Sushi принадлежит типам данных Food и Sushi, но не принадлежит типу данных Apple, поскольку класс Sushi не унаследован от Apple. Наконец, несмотря на то, что экземпляры обоих классов принадлежат типу данных Food, экземпляр класса Food не принадлежит ни одному из типов данных Apple или Sushi, поскольку класс Food не унаследован от классов Apple или Sushi.
Обратите внимание на важное различие между отдельно взятым классом и типом данных, представляемым этим классом. Набором значений, принадлежащим данному классу, являются только экземпляры этого класса. Однако набором значений, принадлежащим типу данных этого класса, являются экземпляры данного класса и экземпляры его классов-потомков.
Подобно тому как каждый класс формирует тип данных, каждый интерфейс также формирует тип данных. Набором значений типа данных интерфейса являются все экземпляры любого класса, реализующего этот интерфейс, а также все экземпляры любого класса, унаследованного от класса, реализующего данный интерфейс. Мы еще не рассматривали интерфейсы, поэтому отложим разговор об их использовании в качестве типа данных до гл. 9.
Если у нас есть два типа данных — А и В, причем класс (или интерфейс), представленный типом данных В, унаследован от класса (или интерфейса), представленного типом данных А, то А называется супертипом для В. И наоборот, тип данных В называется подтипом А. Например, тип данных Food является супертипом для Apple, в то время как Apple является подтипом Food.
Совместимые типы
Поскольку любой отдельно взятый класс через наследование может использовать все незакрытые члены экземпляра своего суперкласса (или суперинтерфейса), любой отдельно взятый подтип считается совместимым с любым из своих супертипов. Например, тип данных Apple считается совместимым с типом данных Food, поскольку он является его подтипом.
Обратное, однако, неверно. Класс не может использовать никакие члены экземпляра, определенные в его классах-потомках. Таким образом, любой отдельно взятый супертип считается несовместимым с любым из своих подтипов. Например, тип данных Food считается несовместимым с типом данных Apple, поскольку Food не является подтипом Apple.
Подтип считается совместимым с супертипом, поскольку программа может рассматривать экземпляр подтипа как экземпляр супертипа. Например, программа может рассматривать любой экземпляр типа данных Apple как экземпляр типа данных Food — возможно, вызывая метод getCalories ( ) класса Food над данным экземпляром.
// Создаем новый экземпляр класса Apple var apple = new Apple( );
// Допустимо вызвать метод getCalor1es( ) над экземпляром класса Apple apple.getCalor1es( );
Для сравнения отметим, что супертип считается несовместимым с подтипом, поскольку программа не может рассматривать экземпляр супертипа как экземпляр подтипа. Например, программа не может вызвать метод hasWorm ( ) классаАрр1е над экземпляром типа данных Food:
И Создаем новый экземпляр класса Food var food = new Food(200);
// Следующая строка приведет к возникновению ошибки обращения, // поскольку класс Food не имеет доступа к методу hasWorm( ) food.hasWorm( ): // Ошибка!
Выявление ошибок несоответствия типов с помощью аннотаций типов
Аннотация типа (или объявление типа?) — это суффикс, определяющий тип данных для переменной, параметра или возвращаемого функцией значения. Общим синтаксисом для аннотации типа является двоеточие (:), за которым указывается тип данных, как показано в следующем примере:
: тип
Например, определение переменной с использованием аннотации типа имеет следующий обобщенный вид:
var идентификатор;тип = значение;
В предыдущем коде тип должен быть именем класса или интерфейса (представляющего тип данных) либо специальным символом * (обозначающим «нетипи- зированные» данные).
Определение функции или метода с использованием аннотации типа параметра и возвращаемого значения имеет следующий обобщенный вид:
function идентификатор (параметр; типПараметра) -.типВозвращаемогоЗначения { }
В предыдущем коде аннотация типа параметра задается с помощью указания типа типПараметра, перед которым ставится двоеточие (:); аннотация типа возвращаемого значения задается указанием типа типВозвращаемогоЗначения, перед которым также ставится двоеточие (:). Тип типПараметра должен быть одним из следующих:
имя класса или интерфейса (представляющего тип данных);
специальный символ * (обозначающий «нетипизированные» данные).
Тип типВозвращаемогоЗначения должен быть одним из следующих:
имя класса или интерфейса (представляющего тип данных);
специальный символ * (обозначающий «нетипизированные» данные);
специальная, «не возвращающая значение», аннотация типа void (которая обозначает, что функция не имеет возвращаемого значения).
Программисты на языке ActionScript 2.0 должны обратить внимание, что в языке
ActionScript 3.0 ключевое слово Void больше не записывается с прописной буквы.
Аннотация типа для переменной, параметра или результата функции ограничивает значение этой переменной, параметра или результата указанным типом. Способ ограничения значения зависит от используемого режима компиляции кода (как уже было сказано, в компиляторах компании Adobe по умолчанию выбран строгий режим компиляции).
В независимости от используемого режима компиляции — стандартного или строгого, — если значение принадлежит указанному типу данных, попытка присвоить или вернуть значение окажется успешной.
Если значение не принадлежит указанному типу данных, то при использовании строгого режима компилятор сгенерирует ошибку (называемую ошибкой несоответствия типов) и прекратит компиляцию кода. При использовании стандартного режима код будет скомпилирован и среда Flash попытается преобразовать значение в указанный тип данных на этапе выполнения программы. Если указанным типом данных является один из внутренних классов String, Boolean, Number, int или uin t (называемых примитивными типами), преобразование будет выполнено в соответствии с правилами, описанными в разд. «Преобразование в примитивные типы» этой главы. В противном случае преобразование завершится неудачей и среда Flash сгенерирует ошибку несоответствия типов на этапе выполнения программы. На формальном языке автоматическое преобразование значения на этапе выполнения программы называется приведением.
Например, следующий код определяет переменную meal типа Food и присваивает этой переменной экземпляр класса Apple:
var meal:Food = new Apple( ):
Указанный код скомпилируется успешно как в строгом режиме компиляции, так и в стандартном режиме, поскольку класс Apple расширяет Food. В итоге экземпляры класса Apple принадлежат типу данных Food.
В отличие от этого следующий код присваивает переменной meal экземпляр класса VirtualPet:
var meal:Food = new V1rtualPet("Lucky"):
При использовании строгого режима компиляции указанный код приведет к ошибке несоответствия типов, поскольку экземпляры класса VirtualPet не принадлежат типу данных Food. По этой причине компиляция кода прекратится.
При использовании стандартного режима указанный код будет успешно откомпилирован. Тем не менее, поскольку значение (экземпляр класса VirtualPet) не принадлежит типу данных переменной (Food), среда выполнения Flash попытается привести (то есть преобразовать) значение к типу данных переменной на этапе выполнения программы. В данном случае тип данных переменной не является одним из примитивных типов, поэтому преобразование завершится неудачей и среда Flash сгенерирует ошибку несоответствия типов на этапе выполнения программы.
Рассмотрим другой пример. Следующий код определяет переменную pet Hunger типа int и присваивает этой переменной экземпляр класса VirtualPet:
var pet:Virtual Pet = new V1rtualPet("Lucky"): var petHunger:1nt = pet;
При компиляции указанного кода с использованием строгого режима произойдет ошибка несоответствия типов, поскольку экземпляры класса VirtualPet не принадлежат типу данных int. По этой причине компиляция кода прекратится.
При использовании стандартного режима указанный код будет скомпилирован успешно. Тем не менее, поскольку значение (экземпляр класса VirtualPet) не принадлежит типу данных переменной (int), среда Flash попытается преобразовать значение в тип данных переменной на этапе выполнения программы. В данном слу-
чае тип данных переменной является одним из примитивных типов, поэтому преобразование будет выполнено в соответствии с правилами, описанными в разд. «Преобразование к примитивным типам» этой главы. Таким образом, после выполнения указанного кода значением переменной petHunger будет являться 0.
Разумеется, предыдущий код наверняка разрабатывался не для того, чтобы переменной petHunger присвоить значение 0. Скорее программист просто забыл вызвать метод getHunger ( ) над экземпляром класса VirtualPet, как показано в следующем коде:
var pet-.Virtual Pet = new Virtual Pet("Lucky");
var petHunger:1 nt = pet.getHunger( ):
В строгом режиме компилятор честно предупредит нас о проблеме, а в стандартном режиме — нет, предположив, что, поскольку типом данных переменной petHunger является int, мы хотим преобразовать объект VirtualPet в тип int. В нашем случае это предположение оказалось неверным, в результате чего программа получила неожидаемое значение.
Некоторые программисты считают снисходительность стандартного режима удобной возможностью, особенно в простых приложениях. Однако в более сложных программах из-за гибкости стандартного режима предполагаемые ошибки зачастую скрываются, что в конечном итоге приводит к появлению труднораспознаваемых ошибок.
В оставшейся части книги мы будем полагать, что весь код компилируется в строгом режиме и для всех переменных, параметров и возвращаемых значений указываются аннотации типа.
Нетипизированные переменные, параметры, возвращаемые значения и выражения
Переменная или параметр, чье определение включает аннотацию типа, называются типизированной переменной или типизированным параметром. Подобным образом определение функции, которое включает аннотацию типа возвращаемого значения, называется определением, имеющим типизированное возвращаемое значение. Кроме того, выражение, которое обращается к типизированной переменной или типизированному параметру либо вызывает функцию с типизированным возвращаемым значением, называется типизированным выражением.
Напротив, переменная или параметр, чье определение не включает аннотацию типа, называется нетипизированной переменной или нетипизированным параметром. Подобным образом определение функции, которое не включает аннотацию типа возвращаемого значения, называется определением, имеющим нетипизированное возвращаемое значение. Кроме того, выражение, которое обращается к нетипизированной переменной или нетипизированному параметру либо вызывает функцию с нетипизированным возвращаемым значением, называется нетипизированным выражением.
Нетипизированные переменные, параметры и возвращаемые значения не ограничены определенным типом данных (в отличие от типизированных переменных, параметров и возвращаемых значений). Например, нетипизированной переменной можно присвоить значение типа Boolean в одной строке кода, а в следующей строке присвоить этой же переменной объект VirtualPet без каких-либо ошибок: var stuff = true: stuff = new VlrtualPetCEdwin"); // Ошибки нет
Компилятор языка ActionScript не генерирует ошибки несоответствия типов для нетипи- зированных переменных, параметров и возвращаемых значений.
Если программист хочет явно указать, что переменная, параметр или возвращаемое значение намеренно являются нетипизированными, он может использовать специальную аннотацию типа : *. Например, следующий код определяет явно не- типизированную переменную totalcost:
var totalCost:* = 9.99:
Следующий код определяет ту же переменную, но на этот раз она является нетипизированной неявно*.
var total Cost = 9.99:*
Неявно нетипизированные переменные, параметры и возвращаемые значения обычно используются в тех случаях, когда в программе вообще не применяются аннотации типов, что дает программисту возможность обрабатывать любые типы ошибок на этапе выполнения. Явно нетипизированные переменные, параметры и возвращаемые значения обычно используются в тех случаях, когда программист желает явно указать место в программе, компилируемой в строгом режиме, где допустимо применение нескольких типов данных. Аннотация типа : * позволяет предотвратить появление предупреждения об «отсутствующей аннотации типа» для нетипизированной переменной. Более подробно этот вопрос будет рассмотрен в разд. «Предупреждения об отсутствующих аннотациях типов».
Три особых случая строгого режима
Существует три ситуации, в которых компилятор игнорирует ошибки несоответствия типов при компиляции программы в строгом режиме, не позволяя выявить возможные ошибки до этапа выполнения:
когда нетипизированное выражение присваивается типизированной переменной или параметру либо возвращается из функции с объявленным типом возвращаемого значения;
если любое выражение присваивается типизированной переменной или парамет- • ру, чьим объявленным типом является Boolean, либо возвращается из функции, объявленным типом возвращаемого значения которой является Boolean;
когда любое числовое значение используется там, где должен быть указан экземпляр другого числового типа.
Рассмотрим каждый из описанных случаев на примере. Сначала создадим нети- пизированную переменную pet и присвоим ее значение типизированной переменной d:
var pet:* = new V1rtualPet("Franc1s");
pet = new Date( ): var d:Date = pet:
Поскольку переменная pet может содержать значение любого типа, в третьей строке компилятор не сможет определить, принадлежит ли значение переменной pet типу данных Date. Чтобы определить это, код должен быть не только откомпилирован, но и выполнен. Во время исполнения кода среда Flash сможет узнать результат попытки присваивания. В случае с предыдущим кодом значение, хранящееся в переменной pet (присвоенное во второй строке), на самом деле принадлежит типу данных Date (даже несмотря на то, что изначально значение переменной pet, присвоенное в первой строке кода, было несовместимо с типом данных Date). Таким образом, операция присваивания будет выполнена без ошибок.
Теперь рассмотрим следующий код, в котором определяется переменная b типа Boolean и этой переменной присваивается целочисленное значение 5:
var b:Boolean = 5;
Даже несмотря на то, что значение 5 не принадлежит типу данных Boolean, компилятор не генерирует ошибку несоответствия типов. Вместо этого он делает предположение, что программист желает привести значение 5 к типу данных Boolean (в соответствии с правилами, описанными в разд. «Преобразование в примитивные типы») и генерирует соответствующее предупреждение. Такая «мягкость» компилятора позволяет сократить количество кода в программе. Например, предположим, что в качестве типа возвращаемого значения метода getHunger ( ) класса VirtualPet указан тип данных Number. Программа может создать переменную, содержащую информацию о том, является животное живым или мертвым, используя следующий код:
var IsAlive:Boolean = somePet.getHunger( ):
В соответствии с правилами, описанными в разд. «Преобразование в примитивные типы», число 0 преобразуется в значение false, а остальные числа — в значение true. Таким образом, если метод getHunger ( ) возвращает любое значение, отличное от 0, переменной is Alive присваивается значение true; в противном случае переменной is Alive присваивается значение false (животное оказывается мертвым, когда у него не остается калорий).
Для сравнения приведем альтернативный, чуть более длинный код, который пришлось бы использовать в том случае, если бы компилятор проверял типы для переменных типа Boolean (не позволяя преобразовывать их на этапе выполнения программы):•
var IsAHve:Boolean = somePet.getHunger( ) > 0;
Наконец, рассмотрим код, в котором определяется переменная xCoordinate типа int и этой переменной присваивается значение 4,6459 типа Number:
var xCoordinate:1 nt = 4.6459:
Даже несмотря на то, что значение 4, 64 5 9 не принадлежит типу данных int, компилятор не генерирует ошибку несоответствия типов. Вместо этого он делает предположение, что вы желаете преобразовать значение 4, 6 4 5 9 к типу данных int (в соответствии с правилами, описанными в разд. «Преобразование в примитивные типы»). Это позволяет максимально упростить взаимодействие между числовыми типами данных языка ActionScript.
Предупреждения об отсутствующих аннотациях типов
Как известно из предыдущих разделов, строгий режим компиляции языка ActionScript предоставляет чрезвычайно полезную возможность выявления ошибок программы на самых ранних стадиях.
Неудивительно, что в своем стремлении создавать безошибочный код многие программисты очень полагаются на проверку типов, выполняемую в строгом режиме на этапе компиляции. Однако, как известно из разд. «Нетипизированные переменные, параметры, возвращаемые значения и выражения», ошибки несоответствия типов, выявляемые при использовании строгого режима компиляции, генерируются только для типизированных переменных, параметров и возвращаемых значений. Всякий раз, когда программист случайно пропускает аннотацию типа, он теряет преимущество проверки типов, выполняемой в строгом режиме на этапе компиляции.
К счастью, компиляторы языка ActionScript компании Adobe предлагают режим предупреждений, при использовании которого на этапе компиляции сообщается обо всех отсутствующих аннотациях типов. Разработчики могут использовать эти предупреждения для поиска случайно пропущенных аннотаций типов. В приложении Flex Builder и компиляторе mxmlc предупреждения об отсутствующих аннотациях типов включены по умолчанию. В среде разработки Flash предупреждения об отсутствующих типах должны быть включены вручную, для чего используется такая последовательность действий.
Используя любой текстовый редактор, откройте файл EnabledWarnings . xml, находящийся в папке /en/Configuration/ActionScript 3.0, которая расположена внутри папки приложения Flash CS3.
Найдите следующие строки:
<warning 1d="1008" enabled="false" label="kWarning_NoTypeDecl"> Missing type declaration.</warning>
Измените enabled="false" на enabled=”true”.
Сохраните файл EnabledWarnings . xml.
Обратите внимание, что предупреждения об отсутствующих аннотациях типов генерируются только для неявно нетипизированных переменных, параметров и возвращаемых значений. Для явно нетипизированных (то есть для тех, которые объявлены с использованием специальной аннотации типа : *) предупреждения об отсутствующих аннотациях типов не генерируются.
Выявление ошибок обращения на этапе компиляции
В начале этой главы рассказывалось, что попытка обратиться к несуществующим переменной или методу приведет к возникновению ошибки обращения. Если для компиляции программы используется стандартный режим, то компилятор не сообщает об ошибках обращения. Вместо этого, когда программа выполняется в отладочной версии среды Flash, ошибки обращения проявляются в виде исключений. Напротив, если для компиляции программы используется строгий режим, компилятор сообгцаетп об обращениях к несуществующим переменным и методам в типизированных выражениях и прекращает компиляцию.
Например, в следующем коде создается переменная pet типа VirtualPet и этой переменной присваивается экземпляр класса VirtualPet:
var pet:VirtualPet = new VIrtualPet("Stan");
Затем в следующем коде происходит попытка обращения к несуществующему методу eatt ( ) через типизированную переменную pet:
pet.eatt(new Sushi( ));
В стандартном режиме предыдущий код успешно откомпилируется, однако на этапе выполнения программы произойдет ошибка обращения. В строгом режиме предыдущий код приведет к генерации следующей ошибки обращения на этапе компиляции и процесс компиляции будет завершен.
1061: Call to a possibly undefined method eatt through a
reference with static type zoo-.Virtual Pet.
На русском языке текст ошибки будет следующим: Вызов, вероятно, неопределенного метода eatt через ссылку статического типа zoo:VirtualPet.
Однако стоит отметить, что компилятор не сообщает об ошибках обращения, происходящих в нетипизированных выражениях. Более того, обращения к несуществующим переменным и методам через экземпляры динамических классов (таких как Ob j ect) не приводят к генерации вообще никаких ошибок обращения; вместо этого в результате возвращается значение undefined.
Дополнительную информацию о динамических классах можно найти в гл. 15.
Существует дополнительное преимущество при использовании аннотаций типов: в приложении Flex Builder и среде разработки Flash аннотации типов для переменных, параметров и возвращаемых значений активизируют подсказки кода. Подсказка кода представляет собой удобное всплывающее меню, содержащее список свойств и методов объектов, которые можно добавить в ваш код путем выбора требуемого элемента.
Приведение типов
В предыдущем разделе рассказывалось, что в строгом режиме компилятор сообщает об ошибках обращения на этапе компиляции. Для выявления ошибок обращения
компилятор полагается на аннотации типов. Предположим, что компилятор встретил обращение к методу, выполненное через типизированную переменную. Чтобы выяснить, является ли данное обращение корректным, компилятор проверяет наличие описания вызываемого метода в классе или интерфейсе, указанном в аннотации типа данной переменной. Если метод, к которому происходит обращение, не определен в указанном классе или интерфейсе, компилятор генерирует ошибку обращения.
Обратите внимание, что необходимость генерации ошибки обращения определяется исходя из класса или интерфейса, указанного в аннотации типа, а не фактического класса значения, хранящегося в данной переменной.
Рассмотрим следующий код, в котором метод has Wo rm ( ) вызывается над объектом Apple через переменную типа Food:
var meal:Food = new Apple( ):
meal,hasWorm( ); // Попытка вызвать метод hasWorm( ) над объектом, // хранящимся в переменной meal
При компиляции предыдущего кода в строгом режиме компилятор должен решить, может ли метод hasWorm ( ) быть вызван над значением переменной meal. Для этого компилятор проверяет, определен ли в классе Food (то есть в классе, который указан в аннотации типа переменной meal) метод hasWorm ( ). В этом классе определение данного метода отсутствует, поэтому компилятор генерирует ошибку обращения. Конечно, глядя на этот код, мы знаем, что значение переменной meal (объект Apple) поддерживает метод hasWorm ( ). Однако этого не знает компилятор. Среда выполнения Flash только на этапе выполнения узнает, что значением переменной на самом деле является объект Apple.
Каково же решение? Использовать операцию приведения типов, чтобы заставить компилятор разрешить предыдущий вызов метода hasWorm ( ). Операция приведения типов приказывает компилятору рассматривать данное значение как принадлежащее указанному типу данных. Эта операция имеет следующий обобщенный вид: тип(выражение)
В этом коде тип — это любой тип данных, а выражение — любое выражение. Говоря простым языком, эта операция «приводит выражение к указанному типу тип». Например, следующий код приводит выражение meal к типу данных Apple перед вызовом метода hasWorm ( ) над значением переменной meal:
Apple(meal).hasWorm( )
Независимо от действительного значения переменной meal компилятор верит, что типом данных выражения meal является тип Apple. По этой причине, принимая решение о возможности вызова метода hasWorm ( ) над значением переменной meal, компилятор проверяет, определен ли метод hasWorm ( ) в классе Apple, но не в классе Food. Метод hasWorm ( ) определен в классе Apple, и следовательно, компилятор не генерирует никаких ошибок.
Однако операция приведения типов используется не только на этапе компиляции. На этапе выполнения программы ей также присуще определенное поведение: если выражение выражение преобразуется в объект, который принадлежит указанному типу
тип, то среда Flash просто возвращает этот объект. Однако если выражение выражение преобразуется в объект, который не принадлежит указанному типу тип, возможен один из двух вариантов завершения операции приведения типов. Если указанный тип тип не является примитивным, операция приведения типов вызовет ошибку на этапе выполнения; в противном случае значение объекта преобразуется в указанный тип (в соответствии с правилами, перечисленными в разд. «Преобразование в примитивные типы»), и результатом операции будет преобразованное значение.
Например, в следующем коде значение переменной meal, сформированное на этапе выполнения программы, принадлежит типу данных Apple, поэтому операция приведения типов во второй строке просто вернет объект Apple, на который ссылается переменная meal:
var meal:Food = new Apple( );
Apple(meal); // На этапе выполнения вернет объект Apple
Для сравнения, в следующем коде значение переменной meal, сформированное на этапе выполнения программы, не принадлежит типу данных VirtualPet, и, поскольку тип данных Virtu al Pet не является примитивным, операция приведения типов во второй строке вызовет ошибку типа:
var meal:Food = new Apple( );
VI rtualPet(meal); // На этапе выполнения будет вызвана ошибка типа
Наконец, в следующем коде значение переменной meal, сформированное на этапе выполнения программы, не принадлежит типу данных Boolean, но, поскольку тип данных Boolean является примитивным, операция приведения типов во второй строке преобразует значение переменной meal в указанный тип и вернет результат данного преобразования (true):
var meal:Food = new Apple( );
Boolean(meal); // На этапе выполнения будет возвращено значение true
Избавление от нежелательных ошибок несоответствия типов
Как уже известно, операции приведения типов могут быть использованы для выявления нежелательных ошибок обращения на этапе компиляции. Подобным образом операции приведения типов могут применяться для избавления от нежелательных ошибок несоответствия типов.
В качестве примера представьте программу, которая преобразует температуру, заданную по шкале Фаренгейта, в температуру по шкале Цельсия. Значение температуры по шкале Фаренгейта вводится в текстовое поле, представленное экземпляром внутреннего класса TextField. Для получения введенного значения мы обращаемся к переменной text экземпляра класса TextField, как показано в следующем коде:
var "Fahrenheit:Number = 1nputFIeld.text;
В данных условиях такой код вызовет ошибку несоответствия типов, поскольку типом данных переменной text является String. Чтобы избавиться от этой ошибки, мы используем операцию приведения типов, как показано в следующем коде:
var fahrenhe1t:Number = Number(1 nputFIeld.text);
На этапе выполнения программы этот код преобразует строковое значение, хранящееся в переменной inputField. text, в тип Number и присвоит преобразованное значение переменной fahrenheit.
Восходящее и нисходящее приведения типов
Приведение типа объекта к одному из его супертипов (суперклассу или суперинтерфейсу) называется восходягцим приведением типов. Например, следующая операция осуществляет восходящее приведение типов, поскольку тип данных Food является супертипом типа Apple:
Food(new Apple( ))
И наоборот, приведение типа объекта к одному из его подтипов (подклассу или подинтерфейсу) называется нисходягцим приведением, поскольку эта операция выполняет приведение типа объекта к типу, который находится ниже текущего в иерархии. Следующая операция осуществляет нисходящее приведение типов, поскольку тип данных Apple является подтипом типа Food:
Apple(new Food( ))
Говорят, что восходящее приведение типов «расширяет» тип объекта, поскольку супертип является более обобщенным по сравнению с его подтипом. В то же время нисходящее приведение типов «сужает» тип объекта, поскольку подтип является более специализированным, чем его супертип.
Кроме того, восходящее приведение типов считается безопасным, поскольку оно никогда не вызывает ошибку на этапе выполнения. Как было сказано ранее, экземпляр подтипа можно всегда рассматривать как экземпляр любого из его супертипов, потому что он гарантированно (через наследование) обладает всеми методами и переменными экземпляра своих супертипов в том случае, если эти методы и переменные объявлены с использованием любых модификаторов управления доступом, кроме private.
И наоборот, нисходящее приведение типов считается небезопасным, поскольку оно способно вызвать ошибку на этапе выполнения. Чтобы гарантировать, что операция нисходящего приведения типов не вызовет ошибку на этапе выполнения, перед приведением типов мы должны убедиться в фактической принадлежности рассматриваемого объекта к целевому типу данных. Для выполнения проверки типа данных объекта используется оператор is, имеющий следующий вид: выражение 1s тип
В предыдущем коде выражение обозначает любое выражение, а тип — любой класс или интерфейс (тип не должен принимать значения undefined или null). Оператор is возвращает значение true, если заданное выражение принадлежит указанному типу тип, в противном случае возвращается значение false.
В следующем коде используется оператор is, чтобы гарантировать, что нисходящее приведение типов не вызовет ошибку на этапе выполнения:
van apple:Food = new Apple( );
1f (apple 1s Apple) {
Applе(applе).hasWormC
В предыдущем коде блок условного оператора будет выполнен только в том случае, если переменная apple ссылается на объект, принадлежащий тину Apple. По этой причине операция приведения типов Apple (apple) никогда не вызовет ошибку.
Использование оператора as для приведения к типам Date и Array
По многим причинам, связанным с поддержкой старого кода в языке ActionScript 3.0, синтаксис приведения типов, описанный в предыдущих разделах, не может быть использован для приведения типа значения к внутренним классам Date и Array. Результат выражения Date (некотороеЗначение) идентичен результату выражения new Date ( ) . toString ( ) (оно возвращает строковое представление текущего времени). Результат выражения Array (некотороеЗначение) идентичен результату выражения new Array (некотороеЗначение) (оно создает новый объект Array, первым элементом которого является значение некотороеЗначение).
Для приведения типа результата выражения либо к классу Date, либо к классу Array используется оператор as, который действует точно так же, как операция приведения типов, но с одним исключением — данный оператор возвращает значение null в тех случаях, когда операция приведения типов вызывает ошибку на этапе выполнения. Оператор as имеет следующий вид:
выражение as тип
В приведенном коде выражение представляет любое выражение, а тип — любой класс или интерфейс (тип не должен принимать значения undefined или null). Оператор as возвращает значение выражения выражение, если указанное выражение принадлежит указанному типу тип, в противном случае возвращается значение null.
Например, в следующем коде результат выражения (meal as Apple) идентичен результату операции приведения типов Apple (meal):
var meal:Food = new Apple( );
(meal as Apple).hasWorm( );
В следующем коде оператор as используется для «приведения» объекта Array к типу данных Array с тем, чтобы данный объект можно было присвоить переменной типа Array.
public function output (msg:Object):void {
1f (msg 1s String) { trace(msg);
}
if (msg is Array) {
var arr:Array = msg as Array; // Приведение к типу Array trace(arr.join("\n"));
}
}
Следующий код демонстрирует результат передачи тестового объекта Ar ray в метод output ( ):
var numbers:Array = [1,2,3] output(numbers);
// Вывод:
1
2
3
Преобразование в примитивные типы
В предыдущем разделе рассказывалось, что если выражение приводится к примитивному типу, к которому оно не принадлежит, то его значение будет преобразовано в указанный тип. Например, рассмотрим следующий код, который выполняет приведение объекта Date к примитивному типу данных Boolean:
Boolean(new Date( ))
Поскольку тип данных Boolean является примитивным типом, а объект Date не принадлежит типу Boolean, среда выполнения Flash преобразует значение объекта Date в тип Boolean. Результатом данного преобразования будет являться значение true типа Boolean.
Операции приведения типов иногда используются не для того, чтобы сообщить компилятору тип заданного выражения, а для того, чтобы преобразовать значение этого выражения в примитивный тип данных.
Операция приведения типов может преобразовать любое значение в конкретный примитивный тип.
Например, следующий код преобразует число с плавающей точкой (с дробной частью) в целое число (без дробной части):
1nt(4.93)
Результатом этой операции приведения типов является целое число 4. Подобным образом следующий код преобразует значение true типа Boolean в целое число 1, а значение false типа Boolean — в целое число 0:
int(true); // Возвращает 1
int(false); // Возвращает О
Такая методика может применяться для уменьшения размера передаваемых на сервер данных, включающих ряд значений типа Boolean.
В табл. 8.1 представлены результаты преобразования различных типов данных в тип Number.
Таблица 8.1. Преобразование в тип Number
Исходные данные
Результат после преобразования
undefined
NaN (специальное числовое значение «Не число» (Not a Number), представляющее некорректные числовые данные)
Исходные данные
Результат после преобразования
null
0
int
То же число
uint
То же число
Boolean
1, если исходным значением является true;
0, если исходным значением является false
Numeric в строковом представлении
Эквивалентное числовое значение, если строка состоит только из цифр десятичной или шестнадцатеричной систем счислений, пробела, экспоненты, десятичной точки, знаков + или - (например, строка ("-1.485е2") превратится в число -148.5)
Пустая строка
0
«Бесконечность»
Infinity•
«Минус бесконечность»
-Infinity
Другие строки
NaN
Объект
NaN
В табл. 8.2 представлены результаты преобразования различных типов данных в тип int.
Таблица 8.2. Преобразование к типу int
Исходные данные
Результат после преобразования
undefined
0
null
0
Number или uint
Целое число в диапазоне от -231 до 231-1; значения, превышающие диапазон представления, включаются в указанный диапазон с помощью алгоритма, описанного в разд. 9.5 третьей редакции стандарта ЕСМА-262
Boolean
1, если исходным значением является true;
0, если исходным значением является false
Numeric в строковом представлении
Эквивалентное числовое значение, преобразованное в целочисленный знаковый формат
Пустая строка
0
«Бесконечность»
0
«Минус бесконечность»
0
Другие строки
0
Объект
0
В табл. 8.3 представлены результаты преобразования различных типов данных в тип uint.
Таблица 8.3. Преобразование в тип uint
Исходные данные
Результат после преобразования
undefined
0
null
0
Number или int
Целое число в диапазоне от 0 до 231-1; значения, превышающие диапазон представления, включаются в указанный диапазон с помощью алгоритма, описанного в разд. 9.6 третьей редакции стандарта ЕСМА-262
Продолжение ^
Таблица 8.3 (мродо. гженис)
Исходные данные
Результат после преобразования
Boolean
1, если исходным значением является true;
0, если исходным значением является false
Numeric в строковом представлении
Эквивалентное числовое значение, преобразованное в целочисленный беззнаковый формат
Пустая строка
0
«Бесконечность»
0
«Минус бесконечность»
0
Другие строки
0
Объект
0
В табл. 8.4 представлены результаты преобразования различных типов данных в тип String.
Таблица 8.4. Преобразование в тип String
Исходные данные
Результат после преобразования
undefined
"undefined"
null
"null"
Boolean
"true", если исходным значением является true;
"false", если исходным значением является false
NaN
"NaN"
0
"0"
«Бесконечность»
"Infinity"
«Минус бесконечность»
"-Infinity"
Другое числовое значение
Строковое представление указанного числа. Например, число 944.345 превратится в строку "944.345"
Объект
Значение, полученное в результате вызова метода toString() над объектом. По умолчанию метод объекта toString() возвращает строку "[object имяКласса]", где имяКласса представляет класс объекта. Метод toString() может быть переопределен для получения более полезной информации. Например, метод toString() объекта Date возвращает время в удобочитаемом формате наподобие "Sun Мау 14 11:38:10 EDT 2000", а метод toString() объекта Array возвращает список элементов массива, разделенных запятыми
В табл. 8.5 представлены результаты преобразования различных типов данных в тип Boolean.
Таблица 8.5. Преобразование в тип Boolean
Исходные данные
Результат после преобразования
undefined
false
null
false
NaN
false
0
false
Infinity
true
-Infinity
true
Другое числовое значение
true
Непустая строка
true
Исходные данные
Результат после преобразования
Пустая строка ("")
false
Объект
true
Значения переменных по умопчанию
Когда переменная объявлена без аннотации типа и без указания исходного значения, в качестве исходного значения этой переменной автоматически присваивается значение undefined (единственное значение типа данных void). Когда переменная объявлена с аннотацией типа, но без указания исходного значения, в качестве ее исходного значения автоматически присваивается значение по умолчанию, соответствующее указанному типу данных.
В табл. 8.6 перечислены значения по умолчанию для каждого конкретного типа данных в языке ActionScript, используемые при объявлении переменных.
Таблица 8.6. Значения переменных по умолчанию
Тип данных
Значение по умолчанию
String
null
Boolean
false
int
0
uint
0
Number
NaN
Все остальные типы
null
Значения null и undefined
В одной из предыдущих глав рассказывалось, что каждый из типов данных — Null и void — включает по одному-единственному значению — null и undefined соответственно. Теперь, когда мы познакомились с типами данных и аннотациями типов, рассмотрим, чем же отличаются эти два значения.
Концептуально оба значения — null и undefined — обозначают отсутствие данных. Значение null обозначает отсутствие данных для переменных, параметров и возвращаемых значений, объявленных с использованием аннотаций типов, кроме типов Boolean, int, uint и Number. Например, следующий код создает типизированную переменную экземпляра pet типа Virtual Pet. До тех пор пока переменной не будет явно присвоено значение в программе, ее значением будет являться null.
package {
Import flash.display.Sprite;
Import zoo.*;
public class VlrtualZoo extends Sprite {
private var pet:Virtual Pet;
public function VirtualZoo ( ) { trace(pet): // Выводит: null }
Напротив, значение undefined обозначает отсутствие данных для переменных, параметров и возвращаемых значений, объявленных без использования аннотаций тп нов. Напри мер, следу юно i й код создает объект с двумя динамическими переменными экземпляра — city и country. Этот код использует значение undefined при присваивании переменной country исходного значения, чтобы показать, что она пока не имеет осмысленного значения.
var Info = new Object( ):
Info.city = "Toronto";
Info.country = undefined;
Кроме того, значение undefined обозначает полное отсутствие переменной или метода у объекта, чей класс объявлен с использованием атрибута dynamic. Например, в результате следующей попытки обратиться к несуществующей переменной объекта, на который ссылается переменная info, будет возвращено значение undefined:
tracednfo.language); // Выводит: undefined
Более подробно динамические возможности языка ActionScript и значение undefined будут рассмотрены в гл. 15.
Типы данных в программе по созданию виртуального зоопарка
Теперь, когда мы получили всю информацию о типах данных, добавим аннотации типов в нашу программу «Зоопарк». В листинге 8.1 представлен измененный код класса VirtualZoo — основного класса программы.
Листинг 8.1. Класс VirtualZoo
package {
Import flash.display.Sprite;
Import zoo.*;
public class VirtualZoo extends Sprite { private var pet:Virtual Pet;
public function VirtualZoo ( ) {
pet = new VirtualPet("Stan");
pet.eattnew Applet ));
pet.eattnew Sushi( ));
}
}
Листинг 8.2 демонстрирует код класса VirtualPet, экземпляры которого представляют животных в зоопарке. Обратите внимание на использование операции приведения типов в методе eat ( ), рассмотренной в подразд. «Восходящее и нисходящее приведения типов» разд. «Приведение типов».
Листинг 8.2. Класс VirtualPet
package zoo {
import flash.utils.setinterval;
Import fl ash.utils.cl earInterval;
Internal class VirtualPet {
private static var maxNameLength:1nt = 20;
private static var maxCalor1es:1nt = 2000;
private static var calor1esPerSecond:1nt = 100;
private var petName:String;
private var currentCalor1es:1nt = Virtual Pet.maxCalor1es/2;
private var digestinterval ID;1nt;
public function VirtualPet (name:Str1ng):void { setName(name);
digestinterval ID = setinterval(digest, 1000);
}
public function eat (foodItem:Food):void {
1f (currentCalorles == 0) {
trace(getName( ) + " 1s dead. You can't feed it."); return;
}
if (fooditem 1s Apple) {
// Обратите внимание на приведение к типу Apple
if (Applе(fooditem),hasWorm( )) { traceCThe " + fooditem.getName( ) + " had a worm. " + getName( ) + " didn't eat it."):
return;
}
}
var newCurrentCalor1es:1nt = currentCalorles + fooditem.getCalor1es( );
if (newCurrentCalorles > Virtual Pet.maxCalorles) { currentCalorles = Virtual Pet.maxCalorles;
} else {
currentCalorles = newCurrentCalorles;
}
trace(getName( ) + " ate some " + foodItem.getName( ) +
+ " It now has " + currentCalorles + " calories remaining."):
}.
public function getHunger ( ):Number { return currentCalorles / Virtual Pet.maxCalorles;
}
public function setName (newName:String):void {
// Если длина заданного нового имени
// больше maxNameLength символов...
1f (newName.length > Virtual Pet.maxNameLength) {
// ...обрезать имя
newName = newName.substr(0, V1rtualPet.maxNameLength);
} else if (newName == "") {
// ...в противном случае, если заданное новое имя является // пустой строкой, завершить выполнение метода, не изменяя // значения переменной petName return;
}
// Присвоить новое проверенное имя переменной petName petName = newName:
}
public function getName ( ):String { return petName;
}
private function digest ( ):vo1d {
// Если в результате потребления очередной порции калорий
// значение переменной currentCalorles животного
// станет равным 0 или меньше...
1f (currentCalorles - Virtual Pet.calorlesPerSecond <= 0) {
// ...прекратить вызов метода d1gest( ) clearinterval(digestinterval ID);
// После чего очистить желудок животного currentCalorles = 0;
// и сообщить о смерти животного trace(getName( ) + " has died.");
} else {
// ...иначе употребить оговоренное количество калорий currentCalorles -= Virtual Pet.calorlesPerSecond;
// и сообщить о новом состоянии животного
trace(getName( ) + " digested some food. It now has " + currentCalorles + " calories remaining.");
}
}
}
}
Листинг 8.3 демонстрирует код класса Food, являющегося суперклассом для различных видов пищи, принимаемой животными.
Листинг 8.3. Класс Food
package zoo {
public class Food {
private var calor1es:1nt:
private var name:String;
public function Food (1n111al Calor1es:1 nt) { setCalor1es(1n111al Calor1es);
}
public function getCalorles ( ):1nt { return calories;
}
public function setCalories (newCalor1es:1nt):vo1d { calories = newCalorles;
}
public function getName ( ):String { return name;
}
public function setName (newName:Str1ng):void { name = newName;
}
}
Листинг 8.4 демонстрирует код класса Apple, представляющего конкретный вид пищи, принимаемой животными.
Листинг 8.4. Класс Apple
package zoo {
public class Apple extends Food {
private static var DEFAULT_CAL0RIES:1nt = 100;
private var wormlnApple:Boolean;
public function Apple (1n1t1alCalor1es:1nt = 0) {
1f (1n1t1alCalor1es <= 0) {
1n1t1alCalor1es = Apple.DEFAULT_CALORIES;
}
super(in1t1alCalor1es);
wormlnApple = Math.randomC ) >= .5;
setName("Apple");
}
public function hasWorm ( ):Boolean { return wormlnApple;
}
}
}
Наконец, листинг 8.5 демонстрирует код класса Sushi, представляющего конкретный вид пищи, принимаемой животными.
Листинг 8.5. Класс Sushi
package zoo {
public class Sushi extends Food {
private static var DEFAULT_CALORIES:mt = 500:
public function Sushi (1n111alCa1or1es:1 nt = 0) {
1f (1n1t1alCalor1es <= 0) {
1n1t1alCalor1es = Sushi.DEFAULT_CALORIES:
}'
super(1n111al Calor1es);
setNameCSushl");
}
}
}
Далее: дополнительное изучение типов данных
В этой главе было рассказано, как использование типов данных помогает выявить и устранить потенциальные проблемы в программе. В следующей главе мы завершим наше обзорное изучение типов данных, рассмотрев интерфейсы. Интерфейсы, как и классы, применяются для создания пользовательских типов данных.
Интерфейсы
Интерфейс — это конструкция языка ActionScript, которая описывает новый тип данных подобно описанию типа данных с помощью класса. Однако, тогда как класс не только описывает тип данных, но и предоставляет для него реализацию, интерфейс только описывает тип данных в абстрактных терминах и не предоставляет реализацию для этого типа данных. Иными словами, класс не только объявляет группу методов и переменных, но и реализует определенное поведение; тела методов и значения переменных управляют поведением класса. Вместо того чтобы предоставлять собственную реализацию, интерфейс принимается одним или несколькими классами, которые согласны предоставить для него реализацию. Экземпляры класса, предоставляющего реализацию для интерфейса, принадлежат как типу данных класса, так и типу данных, описанному интерфейсом. Являясь одновременно членом нескольких типов данных, экземпляры могут выполнять в приложении различные функции.
Не путайте термин «интерфейс», обсуждаемый в данной главе, с другими применениями этого слова. В этой главе «интерфейс» обозначает конструкцию языка ActionScript, а не графический интерфейс пользователя (GUI) или открытый API класса, которые в общей теории объектно-ориентированного программирования иногда именуются интерфейсами.
Если это ваше первое знакомство с интерфейсами, то их теоретические описания могут оказаться сложными для восприятия, поэтому сразу же рассмотрим пример.
Аргумент в пользу интерфейсов
Предположим, мы создаем протоколирующий класс Logger, который рапортует о статусных сообщениях («записях журнала») программы в процессе ее выполнения. Многие классы получают статусные сообщения от класса Logger и по-разному реагируют на них. Например, один класс — LogUI — отображает журнальные сообщения на экране, другой класс — LiveLog — отправляет предупреждение специалисту службы поддержки с помощью сетевого инструмента администрирования, а еще один класс — LogTracker — добавляет журнальные сообщения в базу для ведения статистики. Для получения журнальных сообщений каждый класс определяет метод update ( ). Чтобы отправить сообщение объектам всех заинтересованных классов, класс Logger вызывает метод update ( ).
Пока все это кажется логичным, но что произойдет, если мы забудем определить метод update ( ) в классе LogUI? Статусное сообщение будет отправлено, однако объекты класса LogUI не получат его. Нам необходим такой подход, который
гарантирует, что каждый получатель журнальных сообщений определяет метод update ( ).
Чтобы предоставить такую гарантию, предположим, что мы ввели новое требование в нашу программу: любой объект, желающий получать журнальные сообщения от класса Logger, должен быть экземпляром базового класса LogRecipient (мы предоставим его описание) или экземпляром одного из подклассов класса LogRecipient. Реализация метода update ( ) в классе LogRecipient будет включать базовую функциональность, попросту отображая журнальное сообщение с помощью функции trace ( ):
public class LogRecipient {
public function update (msg:String)-.void { trace(msg);
} }
Теперь любой класс, который желает получать журнальные сообщения от класса Logger, просто расширяет класс LogRecipient и, если требуется специфическое поведение, перекрывает метод update ( ) класса LogRecipient, реализуя желаемое поведение. Например, следующий класс LogTracker расширяет класс LogRecipient и перекрывает метод update ( ), реализуя функциональность сохранения информации в базе данных:
public class LogTracker extends LogRecipient {
// Перекрытый метод update( ) класса LogRecipient
override public function update (msg:String):void {
// Сохранение сообщения об ошибке в базе данных. Код не показан...
}
}
Возвращаясь к классу Logger, мы определим метод addRecipient ( ), который выполняет регистрацию объекта, желающего получать журнальные сообщения. Базовое описание метода addRecipient ( ) представлено ниже. Обратите внимание, что в метод addRecipient ( ) могут передаваться только экземпляры класса LogRecipient и его подклассов:
public class Logger {
public function addRecipient (1r:LogRecipi ent):Boolean {
// Размещаемый здесь код должен выполнять регистрацию объекта 1г
// для получения статусных сообщений и возвращать значение типа Boolean.
// которое отражает результат выполненной операции (код не показан).
}
}
Если передаваемый в метод addRecipient ( ) объект не принадлежит типу LogRecipient, компилятор сгенерирует ошибку несоответствия типов. Если этот объект является экземпляром подкласса класса LogRecipient, в котором не реализован метод update ( ), то по крайней мере будет выполнена базовая версия метода update ( ) (определенная в классе LogRecipient).
Приемлемый вариант, не правда ли? Почти. Однако есть проблема. Что делать в том случае, если класс, желающий получать события от класса LogRecipient,
уже расширяет другой класс? Например, предположим, что класс LogUI расширяет класс flash. display. Sprite:
public class LogUI extends Sprite {
public function update (msg:Str1ng):void {
// Отображение статусного сообщения на экране, код не показан...
В языке ActionScript класс не может расширять несколько классов. Класс LogUI уже расширяет класс Sprite, поэтому он не может расширять еще и класс LogRecipient. Следовательно, экземпляры класса LogUI не могут регистрироваться в классе Logger, чтобы получать от него статусные сообщения. В данной ситуации нам крайне необходим способ, позволяющий указать, что на самом деле экземпляры класса LogUI принадлежат двум типам данных: LogUI иLogRecipient.
В игру вступают... интерфейсы!
Интерфейсы и классы с несколькими типами данных
В предыдущем разделе мы создали тип данных LogRecipient, определив класс LogRecipient. Ограничение данного подхода заключается в том, что каждый получатель сообщений от класса Logger должен быть экземпляром либо класса LogRecipient, либо одного из его подклассов. Чтобы избавиться от этого ограничения, мы можем описать тип данных LogRecipient путем создания интерфейса LogRecipient, а не путем создания одноименного класса. В этом случае экземпляры любого класса, который формально согласен предоставить реализацию для метода update ( ), могут регистрироваться для получения журнальных сообщений. Посмотрим, как это работает.
Синтаксически интерфейс представляет собой просто список методов. Например, следующий код создает интерфейс LogRecipient, содержащий один-един- ственный метод update ( ) (обратите внимание, что интерфейсы, как и классы, могут быть описаны с помощью модификаторов управления доступом public и internal).
public Interface LogRecipient {
function update(msg:String):void;
}•
Как только интерфейс будет описан, любое количество классов может использовать ключевое слово implements, чтобы вступить в соглашение с этим интерфейсом, пообещав определить содержащиеся в нем методы. Как только класс даст такое обещание, его экземпляры будут считаться членами не только типа данных класса, но и типа данных интерфейса.
Например, чтобы указать, что класс LogUI согласен определить метод update ( ) (описанный в интерфейсе LogRecipient), мы используем следующий код:
class Loglll extends Sprite Implements LogRecipient {
public function update (msg:Str1ng):void {
// Отображение статусного сообщения на экране, код не показан...
Вместо того чтобы расширять класс LogRecipient, LogUI расширяет класс Sprite и реализует интерфейс LogRecipient. Поскольку класс LogUI реализует интерфейс LogRecipient, он должен определить метод update ( ). В противном случае компилятор сгенерирует следующую ошибку:
Interface method update 1n namespace LogRecipient not Implemented by class LogUI.
На русском языке она будет выглядеть следующим образом: Метод интерфейса update из пространства имен LogRecipient не реализован классом LogUI.
Поскольку класс LogUI обещает реализовать методы интерфейса LogRecipient, экземпляры этого класса могут быть использованы везде, где требуется тип данных LogRecipient. Экземпляры класса LogUI фактически принадлежат двум типам данных: LogUI и LogRecipient. Таким образом, даже несмотря на то, что класс LogUI расширяет класс Sprite, экземпляры класса LogUI принадлежат типу LogRecipient и могут благополучно передаваться в метод addRecipient ( ) класса Logger.
Ошибки компилятора — это ключ ко всей системе интерфейсов. Они гарантируют, что класс сдержит свои обязательства по реализации методов интерфейса, тем самым позволив внешнему коду использовать этот класс с уверенностью в его правильном поведении. Эта уверенность особенно важна при разработке приложения, возможности которого будут расширяться другим разработчиком или использоваться третьими лицами.
Теперь, когда мы получили общее представление об интерфейсах и о том, как они используются, рассмотрим детали синтаксиса.
Синтаксис и использование интерфейсов
Как уже известно, интерфейс описывает новый тип данных, не предоставляя реализацию ни для одного из методов этого типа. Таким образом, для создания интерфейса используется следующий синтаксис:
Interface НекоеИмя {
function метод 1 (параметр! липданных. . . параметрплипданныхУ типВозвращаемогоЗначения;
function метод2 (параметр! липданных. . . параметрплипданныхУ типВозвращаемогоЗначения:
function методп (параметр! липданных... параметрплипданныхУ типВозвращаемогоЗначения;
Здесь НекоеИмя — это имя интерфейса, метод!. . . методп — методы данного интерфейса, параметр! : типданных. . . параметрп: типданных — параметры методов, а типВоз - вращаемогоЗначения — тип данных возвращаемого значения каждого из методов.
Объявления методов в интерфейсах не включают (и не должны включать) фигурные скобки. Следующее объявление метода вызовет ошибку в интерфейсе на этапе компиляции, поскольку в объявление включены фигурные скобки:
function метод! (параметрлипданныхУлипВозвращаемогоЗначения { }
Возникшая ошибка:
Methods defined 1n an Interface must not have a body.
На русском языке ошибка будет выглядеть так: Описываемые в интерфейсе методы не должны иметь тела.
Объявления всех методов в интерфейсе не должны включать модификаторы управления доступом. Интерфейсы в языке ActionScript не могут содержать определения переменных; описания интерфейсов не могут быть вложенными. Тем не менее интерфейсы могут включать get- и set-методы, которые могут применяться для имитации переменных (с позиции кода, использующего эти методы). Описания интерфейсов, как и описания классов, могут размещаться либо непосредственно внутри оператора package, либо за его пределами, но нигде больше.
Как было сказано в предыдущем разделе, класс, который желает принять тип данных интерфейса, должен согласиться реализовать методы этого интерфейса. Чтобы сформировать данное соглашение, класс использует ключевое слово implements, имеющее следующий синтаксис:
class НекоеИмя Implements НекийИнтерфейс { }
В данном коде НекоеИмя — это имя класса, который обещает реализовать методы интерфейса НекийИнтерфейс, а НекийИнтерфейс — имя интерфейса. Говорят, что класс НекийКласс «реализует интерфейс НекийИнтерфейс». Обратите внимание, что, если в описании класса используется раздел extends, ключевое слово implements должно идти после него. Более того, если после ключевого слова implements вместо имени интерфейса вы укажете имя класса, компилятор сгенерирует следующую ошибку: An Interface can only extend other Interfaces, but ИмяКласса 1s a class. •
По-русски она будет выглядеть так: Интерфейс может только расширять другие интерфейсы, а ИмяКласса является классом.
Класс НекоеИмя должен реализовать все методы, описанные в интерфейсе НекийИнтерфейс, иначе на этапе компиляции возникнет следующая ошибка:
Interface method имяМетода 1n namespace ИмяИнтерфейса not Implemented by class ИмяКласса.
На русском языке ошибка означает следующее: Метод интерфейса имяМетода в пространстве имен ИмяИнтерфейса не реализован классом ИмяКласса.
Определения методов в классе, реализующем интерфейс, должны быть открытыми и в точности соответствовать определениям методов интерфейса, включая количество и типы параметров, а также тип возвращаемого значения. Если между интерфейсом и реализующим его классом существует различие по любому из перечисленных аспектов, компилятор сгенерирует следующую ошибку:
Interface method имяМетода in namespace ИмяИнтерфейса 1s Implemented with an Incompatible signature in class ИмяКласса.
По-русски она будет звучать так: Метод интерфейса имяМетода в пространстве имен ИмяИнтерфейса реализован с несовместимой сигнатурой в классе ИмяКласса.
Класс может реализовать несколько интерфейсов, разделив их имена запятыми, как показано в следующем коде:
class НекоеИмя Implements НекийИнтерфейс. НекийДругойИнтерфейс {
}
В данном случае экземпляры класса НекоеИмя принадлежат всем трем указанным типам данных: НекоеИмя, НекийИнтерфейс и НекийДругойИнтерфейс. Если класс реализует два интерфейса, в каждом из которых описан метод с одним и тем же именем, но с отличающейся сигнатурой (то есть имя метода, список параметров и тип возвращаемого значения), то компилятор сгенерирует ошибку, указывающую на то, что один из методов реализован неправильно.
С другой стороны, если класс реализует два интерфейса, в каждом из которых описан метод с одним и тем же именем и совпадающей сигнатурой, ошибки не будет. Однако в связи с этим возникает вопрос: может ли класс предоставить функциональность, необходимую обоим интерфейсам, в одном определении метода? В большинстве случаев ответ на этот вопрос отрицателен.
Добавление новых методов в интерфейс, который уже реализован одним или несколькими классами, приведет к появлению в этих классах ошибок на этапе компиляции (поскольку в классах определение новых методов отсутствует)! Таким образом, перед внесением изменений в код вы должны тщательно подумать, какие методы будут включены в интерфейс, и быть уверенными в архитектуре своего приложения.
Если класс объявит, что он реализует некий интерфейс, но компилятор не сможет найти этот интерфейс, то появится следующая ошибка:
Interface ИмяИнтерфейса was not found.
На русском языке ошибка будет выглядеть следующим образом: Интерфейс ИмяИнтерфейса не найден.
Соглашения по именованию интерфейсов
Имена интерфейсов, как и имена классов, должны начинаться с прописной буквы, давая понять, что они представляют типы данных. Большинству интерфейсов имена даются исходя из дополнительной возможности, описываемой этими интерфейсами.
Предположим, что приложение содержит несколько классов, представляющих визуальные объекты. Некоторые объекты можно перемещать, другие — нет. В нашем проекте объекты, которые могут быть перемещены, должны реализовать интерфейс Moveable. Рассмотрим пример теоретического класса Product Icon, реализующего интерфейс Moveable:
public class Producticon Implements Moveable {
public function getPosition ( ):Point {
}
public function setPosItlon (pos:Po1nt):vo1d {
Интерфейс с именем Moveable обозначает конкретную возможность, которую он добавляет в класс. Объект может быть фрагментом изображения или блоком текста, но, если он реализует интерфейс Moveable, его можно перемещать. Примерами похожих имен являются Storable, Killable или Serializable. Некоторые разработчики перед именем интерфейса дополнительно указывают букву I, например IMoveable, IKillable или ISerializable.
Наследование интерфейсов
Как и в случае с классами, для наследования одного интерфейса от другого может применяться ключевое слово extends. Например, следующий код демонстрирует интерфейс IntA, который расширяет другой интерфейс — IntB. В данной схеме интерфейс IntB называется подинтерфейсом, а интерфейс IntA — суперинтерфейсом.
public Interface IntA {
function methodA ( ):vo1d;
}
public Interface IntB extends IntA {
function methodB ( ):void:
}
Классы, реализующие интерфейс IntB, должны определять не только метод methodB ( ), но и метод methodA ( ). Наследование интерфейсов позволяет описывать иерархию типов, во многом напоминающую иерархию, которая образуется при использовании наследования классов, но без предоставления реализаций методов.
Интерфейсы языка ActionScript также поддерживают множественное наследование, то есть один интерфейс может расширять несколько. Например, рассмотрим следующие три описания интерфейсов:
public Interface IntC {
function methodC ( ):void;
}
public Interface Into { function methodD ( ):vo1d;
}
public Interface IntE extends IntC, IntD { function methodE ( ):void;
}
Поскольку интерфейс IntE расширяет оба интерфейса IntC и IntD, классы, реализующие интерфейс IntE, должны предоставить определения для методов methodC ( ), methodD ( ) и methodE ( ).
Интерфейсы-маркеры
Чтобы быть полезными, интерфейсы могут вообще не содержать никаких методов. Иногда пустые интерфейсы, называемые интерфейсами-маркерами, применяются для «отметки» (обозначения) класса, обладающего некоторой возможностью. Требования, предъявляемые к отмеченным классам (классам, реализующим интерфейс-маркер), описываются в документации по каждому конкретному интерфейсу-маркеру. Например, API среды выполнения Flash включает интерфейс-маркер IBitmapDrawable, обозначающий класс, который может быть отображен объектом Bi tmapData. Класс Bi tmapData будет отображать только те классы, которые реализуют интерфейс IBitmapDrawable (хотя на самом деле этот интерфейс не определяет никаких методов). Интерфейс IBitmapDrawable используется просто для того, чтобы «показать», что данный класс пригоден для работы с растровым изображением. Вот исходный код интерфейса IBitmapDrawable:
package flash.display {
Interface IBitmapDrawable {
}
}
Другой пример использования составных типов
Как уже известно из предыдущего примера с протоколирующим классом, класс может не только наследоваться от другого класса, но и реализовывать интерфейс. Экземпляры подкласса одновременно принадлежат типу данных суперкласса и типу данных интерфейса. Например, экземпляры класса LogUI из рассмотренного примера принадлежали типам данных Sprite и LogRecipient, поскольку класс LogUI был унаследован от класса Sprite и реализовывал интерфейс LogRecipient. Рассмотрим эту важную архитектурную структуру на новом примере.
Для понимания материала, изложенного в этом разделе, требуется предварительное знание массивов (упорядоченных списков значений), которые еще не рассматривались в этой книге. Если вы незнакомы с массивами, то пока пропустите этот раздел и вернитесь к нему после изучения гл. 11.
Предположим, мы создаем приложение, которое сохраняет объекты на сервере с помощью серверного сценария. Класс каждого сохраняемого объекта обязан предоставить метод serialize ( ), возвращающий строковое представление экземпляров данного класса. Строковое представление используется для воссоздания определенного объекта с нуля.
Одним из классов нашего приложения является простой класс Rectangle с переменными экземпляра width, height, fillcolor и lineColor. Для представления объектов Rectangle в виде строк класс Rectangle реализует метод serialize( ), который возвращает строку следующего формата:
"w1 dth=3 начение | he1 д^=значение | f 111 Col ог=значение 111 neCol ог=з качение"
Чтобы сохранить объект Rectangle на сервере, мы вызываем метод serialize ( ) над данным объектом и передаем полученную строку в наш серверный сценарий. В дальнейшем мы сможем получить эту строку и создать новый экземпляр класса Rectangle, размеры и цвет которого будут соответствовать значениям исходного экземпляра.
Для упрощения данного примера мы будем полагать, что каждый сохраняемый объект в приложении должен сохранять только имена переменных и их значения. Мы также будем полагать, что никакие значения переменных сами по себе не являются объектами, для которых требуется сериализация (то есть преобразован в строку).
Когда наступит время сохранить состояние нашего приложения, экземпляр пользовательского класса StorageManager выполнит следующие задачи.
Соберет объекты для сохранения.
Преобразует каждый объект в строку (вызвав метод serialize( ) ).
Перенесет объекты на диск.
Чтобы гарантировать тот факт, что каждый сохраняемый объект может быть сериализован, класс StorageManager отклонит любые экземпляры классов, которые не принадлежат типу данных Serializable. Вот фрагмент кода класса StorageManager, демонстрирующий метод addOb j есt ( ), который используется объектами для регистрации в списке сохраняемых объектов (обратите внимание, что в этот метод могут быть переданы только экземпляры, принадлежащие типу Serializable):
package {
public class StorageManager {
public function addObject (o:Ser1a!1zable):void {
}
} }
Тип данных Serializable описывается одноименным интерфейсом, который содержит один-единственный метод serialize ( ), как показано в следующем коде:
package {
public Interface Serializable { function ser1a!1ze( ) .-String:
}
}
Для выполнения сериализации создадим класс Serializer, реализующий интерфейс Serializable. Этот класс предоставляет следующие базовые методы для сериализации любого объекта: •
setSerializationObj ( )—указывает объект для сериализации;
setSerializationVars ( ) — задает, какие переменные объекта должны быть сериализованы;
setRecordSeparator ( ) — указывает строку, используемую в качестве разделителя между переменными;
serialize( ) — возвращает строку, представляющую объект.
Рассмотрим исходный код класса Serializer:
package {
public class Serializer Implements Serializable {
private var ser1al1zat1onVars:Array;
private var ser1al 1zat1onObj:Seri al 1zable;
private var recordSeparator:Str1ng;
public function Serializer ( ) { setSerlal 1zat1onObj(th1s);
}
public function setSer1al1zat1onVars (varsiArray):void { serlallzatlonVars = vans;
}
public function setSerlal1zat1onObj (obj:Seri al 1zable):vold { serial1zat1onObj = obj:
}
public function setRecordSeparator (rs:Str1ng):vo1d { recordseparator = rs;
}
public function serialize ( ):Str1ng { var s:String = "";
// Обратите внимание, что счетчик цикла
// уменьшается до нуля,
// а его обновление (декремент 1) происходит внутри
// условного выражения цикла
for (var 1:1nt = sen al 1zat1onVars. length; --1 >= 0; ) {
s += ser1al1zat1onVars[1]
+ "=" + Str1ng(ser1al 1zat1onObjEserlal 1zat1onVarsEI]]);
1f (1 > 0) {
s += recordseparator;
}
}.
return s;
} '
}
}
Если какой-либо класс желает воспользоваться возможностями сериализации класса Serializer, то может просто расширить его. Класс, непосредственно расширивший класс Serializer, унаследует и интерфейс Serializable,H реализацию этого интерфейса классом Serializer.
Обратите внимание на общую структуру системы сериализации: класс Serializer реализует интерфейс Serializable, предоставляя базовую реализацию, которая может быть использована в других классах через процедуру наследования. Но при этом классы могут реализовать интерфейс Serializable самостоятельно, предоставив желаемое поведение для метода serialize ( ).
Например, следующий код демонстрирует класс Point, определяющий переменные х и у, которые должны быть сериализованы. Этот класс расширяет класс Serializer и непосредственно использует его возможности.
package {
public class Point extends Serializer {
public var x:Number;
public var y:Number;
public function Point (x:Number, y:Number) { super( );
setRecordSeparator(",");
setSer1al1zat1onVars(["x". "y"]);
thls.x = x; this.у = у;
}
} }
Код, желающий сохранить экземпляр класса Point надиск, просто вызывает метод serialize ( ) над этим экземпляром, как показано в следующем примере:
var р:Point = new Po1nt(5, 6);
trace(p.ser1a!1ze( )); // Отображает: у=б,х=5
Стоит отметить, что класс Point непосредственно не реализует интерфейс Serializable. Этот класс расширяет класс Serializer, который, в свою очередь, реализует интерфейс Serializable.
Класс Point не расширяет никакой другой класс, поэтому он может свободно расширить класс Serializer. Тем не менее, если некий класс желает использовать класс Serializer, но уже расширяет другой класс, вместо наследования необходимо применять композицию. Иными словами, вместо расширения класса Serializer класс непосредственно реализует интерфейс Serializable, сохранит объект Serializer в переменной экземпляра и переадресует вызовы метода serializer ( ) этому объекту. Например, рассмотрим код упомянутого ранее класса Rectangle. Этот класс расширяет класс Shape, но использует возможности класса Serializer через композицию (обратите особое внимание на строки, выделенные полужирным шрифтом):
// Суперкласс Shape package {
public class Shape {
public var f1HColor:u1nt = OxFFFFFF;
public var HneColor:u1nt = 0;
public function Shape (f 111 Col or: u1 nt, HneColor:u1nt) { this.fill Col or = fill Col or;
thls.lIneCol or = 1 IneCol or;
}
}
}
// Класс Rectangle package {
// Подкласс Rectangle непосредственно реализует
// интерфейс Serializable
public class Rectangle extends Shape Implements Serializable {
public var w1dth:Number = 0;
public var height:Number = 0:
private var ser1a!1zer:Ser1al1zer:
public function Rectangle (f1lIColor:u1nt. HneColor:uint) { super(f1HColor, HneColor)
// Именно здесь создается композиция
serializer = new Serialized );
serial izer.setRecordSeparatod" |");
serializer.setSerializationVars(["height", "width",
"fillColor", "lineColor"]):
seriali zer.setSerializationObj(this);
}
public function setsize (w:Number, h:Number):void { width = w;
height = h:
}
public function getArea ( ):Number { return width * height;
}
public function serialize ( );Str1ng {
// Здесь класс Rectangle переадресует вызов метода serialize( )
// экземпляру класса Serializer, сохраненному
// в переменной serializer
return serial 1zer.serial1ze( );
}
}
}
Как и в случае с классом Point, код, желающий сохранить экземпляр класса Rectangle, просто вызывает метод serialize ( ) над этим объектом. Вызов метода через композицию будет переадресован экземпляру класса Serializer, сохраненному в классе Rectangle. Вот пример использования этого класса:
var r:Rectangle = new Rectangle(0xFF0000, OxOOOOFF);
r.setSizeUO, 15):
// Отображает: 11neColor=2551f111 Color=167116801width=101he1ght=15 trace(r.ser1a!1ze( ));
Если класс желает реализовать собственную версию метода serialize ( ) вместо того, чтобы использовать базовую версию этого метода, предоставляемую классом Serializer, он должен непосредственно реализовать интерфейс Serializable, предоставив определение и само тело метода serialize( ).
Разделение интерфейса типа данных Serializable и его реализации позволяет любому классу легко выбрать один из следующих вариантов реализации метода serialize ( ):
расширить класс Serializer;
использовать класс Serializer через композицию;
непосредственно предоставить собственную реализацию метода serialize! ).
Если класс не расширяет другой класс, он может расширить класс Serializer (этот вариант наименее трудоемкий). Если класс уже расширяет другой класс, он может использовать возможности класса Serializer через композицию (этот вариант наиболее гибкий). Наконец, если класс нуждается в собственной уникальной процедуре сериализации, он может непосредственно реализовать интерфейс Serializable (этот вариант наиболее трудоемкий, но в некоторых ситуациях обойтись без него невозможно).
Принимая во внимание гибкость описанной структуры, корпорация Sun Microsystems рекомендует, чтобы в приложениях на языке Java любой класс, у которого могут быть подклассы, являлся реализацией некоего интерфейса. По существу, подклассы могут создаваться непосредственно от данного класса или же он может использоваться классом, унаследованным от другого класса, через композицию. Рекомендация корпорации Sun также имеет смысл и для больших приложений, разрабатываемых на языке ActionScript.
На рис. 9.1 показана обобщенная структура типа данных, реализация которого может применяться как через наследование, так и через композицию.
НекийАбстрактныйТипНекийАбстрактныйТипИнтерфейсИнтерфейс
НекийАбстрактныйТип
НекийАбстрактныйТип
Интерфейс
Интерфейс
Абстрактноеописание типа данных
РеализуетРеализуетРеализуетРеализует
Реализует
Реализует
Реализует
Реализует
НекийКонкретныйТипНекийКонкретныйТипНекийДругойТипНекийДругойТип
НекийКонкретныйТип
НекийКонкретныйТип
НекийДругойТип
НекийДругойТип
Реализациятипа данныхРеализациятипа данныхНесвязанныйклассНесвязанныйкласс
Реализациятипа данных
Реализациятипа данных
Несвязанныйкласс
Несвязанныйкласс
РасширяетРасширяетСохраняетСохраняетРасширяетРасширяет
Расширяет
Расширяет
Сохраняет
Сохраняет
Расширяет
Расширяет
НекийКонкретныйПодтипНекийАбстрактныйТиписпользуетсячерез наследованиеНекийКонкретныйПодтипНекийАбстрактныйТиписпользуетсячерез наследованиеНекийДругойПодтипНекийАбстрактныйТип используется через композициюЭкземпляр ♦ НекийКонкретныйТипНекийДругойПодтипНекийАбстрактныйТип используется через композициюЭкземпляр ♦ НекийКонкретныйТип
НекийКонкретныйПодтип
НекийАбстрактныйТиписпользуетсячерез наследование
НекийКонкретныйПодтип
НекийАбстрактныйТиписпользуетсячерез наследование
НекийДругойПодтип
НекийАбстрактныйТип используется через композицию
Экземпляр ♦ НекийКонкретныйТип
НекийДругойПодтип
НекийАбстрактныйТип используется через композицию
Экземпляр ♦ НекийКонкретныйТип
Рис. 9.1. Множественное наследование типов данных через интерфейсы
На рис. 9.2 показана структура конкретных классов Serializable, Point и Rectangle из предыдущего примера.
SerializableАбстрактноеописаниетипа данных
Интерфейс
Класс
Реализует
1
Serializer |
Реализация I типа данных I
г т
РасширяетСохраняет
Point
Serializer используетсячерез наследование
Реализует
Shape
Несвязанныйкласс
Расширяет
Rectangle
Serializer используетсячерез композицию
♦Экземпляр Serializer
Рис. 9.2. Множественное наследование типов данных на примере интерфейса Serializable
Впереди еще много важного
Познакомившись с классами, объектами, наследованием, типами данных и интерфейсами, мы завершили изучение базовых концепций объектно-ориентированного программирования. До конца части I мы рассмотрим еще несколько других фундаментальных тем, касающихся языка Action Script. Однако изученные концепции объектно-ориентированного программирования не останутся невостребованными, поскольку они являются основой языка ActionScript.
В следующей главе рассматриваются инструкции и операторы языка ActionScript.
Инструкции и операторы
В этой главе приводится краткое, организованное в виде справочника, описание инструкций и операторов языка ActionScript, со многими из которых вы уже встречались в данной книге. Вместо того чтобы рассматривать каждую инструкцию и оператор по отдельности, эта книга обучает использованию инструкций и операторов в контексте других тем по программированию. Таким образом, глава содержит множество перекрестных ссылок на соответствующие разделы и примеры, разбросанные по всей книге. Информацию по операторам, которые не рассматриваются в данной книге, можно найти в справочнике по языку ActionScript корпорации Adobe.
Инструкции
Инструкции представляют собой разновидность директив, или базовых команд, программы, состоящую из ключевого слова (имени команды, зарезервированного для использования в языке ActionScript) и, обычно, вспомогательного выражения.
В табл. 10.1 перечислены инструкции языка ActionScript, их синтаксис и назначение.
Таблица 10.1. Инструкции языка ActionScript
Инструкция
Использование
Описание
break
break
Завершает цикл или инструкцию switch. Подробную информацию можно найти в гл. 2
case
case выражение: вложенные_инструкции
Обозначает инструкцию, выполняемую по условию в инструкции switch. Подробную информацию можно найти в гл. 2
continue
continue;
Пропускает оставшиеся инструкции в текущем цикле и начинает новую итерацию с начала цикла. За дополнительной информацией обратитесь к документации от корпорации Adobe
default
default: •
вложен н ые_и негрукци и
Обозначает инструкцию (-и), выполняемую (-ые) инструкцией switch, когда результат условного выражения не соответствует ни одному из значений выражений case. Дополнительную информацию можно найти в гл. 2
do-while
do {
вл ожен н ые_и негру кци и
} while (выражение)
Разновидность цикла while, гарантирующая, что тело цикла будет выполнено по крайней мере один раз. Дополнительную информацию можно найти в гл. 2
for
for (инициализация; условноеВыражение; корректирование) { инструкции
}
Многократно выполняет блок инструкций (цикл for). Синоним цикла while, однако выражения инициализации и корректирования цикла размещаются вместе с условным выражением в верхней части цикла. Дополнительную информацию можно найти в гл. 2
Продолжение ^
Таблица 10.1 (продолжение)
Инструкция
Использование
Описание
for-in
for (переменная in объ- ект){
инструкции
}
Перечисляет имена динамических переменных экземпляра или элементы массива. Дополнительную информацию можно найти в гл. 15
for-each-in
for each (переменная- ИлиЗначениеЭлемента in объект) { инструкции
}
Перечисляет значения динамических переменных экземпляра или элементы массива. Дополнительную информацию можно найти в гл. 15
if-else if-else
if (выражение) { вложен ные_и негру кци и
} else if (выражение) { вложенные_инструкции
} else { вложен н ые_и негру кци и
}
Выполняет одну или несколько инструкций в зависимости от условия или ряда условий. Дополнительную информацию можно найти в гл. 2
label
label: инструкция label: инструкции
Связывает инструкцию с идентификатором. Применяется вместе с инструкциями break или continue. За дополнительной информацией обратитесь к документации от корпорации Adobe
return
return;
return выражение;
Выход из функции, при этом может возвращаться значение. Дополнительную информацию можно найти в гл. 5
super
5ирег(аргумент1, аргу- мент2... аргументп) super. метод(аргумент1, аргумент?... аргументп)
Вызывает метод конструктора суперкласса или перекрытый метод экземпляра. Дополнительную информацию можно найти в гл. 6
switch
switch (выражение) { вложенные_инструкции
}
Выполняет указанный код в зависимости от условия или ряда условий (является альтернативой инструкции if-else if-else). Дополнительную информацию можно найти в гл. 2
throw
throw выражение
Генерирует исключение (ошибку) на этапе выполнения.
Дополнительную информацию можно найти в гл. 13
try/catch/ finally
try{
Ц код, который может
Ц сгенерировать
Ц исключение
} catch (еггог:ТипОшиб-
КИ1){
И Код обработчика
Ц ошибки типа
Ц ТипОшибки!
} catch (еггог:ТипОшиб- киМ) {
Ц Код обработчика
Ц ошибки типа
Ц ТипОшибкиМ
} finally {
Ц Код, который
И выполняется всегда
}
Окружает блок кода для реакции на возможные исключения, возникающие на этапе выполнения. Дополнительную информацию можно найти в гл. 13
Инструкция
Использование
Описание
while
while (выражение) { вложенные_инструкции
}
Многократно выполняет блок инструкций (цикл while).
Дополнительную информацию можно найти в гл. 2
with
with (объект) { вл ожен н ые_и негру кци и
}
Выполняет блок инструкций в контексте данного объекта. Дополнительную информацию можно найти в гл. 16
Операторы
Оператор — это символ или ключевое слово, предназначенные для управления, объединения или преобразования данных. Например, следующий код использует оператор умножения ( * ), чтобы умножить число 5 на число 6:
5 * 6;
Хотя каждый оператор выполняет свою специализированную задачу, все операторы обладают рядом общих характеристик. Перед тем как рассмотреть каждый оператор по отдельности, познакомимся с их общим поведением.
Операторы выполняют действия над указанными значениями данных {операндами). Например, в операции 5*6 числа 5 и 6 являются операндами оператора умножения (*).
Отдельные операции могут быть объединены в одно сложное выражение. Например:
((width * height) - (Math.PI * radius * radius)) / 2
В случае очень больших выражений, возможно, более удобным окажется использование переменных для хранения промежуточных результатов, при этом код станет более понятным. Не забывайте давать переменным описательные имена. Например, при выполнении следующего кода получается такой же результат, как и в предыдущем выражении, однако данный код гораздо проще для восприятия:
var rad1us:1nt = 10:
var height:1nt = 25:
var drcleArea:Number = (Math.PI * radius * radius);
var cylindervolume:Number = drcleArea * height:
Количество операндов
Операторы иногда классифицируют по количеству принимаемых операндов (то есть требуемых для выполнения операции). Некоторые операторы языка ActionScript принимают один операнд, некоторые — два, а один оператор принимает даже три операнда:
-х// Один операнд
х * у// Два операнда
(х == у) ? "true result" : "false result" // Три операнда
Операторы, принимающие один операнд, называются унарными; операторы, принимающие два операнда, называются бинарными; операторы, принимающие три операнда, называются тернарными. Для наших целей мы будем рассматривать операторы с точки зрения выполняемых ими действий, а не с точки зрения количества принимаемых операндов.
Приоритет операторов
Приоритет операторов определяет, какая операция будет выполнена первой в выражении, состоящем из нескольких операторов. Например, если в одном выражении встречаются операторы умножения и сложения, первой будет выполнена операция умножения:
4 + 5*6 // Возвращает 34, поскольку 4 + 30 = 34
Выражение 4 + 5*6 вычисляется, как «4 плюс произведение 5 и 6», поскольку оператор * имеет более высокий приоритет, чем оператор +.
Подобным образом, если в одном выражении встречаются оператор «меньше чем» (<) и оператор конкатенации (+), операция конкатенации будет выполнена первой. Предположим, мы хотим сравнить две строки и отобразить результат сравнения при отладке программы. Не зная приоритетов операторов < и +, мы можем по ошибке использовать следующий код:
traceCresult: " + "а" < "Ь");
Из-за приоритетов операторов < и + код выдаст значение false, хотя мы ожидали увидеть несколько иной результат:
result: true
Чтобы определить результат выражения ” result: ” + ”а” < ”Ь”, среда Flash сначала выполнит операцию конкатенации (поскольку оператор + обладает более высоким приоритетом, чем <). Результатом конкатенации строки ”result: ” со строкой ” а ” является новая строка ” ге s u 11: а ”. После этого среда выполнения Flash сравнивает полученную строку со строкой ”Ь" и получает значение false, поскольку первый символ строки ’’result: а” находится дальше по алфавиту, чем символ ”Ь”.
Если вы сомневаетесь в приоритетах используемых операторов или хотите указать другую последовательность выполнения операций, используйте круглые скобки, которые обладают самым высоким приоритетом:
"result: " + ("а" < "Ь") // Возвращает: "result: true"
(4 + 5) * 6// Возвращает 54, поскольку 9 * б = 54
Хотя использовать круглые скобки совсем не обязательно, они помогают сделать сложное выражение более читабельным. Выражение:
х > У || У == z // х больше у или у равняется z
может оказаться сложным для восприятия без знания таблицы приоритетов. Оно становится гораздо более понятным, когда расставлены круглые скобки:
(х > у) || (у == z) // Гораздо лучше!
Ассоциативность операторов
Как уже известно, приоритет операторов определяет очередность их выполнения в выражении: операторы, обладающие более высоким приоритетом, выполняются раньше операторов с более низким приоритетом. Однако что произойдет, если в одном выражении встретятся несколько операторов с одинаковым уровнем приоритета? В данном случае применяются правила ассоциативности операторов, определяющих направление операции. Операторы могут обладать либо левой (выполняются слева направо), либо правой ассоциативностью (выполняются справа налево). Например, рассмотрим следующее выражение: b * с / d
Операторы * и / обладают левой ассоциативностью, поэтому операция умножения слева (Ь * с) выполняется первой. Предыдущий пример эквивалентен следующему выражению:
(Ь * с) / d
Здесь оператор = (оператор присваивания) обладает правой ассоциативностью, поэтому выражение а = b = с = d
читается, как «присвоить значение d переменной с, затем присвоить значение с переменной Ь, после чего присвоить значение Ь переменной а», как показано в следующем примере:
а = (Ь = (с = d))
Унарные операторы обладают правой ассоциативностью; бинарные операторы обладают левой ассоциативностью, за исключением операторов присваивания, обладающих правой ассоциативностью. Условный оператор ( ?:) также обладает правой ассоциативностью. Ассоциативность операторов достаточно понятна на интуитивном уровне, но если сложное выражение вернуло неожидаемое значение, воспользуйтесь дополнительными круглыми скобками, чтобы указать желаемый порядок выполнения операций. Более подробную информацию по ассоциативности операторов в языке ActionScript можно найти в документации от корпорации Adobe.
Типы данных и операторы
Операнды большинства операторов являются типизированными. В строгом режиме, если значение, используемое в качестве операнда, не соответствует типу данных данного операнда, компилятор сгенерирует ошибку на этапе компиляции и прекратит компиляцию кода. В стандартном режиме код будет скомпилирован и на этапе выполнения программы. Если тип операнда является примитивным, среда выполнения Flash преобразует значение к типу данных этого операнда (в соответствии с правилами, описанными в разд. «Преобразование в примитивные типы» гл. 8). Если тип операнда не является примитивным, то среда Flash сгенерирует ошибку на этапе выполнения.
Например, при компиляции программы в строгом режиме следующий код вызовет ошибку несоответствия типов, поскольку типом данных операндов оператора
деления (/) является Number, а значение ”50” не принадлежит типу данных Number:
"50" / 10
При компиляции программы в стандартном режиме предыдущий код не вызовет ошибку на этапе компиляции. Вместо этого на этапе выполнения программы среда Flash преобразует значение ”50” типа String к типу данных Number, получив в результате значение 50, и указанное выражение вернет значение 5.
Чтобы при компиляции предыдущего кода в строгом режиме не возникала ошибка, мы должны привести значение типа String к требуемому типу данных, как показано в следующем примере:
МитЬегСБО") / 10
Операнды некоторых операторов являются нетипизированными, что позволяет определять результат операции на этапе выполнения программы в зависимости от типов данных указанных значений. Оператор +, например, выполняет операцию сложения, если указаны два числовых операнда. Однако если одним из операндов является строка, то будет выполнена операция конкатенации.
Типы данных операндов всех операторов описаны в справочнике по языку ActionScript корпорации Adobe.
Обзор операторов
В табл. 10.2 перечислены операторы языка ActionScript с указанием значения приоритета, кратким описанием и типовым примером использования. Операторы с самым высоким приоритетом (находятся вверху таблицы) выполняются первыми. Операторы с одинаковым приоритетом выполняются в том порядке, в котором они следуют в выражении, обычно слева направо, кроме тех случаев, когда операторы обладают правой ассоциативностью (то есть выполняются справа налево).
Стоит отметить, что книга не содержит исчерпывающей информации об операторах языка ActionScript, за исключением операторов, описанных в спецификации Е4Х. Дополнительную информацию о каждом конкретном операторе можно найти в справочнике по языку ActionScript корпорации Adobe. Побитовые операторы описаны в статье «Using Bitwise Operators in ActionScript», находящейся по адресу http://www.moock.org/asdg/technotes/bitwise.
Таблица 10.2. Операторы языка ActionScript
Оператор
Приоритет
Описание
Пример
15
Многоцелевое использование. 1. Обращается к переменной или методу.
Отделяет имена пакетов от имен классов и других пакетов.
Обращается к дочерним элементам объекта XML или XMLList (спецификация Е4Х)
Обращение к переменной: product, price
Ссылка на класс:
flash.display.Sprite
Обращение к дочернему элементу объекта XML:
novel.TITLE
Оператор
Приоритет
Описание
Пример
[]
15
Многоцелевое использование. 1. Выполняет инициализацию массива.
Обращается к элементу массива.
Обращается к переменной или методу с использованием любого выражения, возвращающего строку.
Обращается к дочерним элементам или атрибутам объекта XML или XMLList (спецификация Е4Х)
Инициализация массива:
["apple", "orange", "pear"]
Обращение к четвертому элементу массива:
list[3]
Обращение к переменной: product["price"]
Обращение к дочернему элементу объекта XML:
novel["TrTLE"]
о
15
Многоцелевое использование.
Задает особый порядок выполнения операций (приоритет).
Вызывает функцию или метод.
Содержит фильтрующий предикат спецификации Е4Х
Выполнение операции сложения до операции умножения:
(5 + 4) * 2
Вызов функции:
trace()
Фильтрация объекта XMLList:
staff.*. (SALARY <= 35000)
@
15
Обращается к атрибутам XML- элемента
Получение всех атрибутов элемента novel:
novel. @*
15
Отделяет уточняющее пространство имен от имени
Уточнение имени orange в пространстве имен fruit:
fruit:: orange
15
Обращается к потомкам XML- элемента
Получение всех элементов-потомков элемента loan с именем DIRECTOR: loan..DIRECTOR
{х:у}
15
Создает новый объект и инициализирует его динамические переменные
Создание объекта с динамическими переменными width и height: {width:30, height:5}
new
15
Создает экземпляр класса
Создание экземпляра класса TextField: new TextField()
<тегхтег/>
15
Описывает XML-элемент
Создание XML-элемента с именем BOOK:
<ВООК>Essential Actionscript 3.0</ ВООК>
Х++
14
Прибавляет единицу к значению переменной х и возвращает ее прежнее значение (постфиксный инкремент)
Увеличение i на 1 и возврат прежнего значения i: i++
х—
14
Вычитает единицу из значения переменной х и возвращает ее прежнее значение (постфиксный декремент)
Уменьшение i на 1 и возврат прежнего значения i:
i—
++Х
14
Прибавляет единицу к значению переменной х и возвращает ее новое значение (префиксный инкремент)
Увеличение i на 1 и возврат результата: ++i
Таблица 10.2 (продолжение)
Оператор
Приоритет
Описание
Пример
—X
14
Вычитает единицу из значения переменной х и возвращает ее новое значение (префиксный декремент)
Уменьшение i на 1 и возврат результата: —i
—
14
Изменяет знак операнда (положительное значение становится отрицательным, а отрицательное — положительным)
var a:int = 10;
Присвоение -10 переменной b: var b:int = -а;
14
Выполняет операцию побитового НЕ
Сброс бита 2 значения переменной options: options &= ~4;
1
14
Возвращает логическое значение, противоположное его единственному операнду
Если значением переменной underl8 не является true, то выполняется тело условного оператора: if (!underl8) {
trace("You can apply for a credit card") }
delete
14
Многоцелевое использование.
Удаляет значение элемента массива.
Удаляет динамическую переменную экземпляра объекта.
Удаляет XML-элемент или атрибут
Создание массива:
var genders:Array = ["male","female"]
Удаление значения первого элемента:
delete genders[0];
Создание объекта:
var о:Object = new Object();
o.a = 10;
Удаление динамической переменной экземпляра а:
delete o.a;
Удаление элемента <TULE> из объекта XML, на который ссылается переменная novel:
delete novel.TITLE;
typeof
14
Возвращает простое строковое описание различных типов объектов. Используется только для обеспечения обратной совместимости с языками ActionScript 1.0 и ActionScript 2.0
Получение строкового описания типа значения 35:
typeof 35
void
14
Возвращает значение undefined
var o:Object = new Ob]ect(); o.a = 10;
Сравнение значения undefined co значением o.a: if (o.a == void) {
trace("o.a does not exist, or has no value");
}
*
13
Перемножает два числа
Умножение 4 на 6: 4*6
/
13
Делит левый операнд на правый операнд
Деление 30 на 5: 30/5
Оператор
Приоритет
Описание
Пример
%
13
Возвращает остаток (то есть модуль) от деления левого операнда на правый операнд
Остаток от деления 14 на 4: 14 % 4
+
12
Многоцелевое использование.
Складывает два числа.
Объединяет (конкатенирует) две строки.
Объединяет (конкатенирует) два объекта XML или XMLList
Результат 25 плюс 10:
25 + 10
Объединение строк "Не" и "Но" в строку "Hello":
"Не" + "Но"
Объединение двух объектов XML:
<JOB>Programmer</JOB> +
<AGE>52</AGE>
-
12
Вычитает правый операнд из левого операнда
Вычитание 2 из 12: 12-2
<<
11
Выполняет побитовый сдвиг влево
Сдвигает значение 9 на четыре бита влево:
9 « 4
>>
11
Выполняет побитовый знаковый сдвиг вправо
Сдвигает значение 8 на один бит вправо:
8 >> 1
>>>
11
Выполняет побитовый беззнаковый сдвиг вправо
Сдвигает значение 8 на один бит вправо, заполняя освободившиеся биты нулями:
8 >» 1
10
Проверяет справедливость условия, что левый операнд меньше правого. В зависимости от значений операндов возвращает true или false
Проверяет справедливость условия, что 5 меньше 6:
5 < 6
Проверяет, обладает ли символ "а" более низкой кодовой позицией, чем символ "z":
"а" < "z"
10
Проверяет справедливость условия, что левый операнд меньше либо равен правому операнду. В зависимости от значений операндов возвращает true или false
Проверяет справедливость условия, что 10 меньше либо равно 5: 10 <= 5
Проверяет, обладает ли символ "С" более низкой или такой же кодовой позицией, что и символ "D":
"С" <= "D"
10
Проверяет справедливость условия, что левый операнд больше правого. В зависимости от значений операндов возвращает true или false
Проверяет справедливость условия, что 5 больше 6:
5 > 6
Проверяет, обладает ли символ "а" более высокой кодовой позицией, чем символ "z":
"а" > "z"
10
Проверяет справедливость условия, что левый операнд больше либо равен правому операнду. В зависимости от значений операндов возвращает true или false
Проверяет справедливость условия, что 10 больше либо равно 5: 10 >= 5
Проверяет, обладает ли символ "С" более высокой или такой же кодовой позицией, что и символ "D":
"С" >= "D"
Таблица 10.2 (продолжение)
Оператор
Приоритет
Описание
Пример
as
Проверяет, принадлежит ли левый операнд типу данных, указанному правым операндом. Если это так, возвращается объект; в противном случае возвращается значение null
Var d:Date = new Date()
Проверяет, принадлежит ли значение переменной d типу данных Date: d as Date
is
Проверяет, принадлежит ли левый операнд типу данных, указанному правым операндом. Если это так, возвращается true; в противном случае возвращается false
var a:Array = new Array()
Проверяет, принадлежит ли значение переменной а типу данных Array: a is Array
in
Проверяет, обладает ли объект указанной открытой переменной или методом экземпляра
Var d:Date = new Date() Проверяет, обладает ли значение переменной d открытой переменной или открытым методом с именем getMonth: "getMonth" in d
instanceof
10
Проверяет, включает ли цепочка прототипов левого операнда правый операнд. В зависимости от значений операндов возвращает true или false
var s:Sprite = new Sprite() Проверяет, включает ли цепочка прототипов значения переменной s объект Displayobject:
s instanceof Displayobject
9
Проверяет, являются ли два выражения равными (условие равенства). В зависимости от значений операндов возвращает true или false
Проверяет, равняется ли выражение "hi" выражению "hello": "hi" == "hello"
i=
9
Проверяет, являются ли два выражения неравными (условие неравенства). В зависимости от значений операндов возвращает true или false
Проверяет, не равно ли выражение 3 выражению 3:
3 != 3
9
Проверяет, являются ли два выражения равными, не выполняя преобразование типов данных операндов к примитивным типам (условие строгого равенства). В зависимости от значений операндов возвращает true или false
Проверяет, равняется ли выражение "3" выражению 3. Этот код компилируется только в стандартном режиме: "3" === з
! = =
9
Проверяет, являются ли два выражения неравными, не выполняя преобразование типов данных операндов к примитивным типам (условие строгого неравенства). В зависимости от значений операндов возвращает true или false
Проверяет, не равно ли выражение "3" выражению 3. Этот код компилируется только в стандартном режиме: "3" !== 3
&
8
Выполняет операцию побитового И
Объединяет биты значений 15 и 4 с помощью операции побитового И: 15 & 4
Оператор
Приоритет
Описание
Пример
7
Выполняет операцию побитового исключающего ИЛИ
Объединяет биты значений 15 и 4 с помощью операции побитового исключающего ИЛИ: 15 л 4
1
6
Выполняет операцию побитового ИЛИ
Объединяет биты значений 15 и 4 с помощью операции побитового ИЛИ: 15 | 4
&&
5
Сравнивает результаты двух выражений с помощью операции логического И. Если значение левого операнда равно false или преобразуется в false, оператор возвращает левый операнд; в противном случае оператор возвращает правый операнд
var validllser: Boolean = true;
var validPassword: Boolean = false; Проверяет, имеют ли обе переменные — validllser и validPassword — значение true:
if (validllser && validPassword) { Ц Выполнить вход...
}
II
4
Сравнивает результаты двух выражений с помощью операции логического ИЛИ. Если значение левого операнда равно true или преобразуется в true, оператор возвращает левый операнд; в противном случае оператор возвращает правый операнд
var promotionalDay: Boolean = false; var registeredllser:Boolean = false; Проверяет, чтобы значение любой из переменных promotionalDay или registeredllser равнялось true if (promotionalDay 11 registeredllser) { Ц Отобразить дополнительное содержимое...
}
?:
3
Выполняет простое условие. Если значение первого операнда равно true или преобразуется в true, вычисляется и возвращается значение второго операнда. В противном случае вычисляется и возвращается значение третьего операнда
Вызывает один из двух методов в зависимости от того, хранит ли переменная soundMuted значение true: soundMuted ? displayVisualAlarm() : playAudioAlarm()
2
Присваивает значение переменной или элементу массива
Присваивает 36 переменной age: var age:int = 36;
Присваивает новый массив переменной seasons:
var seasons:Array = new Array();
Присваивает значение "winter" первому элементу массива seasons: seasons[0] = "winter";
2
Прибавляет (или конкатенирует) и присваивает результат
Прибавляет 10 к значению переменной п:
п += 10; Ц то же самое, что и n = п + 10;
Добавляет восклицательный знак в конец строки msg:
msg += "I"
Добавляет тег <AUTHOR> после первого тега <AUTHOR> потомка объекта novel:
novel.AUTHOR[0] += <AUTHOR>Dave Luxton </AUTHOR>;
Таблица 10.2 (продо.|жеппе)
Оператор
Приоритет
Описание
Пример
—=
2
Вычитает и присваивает результат
Вычитает 10 из значения переменной п:
п -= 10; Ц то же, что и п = п - 10;
*=
2
Умножает и присваивает результат
Умножает значение переменной п на 10:
п *= 10; Ц то же, что и п = п * 10;
/=
2
Делит и присваивает результат
Делит значение переменной п на 10: п /= 10; Ц то же, что и п = п / 10;
%=
2
Выполняет операцию деления по модулю и присваивает результат
Присваивает переменной п результат операции п % 4:
п %= 4; Ц то же, что и п = п % 4;
<< =
2
Сдвигает биты влево и присваивает результат
Сдвигает биты значения переменной п влево на две позиции:
п <<= 2; Ц то же, что и п = п « 2;
>> =
2
Сдвигает биты вправо и присваивает результат
Сдвигает биты значения переменной п вправо на две позиции:
п >>= 2; Ц то же, что и п = п » 2;
>>>=
2
Сдвигает биты вправо (беззнаковый сдвиг)и присваивает результат
Сдвигает биты значения переменной п вправо на две позиции, заполняя освободившиеся биты нулями:
п >>>= 2; Ц то же, что и п = п >>> 2;
&=
2
Выполняет операцию побитового И и присваивает результат
Объединяет биты значения переменной п со значением 4, используя операцию побитового И:
п &= 4 // то же, что и п = п & 4;
2
Выполняет операцию побитового исключающего ИЛИ и присваивает результат
Объединяет биты значения переменной п со значением 4, используя операцию побитового исключающего ИЛИ: п л= 4 // то же, что и п = п л 4;
1=
2
Выполняет операцию побитового ИЛИ и присваивает результат
Объединяет биты значения переменной п со значением 4, используя операцию побитового ИЛИ: п | = 4 // то же, что и п = п | 4;
1
Вычисляет сначала значение левого операнда, а затем правого
Инициализация и увеличение двух итераторов цикла:
for (var i:int = 0, j:int = 10; i < 5; i++, j++) {
Ц i принимает значения от 0 до 4
И j принимает значения от 10 до 14 }
Далее: управление списками данных
В этой главе были рассмотрены некоторые основные встроенные инструменты программирования языка ActionScript. В следующей главе мы познакомимся с еще одним важным инструментом языка ActionScript: массивами. Массивы используются для управления списками данных.
Массивы
Массивы хранят упорядоченные списки данных и управляют ими, являясь, таким образом, основным инструментом в последовательном, итерационном программировании. Мы используем массивы для решения различных задач, начиная с хранения данных, введенных пользователем, и заканчивая renepauncii раскрывающихся меню или описанием траектории движения вражеского космического корабля в игре. Фактически массив — это просто список элементов, похожий на список продуктов или на записи в вашей книге расходов. Только элементами в данном случае являются значения языка ActionScript.
Что такое массив?
Массив — это структура данных, которая объединяет несколько отдельных значений данных в упорядоченный список. Рассмотрим простой пример, который демонстрирует две отдельные строки и массив, содержащий две строки:
"cherries"//Отдельная строка
"peaches"//Еще одна строка
["oranges","apples"]//Массив, содержащийдвестроки
Массив может содержатьлюбое количествоэлементов, причем различных типов.
Массив даже может содержать другие массивы. Рассмотрим простой пример, демонстрирующий массив, который одновременно содержит и строки, и числа. Используя массив, можно представить список покупок, включающий названия покупаемых товаров и их необходимое количество:
["oranges". 6, "apples". 4, "bananas", 3]:
Хотя массив может хранить большое количество значений, важно понимать, что сам по себе он является отдельным значением данных. Массивы представляются экземплярами класса Array. По существу, массив может быть присвоен переменной или использован как часть сложного выражения:
// Присвоить массив переменной
var product:Array = ["ladles downhill skis", 475];
// Передать этот массив в функцию d1splау(product);
Анатомия массива
Каждый отдельный объект, хранящийся в массиве, называется элементом массива, при этом каждый элемент обладает уникальной числовой позицией (индексом), которая может использоваться для обращения к конкретному элементу.
Элементы массива
Каждому элементу массива, как и переменной, можно присвоить любое значение. Таким образом, весь массив похож на совокупность последовательно именованных переменных, но вместо уникального имени каждый элемент обладает номером (номером первого элемента является 0, а не 1). Для работы с соответствующими значениями мы обращаемся к элементам массива по их номеру.
Индексация элементов массива
Позиция элемента в массиве называется его индексом. Индекс элемента используется для присваивания или получения значения этого элемента, а также для выполнения различных действий над этим элементом. В некоторых методах обработки массивов индексы элементов используются для указания диапазона обрабатываемых элементов.
Кроме того, существует возможность добавлять и удалять элементы в начале, конце и даже в середине массива. Массив может иметь промежутки (то есть некоторые элементы могут быть незаполненными). Элементы могут размещаться в позициях 0 и 4, при этом совсем не обязательно, чтобы элементы присутствовали в позициях 1, 2 и 3. Массивы с промежутками называются разреженными массивами.
Размер массива
В любой момент времени своего существования каждый массив содержит определенное количество элементов (как незаполненных, так и заполненных). Количество элементов в массиве называется длиной массива. Это понятие будет рассмотрено чуть далее.
Создание массивов
Для создания нового массива применяется литерал массива или оператор new (то есть new Array ( ) ).
Массивы в других языках программирования. Практически каждый язык программирования высокого уровня поддерживает массивы или похожие на них конструкции. При этом в способах реализации массивов в разных языках есть различия. Например, многие языки не позволяют хранить в массиве данные разных типов. Во многих языках массив может содержать либо числа, либо строки, но хранить в одном массиве значения обоих типов не допускается. Интересно, что в языке С отсутствует примитивный тип данных string. Вместо этого поддерживается односимвольный тип данных char; строки считаются составным типом данных и реализуются в виде массива, состоящего из элементов типа char.
В языке ActionScript размер массива изменяется автоматически при добавлении или удалении элементов. Во многих языках размер массива должен быть указан при первом объявлении, или задании размерности, массива (то есть в тот момент, когда выделяется память для хранения данных массива).
Языки различаются и по тому, что происходит при попытке обращения к элементу, находящемуся за границами (пределами) массива. Если программа попытается присвоить значение элементу, находящемуся за пределами существующих границ массива, язык ActionScript добавит недостающие элементы. Если программа попытается обратиться к элементу, индекс которого лежит за пределами границ массива, то язык ActionScript вернет значение undefined, тогда как язык С, например, не обратит никакого внимания на допустимость указанного номера элемента. Язык программирования С позволяет программе получать и присваивать значения элементам, находящимся за пределами границ массива, что обычно приводит к получению бессмысленных данных, не являющихся частью массива, или к перезаписыванию других данных в памяти.
Создание массивов с помощью литералов
Литерал массива состоит из квадратных скобок, обозначающих начало и конец массива, и элементов, которые перечисляются через запятую внутри квадратных скобок. Вот его обобщенный синтаксис:
[выражение!, выражение2, выражениеЗ[\
Сначала вычисляются результаты указанных выражений, а затем полученные результаты присваиваются элементам определяемого массива. В литерале массива могут использоваться любые допустимые выражения, включая вызовы функций, переменные, литералы и даже другие массивы (массив, содержащийся в другом массиве, называется вложенным или двумерным).
Рассмотрим несколько примеров:
// Простые числовые элементы [4, 5, 63];
// Простые строковые элементы ["apple", "orange", "pear"]
// Числовые выражения с операцией■
[1, 4, 6 + 10]'
// В качестве элементов выступают значения переменных и строки [flrstName, lastName, "tall", "skinny"]
// Вложенный литерал массива ["month end days", [31, 30, 28]]
Создание массивов с помощью оператора new
Для создания массива с помощью оператора new используется следующий обобщенный код:
new кггау (аргументы)
Результат выполнения этого кода зависит от количества и типа аргументов, передаваемых в конструктор класса Array. Если в конструктор передается несколько
аргументов или один нечисловой, то каждый аргумент становится значением отдельного элемента в новом массиве. Например, следующий код создаст массив с тремя элементами:
new Array("sun". "moon", "earth")
Если в конструктор класса Array передается один числовой аргумент, то будет создан массив с указанным количеством незаполненных элементов, значения которым могут быть присвоены позднее (создание подобного массива с помощью литерала оказалось бы достаточно утомительным занятием). Например, следующий код создает массив, состоящий из 14 незаполненных элементов:
new Array(14)
Аргументами, передаваемыми в конструктор класса Array, могут быть любые допустимые выражения, включая составные выражения. Например, следующий код создает массив, первым элементом которого является число 11, а вторым элементом — число 50:
var x:1nt = 10:
var y:1nt = 5:
var numbers:Array = new Array(x + 1, x * y):
Для прямого сравнения следующий код создает массивы из предыдущего раздела, однако вместо литералов массива используется оператор new:
new Array(4. 5. 63)
new Array("apple". "orange", "pear")
new Arrayd. 4, 6 + 10)
new Array(flrstName, lastName, "tall", "skinny")
new ArrayCmonth end days", new Array(31. 30, 28))
Обращение к элементам массива
После создания массива мы, разумеется, захотим получать или изменять значения его элементов. Для этих целей применяется оператор доступа к массиву — [ ].
Получение значения элемента
Для обращения к отдельному элементу массиву используется переменная, ссылающаяся на этот массив, а за ней в квадратных скобках указывается индекс элемента, как показано в следующем коде:
массив[номерЭлемента]
В предыдущем коде массив обозначает ссылку на массив (обычно это переменная, значением которой является массив), а номерЭлемента — это целое число, определяющее индекс элемента. Номером первого элемента является 0, а номер последнего элемента на единицу меньше длины массива. Если указанный номер элемента превышает последний допустимый номер элемента, среда выполнения Flash вернет значение undefined (поскольку указанный индекс находится за пределами границ массива).
Попробуем получить несколько значений элементов. Следующий код создает массив с помощью литерала массива и присваивает его переменной trees:
var trees;Array = ["birch", "maple", "oak", "cedar"];
Следующий код присваивает переменной firstTree значение первого элемента массива trees ("birch"):
var firstTree;String = trees[0];
Следующий код присваивает значение третьего элемента ("oak") переменной f avor it eTree (не забывайте, что индексы начинаются с 0, поэтому элемент с индексом 2 является третьим элементом массива!):
var favor!teTree:String = trees[2];
Теперь начинается самое интересное. Поскольку индекс элемента можно задавать с помощью любого выражения, возвращающего число, для указания индекса элемента мы можем запросто использовать переменные или сложные выражения вместо обычных чисел. Например, следующий код присваивает значение четвертого элемента ("cedar") переменной lastTree: var i = 3;
var lastTree:Str!ng = freest!];
В качестве индексов массива мы можем использовать даже выражения вызова, возвращающие числовые значения. Например, следующий код присваивает переменной randomTree случайно выбранный элемент массива trees, индексом которого является случайное число в диапазоне от 0 до 3:1
var randomTree;String = trees[Math.floor(Math.random( ) * 4)];
Прекрасно. Вы можете использовать подобный подход для выбора произвольного вопроса из массива, в котором хранятся тривиальные вопросы, или для выбора случайной карты из массива, представляющего колоду игральных карт.
Обратите внимание, что обращение к элементу массива очень похоже на обращение к значению переменной. Элементы массива могут являться частью любых составных выражений, как показано в следующем примере:
var ages:Array = [12. 4. 90];
var totalAge:Number = ages[0] + ages[l] + ages[2]; // Сумма значений
// элементов массива
Суммирование значений элементов массива вручную никак нельзя назвать образцом оптимизированного кода. Позднее мы познакомимся с более удобным способом последовательного обращения к элементам массива.
Присваивание значения элементу массива
Чтобы присвоить значение элементу массива, мы используем выражение массив [ но- мерЭлемента ] в качестве левого операнда выражения присваивания. Это демонстрирует следующий код:
// Создание массива
var cities:Array = ["Toronto". "Montreal". "Vancouver". "Waterloo"];
// массив cities в настоящий момент выглядит так:
// ["Toronto". "Montreal". "Vancouver". "Waterloo"]
// Присваиваем значение первому элементу массива
cities[0] = "London":
// Массив cities теперь выглядит так:
// ["London". "Montreal". "Vancouver". "Waterloo"]
// Присваиваем значение четвертому элементу массива
cities[3] = "Hamburg":
// Теперь массив cities выглядит так:
// ["London", "Montreal". "Vancouver", "Hamburg"]
// Присваиваем значение третьему элементу массива
cities[2] = 293.3: // Обратите внимание, что изменение типа данных
// значения элемента не вызывает никаких проблем
// Массив cities теперь выглядит так:
// ["London", "Montreal", 293.3, "Hamburg"]
Стоит отметить, что при присваивании значения элементу массива в качестве индекса мы можем использовать любое неотрицательное числовое выражение:
var 1:1 nt = 1;
// Присваиваем значение элементу с индексом 1 cities[i] = "Tokyo";
// Массив cities теперь выглядит так: ["London", "Tokyo", 293.3, "Hamburg"]
Определение размера массива
У всех массивов есть переменная экземпляра length, обозначающая текущее значение элементов в массиве (включая незаполненные элементы). Для обращения к переменной массива length используется оператор «точка» (.), как показано в следующем коде:
массив.1ength
Рассмотрим несколько примеров:
var list:Array = [34, 45, 57]:
tracetlist.length);// Выводит: 3
var words:Array = ["this", "that", "the other"]:
trace(words.length):// Выводит: 3
var cards:Array = new Array(24): // Обратите внимание, что в конструктор
// класса Array передается один числовой
// аргумент
trace(cards.length):// Выводит: 24
Значение переменной массива length всегда на единицу больше индекса последнего элемента данного массива. Например, длина массива, элементы которого имеют индексы 0,1 и 2, равна 3. Длина массива, элементы которого имеют индексы 0,1,
2 и 50, равна 51. Именно 51. Несмотря на то что элементы с индексами в диапазоне от 3 до 49 являются незаполненными, они все равно учитываются при определении длины массива. Индекс последнего элемента массива всегда равен результату выражения массив. length - 1 (поскольку индексы начинаются с 0, а не с 1). Таким образом, для обращения к последнему элементу массива массив применяется следующий код:
массив\_массив. length - 1]
При добавлении и удалении элементов значение переменной массива length обновляется автоматически, отражая внесенные изменения. На самом деле мы даже можем сами присвоить переменной length значение, чтобы добавить или удалить элементы в конце массива. Этим переменная length массива отличается от переменной length класса String, которая доступна только для чтения. Уменьшение значения переменной length массива приводит к удалению всех элементов, индексы которых превышают новое значение.
С помощью переменной массива length можно создавать циклы для обхода всех элементов массива. Обход элементов массива в цикле является фундаментальной задачей программирования. Чтобы получить представление о возможностях, открывающихся при совместном использовании циклов и массивов, изучите листинг 11.1, в котором осуществляется обход элементов массива soundtracks с целью нахождения позиции элемента со значением "hip hop".
Листинг 11.1. Поиск значения в массиве
// Создание массива
var soundtracks:Array = ["electronic", "hip hop",
"pop", "alternative", "classical"];
// Проверять каждый элемент, чтобы узнать, содержит ли он значение "hip hop" for (var 1:1nt = 0; 1 < soundtracks.length: 1++) {
traceCNow examining element: " + 1);
1f (soundtracks[1] == "hip hop") {
traceCThe location of 'hip hop' 1s Index: " + 1): break;
}
}
Улучшим код листинга 11.1, превратив его в универсальный метод для поиска, который позволит искать произвольный элемент в любом массиве. Если элемент найден, то данный метод вернет позицию найденного элемента в массиве. В противном случае будет возвращено значение -1. Листинг 11.2 демонстрирует этот код.
Листинг 11.2. Универсальная функция для поиска элемента в массиве
public function searchArray (theArray:Array, searchElement:Object): 1 nt {
// Проверять каждый элемент, чтобы определить, совпадает ли
// его значение со значением параметра searchElement
for (var 1:1nt = 0: 1 < theArray.length: 1++) {
1f (theArray[1] == searchElement) {
return 1;
}■
}
return -1;
}.
Чтобы проверить, есть ли имя "Dan" среди имен массива userNames, который представляет собой гипотетический массив с именами авторизованных пользователей, мы можем воспользоваться нашим новым методом для поиска в массиве:
1f (searchArray(userNames, "Dan") == -1) { traceCSorry, that username wasn't found");
} else {
trace("Wei come to the game, Dan.");
Метод searchArray() демонстрирует код, который необходим для выполнения обхода элементов массива в цикле, однако этот код не предназначен для использования в реальной программе. Для определения индекса заданного элемента в реальной программе используйте методы indexOf() и lastIndexOf() класса Array.
В оставшейся части этой главы речь пойдет о механизмах работы с массивами, включая использование методов класса Array.
Добавление элементов в массив
Добавить элементы в массив можно одним из следующих способов.
Присвоить значения новому элементу, индекс которого равен значению длины массива или больше его.
Увеличить значение переменной массива length.
Вызвать над массивом методы push ( ), unshift ( ), splice ( ) или concat ( ).
Рассмотрим более подробно перечисленные способы.
Непосредственное добавление новых элементов
Чтобы добавить новый элемент к существующему массиву по указанному индексу, мы просто присваиваем значение этому элементу. Этот способ продемонстрирован в следующем коде:
// Создаем массив и добавляем в него три значения var fruits:Array = ["apples", "oranges", "pears"];
// Добавляем четвертое значение fru1ts[3] = "tangerines";
Размещать новый элемент сразу за последним элементом массива не обязательно. Если между новым элементом и концом массива можно разместить несколько элементов, среда выполнения Flash автоматически создаст неопределенные элементы для промежуточных индексов:
// Оставить элементы с индексами от 4 до 38 незаполненными fru1ts[39] = "grapes";
trace(fruits[12]); // Выводит: undefined
Если элемент уже существует, его значение будет заменено новым значением. Если указанный элемент не существует, то он будет добавлен в массив.
Переменная length
Чтобы расширить массив, не присваивая значений новым элементам, можно просто увеличить значение переменной length, а среда выполнения Flash добавит необходимое количество элементов для достижения указанной длины:
// Создаем массив с тремя элементами var colors = ["green", "red", "blue"];
// Добавляем в массив 47 незаполненных элементов с индексами от 3 до 49 colors.length = 50;
Этот подход можно использовать для создания определенного количества незаполненных элементов, которые будут хранить собираемые данные, например результаты тестов, выполняемых студентами. Хотя элементы являются незаполненными, они позволяют определить, что ожидаемое значение еще не было присвоено. Например, цикл, отображающий результаты тестов на экране, может выводить стандартное сообщение No Score Available (Результат недоступен) для незаполненных элементов.
Методы класса Array
Для выполнения более сложных операций по добавлению элементов можно использовать методы класса Array.
Метод push()
Метод push ( ) добавляет один или более элементов в конец массива. Этот метод автоматически добавляет данные сразу за последним нумерованным элементом массива, поэтому вам не нужно беспокоиться о текущей длине массива. Кроме того, метод push ( ) позволяет добавлять в массив сразу несколько элементов. Метод имеет следующий обобщенный вид:
массив, push (элемент!, элемент2... элемент);
В предыдущем коде массив — это ссылка на объект класса Array, а элемент!, эле- мент2. . . элементп — это список элементов, разделенных запятыми, которые добавляются в конец массива и представляют новые элементы. Вот несколько примеров:
// Создаем массив с двумя переменными var menuitems:Array = ["home", "quit"];
// Добавляем элемент
menuItems.push("products");
// Массив menuitems теперь выглядит так: ["home", "quit", "products"]
// Добавляем два новых элемента menuitems.push("serv1ces", "contact"); // Теперь массив menuitems выглядит так: // ["home", "quit", "products", "services", "contact"]
Метод push ( ) возвращает новую длину измененного массива (то есть значение переменной length):
var Hst:Array = [12, 23, 98];
trace(myL1st.push(28, 36));
// Добавляет в массив 11st значения 28 и 36 и выводит 5
Обратите внимание, что элементы, добавляемые в список, могут быть представлены любым выражением. Выражение вычисляется до того, как элемент будет добавлен в список:
var temperature;1nt = 22;
var sky:Str1ng = "sunny";
var weatherLIsting;Array = new Array( );
// Добавляем значения 22 и "sunny" в массив weatherL1st1ng.push(temperature, sky);
Проталкивание, выталкивание и стеки. Метод push ( ) берет свое название из концепции программирования, которая называется стеком. Стек может рассматриваться как вертикальный массив, аналогичный стопке тарелок. Если вы часто посещаете кафетерии или рестораны с буфетами, вам должны быть знакомы пружинные подставки, которые удерживают тарелки для клиентов. Когда появляются чистые тарелки, они буквально проталкиваются на вершину стека, при этом те тарелки, которые уже находились в подставке, опускаются ниже. Когда клиент выталкивает тарелку с вершины стека, он забирает тарелку, которая была добавлена в стек самой последней. Этот тип стека называется «последним пришел — первым вышел» (last-in-first-out — LIFO) и обычно применяется для реализации, например, списков предыстории. Например, если вы нажмете кнопку Назад в своем браузере, то откроется предыдущая просмотренная страница. Если снова нажать кнопку Назад, то откроется страница, которая просматривалась перед предыдущей, и т. д. Такое поведение достигается путем проталкивания URL-адреса каждой просматриваемой страницы в стек и последующего выталкивания адреса из стека при нажатии кнопки Назад.
Примеры LIFO-стеков можно найти и в реальной жизни. Человек, последним сдавший багаж при посадке на самолет, после приземления самолета обычно получает свой багаж первым, поскольку разгрузка багажа осуществляется в порядке, обратном погрузке. Пассажир, сдавший свой багаж первым, после приземления самолета будет вынуждена простоять у ленты багажного транспортера дольше всех.
Стек типа «первым пришел — первым вышел» (first-in-first-out — FIFO) является более эгалитарным. В основе его функционирования лежит обслуживание в порядке поступления. Примером FIFO-стека является очередь в банке. FIFO-стек работает не с последним элементом массива, а с первым. После этого первый элемент массива удаляется, а все оставшиеся элементы «продвигаются» точно так же, как
продвигается очередь, когда человек, стоявший перед вами, «удаляется» (то есть либо он покинул очередь после того, как был обслужен, либо он решил покинуть очередь раньше времени, устав от ожидания). Таким образом, слово ^проталкивать» обычно применяется в отношении LIFO-стека, тогда как слово «добавлять» применяется в отношении FIFO-стека. В любом случае элементы добавляются в «конец» стека. Разница заключается в том, какой конец массива хранит элемент для следующей операции.
Метод unshifU)
Метод unshift ( ) во многом похож на метод push ( ), однако он добавляет один или несколько элементов в начало массива, смещая существующие элементы для освобождения пространства (то есть увеличивает индексы существующих элементов, чтобы разместить новые элементы в начале массива). Метод unshi f t ( ) имеет следующий обобщенный вид:
массив.unshift(элемент!, элемент2. .. элементп);
В приведенном коде массив — это ссылка на объект класса Array, а элемент!, эле- мент2. . . элементп — список элементов, разделенных запятыми, которые добавляются в начало массива и представляют новые элементы. Обратите внимание, что элементы добавляются в том порядке, в котором они передаются в метод. Рассмотрим несколько примеров:
var versions:Array = new Array( );
versions[0] = 6:
versions.unshift(5);// Массив versions выглядит так: [5, 6]
versions.unshift(2.3.4); // Массив versions выглядит так: [2, 3. 4. 5. 6]
Метод unshift ( ), как и метод push ( ), возвращает длину увеличенного массива.
Метод splice()
Метод splice ( ) позволяет добавлять в массив или удалять из него элементы. Этот метод обычно применяется для вставки элементов в середину массива (при этом элементы, находящиеся после точки вставки, перенумеровываются, чтобы освободить пространство для добавляемых элементов) или для удаления элементов из середины массива (при этом перенумеровываются элементы, находящиеся после удаляемых элементов, для ликвидации образовавшегося промежутка). Если обе задачи выполняются одновременно за один вызов метода splice ( ), некоторые элементы массива фактически заменяются новыми элементами (хотя количество добавляемых и удаляемых элементов может не совпадать). Метод sp 1 i се ( ) имеет следующий обобщенный вид:
массив.$рД"\се(начальныйИндекс, количествоУдаляемыхЭлементов, элемент!, элемент2... элементп):
В предыдущем коде массив — это ссылка на объект класса Array; начальныйИн- декс — число, определяющее индекс, начиная с которого будут выполняться удаление и необязательное добавление элементов (помните, что индексом первого элемента является 0); количествоУдаляемыхЭлементов — необязательный аргумент, который определяет количество удаляемых элементов (включая элемент с индексом
начальныйИндекс\ Если аргумент количествоУдаляемыхЭлементов опущен, все элементы, расположенные после элемента с индексом начальныйИндекс, включая сам элемент с данным индексом, будут удалены. Необязательные параметры элемент!f эле- мент2. . . элемент — объекты, добавляемые в массив в качестве элементов, начиная с индекса начальныйИндекс.
Листинг 11.3 демонстрирует разносторонность метода splice ( ).
Листинг 11.3. Использование метода splice() класса Array
// Создание массива
var months:Array = new Array("January", "Friday",
"April", "May", "Sunday", "Monday", "July"):
// С нашим массивом что-то не в порядке. Подправим его.
// Во-первых, избавимся от элемента "Friday".
months.spliced,1):
// Массив months теперь выглядит так:
// ["January", "April", "May", "Sunday", "Monday", "July"]
// Теперь добавим два месяца перед элементом "April".
// Обратите внимание, что мы ничего не удаляем (deleteCount равен 0).
months.spliced, 0, "February", "March"):
// Массив months теперь выглядит так:
// ["January", "February", "March", "April",
// "May", "Sunday", "Monday", "July"]
// Наконец, удалим элементы "Sunday" и "Monday", одновременно
// добавив элемент "June".
months.spliced, 2, "June"):
// Массив months теперь выглядит так:
// ["January", "February", "March", "April", "May", "June", "July"]
// Теперь, когда массив months приведен в порядок, обрежем его,
// чтобы остались только названия месяцев первого квартала года,
// удалив все элементы, начиная с индекса 3 (то есть "April").
months.spliced): // Теперь массив months выглядит так:
// ["January", "February", "March"]
Метод splice ( ) возвращает массив удаленных элементов. Таким образом, этот метод можно использовать для извлечения набора элементов из массива:
var letters:Array = ["a", "b", "с", "d"]:
traceCletters.spliced, 2)); // Выводит: "b.c"
// Массив letters теперь выглядит так:
// ["a", "d"]
Если никакие элементы не удалены, то метод splice ( ) возвращает пустой массив (то есть массив без элементов).
Метод concatt)
Метод concat ( ) объединяет два или более массива в один новый массив, возвращаемый данным методом. Метод имеет следующий обобщенный вид: исходныйМассив.concat(списокЭлементов)
Метод concat ( ) один за другим добавляет элементы, содержащиеся в списке списокЭлементов, в конец массива исходныйМассив и возвращает результат в виде нового массива, оставляя массив исходныйМассив нетронутым. Обычно возвращаемый массив сохраняется в переменной. Следующий пример демонстрирует простые числа, добавляемые в массив в качестве элементов:
var UstLArray = new ArrayCH, 12. 13);
var Hst2:Array = Hstl.concat(14. 15); // Массив I1st2 теперь выглядит так: // [11. 12. 13. 14. 15]
В следующем примере метод conca t ( ) используется для объединения двух массивов:
var guests;Array = ["Panda". "Dave"];
var reg1steredPlayers:Array = ["Gray", "Doomtrooper". "TRK9"];
var al Users;Array = reglsteredPlayers.concat(guests);
// Массив allUsers теперь выглядит так:
// ["Gray". "Doomtrooper". "TRK9". "Panda", "Dave"]
Обратите внимание, что при добавлении массива guests к массиву allUsers метод concat ( ) разбил массив guests на составляющие, или, иначе говоря, «выпрямил» его. Иными словами, каждый элемент массива guests был добавлен к массиву allUsers по отдельности. Тем не менее метод concat ( ) не «выпрямляет» вложенные массивы (элементы, которые сами являются массивами внутри основного массива), как показано в следующем коде:
var x:Array = [1. 2. 3];
var y:Array = [[5. 6]. [7. 8]];
var z:Array = x.concat(y); // Результат: [1. 2» 3. [5. 6]. [7. 8]].
// Элементы массива у с индексами 0 и 1 // не были «выпрямлены»
Удаление элементов из массива
Для удаления элементов из массива можно воспользоваться одним из следующих способов.
Удалить определенный элемент с помощью оператора delete.
Уменьшить значение переменной массива length.
Вызвать методы pop ( ), shift ( ) или splice ( ) над массивом.
Рассмотрим подробнее перечисленные способы.
Оператор delete
Оператор delete присваивает элементу массива значение undefined, используя следующий синтаксис:
delete массив1индек<\
В этом коде массив — это ссылка на массив, а индекс — номер или имя элемента, которому должно быть присвоено значение undefined. Название оператора
delete, откровенно говоря, вводит в заблуждение. Этот оператор не удаляет нумерованный элемент из массива; он просто присваивает указанному элементу значение undefined. Таким образом, операция delete аналогична присваиванию значения undefined элементу массива. В этом легко удостовериться, сравнив значения переменной массива length до и после удаления одного из его элементов:
var 11st = ["а", "b", "с"];
tracedlst.length); // Выводит: 3
delete I1st[2];
tracedlst.length); // По-прежнему отображает 3. Элемент с индексом 2 // вместо значения "с" содержит значение undefined, // но все же этот элемент существует
Чтобы удалить элементы на самом деле, используйте метод splice ( ) (для удаления элементов из середины массива) или методы shift ( ) и pop ( ) (для удаления элементов с начала или конца массива соответственно).
Переменная length
Чтобы удалить элементы в конце массива (то есть обрезать массив), можно присвоить переменной массива length значение меньше, чем ее текущее значение:
var toppings:Array = ["pepperoni", "tomatoes",
"cheese", "green pepper", "broccoli"]:
toppings.length = 3:
trace(topplngs): // Выводит: "pepperoni, tomatoes, cheese"
// Мы обрезали элементы с индексами 3 и 4 (последние два)
Методы класса Array
Массивы обладают несколькими встроенными методами для удаления элементов. Мы уже видели, как с помощью метода splice ( ) можно удалять несколько элементов из середины массива. Методы pop ( ) и shift ( ) применяются для удаления элементов в конце или начале массива.
Метод рор()
Метод pop ( ) является полной противоположностью метода push ( ): он удаляет последний элемент массива. Синтаксис метода pop ( ) очень прост:
массив.pop( )
Не знаю почему, но процесс «выталкивания» массива у меня всегда вызывает улыбку. Тем не менее метод pop ( ) уменьшает на единицу значение переменной массива length и возвращает значение удаляемого элемента. Например:
var numbers:Array = [56, 57, 58];
trace(numbers.pop( )); // Выводит: 58 (значение удаленного элемента)
// Массив numbers теперь выглядит так: [56, 57]
Как было отмечено ранее, метод pop ( ) часто используется совместно с методом push ( ) для выполнения операций над LIFO-стеком.
Метод shllt()
Помните метод unshift ( ), который применяется для добавления элемента в начало массива? Познакомьтесь с его близким другом — методом shift ( ), который удаляет элемент с начала массива: массив.sh1ft( )
Как и pop ( ), метод shift ( ) возвращает значение удаляемого элемента. Все оставшиеся элементы в том же порядке продвигаются к началу массива. Например: var sports:Array = ["quake", "snowboarding", "Inline skating"]: trace(sports.shift( )); // Выводит: quake
// Массив sports теперь выглядит так:
// ["snowboarding", "Inline skating"]
trace(sports.sh1ft( )): // Выводит: snowboarding
// Массив sports теперь выглядит так:
// ["Inline skating"]
Поскольку метод shif t ( ) на самом деле удаляет элемент, он оказывается более полезным для удаления первого элемента из массива, чем оператор delete.
Метод splice()
В одном из предыдущих разделов мы познакомились с возможностями метода splice ( ) по удалению из массива и добавлению в него элементов. Поскольку метод splice ( ) был рассмотрен достаточно подробно, мы не будем пересматривать его в этом разделе. Тем не менее для информации следующий код демонстрирует возможности метода splice ( ) по удалению элементов:
var letters:Array = ["a", "b", "с", "d", "е", "f"]:
// Удаляем элементы с индексами 1, 2 и 3, оставляя ["а", "е", "f"] letters.spliced, 3):
// Удаляем все элементы, начиная с индекса 1, оставив только ["а"] letters, spliced);
Проверка содержимого массива с помощью метода tostringt)
Метод toS tring ( ), характерный для всех объектов, возвращает строковое представление того объекта, над которым он был вызван. В случае с объектом класса Array метод toString ( ) возвращает список элементов массива, преобразованных в строки и разделенных запятыми. Метод toString ( ) можно вызывать явно, как показано в следующем коде:
массив.toStrlng( )
Однако обычно метод toString ( ) не вызывается явно; вместо этого он вызывается автоматически всякий раз, когда массив массив используется в строковом контексте. Например, выражение trace (массив) после отладки отобразит список значений элементов массива, разделенных запятыми. Выражение trace (массив') эквивалентно выражению trace (массив. toString ( ) ).
Метод toString ( ) часто оказывается полезным при отладке, когда необходимо получить быструю, неформатированную информацию об элементах, содержащихся в массиве. Например:
var sites = ["www.moock.org", "www.adobe.com", "www.ore1lly.com"]; traceCThe sites array 1s " + sites);
Стоит отметить, что метод j oin ( ) предоставляет более широкие возможности по форматированию информации, чем toString ( ). Более подробные сведения можно получить в справочнике по языку ActionScript корпорации Adobe.
Многомерные массивы
До сих пор мы рассматривали только одномерные массивы, которые аналогичны одной строке или одному столбцу в электронной таблице. Что же делать в том случае, если мы захотим создать эквивалент электронной таблицы с несколькими строками и столбцами? Нам понадобится второе измерение. Язык ActionScript в прямом виде поддерживает только одномерные массивы, однако мы можем имитировать многомерный массив, создав массивы внутри массивов. Другими словами, мы можем создавать массивы, элементами которых являются другие массивы (иногда называемые вложенными?).
Простейшим типом многомерного массива является двумерный массив, элементы которого концептуально организованы в виде сетки со строками и столбцами. Первое измерение массива представляет строки, а второе — столбцы.
Рассмотрим, как работает двумерный массив, на практическом примере. Предположим, мы обрабатываем заказ на три товара, каждый из которых имеет количество и цену. Мы хотим имитировать электронную таблицу с тремя строками (по одной строке для каждого товара) и двумя столбцами (один столбец для количества, другой — для цены). Мы создаем отдельный массив для каждой строки, при этом каждый элемент строки представляет значение в соответствующем столбце:
var rowkArray = [6, 2.99]; // Количество 6, Цена 2.99
var row2:Array = [4, 9.99]; // Количество 4, Цена 9.99
var row3:Array = [1, 59.99]; // Количество 1, Цена 59.99
Затем мы помещаем созданные строки в массив-контейнер с именем spreadsheet: var spreadsheet:Array = [rowl, row2, row3];
Теперь мы можем найти общую сумму заказа, перемножив значения количества и цены для каждой строки и сложив получившиеся произведения. Для обращения к элементам двумерного массива используются два индекса (один индекс обозначает строку, другой — столбец). Выражение spreadsheet [0], например, представляет первую строку массива, состоящего из двух столбцов. Таким образом, чтобы обратиться ко второму столбцу первой строки массива spreadsheet, мы используем выражение spreadsheet [0] [1] (оно вернет значение 2,99). Общая стоимость товаров, содержащихся в массиве spreadsheet, вычисляется следующим образом:
// Создаем переменную для хранения общей стоимости заказа, var total:Number;
// Теперь определяем стоимость заказа. Для каждой строки перемножаем
// значения столбцов, а полученное произведение прибавляем к значению
// переменной total.
for (var 1:1nt = 0; 1 < spreadsheet.length; 1++) {
total += spreadsheetE1 Zl E0] * spreadsheetE1J El]:
}
trace(total): // Выводит: 117.89
Переходим к событиям
В этой главе дано общее представление о массивах, однако предложенная информация не является исчерпывающей. Класс Array обладает множеством полезных методов для переупорядочения и сортировки элементов массива, фильтрации элементов, преобразования элементов в строки и извлечения массивов из других массивов. Более детальное описание класса Array можно найти в справочнике по языку ActionScript корпорации Adobe.
Следующей темой изучения является обработка событий — встроенная система для управления взаимодействием между объектами.
События и обработка событий
Событие — это заслуживающее внимания явление, возникающее на этапе выполнения программы и обладающее потенциалом для инициирования ответной реакции. В языке ActionScript события можно разбить на две категории: предопределенные события, которые описывают изменения состояния среды выполнения, и пользовательские события, описывающие изменения состояния программы. К предопределенным событиям, например, можно отнести щелчок кнопкой мыши или завершение операции загрузки файла. В отличие от этого, к пользовательским событиям можно отнести завершение игры или отправку ответов на вопросы экзамена.
В ActionScript события используются повсеместно. На самом деле в программе, написанной полностью на языке ActionScript, сразу после того, как метод-конструктор основного класса завершает свою работу, выполнение оставшейся части кода инициируется посредством событий. Таким образом, ActionScript поддерживает событийную модель с широкими возможностями, составляющую основу не только для предопределенных, но и для пользовательских событий.
Событийная модель языка ActionScript основана на спецификации W3C Document Object Model (DOM) Level 3, доступной по адресу http://www.w3.org/TR/DOM-Level-3-Events.
В этой главе рассматриваются основы событийной модели языка ActionScript, включая обработку предопределенных событий и реализацию пользовательских событий в программе. Стоит отметить, однако, что в этой главе описываются только основы работы с событиями. Позднее, в гл. 21, будет рассказано, каким образом событийная модель языка ActionScript обеспечивает отображение объектов (объектов, представляющих экранное содержимое). Затем в гл. 22 будет описано все многообразие предопределенных событий пользовательского ввода.
Основы обработки событий в ActionScript
Для обработки событий (реакции на события) в программе на языке ActionScript используются приемники событий. Приемник событий — это функция или метод, которые выполняются при возникновении определенного события. Они называются так потому, что, по существу, ожидают возникновения событий (или, иначе говоря, принимают возникающие события). Чтобы сообщить программе, что возникло определенное событие, среда выполнения Flash вызывает все приемники событий, которые были зарегистрированы на получение информации о возникновении этого события. Описанный процесс нотификации называется диспетчеризацией события.
Перед началом диспетчеризации очередного события среда выполнения создает объект, называемый событийным объектом, который представляет данное событие. Событийный объект всегда является экземпляром класса Event или одного из его потомков. Все приемники событий, выполняемые в процессе диспетчеризации события, получают в качестве аргумента событийный объект. Любой приемник может использовать переменные событийного объекта для получения информации, касающейся произошедшего события. Например, приемник события, которое представляет активность мыши, может использовать переменные событийного объекта, чтобы определить положение указателя мыши в момент возникновения события.
Каждому типу событий в языке ActionScript, будь то предопределенные или пользовательские события, присваивается строковое имя. Например, именем события типа «щелчок кнопкой мыши» является "click”. В процессе диспетчеризации события имя обрабатываемого события может быть получено через переменную type событийного объекта, передаваемого в каждый приемник.
Каждая диспетчеризация события в языке ActionScript обладает получателем, представляющим объект, которому принадлежит данное событие. Например, для событий ввода получателем события обычно является объект, над которым выполнялись определенные действия (щелкнули кнопкой мыши, ввели информацию, переместили указатель мыши и т. д.). Подобным образом для сетевых событий получателем события обычно является объект, вызвавший сетевую операцию.
Для получения информации о возникновении определенного события приемники обычно регистрируются в получателе события. Соответственно, все объекты получателей событий являются экземплярами класса, унаследованного от класса EventDispatcher или реализующего интерфейс lEventDispatcher. Класс EventDispatcher предоставляет методы для регистрации и отмены регистрации приемников событий (addEventListener ( ) и removeEventListener( ) соответственно).
В гл. 21 будет рассказано, что, если получателем события является отображаемый объект (объект, который может быть отображен на экране), приемники событий могут также зарегистрироваться в контейнерах отображения получателя события (то есть в объектах, которые визуально содержат получатель события). Тем не менее пока мы сосредоточимся исключительно на неотображаемых объектах получателей событий.
Регистрация приемника события для получения информации о событии
Основной процесс обработки события в ActionScript заключается в выполнении следующих действий.
Определить имя типа события.
Определить тип данных событийного объекта, представляющего событие.
Создать приемник, отвечающий на событие. Приемник события должен определять один параметр, соответствующий типу данных событийного объекта (тип данных был определен на предыдущем шаге).
Теперь следует использовать метод экземпляра addEventListener ( ) класса EventDispatcher, чтобы зарегистрировать приемник события в получателе события (или в любом контейнере отображения получателя события).
Откинуться на спинку кресла и ожидать возникновения события.
Рассмотрим описанные шаги на примере: создадим и зарегистрируем приемник для предопределенного события "complete".
Шаг 1: Определение имени типа события
Клиентские среды выполнения Flash предлагают широкий выбор типов предопределенных событий, начиная с пользовательского ввода и заканчивая сетевой и звуковой активностью. Имя каждого типа события доступно через константу класса Event или одного из его потомков. Например, константой для типа события «операция завершена» является Event. COMPLETE со строковым значением "complete" . Подобным образом константа для события типа «кнопка мыши нажата» называется MouseEvent. MOUSE DOWN, строковым значением которой является "mouseDown". Чтобы иметь возможность реагировать на конкретный тип предопределенного события, мы сначала должны найти константу, представляющую это событие. В справочнике по языку ActionScript корпорации Adobe константы событий перечислены в разделе Events для каждого класса, поддерживающего события (то есть унаследованного от класса EventDispatcher). Таким образом, чтобы найти константу для конкретного предопределенного события, мы обращаемся к разделу Events документации по тому классу, которому принадлежит это событие.
Предположим, что мы загружаем внешний текстовый файл с помощью класса URLLoader и хотим выполнить некоторый код по завершению загрузки. Мы обращаемся к разделу Events документации по классу URLLoader, чтобы определить, есть ли у него подходящее нам событие «загрузка завершена». В разделе Events мы находим описание события "complete", которое, кажется, нам подходит. Описание события "complete" выглядит следующим образом.
Событие complete
Тип событийного объекта: fl ash.events.Event
Свойство Event, type = fl ash.events.Event.COMPLETE
Диспетчеризация события осуществляется после того, как все полученные данные декодированы и помещены в свойство data объекта URLLoader. Обращаться к полученным данным можно сразу после диспетчеризации этого события.
Подраздел Свойство Event, type сообщает нам название константы для события "complete" — flash. events . Event. COMPLETE. Мы будем использовать эту константу при регистрации приемника для события "complete", как показано полужирным шрифтом в следующем обобщенном коде:
oCbeKTURLLoader.addEventListener(Event.COMPLETE, некийПриемник);
Й
С этого момента при упоминании любых предопределенных событий мы будем использовать соответствующую константу события (например, Event.COMPLETE) вместо его строкового имени-литерала (например, "complete"). Хотя данный стиль является слегка громоздким, он способствует знакомству разработчика с константами событий, фактически применяемых в программах на языке ActionScript.
Шаг 2: Определение типа данных событийного объекта
Теперь, когда мы определили имя типа нашего события (Event. COMPLETE), нужно определить тип данных соответствующего событийного объекта. И снова обращаемся к описанию события "complete" класса URLLoader в справочнике по языку ActionScript корпорации Adobe. Подраздел Свойство Event, type описания события "complete" (которое приводилось в предыдущем разделе) сообщает нам тип данных объекта Event события Event .COMPLETE — flash. events . Event.
Шаг 3: Создание приемника события
Мы знаем константу и тип данных событийного объекта для нашего события (Event. COMPLETE и Event соответственно) и можем создать для него соответствующий приемник. Вот этот код:
private function completeListener (e:Event):void {
traceC'Load complete"):
}
Обратите внимание, что в нашем приемнике описан параметр (е), который будет принимать событийный объект на этапе диспетчеризации события. Тип данных параметра соответствует типу данных события Event. COMPLETE, который был определен на шаге 2.
По соглашению, типом возвращаемого значения всех приемников событий является void. Более того, приемники событий — это методы, которые обычно объявляются с использованием модификатора управления доступом private, что исключает возможность их вызова кодом за пределами класса, в котором они определены.
Поскольку стандарта по именованию функций и методов приемников событий не существует, для именования приемников событий в этой книге используется формат имяСобытияСзstener, где имяСобытия — строковое имя события (в нашем примере "complete").
Шаг 4: Регистрация приемника для события
Теперь, когда мы определили наш приемник события, можно приступать к его регистрации. Если помните, мы загружаем внешний текстовый файл с помощью экземпляра класса URLLoader. Этот экземпляр будет нашим получателем события (поскольку он инициирует операцию загрузки, которая в конце концов завершится событием Event .COMPLETE). Следующий код создает экземпляр класса URLLoader:
var urlLoader:URLLoader = new URLLoader( );
Следующий код регистрирует наш приемник completeListener ( ) в только что созданном получателе события urlLoader для событий Event. COMPLETE:
urlLoader.addEventListener(Event.COMPLETE, completeListener);
Первый аргумент метода addEvent Listener ( ) задает имя типа события, для которого выполняется регистрация. Второй аргумент метода addEventLis tener ( ) является ссылкой на регистрируемый приемник.
Рассмотрим полную сигнатуру метода addEventListener ( ):
addEventLIstener(ти/7, приемник, использоватьПерехват, приоритет, использоватьСлабуюСсылку)
Первые два параметра (тип и приемник) являются обязательными; остальные — необязательными. Параметры приоритет и использоватьСлабуюСсылку будут рассмотрены далее в этой главе, а с параметром использоватьПерехват мы познакомимся в гл. 21.
Шаг 5: Ожидание возникновения события
Мы создали приемник для события Event. COMPLETE и зарегистрировали его в получателе события. Чтобы возникло событие Event. COMPLETE, что, в свою очередь, приведет к выполнению метода completeLis tener ( ), мы инициируем операцию загрузки файла, как показано в следующем коде:
urlLoader.1oad(new URLRequest("someFI1e.txt"));
Когда загрузка файла someFile.txt будет завершена, среда Flash приступит к диспетчеризации события Event. COMPLETE, возникшего в объекте ur ILoader, и выполнит метод completeListener ( ).
Листинг 12.1 демонстрирует код, представляющий пять описанных шагов в контексте функционального класса FileLoader:
Листинг 12.1. Регистрация приемника для событий Event.COMPLETE
package {
Import flash.display
Import flash.net.*:
Import flash.events.*;
public class FileLoader extends Sprite {
public function FileLoader ( ) {
// Создаем получатель события
var urlLoader:URLLoader = new URLLoadert );
// Регистрируем приемник события
urlLoader.addEventListener(Event.COMPLETE, completeL1stener);
// Запускаем операцию, которая приведет к возникновению события urlLoader.1oad(new URLRequest("someFI1e.txt"));
}'
// Определяем приемник события
private function completeListener (e:Event):vo1d { traceCLoad complete");
}
}
}
Чтобы попрактиковаться, зарегистрируем еще два события.
Два дополнительных примера регистрации приемников событий
В случае если при выполнении кода листинга 12.1 клиентская среда Flash не обнаружит файл someFile.txt, то она приступит к диспетчеризации собы-
тия lOErrorEvent. IO ERROR, получателем которого будет являться объект urlLoader. Зарегистрируем приемник для этого события, чтобы наше приложение могло корректно обрабатывать ошибки загрузки. Сначала мы создадим новый приемник события ioErrorListener ( ), как показано в следующем коде: private function IoErrorListener (e:Event):void {
traceCError loading file.");
}
Теперь зарегистрируем приемник события ioErrorListener ( ) в объекте urlLoaderдля событий lOErrorEvent.IO_ERROR:
urlLoader.addEventLIstener(lOErrorEvent.IO_ERROR. 1oErrorLIstener);
Красиво и просто.
В листинге 12.2 демонстрируется новый код, который обрабатывает события lOErrorEvent. IO_ERROR, в контексте класса FileLoader.
Листинг 12.2. Регистрация приемника для событий IOErrorEvent.IO_ERROR package {
Import flash.display.*;
Import flash.net.*;
Import fl ash.events.*;
public class FileLoader extends Sprite {
public function FileLoader ( ) {
var url Loader-.URLLoader = new URLLoaderC );
urlLoader.addEventLIstener(Event.COMPLETE, completeL1stener);
urlLoader.addEventLIstener(lOErrorEvent.IO_ERROR, 1oErrorLIstener);
urlLoader.1oad(new URLRequest("someFI 1 e.txt"));
}
private function completeL1stener (e:Event):void { traceC'Load complete");
private function IoErrorListener (e:Event):void { trace("Error loading file.");
}
}
}
Теперь попытаемся обработать совершенно другое предопределенное событие Event. RESIZE клиентской среды выполнения Flash. Диспетчеризация события Event.RESIZE осуществляется всякий раз, когда среда выполнения Flash находится в режиме «без масштабирования» (no-scale) и изменяется ширина или высота окна приложения. Получателем событий Event .RESIZE является экземпляр класса Stage клиентской среды Flash. Для обращения к этому экземпляру мы воспользуемся переменной stage нашего основного класса приложения ResizeMonitor. Если вы еще незнакомы с экземпляром класса Stage, пока просто считайте, что он представляет область отображения клиентской среды выполнения Flash. Более подробно класс Stage будет рассмотрен в гл. 20.
Вот этот код:
package {
import flash.display.*;
Import flash.net.*;
Import fl ash.events.*;
public class ResizeMonltor extends Sprite {
public function ResizeMonltor ( ) {
// Используем режим "без масштабирования". В противном случае при
// изменении размеров окна приложения происходит автоматическое
// масштабирование содержимого и события Event.RESIZE не возникают.
stage.seal eMode = StageScaleMode.NO_SCALE;
// Регистрируем res1zeL1stener( ) в экземпляре Stage на события
// Event.RESIZE.
stage.addEventListener(Event.RESIZE, resizeListener);
}
// Определяем приемник события, выполняющийся всякий раз, когда среда
// выполнения Flash генерирует событие Event.RESIZE
private function resizeListener (e;Event);void {
traceC'The application window changed size!");
// Вывод новых размеров экземпляра Stage на консоль
// с отладочной информацией'
traceCNew width; " + stage.stageWidth);
traceCNew height; " + stage.stageHeight);
}
}
}
Обратите внимание, что внутри функции resizeListener ( ) к переменной stage можно обращаться напрямую, как если бы мы находились в методе-конструкторе класса ResizeMonltor.
Когда приемником события является метод экземпляра, приемник получает полный доступ к методам и переменным этого экземпляра. Дополнительную информацию можно найти в разд. «Связанные методы» гл. 3.
Отмена регистрации приемника дня события
Чтобы остановить процесс получения приемником событий уведомлений о возникающих событиях, мы должны отменить регистрацию этого приемника с помощью метода removeEventListener ( ) экземпляра класса EventDispatcher, который имеет следующий обобщенный вид:
получательСобытияИлиПредокПолучателя.removeEventListener(тип, приемник, использоватьПерехват')
В большинстве случаев обязательными являются только первые два параметра ( тип и приемник); параметр использоватьПерехват будет рассмотрен в гл. 21.
^ С целью сокращения объема используемой памяти и уменьшения загрузки процессора *• А отмена регистраций приемников событий должна происходить сразу же после того, как в программе отпадает необходимость их применения.
Следующий код демонстрирует использование метода removeEventLi s tener ( ); он останавливает процесс получения методом mouseMoveListener ( ) уведомлений о возникающих событиях Мои seEvent. MOUSE_MOVE, получателем которых является экземпляр класса Stage:
stage.removeEventListener(MouseEvent.MOUSE_MOVE, mouseMoveLIstener);
Дополнительную информацию о потенциальных проблемах с памятью, которые могут возникать в процессе использования событий, можно найти в разд. «Приемники событий и управление памятью» далее в этой главе.
Обзор терминологии, используемой при работе с событиями
Следующий список терминов, с которыми мы уже встречались в этой главе, представляет ключевую терминологию, используемую при работе с событиями.
Событие — по существу, нечто произошедшее (некое «асинхронное явление»), например щелчок кнопкой мыши или завершение операции загрузки. Каждое событие обозначается именем события, которое обычно доступно через константу. Константы для предопределенных событий определяются либо в классе Event, либо в одном из его подклассов, который наиболее близко связан с событием.
Событийный объект — объект, представляющий одно конкретное возникновение события. Класс событийного объекта определяет, какая информация о данном событии будет доступна приемникам событий. Все событийные объекты являются экземплярами либо класса Event, либо одного из его подклассов.
Получатель события — объект, которому принадлежит событие. Является целевым объектом для события, для которого осуществляется диспетчеризация, и однозначно определяется каждым типом события. Каждый получатель события (и предок получателя в случае получателей в списке отображения) может регистрировать приемники событий, которые будут уведомляться о возникновении события.
Приемник события — функция или метод, которые регистрируются для получения уведомлений о возникновении события от получателя события (или от предка получателя события).
Диспетчеризация события — отправка уведомления о возникновении события получателю события, который вызывает зарегистрированные приемники. Если получатель находится в списке отображения, диспетчеризация события осуществляется по цепочке, от начала списка до получателя и — в случае всплывающих событий — обратно к началу списка. Более подробную информацию о списке отображения и цепочке диспетчеризации событий можно найти в гл. 21. Диспетчеризация события также называется распространением события.
Забегая вперед, хочется привести еще несколько терминов, с которыми придется столкнуться при дальнейшем рассмотрении вопросов обработки событий. Говорят, что приемники, выполняемые в ответ на событие, вызываются этим событием. Когда вызванный приемник завершает свое выполнение, говорят, что событие обработано. Когда все приемники объекта обработают данное событие, говорят, что сам объект завершил обработку этого события.
Теперь, когда мы познакомились с основами событий и их обработки, более детально рассмотрим несколько конкретных вопросов, касающихся обработки событий.
Обращение к объекту получателя
В процессе диспетчеризации любого события объект Event, передаваемый в каждый приемник события, определяет переменную target, которая содержит ссылку на объект получателя. Таким образом, чтобы обратиться к объекту получателя, мы используем следующий обобщенный код для приемника события, который в процессе отладки просто выводит строковое значение (типа String) получателя события:
public function некийПриемник (е:SomeEvent):void {
// Обращение к объекту получателя события tracete.target);
}
Программы обычно используют переменную экземпляра target класса Event для управления объектом получателя. Например, вспомните код, который мы использовали для реакции на завершение операции загрузки файла (продемонстрированный в листинге 12.1):
package {
Import flash.display.*;
Import flash.net.*;
Import fl ash.events.*;
public class FIleLoader extends Sprite {
public function FIleLoader ( ) {
var urlLoader;URLLoader = new URLLoaderC );
urlLoader.addEventLIstener(Event.COMPLETE, completeL1stener);
urlLoader.1oad(new URLRequest("someFI1e.txt"));
}
private function completeListener (e:Event):vo1d { trace("Load complete");
}
}
}
В представленном коде мы могли бы обратиться к объекту urILoader внутри функции completeListener ( ), чтобы получить содержимое загруженного файла. Рассмотрим код, который мы могли бы использовать (обратите внимание, что для
обеспечения безопасности типов значение переменной target приводится к типу URLLoader — фактическому типу данных объекта получателя):
private function completed stener (e:Event):vo1d {
var loadedText:String = URLLoader(e.target).data;
}
После выполнения этого кода значением переменной loadedText станет содержимое загруженного текстового файла (someFile. txt).
В листинге 12.3 продемонстрирован еще один пример обращения к объекту получателя события, но на этот раз объект получателя находится в списке отображения. В этом примере, когда текстовое поле получает фокус ввода, цвет фона этого поля становится красным. Для обращения к объекту TextField метод focusInListener ( ) использует переменную экземпляра target класса Event.
В листинге 12.3 применяется несколько методик, которые мы еще не рассматривали: создание текста, установка фокуса ввода на объект, работа со списком отображения и цепочка диспетчеризации событий. Все перечисленные темы будут рассмотрены в части II. Если вы никогда не программировали объекты, отображаемые на экране, пропустите этот пример и вернитесь к нему после прочтения части II.
Листинг 12.3. Обращение к объекту получателя
package {
Import flash.display.*;
Import fl ash.events.*;
Import fl ash.text.*;
// Изменяет цвет фона текстового поля на красный,
// когда поле получает фокус ввода
public class Н1ghl1ghtText extends Sprite {
// Конструктор
public function Highl1ghtText ( ) {
// Создание объекта Sprite
var s:Spr1te = new Spr1te( );
.x = 100;
.y = 100;
// Создание объекта TextField
var t;TextF1eld = new TextF1eld( ):
t.text = "Click here";
t.background = true:
t.border = true:
t.autoSize = TextF1eldAutoS1ze.LEFT;
// Помещение объекта TextField в объект Sprite s.addChlld(t):
/7 Добавляем объект Sprite в иерархию отображения данного объекта addChlld(s);
// Регистрируем приемник для получения уведомлений об установке
// фокуса ввода на любой из потомков объекта Sprite (в данном случае
// существует только один потомок: объект TextField, t)
s.addEventLi stener(FocusEvent.FOCUS_IN, focus Intistener):
}
// Приемник выполняется в том случае, когда любой из потомков объекта
// Sprite получает фокус ввода
public function focusInListener (e:FocusEvent):void {
// Выводит: Target of this event dispatch: [object TextField] trace("Target of this event dispatch: " + e.target):
// Устанавливает красный цвет для фона текстового поля. Обратите
// внимание, что для обеспечения безопасности типов мы приводим '
// значение переменной Event.target к типу TextField - фактическому
// типу данных объекта получателя.
TextField(e.target).backgroundcolor = OxFFOOOO:
Упражнение: попробуйте добавить к коду листинга 12.3 приемник события FocusEvent. FOCUS_OUT, который меняет цвет фона текстового поля — делает его белым.
Обращение к объекту, зарегистрировавшему приемник
В процессе диспетчеризации любого события объект Event, передаваемый в каждый приемник события, определяет переменную currentTarget, содержащую ссылку на объект, в котором зарегистрирован этот приемник события. Это демонстрирует следующий обобщенный код приемника события; он отображает строковое значение (типа String) объекта, в котором зарегистрирован приемник не- кийПриемник( У
public function некийПриемник (е:НекоеСобытие):^о16 {
// Обращение к объекту, в котором зарегистрирован данный приемник события trace(e.currentTarget);
}
Для событий, получателями которых являются неотображаемые объекты, значение переменной экземпляра currentTarget класса Event всегда равняется значению переменной экземпляра target (поскольку приемники всегда регистрируются в получателе события). Например, вернемся к классу FileLoader из листинга 12.1. Если мы сравним значения переменных е. currentTarget и е. target внутри метода completeListener ( ), то увидим, что обе ссылаются на один и тот же объект:
package {
import fl ash.di splay.*;
Import flash.net.*;
Import flash.events.*;
public class FIleLoader extends Sprite {
public function FIleLoader ( ) {
var urlLoader:URLLoader = new URLLoader( );
ur1 Loader.addEventLIstener(Event.COMPLETE, completeL1stener);
urlLoader.1oad(new URLRequest("someFI1e.txt"));
}
private function completeL1stener (e;Event):void { trace(e.currentTarget == e.target): // Отображает: true }
}
}
Тем не менее, как будет рассказано в гл. 21, для событий, получателями которых являются отображаемые объекты в иерархии отображения, приемники могут регистрироваться как в получателе события, так и в его контейнерах отображения. Для приемников событий, зарегистрированных в контейнере отображения получателя события, переменная currentTarget ссылается на этот контейнер, а переменная target — на объект получателя события.
Предположим, объект Sprite, содержащий объект TextField, зарегистрировал приемник события clickListener ( ) для события MouseEvent. CLICK. Когда пользователь щелкает кнопкой мыши в этом текстовом поле, происходит диспетчеризация события MouseEvent. CLICK, в результате чего вызывается приемник clickListener ( ). Внутри метода clickListener ( ) переменная currentTarget ссылается на объект Sprite, а переменная target — на объект TextField.
Программы обычно используют переменную currentTarget для управления объектом, в котором зарегистрирован приемник. В качестве примера модифицируем функцию focusInListener ( ) из листинга 12.3. На этот раз при получении объектом TextField фокуса ввода наш новый код функции focusInListener ( ) будет отображать синий овал вокруг текстового поля. Синий овал рисуется на объекте Sprite, доступ к которому осуществляется через переменную currentTarget.
public function focusInListener (e:FocusEvent):void {
// Установить для фона текстового поля красный цвет TextF1eld(e.target).backgroundcolor = OxFFOOOO;
// Получить ссылку на объект Sprite
var theSpr1te:Spr1te = Spr1te(e.currentTarget);
// Нарисовать эллипс на объекте Sprite
theSprlte.graphics.beg1nF111(OxOOOOFF);
theSprlte.graphics.drawEl11pse(-10, -10, 75, 40):
}
Отмена стандартного поведения событий
Некоторые события в языке ActionScript обладают побочным эффектом, называемым стандартным поведением. Например, стандартным поведением события TextEven t. TEXT_INPUT является добавление текста в текстовое поле получателя. Подобным образом стандартным поведением события MouseEvent. MOUSE_DOWN, получаемого объектом класса SimpleButton, является отображение картинки, которая представляет нажатое состояние кнопки.
В некоторых случаях события, которые характеризуются стандартным поведением, предоставляют возможность избежать этого поведения программным путем. Такие события называются отменяемыми. Например, отменяемыми являются события TextEvent.TEXT_INPUT, FocusEvent.KEY_FOCUS_CHANGE иFocusEvent.MOUSE_FOCUS_CHANGE.
Чтобы избежать стандартного поведения для отменяемого события, мы вызываем метод экзeмпляpapreventDef suit ( ) класса Event над объектом этого класса, передаваемым во все приемники, зарегистрированные для данного события. Например, в следующем коде мы отменяем стандартное поведение для всех событий TextEvent. TEXT_INPUT, получателем которых является текстовое поле t. Вместо того чтобы позволить программе отображать в текстовом поле текст, вводимый пользователем, мы будем просто добавлять в это поле букву "х".
package {
Import flash.display.*;
Import flash.text.*;
Import fl ash.events.*;
// Изменить текст, вводимый пользователем, на символ "х"
public class Inputconverter extends Sprite {
private var t;TextField;
public function Inputconverter ( ) {
// Создаем текстовое поле
t = new TextFi eld( );
t.border = true;
t.background = true;
t.type = TextFieldType.INPUT addChild(t);
// Регистрируем приемник для события TextEvent.TEXT_INPUT t.addEventtistener(TextEvent.TEXT_INPUT, textlnputListener);.
}
// Приемник выполняется при возникновении события TextEvent.TEXT_INPUT private function textlnputListener (e;TextEvent);void {
// Показать текст, введенный пользователем trace("Attempted text input: " + e.text);
// Исключить отображение введенного текста в текстовом поле e.preventDefault( );
// Добавить в текстовое поле букву "х" вместо введенного // пользователем текста t.appendTextCx");
}
}
}
Чтобы определить, обладает ли определенное событие стандартным поведением, которое можно отменить, проверьте значение переменной экземпляра cancel able класса Event внутри приемника, зарегистрированного для получения уведомлений о возникновении данного события. Для предопределенных событий эту информацию можно также найти в разделе описания соответствующего события в справочнике по языку ActionScript корпорации Adobe.
Чтобы определить, было ли отменено стандартное поведение события, диспетчеризация которого происходит в текущий момент, проверьте возвращаемое значение метода экземпляра isDefault Prevented ( ) класса Event внутри приемника, зарегистрированного для получения уведомлений о возникновении данного события. Стоит отметить, что, как и предопределенные события, пользовательские события имеют возможность определять стандартное поведение, которое может быть отменено вызовом метода preventDef aul t ( ). Дополнительную информацию вместе с примером кода можно найти в подразд. «Отмена стандартного поведения для пользовательских событий» разд. «Пользовательские события» далее в этой главе.
Еще один пример, демонстрирующий использование метода preventDefault() для события TextEvent.TEXT_INPUT, показан в листинге 22.8 гл. 22.
Приоритет приемника события
По умолчанию, если сразу несколько приемников событий регистрируются в конкретном объекте для получения уведомлений об одном и том же типе событий, они вызываются в том порядке, в котором были зарегистрированы. Например, в следующем коде два приемника событий — completeListenerA ( ) и completeListenerB ( ) — регистрируются в объекте urlLoader для получения уведомлений о событии Event. COMPLETE. При возникновении события Event-COMPLETE приемник completeListenerA ( ) будет выполнен раньше приемника completeListenerB ( ), поскольку completeListenerA ( ) был зарегистрирован раньше completeListenerB ( ).
package {
Import flash.display.*;
import flash.net.*;
import fl ash.events.*;
public class FileLoader extends Sprite {
public function FileLoader ( ) {
var url Loader-.URLLoader = new URLLoader( );
// Порядок регистрации определяет порядок выполнения
urlLoader.addEventLi stener(Event.COMPLETE, completeLi stenerA);
uг 1 Loader.addЕventL1stener(Event.COMPLETE. completeListenerB);
urlLoader.1oad(new URLRequest("someFI1e.txt")):
}
private function completeLlstenerA (e;Event):void { trace("L1stener A: Load complete");
}
private function completeL1stenerB (e:Event):void { trace("Listener B: Load complete");
}
}
}
Изменить стандартный порядок вызова приемников событий можно с помощью параметра приоритет метода addEventListener ( ), показанного в следующем обобщенном коде:
addEventLIstener(ти/7, приемник, использоватьПерехват, приоритет, использоватьСлабуюСсылку)
Параметр приоритет представляет собой целое число, обозначающее порядок, в котором должен вызываться регистрируемый приемник события относительно других приемников, зарегистрированных для того же события в том же объекте. Приемники, зарегистрированные с более высоким значением параметра приоритет, будут вызваны раньше приемников, зарегистрированных с более низким значением. Например, приемник, зарегистрированный со значением 3 параметра приоритет, будет вызван раньше приемника, зарегистрированного со значением 2 параметра приоритет. Если два приемника зарегистрированы с одним и тем же значением параметра приоритет, они будут выполняться в том порядке, в котором были зарегистрированы. Если значение параметра приоритет не указано, принимается значение по умолчанию, равное 0.
Следующий код демонстрирует принципы использования параметра приоритет. Приемник completeListenerB ( ) будет выполнен раньше приемника completeListenerA( ) несмотря на то, что completeListenerA ( ) был зарегистрирован раньше completeListenerB ( ).
package {
Import flash.display.*;
Import flash.net.*;
Import flash.events.*;
public class FIleLoader extends Sprite {
public function FIleLoader ( ) {
var urlLoader;llRLLoader = new URLLoader( );
// Параметр приоритет определяет порядок выполнения urlLoader.addEventLIstener(Event.COMPLETE.
completeListenerA, false, 0);
url Loader.addEventLIstener(Event.COMPLETE, completeListenerB,
false.
1):
urlLoader.1oad(new URLRequest("someF11e.txt"));
}
private function completeListenerA (e:Event):void { • trace("Listener A: Load complete");
}
private function completeListenerB (e:Event):void { trace("Listener B: Load complete");•
}
}
}-
Параметр приоритет применяется крайне редко, однако в некоторых ситуациях он может оказаться весьма полезным. Например, среда разработки приложений может использовать приемник с более высоким приоритетом, чтобы инициировать загруженное приложение до того, как будут выполнены другие приемники. Кроме того, программный пакет для тестирования может использовать приемник с более высоким приоритетом, чтобы заблокировать другие приемники, которые в противном случае повлияют на результаты конкретного теста (дополнительную информацию можно получить в разд. «Остановка процесса диспетчеризации события» гл. 21).
Будьте осторожны при изменении порядка выполнения приемников событий. Программы, зависящие от порядка выполнения, предрасположены к ошибкам, поскольку приоритеты приемников событий являются непостоянными, усложняют поддержку кода и делают его более сложным для восприятия.
Приемники событий и управление памятью
В этой главе мы увидели, что событийная модель языка ActionScript основывается на приемнике (представляющем собой функцию или метод) и объекте, в котором регистрируется этот приемник. Каждый объект, регистрирующий приемник для определенного события, поддерживает связь с этим приемником, сохраняя ссылку на него во внутреннем массиве, который называется списком приемников. Например, в следующем коде (взятом из листинга 12.1) метод completeListener ( ) регистрируется в объекте urlLoader для событий Event. COMPLETE. В результате внутренний список приемников объекта ur ILoadeг получает ссылку на метод completeListener ( ).
package {
import flash.display.*;
import flash.net.*;
import fl ash.events.*:
public class FileLoader extends Sprite {
public function FileLoader ( ) {
var urlLoader:URLLoader = new URLLoader( );
// Регистрация приемника completeListener( )
urlLoader.addEventListener(Event.COMPLETE, completeListener);
urlLoader.load(new URLRequest("someFile.txt"));
private function completeListener (e:Event):void { traceCLoad complete");
}
}
По умолчанию любой объект, получивший ссылку на приемник, хранит ее до тех пор, пока регистрация данного приемника не будет явно отменена методом removeEventListener ( ). Более того, объект продолжает хранить полученную ссылку на приемник даже тогда, когда в программе не остается других ссылок на этот приемник. Это демонстрирует следующий простой класс AnonymousLi stener. Он создает анонимную функцию и регистрирует ее для событий MouseEvent. MOUSE_EVENT в экземпляре Stage клиентской среды выполнения Flash. Хотя класс AnonymousLi stener не имеет ссылок на эту анонимную функцию, она продолжает храниться в экземпляре Stage и вызывается каждый раз при возникновении события MouseEvent. MOUSE MOVE, даже спустя долгое время после завершения метода конструктора класса AnonymousListener.
package {
import flash.display.*;'
import flash.events.*;
public class AnonymousListener extends Sprite {
public function AnonymousListener ( ) {
// Добавляем анонимную функцию в список приемников экземпляра Stage stage.addEventListener(MouseEvent.MOUSE_MOVE.
function (e;MouseEvent);void {traceCmouse move");
}
}
В предыдущем коде созданная анонимная функция окажется навсегда «заброшенной» в списке приемников экземпляра Stage. Программа не сможет отменить регистрацию анонимной функции, поскольку она не имеет ссылки на нее.
«Заброшенные» приемники представляют собой потенциальный источник существенного расходования памяти и могут привести к другим побочным эффектам в программах на языке ActionScript.
Рассмотрим пример, демонстрирующий потенциальные проблемы, которые могут возникнуть из-за «заброшенных» приемников, и способы их решения.
Предположим, мы разрабатываем игру, которая заключается в ловле бабочек: чтобы поймать бабочку, игрок должен коснуться ее указателем мыши. Бабочки
не хотят быть пойманными и всячески стараются улететь от указателя мыши. Основным классом приложения является ButterflyGame. Каждая бабочка представляется экземпляром класса Butterfly. Для управления перемещением бабочек в игре используется основной объект Timer, который генерирует событие TimerEvent. TIMER каждые 25 мс. Каждый объект класса Butterfly регистрирует приемник в основном объекте Timer и вычисляет свое новое местоположение всякий раз, когда возникает событие TimerEvent. TIMER.
Рассмотрим код класса Butterfly:
package {
Import flash.display.*;
import fl ash.events.*;
import fl ash.utils.*;
public class Butterfly extends Sprite {
// Каждый объект Butterfly получает ссылку на основной таймер
// через параметр конструктора gameTimer
public function Butterfly (gameTimer:Timer) {
gameTimer.addEventListener(TimerEvent.TIMER. timerListener);
}.
private function timerListener (eiTimerEvent):void { traceCCalculating new butterfly position...”);
// Вычисление нового местоположения бабочки (код не приводится)
}
}'
}
Рассмотрим код класса ButterflyGame, который значительно упрощен, чтобы акцентировать ваше внимание на коде, отвечающем за создание и удаление бабочки. В этой версии кода игра содержит только одну бабочку.
package {
import fl ash.di splay.*;
import flash.utils.*; *
public class ButterflyGame extends Sprite {
private var timer:Timer;
private var butterfly:Butterfly;
public function ButterflyGame ( ) {
// Игровой таймер
timer = new Timer(25. 0);
' timer.start( );•
addButterfly( );
}.
// Добавляет бабочку в игру
public function addButterfly ( );void {
butterfly = new Butterfly(timer);
// Удаляет бабочку из игры
public function removeButterfly ( ):vo1d { butterfly = null;
}
}
}
Для добавления бабочки в игру класс ButterflyGame использует следующий код: butterfly = new Butterfly(timer):
Этот код приведет к выполнению конструктора класса Butterfly, в результате чего метод timerListener ( ) класса Butterfly зарегистрируется в объекте gameTimer для получения событий TimerEvent. TIMER.
Когда игрок поймает бабочку, объект ButterflyGame удалит соответствующий объект Butterfly из программы, используя следующий код:
butterfly = null:
Однако, даже несмотря на то, что предыдущий код удаляет ссылку на объект Butte rfly из объекта ButterflyGame, в списке приемников объекта gameTimer продолжает храниться ссылка на метод timerListener ( ) объекта Butterfly и, соответственно, на сам объект Butterfly. Более того, метод timerListener ( ) продолжает выполняться каждый раз при возникновении события TimerEvent. TIMER. Таким образом, объект Butterfly продолжает потреблять память и процессорное время и способен вызвать неожиданные или нежелательные побочные эффекты в программе. Чтобы избежать подобных проблем, перед удалением объекта Butterfly из игры нужно сначала отменить регистрацию метода timerListener ( ) для событий TimerEvent. TIMER. .
Добавим новую переменную gameTimer и новый метод destroy ( ) в класс Butterfly, чтобы облегчить процесс отмены регистрации приемника для события TimerEvent. TIMER. Основной игровой таймер присваивается переменной gameTimer. Метод destroy ( ) отменяет регистрацию метода timerListener ( ) для событий TimerEvent. TIMER. Рассмотрим код класса Butterfly с внесенными изменениями, которые выделены полужирным шрифтом:
package {
Import flash.display.*:
Import fl ash.events.*;
Import flash.utils.*:
public class Butterfly extends Sprite {
private var gameTimer:Timer;
public function Butterfly (gameTimer:T1mer) {
this.gameTimer = gameTimer;
this.gameTimer.addEventLIstener(TimerEvent.TIMER. timerListener);
}
private function timerListener (e:T1merEvent):void {
trace("Calculat1ng new butterfly position...");
// Вычисление нового местоположения бабочки (код не показан) }
public function destroy ( ):void {
gameT1mer.removeEventlistener(T1merEvent.TIMER, timerListener);
}
}
}
Перед тем как удалить ссылку на объект Butterfly, в методе экземпляра removeButterfly ( ) класса ButterflyGame мы вызываем метод destroy ( ), как показано в следующем коде:
public function removeButterfly ( ):void {
butterfly.destroy( );
butterfly = null;
}
Вызывая метод destroy ( ) перед удалением объекта Butterfly из игры, мы не позволяем методу timerListener ( ) оказаться «заброшенным» в списке приемников объекта Timer.
Если вы регистрируете приемник события в каком-либо объекте, убедитесь, что ваша программа с течением времени также отменяет регистрацию этого приемника.
Слабые ссылки на приемники событий. В предыдущем разделе было рассказано, что по умолчанию объект, регистрирующий приемник для определенного события, хранит ссылку на этот приемник до тех пор, пока его регистрация для указанного события не будет отменена явно, даже если в программе не остается других ссылок на этот приемник. Тем не менее это стандартное поведение можно изменить с помощью параметра использоватьСлабуюСсылку метода addEventListener ( ).
" Для изучения этого раздела требуется предварительное понимание механизма сборки ** 4 й мусора в языке ActionScript. Этот механизм рассматривается в гл. 14.
„ цу
Регистрация приемника с использованием параметра использоватьСлабуюСсылку, для которого установлено значение true, не позволит этому приемнику оказаться «заброшенным» в списке приемников объекта, выполняющего регистрацию. Предположим, что объект (О) регистрирует приемник (П) для события (С) с использованием параметра использоватьСлабуюСсылку, ддя которого установлено значение true. Кроме того, предположим, что единственной ссылкой на П, которой обладает программа, является ссылка, хранящаяся в О. В обычной ситуации п будет храниться в О до тех пор, пока регистрация П для события С не будет отменена. Однако поскольку при регистрации П был использован параметр использоватьСлабуюСсылку со значением true и О хранит единственную оставшуюся ссылку на П в программе, П сразу же становится пригодным для сборки мусора. Впоследствии сборщик мусора по своему усмотрению может автоматически исключить П из списка приемников О и удалить его из памяти. Для демонстрации работы параметра использоватьСлабуюСсылку вернемся к классу AnonymousListener. Как уже говорилось, класс AnonymousListener создает
анонимную функцию и регистрирует ее для событий MouseEvent .MOUSE_MOVE в экземпляре Stage клиентской среды выполнения Flash. Однако на этот раз при регистрации функции для событий MouseEvent .MOUSE_MOVE мы используем параметр использоватьСлабуюСсылку со значением true.
package {
Import fl ash.display.*;
Import fl ash.events.*;
public class AnonymousLIstener extends Sprite { public function AnonymousLIstener ( ) {
// Добавляем анонимную функцию в список приемников экземпляра Stage stage.add Е ventL1stener(MouseEvent.MOUSE_MOVE,
function (e:MouseEvent):void {trace("mouse move");
false,
0, true);
}
} }
После выполнения предыдущего кода единственной ссылкой на анонимную функцию в программе является ссылка, хранящаяся в экземпляре Stage. Поскольку анонимная функция была зарегистрирована с использованием параметра использоватьСлабуюСсылку, для которого было установлено значение true, она сразу же становится пригодной для сборки мусора. Таким образом, сборщик мусора по своему усмотрению может впоследствии автоматически исключить анонимную функцию из списка приемников экземпляра Stage и удалить ее из памяти.
Безусловно, тот факт, что анонимная функция пригодна для сборки мусора, совершенно не означает, что она будет удалена из памяти. На самом деле в случае с предыдущим простым примером, функция, скорее всего, не будет удалена из памяти, поскольку объем используемой приложением памяти недостаточен для запуска механизма сборки мусора. В результате функция будет продолжать выполняться при получении события MouseEvent. MOUSE_MOVE экземпляром Stage, хотя теоретически она может быть удалена из памяти в любой момент времени. Из этого следует, что вообще не следует полагаться на параметр исполь - зоватьСлабуюСсылку как на способ автоматического удаления приемников событий. Наилучшее решение — просто избегать появления заброшенных приемников событий.
Если вы регистрируете приемник события в каком-либо объекте, убедитесь, что ваша программа с течением времени также отменяет регистрацию этого приемника.
До сих пор в этой главе мы работали исключительно с предопределенными событиями языка ActionScript. Теперь рассмотрим процесс создания в программе своих собственных пользовательских событий.
Пользовательские события
Чтобы выполнить диспетчеризацию нового пользовательского события в языке ActionScript, достаточно расширить класс EventDispatcher, присвоить новому событию имя и вызвать метод экземпляра dispatchEvent ( ) класса EventDispatcher. Для изучения процесса создания пользовательских событий в программе мы рассмотрим два примера: в первом событие создается для игры, а во втором — для элемента пользовательского интерфейса.
Если вы хотите сделать получателем события экземпляр класса, который уже расширяет другой класс, используйте композиционный подход, рассмотренный в гл. 9: непосредственно реализуйте интерфейс lEventDispatcher и используйте методы класса EventDispatcher не через наследование, а через композицию.
Пользовательское событие "gameOver"
Предположим, что мы создаем универсальный каркас для разработки видеоигр. Каркас включает в себя следующие два класса: класс Game, выполняющий основные функции, необходимые для любой видеоигры, и класс Console, который представляет панель для запуска новых игр. Каждый раз при запуске новой игры класс Console создает объект класса Game. Любой экземпляр класса Game, создаваемый классом Console, является получателем пользовательского события "gameOver”, которое возникает после окончания игры.
Чтобы объекты класса Game могли выступать в роли получателей событий, класс Game расширяет класс EventDispatcher, как показано в следующем коде: package {
Import fl ash.events.*;
public class Game extends EventDispatcher {
}
}
Кроме того, в классе Game определена константа Game. GAME_OVER, значением которой является имя пользовательского события: "gameOver". По соглашению имена констант событий записываются полностью прописными буквами, а слова разделяются знаком подчеркивания, например: GAME_OVER. Константы пользовательских событий обычно определяются либо в классе получателя события (в данном случае в классе Game), либо, если используется подкласс класса Event, в этом подклассе (как показано в нашем следующем примере с элементом пользовательского интерфейса). Поскольку в нашем текущем примере подклассы класса Event не используются, определим константу для события "gameOver" в классе Game, как показано в следующем коде:
package {
Import flash.events.*;
public class Game extends EventDispatcher {
public static const GAMEOVER: String = "gameOver";
}
}
Когда игра завершается, объект Game вызывает метод endGame ( ), который возвращает игровую среду в исходное состояние, что позволит начать новую игру. Вот код метода endGame ( ):
package {
Import flash.events.*;
public class Game extends EventDispatcher {
public static const GAME_OVER:String = ’’gameOver”;
private function endGame ( ):void {
// Выполнение действий для завершения игры (код не показан)
}
}
}
Когда все действия, завершающие игру, выполнены, метод endGame ( ) использует метод dispatchEvent ( ), чтобы приступить к диспетчеризации события Game. GAME_OVER, сигнализирующего об окончании игры: package {
import flash.events.*;
public class Game extends EventDispatcher {
public static const GAME_OVER:String = "gameOver”;
private function endGame ( ):void {
// Выполнение действий для завершения игры
// (код не показан)
// ...после чего просим среду Flash выполнить
// диспетчеризацию события, обозначающего окончание игры dispatchEvent(new Event(Game.GAME_OVER));
}
}
}
Обратите внимание, что, поскольку метод dispatchEvent ( ) вызывается над объектом Game, этот объект и является получателем события.
Й
Объект, над которым вызывается метод dispatchEvent(), является получателем события.
Метод dispatchEvent ( ), продемонстрированный в предыдущем коде, принимает один параметр — объект Event, предоставляющий событие для диспетчеризации. Сам конструктор класса Event принимает три параметра — тип, всплывающее и отменяемое, как показано в следующем обобщенном коде:
Event(тип, всплывающее, отменяемое)
Тем не менее в большинстве случаев требуется только первый аргумент — тип; он определяет строковое имя события (в нашем случае Game. GAME_OVER). Параметр всплывающее используется только в тех случаях, когда получателем события является отображаемый объект; этот параметр обозначает присутствие (true) или отсутствие (false) всплывающей фазы в цепочке диспетчеризации событий (дополнительную информацию можно найти в разд. «Пользовательские события и цепочка диспетчеризации события» гл. 21). Параметр отменяемое применяется для создания пользовательских событий с избегаемым стандартным поведением (этот вопрос рассматривается далее в подразд. «Отмена стандартного поведения для пользовательских событий» разд. «Пользовательские события»).
Чтобы зарегистрировать приемник события для нашего пользовательского события Game. GAME OVER, как и при регистрации приемника для предопределенного события, используется метод addEventListener ( ). Предположим, что по окончании игры мы хотим, чтобы класс Console выводил окно, позволяющее пользователю вернуться к панели запуска или снова сыграть в выбранную игру. Определить момент окончания игры в классе Console позволит регистрация приемника для событий Game . GAME_OVER, как показано в следующем коде:
package {
Import flash.display
Import flash.events.*:
public class Console extends Sprite {
// Конструктор
public function Console ( ) {
var game:Game = new Game( ):
game.addEventLIstener(Game.GAME_OVER. gameOverLIstener);
}
private function gameOverListener (e:Event):void { traceCThe game has ended!’’);
// Отображает пользовательский интерфейс ’’back to console”
// (код не показан)
}
}
}
Обратите внимание, что тип данных событийного объекта, передаваемого в метод gameOverListener ( ), соответствует типу данных событийного объекта, изначально передаваемого в метод di spat с НЕ vent ( ) внутри метода экземпляра endGame ( ) класса Game (как показано в предыдущем коде).
При создании приемника для пользовательского события указывайте тип данных па- $ А w раметра приемника в соответствии с типом данных событийного объекта, изначально передаваемого в метод dispatchEvent().
В листинге 12.4 полностью показан код для нашего пользовательского события Game. GAME_OVER, который также содержит таймер, вызывающий метод
endGame ( ), имитируя окончание реальной игры (подробную информацию по классу Timer можно найти в справочнике по языку ActionScript корпорации Adobe).
Листинг 12.4. Пользовательское событие "gameOver"'
// Класс Game (получатель события)
package {
Import fl ash.events.*;
import flash.utils.*; // Требуется для класса Timer
public class Game extends EventDispatcher {
public static const GAME_OVER;String = "gameOver";
public function Game ( ) {
// Завершает игру спустя одну секунду
var t1mer;T1mer = new T1mer(l000, 1);
timer.addEventL1stener(T1merEvent.TIMER. timerLIstener);
timer.start( );
// Вложенная функция, которая выполняется через одну секунду
// после создания данного объекта.
function timerLIstener (e;T1merEvent):void { endGame( );
}
}
private function endGame ( ):void {
// Выполнение действий для завершения игры (код не показан)
// ...после чего просим среду Flash
// выполнить диспетчеризацию события.
// обозначающего окончание игры
d1spatchEvent(new Еvent(Game.GAME_OVER));
}
}
}
// Класс Console (регистрирует приемник для события)
package {
Import flash.display.*:
import flash.events.*;
public class Console extends Sprite {
// Конструктор
public function Console ( ) {
var game:Game = new Game( ):
game.addEventL1stener(Game.GAME_OVER, gamedverListener): }
private function gameOverListener (e:Event):void { traceCThe game has ended!"):
// Отображает пользовательский интерфейс "back to console" (код не показан) }
}
}
Теперь рассмотрим другой пример, создающий событие для элемента пользовательского интерфейса.
Пользовательское событие "toggle"
Предположим, что мы создаем кнопку-переключатель, которая может быть использована в пользовательском интерфейсе. Она может принимать два положения — включения и выключения. Наша кнопка-переключатель представлена классом Toggleswitch. Всякий раз, когда кнопка включается или выключается, мы инициируем диспетчеризацию пользовательского события с именем "toggle”.
В предыдущем разделе событийный объект для нашего пользовательского события Game. GAME OVER представлял собой экземпляр внутреннего класса Event. На этот раз наше пользовательское событие будет представлено своим собственным классом ToggleEvent. Этот класс выполняет две следующие функции:
□ определяет константу для события toggle (ToggleEvent. TOGGLE);
□ задает переменную i sOn, которая будет использоваться приемниками для определения состояния объекта получателя Toggleswitch.
Далее представлен код класса ToggleEvent. Обратите внимание, что каждый пользовательский подкласс класса Event должен переопределять методы clone ( ) и toString ( ), предоставляя версии методов, которые учитывают все пользовательские переменные данного подкласса (например, isOn).
Код кнопки-переключателя в этом разделе демонстрирует исключительно реализацию события "toggle”. Код, необходимый для создания интерактивности и добавления графики, опущен.
package {
import flash.events.*:
// Класс, представляющий пользовательское событие "toggle"
public class ToggleEvent extends Event {
// Константа для типа события "toggle".
public static const TOGGLE:String = "toggle":
// Обозначает, включен или выключен переключатель public var isOn:Boolean:
// Конструктор
public function ToggleEvent (type:String.
bubbles:Boolean = false.
cancel able:Boolean = false.
isOn:Boolean = false) {
// Передаем параметры конструктора в конструктор суперкласса super(type, bubbles, cancelable):
// Запоминаем состояние переключателя, которое может быть использовано
// в приемниках события ToggleEvent.TOGGLE thls.lsOn = 1s0n;
}•
// Любой класс пользовательского события должен переопределить
// метод clone( )
public override function clone( ):Event {
return new ToggleEvent(type, bubbles, cancelable, isOn);
}
// Любой класс пользовательского события должен переопределить
// метод toStr1ng( ). Обратите внимание, что "eventPhase” - это
// переменная экземпляра, имеющая отношение к цепочке диспетчеризации
// событий (гл. 21).
public override function toStr1ng( ): String {
return formatToStr1ng("ToggleEvent", "type", "bubbles", "cancelable", "eventPhase", "isOn");
}
}
}
Теперь перейдем к классу Toggleswitch, который представляет кнопку-переключатель. Единственный метод toggle ( ) класса Toggleswitch изменяет состояние кнопки-переключателя, а затем выполняет диспетчеризацию события ToggleEvent. TOGGLE, которое обозначает изменение состояния переключателя. Следующий код демонстрирует класс Toggleswitch. Обратите внимание, что класс Toggleswitch расширяет класс Sprite, предоставляющий возможности для отображения объекта на экране. Кроме того, класс Sprite, являясь потомком класса EventDispatcher, предоставляет необходимую функциональность для диспетчеризации событий:
package {.
Import flash.display.*;
Import flash.events.*;
// Представляет простой элемент-переключатель
public class Toggleswitch extends Sprite {
// Запоминает состояние переключателя private var 1s0n;Boolean;
// Конструктор
public function ToggleSwItch ( ) {
// По умолчанию переключатель выключен 1s0n = false;
}
// Включает переключатель, если он был выключен, или
// выключает его
public function toggle ( ):vo1d {
// Изменяет состояние переключателя
1s0n = !1s0n;
// просим среду Flash выполнить диспетчеризацию
// события ToggleEvent.TOGGLE, получателем которого
// является данный объект ToggleSwitch
dispatchEvent(new ToggleEvent(ToggleEvent.TOGGLE, true, false, 1sOn));
}
}
}
Чтобы продемонстрировать использование события ToggleEvent. TOGGLE, создадим простой класс SomeApp. Этот класс определяет метод toggleListener ( ) и регистрирует его в объекте Toggleswitch для событий ToggleEvent. TOGGLE. Кроме того, для демонстрационных целей класс SomeApp программным путем включает переключатель, вызывая событие ToggleEvent. TOGGLE.
package {
Import flash.display.*;
// Простое приложение, демонстрирующее применение
// пользовательского события ToggleEvent.TOGGLE
public class SomeApp extends Sprite {
// Конструктор
public function SomeApp ( ) {
// Создание объекта ToggleSwitch
var toggleSwitch:ToggleSwitch = new ToggleSwitch( );
// Регистрация приемника для событий ToggleEvent.TOGGLE toggleSwitch.addEventListener(Toggl eEvent.TOGGLE, toggleListener);
// Изменяем состояние переключателя (обычно состояние
// изменяется пользователем, но для демонстрационных целей
// мы изменяем состояние программным путем) toggleSwitch.togglе( );
}
// Приемник выполняется каждый раз при возникновении события
// ToggleEvent.TOGGLE
private function toggleListener (e:ToggleEvent):void {
if (e.isOn) {
traceC'The ToggleSwitch is now on.");
} else {
traceC'The ToggleSwitch is now off.");
}
}
}
}
Теперь, когда мы приобрели опыт создания пользовательских событий, рассмотрим более сложный сценарий: пользовательское событие со стандартным поведением.
Отмена стандартного пооедення для пользовательских событий
В предыдущем разделе рассказывалось, что некоторые предопределенные события характеризуются стандартным поведением. Например, стандартное поведение события TextEvent. TEXT INPUT заключается в добавлении текста в текстовое поле. Мы также знаем, что для предопределенных событий, которые относятся к категории отменяемых, избежать стандартного поведения можно с помощью метода экземпляра preventDef ault ( ) класса Event.
Кроме того, пользовательские события могут характеризоваться определенным стандартным поведением, избежать которого можно также с помощью метода preventDefault ( ). Стандартное поведение пользовательского события полностью определяется и реализуется в программе. Общий подход, применяемый для создания событий с отменяемым стандартным поведением, заключается в следующем.
На этапе диспетчеризации события создать событийный объект, представляющий событие, передав в качестве параметра отменяемое конструктора класса Event значение true.
Использовать метод dispatchEvent ( ) для диспетчеризации события.
После завершения метода dispatchEvent ( ) использовать метод экземпляра isDefaultPrevented ( ) класса Event, чтобы определить, запрашивали ли приемники отмену стандартного поведения.
Если метод isDefaultPrevented ( ) событийного объекта вернет значение false, продолжать выполнение действий, относящихся к стандартному поведению; в противном случае не выполнять действий, относящихся к стандартному поведению.1
Рассмотрим обобщенный код для создания события с отменяемым стандартным поведением:
// Создание событийного объекта с произвольными значениями для параметров
// тип и всплывающее. Для параметра отменяемое (третий параметр) указывается
// значение true.
var e:Event = new Event(T^/7. всплывающее, true);
// Диспетчеризация события
dispatchEvent(e);.
// Проверить, запрашивали ли приемники отмену стандартного поведения.
// Если приемники не вызывали метод preventDefault( ),...
if (!e.1sDefaultPrevented( )) {
// ...выполняем действия, относящиеся к стандартному поведению
} .■
Рассмотрим описанные шаги на примере с кнопкой-переключателем. Предположим, мы используем нашу кнопку-переключатель в приложении с панелью управления, которое назначает различные привилегии своим пользователям в зависимости от их статуса. Пользователи-«гости» могут использовать только некоторые
кнопки на панели, в то время как пользователям-«администраторам» доступны все кнопки.
Для реализации различных уровней доступа в приложении мы определяем новый тип события кнопки-переключателя: ToggleEvent. TOGGLE_ATTEMPT. Это событие возникает всякий раз, когда пользователь пытается включить или выключить кнопку-переключатель. Стандартным поведением, характеризующим событие ToggleEvent.TOGGLE_ATTEMPT, является изменение состояния переключателя..
Для упрощения будем считать, что кнопку-переключатель можно включить или выключить только щелчком кнопки мыши (не используя клавиатуру). Всякий раз, когда пользователь щелкает на кнопке-переключателе, выполняется диспетчеризация события ToggleEvent. TOGGLE_ATTEMPT. Затем, если никакой приемник не отменяет стандартного поведения, мы изменяем состояние переключателя. Рассмотрим соответствующий код:
private function cl 1ckL1stener (e:MouseEvent):void {
// Пользователь попытался включить или выключить переключатель, поэтому
// просим среду Flash выполнить диспетчеризацию события
// ToggleEvent.TOGGLE_ATTEMPT. получателем которого является данный объект
// ToggleSwItch. Сначала создадим событийный объект...
var toggleEvent:ToggleEvent =
new ToggleEvent(ToggleEvent.TOGGLE_ATTEMPT.
true, true):•
H ... затем отправляем запрос на диспетчеризацию события
d1spatchEvent(toggleEvent):
// Диспетчеризация события ToggleEvent.TOGGLE-ATTEMPT завершена.
// Если никакой приемник не отменил стандартное поведение события...
if (!toggleEvent.1sDefaultPrevented( )) {
// ...изменяем состояние переключателя
togglе( );•
}
}'
В нашем приложении с панелью управления мы регистрируем приемник события ToggleEvent.TOGGLE_ATTEMPT для каждого объекта Toggleswitch. Внутри этого приемника проверяется статус пользователя. Для закрытых переключателей, если пользователь является «гостем», мы отменяем стандартное поведение события. Рассмотрим этот код:
// Приемник выполняется всякий раз. когда возникает событие
// ToggleEvent.TOGGLE_ATTEMPT
private function toggleAttemptListener (e:ToggleEvent):vo1d {
// Если пользователь является «гостем»...
if (userType == UserType.GUEST) {.
// ...запретить изменение состояния переключателя’
e.preventDefault( ):.
}.
В листинге 12.5 целиком показан код приложения с панелью управления, включая полнофункциональную, хотя и простую графическую версию кнопки-переключателя. Понять этот код вам помогут подробные комментарии.
Листинг 12.5. Классы приложения с панелью управления
// Класс ToggleEvent
package {
import fl ash.events.*;'
// Класс, представляющий пользовательское событие "toggle"
public class ToggleEvent extends Event {
// Константа для типа события "toggle"
public static const TOGGLE:String = "toggle";
// Константа для типа события "toggleAttempt"
public static const TOGGLE-ATTEMPT:String = "toggleAttempt";
// Обозначает текущее состояние переключателя -
// включен или выключен
public var 1s0n:Boolean;
// Конструктор
public function ToggleEvent (type:String,
bubbles-.Boolean = false, cancelable:Boolean = false, 1s0n:Boolean = false) {
// Передаем параметры конструктора в конструктор суперкласса super(type, bubbles, cancel able);
// Запоминаем состояние переключателя, которое может быть использовано
// в приемниках события ToggleEvent.TOGGLE this.1s0n = 1$0n;
}
// Любой класс пользовательского события должен переопределить
// метод clone( ).
public override function clone( )-.Event {
return new ToggleEvent(type, bubbles, cancelable, 1s0n);
}
// Любой класс пользовательского события должен переопределить•
// метод toString( )
public override function toString( ):String {
return formatToStr1ng("ToggleEvent", "type", "bubbles", "cancelable", "eventPhase", "IsOn"):
}
}
// Класс Toggleswitch
package {
import flash.display.*:
import flash.events.*;
// Представляет простую кнопку-переключатель co стандартным поведением public class ToggleSwitch extends Sprite {
// Запоминает состояние переключателя .
private var isOn:Boolean;
// Содержит графическое изображение кнопки-переключателя
private var icon .-Sprite:
// Конструктор
public function ToggleSwitch ( ) {
// Создаем объект Sprite, который будет содержать графическое
// изображение кнопки-переключателя
icon = new Sprite( ):
addChild(icon);.
// По умолчанию переключатель выключен
isOn = false;
drawOffState( ):
// Регистрируем приемник для получения уведомлений всякий раз,
// Если пользователь щелкнет кнопкой мыши
// на графическом изображении переключателя
icon.addEventListener(MouseEvent.CLICK, clickListener);
// Приемник, выполняемый после щелчка кнопкой мыши
// на кнопке-переключателе
private function clickListener (e:MouseEvent);void {
// Пользователь попытался включить или выключить переключатель,
// поэтому просим среду Flash выполнить диспетчеризацию
// события ToggleEvent.TOGGLE_ATTEMPT, получателем которого
// является данный объект ToggleSwitch. Сначала создадим
// событийный объект...
var toggleEvent:ToggleEvent =
new ToggleEvent(ToggleEvent.TOGGLE-ATTEMPT,true, true);
// ...затем отправляем запрос на диспетчеризацию события dispatchEvent(toggleEvent);
// Диспетчеризация события ToggleEvent.TOGGLE-ATTEMPT завершена.
// Если никакой приемник не отменил стандартное поведение события...
if ('toggleEvent.isDefaultPrevented( )) {
// ...изменяем состояние переключателя togglе( );
}
// Включает переключатель, если в настоящий момент он выключен, или
// выключает его, если переключатель включен. Стоит отметить, что состояние
// переключателя может быть изменено программным путем, даже если пользователь // не имеет привилегий изменить состояние переключателя вручную.
public function toggle ( );void {.
// Изменяем состояние переключателя
isOn = ИзОп:
// Рисуем для нового состояния переключателя соответствующее изображение
if (isOn) {’
drawOnState( );
} else {
drawOffState( );
}
// Просим среду Flash выполнить диспетчеризацию события
// ToggleEvent.TOGGLE, получателем которого является данный
// объект ToggleSwitch.
van toggleEvent:ToggleEvent = new ToggleEvent(ToggleEvent.TOGGLE,
true, false, isOn);
dispatchEvent(toggleEvent);
}
// Рисуем изображение для выключенного состояния
private function drawOffState ( ):void {
icon.graphics.clear( );
icon.graphics.lineStyle(l);.
icon.graphics.beginFill(OxFFFFFF);
icon.graphics.drawRect(O, 0, 20, 20);
// Рисуем изображение для включенного состояния private function drawOnState ( ):void {
icon.graphics.clear( );
i con.graphics.1ineSty1e(1);
icon.graphics.beginFill(OxFFFFFF);
icon.graphics.drawRect(0, 0, 20, 20);
icon.graphics.beginFill(0x000000);
icon.graphics.drawRect(5, 5, 10, 10);
// Класс Control Panel (основной класс приложения)
package {
import flash.display.*;
// Базовое приложение, которое демонстрирует отмену
// стандартного поведения для пользовательских событий
public class Controlpanel extends Sprite {
// Присваиваем уровень привилегий для пользователя данного приложения.
// В данном примере только пользователи с привилегиями UserType.ADMIN
// могут использовать кнопку-переключатель.
private var userType:int = UserType.GUEST;
// Конструктор
public function Control Panel ( ) {
// Создаем объект ToggleSwitch
var toggleSwitch:ToggleSwitch = new ToggleSwitch( );
// Регистрируем приемник для событий
// ToggleEvent.TOGGLE-ATTEMPT
toggleSwitch.addEventListener(ToggleEvent.TOGGLE-ATTEMPT, toggleAttemptListener);
// Регистрируем приемник для событий ToggleEvent.TOGGLE toggleSwitch.addEventListener(ToggleEvent.TOGGLE.
toggleListener);
// Добавляем кнопку-переключатель в иерархию отображения
// данного объекта
addChild(toggleSwitch);
}
// Приемник выполняется всякий раз, когда возникает событие
// Toggl eEvent. TOGGLE_AHEMPT
private function toggleAttemptListener (e:ToggleEvent):void {
// Если пользователь является «гостем»...
if (userType == UserType.GUEST) {
// ...запретить изменение состояния переключателя
e.preventDefaultC ):
}
}
// Приемник выполняется всякий раз, когда возникает событие
// ToggleEvent.TOGGLE
private function toggleListener (e:ToggleEvent):void {
if (e.isOn) {
traceCThe ToggleSwitch is now on.");
} else {
trace("The ToggleSwitch is now off.");
}
}
// Класс UserType
package {
// Определяет константы, представляющие уровни
// пользовательских привилегий в приложении
// с панелью управления’
public class UserType {
public static const GUEST:1nt = 0;-
public static const ADMIN:int =
Теперь, когда мы познакомились с пользовательскими событиями в ActionScript, рассмотрим две последние темы, связанные с событиями.
Недостаток проверки типов о событийной модели языка Actionscript
Событийная модель ActionScript, основанная на приемниках, включает несколько различных участников: приемник события, объект, регистрирующий этот приемник, получатель события, событийный объект и имя события. Диспетчеризация определенного события (и его обработка) завершится успешно только в том случае, если все участники будут надлежащим образом взаимодействовать между собой. Для этого должны выполняться следующие основные условия.
Должен существовать тип события, для которого регистрируется приемник.
Должен существовать сам приемник.
Приемник должен знать, как обрабатывать событийный объект, передаваемый в процессе диспетчеризации возникшего события.
Объект, осуществляющий регистрацию приемника, должен поддерживать указанный тип события.
Когда приемник регистрируется в объекте для получения события, он вступает в соглашение, основанное на типах данных, которое гарантирует выполнение первых трех условий. Если это соглашение не выполняется, компилятор генерирует ошибку типа. Например, рассмотрим следующий код, описывающий и регистрирующий приемник, в котором умышленно допущены три нарушения (выделенные полужирным шрифтом) контракта приемника события:
uг1 Loader.addEventL1stener(Event.COMPETE, completeListenr);
private function completeListener (e:MouseEvent):void { traceC'Load complete");
}.
В приведенном коде нарушения контракта приемника события заключаются в следующем.
Константа Event. COMPETE записана с ошибкой: пропущена буква Е. Компилятор сгенерирует ошибку, которая предупредит программиста о том, что тип события, для получения которого пытается зарегистрироваться приемник, не существует.
Название приемника события записано с ошибкой: пропущена еще одна буква е. Компилятор сгенерирует ошибку, которая предупредит программиста о том, что регистрируемый приемник не существует.
Типом данных первого параметра, передаваемого в метод completeLis tener ( ), является Мои sеЕ ven t, который не соответствует типу данных событийного объекта для события Event. COMPLETE. На этапе диспетчеризации события среда выполнения Flash сгенерирует ошибку, которая предупредит программиста, что приемник не может обработать переданный в него событийный объект.
Если мы изменим предыдущий код, исправив все указанные ошибки типа, диспетчеризация события и его обработка будут успешно выполнены.
Соглашение между приемником события и объектом, который регистрирует этот приемник, основанное на типах данных, позволяет гарантировать корректное выполнение нашего кода, обрабатывающего события.
Тем не менее соглашение между приемником и объектом, регистрирующим этот приемник, имеет один недостаток: оно не гарантирует, что объект поддерживает указанный тип события. Например, рассмотрим следующим код, который регистрирует приемник в объекте urlLoader для событий TextEvent. TEXT_INPUT:
urlLoader.addEventListener(TextEvent.TEXT_INPUT, textlnputLIstener);
Хотя с практической точки зрения у нас есть все основания полагать, что объект URLLoader никогда не будет получателем события TextEvent. TEXT_INPUT, приведенный код не вызовет ошибки. В языке ActionScript регистрация приемников для событий осуществляется по любому имени. Например, следующий бессмысленный код также является допустимым:
urlLoader.addEventListener("dlrognw", dlrognwLIstener):
Каким бы очевидным ни казалось то, что объект urlLoader никогда не будет получателем события с именем ” dl rognw”, программа на самом деле может выполнить диспетчеризацию такого события. Это демонстрирует следующий код:
urlLoader.d1spatchEvent(new Event("dlrognw"));
Учитывая, что программа имеет возможность назначать любой объект в качестве получателя любого события, язык ActionScript намеренно не использует концепцию «поддерживаемых событий». Подобная гибкость является предметом споров, поскольку она может привести к трудновыявляемым ошибкам в коде. Например, предположим, что мы используем класс Loader для загрузки внешнего изображения, как показано в следующем коде:
var loader:Loader = new Loader( ):
1oader. 1 oad(new URLRequest("1mage.jpg")):
Предположим также, что объект loader будет являться получателем событий, информирующих о завершении загрузки изображения (во многом аналогично тому, как объект URLLoader является получателем событий о завершении загрузки элемента). Таким образом, мы пытаемся обработать событие Event .COMPLETE для нашего загружаемого элемента, зарегистрировав приемник непосредственно в объекте Loader, как показано в следующем коде:
1oader.dddEventLIstener(Event.COMPLETE. completeListener):
Запустив код, мы будем удивлены, поскольку, даже несмотря на отсутствие ошибок, метод completeListener ( ) не был вызван ни разу. Так как никаких ошибок не возникло, мы не сможем сразу же определить источник проблемы в нашем коде. Последующий анализ и отладка кода будут стоить нам времени и, по всей вероятности, значительного неудовлетворения. Только прочитав соответствующий раздел документации корпорации Adobe, мы определим проблему: объекты Loader на самом деле не являются получателями событий о завершении загрузки; вместо этого события о завершении загрузки должны обрабатываться
экземпляром класса Loader Inf о каждого объекта Loader, как показано в следующем коде:
1oader.contentLoaderInfo.addEventListener(Event.COMPLETE, comp]eteListener);
В будущем язык ActionScript, возможно, позволит классам перечислять события, которые они поддерживают, и генерировать соответствующие предупреждения компилятора на попытки зарегистрировать приемник на события, которые не поддерживаются данным классом. Пока же классы, которые реализуют пользовательские события, путем переопределения метода addEventListener ( ) могут самостоятельно генерировать пользовательские ошибки в тех случаях, когда программа пытается зарегистрировать приемник для неподдерживаемых событий, как показано в следующем коде:
public override function addEventListener(eventType:String, handler:Function, capture:Boolean = false, priority:!nt = 0, weakRef:Boolean = false):void {
// Метод canDispatchEyent( ) (не показан) проверяет наличие
// указанного типа eventType в списке поддерживаемых •
// данным классом событий и возвращает значение типа Boolean,
// которое говорит о том, является ли указанный тип eventType’
// поддерживаемым типом событий
1f(canDi spatchEvent(eventType)) {
// Событие поддерживается, поэтому приступаем к регистрации
super.addEventListener(eventType, handler, capture, priority, weakRef);
} else {
// Событие не поддерживается, поэтому генерируем ошибку throw new Error(this + " does not support events of type '"
+ eventType + );•
}
Мораль этой истории такова: будьте особенно внимательны при регистрации приемника для события. Всегда убеждайтесь в том, что объект, в котором регистрируется приемник, на самом деле поддерживает требуемое событие.
Теперь рассмотрим последний вопрос, касающийся событийной модели: обработку событий в приложениях, состоящих из нескольких SWF-файлов, которые размещены в различных интернет-доменах. Для изучения следующего раздела необходимс иметь общее представление о методах загрузки SWF-файлов, которые рассматриваются в гл. 28.
Обработка событий между границами зон безопасности
В гл. 19 будет рассмотрено несколько сценариев, в которых ограничения безопас ности не позволяют одному SWF-файлу осуществлять кросс-скриптинг (управ лять программным путем) над другим файлом. Когда два SWF-файла не могу]
осуществлять кросс-скриптинг друг над другом из-за ограничений безопасности приложения Flash Player, к ним применяются следующие ограничения, связанные с обработкой событий.
Приемники событий из одного SWF-файла не могут регистрироваться для событий в объектах другого SWF-файла.
Если получателем события является объект в иерархии отображения, любые объекты, недоступные в SWF-файле объекта получателя, не включаются в цепочку диспетчеризации событий.
К счастью, описанные ограничения можно полностью обойти с помощью статического метода allowDomain ( ) класса flash. system. Security. Рассмотрим два примера, которые демонстрируют применение метода allowDomain ( ) для обхода каждого из этих ограничений.
Информацию по загрузке SWF-файлов можно найти в гл. 28.
Приемник из файла Mcdule.swf регистрируется в объекте файла Main.swf
Предположим, что SWF-файл, находящийся на одном сайте (site-a.com/Main.swf), загружает SWF-файл, расположенный на другом сайте (site-b.com/Module.swf). Предположим также, что в файле Module.swf определен приемник, который желает зарегистрироваться в объекте, созданном в файле Main. swf. Чтобы разрешить данную регистрацию, перед регистрацией приемника из файла Modul е. swf в файле Main. swf должна быть выполнена следующая строка кода:
Secur1ty.а11owDoma1n("s1te-b.com"):
Эта строка позволяет всем SWF-файлам, находящимся на сайте site-b.com (включая файл Module. swf), регистрировать приемники в любом объекте, созданном в файле Main. swf.
Приемник из файла Main.swf получает уведомление о событии, получателем которого является отображаемый объект в файле Module.swf
Продолжая рассматривать сценарий, в котором файл Main.swf загружает файл Module.swf из предыдущего раздела, предположим, что экземпляр основного класса файла Main. swf добавляет объект класса Loader, содержащий файл Module. swf, в свою иерархию отображения, как показано в следующем коде: ’
package {
Import fl ash.display.*;
Import flash.net.*:
Import fl ash.events.*:
public class Main extends Sprite { private var loader:Loader:
public function Ma1n( ) { loader = new Loader( );
1oader.1oad(new URLRequest("http://s1te-b.com/Modul e.swf"));
// Добавляем объект Loader, содержащий файл Module.swf, в иерархию
// отображения данного объекта addChlld(loader);
Предположим также, что экземпляр основного класса файла Main. swf желает получать уведомления всякий раз, когда пользователь щелкает кнопкой мыши на объекте из файла Module. swf. Следовательно, экземпляр основного класса файла Main, swf регистрирует приемник в объекте loader для событий MouseEvent. CLICK, как показано в следующем коде: package {
Import flash.display.*;
Import flash.net.*;
Import fl ash.events.*;•
public class Main extends Sprite { private var loader:Loader;
public function Ma1n( ) {
loader = new Loader( );
loader.-load(new URLRequest("http://s1 te-b.com/Module.swf"));
addChl1d(1oader);
1oader.addEventLIstener(MouseEvent.CLICK, cl 1ckL1stener);
}■ . .
private function clickListener (e:MouseEvent):void { trace("Module.swf was clicked"):
}
}
Тем не менее, поскольку файлы Main. swf и Module. swf размещены в различных интернет-доменах, ограничения безопасности запрещают вызывать метод clickListener ( ) для возникающих событий MouseEvent. CLICK, получателями которых являются отображаемые потомки объекта loader (то есть отображаемые объекты из файла Module . swf).
Для того чтобы обойти данное ограничение, конструктор основного класса файла Module. swf содержит следующую строку кода:
Secur1ty.а11owDoma1n(”s1tе-а.com");
После выполнения этой строки файл Module. swf начнет доверять файлу Main. swf (и всем SWF-файлам с сайта site-a.com), благодаря чему экземпляр основного класса файла Ma in. swf будет включен клиентской средой выполнения Flash в цепочку диспетчеризации события MouseEvent. CLICK, получателем которого являются объекты из файла Module . swf. В результате метод clickListener ( )
будет вызываться всякий раз при щелчке кнопкой мыши на объекте из файла Module. swf.
Подробную информацию о .методе allowDomain() и безопасности приложения Flash Player можно найти в разд. «Разрешения создателя (allowDomain())» гл. 19.
Стоит отметить, что вызов метода а 11 о wDoma in ( ) позволяет не только обрабатывать события между границами зон безопасности: все SWF-файлы из разрешенного домена получают возможность осуществлять кросс-скриптинг над SWF-файлом, в котором был вызван метод allowDomain ( ). Однако существует альтернатива всеобъемлющим разрешениям, выдаваемым методом allowDomain ( ).
Альтернатива методу allowDomain(): разделяемые события
В некоторых случаях SWF-файлы из различных доменов могут пожелать совместно использовать события, не предоставляя при этом всех полномочий для кроссскриптинга. Для решения подобных проблем приложение Flash Player предоставляет переменную экземпляра sharedEvents класса Loaderinfo. Переменная sharedEvents — это простой нейтральный объект, через который два SWF-файла могут отправлять события друг другу, независимо от ограничений, обусловленных требованиями безопасности. Этот подход позволяет осуществлять взаимодействие между SWF-файлами, основанное на событиях, не отменяя требований безопасности, но для его реализации требуется написание большего объема кода, чем при использовании альтернативного подхода с методом allowDomain ( ).
Рассмотрим применение переменной sharedEvents на примере. Предположим, что Томми основал компанию по производству фейерверков и создал рекламный сайт www.blast.ca с использованием технологии Flash. Томми нанял подрядчика Дерека для создания отдельного элемента, реализующего эффект, который заключается в хаотичной генерации анимированных взрывов фейерверков под указателем мыши. Дерек создает SWF-файл MouseEf feet. swf, в котором реализован этот эффект, и размещает его по адресу www.dereksflasheffects.com/MouseEffect.swf. Дерек говорит Томми загрузить файл MouseEf feet. swf в его приложение www.blast.ca/BlastSite.swf. Дерек и Томми согласились, что файл MouseEf feet. swf должен размещаться на сервере www.derekflasheffects.com, что в дальнейшем позволит Дереку легко обновлять данный файл, не внося при этом никаких изменений в сайт Томми.
Гомми просит Дерека изменить файл MouseEffeet. swf таким образом, чтобы енерация взрывов прекращалась в тот момент, когда указатель мыши покидает об- часть отображения приложения Flash Player. Дерек считает эту идею целесообраз- той и приступает к написанию соответствующего кода. В обычной ситуации, чтобы определить выход указателя мыши за пределы области отображения приложения Flash Player, код в файле MouseEf feet. swf должен зарегистрировать приемник з экземпляре Stage для событий Event. MOUSE_LEAVE. Однако, поскольку файты MouseEffeet. swf и Blastsite. swf размещены в разных доменах, файл 4ouseEffeet. swf не имеет доступа к экземпляру Stage. Томми решает, что
вместо того, чтобы предоставлять файлу MouseEf f ect. swf полный доступ к файлу Blastsite, swf, он просто переадресует все события Event .MOUSE_LEAVE файлу MouseEffeet. swf через переменную sharedEvents.
Листинг 12.6 демонстрирует код файла Blastsite. swf, относящийся к переадресации событий.
Листинг 12.6. Переадресация события через переменную sharedEvents package {
import flash.display.*;
import flash.net.*;
import fl ash.events.*;
import flash.system.*;
public class BlastSite extends Sprite { private var loader:Loader;
public function BlastSite ( ) {
// Загружаем файл MouseEffect.swf
loader = new Loader( );
loader.load(
new URLRequest("http://www.dereksflasheffects.com/MouseEffect.swf")); addChi1d(1oader);
// Регистрируем приемник для событий Event.MOUSE_LEAVE stage.addEventListener(Event.MOUSE_LEAVE. mouseLeaveListener);
}"
// Когда возникает событие Event.MOUSELEAVE,...
private function mouseLeaveListener (e:Event):void {
// ...переадресуем его файлу MouseEffect.swf
1oader.contentLoaderInfо.sharedEvents.di spatchEvent(e): }
}
Листинг 12.7 демонстрирует код файла MouseEf feet. swf, относящийся к обра ботке событий.
Листинг 12.7. Обработка события, полученного через переменную sharedEvents package {
import fl ash.di splay.Sprite;
import fl ash.events.*;
public class MouseEffect extends Sprite {
public function MouseEffect ( ) {
// Регистрируем приемник для событий Event.MOUSELEAVE, получаемых
// через переменную sharedEvents
1oaderInfo.sharedEvents.addEventListener(Event.MOUSELEAVE, mouseLeaveListener);
// Обрабатываем события Event.MOUSE_LEAVE. полученные через переменную
// sharedEvents
private function mouseLeaveListener (e:Event):vo1d {
trace("MouseEffect.mouseLeaveListener( ) was Invoked...");
// Здесь прекращаем генерацию взрывов...
}.
Дерек получил деньги за свою работу и отложил их на предстоящую поездку в Японию. Томми доволен эффектом взрывов, хотя и не уверен, что он способствовал увеличению продаж.
Что дальше?
Мы достигли больших успехов в изучении основ языка ActionScript. Если вы поняли концепцию прочитанных 12 глав, то теперь обладаете достаточными знаниями языка ActionScript, чтобы приступить к рассмотрению большей части API клиентской среды выполнения Flash. Таким образом, пришло время сделать собственный выбор. Если вы желаете продолжить знакомство с базовыми возможностями ActionScript, переходите к чтению гл. 13, в которой будет рассказано, как создавать код, позволяющий выходить из сбойных ситуаций на этапе выполнения программы. Если, с другой стороны, вы предпочитаете узнать, как использовать язык ActionScript для отображения содержимого на экране, сразу переходите к части II.
Обработка исключений и ошибок
В этой главе мы познакомимся с системой языка ActionScript, предназначенной для генерации и реагирования на ошибки этапа выполнения программы, которые называются исключениями. В языке ActionScript ошибки могут генерироваться как средой Flash, так и выполняемой программой. Ошибки, генерируемые средой Flash, называются предопределенными; ошибки, генерируемые программой, называются пользовательскими. В программе можно реагировать на любые ошибки (как предопределенные, так и пользовательские), или, иначе говоря, обрабатывать их с помощью инструкции try/catch/finally. Генерация ошибок осуществляется с помощью инструкции throw.
i**-*^Гi**-*^ГД?*Д?*Чтобы познакомиться с процессом генерации и обработки ошибок в программе, мы вернемся к нашей программе по созданию виртуального зоопарка.
i**-*^Г
i**-*^Г
Д?*
Д?*
Изменения, которые будут внесены в программу «Зоопарк» на протяжении этой главы, являются последними для этой программы до конца книги. Чтобы завершить программу по созданию виртуального зоопарка, мы должны рассмотреть вопросы, связанные с экранным программированием и работой с мышью, которые освещены в части II. Прочитав часть II, обратитесь к приложению, чтобы узнать, как добавить графику и интерактивность в программу «Зоопарк».
Механизм обработки исключений
Если помните, класс Virtual Pet определяет метод setName ( ), который присваивает значение переменной petName экземпляров класса VirtualPet. Чтобы освежить вашу память, ниже представлен соответствующий код класса VirtualPet (те части класса, которые не имеют отношения к присваиванию значения переменной petName, не приводятся):
public class VirtualPet {
private var petName:Str1ng;
public function setName (newName;Str1ng):void {
// Если длина заданного нового имени больше maxNameLength символов...
1f (newName.length > Virtual Pet.maxNameLength) {
// ...обрезать имя
newName = newName.substr(0, V1rtualPet.maxNameLength);
} else 1f (newName == "") {
// ...в противном случае, если заданное новое имя является
// пустой строкой, завершить выполнение метода, не изменяя
// значения переменной petName
return;
}
// Присвоить новое проверенное имя переменной petName petName = newName;
}
Метод setName ( ) перед тем, как изменить значение переменной petName, проверяет, является ли допустимым количество символов в новом имени животного. Если новое имя животного не является допустимым, значение переменной не изменяется; в противном случае изменение значения допускается.
Изменим метод setName ( ) таким образом, чтобы он генерировал исключение (оповещал об ошибке) в тех случаях, когда передаваемое значение параметра newName содержит недопустимое количество символов. Позднее мы добавим код, восстанавливающий работоспособность программы после ошибки, для обработки нового исключения, генерируемого в методе setName ( ).
Для генерации исключения в нашем коде мы используем оператор throw, который имеет следующий вид:
throw выражение
В предыдущем коде выражение — это значение данных, описывающее некоторую необычную или проблематичную ситуацию. Использование оператора throw для оповещения об ошибке иногда называется «генерацией исключения». Язык ActionScript позволяет использовать любое значение в качестве выражения выражение в операторе throw. Например, значением выражения выражение может быть строковый литерал "Something went wrong! " (Что-то не получилось!) или числовой код ошибки. Однако корпорация Adobe рекомендует использовать в качестве значения выражения выражение экземпляр предопределенного класса Error (или одного из его подклассов), считая этот подход хорошей практикой. Класс Error является стандартным классом, представляющим исключительные ситуации в программе. Его переменная экземпляра message используется для описания ошибки.
Оператор throw останавливает выполнение кода и передает значение выражения выражение в специальный блок кода, называемый блоком catch, который будет реагировать на возникшую проблему, или обрабатывать ее. Прежде чем рассмотреть, как работает блок catch, изменим метод setName ( ) таким образом, чтобы он генерировал исключение с помощью оператора throw, когда получено недопустимое значение параметра petName:
public function setName (newName:Str1ng):void {
// Если длина заданного нового имени больше maxNameLength символов...
if (newName.length > Virtual Pet.maxNameLength || newName = "") {
H ... генерируем ошибку
throw new Error("Invalid pet name specified.");
}
// Присвоить новое допустимое имя переменной petName
petName = newName:
}
В нашей новой версии метода setName ( ), если значение параметра newName является недопустимым, мы используем оператор throw для прекращения выполнения метода вместо того, чтобы просто обрезать указанное имя, как мы делали раньше. Кроме того, мы указываем описание проблемы — "Invalid pet name specified" (Указано недопустимое имя животного) — в качестве аргумента конструктора Error. Это описание определяет ситуацию, из-за которой возникла ошибка. Конструктор Error присваивает это описание переменной message созданного объекта Error.
Если метод setName ( ) не обнаружит никаких проблем со значением параметра newName, то он завершится нормально, и код, вызвавший его, может быть уверен, что работа, возложенная на этот метод, выполнена успешно. В противном случае блок catch должен обработать возникшую проблему. Блок catch является частью большой инструкции, называемой инструкцией try/catch/finally. Инструкция try/catch/ fin ally предусматривает план восстановления для кода, который может сгенерировать исключение. Вот общая структура типовой инструкции try/ catch/finally:
try {
// Код в этом блоке может генерировать исключения
} catch (е:тип) {
// Код в этом блоке обрабатывает возникшую проблему
} finally {
// Код в этом блоке выполняется всегда, независимо от того,
// сгенерировал блок try исключение или нет
}
В приведенном коде ключевое слово try сообщает среде Flash, что мы собираемся выполнить код, который может сгенерировать исключение. Блок catch обрабатывает исключения, генерируемые блоком try. Код в блоке catch выполняется в том, и только в том случае, когда код в блоке try сгенерировал исключение. Код в блоке final 1 у выполняется всегда после завершения выполнения блока try или catch. Блок final 1 у инструкции try/catch/finally обычно содержит очищающий код, который должен выполняться независимо от того, было сгенерировано исключение в соответствующем блоке try или нет.
Обратите внимание на типовую структуру.
Блок try выполняет код, который может сгенерировать исключение.
Код в блоке try использует оператор throw для оповещения о любых ошибках.
Если в блоке try не возникло никаких ошибок, то он выполняется полностью и программа пропускает блок catch.
Если в блоке try была сгенерирована ошибка, то его выполнение прекращается и начинается выполнение блока catch. Блок catch способен обрабатывать любые ошибки, возникающие в блоке try.
Выполняется блок final 1 у.
В большинстве случаев блок finally не требуется и, следовательно, опускается. В последующих примерах мы будем опускать блок finally. Далее, в разд. «Блок finally», мы рассмотрим пример использования этого блока.
Когда выполняется блок catch, он получает значение выражения выражение оператора throw в качестве параметра. В блоке catch это значение может помочь выявить ошибку, сгенерированную в блоке try. Образно говоря, код, в котором возникла проблема, бросает (throw) исключение (передает объект Error) в блок catch, который получает этот объект в качестве параметра (ловит (catch) его).
Далее в разд. «Передача исключений вверх по иерархии объектов» мы выясним, что произойдет в том случае, если возникшая ошибка не будет обработана.
Рассмотрим пример инструкции try/catch/finally:
try {
somePet.setName("James");
// Если мы находимся здесь, значит, исключение не возникло;
// продолжаем выполнение, как планировалось ранее. traceC'Pet name set successfully.");
} catch (e:Error) {.
// ОШИБКА! Недопустимые данные. Выводим предупреждение. traceCAn error occurred; " + e.message);
Если при вызове метода pet. setName ( ) внутри предыдущего блока try оператор throw метода setName ( ) не будет выполнен (если не произойдет никакой ошибки), то все последующие инструкции в блоке try будут выполнены успешно и программа полностью пропустит блок catch. Однако если метод setName ( ) сгенерирует исключение, программа немедленно прекратит выполнение инструкций в блоке try и перейдет к выполнению блока catch. В блоке catch значением параметра е является объект класса Error, переданный в оператор throw внутри метода setName ( ).
В предыдущем примере код в блоке catch при отладке просто отображает значение переменной message объекта Error. Однако в более сложном приложении блок catch может попытаться восстановить работоспособность программы после ошибки, возможно отобразив окно, которое позволит пользователю указать допустимое имя.
Обработка нескольких типов исключений
Пример исключения из предыдущего раздела был чрезмерно упрощен. Что произойдет, если наш метод генерирует ошибки нескольких типов? Все ошибки будут отправлены в один и тот же блок catch? Что ж, это зависит от разработчика. Конечно, они все могут быть отправлены в один блок catch, однако чаще всего обработка различных типов ошибок выполняется отдельными блоками cat ch — и это является хорошей практикой. Рассмотрим почему.
Предположим, что мы хотим получить набор более детальных сообщений об ошибках в нашем методе setName ( ): одно сообщение для недопустимых данных, одно — для слишком короткого имени, еще одно — для слишком длинного имени.
Тело нашего модифицированного метода setName ( ) могло бы выглядеть следующим образом:
1f (newName.indexOfC ") == 0) {
// Имена не могут начинаться с пробела...
throw new Error("Invalid pet name specified."):
} else 1f (newName == "") {
throw new ErrorC'Pet name too short."):
} else 1f (newName.length > Virtual Pet.maxNameLength) { throw new ErrorC'Pet name too long."):
}
Чтобы обработать все три возможные сообщения об ошибках, генерируемые в нашем новом методе setName ( ), мы могли бы записать код нашей инструкции try/catch/finallу следующим образом:
try {
somePet. setName("некоеИмяЖивотного");
// Если мы находимся здесь, значит, исключение не возникло;, продолжаем
// выполнение, как планировалось ранее.
traceC'Pet name set successfully."):
} catch (e:Error) { switch (e.message) { case "Invalid pet name specified.": traceC'An error occurred: " + e.message): traceC'Please specify a valid name."): break:
case "Pet name too short.":
traceC'An error occurred: " + e.message);
traceC'Please specify a longer name."): break:
case "Pet name too long.":
traceC'An error occurred: " + e.message): traceC'Please specify a shorter name."); break:
}
}
Надо признаться, что этот код работает, однако он имеет множество недостатков. Самый первый и наиболее серьезный недостаток состоит в том, что ошибки, отличаются друг от друга только текстом в строке, которая скрыта внутри класса Virtual Pet. Всякий раз, когда мы хотим узнать, какие типы ошибок могут возникать в методе setName ( ), мы вынуждены обращаться к коду класса VirtualPet и искать строки сообщений об ошибках. Использование сообщений для идентификации ошибок между различными методами и классами зачастую приводит к появлению ошибок, вызванных человеческим фактором, и затрудняет поддержку нашего кода. Второй недостаток заключается в том, что оператор switch сам по себе сложен для чтения. Это ненамного лучше использования, скажем, числовых кодов ошибок вместо формальных исключений.
К счастью, существует официальный (и элегантный) способ обработки нескольких типов исключений. Каждый блок try может иметь любое количество вспомогательных блоков catch. Когда исключение генерируется в блоке try, который имеет несколько блоков catch, среда Flash выполняет тот блок catch, тип данных параметра которого совпадает с типом данных значения сгенерированного исключения.
Рассмотрим общий синтаксис оператора try с несколькими блоками catch:
try {
// Код, который может генерировать исключения.
} catch 1е:Тип0шибкиВ {'
// Код обработки ошибки с типом ТипОшибки!.
} catch (е:Тип0шибки2') {
// Код обработки ошибки с типом Тип0шибки2.
} catch (е;ТипОшибкип) {
// Код обработки ошибки с типом ТипОшибкип.
}
Если бы оператор throw в предыдущем блоке try сгенерировал исключение, применив в качестве параметра выражение типа ТипОшибки!, был бы выполнен первый блок catch. Например, следующий код приведет к выполнению первого блока catch: throw new ТипОшибкиК );
Если бы в оператор throw было передано выражение типа Тип0шибки2, был бы выполнен второй блок catch и т. д. Как уже известно, в языке ActionScript выражение оператора throw может принадлежать любому типу данных. Однако помните, что в большинстве программ исключения представляются только экземплярами класса Error или одного из его подклассов и это является хорошей практикой.
Если мы хотим генерировать несколько типов исключений в приложении, для каждого типа исключения мы определяем отдельный подкласс класса Error. Вам, как разработчику, необходимо определить требуемую степень детализации (то есть указать, до какой степени обособлять различные исключительные ситуации).
Определение степени детализации типов исключений. Следует ли определять подкласс класса Error для каждой исключительной ситуации? Обычно ответ на этот вопрос отрицателен — вам не потребуется такая степень детализации, поскольку во многих случаях несколько исключительных ситуаций могут иметь одинаковый смысл. Если вам не нужно задавать различие между несколькими исключительными ситуациями, то можете объединить эти ситуации в одном пользовательском подклассе класса Error. Например, вы можете определить один подкласс класса Error с именем InvalidlnputExcept ion для решения широкого круга проблем, связанных с вводом данных.
С другой стороны, вы должны определять отдельный подкласс класса Error для каждой исключительной ситуации, которая, по вашему мнению, отличается от других возможных ситуаций. Чтобы разобраться, когда следует создавать новый подкласс для конкретной исключительной ситуации, а также продемонстрировать возможность группирования нескольких ситуаций в одном подклассе, вернемся к методу setName ( ).
Ранее мы генерировали три исключения в методе setName ( ). Все три исключения использовали базовый класс Error. Приведем этот код снова:
if (newName. IndexOfC ") == 0) {
// Имена не могут начинаться с пробела...
throw new Error("Inval1d pet name specified."):
} else if (newName == "") {
throw new ErrorCPet name too short."):
} else if (newName.length > VlrtualPet.maxNameLength) {
throw new ErrorCPet name too long."):
}
В данном коде, чтобы провести различие между исключениями класса Virtual Pet и остальными исключениями в нашем приложении, мы использовали переменную message класса Error, которая, как уже известно, делает наши исключения неудобными для использования и может привести к появлению ошибок, вызванных человеческим фактором. Для отличия ошибок, относящихся к классу Virtual Pet, от других ошибок в нашем приложении лучше определить пользовательский подкласс класса Error с именем VirtualPetNameException, как показано в следующем коде:,
// Код в файле VirtualPetNameException.as:
package zoo {
public class VirtualPetNameException extends Error {
public function VirtualPetNameException ( ) {
// Передаем сообщение об ошибке в конструктор класса Error, которое
// будет присвоено переменной message данного объекта'
super("Invalid pet name specified."):
Теперь, когда у нас появился класс VirtualPetNameException, метод setName ( ) может генерировать свой собственный тип ошибки, как показано в следующем коде:
public function setName (newName:Stri ng):void {
if (newName. IndexOfC ") == 0) {
throw new V1rtualPetNameExcept1on( ):
} else if (newName == "") {
throw new V1rtualPetNameException( ):
} else if (newName.length > Virtual Pet.maxNameLength) {
throw new V1rtualPetNameExcept1on( ):
petName = newName:
Обратите внимание, что в предыдущем описании метода для всех трех исключительных ситуаций, относящихся к классу VlrtualPet, генерируется один и тот же тип ошибки (VirtualPetNameException). Как разработчики класса VlrtualPet мы столкнулись с проблемой определения степени детализации исключительных ситуаций. Мы должны решить не только то, в какой мере сообщения об ошибках класса
Virtual Pet будут отличаться от других ошибок приложения, но и то, насколько эти ошибки будут отличаться друг от друга. У нас есть следующие варианты:
Вариант 1. Использовать один класс для исключительных ситуаций класса VirtualPet.
В этом случае мы оставляем предыдущее описание метода s е tName ( ) как есть. Как вскоре станет известно, этот вариант позволяет отличать ошибки класса VirtualPet от других базовых ошибок в программе, однако мы не сможем отличить между собой три внутренние разновидности ошибок класса Virtual Pet (недопустимые данные, слишком короткое имя животного и слишком длинное имя животного).
Вариант 2. Упростить код, но по-прежнему использовать один класс для исключительных ситуаций класса VirtualPet.
В данном случае мы изменяем метод setName ( ) таким образом, чтобы проверка всех трех исключительных ситуаций выполнялась в одном операторе if. Этот вариант аналогичен предыдущему, но использует более сжатый код.
Вариант 3. Использовать отладочные сообщения для нахождения различий между ошибками.
В данном случае мы добавляем конфигурируемые отладочные сообщения в класс VirtualPetNameException. Этот вариант незначительно увеличивает степень детализации по сравнению с двумя предыдущими, но только для удобства разработчика и только на этапе отладки.
Вариант 4. Создать пользовательский класс исключения для каждой исключительной ситуации.
Используя это вариант, мы создаем два пользовательских подкласса класса VirtualPetNameException: VirtualPetlnsufficientDataException иVirtualPetExcessDataException. Этот вариант обеспечивает наибольшую степень детализации. Он позволяет программе независимо реагировать на три разновидности ошибок, относящихся к классу VirtualPet, используя формальную логику ветвлений.
Рассмотрим каждый из описанных вариантов.
Варианты 1 и 2. Использование одного пользовательского типа исключения. Первый вариант состоит в применении предыдущего описания метода setName ( ), которое генерирует ошибку одного и того же типа (VirtualPetNameException) для всех трех исключительных ситуаций, относящихся к классу VirtualPet. Поскольку для генерации исключений этот метод использует класс VirtualPetNameException, а не класс Error, исключения класса Virtual Pet уже отличаются от других базовых исключений. Пользователи метода setName ( ) могут применять код, аналогичный следующему, для отличия ошибок, относящихся к классу VirtualPet, от других базовых ошибок:
try {
// Этот вызов метода setName( ) приведет к возникновению исключения
// VirtualPetNameException.
somePet.setNameС”);
// Другие инструкции в этом блоке try могут генерировать
// другие базовые ошибки. Для демонстрационных целей
// мы непосредственно сгенерируем
// базовую ошибку.
throw new ErrorCA generic error.");
} catch (e:VirtualPetNameException) {
// Здесь обрабатываются ошибки, связанные с именем объекта класса
// Virtual Pet.
traceCAn error occurred: " + e.message);
traceCPlease specify a valid name.");
} catch (e:Error) {
// Здесь обрабатываются все остальные ошибки.
traceCAn error occurred: " + e.message);
}
Для большого количества приложений степень детализации, обеспечиваемая классом Virtual РеtNameExcept ion, оказывается достаточной. В этом случае мы должны по крайней мере переписать метод setName ( ), чтобы он не содержал избыточный код (трижды генерирующий исключение VirtualPetNameException). Рассмотрим переписанный код (представляющий вариант 2 из предыдущего списка):
public function setName (newName: St г 1 ng): void {
if (newName.IndexOfC ") == 0
|| newName == ""
|| newName.length > Virtual Pet.maxNameLength) {
throw new V1rtualPetNameExcept1on( );
}
petName = newName: }
Переписывание кода с целью улучшения его структуры без изменения существующего поведения называется рефакторингом.
Вариант 3. Применение конфигурируемых отладочных сообщений. Вариант 3 заключается в добавлении конфигурируемых отладочных сообщений в класс VirtualPetNameException. Варианты 1 и 2 позволяют отличить исключение класса Virtual Pet от других исключений в приложении, но не позволяют отличить исключение «слишком длинное» от исключения «слишком короткое». Если вы чувствуете, что отладка проблемы, связанной с именем объекта класса Virtual Pet, затруднена отсутствием знания о том, является имя объекта класса Virtual Pet слишком длинным или слишком коротким, можно изменить класс VirtualPetNameException таким образом, чтобы он принимал дополнительное описание (наподобие общеизвестного крестика на память). Рассмотрим измененный код класса VirtualPetNameException:
package zoo {
public class VirtualPetNameException extends Error {
// Предоставляет конструктор, который позволяет указывать
// пользовательское сообщение. Если пользовательское сообщение не
// указано, используется стандартное сообщение об ошибке
public function VirtualPetNameException (
message:String = "Invalid pet name specified.") {
super(message);
}
} }
Чтобы воспользоваться модифицированным классом Virtual PetNameExcept ion в методе setName ( ), вернемся к коду метода setName ( ), использованному в варианте 1, и добавим отладочные сообщения об ошибке, как показано в следующем коде:
public function setName (newName:String):void {
1f (newName. IndexOfC ") == 0) {
// В данном случае отлично подойдет стандартное сообщение об ошибке,
// поэтому не стоит утруждать себя указанием пользовательского сообщения // об ошибке.
throw new V1rtual PetNameExceptl on( );
} else if (newName == "") {
// Вот пользовательское сообщение об ошибке «слишком короткое».
throw new V1rtualPetNameExceptlon("Pet name too short."): .
} else 1f (newName.length > Virtual Pet.maxNameLength) {
// Вот пользовательское сообщение об ошибке «слишком длинное».
throw new VirtualPetNameExceptlon("Pet name too long.");
}
petName = newName;
}
Теперь, когда метод setName ( ) задает пользовательские сообщения об ошибках, упрощается отладка проблем, связанных с именем объекта класса Virtual Pet, поскольку у нас появляется возможность получить больше информации о возникшей ошибке. Использование метода setName ( ) не изменилось, но теперь, если что-то пойдет не так, мы будем лучше проинформированы, как показано в следующем коде: try {
// Этот вызов метода setName( ) приведет к возникновению исключения
// VirtualPetNameExceptlon.
somePet.setNameC");
} catch (e:VirtualPetNameExceptlon) {
// Здесь обрабатываются ошибки, связанные с именем объекта класса
// Virtual Pet. В данном случае полезным отладочным сообщением является:
// An error occurred: Pet name too short
// (Возникла ошибка: Имя животного слишком короткое).
traceCAn error occurred: " + е.message);
} catch (e:Error) {
// Здесь обрабатываются все остальные ошибки.
traceCAn error occurred: " + е.message);
}
Вариант 4. Пользовательские подклассы класса VirtualPetNameException. В варианте 3 мы добавляли конфигурируемые отладочные сообщения в класс VirtualPetNameException. Он помог выявить проблему в нашем коде на этапе разработки, однако этот вариант не позволяет программе выполнить независимые действия по восстановлению работоспособности после возникновения отдельных
ошибок класса Virtual Pet. Чтобы программа могла выполнить отдельные ветки кода в зависимости от типа сгенерированной ошибки класса VirtualPet, нам потребуются пользовательские подклассы класса VirtualPetNameException, описанные в варианте 4.
Если вы хотите, чтобы программа могла находить различия между исключительными ситуациями, определяйте отдельный подкласс класса Error для каждой ошибки. Не полагайтесь исключительно на значение переменной message, чтобы реализовать логику ветвлений. Если ваш пользовательский подкласс класса Error определяет конструктор, принимающий сообщение об ошибке в качестве параметра, используйте это сообщение только для отладки, но не для построения логики ветвлений.
Чтобы иметь возможность устанавливать различие между тремя исключительными ситуациями класса VirtualPet, создадим три подкласса класса Error: VirtualPetNameException, Virtual Pet Insuffici ent DataExcept ion и Vir tualPetExcessDataException. Первый класс непосредственно расширяет класс Error. Оба следующих класса расширяют класс VirtualPetNameException, поскольку мы хотим отличать эти специфические типы ошибок от базового исключения, обозначающего недопустимые данные.
Рассмотрим исходный код наших трех подклассов класса Error, представляющих ошибки класса VirtualPet:
// Код в файле VirtualPetNameException.as:
package zoo {
public class VirtualPetNameException extends Error {
public function VirtualPetNameException (
•message:String = "Invalid pet name specified.") {
super(message);
}
}
}
// Код в файле VirtualPetlnsufficientDataException.as:
package zoo {
public class VlrtualPetlnsufficientDataException
extends VirtualPetNameException { public function VirtualPetlnsufficientDataException ( ) {
super("Pet name too short.");
}
}
}
// Код в файле VirtualPetExcessDataException.as:
package zoo {
public class VirtualPetExcessDataException
extends VirtualPetNameException { public function VirtualPetExcessDataException ( ) {
super("Pet name too long.");
}
}
Каждый класс определяет значение своей переменной message и не позволяет изменять его в процессе использования. При обработке любого из описанных исключений класса VirtualPet наша программа будет руководствоваться типом данных исключения (а не значением переменной message) для нахождения различия между тремя типами исключений.
Теперь, когда у нас появилось три типа исключений, добавим их генерацию в наш метод setName ( ):
public function setName (newName:Str1ng):void {
1f (newName. IndexOfC ") == 0) {
throw new V1rtualPetNameExcept1on( );
} else 1f (newName == "") {
throw new V1rtualPetInsuff1c1entDataExcept1on( ):
} else 1f (newName.length > Virtual Pet.maxNameLength) {
throw new VirtualPetExcessDataExcept1on( );
}
petName = newName;
}
Обратите внимание, что в конструкторы различных исключений класса Virtual Pet не передаются никакие описания ошибок. Еще раз повторим, что описание каждого исключения задается в соответствующем пользовательском подклассе класса Error через его переменную message.
Теперь, когда каждое исключение класса VirtualPet представлено собственным классом, программистам, работающим с экземплярами класса VirtualPet, известны все ошибки, которые могут быть сгенерированы методом setName ( ). Типы исключений доступны за пределами класса VirtualPet и, соответственно, открыты для программистов, работающих над приложением. Разработчику достаточно взглянуть на иерархию классов приложения, чтобы определить исключения, относящиеся к классу VirtualPet. Более того, если он случайно укажет неправильное имя для исключения, компилятор сгенерирует ошибку типа.
Рассмотрим, как добавить в код логику ветвления, основанную на типах исключений, которые могут быть сгенерированы методом setName ( ). Особое внимание обратите на типы данных параметров и размещение каждого блока catch.
try {..
b.setName("некоеИмяЖивотного”);
} catch (e:V1rtualPetExcessDataExcept1on) {
// Обработка ситуации «слишком длинное».
traceCAn error occurred: " + e.message):
trace("Please specify a shorter name."):
} catch (e:V1rtualPetInsuff1c1entDataExcept1on) {
// Обработка ситуации «слишком короткое».
traceCAn error occurred: " + e.message):
traceCPlease specify a longer name."):
} catch (e:V1rtualPetNameExcept1on) {
// Обработка общих ошибок, связанных с именем.
traceCAn error occurred: " + е.message):
traceCPlease specify a valid name."):
}
В приведенном коде, если метод setName ( ) сгенерирует исключение Virtu alPetExcessDataException, будет выполнен первый блок catch. Если метод сгенерирует исключение VirtualPetlnsufficientDataException, будет выполнен второй блок catch. И наконец, если метод сгенерирует исключение VirtualPetNameException, будет выполнен третий блок catch. Обратите внимание, что в блоках catch сначала перечислены специфические типы данных ошибок, а затем — общие. При возникновении исключения выполняется тот блок catch, у которого первым совпадет тип данных параметра с типом данных исключения.
Таким образом, если мы изменим тип данных параметра первого блока catch на тип VirtualPetNameException, первый блок catch будет выполняться для всех трех типов исключений!
Й
Вспомните, что класс VirtualPetNameException является суперклассом для обоих классов VirtualPetlnsufficientDataException и VirtualPetExcessDataException, поэтому считается, что они соответствуют типу данных VirtualPetNameException.
Фактически мы могли бы предотвратить выполнение всех блоков catch, разместив первым новый блок catch, типом данных параметра которого является Error: try {
b.setName("некоеИмяЖивотного"):
} catch (e:Error) {
// Обрабатываем все ошибки. Никакие другие блоки catch
// выполняться не будут.
traceCAn error occurred:" + е.message);
traceCThe first catch block handled the error.");
} catch (e:V1rtualPetExcessDataExcept1on) {
// Обработка ситуации «слишком длинное».
traceCAn error occurred: " + e.message);
traceCPlease specify a shorter name.");
} catch (e:V1rtualPetInsufficientDataExcept1on) {
// Обработка ситуации «слишком короткое».
traceCAn error occurred: " + e.message):
traceCPlease specify a longer name.");
} catch (e:VirtualPetNameException) {
// Обработка общих ошибок, связанных с именем.
traceCAn error occurred: " + е.message);
traceCPlease specify a valid name."): }
Очевидно, что попытка добавить первый блок catch в предыдущем коде обречена на провал, но этот пример иллюстрирует иерархическую природу обработки ошибок. Поместив базовый блок catch в самое начало списка обработчиков, мы можем обработать все ошибки в одном блоке. И наоборот, если поместить базовый блок catch в конец списка, мы можем создать «страховочную сетку», которая будет обрабатывать любые ошибки, не «пойманные» предыдущими блоками catch. Например, в следующем коде последний блок catch будет выполнен только в том
случае, если блок try сгенерирует исключение, которое не принадлежит типам данных VirtualPetExcessDataException, Virtual Pet In sufficient Dat а Exception или VirtualPetNameException:
try {
b.setName("некоеИмяЖивотного");
} catch (e:VirtualPetExcessDataException) {
// Обработка переполнения.
traceC'An error occurred: " + e.message);
traceCPlease specify a smaller value."):
} catch (e:Virtual PetInsuff1c1entDataExcept1on) {
// Обработка нулевой длины.
traceC'An error occurred: " + e.message);
traceCPlease specify a larger value.");
} catch (e;VirtualPetNameException) {
// Обработка общих ошибок, связанных с размерностью.
traceC'An error occurred: " + е.message);
traceCPlease specify a valid dimension.");
} catch (e:Error) {
// Обработка любых ошибок, которые не относятся
// к ошибкам VirtualPetNameException.
}
Не забывайте, что выбор степени детализации ошибок зависит от ситуации. Реализуя вариант 4, мы создали пользовательские подклассы класса Error для каждого исключения, генерируемого классом VirtualPet. Этот подход дает нашей программе максимальную возможность независимо обрабатывать различные типы ошибок. Однако во многих ситуациях подобная гибкость является излишней. Будет лучше, если степень детализации ошибок будет определяться требованиями логики вашей программы.
Передача исключений вверх по иерархии объектов
В ActionScript исключение может быть сгенерировано в любом месте программы, даже в сценарии кадра на временной шкале! В этом случае возникает вопрос: каким образом среда выполнения Flash находит соответствующий блок catch для обработки этого исключения? И что произойдет при отсутствии блоков catch? Эти загадки решаются с. помощью магии передачи исключений вверх по иерархии объектов. Проследуем по пути передачи исключений вместе со средой Flash с того момента, как она выполнит в программе оператор throw. В ходе последующей инсценировки «размышления» среды выполнения Flash оформлены в виде комментариев.
После исполнения оператора throw нормальная работа программы немедленно прекращается и среда Flash пытается найти блок try, который содержит этот оператор. Например, рассмотрим оператор throw:
// Среда выполнения Flash: Хм. Оператор throw.
// Существует ли блок try, который содержит этот оператор?
throw new ErrorC'Somethlng went wrong");
Если оператор throw включен в блок try, среда выполнения Flash пытается найти блок catch, тип данных параметра которого совпадает с типом данных значения сгенерированного исключения (в данном случае с типом Error):
// Среда выполнения Flash: Отлично, я нашла блок try.
// Существует ли соответствующий блок catch?
try {
throw new ErrorC'Somethlng went wrong");
}
Если соответствующий блок catch найден, среда выполнения Flash передает управление программой этому блоку: try {•
throw new ErrorC'Somethlng went wrong");
// Среда выполнения Flash: Найден блок catch, типом данных параметра
// которого является Error! Поиск завершен. Сейчас я выполню этот // блок catch...
} catch (e:Error) {’
// Обработка ошибок...
}
Однако если соответствующий блок catch не может быть найден или если оператор throw изначально не был включен в блок try, среда Flash проверяет, размещен ли этот оператор внутри метода или функции. Если да, то среда выполнения ищет блок try вокруг кода, вызвавшего этот метод или функцию. Следующий код демонстрирует, как среда Flash реагирует на оператор throw, который размещен внутри метода и не включен в блок try:
public function doSomethlng ( ):void {
// Среда выполнения Flash: Хм. Блок try отсутствует.
// Проверю, кто вызвал этот метод.
throw new ErrorC'Somethlng went wrong");
}
Если код, вызвавший этот метод или функцию, включен в блок try, среда Flash попытается найти соответствующий блок catch и, если такой блок будет найден, выполнит его. Следующий код демонстрирует исключение, генерируемое в методе и обрабатываемое там, где вызывается этот метод (то есть уровнем выше по стеку вызовов):
public class Problemclass {
public function doSomethlng ( ):void {
// Среда выполнения Flash: Хм. Блок try отсутствует.
// Проверю-ка я, кто вызвал этот метод.
throw new ErrorC'Somethlng went wrong");
}
}
// Среда выполнения Flash: Ага, вот кто вызвал метод doSometh1ng( ). // И вот блок try, включающий этот код, вместе с блоком catch, типом // данных параметра которого является Error! Моя работа сделана.
// Блок catch, пожалуйста, выполняйтесь...
try {
var problemobject:Problemclass = new ProblemClassC );
problemObject.doSometh1ng( ):
} catch (e:Error) {
// Обработка ошибок...
trace("Exception caught in ErrorDemo, thrown by doSometh1ng( )."): }'
Стек вызовов — это список функций или методов программы, исполнением которых среда Flash занимается в любой момент времени. Функции и методы размещаются в списке в порядке, обратном порядку их вызова, по направлению сверху вниз. Если функция находится непосредственно под другой функцией в стеке вызовов, значит, нижняя функция была вызвана верхней функцией. Самая нижняя функция в стеке вызовов — это функция, выполняемая в настоящий момент.
В приложении Flex Builder и среде разработки Flash вы можете использовать отладчик для просмотра стека вызовов текущей программы, как описано в документации корпорации Adobe.
В предыдущем коде исключение, сгенерированное методом, было поймано блоком try/catch, в который включена инструкция вызова метода. Тем не менее, если вокруг кода, вызывающего функцию или метод, не найден блок try, среда выполнения Flash просматривает весь стек вызовов в поисках блока try с соответствующим блоком catch. Следующий код демонстрирует метод, генерирующий ошибку, которая обрабатывается двумя уровнями выше в стеке вызовов:
public class Problemclass {
public function doSomethlng ( ):vo1d {
// Среда выполнения Flash: Хм. Блок try отсутствует.^
// Проверю-ка я, кто вызвал этот метод.
throw new Error("Someth1ng went wrong"):
}
}
public class Normalclass {
public function Normalclass ( ) {
// Среда выполнения Flash: Ага, вот кто вызвал метод doSometh1ng( ).
//Но здесь все равно нет блока try. Проверю,
//кто вызвал этот метод.
var problemobject:Problemclass = new ProblemClassC );
problemobject.doSometh1ng( );
}
}
// Среда выполнения Flash: Ага! Нашла блок try, который имеет блок
//catch, типом данных параметра которого
//является Error! Моя работа сделана.
//Блок catch, пожалуйста, выполняйтесь...
try {
var normalobject:NormalClass = new NormalClass( );
} catch (e:Error) {
// Обработка ошибок...
trace("Exception caught in ErrorDemo, thrown by doSometh1ng( ).");
}
}
}
Обратите внимание, что среда выполнения Flash находит блок try/catch, даже несмотря на то, что этот блок не включает ни код, генерирующий ошибку, ни код, который вызывает метод, генерирующий ошибку, а только код, вызывающий метод, который, в свою очередь, вызывает метод, генерирующий ошибку!
Следующий код демонстрирует предыдущий пример с передачей исключения вверх по иерархии объектов в контексте нашей программы по созданию виртуального зоопарка. Для краткости в следующем листинге показан только код, присваивающий объекту имя животного. Комментарии в коде описывают, как происходит передача исключения.
package {.
Import flash.display.Sprite;
Import zoo.*;
public class Virtual Zoo extends Sprite { private var pet:Virtual Pet;
public function Virtual Zoo ( ) { try {
// Этот код пытается присвоить животному слишком длинное имя.
// В результате метод setName( ) генерирует ошибку.
// Однако возникшее исключение не обрабатывается в конструкторе
// класса Virtual Pet (откуда вызывается метод setName( )). Вместо
// этого исключение обрабатывается там, где вызывается конструктор
// класса VirtualPet (то есть двумя уровнями выше в стеке вызовов) pet = new Virtual Pet("Bartholomew McGillicuddy");
} catch (e:Error) {
traceCAn error occurred: " + e.message):
// Если в процессе создания объекта VirtualPet возникает исключение,
// объект не будет создан. Таким образом, здесь мы создадим новый
// объект VirtualPet с предопределенным допустимым именем.
pet = new Virtual Pet("Unnamed Pet");
}
}
}
}
package zoo {
public class VirtualPet {
public function VlrtualPet (name:Str1ng):void {
// Даже несмотря на то, что метод setName( ) вызывается здесь,
// исключения, генерируемые методом setName( ), не обрабатываются // в данном конструкторе. Они обрабатываются выше в стеке вызовов // кодом, который создал данный объект VlrtualPet.
setName(name);
}
public function setName (newName:String):void {
// Исключения, генерируемые в этом методе, не обрабатываются здесь.
// Они обрабатываются на два уровня выше в стеке вызовов кодом, // который создал данный объект VlrtualPet.
if (newName.1ndex0f(" ") == 0) {'
throw new V1rtualPetNameExcept1on( );
} else 1f (newName == "") {
throw new V1rtualPetInsuff1c1entDataExcept1on( ):
} else 1f (newName.length > VlrtualPet.maxNameLength) { throw new V1rtualPetExcessDataExcept1on( );
}
petName = newName;
}
}
}
Необработанные исключения. Мы рассмотрели ряд сценариев, в которых обрабатывались различные ошибки. Что же произойдет в том случае, когда среда выполнения Flash не найдет блок catch, способный обработать сгенерированное исключение? Если подходящий блок catch не найден во всем стеке вызовов, то Flash завершает выполнение кода, который на текущий момент остается в стеке вызовов. Кроме того, если программа выполняется в отладочной версии среды Flash, информация о возникшей ошибке появится в отдельном окне: в окне Output (Вывод) (среда разработки Flash) или в окне Console (Консоль) (приложение Flex Builder). После этого выполнение программы продолжится в обычном режиме.
Следующий код демонстрирует метод, генерирующий ошибку, которая никогда не будет обработана:
public class Problemclass {
public function doSomethlng ( ):vo1d {
// Среда выполнения Flash: Хм. Блок try отсутствует.
// Проверю-ка я, кто вызвал этот метод.
throw new Error("Someth1ng went wrong");
} }
public class ErrorDemo extends Sprite { public function ErrorDemo ( ) {
// Среда выполнения Flash: Ага, вот кто вызвал метод doSometh1ng( ).
// Но здесь все равно нет блока try. Хм. Я просмотрела весь стек вызовов
// до самого верха и не нашла блока try. Если это отладочная версия // среды выполнения Flash, я сообщу о проблеме. Возможно, программист
// знает, что нужно делать.
var problemobject:ProblemClass = new ProblemClasst );
problemObject.doSometh1ng( ):
}
}
Как мы только что увидели, метод не обязан обрабатывать свои собственные исключения, поскольку исключения обладают способностью подниматься вверх по стеку вызовов. Исключения метода не обязан обрабатывать даже код, вызывающий этот метод. Обработка исключения допускается на любом уровне в стеке вызовов. Любой метод может делегировать обработку исключений коду, вызывающему данный метод. С другой стороны, генерация исключений, которые никогда не будут обработаны, является дурным тоном и оказывает опасное воздействие на программу. Вы должны всегда обрабатывать исключения или, если столкнетесь с необработанным исключением, в первую очередь изменить свой код, чтобы избежать повторной генерации данного исключения.
Блок finally
Пока мы рассмотрели лишь блоки try и catch инструкции try/catch/finally. Как уже известно, блок try содержит код, который может генерировать исключение, а блок catch включает в себя код, который выполняется в ответ на сгенерированное исключение. Для сравнения, блок finally содержит код, который выполняется всегда, независимо от того, возникло в блоке try исключение или нет.
Инструкция try/catch/finally содержит один (и только один) блок finally, который является ее последним блоком. Например: try {.
// Вложенные инструкции
} catch (еЛипОшибки!) {
// Обработка исключений типа ТипОшибки!.
} catch (еЛипОшибкип) {
// Обработка исключений типа ТипОшибкип.
} finally {
// Этот код выполняется всегда, независимо от того, как завершается // выполнение блока try.
}
Неправильное размещение блока finally вызовет ошибку на этапе компиляции.
В предыдущем коде блок finally будет выполнен сразу после того, как:
выполнение блока try завершится без ошибок;
блок catch обработает исключение, сгенерированное блоком try;
необработанное исключение поднимется вверх по иерархии объектов;
оператор return, continue или break передаст управление программой за пределы блоков try или catch.
Блок final 1у инструкции try/ cat ch/final 1у обычно содержит очищающий код, который должен выполняться независимо от того, возникло исключение в соответ-
ствующем блоке try или нет. Предположим, что мы создаем игру в жанре «космический шутер» и определяем класс Spaceship, представляющий космические корабли. У класса Spaceship есть метод attackEnemy ( ), который выполняет следующее.
Устанавливает текущую цель для космического корабля.
Стреляет по выбранной цели.
□ Удаляет выбранную цель (присваивая переменной currentTarget объекта Spaceship значение null).
Предположим, что в нашем гипотетическом приложении при выполнении первых двух из описанных задач может возникнуть исключение. Более того, предположим, что метод attackEnemy ( ) не обрабатывает эти исключения самостоятельно; он передает исключения вызывающему методу. Независимо от того, было сгенерировано исключение или нет, метод attackEnemy ( ) должен присвоить переменной currentTarget значение null.
Вот так выглядел бы метод attackEnemy ( ), если бы мы запрограммировали его с помощью оператора catch (то есть без использования блока-finally):
public function attackEnemy (enemy:SpaceSh1p):void {
try {.
setCurrentTarget(enemy);
f1reOnCurrentTarget( ):
} catch (e:Error) {
// Удаляем текущую цель, если возникло исключение.
setCurrentTarget(nul1);
// Передаем исключение вызывающему методу, throw е;
// Удаляем текущую цель, если никаких исключений не возникло. setCurrentTarget(nul1);
}
Здесь мы вынуждены дублировать инструкцию setCurrentTarget (null). Мы поместили ее и внутрь блока catch, и после инструкции try/catch, гарантируя тем самым, что она будет выполнена независимо от того, возникло исключение в блоке try или нет. Тем не менее дублирование инструкции может привести к ошибке. В предыдущем методе программист мог бы легко забыть удалить текущую цель после блока try/catch.
Если изменить нашу стратегию так, чтобы текущая цель удалялась в блоке fina 11 у, мы устраним ненужные команды в предыдущем коде:
public function attackEnemy (enemy:SpaceShlp):void {
try {
setCurrentTarget(enemy);
f1reOnCurrentTarget( ):
} finally {•'
setCurrentTarget(nul1):
В модифицированной версии блок finally удаляет текущую цель независимо от того, возникло исключение или нет. Поскольку блок finally обрабатывает обе ситуации, у нас нет необходимости в блоке catch; мы можем просто позволить исключению автоматически подняться вверх к вызывающему методу.
Вы можете поинтересоваться, а зачем нам вообще нужен блок finally? Иными словами, почему нельзя просто использовать следующий код?
// Этот код выглядит подходящим, однако в нем существует проблема.
// Сможете определить ее?
public function attackEnemy (enemy: SpaceSM р): void {
setCurrentTarget(enemy);
f1re0nCurrentTarget( );
setCurrentTarget(nul1);
}
Запомните, что, когда генерируется исключение, управление программой передается в ближайший подходящий блок catch в стеке вызовов. Следовательно, если метод fir concurrent Target ( ) генерирует исключение, управление передается в метод attackEnemy ( ), при этом обратно в метод fireOnCurrentTarget ( ) управление возвращено не будет и инструкция setCurrentTarget (null) останется невыполненной. Однако с помощью блока finally мы гарантируем, что инструкция setCurrentTarget (null) будет выполнена до того, как исключение поднимется вверх по иерархии объектов.
Пример метода attackEnemy ( ) отражает наиболее распространенное использование блока finally в многопоточных приложениях, в которых одновременно может выполняться сразу несколько фрагментов кода и которые разрабатываются с помощью таких языков программирования, как, например, Java. В языке Java следующая общая структура — обычное явление; она исключает возможность удаления объекта, выполняющего некую задачу, другим объектом в процессе выполнения текущей задачи:
// Установить состояние, обозначающее выполнение данным объектом текущей
// задачи. Внешние объекты должны проверять состояние данного объекта перед
// тем, как обратиться к нему или выполнить над ним какие-либо действия.
do1ngSomethlng = true;
try {
// Выполняем задачу.
doSometh1ng( ):
} finally {
// Сбросить состояние, обозначающее выполнение текущей задачи (независимо
// от того, возникло в процессе выполнения задачи исключение или нет).
do1ngSomethlng = false:•
}
В языке ActionScript приведенный код, управляющий состоянием объекта, на самом деле необязателен, поскольку разрабатываемые с помощью этого языка приложения являются однопоточными, следовательно, никакой внешний объект не сможет изменить состояние другого объекта, выполняющего некий метод. Таким образом, в языке ActionScript блок finally используется гораздо реже, чем в языках, применяемых для разработки многопоточных приложений. Тем не менее этот блок
можно использовать для организационных целей — помещать в него код, который выполняет очистку после выполнения другого кода.
Вложенные исключения
До сих пор мы использовали только одноуровневые инструкции try/catch/ finally, однако логика обработки исключений может быть и вложенной. Инструкция try/catch/finally может размещаться внутри блока try, catch или finally другой инструкции try/catch/finally. Такое иерархическое вложение позволяет любому блоку инструкции try/catch/finally выполнять код, который, в свою очередь, может генерировать исключения.
Предположим, что мы создаем многопользовательское веб-приложение, представляющее доску объявлений. Мы определяем следующие классы: Bullet inBoard — основной класс приложения, GUIManager — класс, управляющий пользовательским интерфейсом, и User — класс, который представляет пользователя на доске. В классе Bullet inBoard мы описываем метод populateUserList ( ), который отображает список активных пользователей на текущий момент. Выполнение мето- дapopulateUserList ( ) состоит из двух этапов: на первом этапе метод получает экземпляр класса List из экземпляра класса GUIManager нашего приложения. Класс List представляет отображаемый на экране список пользователей. Затем метод populateUserList ( ) заполняет экземпляр класса List пользователями из переданного массива экземпляров класса User. На обоих этапах существует потенциальная возможность возникновения исключения, поэтому в методе populateUserList ( ) используется вложенная структура try/catch/finally. Рассмотрим эту вложенную структуру поближе.
EcлинaпepвoмэтaпeвыпoлнeниямeтoдapopulateUserList ( ) экземпляр класса List окажется недоступным, будет сгенерировано исключение UserListNotFound экземпляром класса GUIManager. Исключение UserListNotFound обрабатывается внешней инструкцией try/catch/finally.
Если, с другой стороны, экземпляр класса List окажется доступным, метод populateUserList ( ) перейдет к выполнению второго этапа, где с помощью цикла заполнит экземпляр класса List пользователями из переданного массива. На каждой итерации цикла, если ID текущего пользователя не может быть найдено, метод User. gelD ( ) генерирует исключение UserldNotSet. Оно обрабатывается вложенной инструкцией try/catch/finally.
Рассмотрим этот код:
public function populateUserList (users:Array):vo1d { try {
// Приступаем к выполнению этапа 1... получаем экземпляр класса List.
// Если метод getUserL1st( ) сгенерирует исключение, будет выполнен // внешний блок catch.
var u!1st:L1st = getGUIManager( ).getUserL1st( );
// Приступаем к выполнению этапа 2... заполняем экземпляр класса List.
for (var 1-.Number = 0; 1 < users.length: 1++) { try {
var th1 sllser:User = User(users[1]);
// Если метод getID( ) сгенерирует исключение, будет выполнен // вложенный блок catch. В противном случае пользователь будет // добавлен в экземпляр класса List вызовом метода addltem( ). ul1st.addItem(th1sUser.getName( ), th1sllser.getID( ));
} catch (e:UserldNotSet) { trace(e.message); continue; // Пропускаем этого пользователя.
}
}
} catch (e:UserL1stNotFound) { trace(e.message);
Теперь, когда мы рассмотрели конкретный пример вложенного исключения, познакомимся с общим процессом обработки вложенных исключений.
Если исключение генерируется в блоке try, вложенном в другой блок try, и внутренний блок try содержит блок catch, способный обработать сгенерированное исключение, выполняется внутренний блок catch и программа продолжает свое выполнение сразу после внутренней инструкции try/catch/finally.
try {
try {
// Здесь генерируется исключение.•
throw new ErrorCTest error");
} catch (e:Error) {
// Здесь обрабатывается исключение.
trace(e.message); // Выводит: Test error
// Здесь продолжается выполнение программы.
} catch (e:Error) {'"
// Обработка исключений, генерируемых внешним блоком try.
}
Если, с другой стороны, исключение возникло в блоке try, вложенном в другой блок try, однако внутренний блок try не содержит блока catch, способного обработать данное исключение, сгенерированное исключение будет передаваться вверх к внешней инструкции try/catch/finally (и при необходимости дальше по стеку вызовов) до тех пор, пока не будет найден подходящий блок catch или пока не будет достигнута верхняя точка стека вызовов. Если исключение будет обработано в некоторой точке стека вызовов, то выполнение программы продолжится сразу после инструкции try/catch/finally, обработавшей это исключение. Обратите внимание, что в следующем примере кода (и последующих примерах) гипотетический тип данных ошибки SomeSpecificEr гог является заполнителем, используемым для того, чтобы сгенерированное исключение не было поймано. Чтобы протестировать пример кода в вашем собственном коде, вы должны создать подкласс SomeSpecificError класса Error.
try {
try {
// Здесь генерируется исключение.
throw new ErrorCTest error");
} catch (e:SomeSpedf1cError) {
// Здесь исключение не обрабатывается.
trace(e.message); // Инструкция никогда не будет выполнена, // поскольку типы не совпадают.
} catch (е:Error) {
// Исключение обрабатывается здесь.
trace(e.message); // Выводит; Test error
// Выполнение программы продолжается здесь, сразу после обработки исключения // внешним блоком catch.
Если исключение генерируется в блоке try, вложенном в блок catch, и внутренний блок try не имеет блока catch, способного обработать данное исключение, поиск подходящего блока catch начинается за пределами внешней инструкции try/catch/finally:
try {
// Здесь генерируется внешнее исключение.
throw new ErrorCTest error Г');
} catch (e:Error) {
// Здесь обрабатывается внешнее исключение.
trace(e.message); // Выводит; Test error 1
try {
// Здесь генерируется внутреннее исключение.
throw new ErrorCTest error 2");
} catch (e;SomeSpec1f1cError) {
// Внутреннее исключение здесь не обрабатывается.
trace(e.message); И Инструкция никогда не будет выполнена, // поскольку типы не совпадают.
}
}
// Процесс поиска подходящего блока catch для внутреннего исключения // начинается здесь.
Наконец, если исключение генерируется в блоке try, вложенном в блок finally, но при этом предыдущее исключение уже находится в процессе подъема по стеку вызовов, новое исключение будет обработано до того, как предыдущее исключение продолжит свой подъем по иерархии объектов.
// Этот метод генерирует исключение в блоке finally.
public function throwTwoExceptlons ( ):vo1d {
try {
// Здесь генерируется внешнее исключение. Поскольку этот блок try
// не имеет соответствующего блока catch, внешнее исключение начинает
// свой подъем по иерархии объектов.
throw new ErrorCTest error Г');
} finally {
try {•
// Здесь возникает внутреннее исключение. Внутреннее исключение
// будет обработано до того, как внешнее исключение фактически начнет
// подъем по иерархии объектов.
throw new ErrorCTest error 2");
} catch (e:Error) {
// Внутреннее исключение обрабатывается здесь. trace("Internal catch: " + e.message);
// Где-то в другом месте, внутри метода, // вызывающего предыдущий метод, try {
throwTwoExcept1ons( );
} catch (e:Error) {
// Здесь обрабатывается внешнее исключение,
// поднявшееся из метода throwTwoExcept1ons( ).
trace("External catch: " + e.message);
// Вывод (обратите внимание, что внутреннее исключение обработано первым):
// Internal catch: Test error 2
// External catch: Test error 1
Если бы в предыдущем коде исключение, сгенерированное в блоке finally, не было обработано, среда Flash сообщила бы об ошибке на этапе отладки и прекратила бы выполнение оставшегося кода в стеке вызовов. В результате никакой код в стеке вызовов не обработал бы сгенерированное первым внешнее исключение. Следующий код демонстрирует описанный сценарий. Этот код генерирует необрабатываемое исключение в блоке finally. В итоге исключение, сгенерированное внешним блоком try, будет потеряно.
try {•
// Здесь генерируется внешнее исключение.
throw new ErrorCTest error Г');
} finally { try {
// Здесь генерируется внутреннее исключение.
throw new ErrorCTest error 2");
} catch (e:SomeSpec1f1cError) {
// Внутреннее исключение здесь не обрабатывается.
traceCInternal catch: " + е.message); И Инструкция никогда не будет
// выполнена, поскольку типы
// не совпадают.
И Процесс поиска подходящего блока catch для внутреннего исключения
// начинается здесь. Если внутреннее исключение не будет обработано, о нем
// сообщит среда выполнения Flash на этапе отладки, при этом передача // внешнего исключения вверх по иерархии объектов будет прекращена.
Предыдущий код демонстрирует влияние необработанного исключения на ход выполнения программы в одном сценарии, однако хочется еще раз повторить, что
не следует допускать появления необрабатываемых исключений. В предыдущем случае мы должны либо обработать исключение, либо модифицировать наш код таким образом, чтобы данное исключение больше не появлялось.
Изменение хода выполнения проградимы в инструкции try/catch/finally
На протяжении этой главы мы неоднократно убеждались в том, что инструкция throw изменяет ход выполнения программы. Когда среда Flash встречает инструкцию throw, она немедленно прекращает выполнение текущей задачи и передает управление программой подходящим блокам catch и finally. Тем не менее блоки catch и finally также могут влиять на ход выполнения программы с помощью оператора return (в случае метода или функции), break или continue (в случае цикла). Более того, операторы return, break и continue могут также использоваться в блоке try.
Чтобы познакомиться с правилами изменения хода выполнения программы в инструкции try/catch/finally, рассмотрим, как оператор return влияет на ход выполнения программы в блоках try, catch и finally. Следующий пример кода содержит функцию changeFlow ( ), которая демонстрирует ход выполнения программы в различных гипотетических ситуациях.
В листинге 13.1 показан оператор return в блоке try, помещенный перед инструкцией, генерирующей ошибку. В данном случае метод выполняется нормально и никакая ошибка не будет сгенерирована или обработана. Однако перед возвратом из метода будет выполнен блок finally. Стоит отметить, что вы вряд ли увидите код, в точности повторяющий код из листинга 13.1, в реальной программе. В большинстве случаев оператор return используется в условных операторах и выполняется в ответ на некоторое определенное условие в программе.
Листинг 13.1. Использование оператора return в блоке try перед оператором throw
public function changeFlow ( ):vo1d {
try {'
return;
throw new ErrorCTest error.");•
} catch (e:Error) {
trace("Caught: " + e.message);
} finally {
trace("Finally executed.");
}
traceCLast Une of method."); ■
}
// Вывод после вызова метода changeFlow( ):
// Finally executed.■
В листинге 13.2 показан оператор return в блоке try, помещенный после инструкции, генерирующей ошибку. В данном случае return не выполнится, поскольку ошибка будет сгенерирована до того, как программа дойдет до этого оператора. Как только
ошибка будет обработана и выполнение инструкции try/ cat ch/finally завершится, выполнение программы продолжится после данной инструкции try/cat ch/finally и выход из метода произойдет в конце его тела. Снова повторим, что листинг 13.2 всего лишь демонстрирует принцип, но не является типичным в реальном сценарии, поскольку ошибка обычно генерируется на основании некоторого условия.
Листинг 13.2. Использование оператора return в блоке try после оператора throw
public function changeFlow ( ):void {
try {
throw new Error("Test error.");
return;
} catch (e:Error) {
trace("Caught: " + e.message):
} finally {
trace("Finally executed.");
}
traceCLast line of method.");
}
// Вывод после вызова метода changeFlow( ):
// Caught: Test error.
// Finally executed.
// Last line of method.
Листинг 13.3 демонстрирует использование оператора return в блоке catch. В данном случае return будет выполнен после завершения процесса обработки ошибки. При этом код, размещенный после инструкции try/catch/finally, выполнен не будет. Однако, как обычно, перед возвратом из метода будет выполнен блок fin а 11 у. В отличие от листингов 13.1 и 13.2 данный код является типичным в реальном сценарии, когда выполнение метода прекращается при возникновении ошибки.
Листинг 13.3. Использование оператора return в блоке catch
public function changeFlow ( ):void {.
try {
throw new ErrorCTest error.");
} catch (e:Error) {
trace("Caught: " + e.message);
return;
} finally {■
trace("Finally executed.");
}
traceCLast line of function.");
}
// Вывод после вызова метода changeFlowC ):
// Caught: Test error.
// Finally executed. ,.
Из-за известной ошибки в- приложении Flash Player 9 при выполнении кода из листингов 13.2 и 13.3 происходит обращение к несуществующей области стека. Корпорация Adobe планирует исправить эту проблему в следующей версии приложения Flash Player. .
В листинге 13.4 показан оператор return в блоке finally. В данном случае он выполняется тогда, когда выполняется блок finally (как уже известно, выполнение блока finally происходит после завершения соответствующего блока try одним из следующих способов: без ошибок; с обработанной ошибкой; с необработанной ошибкой; в результате вызова операторов return, break или continue). Обратите внимание, что оператор return в листинге 13.4 предотвращает выполнение кода, размещенного после инструкции try/catch/ finally. Вы можете использовать подобную методику для завершения метода после выполнения блока кода независимо от того, было сгенерировано исключение или нет. При этом вся инструкция try/catch/finally обычно помещается внутрь условного оператора (иначе оставшаяся часть метода никогда не будет выполнена!).ч
Листинг 13.4. Использование оператора return в блоке finally
public function changeFlow ( ):vo1d {
try {
throw new ErrorCTest error."):
} catch (e:Error) {
trace("Caught: " + e.message):
} finally { .
trace("Finally executed.");
return;
}
traceCLast Une of method."): // He выполняется.
}
11 Вывод после вызова метода changeFlow( ): Caught: Test error.
Finally executed.
Если оператор return в блоке finally вызывается после того, как был вызван оператор return в соответствующем блоке try, вызов return в блоке finally отменяет предыдущий вызов return.
Обработка предопределенного исключения
В самом начале этой главы мы узнали, что с помощью инструкции try/catch/ finally можно обрабатывать как предопределенные, так и пользовательские ошибки. До настоящего момента все обрабатываемые нами ошибки были пользовательскими. Сейчас мы рассмотрим инструкцию try/catch/finally, обрабатывающую предопределенную ошибку.
Предположим, что мы создаем приложение для обмена текстовыми сообщениями, в котором при соединении с сервером данного приложения пользователю предлагается ввести номер порта. Мы присваиваем указанный номер порта переменной с именем user Port. После этого мы пытаемся подключиться к указанному порту,
используя класс Socket. В некоторых случаях установить соединение не получится из-за ограничений безопасности. Чтобы показать, что причиной неудачной попытки соединения являются ограничения безопасности, среда выполнения Flash генерирует исключение SecurityError. Таким образом, при попытке создать соединение мы помещаем соответствующий код в блок try. Если установить соединение не получится по причинам безопасности, мы отобразим для пользователя сообщение об ошибке, обозначив проблему, из-за которой возникла данная ошибка.
var socket:Socket = new SocketC );*
try {
// Пытаемся подключиться к указанному порту
socket.connect("example.com". userPort);
} catch (e:SecurityError) {
// Код, расположенный здесь, отображает сообщение для пользователя
}
Список причин, которые могут привести к ошибкам соединения сокета, можно найти *<? 4 # в описании метода connect() класса Socket в справочнике по языку ActionScript корпо-
——рации Adobe.
События об ошибках в случае проблемных ситуаций. В предыдущем разделе мы рассмотрели, как обработать исключение, вызванное недопустимой попыткой установить соединение сокета. Однако не все сбойные ситуации в языке ActionScript приводят к генерации исключений. Информация о проблемах, возникающих асинхронно (то есть спустя некоторое время), передается через события об ошибках, а не через исключения. Например, если мы попытаемся загрузить файл, среда выполнения Flash в асинхронном режиме сначала должна проверить, существует ли запрашиваемый файл. Если этот файл не существует, среда Flash выполнит диспетчеризацию события lOErrorEvent. IO_ERROR. Чтобы обработать возникшую проблему, код, инициировавший операцию загрузки, должен зарегистрировать обработчик для события lOErrorEvent. IO ERROR. Если этого не произойдет, возникнет ошибка на этапе выполнения. Пример обработчика события об ошибке можно найти среди примеров в подразд. «Два дополнительных примера регистрации приемников событий» разд. «Основы обработки событий в ActionScript» гл. 12.
Впереди еще одна скучная работа
Исключения никогда не являлись самым эффектным аспектом программирования. Зачастую куда более забавно создавать программы, нежели выяснять, почему эти программы работают неправильно. Тем не менее обработка ошибок — это важная часть в разработке любой программы. В следующей главе мы рассмотрим еще одну похожую скучную тему, посвященную сборке мусора. Сборка мусора помогает предотвратить ситуацию, когда программа полностью исчерпывает системную память.
Сборка мусора
Всякий раз, когда программа создает объект, среда выполнения Flash сохраняет его в системной памяти (например, ОЗУ). По мере того как программа создает сотни, тысячи или даже миллионы объектов, объем памяти, занимаемой этой программой, постепенно увеличивается. Чтобы предотвратить полное исчерпывание системной памяти, Flash автоматически удаляет из нее объекты, когда программа перестает в них нуждаться. Процесс автоматического удаления объектов из памяти называется сборкой мусора.
Доступность объектов для сборки мусора
В программе на языке ActionScript любой объект становится доступным для процесса сборки мусора сразу после того, как он окажется недостижимым. Объект считается недостижимым, когда к нему невозможно обратиться прямо или косвенно хотя бы через один корневой элемент сборки мусора. К наиболее значимым корневым элементам сборки мусора в языке ActionScript можно отнести следующие:
переменные, определенные на уровне пакета;
локальные переменные в выполняющемся методе или функции;
статические переменные;
переменные экземпляра основного класса программы;
переменные экземпляра объекта, находящегося в списке отображения среды выполнения Flash;
переменные, находящиеся в цепочке областей видимости выполняющейся функции или метода.
Например, рассмотрим следующую версию класса VirtualZoo из нашей программы «Зоопарк». Обратите внимание, что в этой версии объект VirtualPet, создаваемый в конструкторе класса VirtualZoo, не присваивается переменной, package {
import flash.display.Sprite;
import zoo.*;
public class VirtualZoo extends Sprite {
public function VirtualZoo ( ) {
new VirtualPet("Stan");
}■
При выполнении конструктора класса VirtualZoo из предыдущего кода выражение new VirtualPet (’’Stan”) создает новый объект класса VirtualPet. Однако обратиться к объекту после его создания невозможно, поскольку он не был присвоен никакой переменной. Как результат, созданный объект считается недостижимым и сразу же становится доступным для сборки мусора.
Теперь рассмотрим следующую версию класса VirtualZoo. Особое внимание уделите телу метода-конструктора, выделенного полужирным шрифтом:
package {
import fl ash.di splay.Sprite;
import zoo.*;
public class VirtualZoo extends Sprite {
public function VirtualZoo ( ) {
var pet:Virtual Pet ^ new Virtual Pet("Stan"):
}
} }
Как и раньше, при выполнении конструктора класса VirtualZoo из предыдущего кода выражение new VirtualPet (” Stan”) создает новый объект класса VirtualPet. Однако на этот раз созданный объект класса VirtualPet присваивается локальной переменной pet. В конструкторе класса VirtualZoo к объекту VirtualPet можно обратиться через эту локальную переменную, поэтому данный объект недоступен для сборки мусора. Тем не менее, как только выполнение конструктора VirtualZoo будет завершено, время жизни переменной pet истечет и обратиться к объекту VirtualPet будет невозможно. Как результат, объект считается недостижимым и становится доступным для сборки мусора.
Далее рассмотрим следующую версию класса VirtualZoo:
package {'
import flash.display.Sprite;
import zoo.*;
public class VirtualZoo extends Sprite {
private var pet:Virtual Pet:
public function VirtualZoo ( ) {
pet = new Virtual Pet("Stan"):
}
}
При выполнении конструктора класса VirtualZoo из предыдущего кода выражение new VirtualPet (’’Stan”) снова создает объект класса VirtualPet. Однако на этот раз созданный объект VirtualPet присваивается переменной экземпляра основного класса программы. По существу, этот объект считается достижимым и поэтому недоступен для сборки мусора.
Теперь рассмотрим следующую версию класса VirtualZoo (снова обратите внимание на фрагменты кода, выделенные полужирным шрифтом):
package {
import flash.display.Sprite:
import zoo.*:
public class Virtual Zoo extends Sprite {
private var pet:Virtual Pet;
public function Virtual Zoo ( ) {
pet = new VirtualPetCStan");
pet = new VlrtualPetCTIm"):
}
}
}
Как и раньше, первая строка конструктора из предыдущего кода создает объект класса VirtualPet и присваивает его переменной экземпляра pet. Однако вторая строка метода-конструктора из предыдущего кода создает егце один объект класса VirtualPet и тоже присваивает его переменной экземпляра pet. Вторая операция присваивания заменяет первое значение переменной pet (то есть животное с именем Stan) новым значением (то есть животным с именем Tim). Как результат, объект VirtualPet с именем Stan считается недостижимым и становится доступным для сборки мусора. Стоит отметить, что, если бы мы присвоили переменной pet значение null (или любое другое допустимое значение), как показано в следующем коде, объект VirtualPet с именем Stan также оказался бы недостижимым:
pet = null:
Наконец, рассмотрим следующую версию класса VirtualZoo, в которой определены две переменные экземпляра petl и pet2:
package {
import flash.display.Sprite:
import zoo.*:
public class VirtualZoo extends Sprite {
private var petl:Virtual Pet;
private var pet2:Virtual Pet;
public function VirtualZoo ( ) {
petl = new VirtualPetCStan");
pet2 = petl:
petl = null: pet2 = nul1;
}
}
Как и раньше, первая строка конструктора из предыдущего кода создает объект класса VirtualPet; для удобства назовем его ’’Stan”. Кроме того, первая строка присваивает объект "Stan" переменной petl. Затем вторая строка присваивает тот же объект переменной экземпляра pet2. После выполнения второй строки конструктора и перед выполнением третьей строки программа может обратиться
к объекту "Stan" как через переменную petl, так и через переменную pet2, поэтому данный объект недоступен для сборки мусора. Третья строка заменяет значение переменной petl значением null, так что объект "Stan" оказывается недоступен через эту переменную. Тем не менее к объекту "Stan" по-прежнему можно обратиться через переменную pet2, поэтому данный объект все еще недоступен для сборки мусора. Наконец, четвертая строка заменяет значение переменной pet2 значением null. Как результат, к объекту "Stan" больше нельзя обратиться через какую-либо переменную. «Бедный» объект "Stan" оказывается недостижимым и официально становится доступным для сборки мусора.
В языке Actionscript существует два особых случая, когда являющийся достижимым объект становится доступным для сборки мусора. Соответствующую информацию можно найти в разд. «Приемники событий и управление памятью» гл. 12 и в описании класса Dictionary справочника по языку Actionscript корпорации Adobe.
Алгоритм поэтапных пометок и вычищений
В предыдущем разделе рассказывалось, что объект становится доступным для сборки мусора (автоматического удаления из памяти) в тот момент, когда он оказывается недостижимым. Однако мы так и не выяснили, когда недостижимые объекты удаляются из памяти. В идеальном мире объекты должны удаляться из памяти сразу после того, как они оказались недостижимыми. Однако на практике незамедлительное удаление недостижимых объектов отнимает очень много времени и приводит к тому, что большинство нетривиальных программ выполняется медленно или вообще не отвечает на запросы. Соответственно среда выполнения Flash не удаляет недостижимые объекты из памяти незамедлительно. Вместо этого, она ищет и удаляет недостижимые объекты периодически, в процессе выполнения циклов сборки мусора.
Стратегия удаления недостижимых объектов языка ActionScript называется сборкой мусора с использованием алгоритма поэтапных пометок и вычищений. Рассмотрим, как это работает.
После запуска среда Flash просит операционную систему оставить, или выделить, произвольный объем памяти, в которой будут храниться объекты выполняемой в настоящий момент программы. По мере выполнения программы объекты накапливаются в памяти. В любой момент времени некоторые объекты программы являются достижимыми, а другие могут оказаться недостижимыми Если программа создаст достаточное количество объектов, среда выполнение Flash в конечном счете решит выполнить цикл сборки мусора. В процессе выполнения цикла все объекты, находящиеся в памяти, проверяются на «достижимость». В результате все достижимые объекты помечаются и продолжают храниться в памяти, а все недостижимые объекты вычищаются (удаляются'
из памяти. Однако в большой программе проверка объектов на достижимость может оказаться достаточно длительной. Соответственно среда Flash разбивает циклы сборки мусора на небольшие части, или прирагцения, которые включаются в процесс выполнения программы. Кроме того, среда выполнения Flash использует механизм отложенного подсчета ссылок для повышения производительности процесса сборки мусора. Информацию о механизме отложенного подсчета ссылок можно найти в статье «The Memory Management Reference: Beginner’s Guide: Recycling» по адресу http://www.memorymanagement.org/articles/ recycle.html#reference.deferred.
В языке ActionScript циклы сборки мусора обычно запускаются тогда, когда объем памяти, необходимый для хранения объектов программы, достигает объема памяти, выделенного среде Flash. Однако ActionScript не дает никакой гарантии относительно времени запуска циклов сборки мусора. Более того, программист не может заставить среду Flash выполнить цикл сборки мусора.
Намеренное освобождение обьектов
В языке ActionScript не существует прямого способа для удаления объекта из системной памяти. Удаление любых объектов программы осуществляется косвенно, через автоматическую систему сборки мусора.
Тем не менее, хотя программа и не может самостоятельно удалить объект из системной памяти, она по крайней мере может сделать этот объект доступным для удаления, устранив все ссылки на него. Чтобы устранить все ссылки на объект, мы должны вручную удалить этот объект из любых массивов, содержащих его, и присвоить значение null (или другое подходящее значение) всем переменным, ссылающимся на него.
Тот факт, что объект является доступным для сборки мусора, вовсе не означает, что он будет незамедлительно удален из памяти. Среда выполнения Flash просто получает разрешение на удаление этого объекта, когда (и если) запустится цикл сборки мусора.
Стоит отметить, однако, что создание и последующее удаление объектов из памяти зачастую является менее эффективным решением, чем повторное использование существующих объектов.
Когда это возможно, вы должны стараться повторно использовать существующие объекты, а не удалять их.
Снова вернемся к программе по созданию виртуального зоопарка и рассмотрим следующий код. В нем описывается метод для кормления животного яблоками.
package {
Import fl ash.display.Sprite:
import zoo.*;
public class Virtual Zoo extends Sprite { private var pet:Virtual Pet;
public function Virtual Zoo ( ) {
pet = new VlrtualPetCStan");
pet.eat(new Apple( ));
pet.eat(new Apple( ));
pet.eat(new Apple( ));
pet.eat(new Apple( )); pet.eat(new Apple( ));
Обратите внимание, что при каждом кормлении животного предыдущий код создает новый экземпляр класса Apple и передает этот экземпляр в метод eat ( ). Всякий раз, когда завершается выполнение метода eat ( ), все ссылки на переданный в этот метод экземпляр класса Apple теряются, поэтому данный экземпляр становится доступным для сборки мусора. Теперь представьте, что произойдет, если мы скормим животному 1000 объектов класса Apple. Затраты нашей программы на обработку данных будут включать не только затраты на создание объектов класса Apple, но и затраты на их удаление из памяти в процессе сборки мусора. Чтобы минимизировать подобные затраты, лучше создать один повторно используемый объект класса Apple и применять его при каждом кормлении животного яблоком. Следующий код демонстрирует процесс пятикратного кормления животного одним и тем же объектом класса Apple: package {
Import flash.display.Sprite:
Import zoo.*;
public class VlrtualZoo extends Sprite { private var pet-.Virtual Pet:
private var apple:Apple;
public function VlrtualZoo ( ) {
pet = new VlrtualPetCStan"):
apple = new Apple( );
pet.eat(apple);
pet.eat(apple);
pet.eat(apple);
pet.eat(apple); pet.eat(apple);
}}
К затратам предыдущего кода можно отнести затраты на создание единственного объекта. При этом не будет вообще никаких затрат на сборку мусора. Этот подход гораздо более эффективен по сравнению с предыдущим подходом, заключавшимся в создании нового объекта класса Apple и его последующем удалении для каждого вызова метода eat ( )!
Деактивация объектов
Как уже известно, удаление всех ссылок на объект делает его доступным для сборки мусора. Тем не менее даже после этого объект продолжает существовать в памяти до тех пор, пока среда выполнения Flash не решит «смести» его в одном из циклов сборки мусора. С того момента, как объект становится доступным для сборки мусора, и до того, как он фактически будет удален из системной памяти, данный объект продолжает получать события и, в случае объектов класса Function, может по-прежнему вызываться функцией setinterval ( ).
Например, представьте приложение для демонстрации изображений в режиме слайд-шоу, которое использует класс ImageLoader для загрузки изображений с сервера через определенные интервалы времени. Код класса ImageLoader выглядит следующим образом:
package {•
Import fl ash.events.*:
Import fl ash.utils.*:
public class ImageLoader {
private var loadinterval:1nt:
public function ImageLoader (delay:1nt = 1000) { loadinterval = setinterval(loadimage, delay):
}
public function loadimage ( ):vo1d {
traceCNow loading Image..."):
// Код загрузки изображения
// здесь не приводится
}
}
Теперь представьте, что основной класс приложения SlideShow реализует функциональность для запуска и остановки слайд-шоу. Для запуска слайд-шоу класс SlideShow создает экземпляр класса ImageLoader, управляющего процессом загрузки изображений. Экземпляр класса ImageLoader сохраняется в переменной экземпляра imgLoader, как показано в следующем коде:,
ImgLoader = new ImageLoaderC );
Для остановки или приостановки слайд-шоу класс SlideShow удаляет ссылку на экземпляр класса ImageLoader, как показано в следующем коде:
ImgLoader = null:
Когда переменной imgLoader присваивается значение null, экземпляр класса ImageLoader становится доступным для сборки мусора. Тем не менее, до тех пор пока этот экземпляр не будет фактически удален из системной памяти, операция загрузки в экземпляре ImageLoader, реализованная на базе функции set Interval ( ), будет регулярно выполняться.
Это демонстрирует следующий очень простой класс. Он создает экземпляр класса ImageLoader и сразу же удаляет ссылку на созданный экземпляр. Но даже после того, как переменной imgLoader присвоено значение null, сообщение «Now loading image...» продолжает появляться в окне для отладки с интервалом один раз в секунду.
package {
Import flash.display.*;
public class S11 deShow extends Sprite {
private var ImgLoader:ImageLoader;
public function S11 deShow ( ) {
// Создаем экземпляр класса ImageLoader и сразу же удаляем ссылку
// на созданный экземпляр
ImgLoader = new ImageLoaderC );
ImgLoader = null;
}
Если объем памяти, который необходим приложению для демонстрации изображений в режиме слайд-шоу, никогда не достигнет уровня, достаточного для запуска цикла сборки мусора, операция загрузки в экземпляре класса ImageLoader, реализованная на базе функции se 11 nt erval ( ), будет выполняться бесконечно долго. Ненужное выполнение кода в «заброшенном» экземпляре класса ImageLoader тратит впустую системные и сетевые ресурсы и может привести к появлению нежелательных побочных эффектов в программе.
Чтобы избежать ненужного выполнения кода в «заброшенных» объектах, программа должна всегда деактивировать объекты перед тем, как избавиться от них. Деактивация объекта означает его перевод в нерабочее состояние, когда программа больше не может воспользоваться этим объектом для выполнения кода. Например, чтобы деактивировать объект, мы могли бы выполнить одно из перечисленных далее действий или же все действия сразу:
отменить регистрацию методов объекта для событий;
остановить все таймеры и интервалы;
остановить воспроизводящую головку временных шкал (для экземпляров клипов, созданных в среде разработки Flash);
деактивировать любые объекты, которые станут недостижимыми после того, как сам объект станет недостижимым.
Чтобы объекты могли быть деактивированы, любой класс, экземпляры которого регистрируются для получения событий или используют таймеры, должен предоставлять открытый метод для деактивации своих экземпляров.
Например, наш предыдущий класс ImageLoader должен определить метод, останавливающий внутренний интервал. Сейчас добавим подобный метод и назовем его dispose ( ). Имя выбрано произвольно; с таким же успехом мы могли бы присвоить данному методу имя kill ( ), destroy ( ), die ( ), clean ( ), disable ( ), deactivate ( ) или любое другое имя. Рассмотрим этот код:
package {
Import fl ash.events.*;
Import flash.utils.*:
public class ImageLoader {
private var loadinterval:1nt;
public function ImageLoader (delay:1nt = 1000) { loadinterval = .setinterval (loadimage, delay):
}
public function loadimage ( ):void {.
traceCNow loading Image..."):
// Код загрузки изображения не приводится }
public function dispose ( ):void { clearinterval(loadinterval);
}
}
}
Любой код, создающий экземпляр класса ImageLoader, должен в дальнейшем вызвать метод ImageLoader. dispose ( ) перед тем, как избавиться от этого экземпляра, как показано в следующем коде: package {
Import flash.display.*:
public class S11 deShow extends Sprite {
private var ImgLoader:ImageLoader:
public function S11 deShow ( ) {
// Создаем и сразу же избавляемся от экземпляра класса ImageLoader
ImgLoader = new ImageLoader( );
ImgLoader.dispose( );
ImgLoader = null:
}
}
}
Сборка мусора в действии
В листинге 14.1 показана очень простая программа, демонстрирующая сборку мусора в действии. Программа создает объект класса Sprite, многократно отображающий сообщение в консоли для отладочной информации. Поскольку объект Sprite достижим только через локальную переменную, он становится доступным для сборки мусора сразу после завершения конструктора основного класса программы. При этом в программе также запущен таймер, который многократно создает объекты, занимая системную память. Когда объем потребленной памяти превысит допустимое значение, запустится сборщик мусора. В процессе сборки
мусора исходный объект Sprite будет удален из памяти и его сообщения перестанут появляться в консоли для отладочной информации.
Листинг 14.1. Сборка мусора в действии
package {
Import flash.display.*;
Import flash.text.*;
Import flash.utils.*;
Import fl ash.events.*:
Import fl ash.system.*;
public class GarbageCollectlonDemo extends Sprite {
public function GarbageCollectlonDemo ( ) {
// Данный объект Sprite будет удален в процессе сборки мусора, когда
// объем потребленной памяти превысит допустимое значение
var s.-Sprite = new Spr1te( ):
s.addEventLIstener(Event.ENTER_FRAME. enterFrameLi stener);
// Многократно создает новые объекты, занимая .системную память
var t1mer:T1mer = new T1mer(l. 0);
timer.addEventLIstener(TlmerEvent.TIMER. t1merL1stener);
timer.start( );•
}
private function t1merL1stener (e:T1merEvent):void {
// Создаем объект, чтобы захватить часть системной памяти. Это может
// быть любой объект, но объекты класса TextFleld являются довольно
// объемными.
new TextF1eld(
// Эта функция выполняется до тех пор. пока объект Sprite не будет
// удален из памяти в процессе сборки мусора
private function enterFrameLlstener (e:Event):void {
// Отображаем объем памяти, занимаемой программой
traceCSystem memory used by this program: " + System, total Memory):
1
К задворкам языка Actionscript
Сборка мусора является чрезвычайно важной частью программирования на языке ActionScript. При создании любой программы на языке ActionScript вы должны принимать во внимание вопросы управления памятью. При создании объекта следует решить, нужен ли он на всем протяжении жизни программы. Если это не так, вы должны включить в программу код, который деактивирует этот объект и впоследствии избавляется от него.
Более полную информацию по сборке мусора в языках программирования можно получить в специальной статье на сайте «Википедии» и на сайте The Memory Management Reference по адресу http://www.memorymanagement.org.
Несколько самостоятельно опубликованных статей, написанных Грантом Скиннером (Grant Skinner) и посвященных сборке мусора в языке ActionScript 3.0, можно найти на сайте автора по адресу http://gskinner.com/talks/resource-management/ и http:// www.gskinner.com/blog/archives/2006/06/as3_resource_ma.html.
В следующей главе мы рассмотрим менее распространенные инструменты языка ActionScript, предназначенные для изменения структуры классов и объектов на этапе выполнения программы.
Динамические возможности языка Actionscript
Язык ActionScript изначально задумывался как язык, который позволял бы реализовать простейшее программное поведение для содержимого, создававшегося вручную в среде разработки Flash. В ранних версиях ActionScript большая часть кода представляла собой короткие сценарии, которые реализовывали ограниченную функциональность, по сравнению с кодом, необходимым для создания слож- . ного настольного приложения. По существу, первоначальный набор возможностей языка ActionScript отличался гибкостью и простотой.
Изначально язык ActionScript позволял динамически, на этапе выполнения программы, изменять структуры всех классов и даже любых отдельных объектов. Например, на этапе выполнения программа могла:
добавлять новые методы или переменные экземпляра в любой класс;
добавлять новые методы или переменные экземпляра в любой отдельно взятый конкретный объект;
создавать новый класс с нуля;
изменять суперкласс выбранного класса.
С появлением языка ActionScript 3.0, приложений Flash Player 9, Adobe AIR и Flex, платформа Flash вышла на новый уровень развития, где сложность программы, разработанной на языке ActionScript, может вполне конкурировать со сложностью полнофункционального настольного приложения. Соответственно, ActionScript, как настоящий язык программирования, взял на вооружение многие формальные структуры, необходимые для разработки крупномасштабных приложений, например формальное ключевое слово class и синтаксис наследования, формальные типы данных, систему предопределенных событий, обработку исключений и встроенную поддержку формата XML. Тем не менее динамические возможности ActionScript остаются доступными и по-прежнему составляют важную часть внутренней структуры языка.
В этой главе рассматриваются приемы программирования с использованием динамических возможностей языка ActionScript. Однако стоит отметить, что гибкость, присущая такому программированию, ограничивает или полностью лишает преимущества проверки типов, с которым мы познакомились в гл. 8. Как результат, большинство сложных программ используют описанные в этой главе возможности лишь изредка, если вообще используют. Например, из более чем 700 классов, определенных в среде разработки Flex, только около 10 классов используют возможности динамического программирования. С другой стороны, даже если вы никогда не будете использовать динамическое программирование в своем коде, информа-
ция, представленная в этой главе, поможет получить более полное представление о внутренних процессах языка ActionScript.
В качестве нашего первого приема динамического программирования мы рассмотрим динамические переменные экземпляра — переменные, добавляемые в конкретный объект на этапе выполнения программы. .
Динамические переменные экземпляра
В самом начале этой книги написание программы на языке ActionScript сравнивалось с проектированием и разработкой самолета. Чертежи самолета сравнивались с классами ActionScript, а реальные детали конкретного физического самолета — с объектами ActionScript. По этой аналогии структура каждого конкретного самолета будет гарантированно совпадать со структурой всех других самолетов, поскольку все самолеты построены по одному и тому же чертежу. Для сравнения отметим, что все экземпляры конкретного класса будут иметь одинаковую структуру, поскольку в их основе лежит один и тот же класс.
Что же произойдет, если владелец одного из самолетов решит закрепить собственный фонарь на верху своего самолета? Этот самолет будет обладать специфической характеристикой, не присущей всем остальным самолетам. В языке ActionScript «добавление нового фонаря на конкретный самолет» аналогично добавлению новой переменной экземпляра в отдельно взятый конкретный объект, при этом в остальные экземпляры класса данного объекта этот «фонарь» не добавляется. Переменная экземпляра такого рода называется динамической переменной экземпляра. В сравнении с динамическими переменными экземпляра «обычные» переменные экземпляра называются фиксированными.
Динамические переменные экземпляра могут быть добавлены только в экземпляры классов, объявленных с использованием атрибута dynamic (подобные классы называются динамическими). Динамические переменные экземпляра не могут быть добавлены в экземпляры классов, которые не объявлены с использованием атрибута dynamic (подобные классы называются закрытыми). Подкласс динамического класса считается динамическим только в том случае, если его определение тоже включает атрибут dynamic.
Следующий код создает новый класс Person, который может представлять человека в статистической программе, отслеживающей демографическую#ситуацию. Поскольку класс Person объявлен с использованием атрибута dynamic, в любой отдельный объект класса Person на этапе выполнения программы можно добавлять динамические переменные экземпляра.
dynamic public class Person { }
После того как класс будет объявлен динамическим, мы сможем добавлять новые динамические переменные в любой экземпляр этого класса с помощью стандартного оператора присваивания. Например, следующий код добавляет динамическую переменную экземпляра eyeColor в объект класса Person:
var person .-Person = new Person( );
person.eyeColor = "brown";
Как уже известно из гл. 8, если бы класс Person не был объявлен с использованием атрибута dynamic, приведенный код вызвал бы ошибку обращения, поскольку в классе Person не определена переменная экземпляра с именем eyeColor. Тем не менее в данном случае класс Person объявлен с использованием атрибута dynamic. В результате, когда среда выполнения Flash попытается присвоить значение несуществующей переменной экземпляра eyeColor, вместо того чтобы сообщить об ошибке, она просто создаст динамическую переменную экземпляра с именем eyeColor и присвоит ей указанное значение ("brown"). Обратите внимание, что определение динамической переменной экземпляра в предыдущем коде не содержит и не должно содержать объявление типа и модификатор управления доступом.
Все динамические переменные экземпляра являются нетипизированными и открытыми.
Следующий код, в котором происходит попытка использовать объявление типа при создании переменной eyeColor, вызовет ошибку на этапе компиляции:
person.eyeColor:String = "brown"; // Ошибка! Использование :Str1ng здесь // недопустимо
Для получения значения динамической переменной экземпляра применяется стандартное выражение доступа к переменной, как показано в следующем коде: trace(person.eyeColor); // Выводит: brown
Если указанная переменная экземпляра (динамическая или нединамическая) не существует, среда выполнения Flash вернет значение undefined, как показано в следующем коде:
trace(person.age): // Выводит undefined, поскольку объект person // не имеет переменной экземпляра с именем аде
Наиболее активное использование динамических переменных экземпляра языка ActionScript присуще среде разработки Flash, где каждая анимированная временная шкала представляется подклассом встроенного класса MovieClip. В среде разработки Flash автоматически генерируемые подклассы класса MovieClip являются динамическими, чтобы программисты могли определять новые переменные в создаваемых вручную экземплярах клипов. Подробное описание этой методики, а также описания других приемов работы с временными шкалами можно найти в гл. 29.
Динамические переменные экземпляра иногда используются для создания простой «справочной таблицы», рассматриваемой далее, в разд. «Использование динамических переменных экземпляра для создания справочных таблиц».
Следует помнить, что возможность динамического изменения программы может привести к проблемам, которые очень сложно выявить. Например, если класс объявлен динамическим, чтобы поддержать динамические переменные экземпляра, настоящие ошибки обращения, возникающие при использовании экземпляров данного класса, могут запросто остаться незамеченными (поскольку обращение
к несуществующей переменной экземпляра не вызовет ошибки ни на этапе компиляции, ни на этапе выполнения программы). Единственный способ узнать наверняка, работает ли динамически изменяемая программа, — это запустить ее и понаблюдать за поведением. Подобное наблюдение отнимает много времени и может приводить к ошибкам, вызванным человеческим фактором, поэтому большинство программистов избегают использования динамических переменных в сложных программах.
Среде выполнения Flash для обращения к динамической переменной экземпляра требуется больше времени, чем для обращения к фиксированной переменной. Когда производительность является решающим фактором, избегайте использования динамических переменных экземпляра.
Обработка динамических переменных экземпляра с помощью циклов for-each- in и for-in. Цикл f or-each-in обеспечивает простой способ обработки значений динамических переменных экземпляра объекта (или элементов массива). Он имеет следующий общий вид:
for each (переменнаяИлиЗначениеЭлемента in некийОбъект) { инструкции
Инструкции инструкции цикла for-each-in выполняются один раз для каждой динамической переменной экземпляра или элемента массива в объекте некийОбъ- ект. В процессе каждой итерации цикла значение переменной или элемент, над которым выполняется итерация (перечисление), присваивается переменной пере- меннаяИлиЗначениеЭлемента. Код внутри тела цикла имеет возможность применять это значение по своему усмотрению.
Например, рассмотрим описание объекта и связанный с ним цикл for-each-in, продемонстрированный в следующем коде. Обратите внимание, что внутренний объект Object объявлен с использованием атрибута dynamic и, следовательно, поддерживает динамические переменные экземпляра.
var 1nfo:Object = new ObjectC );
Info.city = "Toronto":
Info.country = "Canada":
for each (var detail:* in Info) { trace(deta1l):
}■
Приведенный цикл выполняется дважды, по одному разу для каждой из двух динамических переменных экземпляра объекта, на который ссылается переменная info. При выполнении цикла в первый раз переменной detail присваивается значение "Toronto” (то есть значение переменной city). При выполнении цикла во второй раз переменная detail содержит значение "Canada” (то есть значение переменной country). Таким образом, в результате выполнения цикла будет выведена следующая информация:
Toronto
Canada
В большинстве случаев порядок, в котором циклы for-each-in и for-in перечисляют переменные объекта, не гарантирован. Однако существует два исключения: перечисление переменных экземпляров классов XML и XMLList происходит в возрастающем порядке, в соответствии с числовыми именами их переменных (то есть в соответствии с документированным порядком для объектов XML; дополнительную информацию можно найти в гл. 18). Для всех остальных типов объектов порядок перечисления, используемый циклами for-each-in и for-in, может отличаться в зависимости от версий языка Actionscript и клиентских сред выполнения Flash. Таким образом, не следует писать код, который зависит от порядка перечисления циклов for-each-in или for-in, кроме тех случаев, когда обрабатываются данные в формате XML
Следующий код демонстрирует цикл for-each-in, который используется для обращения к значениям элементов массива:
var games:Array = ["Project Gotham Racing", "Shadow of the Colossus", "Legend of Zelda"]:
for each (var game:* 1n games) { trace(game);
}
Приведенный цикл выполняется трижды, по одному разу для каждого из трех элементов массива games. При выполнении цикла в первый раз переменной game присваивается значение "Project Gotham Racing" (то есть значение первого элемента). При выполнении цикла во второй раз переменная game принимает значение "Shadow of the Colossus”, а на третий раз — значение "Legend of Zelda”. Таким образом, выводимая информация выглядит следующим образом: Project Gotham Racing
Shadow of the Colossus
Legend of Zelda
Цикл for-each-in является напарником цикла for-in языка ActionScript. Тогда как цикл for-each-in перечисляет значения переменных, цикл for-in — имена переменных. Например, следующий цикл for-in перечисляет имена динамических переменных экземпляра объекта, на который ссылается переменная info: for (var detallName:* 1n Info) {
trace(detallName);
}
// Вывод:
// city
// country
Обратите внимание, что предыдущий код выводит имена переменных city и country, а не их значения. Для обращения к значениям этих свойств мы могли бы использовать оператор [ ], который рассматривается далее, в разд. «Динамические обращения к переменным и методам». Это демонстрирует следующий код: for (var detallName:* 1n Info) {
traced nfo[deta11 Name]) ;
}
// Вывод:
// Toronto // Canada
Чтобы исключить перечисление динамической переменной экземпляра в циклах for-in и for-each-in, используется метод setPropertylsEnumerable ( ) класса Object, показанный в следующем коде:
info.setPropertyIsEnumerableCdty", false);
for (var detallName:* in Info) {
trace(1nfo[detailName]):
}
// Выводит: Canada
// (переменная "city" не была обработана в цикле for-1n)
Мы рассмотрим применение цикла for-each-in на практическом примере в разд. «Использование динамических переменных экземпляра для создания справочных таблиц».
Динамическое добавление нового поведения в экземпляр
Когда вы познакомитесь с тем, как создавать динамические переменные экземпляра, у вас может возникнуть вопрос, поддерживает ли язык ActionScript и динамические методы экземпляра, то есть добавление нового метода экземпляра в один конкретный объект без добавления этого метода в любые другие экземпляры класса данного объекта. Фактически формальных способов для динамического добавления настоящего метода экземпляра в объект не существует. Тем не менее, присвоив замыкание функции динамической переменной экземпляра, мы можем имитировать эффект добавления нового метода в отдельный объект (чтобы освежить в памяти смысл фразы «замыкание функции», обратитесь к гл. 5). Следующий код демонстрирует общий подход:
некийОбъект.некаяДинамическаяПеременная = некаяФункция;
В приведенном коде некийОбъект — это экземпляр динамического класса, некаяДинамическаяПеременная — имя динамической переменной экземпляра (которая может являться либо новой, либо существующей переменной), а некаяФункция — ссылка на замыкание функции. Обычно функция некаяФункция задается с помощью литерала функции, как показано в следующем коде:
некийОбъект.некаяДинамическаяПеременная = function (параметр!, параметр2. . . параметра) {
// Тело функции }
После того как функция некаяФункция будет присвоена динамической переменной экземпляра, она может быть вызвана через этот объект точно так же, как и обычный метод экземпляра, что показано в следующем коде:
некийОбъект.некаяДинамическаяПеременная(значение!, значение2. .. значениеа);
Чтобы продемонстрировать использование предыдущего общего синтаксиса, вернемся к примеру с переменной inf о из предыдущего раздела:
var info:Object = new ObjectC );
info.city = "Toronto";
info.country = "Canada";
Предположим, мы хотим добавить в объект, на который ссылается переменная info, новое поведение — возможность форматировать и отображать собственное содержимое в виде строки. Мы создадим новую переменную экземпляра get Address, которой присвоим желаемую функцию форматирования, как показано в следующем коде:
info.getAddress = function ( ):String { return this.city + ", " + this.country;
}
Для вызова этой функции используется следующий код:
trace(info.getAddress( ));
Обратите внимание, что внутри тела функции, присвоенной переменной getAddress, мы можем использовать ключевое слово this для обращения к переменным и методам объекта, через который вызывается эта функция. На самом деле в случае с замыканиями функций обратиться без использования ключевого слова this к переменным и методам объекта, через который вызывается эта функция, невозможно. Предположим, мы убрали ключевое слово this из описания функции getAddress ( ), как показано в следующем коде:
info.getAddress = function ( ):String { return city + ", " + country;
}
При поиске переменных ci ty и country среда выполнения Flash не рассматривает автоматически переменные экземпляра объекта, на который ссылается переменная info. Следовательно, предыдущий код вызовет ошибку (если выше в цепочке видимости функции getAddress ( ) не существует других переменных с именами city и country).
Если функция переменной экземпляра объекта присваивается внутри класса данного объекта, то она сможет обращаться к переменным и методам объекта, объявленным с использованием модификаторов управления доступом private, protected, internal и public. Если присваивание происходит внутри подкласса класса объекта, функция сможет обращаться только к тем переменным и методам объекта, которые объявлены с использованием модификаторов управления доступом protected, internal и public. Если присваивание происходит внутри пакета, в котором объявлен класс объекта, функция сможет обращаться только к переменным и методам объекта, объявленным с использованием модификаторов управления доступом internal и public. Если класс объекта объявлен в одном пакете, а присваивание происходит в другом пакете, функция сможет обращаться только к переменным и методам объекта, объявленным с использованием модификатора управления доступом public.
Например, рассмотрим следующий код, который создает динамический класс Employee:
dynamic public class Employee {
public var startDate:Date;
private var age:1nt;
}
Следующий код присваивает функцию динамической переменной экземпляра doReport экземпляра класса Employee. Присваивание происходит за пределами класса Employee, но внутри класса, который объявлен в том же пакете, что и класс Employee. Следовательно, функция может обращаться только к тем переменным объекта Employee, которые объявлены с использованием модификаторов управления доступом internal й public. Переменные, объявленные с использованием модификаторов управления доступом protected и private, недоступны для этой функции.
public class Report {
public function Report (employeeEmployee) {
// Присваиваем функцию переменной doReport
employee.doReport = function ( ):vo1d {
trace(thls.startDate); // Обращение к public-переменной допустимо trace(thls.age);// Обращение к private-переменной запрещено
}
}
}
Динамические обращения к переменным и методам
Поскольку имена динамических переменных экземпляра зачастую неизвестны вплоть до этапа выполнения программы, язык ActionScript предоставляет возможность указывать имя переменной с помощью обычного строкового выражения. Следующий код демонстрирует общий подход:
некийОбъект^некоеВыражениеЗ
В предыдущем коде некийОбъект — это ссылка на объект, к переменной которого происходит обращение, а некоеВыражение — любое выражение, возвращающее строку (которая обозначает имя переменной). Предыдущий код может применяться как для присваивания значения переменной, так и для получения значения.
Например, следующий код присваивает значение "Toronto" переменной, имя которой указывается с помощью выражения строкового литерала ’’city”:
var Info:Object = new Object( ): 1nfo["c1ty"] = "Toronto":
Следующий код присваивает значение ’’Canada” переменной, имя которой указывается с помощью выражения строкового литерала "country”:
1nfo["country"J = "Canada":
Следующий код получает значение переменной, имя которой указывается с помощью выражения-идентификатора detail:
var detail-.String = "city";
trace(1nfo[deta1l]): // Выводит: Toronto
Когда среда выполнения Flash встречает код info [detail], она сначала определяет значение переменной detail (в нашем случае это ’’city”), после чего ищет переменную с именем ’’city” в объекте, на который ссылается переменная info.
Синтаксические правила, применяемые к идентификаторам, не распространяются на переменные, которые создаются с использованием оператора [ ]. Например, следующий код создает динамическую переменную экземпляра, имя которой начинается с цифры:
var 1nfo:Object = new ObjectC ): 1nfo["4H"] = "Information Line";
Использование оператора «точка» (.) для создания той же переменной вызовет ошибку, поскольку такая запись нарушает синтаксические правила, применяемые к идентификаторам:'
var i nfo .-Object = new Object ( );
Info.411 = "Information Line"; // ОШИБКА! Идентификаторы не должны // начинаться с цифры
Стоит отметить, что описанная методика может использоваться для обращения не только к динамическим переменным экземпляра, но и к любым типам переменных и методов. Однако наиболее часто она применяется при работе именно с динамическими переменными экземпляра. Следующий раздел демонстрирует использование динамических обращений в практической ситуации: для создания справочной таблицы.
Использование динамических переменных экземпляра для создания справочных таблиц
Справочная таблица — это структура данных, которая связывает набор имен с соответствующим набором значений. Например, следующий псевдокод демонстрирует справочную таблицу, которая представляет меню (приводится по-русски): закуска:маисовые чипсы
основное блюдо: лепешка с начинкой из бобов десерт:пирожное
Чтобы представить данную справочную таблицу с помощью динамических переменных экземпляра, можно использовать следующий код:
var meal:Object = new Objectt ); meal.appetizer = "tortilla chips"; meal.malncourse = "bean burrito";
meal.dessertmeal.dessert= "cake";= "cake";
meal.dessert
meal.dessert
= "cake";
= "cake";
Теперь рассмотрим более сложный сценарий. Представьте приложение для инвентаризации книг в книжном магазине, которое позволяет пользователю искать книги по номеру ISBN. Информация о каждой книге загружается с внешнего сервера. Чтобы минимизировать количество обращений к серверу, приложение загружает за раз информацию о 500 книгах. Для упрощения будем полагать, что информация о каждой книге представлена в виде отдельной строки, имеющей следующий формат:
"Price: $19.99. Title: Path of the Paddle"
Для хранения загруженной информации о книге в программе на языке ActionScript создадим экземпляр класса Object, который будет служить справочной таблицей для книг:
var booklist:Object = new Objects ):
Загруженную информацию о каждой книге мы присваиваем новой динамической переменной экземпляра созданного объекта bookList. Имя каждой переменной соответствует ISBN-номеру книги с предшествующей строкой ”isbn”. Например, переменная для книги с ISBN-номером 155209328Х будет называться isbnl55209328Х. Следующий код демонстрирует создание динамической переменной экземпляра для данной книги в том случае, если бы мы заранее знали ее ISBN-номер:•
booklist.1sbnl55209328X = "Price: $19.95. Title: Path of the Paddle";
В реальном приложении тем не менее ISBN-номер книги станет известен только после того, как информация об этой книге будет загружена с сервера. Следовательно, имя динамической переменной экземпляра для каждой книги должно формироваться динамически, на основании загружаемых данных. Для демонстрационных целей создадим переменную bookData, значение которой будет представлять данные в том виде, в котором они были бы загружены с сервера. В этом упрощенном примере ISBN-номер и подробная информация о каждой книге разделяются одиночным символом «тильда» (-). При этом полная информация о каждой книге отделяется двойным символом «тильда» (--).
var bookData:String = "155209328Х~Рг1се: $19.95. Title: Path of the Paddle"
+ "007223l726~Pr1ce: $24.95. Title: High Score!";
Чтобы преобразовать загруженные данные о книгах из строки в массив книг для обработки, воспользуемся методом split ( ) класса String, как показано в следующем коде:
var bookDataArray.Array = bookData.spl1t("~~");
Для преобразования массива книг в справочную таблицу используем следующий код:
// Создаем переменную, которая будет хранить информацию о каждой книге
// в процессе обработки var book:Array:
// Выполнить цикл один раз для каждого элемента в массиве книг
for (var 1:1nt = 0; 1 < bookDataArray.length; 1++) {
// Преобразуем текущий элемент массива из строки в собственный массив.
// Например, строка:
// "155209328Х~Рг1се: $19.95. Title: Path of the Paddle"
// становится массивом:
// ["155209328X", "Price: $19.95. Title: Path of the Paddle"]
book = bookDataArray[1].spl1t("~"):
// Создаем динамическую переменную экземпляра, имя которой соответствует
// ISBN-номеру текущего элемента в массиве книг, и присваиваем этой
// переменной описание текущего элемента в массиве. Обратите внимание, что
// ISBN-номер представлен выражением book[0], а описание -
// выражением Ьоок[1].
ЬоокЫ st Е" 1 sbn" + book[0]] = Ьоок[1]:
Когда все 500 книг будут добавлены в объект bookList и каждая из них будет храниться в своей собственной динамической переменной экземпляра, пользователь сможет выбирать книгу для просмотра, вводя ее ISBN-номер в текстовое поле isbnlnput. Вот как бы мы отображали информацию о выбранной пользователем книге в процессе отладки:
trace(bookL1st["1sbn" + Isbnlnput.text]):
Следующим же образом мы бы выводили информацию о выбранной пользователем книге на экране в текстовом поле, на которое ссылается переменная bookDescription:
bookDescrlptlon.text = bookList["1sbn" + Isbnlnput.text];
Для отображения списка всех книг, хранящихся в объекте bookList, можно использовать цикл f or-each-in, как показано в следующем коде:
for each (var bookinfo:* in bookList) {
// Выводим значение динамической переменной экземпляра,
// обрабатываемой в текущий момент trace(bookInfo):' .
В результате выполнения цикла будет выведена следующая отладочная информация:
Price: $19.95. Title: Path of the Paddle
Price: $24.95. Title: High Score!
Создание справочных таблиц с помощью литералов объекта. Для удобства справочные таблицы, содержимое которых имеет фиксированный размер и известно заранее, можно создавать с помощью литерала объекта. Литерал объекта создает новый экземпляр класса Ob j ect из набора пар «имя/значение», которые представляют динамические переменные экземпляра, разделены запятыми и заключены в фигурные скобки. Вот общий синтаксис:
{имяПеременной!:значениеПеременной!,
имяПеременной2:значениеПеременной2,
имяПеременнойМ: значениеПеременной^
Например, следующий код создает экземпляр класса Ob j ect с динамической переменной экземпляра city (значением которой является ”Toronto”)и динамической переменной экземпляра country (значением является "Canada"):
var 1nfo:Object = {city:"Toronto", country:"Canada"};
Данный код идентичен следующему:
var 1nfo:Object = new ObjectC );
Info.city = "Toronto":
Info.country = "Canada":
Если бы в приложении для инвентаризации из предыдущего раздела было всего две книги, мы могли бы использовать следующий литерал объекта для создания справочной таблицы bookList:
var booklist:Object = {
1sbnl55209328X:"Price: $19.95. Title: Path of the Paddle", 1sbn007223l726:"Price: $24.95. Title: High Score!"
Использование функций для создания объектов
В процессе чтения этой книги вы видели, что большинство объектов в языке ActionScript создается с помощью классов. Тем не менее существует возможность создавать объекты с использованием независимых замыканий функций. Следующий код демонстрирует общий подход. В нем для примера объявлена функция Employee ( ), которая применяется для создания объекта:
// Создаем функцию function Employee ( ) {
// Используем функцию для создания объекта и присваиваем этот объект // переменной worker
var worker = new EmployeeC );
Обратите внимание, что переменная worker является нетипизированной. С точки зрения типов данных объект, на который ссылается переменная worker, представляет собой экземпляр класса Object. Класс Employee не существует, поэтому не существует и тип данных Employee. Таким образом, следующий код вызовет ошибку (поскольку тип данных Employee не существует):
// ОШИБКА!
var worker-.Employee = new EmployeeC ):
Замыкание функции, используемое для создания объекта, называется функцией- конструктором (не путайте с л/еягодсш-конструктором, который является частью определения класса). В языке ActionScript 3.0 независимые функции, объявленные на уровне пакета, не могут применяться в качестве функций-конструкторов, noj этому предыдущий код должен быть размещен внутри метода, в коде за пределами описания пакета или в сценарии кадра на временной шкале в среде разработки Flash. Тем не менее ради краткости в этом разделе все функции-конструкторы
показаны без необходимых методов или сценариев кадров, которые должны содержать эти функции.
Все объекты, создаваемые из функций-конструкторов, неявно являются динамическими. Таким образом, в процессе создания объекта функция-конструктор может использовать ключевое слово this для добавления в этот объект новых динамических переменных экземпляра. Динамическим переменным экземпляра, создаваемым в функции-конструкторе, обычно присваиваются значения, которые передаются в функцию в качестве аргументов. Это демонстрирует следующий код:
function Employee (age, salary) {
// Описываем динамические переменные экземпляра
this.аде = аде;
this.salary = salary;
}
// Передаем аргументы, которые будут использованы в качестве значений // динамических переменных экземпляра данного объекта'
var worker = new Employee(25, 27000);
trace(worker.age); // Выводит: 25
Чтобы объекты, создаваемые с помощью определенной функции-конструктора, могли разделять между собой информацию и поведение, язык ActionScript для каждой функции вводит специальную статическую переменную prototype. Переменная функции prototype ссылается на объект (называемый объектом-прототипом функции), к динамическим переменным экземпляра которого можно обращаться через любой объект, созданный с помощью данной функции. Изначально язык ActionScript присваивает переменной prototype каждой функции экземпляр базового класса Object. Добавляя в этот объект динамические переменные экземпляра, мы можем создать информацию и поведение, разделяемые между всеми объектами, созданными из конкретной функции.
Например, следующий код добавляет динамическую переменную экземпляра company в объект prototype функции Employee ( ):
Employee.prototype.company = "AnyCorp";
В результате любой объект, созданный из функции Employee ( ), может обращаться к переменной company так, будто это его собственная динамическая переменная экземпляра:
var worker = new Employee(25, 27000);
trace(worker.company); // Выводит: AnyCorp
В предыдущем коде, когда среда выполнения Flash поймет, что объект, созданный из функции Employee ( ) (worker), не имеет переменной экземпляра или метода экземпляра с именем "company”, она проверит, определена ли динамическая переменная экземпляра с таким именем в объекте Employee. prototype. В этом объекте такая переменная определена' поэтому среда Flash использует ее так, будто это собственная переменная объекта worker.
Если, с другой стороны, в объекте worker определена собственная переменная company, она будет использована вместо переменной объекта Employee. prototype. Это демонстрирует следующий код:
var worker = new Employee(25, 27000);
worker.company = "CarCompany";
trace(worker.company); // Выводит: CarCompany (не AnyCorp)
Используя методику, рассмотренную в разд. «Динамическое добавление нового поведения в экземпляр», мы можем присвоить функцию динамической переменной экземпляра объекта prototype любой функции-конструктора. Эта функция в дальнейшем может быть использована любым объектом, созданным из данной функции-конструктора.
Например, следующий код определяет динамическую переменную экземпляра getBonus в объекте prototype функции Employee ( ) и присваивает этой переменной функцию, которая подсчитывает и возвращает премию по итогам года:
Employee.prototype.getBonus = function (percentage;1nt):Number {
// Возвращает размер премии в зависимости от зарплаты сотрудника
// и указанного процента
return this.sal ary * (percentage/100);
В результате все объекты, созданные из функции Employee ( ), могут использовать функцию getBonus ( ) так, будто она была присвоена их собственным динамическим переменным экземпляра:
var worker = new Employee(25, 27000);
trace(worker.getBonusQO)); // Выводит: 2700
Использование объектов-прототипов для дополнения классов
Как уже было сказано, язык ActionScript определяет для каждой функции специальную статическую переменную prototype. Используя переменную prototype функции, мы можем разделять информацию и поведение между всеми объектами, созданными из этой функции.
Подобно тому, как язык ActionScript определяет переменную prototype для каждой функции, он также определяет статическую переменную prototype для каждого класса. Используя статическую переменную prototype, мы можем добавлять разделяемую между всеми экземплярами данного класса информацию и поведение на этапе выполнения программы.
Например, следующий код определяет новую динамическую переменную экземпляра isEmpty в объекте prototype внутреннего класса String и присваивает ей функцию. Эта функция возвращает значение true, когда строка не содержит символов; в противном случае функция возвращает значение false:
String.prototype.IsEmpty = function ( ) { return (this == "") ? true : false;
}:
Для вызова функции isEmpty ( ) над объектом String мы используем следующий код:
var sl:Str1ng = "Hello World";
var s2:String = "";
trace(sl.1sEmpty( )): // Выводит: false
trace(s2.1sEmpty( )): // Выводит: true
Тем не менее в предыдущем примере кода — и вообще во всей этой методике — существует проблема: динамическая переменная экземпляра добавляется только на этапе выполнения программы; следовательно, компилятор не имеет ни малейшего представления о том, что эта переменная существует, и сгенерирует ошибку, если компиляция программы будет выполняться в строгом режиме. Например, при компиляции программы в строгом режиме код из предыдущего примера вызовет следующую ошибку:
Call to a possibly undefined method IsEmpty through a reference with static type String.
По-русски она будет звучать так: Вызов возможно неопределенного метода isEmpty через ссылку на статический тип String.
Чтобы обращение к функции isEmpty ( ) при использовании строгого режима не приводило к ошибке на этапе компиляции, мы должны применять динамическое обращение, как показано в следующем коде:
slCIsEmpty"]( )
С другой стороны, если бы класс String не был объявлен с использованием атрибута dynamic, первоначальный подход (то есть si. isEmpty ( ) ) не вызывал бы ошибку.
Стоит отметить, что фиксированные переменные и методы всегда имеют преимущество перед переменными прототипа. В предыдущем примере, если в классе String уже определен метод или переменная экземпляра с именем isEmpty, то все обращения к свойству isEmpty будут относиться к этой переменной или к методу экземпляра, а не к динамической переменной экземпляра объекта-прототипа класса String.
Цепочка прототипов
Из предыдущих разделов мы узнали, что объект-прототип может использоваться для разделения информации и поведения между объектами, созданными из определенной функции-конструктора или класса. Фактически обращаться к данному объекту-прототипу можно и за пределами объектов, созданных из функции или класса, которому принадлежит данный прототип.
В случае класса к динамической переменной экземпляра, определенной в объекте-прототипе данного класса, можно обращаться не только через экземпляры этого класса, но и через экземпляры его потомков. Это демонстрирует следующий простой код:
// Создаем простейший класс А
dynamic public class А {
}
// Создаем другой простейший класс В, который расширяет класс А dynamic public class В extends А {
}
// Создаем основной класс приложения
public class Main extends Sprite {
public function Main ( ) {
// Добавляем динамическую переменную экземпляра в объект-прототип
// класса А
A.prototype.day = "Monday";
// Обращаемся к переменной A.prototype.day через экземпляр класса В var b:B = new В( );
trace(b.day); // Выводит: "Monday"
В случае функции обращаться к динамическим переменным экземпляра, определенным в объекте-прототипе функции, можно не только через любой объект, созданный из этой функции, но и через любой объект, цепочка прототипов которого включает объект-прототип данной функции.
Рассмотрим, как работают цепочки прототипов. Предположим, что мы создаем функцию Employee ( ), как делали это раньше, в объекте-прототипе которой определяем динамическую переменную экземпляра company:
function Employee ( ) {
Employee.prototype.company = "AnyCorp";
Любой объект, созданный из функции Employee ( ), может обращаться к переменной company через объект-прототип функции Ешроуее ( ). Ничего нового. Теперь предположим, что мы создали еще одну функцию Manager ( ):
function Manager ( ) {
}
Предположим также, что необходимо сделать так, чтобы объекты, созданные из функции Manager ( ), могли обращаться к переменной company через объект- прототип функции Employee ( ). Для этого мы присваиваем объект, созданный из функции Employee ( ), переменной prototype функции Manager ( ).
Manager.prototype = new EmployeeC );
Теперь рассмотрим, что произойдет, если мы обратимся к переменной с именем "company” через объект, созданный из функции Manager ( ), как показано в следующем коде:
var worker = new Manager( );
trace(worker.company);
При выполнении предыдущего кода среда Flash проверяет, имеет ли объект worker переменную или метод экземпляра с именем ” company”. Объект worker не имеет
переменной или метода экземпляра с таким именем, поэтому далее среда выполнения Flash проверяет, определена ли динамическая переменная экземпляра с именем "company" в объекте-прототипе функции Manager ( ). Сам по себе объект-прототип функции Manager ( ) является объектом, созданным из функции Employee ( ). Тем не менее в объектах, созданных из функции Employee ( ), динамическая переменная экземпляра с именем "company" не определена. Следовательно, после этого среда Flash проверяет, определена ли динамическая переменная экземпляра с именем " company" в объекте-прототипе функции Employee ( ). В нем такая переменная определена, поэтому среда выполнения Flash использует ее так, будто это собственная переменная объекта worker.
Рассмотрим путь, который проходит среда Flash при поиске переменной с именем "company”.
Ищем переменную company в объекте worker. Не найдена.
Ищем переменную company в объекте Manager. prototype. Не найдена.
Объект Manager. prototype создан из функции Employee ( ), поэтому ищем переменную company в объекте Employee. prototype. Найдена!
Список объектов-прототипов, просматриваемых средой выполнения Flash при попытке определить значение переменной, называется цепочкой прототипов. До появления языка ActionScript 3.0 цепочка прототипов была основным механизмом для разделения повторно используемого поведения между различными типами объектов. В языке ActionScript 3.0 эту роль играет наследование классов.
Обратите внимание на следующие ограничения, налагаемые на цепочки прототипов в ActionScript 3.0.
Объект, присваиваемый переменной prototype функции, сам по себе должен являться объектом, созданным из функции, или экземпляром класса Object (использование экземпляров других классов не допускается).
Значение переменной prototype класса присваивается средой выполнения Flash автоматически и в дальнейшем не может быть изменено.
Вперед!
В большинстве средних и крупномасштабных проектов приемы динамического программирования, рассмотренные в этой главе, играют лишь второстепенную роль. Тем не менее понимание его возможностей в ActionScript позволит вам чувствовать себя более комфортно при работе с этим языком. Подобным образом знание концепции области видимости, которая рассматривается в следующей главе, добавит вам уверенности в себе как программисту на языке ActionScript. Область видимости управляет доступностью и продолжительностью жизни определений в программе.
Область видимости
Область видимости — это физическая область программы, в которой выполняется код. В языке ActionScript существует пять возможных областей видимости:
тело функции;
тело метода экземпляра;
тело статического метода;
тело класса;
все остальное (то есть глобальная область видимости).
В любой конкретный момент выполнения программы доступность переменных, функций, классов, интерфейсов и пространств имен определяется областью видимости кода, исполняемого в текущий момент. Например, код внутри функции может обращаться к локальным переменным этой функции, поскольку он выполняется внутри ее области видимости. Напротив, код за пределами функции не может обращаться к локальным переменным данной функции, поскольку он выполняется за пределами ее области видимости.
В ActionScript области видимости могут быть вложенными. Например, функция может быть вложена в метод экземпляра, который, в свою очередь, вложен в тело класса:
public class SomeClass {
public function someMethod ( ):vo1d {
function someNestedFunctlon ( ):vo1d {
// Область видимости данной функции вложена внутрь области видимости
// метода someMethod( ). которая вложена в область видимости класса // SomeClass
Если одна обдасть видимости вложена в другую область, определения (то есть переменные, функции, классы, интерфейсы и пространства имен), доступные во внешней области видимости, становятся доступными во вложенной области. Например, функция, вложенная внутрь метода экземпляра, может обращаться к локальным переменным этого метода. Полный список вложенных областей видимости, окружающих код, выполняемый в текущий момент, называется цепочкой областей видимости.
В этой главе рассматривается доступность переменных, функций, классов, интерфейсов и пространств имен внутри различных областей видимости языка ActionScript.
Обратите внимание, что помимо «доступных» определений, перечисленных в каждом из последующих разделов, определения, объявленные во внешнем пакете с использованием модификатора управления доступом public, можно сделать видимыми и в данной области видимости с помощью директивы import. Подробную информацию можно найти в подразд. «Пример создания объекта: добавление животного в зоопарк» разд. «Создание объектов» гл. 1.
Местоположение определения и используемые при его объявлении модификаторы управления доступом совместно определяют доступность данного определения в программе. Для информации в табл. 16.1 приведена доступность определений в соответствии с их местоположением и применяемым модификатором управления доступом.
Таблица 16.1. Доступность определения в зависимости от его местоположения и используемого модификатора управления доступом
Определение
Доступно•
Определение за пределами всех пакетов
Только внутри исходного файла, содержащего данное определение
Определение в безымянном пакете
В любой точке программы
Определение с использованием модификатора управления доступом public в именованном пакете
Внутри пакета, содержащего данное определение, и в любом месте, где оно импортируется
Определение с использованием модификатора управления доступом internal в именованном пакете
Только внутри пакета, содержащего данное определение
Метод или переменная, объявленные с использованием модификатора управления доступом public
В любом месте, где доступен класс, содержащий данное определение
Метод или переменная, объявленные с использованием модификатора управления доступом internal
Внутри пакета, содержащего класс с данным определением
Метод или переменная, объявленные с использованием модификатора управления доступом protected
Внутри класса, содержащего данное определение, и его классов-потомков
Метод или переменная, объявленные с использованием модификатора управления доступом private
Только внутри класса, содержащего данное определение
Определение в методе экземпляра, статическом методе или функции
Доступно внутри метода или функции, содержащих данное определение, а также во всех вложенных в них функциях
Глобальная область видимости
Код, помещенный непосредственно в тело пакета или на верхний уровень тела пакета, находится в глобальной области видимости. Иначе говоря:
package {
// Этот код находится в глобальной области видимости
// Этот код также находится в глобальной области видимости
Код, находящийся в глобальной области видимости, может обращаться к функциям, переменным, классам, интерфейсам и пространствам имен, определенным:
на верхнем уровне безымянного пакета;
за пределами всех пакетов, но в том же исходном файле (AS).
Другими словами:
package {
// Размещенные здесь определения доступны всему коду
// в глобальной области видимости
}
// Размещенные здесь определения доступны всему коду в том же исходном файле
Стоит отметить, что код, размещенный на верхнем уровне тела именованного пакета, может также обращаться к определениям, размещенным на верхнем уровне того же пакета. Эти определения доступны потому, что внутри именованного пакета язык ActionScript автоматически открывает пространство имен, связанное с данным пакетом (более подробную информацию можно найти в гл. 17). Иными словами:
package somePackage {
// Размещенные здесь определения становятся автоматически доступны
// всему коду в пакете somePackage
)
Область видимости класса
Код, помещенный на верхний уровень тела класса, находится в области видимости этого класса. Например:
package {
public class SomeClass {
// Размещенный здесь код находится в области видимости класса someClass
Помните, что код, размещенный на верхнем уровне тела класса, включается в автома- **; е тически создаваемый статический метод (инициализатор класса), который выполняется МУ всякий раз, когда среда Flash определяет класс на этапе выполнения программы. Подробную информацию можно найти в разд. «Статические методы* гл. 4.
Через цепочку областей видимости код в области видимости класса может обращаться к следующим определениям:
ко всем определениям, доступным коду в глобальной области видимости;
статическим методам и статическим переменным, определенным в этом классе;
статическим методам и статическим переменным, определенным в предках данного класса, если они существуют (то есть в суперклассе, суперклассе суперклас-
Иначе говоря:
package {
public class SomeClass extends SomeParentClass {
// Определенные здесь статические переменные
// и статические методы доступны
// в любом месте класса SomeClass
}
}
package {
public class SomeParentClass {
// Определенные здесь статические переменные
// и статические методы доступны
// в любом месте класса SomeClass
Хотя класс может обращаться к статическим переменным и методам своих предков, следует помнить, что статические переменные и методы не наследуются. Дополнительную информацию можно найти в разд. «Пример наследования» гл. 6.
Область видимости статического метода
Код, помещенный в тело статического метода, находится в области видимости данного метода. Это демонстрирует следующий код: package {
public class SomeClass {
public static function staticMeth ( ) {
// Размещенный здесь код находится в области видимости метода
// staticMeth ‘ .
}
Через цепочку областей видимости код в области видимости статического метода может обращаться к этим определениям:
ко всем определениям, доступным коду в глобальной области видимости;
ко всем определениям, доступным коду в области видимости класса, который содержит определение данного статического метода.
Кроме того, код в области видимости статического метода может обращаться ко всем локальным переменным, вложенным функциям и пространствам имен, определенным внутри данного статического метода.
Другими словами:
package {
public class SomeClass extends SomeParentClass {
public static function staticMeth ( ) {
// Определенные здесь локальные переменные, вложенные функции
// и пространства имен доступны в методе staticMeth
Область видимости метода экземпляра
Код, помещенный в тело метода экземпляра, находится в области видимости данного метода: package {
public class SomeClass {
public function InstanceMeth ( ) {
// Размещенный здесь код находится в области видимости // метода InstanceMeth
Через цепочку областей видимости код в области видимости метода экземпляра может обращаться к следующим определениям:
ко всем определениям, доступным коду в глобальной области видимости;
ко всем определениям, доступным коду в области видимости класса, который содержит определение данного метода экземпляра;
ко всем методам и переменным экземпляра объекта, через который был вызван данный метод экземпляра (с учетом ограничений, налагаемых используемыми модификаторами управления доступом);
□ ко всем локальным переменным, вложенным функциям и пространствам имен,* определенным внутри данного метода экземпляра.
Это демонстрирует следующий код:
package {
public class SomeClass extends SomeParentClass {
public function InstanceMeth ( ) {
// Все методы и переменные экземпляра текущего объекта (то есть this)
// доступны в методе 1nstanceMeth( ) (с учетом ограничений, налагаемых
// используемыми модификаторами управления доступом).
// Определенные здесь локальные переменные, вложенные функции
// и пространства имен доступны в методе 1nstanceMeth( )
}
}
Область видимости функции
Код, добавленный в тело функции, находится в области видимости данной функции. Конкретный список определений, доступных коду, находящемуся в области видимости функции, зависит от местоположения этой функции в программе.
Код в функции, которая определена на уровне пакета или за пределами всех пакетов, может обращаться к следующим определениям:
ко всем определениям, доступным коду в глобальной области видимости;
ко всем локальным переменным, вложенным функциям и пространствам имен, определенным внутри этой функции.
Код в функции, которая определена внутри статического метода, может обращаться к таким определениям:
ко всем определениям, доступным коду в глобальной области видимости;
ко всем определениям, доступным коду в области видимости данного статического метода;•
ко всем локальным переменным, вложенным функциям и пространствам имен, определенным внутри этой функции.
Код в функции, определенной внутри метода экземпляра, может обращаться к следующим определениям:
ко всем определениям, доступным коду в глобальной области видимости;
ко всем определениям, доступным коду в области видимости данного метода экземпляра;
ко всем локальным переменным, вложенным функциям и пространствам имен, определенным внутри этой функции.
Код в функции, которая определена внутри другой функции, может обращаться к таким определениям:
ко всем определениям, доступным коду в глобальной области видимости;
ко всем определениям, доступным коду в области видимости внешней функции;
ко всем локальным переменным, вложенным функциям и пространствам имен, определенным внутри этой функции.
Обзор областей видимости
Приведенный далее код демонстрирует все возможные области видимости языка
ActionScript:
package {
// Размещенный здесь код находится в глобальной области видимости
public class SomeClass {
// Этот код находится в области видимости класса SomeClass
public static function statlcMeth ( ):vo1d {
// Размещенный здесь код находится в области видимости метода
// statlcMeth
public function InstanceMeth ( ):vo1d {
// Этот код находится в области видимости метода InstanceMeth
function nestedFunc ( ):vo1d {
// Размещенный здесь код находится в области видимости функции // nestedFunc
}
// Этот код находится в глобальной области видимости
Детали реализации
Для осуществления хранения информации об определениях в цепочке областей видимости среда Flash использует список объектов. Информацию об определениях для каждой области видимости хранят следующие объекты.
Глобальная область видимости — глобальный объект (объект, автоматически создаваемый средой выполнения Flash для хранения глобальных определений).
Область видимости класса — объект Class данного класса (и объекты Class его предков).
Область видимости статического метода — объект Class данного класса (и объекты Class его предков).
Область видимости метода экземпляра — текущий объект (this) и объект активации (объект активации — это объект, создаваемый средой выполнения Flash и хранящийся в ней, который включает локальные переменные и параметры функции или метода).
Область видимости функции — объект активации.
Когда среда выполнения Flash встречает в программе выражение-идентификатор, она выполняет поиск этого идентификатора среди объектов в цепочке областей видимости. Например, рассмотрим следующий код:
package {
public class SomeClass {
public function InstanceMeth ( ):vo1d {
function nestedFunc ( ):vo1d { trace(a);
}
var a:1nt = 15:
Когда среда Flash встречает идентификатор а, она выполняет поиск его значения в объекте активации функции nestedFunc ( ). Однако в функции nestedFunc ( ) не определено никаких локальных переменных или параметров с именем а, поэтому далее среда Flash продолжает поиск идентификатора а в текущем объекте (то есть в объекте, через который был вызван метод InstanceMeth ( ) ). Но класс SomeClass не определяет и не наследует метод или переменную экземпляра
с именем а, поэтому после этого Flash продолжает поиск идентификатора а в классе объекта SomeClass. В классе SomeClass отсутствует определение статического метода или статической переменной с именем а, поэтому далее среда выполнения Flash продолжает поиск идентификатора а в объекте суперкласса класса SomeClass, которым является класс Object. Однако в классе Object отсутствует определение статического метода или статической переменной с именем а, поэтому после этого среда Flash продолжает поиск идентификатора а в глобальном объекте. В нем Flash находит идентификатор а и определяет, что значением этого идентификатора является 15. Получив значение идентификатора а, среда выполнения выводит число 15 в процессе отладки. Довольно много действий, чтобы найти маленькую а!
Вот объекты, среди которых среда выполнения Flash пыталась найти идентификатор а, перечисленные в порядке поиска:
объект активации функции nestedFunc ( );
объект, через который был вызван метод instanceMeth ( );
объект класса SomeClass;
объект класса Object;
глобальный объект.
Если бы идентификатор а не был найден в глобальном объекте, среда выполнения Flash сообщила бы об ошибке обращения.
Переменные, объявленные за пределами описания пакета, доступны только внутри исходного файла, содержащего эти переменные.
Теперь, когда все известно про цепочку областей видимости, завершим эту главу, рассмотрев единственный инструмент языка ActionScript, который позволяет непосредственно управлять цепочкой областей видимости, — оператор with.
Расширение цепочки областей видимости с помощью оператора with
Оператор with предоставляет сокращенный способ обращения к переменным и методам объекта, который исключает необходимость повторно указывать имя объекта. Этот оператор имеет следующий обобщенный вид:
with (объект') {
вложенныеИнструкции
}
Когда обращение к идентификатору происходит внутри блока оператора with, на наличие указанного имени проверяется объект объект до того, как будет проверена оставшаяся часть цепочки областей видимости. Другими словами, оператор with временно добавляет объект объект в конец внутреннего списка объектов, составляющих цепочку областей видимости среды выполнения Flash.
Например, чтобы обратиться к переменной РI внутреннего класса Math, мы обычно используем следующий код:
Math.PI;
Однако с помощью оператора with мы можем обратиться к переменной PI внутреннего класса Math без предварительного обращения к этому классу:
with (Math) { // Выполняем инструкции в контексте класса Math
trace(PI): // Выводит: 3.1459... (поскольку переменная PI определена
// в классе Math)
Некоторые разработчики находят оператор with полезным, когда создается код, в котором приходится часто обращаться к переменным и методам определенного объекта.
К пространствам имен
В этой главе мы узнали, как язык ActionScript управляет доступностью определений в различных областях видимости. В следующей главе мы научимся использовать пространства имен для управления видимостью определений. Стоит отметить, что пространства имен являются важной частью внутренней архитектуры языка ActionScript, но в пользовательском коде они обычно применяются только в сложных ситуациях.
Пространства имен
В самых общих чертах, пространство имен — это набор имен, не содержащий дубликатов. Иными словами, внутри этого набора каждое имя является уникальным. Например, в английском языке названия фруктов могут считаться пространством имен, поскольку каждый фрукт имеет уникальное имя: apple (яблоко), pear (груша), orange (апельсин) и т. д. Подобным образом пространством имен могут считаться названия цветов, поскольку каждый цвет обладает своим уникальным именем: blue (синий), green (зеленый), orange (оранжевый) и т. д.
Обратите внимание, что имя orange встречается в обеих группах имен. Имя orange само по себе не является уникальным — оно уникально только внутри каждой группы. В зависимости от того, идет разговор о фрукте или цвете, одно и то же имя orange может обозначать два различных предмета. В этом и заключается смысл пространств имен. Они позволяют одному и тому же имени (идентификатору) иметь различные значения в зависимости от контекста, в котором оно используется.
Что касается программирования, данная особенность пространств имен — «то же имя — другое значение» — обладает двумя общими преимуществами:
позволяет программистам избежать конфликтов имен;
дает возможность программе адаптировать свое поведение в соответствии с текущим контекстом.
В процессе изучения этой главы мы рассмотрим множество тонкостей, связанных с пространствами имен в языке ActionScript. Попытайтесь разобраться в теме так, чтобы различные подробности не уводили вас в сторону от относительной простоты пространств имен. По существу, пространства имен — это не более чем система именований, состоящая из двух частей. Они используются для того, чтобы отличать одну группу имен от другой, подобно тому как код города позволяет отличать один номер телефона от других телефонных номеров по всему миру.
Словарь пространств имвн
В этой главе мы встретимся с несколькими новыми терминами, относящимися к пространствам имен. Некоторые наиболее важные из них приведены далее в виде краткого справочника. Сейчас бегло ознакомьтесь с этим списком, чтобы получить общее представление, а в дальнейшем возвращайтесь к нему всякий раз, когда вам понадобится памятка при изучении последующих разделов. В оставшейся части этой главы каждый из приведенных терминов рассматривается гораздо более подробно.
Локальное имя — локальная часть уточненного идентификатора, то есть имя, которое уточняется пространством имен. Например, orange в fruit: : orange.
Название пространства имен — уникальное идентифицирующее название пространства имен, представленное в виде унифицированного идентификатора ресурса (URI — Uniform Resource Identifier). В языке ActionScript название пространства имен доступно через переменную экземпляра uri класса Namespace. В XML название пространства имен доступно через атрибут xml ns.
Префикс пространства имен — псевдоним названия пространства имен. Префиксы пространств имен используются только в языке XML, однако в ActionScript для упрощения операций расширения Е4Х к ним можно обращаться через переменную prefix класса Name spa се.
Идентификатор пространства имен — идентификатор, используемый при определении пространства имен в языке ActionScript. Например, в следующем определении пространства имен fruit является идентификатором:
namespace fruit = "http://www.example.com/games/k1dsgame/fru1t";
Открытое пространство имен — пространство имен, которое было добавлено в набор открытых пространств имен с помощью директивы use namespace.
Открытые пространства имен — набор пространств имен, просматриваемый компилятором при попытке разрешить неуточненные ссылки.
Уточняющее пространство имен — пространство имен, которое квалифицирует определение переменной или метода либо идентификатор пространства имен как уточненный идентификатор.
Уточненный идентификатор — идентификатор языка ActionScript, состоящий из двух частей и включающий идентификатор пространства имен и локальное имя, разделенные двумя двоеточиями. Например, fruit: : orange.
Пространства имен в языке ActionScript
В языке ActionScript пространство имен — это описатель для имени переменной, метода, XML-тега или XML-атрибута. Описатель ограничивает, или уточняет, значение идентификатора, позволяя нам сказать в коде, что «переменная orange является фруктом, а не цветом», или «метод search ( ) применяется для поиска в японском языке, а не в английском», или «тег <TABLE> описывает разметку HTML-страницы, а не часть мебели».
Используя пространства имен в языке ActionScript для уточнения имен переменных и методов, мы можем выполнить следующее.
Предотвратить конфликты именования (подробную информацию можно найти в разд. «Пространства имен для модификаторов управления доступом»).
Реализовать пользовательские уровни видимости методов и переменных во всей программе, независимо от структуры пакетов программы (обратитесь к примеру
пространства имен mx internal, рассмотренному в подразд. «Пример: управление видимостью на уровне прикладной среды» разд. «Практические примеры использования пространств имен»).
Реализовать контроль доступа, основанный на разрешениях, когда классы должны запрашивать доступ к переменным или методам (обратитесь к листингу 17.5 в подразд. «Пример: управление доступом на основании разрешений» разд. «Практические примеры использования пространств имен»).
Реализовать различные «режимы» в программе (обратитесь к листингу 17.7 в подразд. «Пример: реализация режимов работы программы» разд. «Практические примеры использования пространств имен»).
Кроме того, пространства имен в языке ActionScript предоставляют непосредственный доступ к пространствам имен языка XML в X ML-доку ментах. Эта тема рассматривается в разд. «Использование пространств имен XML» гл. 18.
Пространства имен в языке C++ в сравнении с пространствами имен в языке ActionScript. Хотя отчасти синтаксис пространств имен в ActionScript похож на синтаксис пространств имен в языке C++, в ActionScript пространства имен используются иначе, нежели в C++.
В языке C++ пространство имен является синтаксическим контейнером, подобно пакетам в языках ActionScript и Java. Здесь идентификатор считается находящимся в конкретном пространстве имен только в том случае, если он физически находится в операторе блока этого пространства имен. Например, в следующем коде переменная а находится в пространстве имен п, поскольку физическое размещение объявления переменной находится внутри блока пространства имен: namespace п {
1nt а;
} '
Таким образом, пространства имен в языке C++ в основном используются для того, чтобы предотвратить конфликты именования между различными частями кода и запретить одной части кода обращаться к другой части кода.
В отличие от этого в языке ActionScript пространство имен может включать любую переменную или метод, независимо от физической структуры кода. Пространства имен в языке ActionScript определяют правила видимости для методов и переменных, которые выходят за структурные границы (за границы классов и пакетов) программы.
Программисты на C++, пытающиеся отыскать в ActionScript эквивалент пространств имен языка C++, должны рассмотреть возможность использования пакетов ActionScript, которые описаны в гл. 1. В C++ не существует непосредственных аналогов пространств имен языка ActionScript.
Перед тем как перейти к рассмотрению примеров применения пространств имен, познакомимся с основными концепциями и синтаксисом, необходимыми при использовании пространств имен в ActionScript. В следующих нескольких вводных разделах мы создадим два пространства имен — fruit и color, после чего ис-
пользуем их для уточнения определений двух переменных и, наконец, обратимся к этим переменным с помощью так называемых уточненных идентификаторов. Изложенный материал мы будем рассматривать на примере простого приложения: детской игры «Учусь читать». Начнем.
Создание пространств имен
Чтобы создать пространство имен, мы должны присвоить ему название. Название каждого пространства имен, формально именуемое названием пространства имен, — это строка, которая по соглашению представляет унифицированный идентификатор ресурса, или URL Идентификатор URI однозначно идентифицирует пространство имен среди остальных пространств имен в программе и потенциально даже в любой другой программе по всему миру.
Термин URI относится к обобщенному стандарту идентификации ресурсов, подвидом м которого является известный стандарт адресации в Интернете — URL. Спецификацию Л' стандарта можно найти по адресу http://www.ietf.org/rfc/rfc2396.txt.
Использование идентификаторов URI в качестве названий пространств имен в языке ActionScript основано на стандарте, установленном консорциумом World Wide Web (W3C) в их рекомендации «Namespaces in XML». Текст документа доступен по адресу http://www. w3 .org/TR/xml-namesl 1.
Первым шагом на пути создания пространства имен является выбор идентификатора URI для названия будущего пространства.
Выбор идентификатора URI для пространства имен
Обычно идентификатором URI, используемым в качестве названия пространства имен, является указатель URL, который находится в управлении организации, создающей данный код. Например, моим сайтом является www.moock.org, поэтому для нового имени пространства имен я мог бы использовать идентификатор URI, имеющий следующую структуру:
http://www.moock. огд/приложение/пространство_имен
Мы воспользуемся следующими идентификаторами URI для пространств имен fruit и color, которые будут применены в создаваемой нами детской игре:
http://www.examplе.com/games/k1dsgame/fruithttp://www.example.com/games/k1dsgame/col or
Стоит отметить, что идентификатор URI не обязан — а зачастую так и происходит — существовать в действительности. Он применяется лишь для идентификации пространства имен. Это не адрес веб-страницы, XML-документа или любого другого сетевого ресурса. Можно использовать любой идентификатор URI, однако применение в качестве названия пространства имен указателя URL со своего собственного сайта позволяет минимизировать вероятность того, что другие организации будут использовать такое же название.
Определение пространства имен
Теперь, когда мы выбрали идентификатор URI, который будет использован в качестве названия нашего пространства имен, мы создаем пространство имен с помощью ключевого слова name space, за которым следует идентификатор пространства имен, знак = и, наконец, само название пространства имен (идентификатор URI): namespace идентификатор = URI;
Идентификатор пространства имен — это имя константы языка ActionScript, которой присваивается значение пространства имен (значением пространства имен является экземпляр класса Namespace, генерируемый в результате выполнения предыдущей инструкции). URI — пространство имен.
Например, чтобы создать пространство имен с идентификатором fruit и URI ’’http: //www. example. com/games/kidsgame/fruit”, мы используем: namespace fruit = "http://www.example.com/games/k1dsgame/fru1t";
Чтобы создать пространство имен с идентификатором color и URI ”http: // www. example . сот/games/kidsgame/color”, мы применяем:
namespace color = "http://www.example.com/games/k1dsgame/color";
Обратите внимание на отсутствие объявления типа — в данном случае его использование не допускается. Неявным типом данных идентификатора пространства имен всегда является Name space. Пространства имен могут определяться везде, где могут определяться переменные, а именно:
на верхнем уровне определения пакета;
на верхнем уровне определения класса;
в функции или методе;
на временной шкале клипа в FLA-файле.
Фактически пространства имен почти всегда определяются на верхнем уровне определения пакета или класса (если они не используются для XML-документов); дополнительную информацию можно найти в гл. 18. Пока мы будем определять все наши пространства имен на уровне пакета.
Чтобы создать пространство имен на уровне пакета, которое можно использовать в любом месте программы, поместите его определение в отдельный файл с расширением AS, имя которого полностью совпадает с именем идентификатора пространства имен, как показано в следующем примере для пространства имен fruit:
// Файл fruit.as
package kidsgame {
namespace fruit = "http://www.example.com/games/k1dsgame/fru1t": }
и для пространства имен color:
// Файл color.as
package kidsgame {
namespace color = "http://www.example.com/games/k1dsgame/color";
Далее, в разд. «Доступность пространств имен», мы рассмотрим примеры пространств имен, определенных на уровне класса или функции. Пространства имен, определенные на временной шкале клипа, рассматриваются так, будто они были определены на уровне класса в классе, который представляет клип, содержащий данные пространства имен (более подробную информацию об определениях на уровне временной шкалы можно найти в разд. «Класс документа» гл. 29).
Явные идентификаторы URI в сравнении с неявными
До сих пор все наши определения пространств имен включали явный идентификатор URI, аналогичный тому, который выделен полужирным шрифтом в следующем определении пространства имен:
namespace fruit = "http://www.example.com/games/k1dsgame/fruit":
Но когда объявление пространства имен явно не включает название пространства (URI), это название генерируется средой выполнения автоматически. Например, следующее определение пространства имен не включает идентификатор URI, поэтому среда автоматически создает его: package {
namespace nsl;
}
Чтобы доказать это, мы можем отобразить автоматически сгенерированный идентификатор URI для пространства имен nsl, как показано ниже:
namespace nsl;
trace(nsl.ur1); // Выводит: nsl
Метод экземпляра toString( ) класса Name space также возвращает значение переменной экземпляра uri, так что вызов функции trace ( ) можно сократить до:
trace(nsl): // Также выводит: nsl
Однако при определении пространств имен вообще целесообразно указывать идентификатор URI, поскольку явные URI можно легко идентифицировать в любом контексте, даже между несколькими SWF-файлами, в то время как автоматически генерируемые URI таким свойством не обладают. В данном разделе мы будем указывать явные идентификаторы URI для всех пространств имен.
Хорошей практикой является включение идентификатора URI в определения любых пространств имен.
Обзор терминологии по пространстоам имен
Всего на нескольких коротких страницах текста мы встретились с множеством новых терминов. Рассмотрим их.
Название пространства имен — это идентификатор URI, который идентифицирует пространство имен.
Класс Namespace представляет пространство имен в объектно-ориентированном виде.
Значение пространства имен — это экземпляр класса Name space.
Идентификатор пространства имен — это имя константы языка ActionScript, которая ссылается на значение пространства имен.
Вообще говоря, сложность этих терминов можно охватить одним простым названием — «пространство имен». Например, в этой книге мы часто используем простую фразу «пространство имен fruit» вместо более точной с технической точки зрения фразы «пространствоимен "http: //www. example. com/games/kidsgame/ fruit", представленное объектом Namespace, на который ссылается идентификатор fruit».
Чтобы упростить чтение этой книги, мы обычно будем использовать более простую и менее точную фразу «пространство имен fruit». Тем не менее отличие между названием пространства имен и идентификатором пространства имен является важным для некоторых последующих обсуждений, поэтому вы должны познакомиться с приведенной выше терминологией.
Использование пространств имен для уточнения определений переменных и методов
Теперь, когда мы определили пространства имен fruit и color, мы можем использовать их для указания так называемого уточняющего пространства имен для новых методов и переменных. Уточняющее пространство имен — это пространство имен, внутри которого имя переменной или метода является уникальным.
Чтобы указать уточняющее пространство имен для новой переменной или метода, используем идентификатор этого пространства имен в качестве атрибута определения переменной или метода, как показано в следующем примере:
// Указываем уточняющее пространство имен для переменной идентификаторПространстваИмен van имяСвойствалипДанных = необязательноеИсходноеЗначение;
// Указываем уточняющее пространство имен для метода
идентификаторПространстваИмен function имяМетода (параметры)-.ВозвращаемыйТип { инструкции
}
Следующие правила применяются к идентификатору идентификаторПространстваИмен.
Он должен быть доступен в области видимости, в которой определены переменная или метод, как рассматривается далее, в разд. «Доступность пространств имен».
Идентификатор не может быть литеральным значением; в частности, строковым литералом, содержащим название пространства имен (URI).
Он должен быть константой на этапе компиляции.
Эти три правила в действительности означают, что идентификатор идентифика- торПространстваИмен может являться только идентификатором пространства имен, созданного с помощью ключевого слова namespace, и, в частности, не может быть переменной, которая ссылается на значение пространства имен (такие переменные будут рассмотрены далее, в разд. «Присваивание и передача значений пространств имен»).
Вот как можно указать уточняющее пространство имен fruit для переменной экземпляра с именем orange:
fruit var orange:Str1ng = "Round citrus fruit";
Следующим образом можно указать уточняющее пространство имен color для переменной экземпляра с таким же именем orange:.
color var orange:String = "Color obtained by mixing red and yellow";
Допустимо и распространено использование одного уточняющего пространства имен для уточнения множества различных переменных, при котором подчеркивается тот факт, что имя каждой переменной уникально внутри данного пространства имен (в этом и заключается вся идея!). Например, рассмотрим другую переменную — purple, которая также уточняется пространством имен color:
color var purple:Str1ng = "Color obtained by mixing red and blue";
Когда несколько переменных и методов уточняются одним и тем же пространством имен п, можно считать, что они формируют логическую группу. С теоретической точки зрения естественно полагать, что переменная или метод «принадлежит» или «находится внутри» пространства имен, в котором они объявлены. Однако на техническом уровне «пространство имен» языка ActionScript не является структурой данных, которая физически хранит переменные или методы. Пространства имен не являются ни контейнерами данных, ни массивами. Они служат лишь для уточнения имен. Чтобы избежать путаницы, с этого момента мы будем использовать фразу «пространство имен п уточняет имя переменной р» вместо фразы «переменная с именем р принадлежит пространству имен п» или «переменная с именем р находится внутри пространства имен п».
Пространства имен не содержат имена; они просто уточняют их.
Обратите внимание, что для одного определения переменной или метода нельзя указать несколько пространств имен. Каждое определение может включать только одно уточняющее пространство имен. Например, следующий код недопустим:
// Попытка указать два пространства имен для одного определения.
fruit color var orange:String; // Вызывает следующую ошибку:
// Only one namespace attribute
// may be used per definition
// (В определении может указываться только
// одно пространство имен)
Атрибуты пространств имен, определенных пользователем, допустимы только на верхнем уровне описания класса. В предыдущем разделе было рассказано, как использовать собственные пространства имен в качестве атрибутов при определении методов и переменных. На самом деле это единственное место, где допустимо применять пространства имен, заданные пользователем, в качестве атрибута определения.
Пространства имен, определенные пользователем, можно применять в качестве атрибутов только на верхнем уровне описания класса.
Если вы попытаетесь использовать пространство имен, заданное пользователем, в качестве атрибута определения в любом другом месте, возникнет следующая ошибка:
A user-defined namespace attribute can only be used at the top level of a class definition.
По-русски она будет выглядеть следующим образом: Атрибут пространства имен, определенного пользователем, может быть использован только на верхнем уровне описания класса.
В частности, это значит, что вы не можете указать пространство имен, определенное пользователем, при определении класса, переменной на уровне пакета, функции на уровне пакета, локальной переменной или вложенной функции. Следующие определения являются недопустимыми:
// Недопустимое определение класса. Здесь не допускается использовать
// пространство имен color!
color class Picker {
}
public function doSomethlng ( ):vo1d {
// Недопустимое определение локальной переменной. Здесь не допускается
// использовать пространство имен color!
color var tempSwatch;
package p {
// Недопустимое определение переменной на уровне пакета. Здесь
// не допускается использовать пространство имен color!
color var favorites:Array:
}
Напротив, внутренние пространства имен языка ActionScript могут быть использованы в качестве атрибутов определения в любом месте, где это допускается языком ActionScript. Например, как будет рассказано далее, в разд. «Пространства имен для модификаторов управления доступом», модификаторы управления доступом (publi с, internal, protected и private) являются внутренними пространствами имен, а два из них (public и internal) могут быть использованы на уровне пакета.
Итак, вернемся к нашему коду. Мы уже знаем, как создать два пространства имен и три переменные, уточненные этими пространствами, — это показано в следующем коде:
// Создаем два пространства имен package kidsgame {
namespace fruit = "http://www.example.com/games/kidsgame/fruit";
}
package kidsgame {
namespace color = "http://www.example.com/games/k1dsgame/color";
}
// В любом месте внутри класса создаем три переменные
fruit var orange:Str1ng = "Round citrus fruit";
color var orange:String = "Color obtained by mixing red and yellow";
color var purple:Str1ng = "Color obtained by mixing red and blue";
Далее мы рассмотрим, как обращаться к этим переменным с помощью уточненных идентификаторов.
Уточненные идентификаторы
До сих пор все идентификаторы, с которыми мы встречались в этой книге, были так называемыми простыми идентификаторами — имеющими «простые» однокомпонентные имена, например box, height и border. Но для того, чтобы работать с пространствами имен, мы должны использовать уточненные идентификаторы. Уточненный идентификатор — это особый вид идентификатора, который включает не только имя, но и пространство имен, уточняющее это имя. Соответственно уточненные идентификаторы состоят из двух частей, а не из одной.
Локальное имя — имя, которое является уникальным внутри указанного пространства имен.
Уточняющее пространство имен — пространство имен, внутри которого данное локальное имя является уникальным.
В коде на языке ActionScript уточненные идентификаторы записываются следующим образом:
уточняющееПространствоИмен: ;локальноеИмя
Здесь локальное имя и уточняющее пространство имен объединяются вместе с помощью оператора уточнителя имени, записываемого в виде двух двоеточий (: :). Первая часть выражения —уточняющееПространствоИмен — должна быть представлена либо идентификатором пространства имен, либо переменной, значением которой является пространство имен. О том, как присваивать пространства имен переменным, будет рассказано далее, в разд. «Присваивание и передача значений пространств имен». Тем не менее часть уточняющееПространствоИмен не может быть представлена строковым литералом, являющимся названием пространства имен (URI).
Рассмотрим реальный пример использования уточненного идентификатора. Во- первых, вспомните наше предыдущее определение переменной orange, уточненное пространством имен fruit:
fruit var orange:Str1ng = "Round citrus fruit";
Вот как мы обращаемся к этой переменной с помощью уточненного идентификатора:
fruit::orange
Аналогично этому рассмотрим уточненный идентификатор для переменной с локальным именем orange, которое уточнено пространством имен color:
color::orange
Обратите внимание, что в предыдущих примерах локальные имена являются одинаковыми (orange), но отличаются уточняющие их пространства имен. Язык ActionScript использует уточняющее пространство имен для проведения различия между двумя локальными именами. В языке ActionScript уточненные идентификаторы используются точно так же, как и простые; они просто содержат уточняющее пространство имен. ФорматуточняющееПространствоИмен: : локальноеИмя применяется одинаково как к именам методов, так и к именам переменных:
someNamespace::р // Обращение к переменной р someNamespace::m( ) // Вызов метода т( )
Для обращения к уточненному идентификатору через объект применяется знакомый нам оператор «точка», как показано в следующем коде:
некийОбъект .уточняющееПространствоИмен: -.локальноеИмя
Например, этот код обращается к переменной р объекта someObj, которая уточняется пространством имен someNamespace:
someObj.someNamespace::р
Следующий код вызывает метод m ( ) объекта s omeOb j, который уточняется пространством имен someNamespace:
someObj.someNamespace::m( )
Расширенные имена. Как уже было сказано, уточненный идентификатор является двухкомпонентным именем, состоящим из уточняющего пространства имен и локального имени:
уточняющееПространствоИмен: -.локальноеИмя
ЧастьуточняющееПространствоИмен в уточненном идентификаторе — это ссылка на объект Namespace, переменная uri которого определяет название пространства имен.
Для сравнения отметим, что расширенное имя представляет собой двухкомпонентное имя, состоящее из литерала названия пространства имен (URI) и локального имени. Расширенные имена используются только в документации — но не в коде — и обычно записываются в следующем виде:
{названиеПространстваИмен}локальноеИмя
Например, снова рассмотрим определение пространства имен fruit:
namespace fruit = "http://www.example.com/games/k1dsgame/fru1t":
Теперь рассмотрим определение переменной orange, уточняемой пространством имен fruit:
fruit var orange:Str1ng = "Round citrus fruit":
В коде мы обращаемся к этой переменной с помощью уточненного идентификатора fruit: : orange. Однако в документации мы могли бы обсуждать эту переменную, ссылаясь на действительное название соответствующего пространства имен, а не на ее идентификатор. Это можно сделать с помощью следующего расширенного имени:
{http://www.example.com/games/k1dsgame/fru1t}orange
В этой книге расширенные имена применяются редко, однако они достаточно распространены в документации по пространствам имен XML. Если вы не используете пространства имен XML, просто знайте, что синтаксис {названиеПростран- стваИмен}локальноеИмя является только соглашением по документированию, но не поддерживаемым вариантом записи кода.
Функциональный пример использования пространств имен
Воспользуемся нашими новыми знаниями о пространствах имен для создания простейшей программы. В листинге 17.1 представлены базовые элементы приложения, которое мы будем разрабатывать на протяжении следующих разделов, — детской игры на распознавание слов. В ней игроку демонстрируется картинка с изображением цвета или фрукта и предлагается выбрать его название из списка вариантов. На рис. 17.1 показаны две различные картинки игры.
Рис. 17.1. Детская игра «Учусь читать»Рис. 17.1. Детская игра «Учусь читать»| Orange | | Purple || Orange | | Purple |
Рис. 17.1. Детская игра «Учусь читать»
Рис. 17.1. Детская игра «Учусь читать»
| Orange | | Purple |
| Orange | | Purple |
Пока каждый предмет в игре будет представлен переменной, значением которой является строковое описание. Мы определим набор всех переменных-предметов в классе с именем Items. С помощью пространств имен мы отделим перемен- ные-«фрукты» от переменных-«цветов»; названия переменных-«фруктов» будут уточняться пространством имен fruit, а названия переменных-«цветов» — пространством имен color.
Взглянем на код в листинге 17.1, после чего рассмотрим его более подробно.
Листинг 17.1. Детская игра: функциональный пример использования пространств имен
// Файл fruit.as package {
namespace fruit = "http://www.example.com/games/k1dsgame/fru1t";
// Файл color.as package {
namespace color = "http://www.example.com/games/k1dsgame/color";
}
// Файл Items.as package {
public class Items {
fruit var orange:Str1ng = "Round citrus fruit";
color var orange;String = "Color obtained by mixing red and yellow";
public function Items ( ) {
trace(fru1t::orange); tracetcolor: .-orange);
}
} }
Предыдущий код начинается с определения пространств имен нашей игры. Пространство fruit определяется в файле fruit, as, как показано в следующем коде: package {
namespace fruit = "http://www.example.com/games/k1dsgame/fru1t"; }
После этого мы определяем пространство имен color в файле color.as, как показано в следующем коде: package {
namespace color = "http://www.example.com/games/k1dsgame/color";
}
Оба пространства имен определены на уровне пакета, поэтому обращаться к ним может любой класс нашего приложения.
Затем мы определяем класс Items в файле Items . as. В классе Items определены две переменные, каждая из которых имеет локальное имя orange. Для первой переменной мы указываем уточняющее пространство имен fruit; для второй — уточняющее пространство имен color.
package {
public class Items {
fruit var orange:String = "Round citrus fruit";
color var orange:String = "Color obtained by mixing red and yellow";
} }
Наконец, чтобы убедиться, что наш код работает, в методе-конструкторе класса Items мы используем функцию trace ( ) для отображения значений обеих переменных orange. Чтобы отличать одну переменную orange от другой, используются уточненные идентификаторы fruit: : orange и color: : orange, package {
public class Items {
fruit var orange:Str1ng = "Round citrus fruit";
color var orange:Str1ng = "Color obtained by mixing red and yellow";
public function Items ( ) {
trace(fruit::orange); // Выводит: Round citrus fruit
trace(col or::orange); // Выводит: Color obtained by
// mixing red and yellow
}
}
}.
Попробуйте догадаться, что бы произошло, если бы мы изменили предыдущий конструктор класса Items и обращались к простому идентификатору orange, без применения уточняющего пространства имен, как показано в следующем коде:
public function Items ( ) {
trace(orange); // Что произойдет здесь?
}
Ответ: возникнет следующая ошибка на этапе компиляции программы:
Access of undefined property orange.
На русском языке она будет звучать так: Обращение к несуществующему свойству orange.
Компилятор не может найти переменную или метод (то есть «свойство») по имени orange, поскольку в области видимости метода-конструктора Items не существует переменной или метода с простым идентификатором orange. Переменные fruit: : orange и color: : orange уточняются с помощью пространств имен, поэтому они оказываются недоступны при попытке обратиться к ним с применением неуточненного идентификатора. И все-таки далее, в разд. «Открытые пространства имен и директива use namespace», мы познакомимся с упрощенным способом обращения к уточненным идентификаторам без использования уточняющего пространства имен.
Очевидно, что в листинге 17.1 не показана полнофункциональная игра, но этот код призван дать вам представление о базовом синтаксисе и использовании пространств имен. Мы завершим создание нашей игры далее в этой главе.
На этом начальном этапе разработки нашей игры вы могли бы поинтересоваться, почему вместо использования пространств имен мы не можем просто определить переменные с длинными именами, например orangeFruit и orangeColor. Или почему нельзя разделить оба вида oranges, присвоив их двум отдельным массивам, как показано в следующем коде:
var frulttlst:Array = ["orange", "apple", "banana"]:
var colorLIst:Array = ["orange", "red", "blue"];
Описанные варианты имеют право на жизнь. Фактически, учитывая выбранный уровень упрощений, нам действительно было бы лучше использовать массивы или более длинные имена переменных. Но не стоит пока терять веру в пространства имен; мы собираемся строить системы с более сложными сценариями использования.
Доступность пространств имен
Как и в случае с определениями переменных и методов, определения пространств имен могут быть изменены с помощью модификаторов управления доступом publ iс, internal, protected и private. Местоположение определения пространства имен в сочетании с модификатором управления доступом этого определения указывают, где может быть использован результирующий идентификатор пространства имен.
Вот несколько основных правил, которые помогут решить, где разместить ваши пространства имен.
Если пространство имен должно быть доступно в любом месте программы или в группе классов, определяйте его на уровне пакета.
Если вам требуется пространство имен, которое задает видимость переменных и методов внутри одного класса, определяйте его на уровне класса.
□ Если пространство имен будет применяться лишь иногда внутри функции и вы знаете идентификатор URI этого пространства имен, но не можете обращаться к нему напрямую, определяйте пространство имен на уровне функции.
Рассмотрим несколько примеров, начав с пространств имен, задаваемых на уровне пакета.
Доступность определений пространств имен на уровне пакета
В следующем коде мы определяем идентификатор пространства имен fruit в пакете kidsgame:
package kidsgame {
public namespace fruit = "http://www.example.com/games/k1dsgame/fru1t";
}
Поскольку идентификатор fruit объявлен на уровне пакета с использованием модификатора управления доступом public, он может быть применен для уточнения любой переменной или метода в данной программе. Безусловно, код за пределами пакета kidsgame должен импортировать пространство имен fruit перед его использованием, как показано в следующем примере:
package anyPackage {
// Импортируем пространство имен fruit
Import kidsgame.fruit;
public class AnyClass {
// Здесь можно применять пространство имен fruit, поскольку оно уже
// было импортировано
fruit var banana:Str1ng = "Long yellow fruit";
}
}
Теперь сделаем так, чтобы доступность пространства имен color была ограничена одним пакетом, используя модификатор управления доступом internal:
package kidsgame {
internal namespace color = "http://www.example.com/games/k1dsgame/color";
Когда идентификатор пространства имен определяется с применением модификатора управления доступом internal на уровне пакета, он может быть использован только внутри пакета, в котором определен. Это демонстрирует следующий код. package kidsgame {
public class Items {
// Здесь можно применять пространство имен color. Использование
// пространства имен color допустимо, поскольку оно происходит внутри
// пакета kidsgame
color var green:String = "Color obtained by mixing blue and yellow";
}
}
package cardgame {
Import kidsgame.col or;
public class CardGame {
// Недопустимо.
// Пространство имен color может быть использовано
// только внутри пакета kidsgame.
color var purple:Str1ng = "Color obtained by mixing blue and red";
} }
При определении пространств имен на уровне пакета могут применяться модификаторы управления доступом public и internal, при этом использование модификаторов управления доступом private и protected не допускается. Более того, если в определении пространства имен на уровне пакета модификатор управления доступом опускается, применяется модификатор управления доступом internal. Например, следующий код: package kidsgame {
// Internal указывается явно
Internal namespace fruit;
}
аналогичен данному коду:
package kidsgame {
// Internal подразумевается неявно namespace fruit;
}
Теперь рассмотрим определения пространств имен на уровне класса.
Доступность определений пространсте имен на уровне класса
Идентификатор пространства имен, определенный в классе с использованием модификатора управления доступом private, доступен только внутри данного класса и недоступен в его подклассах и в любом другом внешнем коде:
public class А {
private namespace n = "http://www.example.eom/n";
// Отлично. Идентификатор пространства имен п доступен в этом месте, n var someVar1ablе:1 nt:
public class В extends А {
// Ошибка. Идентификатор пространства имен п недоступен в этом месте.
n var someOtherVarlablе:1 nt;
Мы можем использовать пространство имен, объявленное с применением модификатора управления доступом private, для реализации системы управления доступом на основании разрешений. Эта система рассматривается далее, в подразд. «Пример: управление доступом на основании разрешений» разд. «Практические примеры использования пространств имен».
Идентификатор пространства имен, объявленный в классе с использованием модификатора управления доступом protected, internal или public, доступен напрямую в любом месте данного класса и его подклассов, но недоступен в любом другом внешнем коде. Такое определение пространства имен является противоположностью определения на уровне пакета с применением модификатора управления доступом pub lie, создающего идентификатор пространства имен, к которому можно обращаться напрямую из любого места программы. Это демонстрирует следующий код: public class А {
public namespace n = "http://www.example.eom/n";
// Отлично. Идентификатор пространства имен п доступен напрямую
// в этом месте.
n var someVar1able:1nt;
public class В extends A {
// Отлично. Идентификатор пространства имен п доступен напрямую // в этом месте.
n var someOtherVarlablе:1 nt;
public class С {
// Ошибка. Идентификатор пространства имен п напрямую не доступен
// в этом месте.
// (Но идентификатор п мог бы быть доступен, если бы он был определен
// на уровне пакета.)
n var yetAnotherVarlablе:1 nt;
}
Стоит отметить, что, хотя идентификатор пространства имен, объявленный в классе с использованием модификатора управления доступом internal или public, доступен напрямую только в этом классе и его подклассах, к объекту Name space, на который ссылается идентификатор пространства имен, можно обратиться с применением синтаксиса обращения к статическим переменным.
Например, чтобы обратиться к объекту Name space, на который ссылается идентификатор пространства имен п в предыдущем коде, мы могли бы использовать выражение: А. п. Доступ к объектам Namespace с помощью синтаксиса обращения к статическим переменным регламентируется обычными ограничениями, налагаемыми на статические переменные, объявленные с применением модификаторов управления доступом protected, internal и public. В предыдущем коде, поскольку идентификатор п объявлен с использованием модификатора управления доступом public, выражение А.п является допустимым в любом коде, который имеет доступ к классу А. Если бы идентификатор п был объявлен с использованием модификатора управления доступом internal, выражение А. п было бы допустимым только внутри пакета, содержащего определение данного пространства имен. Если бы идентификатор п был объявлен с использованием модификатора управления доступом protected, выражение А. п было бы допустимым только внутри класса А и его подклассов.
Однако ссылки на пространства имен, устанавливаемые через класс (например, А.п), не могут быть использованы в качестве атрибута в определении переменной или метода. Следующий синтаксис недопустим, поскольку атрибут определения переменной или метода должен быть константным значением на этапе компиляции:
А.п var p:1nt: // Недопустимо. А.п не является константой // на этапе компиляции.
Итак, если мы не можем использовать выражение А. п для уточнения определений, для чего оно может использоваться вообще? Оставайтесь с нами, мы скоро узнаем ответ на этот вопрос в разд. «Присваивание и передача значений пространств имен».
Пока рассмотрим последнюю тему, связанную с доступностью пространств имен: определение пространств имен в методах и функциях.
Доступность определений пространств имен на уровне функции
Как и в случае с другими определениями на уровне функции, идентификатор пространства имен, объявленный на уровне функции, не может включать никакие модификаторы управления доступом (то есть он не может быть объявлен с использованием модификаторов управления доступом public, private и т. д.) и доступен только в области видимости данной функции:
public function doSomethlng ( ):vo1d {.
// Это недопустимо
private namespace n = "http://www.example.eom/n":
}*
Более тогог определения локальных переменных и вложенных функций не могут использовать пространства имен в качестве атрибутов:
public function doSomethlng ( ):vo1d {
// Это тоже недопустимо
namespace n = "http://www.example.eom/n":
n var someLocalVar1able:1nt = 10:
}
Таким образом, идентификаторы пространств имен, определенные в функции, могут быть использованы только для формирования уточненных идентификаторов (в следующем коде предполагается, что пространство имен п было определено где-то в программе и применяется для уточнения переменной экземпляра someVariable).
public function doSomethlng ( ):vo1d {
// Это допустимо
namespace n = "http://www.example.eom/n";
tracetn: .-someVariable);
}
Определения пространств имен на уровне функции используются только в редких случаях, когда функция не может обратиться к пространству имен, которое временно требуется для этой функции, напрямую, при этом идентификатор URI пространства имен известен. Например, функция, которая обрабатывает фрагмент XML-документа, содержащего уточненные имена элементов, может использовать код, похожий на следующий:
public function getPrlce ( ):vo1d {
namespace htmlNS = "http://www.w3.org/1999/xhtml";
output.text = htmlNS::table.htmlNS::tr[l].htmlNS::td[l].price;
}
Пространства имен XML будут рассматриваться в гл. 18.
Видимость уточненных идентификаторов
Наверняка вы заметили, что в этой книге определения уточненных идентификаторов не включают модификаторы управления доступом (public, internal, protected или private). Мы видели достаточно много таких определений: fruit var orange:Str1ng = "Round citrus fruit";
Однако ни одного такого (обратите внимание на присутствие модификатора управления доступом private):
private fruit var orange:Str1ng = "Round citrus fruit";
По понятной причине нельзя использовать модификаторы управления доступом в определениях, которые включают уточняющее пространство имен. Например, следующий код:
private, fruit var orange:String;
вызовет ошибку:
Access specifiers not allowed with namespace attributes
На русском языке она будет звучать так: Использование спецификаторов вместе с атрибутами пространства имен недопустимо.
Однако если нельзя использовать модификаторы управления доступом, с помощью чего можно управлять доступностью уточненного идентификатора? Ответ: с помощью доступности идентификатора уточняющего пространства имен.
Доступность уточняющего пространства имен в уточненном идентификаторе определяет доступность этого идентификатора. Если уточняющее пространство имен доступно в указанной области видимости, значит, доступен и уточненный идентификатор.
Например, в выражении game items .fruit: : orange переменная fruit: : orange доступна тогда, и только тогда, когда пространство имен fruit доступно в области видимости этого выражения. Доступность переменной fruit: : orange целиком и полностью определяется доступностью пространства имен fruit.
В листинге 17.2 демонстрируется видимость уточненного идентификатора на примере обобщенного кода.
Листинг 17.2. Демонстрация видимости уточненного идентификатора
// Создаем пространство имен п в пакете one, видимое только в этом пакете package one {
internal namespace n = "http://www.example.eom/n";
}
// Создаем переменную n::p в классе А, пакет one
package one {
public class A {
n var p:1nt = 1:
}
}
// Поскольку пространство имен n объявлено с использованием модификатора
// управления доступом Internal, переменная п::р доступна в любом месте
// внутри пакета one
package one {
public class В {
public function В ( ) {
var a:A = new A( );
trace(a.n::p); // OK
}
}
}
// Однако переменная n::p недоступна для кода за пределами пакета one package two {
Import one.*;
public class C {
public function C ( ) { var a:A = new A( ); trace(a.n;:p); // Недопустимо, поскольку пространство имен n // объявлено с использованием модификатора управления // доступом Internal в пакете one, и поэтому // недоступно в пакете two
}
}
Сравнение уточненных идентификаторов
Два пространства имен считаются одинаковыми тогда, и только тогда, когда совпадают их названия (URI). Например, чтобы определить, являются ли одинаковыми пространства имен в уточненных идентификаторах fruit : : orange и color: : orange, среда выполнения Flash не проверяет, соответствуют ли буквы слова «fruit» первого идентификатора буквам слова color второго идентификатора. Вместо этого среда Flash проверяет, совпадают ли значения переменной uri экземпляра класса Name space, на который ссылается идентификатор fruit, и экземпляра класса Namespace, на который ссылается идентификатор color. Если значение переменной f ruit. uri равняется значению переменной color. uri, то пространства имен считаются одинаковыми.
Таким образом, когда мы записываем следующее выражение:
trace(fru1t::orange == color::orange);
среда Flash выполняет данное сравнение (обратите внимание на использование расширенных имен, которые рассматривались в разд. «Уточненные идентификаторы»):
{http://www.example.com/games/k1dsgame/fruit}orange
== {http://www.example.com/games/k1dsgame/color}orange
Даже если два уточненных идентификатора внешне кажутся различными, на деле они могут оказаться одинаковыми и привести к неожиданным конфликтам имен. Например, в следующем коде попытка определить переменную ns2 : : р вызовет ошибку на этапе компиляции, поскольку переменная с расширенным именем {http : //www. example . com/general }p уже существует:
namespace nsl = "http://www.example.com/general" namespace ns2 = "http://www.example.com/general" nsl var p:1nt = 1:
ns2 var p:1nt = 2; // Ошибка! Повторное определение переменной!
Даже несмотря на то, что идентификаторы ns 1 и ns 2 являются различными, переменные nsl: : р и ns2 : : р считаются одинаковыми, поскольку они имеют одинаковые расширенные имена ({http: //www. example . com/general }р).
Стоит отметить, что названия пространств имен (идентификаторы URI) сравниваются как строки, с учетом регистра символов. Поэтому, несмотря на то, что для браузера два идентификатора URI, которые отличаются только регистром символов, будут считаться одинаковыми, в языке ActionScript они будут считаться различными. В ActionScript следующие два идентификатора URI считаются различными, поскольку слово example в первом случае начинается со строчной буквы, а во втором — с прописной:
namespace nsl = "http://www.example.com"
namespace ns2 = "http://www.Example.com"
trace(nsl == ns2): // Отображает: false
Присваивание и передача значений пространств имен
Поскольку каждое пространство представлено экземпляром класса Name spa се, пространства имен могут присваиваться переменным или элементам массива, передаваться в методы и возвращаться из методов и вообще могут быть использованы, как любой другой объект. Эта гибкость позволяет:
передавать пространство имен из одной области видимости в другую;
динамически выбирать одно пространство имен из нескольких на этапе выполнения программы.
При использовании пространств имен в ActionScript эти действия являются крайне важными. Узнаем почему.
Присваивание значения пространства имен переменной
Чтобы присвоить значение пространства имен переменной, мы используем точно такой же синтаксис присваивания, как и для любого другого значения. Например, следующий код присваивает значение пространства имен fruit переменной currentltemType (напомним, что значение пространства имен — это объект класса Namespace):
// Файл fruit.as package { namespace fruit = "http://www.example.com/games/k1dsgame/fru1t";
}
// Файл Items.as package { public class Items { // Присваиваем значение пространства имен fruit переменной // currentltemType private var currentltemType-.Namespace = fruit;
} } Переменная, которая ссылается на объект класса Namespace, может быть использована для формирования уточненного идентификатора. Например, рассмотрим следующее определение переменной:
fruit var orange:Str1ng = "Round citrus fruit";
Для того чтобы обратиться к этой переменной, мы можем использовать выражение fruit: : orange либо currentltemType : : orange. Присвоив переменной currentltemType некоторое другое пространство имен, можно динамически изменить смысл идентификатора currentltemType: -.orange, а также всех остальных методов и переменных, уточняемых переменной currentltemType по всей программе. Если организовать группы методов и переменных с помощью пространств имен, мы можем воспользоваться возможностью динамического
выбора пространства имен для переключения между различными режимами работы программы.
Например, предположим, что мы создаем приложение для мгновенного обмена сообщениями, которое может функционировать в двух режимах, представляемых соответствующими пространствами имен offline и online. В приложении определены две версии метода с именем sendMes sage ( ): одна версия предназначена для работы в режиме онлайн, а другая — для работы в автономном режиме.
online sendMessage (msg;Str1ng):void {
// Отправить сообщение прямо сейчас...
}
offline sendMessage (msg:Str1ng);void {
// Поставить сообщение в очередь и отправить его позднее... }
Наше приложение управляет текущим режимом работы с помощью переменной currentMode. Всякий раз, когда устанавливается или теряется соединение с сервером, обновляется значение переменной currentMode.
private function connectLIstener (e:Event):void { currentMode = online;
}
private function closeLlstener (e:Event):void { currentMode = offline;
}
Во всех обращениях к методу sendMessage ( ) в качестве уточняющего пространства имен применяется переменная currentMode, как показано в следующем коде: currentMode;;sendMessage("yo dude");
Изменяя значение переменной currentMode, приложение динамически переключается между двумя версиями метода sendMessage ( ) в зависимости от состояния соединения.
Далее, в подразд. «Пример: реализация режимов работы программы» разд. «Практические примеры использования пространств имен», мы вернемся к концепции использования пространств имен в качестве режимов работы программы на примере японско-английского словаря, в котором происходит переключение между различными режимами поиска.
Просто запомните, что, хотя переменная может применяться для указания пространства имен уточненного идентификатора, переменные не могут быть использованы для указания пространства имен в определении переменной или метода. Третья строка следующего кода:
namespace fruit;
var currentItemType:Namespace = fruit;
currentltemType var orange:Str1ng = "Round citrus fruit";
вызовет такую ошибку:
Namespace was not found or 1s not a complle-ti’me constant.
377
По-русски это будет звучать так: Пространство имен не найдено, или оно не является константой на этапе компиляции.
Аналогичным образом переменные не могут быть использованы для указания пространства имен в директиве use namespace. Мы познакомимся с этой директивой далее, в разд. «Открытые пространства имен и директива use namespace».
Пространства имен в качестве аргументов и возвращаемых значений методов
Вдобавок к тому, что значения пространств имен могут присваиваться переменным и элементам массива, они могут передаваться в методы и возвращаться из них. Например, следующий код определяет метод doSomething ( ), который принимает значение пространства имен в качестве аргумента:
public function doSomething (n:Namespace):void { trace(n):
}
Этот код передает пространство имен fruit в метод doSomething ( ):
doSomething(fruit);
Пространство имен может передаваться в метод для того, чтобы перенести одну часть контекста программы в другую. Например, приложение, реализующее корзину в интернет-магазине, может передавать пространство имен currentLocale в класс Checkout, который затем динамически выберет подходящую валюту и зависящее от времени приветствие, взяв за основу текущее местоположение пользователя.
Этот код определяет метод getNamespace ( ), который возвращает пространство имен fruit:
public function getNamespace ( ):Namespace { return fruit:
}
Пространство имен может возвращаться из метода для того, чтобы предоставить вызывающему коду привилегированный доступ к закрытым переменным и методам. Полный пример, демонстрирующий возврат пространства имен из метода в качестве части системы управления доступом на основе разрешений, можно найти далее, в подразд. «Пример: управление доступом на основании разрешений» разд. «Практические примеры использования пространств имен».
Притер использования значения пространства имен
Теперь, когда мы познакомились с тем, как работают значения пространств имен в теории, вернемся к нашему предыдущему примеру детской игры и посмотрим, как значения пространств имен могут быть использованы в реальном приложении. Напомним, что указанная игра представляет собой упражнение на чтение, в котором игрок пытается распознать выбранный случайным образом цвет или фрукт.
Первая версия кода игры (см. листинг 17.1) демонстрировала единственный, чрезвычайно упрощенный фрагмент игры. В этой измененной версии мы сделаем игру полностью функциональной, подробно рассмотрев возможность применения пространств имен для управления несколькими наборами данных.
Бегло просмотрите код в листинге 17.3, чтобы получить общее представление о программе. В данном примере пространства имен используются только в классах I terns и Ki ds Game, поэтому вы должны сосредоточить свое внимание на этих классах. Информацию о методиках, применяемых для создания пользовательского интерфейса в этом примере, можно найти в части II. Подробный анализ кода представлен сразу после листинга.
Листинг 17.3. Детская игра: пример использования значения пространства имен
// Файл fruit.as•
package {
public namespace fruit = "http://www.example.com/games/k1dsgame/fru1t";
}
// Файл color.as
package {
public namespace color = "http://www.example.com/games/k1dsgame/color";
}
// Файл Items.as package {
// Простой класс для хранения данных, содержащий объекты Item для игры.
public class Items {
// Фрукты•
fruit var orange:Item = new Item("Orange", "fruit-orange.jpg", 1);
fruit var apple:Item = new Item("Apple", "fru1t-apple.jpg", 2);
// Цвета
color -var orange-.Item = new Item( "Orange", "color-orange, jpg", 3);
color var purple:Item = new ItemC'Purple", "color-purple.jpg", 4);
// Массивы, хранящие полные наборы элементов (то есть все фрукты
// или все цвета)
fruit var ItemSet:Array = [fruit::orange, fruit::apple];
color var ItemSet:Array = [color::orange, color::purple];
// Массив пространств имен, представляющих
// типы наборов элементов в игре
private var ItemTypes:Array = [color, fruit];
// Возвращает все элементы-фрукты, используемые в игре
fruit function getltems ( ):Array { return fruit;:1temSet.sl1ce(0);
}
// Возвращает все элементы-цвета, используемые в игре
color function getltems ( ):Array {*
return color::itemSet.slice(0):
}
// Возвращает список доступных типов элементов, используемых в игре public function getltemTypes ( ):Array {
return itemTypes.slice(O);
}
// Файл KidsGame.as
package {
import fl ash.di splay.*;
import fl ash.events.*;
import flash.utils.*:
// Основной класс приложения для детской игры «Учусь читать», которое
// демонстрирует основы использования пространств имен в языке ActionScript.
// Игроку показывается картинка с цветом или фруктом и предлагается выбрать
// название этого цвета или фрукта из списка вариантов.
public class KidsGame extends Sprite {
private var gameitems:Items: // Список всех элементов, используемых // в игре
private var thisQuestionltem:Item; // Элемент для каждого вопроса private var quest!onScreen:QuestionScreen: // Пользовательский интерфейс
// Конструктор
public function KidsGame( ) {
// Получаем элементы, используемые в игре (фрукты и цвета,
// названия которых должен указать игрок)
gameitems = new Items( );
// Отображаем первый вопрос newQuestion( );
}
// Создаем и отображаем новый случайный вопрос
public function newQuestion ( ):void {
// Получаем полный список типов элементов (массив пространств имен) var itemTypes:Array = gameitems.getItemTypes( );
// Случайным образом выбираем тип элемента (одно из пространств имен,
// на которые ссылается переменная itemTypes)
var randomItemType:Namespace = itemTypes[Math.floor(
Math.random( )*itemTypes.1ength)];
// Получаем элементы набора, выбранного случайным образом var items:Array = gameitems.randomltemType::getItems( );
// Случайным образом выбираем элемент для данного вопроса
// из набора элементов
thisQuestionltem = iterns[Math.floor(Math.random( )*iterns.length)];
// Удаляем предыдущий вопрос, если он существует
if (questionscreen != null) {
removeChild(quest1onScreen);
}
// Отображаем новый вопрос
questionscreen = new Quest1onScreen(th1s, Items, thlsQuestlonltem);
addChild(questionScreen);
// Обрабатываем ответ игрока
public function submitGuess (guess:int):void {
traceCGuess: " + guess + ", Correct: " + thlsQuestlonltem.id);
if (guess == thlsQuestlonltem.id) {
questlonScreen.displayResult("Correct!");
// Отключить кнопки ответа до тех пор, пока игрок не дождется
// следующего вопроса.
questlonScreen.d1sable( );
// Подождать 3 секунды перед отображением следующего вопроса, var timer:T1mer = new T1mer(3000, 1);
timer.addEventL1stener(T1merEvent.TIMER, doneResultDelay);
timer.start( );
} else {
questionscreen.displayResultC'Incorrect. Please try again.");
}
// Создает новый вопрос после того, как был получен
// ответ на предыдущий.
private function doneResultDelay (e:T1merEvent):void { newQuestion( );
// Файл Item.as■
package {
// Простой контейнер данных, который хранит информацию об элементе, public class Item {
// Название элемента (например, "apple")
public var name:String;
// Адрес URL, с которого загружается изображение,
// представляющее элемент
public var src:String;
// Уникальный идентификатор элемента, который используется
// для обработки ответов игрока
public var id:1nt;
// Конструктор
public function Item (name:String, src:String, 1d:int) {
this.name = name;
this.src = src; this.id = id;
}
}
// Файл QuestlonScreen.as package {
Import fl ash.events.*;
Import fl ash.display.*;
Import fl ash.text.*;
Import flash.net.*;
// Создает пользовательский интерфейс для вопроса
public class QuestlonScreen extends Sprite {
private var status:TextF1eld;
private var game:K1dsGame;
private var 1 terns:Array;
private var thlsQuestlonltem:Item;
// Конструктор
public function QuestlonScreen (game:K1dsGame,
Items;Array,
thlsQuestlonltem:Item) {
// Сохраняем ссылку на основной объект игры this.game = game;
// Собираем данные о вопросе
this.Items = Items;
this.thlsQuestlonltem = thlsQuestlonltem;
// Помещаем вопрос на экран makeQuest1on( );
// Создаем и отображаем интерфейс для вопроса
public function makeQuestlon ( ):vo1d {
// Отображаем картинку для элемента
var ImgLoader:Loader = new Loader( );
addChllddmgLoader);
ImgLoader.load(new URLRequest(th1sQuest1onItem.src));
// Добавляем набор слов, которые может выбирать игрок, // щелкая кнопкой мыши. Для упрощения будем отображать // название каждого элемента в наборе.
var wordButton:WordButton;
for (var 1:1nt = 0; 1 < Items.length; 1++) { wordButton = new WordButton( );
wordButton.setButtonText(1 terns[1].name);
wordButton.setID(1tems[1].1d);
wordButton.у = 110 + 1*(wordButton.height + 5);
wordButton.addEventListenerCMouseEvent.CLICK, clickListener); addChiId(wordButton);
}
// Создаем текстовое поле, в котором будет отображаться статус вопроса status = new TextF1eld( );
status.autoSize = TextFieldAutoSize.LEFT;
status.у = wordButton.у + wordButton.height + 10;
status.selectable = false;
addChild(status);
}
// Отображает сообщение в поле статуса
public function displayResult (msg:String).-void { status.text = msg;
}
// Выводит выбранное пользователем слово для данного вопроса
public function disable ( );vo1d {
// Отключаем события мыши для всех потомков данного объекта Sprite. mouseChlldren = false;
}
// Реагируем на событие, вызванное щелчком кнопкой мыши на кнопке-слове private function clickListener (e:MouseEvent):void {
// Выбранный игроком вариант имеет идентификатор элемента, который был
// присвоен объекту WordButton в методе makeQuest1on( ).
game.subm1tGuess(e.target.getID( ));
}
// Файл WordButton.as
package {
Import flash.text.*;
Import flash.display.*;
// Представляет на экране слово, на котором можно щелкнуть кнопкой мыши
// (то есть доступный вариант ответа на вопрос). ID обозначает
// идентификатор элемента, выбранного игроком (переменная Item.ld).
public class WordButton extends Sprite {
private var 1d:1nt; // Идентификатор элемента, представляемого // данной кнопкой
private var t;TextF1eld;
// Конструктор
public function WordButton ( ) {
t = new TextF1eld( );
t.autoSi'ze = TextFieldAutoSize.LEFT;
t.border = true;
t.background = true;
t.selectable = false;_
addChlld(t);
buttonMode = true; mousechildren = false;
}
// Присваивает текст, отображаемый на кнопке
public function setButtonText (text:String):void { t.text = text;
}
// Присваивает идентификатор элемента, представляемого данной кнопкой public function setID (newID:1nt):void {
1d = newID:
}
// Возвращает идентификатор элемента, представляемого данной кнопкой public function getID ( );1nt { return 1d;
}
}
}
Просмотрели код? Отлично, рассмотрим его более детально. Возможно, вы заметили, что определения пространств имен в игре не изменялись вообще с того момента, как они были представлены в листинге 17.1. Тем не менее существенно изменился класс Items, а также появилось несколько новых классов:
KidsGame — основной класс приложения;
Item — предоставляет информацию о конкретном элементе игры;
Questionscreen — формирует пользовательский интерфейс для каждого вопроса;
WordButton — представляет кнопку-слово на экране.
Поскольку сейчас наше внимание сосредоточено на пространствах имен, мы рассмотрим только классы Items и KidsGame. В качестве упражнения рассмотрите оставшиеся классы самостоятельно.
Для начала посмотрим, как изменился класс Items со времени его предыдущего представления в листинге 17.1. Во-первых, мы добавили две новые переменные fruit: : apple и color: : purple, представляющие элементы. Благодаря новым переменным каждая категория элементов для фруктов и цветов теперь состоит из двух элементов: апельсина и яблока для фруктов и оранжевого и фиолетового для цветов. Мы также заменили простые описания элементов из листинга 17.1 (например, Round citrus fruit) экземплярами класса Item. Экземпляры класса Item хранят название элемента, URL-адрес изображения этого элемента и его идентификатор. Следующий код демонстрирует измененные переменные, представляющие элементы. Как и в листинге 17.1, каждая переменная уточняется пространством имен, соответствующим множеству, которому принадлежит данный элемент.
fruit var orange:Item = new Item("Orange", "fruit-orange.jpg", 1);
fruit var apple:Item = new ItemCApple", "fruit-apple.jpg". 2):
color var orange:Item = new Item("Orange", "color-orange.jpg", 3): color var purple:Item = new ItemCPurple", "color-purple.jpg", 4);
Кроме того, в класс I terns добавлены два массива, предназначенные для управления элементами в виде групп. Каждый массив содержит полный список элементов своей группы (либо фруктов, либо цветов). Массивы присваиваются переменным с одним и тем же именем (itemSet), но уточняемым различными пространствами имен (fruit и color).
fruit var ItemSet:Array = [fruit::orange, fruit::apple];
color var ItemSet:Array = [color::orange, color: .-purple];
Чтобы предоставить доступ другим классам к различным наборам элементов в игре, в Items определено два метода с одним и тем же локальным именем getltems ( ), которое уточняется различными пространствами имен fruit и color. Каждый метод ge 11 terns ( ) возвращает копию набора элементов, соответствующего пространству имен данного метода. Таким образом, обратиться к подходящему набору элементов можно динамически, в зависимости от текущего типа вопроса (либо цвет, либо фрукт).
fruit function getltems ( ):Array {
// Возвращает фрукты.
return fruit::ItemSet.si1се(0):
}
color function getltems ( ):Array {
// Возвращает цвета.
return color::1temSet.sl1ce(0):
}
Наконец, в классе Items определены переменная itemTypes и соответствующий метод-аксессор getItemTypes ( ). Переменная itemTypes хранит список всех различных множеств элементов в игре. В нашей игре определено только два множества: фрукты и цвета, но в дальнейшем можно будет легко добавить новые множества. Каждое множество элементов соответствует пространству имен, поэтому переменная itemTypes представляет собой массив пространств имен. Метод get ItemTypes ( ) возвращает копию этого массива, предоставляя внешнему коду возможность централизованно получать официальный список типов элементов в игре.
// Переменная ItemTypes
private var ItemTypes.-Array = [color, fruit]:
// Метод getItemTypes( )
public function getltemTypes ( ):Array {
return 1temTypes.sl1ce(0);
}
Это все, что касается изменений в классе Items. Теперь рассмотрим новый основной класс приложения KidsGame. В отличие от Items, класс KidsGame никогда не
использует идентификаторы пространств имен fruit и color напрямую. Вместо этого он обращается к указанным пространствам имен через метод экземпляра getltemTypes ( ) класса Items.
Переменная game Items класса KidsGame позволяет ему обращаться к игровым данным посредством объекта класса Items. При этом метод newQuestion ( ) класса KidsGame генерирует новый вопрос на основании данных, хранящихся в переменной gameitems. Метод newQuestion ( ) включает основную часть кода, связанного с использованием пространств имен. Именно эта часть интересует нас больше всего, поэтому рассмотрим данный код детально.
Напомним, что каждый вопрос отображает элемент одного из предопределенных наборов элементов, хранящихся в классе Items (fruit: : itemSet или color: : itemSet). Соответственно первая задача, которая стоит перед методом newQuestion ( ), — случайным образом выбрать набор элементов для генерируемого вопроса. Сначала мы получаем весь массив возможных наборов элементов (то есть пространств имен) из класса Items, используя метод gameitems . getItemTypes ( ):
var ItemTypes:Array = gameItems.getItemTypes( );
Затем мы случайным образом выбираем пространство имен из результирующего массива. Для удобства мы присваиваем выбранное пространство имен локальной переменной randomltemType.
var randomltemType:Namespace = ItemTypes[Math.floor(
Math.random( )*itemTypes.1ength)]:
Обратите внимание, что типом данных переменной randomltemType является тип Namespace, поскольку эта переменная ссылается на значение пространства имен. Как только будет выбран набор элементов (пространство имен) для вопроса, мы должны получить список существующих элементов из этого набора. Чтобы получить соответствующий массив элементов (либо фруктов, либо цветов), мы вызываем метод класса Items, который соответствует нашему выбранному пространству имен, — либо метод fruit: : getltems ( ), либо метод color: : getIterns ( ). Однако вместо того, чтобы обращаться к желаемому методу напрямую, мы динамически генерируем уточненный идентификатор метода, используя переменную randomltemType для определения пространства имен, как показано в следующем коде:
gameitems.randomltemType::getltems( )
Массив, возвращаемый методом, присваивается локальной переменной items:
var items:Array = gameitems.randomltemType::getItems( ):
В предыдущем вызове метода обратите внимание, что поведение программы определя- 4 е ется контекстом программы. Эту особенность можно рассматривать как разновидность
—_дку полиморфизма, которая основывается не на наследовании классов, а на произвольных группах методов и переменных, определяемых пространствами имен.
Теперь, когда у нас на руках есть массив элементов, мы можем продолжить текущую работу, которая заключается в отображении вопроса на экране. Сначала
мы случайным образом выбираем элемент для отображения из массива элементов:
thisQuestionltem = items[Math.floor(Math.random( )*items.length)]:
Затем мы размещаем изображение и варианты ответов для выбранного элемента на экране, используя класс Questionscreen:
// Удаляем предыдущий вопрос, если он существует
if (questionScreen != null) { removeChild(questionScreen):
}
// Отображаем новый вопрос
questionScreen = new QuestionScreen(this, items, thisQuestionltem); addChild(questionScreen);
Приведем код метода newQuestion ( ) еще раз. Обратите особое внимание на использование значений пространств имен в этом коде, поскольку мы не будем больше возвращаться к нему.
public function newQuestion ( ):void {
// Получаем полный список типов элементов (массив пространств имен) var itemlypes .‘Array = gameitems.getItemTypes( );
// Случайным образом выбираем тип элемента (одно из пространств имен,
// на которые ссылается переменная itemlypes)
var randomltemType:Namespace = itemTypes[Math.floor(
Math.random( )*itemTypes.1ength)];
// Получаем элементы набора, выбранного случайным образом var items:Array = gameitems.randomltemType::getItems( ):
// Случайным образом выбираем элемент для данного вопроса
// из набора элементов
thisQuestionltem = iterns[Math.floor(Math.random( )*iterns.length)];
// Удаляем предыдущий вопрос, если он существует
if (questionScreen != null) { removeChild(questionScreen);
}
// Отображаем новый вопрос
questionScreen = new QuestionScreen(this, items, thisQuestionltem): addChild(questionScreen);
}
Оставшаяся часть кода из листинга 17.3 относится к игровой логике и созданию пользовательского интерфейса, что в настоящее время не является нашей основной задачей. Как уже отмечалось ранее, вы должны самостоятельно изучить оставшийся код. Информацию о методиках создания пользовательского интерфейса можно найти в части II этой книги.
Что ж, это был хороший практический пример. Впереди нас ждет еще несколько примеров, однако сначала мы должны рассмотреть две фундаментальные концеп-
ции, относящиеся к пространствам имен: открытые пространства имен и пространства имен для модификаторов управления доступом.
Открытые пространства имен и директива use namespace
Помните простой класс Items из листинга 17.1?
package {
public class Items {
fruit var orange:Str1ng = "Round citrus fruit":
color var orange:String = "Color obtained by mixing red and yellow":
public function Items ( ) {
trace(fru1t: -.orange): tracetcolor::orange): }
}
}•
Как уже говорилось, один из способов обращения к переменным orange в предыдущем коде заключается в применении уточненных идентификаторов, как показано ниже:
trace(fru1t::orange): // Выводит: Round citrus fruit tracetcolor::orange): // Выводит: Color obtained by //mixing red and yellow
Однако язык ActionScript предлагает еще один удобный инструмент для обращения к переменным, уточняемым пространствами имен: директиву use namespace. Директива use namespace добавляет указанное пространство имен в набор так называемых открытых пространств имен для определенной области видимости программы. Открытые пространства имен — это набор пространств имен, к которому обращается компилятор при попытке разрешить неуточненные ссылки. Например, если пространство имен п находится в наборе открытых пространств имен и компилятор встретит неуточненную ссылку на переменную р, то он автоматически проверит существование переменной п: : р.
Рассмотрим общий вид директивы use name space:
use namespace идентификаторПространстваИмен
Здесь идентификаторПространстваИмен — это идентификатор пространства имен, которое должно быть добавлено в набор открытых пространств имен. Стоит отметить, что данный идентификатор должен быть константой на этапе компиляции, поэтому не может быть переменной, которая ссылается на значение пространства имен.
Посмотрим на примере предыдущего конструктора класса Items, как работает директива use namespace, обратившись напрямую к локальной переменной orange после того, как пространство имен fruit будет добавлено в набор
открытых пространств имен (эта операция также называется открытием пространства имен fruit).
public function Items ( ) {
use namespace fruit: trace(orange):
}
Мы добавили пространство имен fruit в набор открытых пространств имен, поэтому, когда компилятор встретит следующий код:
trace(orange):
он автоматически проверит, существует ли уточненный идентификатор fruit: : orange. В нашем примере данный идентификатор существует, поэтому он будет использован вместо локального имени orange. Другими словами, в конструкторе класса Items этот код:
traceCfru1t::orange): // Выводит: Round citrus fruit
выполняет то же самое, что и следующий:
use namespace fruit:
trace(orange);// Выводит: Round citrus fruit
Открытые пространства имен и область видимости
Каждая область видимости в программе на языке ActionScript имеет отдельный список открытых пространств имен. Пространство имен, открытое в определенной области видимости, будет открыто для нее, включая вложенные области, но при этом оно не будет открыто для остальных областей видимости. Открытое пространство имен будет доступно даже до инструкции use namespace (однако лучше всего помещать директиву use namespace в самом верху содержащего ее блока кода).
Напомним, что «область видимости» обозначает «область программы». В ActionScript для каждого пакета, класса и метода определена уникальная область видимости. Условные операторы и операторы циклов не имеют собственных областей видимости.
В листинге 17.4 демонстрируется общий код, чтобы показать две различные области видимости со своими отдельными списками открытых пространств имен. Пояснения к коду приводятся в виде комментариев.
Листинг 17.4. Демонстрация открытых пространств имен
public class ScopeDemo {
// Создаем пространство имен.
private namespace nl = "http://www.example.com/nl":
// Создаем две переменные, уточняемые пространством имен nl.
nl var a:Str1ng = "а":
nl var b:Str1ng = "b":
// Конструктор
public function ScopeDemo ( ) {
// Вызываем метод, который обращается к переменной nl::а. showA( );
}
public function showA ( ):vo1d {
// Эта неуточненная ссылка на переменную а полностью соответствует
// уточненному идентификатору nl::a, поскольку следующая строка кода
// открывает пространство имен nl.
trace(a); // ОК!
// Открываем пространство имен nl. use namespace nl;
// Неуточненная ссылка на переменную а
// снова соответствует уточненному
// идентификатору nl::a. trace(a): // ОК!
// Создаем вложенную функцию.
function f ( ):vo1d {
// Пространство имен nl остается открытым во вложенных областях
// видимости...
trace(a); // ОК! Соответствует nl::a.
}
// Вызываем вложенную функцию.
f( ):
}
public function showB ( ):vo1d {
// В следующем коде происходит неправильное обращение к переменной
// nl::b. Пространство имен nl открыто только в области видимости метода
// showA( ), но не в области видимости метода showB( ), поэтому попытка
// обращения окажется неудачной. Более того, в области видимости метода
// showB( ) не существует ни одной переменной с простым
// идентификатором Ь, поэтому компилятор сгенерирует следующую ошибку:
// Attempted access to Inaccessible property b through a reference
// with static type ScopeDemo.
// (Предпринята попытка обращения к недоступному свойству b через
// ссылку на статический тип ScopeDemo.) trace(b); // ОШИБКА!
}
}
Поскольку открытое пространство имен остается открытым во вложенных областях видимости, мы можем открывать пространство имен на уровне класса или пакета с тем, чтобы использовать его в любом месте блока инструкции class или package. Однако стоит отметить, что после того, как пространство имен было открыто, закрыть его будет невозможно. Не существует директивы unuse namespace, равно как не существует способа удалить пространство имен из списка открытых пространств имен определенной области видимости.
Открытие нескольких пространств имен
Вполне допустимо открывать несколько пространств имен в одной и той же области видимости. Например, рассмотрим четыре переменные, относящиеся к двум пространствам имен (переменные взяты из класса Items, представленного в листинге 17.3):
fruit var orange:Item = new Item("Orange", "fruit-orange.jpg", 1): fruit var apple:Item = new ItemCApple". "fru1t-apple.jpg", 2): color var orange:Item = new Item("Orange". "color-orange.jpg", 3); color var purple:Item = new ItemCPurple". "color-purple.jpg", 4):
Предположим, что мы добавили метод showitems ( ) в класс Items для отображения всех элементов игры. В этом методе мы можем открыть оба пространства имен fruit и color, азатем обращаться к переменным fruit: : apple и color: : purple, не указывая уточняющее пространство имен:
public function showitems ( ):void {
use namespace fruit; use namespace color;
// Вот это да! Никаких пространств имен!
trace(apple.name): // Выводит; Apple trace(purple.name): // Выводит; Purple
}
Рассмотрим, как это работает. Как уже известно, термин «открытые пространства имен» означает «набор пространств имен, к которому обращается компилятор при попытке разрешить неуточненные ссылки». Если в указанной области видимости открыто несколько пространств имен, компилятор проверяет каждое пространство абсолютно для всех неуточненных ссылок в данной области видимости. Например, в методе showitems ( ) открыты оба пространства имен fruit и color. Следовательно, когда компилятор встречает неуточненный идентификатор apple, он проверяет, существуют ли идентификаторы fruit: : apple и color: : apple. В случае с идентификатором apple неуточненная ссылка соответствует идентификатору fruit: : apple, но не соответствует идентификатору color: : apple. Поскольку идентификатор apple соответствует только одному уточненному идентификатору (а именно, fruit: : apple), этот уточненный идентификатор и используется вместо неуточненной ссылки apple.
Что же произойдет в том случае, если используется неуточненная ссылка, как, например, orange, которая соответствует двум уточненным идентификаторам: public function showitems ( ):void { use namespace fruit:
use namespace color;•
// Соответствует fruit::orange и color:;orange -
// что произойдет в этом случае?
trace(orange);
}
Если неуточненная ссылка соответствует имени в более чем одном пространстве имен, возникает ошибка на этапе выполнения. Предыдущий код вызовет следующую ошибку:
Ambiguous reference to orange.
По-русски ошибка будет выглядеть следующим образом: Неоднозначная ссылка на orange.
Из-за ошибки в некоторых компиляторах компании Adobe предыдущая ошибка может остаться незамеченной.
Если открыты оба пространства имен fruit и color, мы должны использовать уточненные идентификаторы fruit: : orange или color: : orange для обращения к нашим переменным orange, исключая неоднозначность, как показано в следующем коде:.
public function showitems ( ):vo1d { use namespace fruit; use namespace color;
trace(apple); // Выводит: Apple trace(purple); // Выводит: Purple
// Открыты оба пространства имен fruit и color, поэтому ссылки // на переменную orange должны быть полностью уточнены. trace(fruit::orange);
trace(color::orange);
Пространства имен дня модификаторов управления доступом
Точно так же, как мы используем пространства имен для управления видимостью переменных и методов в наших собственных программах, язык ActionScript использует пространства имен для управления видимостью каждой переменной и каждого метода в любой программе! Помните четыре модификатора управления доступом в ActionScript — public, internal, protected, private? Сам язык ActionScript реализует приведенные правила видимости с помощью пространств имен. Например, с точки зрения ActionScript определение переменной:
class А {
private var p:1nt;
означает «создать новую переменную р, уточняемую пространством имен private класса А».
В каждой области видимости ActionScript неявно открывает подходящее пространство имен для различных модификаторов управления доступом. Например, в каждой области видимости всегда добавляется глобальное пространство имен public в набор открытых пространств имен. На верхнем уровне пакета также добавляются пространства имен internal и public данного пакета. В коде класса, который находится внутри пакета, также добавляются пространства имен private и protected данного класса. Таким образом, набор открытых пространств имен включает не
только пространства имен, открытые пользователем, но и пространства имен для управления доступом, которые неявно открываются в каждой области видимости.
Открыть пространства имен для управления доступом явно с помощью директивы use namespace невозможно. Среда выполнения открывает пространства имен для управления доступом автоматически, в соответствии с текущей областью видимости.
Пространства имен для модификаторов управления доступом определяют доступность идентификаторов и предотвращают конфликты именования. Например, в следующем коде суперкласс Parent и подкласс Child определяют переменную с одним и тем же именем, используя модификатор управления доступом private: description. Переменная description класса Parent недоступна для кода в классе Child, поскольку она уточнена пространством имен private класса Parent, которое не открывается в области видимости класса Child. Благодаря этому названия переменных не конфликтуют между собой.
package р {
public class Parent. {
private var descr1pt1on:Str1ng = "A Parent object";
public function Parent ( ) { trace(descri'ptlon);•
}
} }
package p {
public class Child extends Parent {
private var description:String = "A Child object";
public function Child () {
trace(description); // Конфликта не происходит
Однако если переменную description класса Parent объявить с использованием модификатора управления доступом protected, возникнет конфликт. Рассмотрим почему. Во-первых, изменим модификатор управления доступом для переменной description на protected:
public class Parent {
protected var description-.String = "A Parent object";
}
Теперь представим себя на месте среды Flash, пытающейся выполнить код в конструкторе класса Child. Мы входим в конструктор и встречаем ссылку на идентификатор description. Чтобы разрешить этот идентификатор, мы должны проверить его существование в открытых пространствах имен. И какие же пространства имен открыты в конструкторе класса Child? Как мы уже знаем, в коде класса, который находится внутри пакета, среда Flash открывает пространства имен private и protected данного класса, пространства имен internal и public пакета и глобальное пространство имен public. Итак, открытыми пространствами имен являются:
пространство имен private класса Child;
пространство имен protected класса Child (которое уточняет все члены, унаследованные от непосредственного суперкласса);
пространство имен internal пакета р;
пространство имен public пакета р;
глобальное пространство имен public;
все пользовательские пространства имен, открытые явным образом.
Когда среда выполнения проверяет существование переменной description в открытых пространствах имен, она находит два соответствия: private : .-description и protected: :description класса Child. Как мы уже знаем из предыдущего раздела, когда неуточненная ссылка соответствует имени в более чем одном пространстве имен, возникает ошибка неоднозначного обращения. Более того, если несколько имен уточняются различными неявно открытыми пространствами имен, возникает ошибка, связанная с конфликтом определений. В случае с переменной description возникнет следующая ошибка:
A conflict exists with Inherited definition Parent.description 1n namespace protected.
На русском языке она будет выглядеть так: Существует конфликт с унаследованным определением Parent.description в пространстве имен protected.
Если в вашем коде существуют конфликтующие имена методов и переменных, компилятор опишет суть конфликта, указав пространство имен, в котором этот конфликт произошел. Например, следующий код:
package {
Import flash.display.*;
public class SomeClass extends Sprite {
private var prop:1nt;
private var prop:1nt; // Недопустимое повторное определение свойства
вызовет следующую ошибку:
A conflict exists with definition prop 1n namespace private.
По-русски это будет звучать так: Существует конфликт с определением prop в пространстве имен private.
На самом деле из-за ошибки компилятора в приложениях Flex Builder 2 и Flash CS3 предыдущее сообщение будет содержать неправильную фразу name space internal, хотя должно быть namespace private.
Подобным образом, данный код:
package {
Import flash.display.*;
public class SomeClass extends Sprite {
private var x;
вызовет следующую ошибку (поскольку — об этом вы можете почитать в справочнике по языку ActionScript компании Adobe — в классе Di splayObject уже определена переменная х с использованием модификатора управления доступом public):
A conflict exists with inherited definition flash.display:DisplayObject.x in namespace public.
На русском языке это будет выглядеть следующим образом: Существует конфликт с унаследованным определением flash.display:DisplayObject.x в пространстве имен public.
Директива import открывает пространства имен public. Стоит отметить, что с технической точки зрения импортирование пакета, как показано в следующем коде: import somePackage.*;
открывает пространство имен public импортированного пакета. Тем не менее оно не открывает пространство имен internal импортированного пакета. Даже если пакет импортируется, его идентификаторы, объявленные с использованием модификатора управления доступом internal, остаются недоступными для внешнего кода.
Практические примеры использования пространств имен
В самом начале этой главы упоминалось четыре практических сценария использования пространств имен:
предотвращение конфликтов именования;
управление видимостью членов на уровне прикладной среды;
управление доступом на основании разрешений;
□ реализация различных режимов работы программы.
В предыдущем разделе рассказывалось, как пространства имен предотвращают конфликты именования. В этом разделе мы рассмотрим каждый из трех оставшихся сценариев на примерах из реальной жизни.
Пример: управление видимостью на уровне прикладной среды
Наш первый пример прикладного использования пространств имен взят из прикладной среды Flex компании Adobe — это библиотека компонентов пользовательского интерфейса и утилит для разработки интернет-приложений с широкими функциональными возможностями.
Прикладная среда Flex включает большое количество кода — сотни классов, размещаемых в дюжинах пакетов. Некоторые методы и переменные этих классов должны быть доступны в различных пакетах, но при этом они должны считаться внутренними по отношению ко всей прикладной среде. Возникает дилемма: если методы и переменные объявить с использованием модификатора управления до-
ступом public, код, находящийся за пределами прикладной среды, будет иметь к ним нежелательный доступ, но если их объявить с использованием модификатора управления доступом internal, эти методы и переменные нельзя будет использовать в других пакетах.
Для разрешения этой ситуации в прикладной среде Flex определяется пространство имен mx internal, используемое для уточнения методов и переменных, которые не должны быть видны за пределами прикладной среды, но при этом должны быть доступны в различных пакетах внутри ее.
Вот объявление пространства имен mx internal:
package mx.core {
public namespace mxjnternal =
"http://www.adobe.com/2006/f1ex/mx/1nternal";
Рассмотрим конкретный пример использования пространства имен mx internal из прикладной среды Flex.
Для работы с табличными данными наподобие тех, которые используются в программах электронных таблиц, прикладная среда Flex предоставляет компонент Da taGr id. Класс DataGrid находится в пакете mx. controls. Вспомогательные классы для компонента DataGrid размещаются в отдельном пакете:mx.controls .gridclasses. Чтобы взаимодействие между классом DataGrid и его вспомогательными классами осуществлялось максимально эффективно, DataGrid обращается к некоторым внутренним переменным его вспомогательных классов напрямую, а не с помощью доступных всем методов-получателей. Однако эти внутренние переменные не должны использоваться классами за пределами прикладной среды Flex, поэтому они уточняются пространством имен mx internal. Например, вспомогательный класс mx. controls . gridclasses . DataGridColumn хранит индекс столбца в переменной mx_internal:: colNum.
// Файл DataGridColumn.as
mxjnternal var col Num: Number;
Чтобы получить индекс столбца, класс DataGrid сначала открывает пространство имен mx_internal: use namespace mxjnternal;
а затем обращается к переменной mx internal: : colNum напрямую, как показано в следующем фрагменте кода, взятого из определения метода-писателя:
// Файл DataGrid.as
public function set columns(value:Array):void {
// Инициализируем "colNum" для всех столбцов
var n:1nt = value.length;
for (var 1;1nt = 0; 1 < n; 1++) {
var column:DataGridColumn = _columns[1]; column.owner = this;
// Обращаемся к переменной mxjnternal::col Num напрямую. (Напомним, что
// пространство имен mxjnternal открыто, поэтому выражение
// column.colNum эквивалентно выражению column.mxjnternal::col Num.)
column.col Num = 1;
И Оставшаяся часть метода не приводится }
Классы за пределами прикладной среды Flex для получения индекса столбца используют общедоступный метод getColumnlndex ( ) вместо обращения к переменной mx_internal: : colNum напрямую.
Проблема решена на 9/10. Помещение переменных и методов в пространство имен mx internal, безусловно, уменьшает их непосредственную видимость, однако технически это не запрещает коду за пределами прикладной среды Flex обращаться к ним. Любой разработчик, которому известен идентификатор URI пространства имен mx_internal, может применять этот идентификатор для обращения к любой переменной или методу, уточняемому с использованием пространства имен mx_internal.
Однако целью пространства имен mx internal является не техническое запрещение использования переменных и методов разработчиком. Скорее оно является большим знаком предупреждения, сообщающим о том, что переменные и методы не предназначены для использования внешним кодом и могут быть изменены без предупреждения или привести к ошибочному поведению, если обращение к ним осуществляется из кода за пределами прикладной среды Flex.
Пример: управление доступом на основании разрешений
Второй пример использования пространств имен демонстрирует вариант механизма управления доступом, когда класс определяет группу методов и переменных, к которым могут обращаться только определенные классы. В этом примере задействованы следующие участники.
Заи^шцаемый класс — класс, который предоставляет доступ к своим защищенным методам и переменным.
Методы и переменные с ограниченным доступом — группа методов и переменных, доступ к которым ограничен.
Авторизованные классы — классы, которым разрешен доступ к методам и переменным с ограниченным доступом.
Рассмотрим базовый код защищаемого класса:
package {
// Это защищаемый класс.
public class ShelteredClass {
// Пространство имен restricted уточняет переменные
// и методы, доступ к которым ограничен, private namespace restricted;
// Это массив авторизованных классов. В данном примере
// определен только один авторизованный класс: Caller.
private var authorlzedClasses:Array = [ Caller ];
// Это переменная с ограниченным доступом.
// К ней могут обращаться только авторизованные
// классы.
restricted var secretData;String = "No peeking";
// Это метод с ограниченным доступом.
// К нему могут обращаться только авторизованные
// классы.
restricted function secretMethod ( );vo1d {
trace("Restricted method secretMethod( ) called");
}
Защищаемый класс хранит массив авторизованных классов. Кроме того, в нем объявлено пространство имен с использованием модификатора управления доступом private, которое применяется для уточнения методов и переменных с ограниченным доступом. Более того, идентификатор URI для этого пространства имен генерируется автоматически, поэтому его невозможно узнать и использовать за пределами данного класса. Наконец, защищаемый класс определяет сами переменные и методы с ограниченным доступом.
Для обращения к методу или переменной с ограниченным доступом (например, secretData или secretMethod ( ) ) потенциальный класс должен получить общеизвестные «ключи от парадной двери». Другими словами, он должен получить ссылку на пространство имен, которое уточняет методы и переменные с ограниченным доступом. Однако защищаемый класс предоставит эту ссылку только в том случае, если потенциальный класс — будем называть его «вызывающим классом» — является одним из элементов массива authorizedClasses.
В нашем примере вызывающий класс будет просить у класса ShelteredClass ссылку на пространство имен restricted, используя метод getRestricted Namespace ( ) класса ShelteredClass. Метод getRestrictedAccess ( ) принимает экземпляр вызывающего класса в качестве аргумента. Если экземпляр вызывающего класса оказывается авторизованным, метод getRestrictedNames расе ( ) вернет ссылку на пространство имен restricted. В противном случае метод вернет значение null, которое сообщает о том, что вызывающий класс не имеет права обращаться к методам и переменным с ограниченным доступом. Рассмотрим код метода getRestrictedNamespace ( ):
public function getRestrictedNamespace
(cal lerObject;Object.):Namespace {
// Проверяем, есть ли объект callerObject в массиве authorizedClasses.
for each (var author1zedClass;Class 1n authorizedClasses) {
// Если вызывающий объект является экземпляром авторизованного класса...
1f (callerObject 1s authorlzedClass) {
// ...возвращаем обратно ссылку на пространство имен restricted
// («ключи от парадной двери») return restricted;
}
}
// Вызывающий объект не является экземпляром
// авторизованного класса, поэтому
// запрещаем дальнейшее обращение к переменной
// и методу с ограниченным доступом, return null;
В листинге 17.5 продемонстрирован весь код класса ShelteredClass, включая метод getRestrictedNamespace ( ).
Листинг 17.5. Класс ShelteredClass
package {
// Это защищаемый класс
public class ShelteredClass {
// Пространство имен restricted уточняет переменные
// и методы, доступ к которым ограничен, private namespace restricted;
// Это массив авторизованных классов. В данном примере
// определен только один авторизованный класс: Caller, private var authorlzedClasses:Array = [ Caller ];
// Это переменная с ограниченным доступом.
// К ней могут обращаться только авторизованные классы, restricted var secretData:String = "No peeking":
// Это метод с ограниченным доступом.
// К нему могут обращаться только авторизованные классы.
restricted function secretMethod ( ):vo1d {
trace("Restricted method secretMethodt ) called");
}
public function getRestrictedNamespace
(callerObject:Object):Namespace {
// Проверяем, есть ли объект callerObject в массиве authorlzedClasses.
for each (var author1zedClass:Class in authorlzedClasses) {
// Если вызывающий объект является экземпляром
// авторизованного класса...
if (callerObject 1s authorlzedClass) {
// ...возвращаем обратно ссылку на пространство имен restricted
// («ключи от парадной двери») return restricted;
}
// Вызывающий объект не является экземпляром
// авторизованного класса, поэтому
// запрещаем дальнейшее обращение к переменной
// и методу с ограниченным доступом, return null;
}
}
Теперь рассмотрим класс Caller — класс, который желает получить доступ к методам и переменным с ограниченным доступом класса Shel teredClas s. Принимая во внимание значения элементов массива authorizedClasses класса She Ite г edC lass, мы знаем, что класс Caller является допустимым. В нашем примере Caller также является основным классом приложения, поэтому он расширяет класс Sprite. Класс Caller создает экземпляр класса ShelteredClass в своем методе конструктора и присваивает этот экземпляр переменной shelteredOb j ect.
package {•
import flash.display
public class Caller extends Sprite {
private var shelteredObject:ShelteredClass;
public function Caller () { shelteredObject = new ShelteredClass( );
Чтобы вызвать метод secretMethod ( ) класса ShelteredClass, объект Caller должен сначала получить ссылку на пространство имен restricted. Для этого объект Caller передает себя в метод getRestrictedNamespace ( ) и присваивает результат (либо пространство имен restricted, либо значение null) переменной key для дальнейшего использования.
var key:Namespace = shelteredObject.getRestrlctedNamespace(thls):
Далее, перед тем как вызвать метод secretMethod ( ), объект Caller проверяет, ссылается ли переменная key на допустимое пространство имен. Если это так, объект Caller использует переменную key в качестве пространства имен для вызова метода secureMethod ( ):
1f (key != null) {
shelteredObject.key::secureMethod( ):
}
Для удобства метод с именем callSecretMethod ( ) нашего класса Caller включает код, который вызывает метод secretMethod ( ):
public function callSecretMethod ( ):vo1d {
var key:Namespace = shelteredObject.getRestrlctedNamespace(thls):
1f (key != null) {
shelteredObject.key:: secretMethod( ):
Листинг 17.6 демонстрирует весь код рассматриваемого класса Caller, включая метод callSecretMethod ( ) и другой удобный метод displaySecret ( ), который обращается к переменной secretData с ограниченным доступом, используя тот же основной принцип.
Листинг 17.6. Класс Caller
package {
Import flash.display.*:
public class Caller extends Sprite {
private var shelteredObject:ShelteredClass;
public function Caller ( ) {
shelteredObject = new ShelteredClassC );
callSecretMethod( ): d1splaySecret( );
}
public function call SecretMethod ( ):vo1d {
var key-.Namespace = shelteredObject.getRestrlctedNamespace(thls);
1f (key != null) {
shelteredObject.key::secretMethod( );
}
}
public function displaySecret ( ):void {
var key:Namespace = shelteredObject.getRestrictedNamespace(this);
if (key != null) {
trace(shelteredObject.key::secretData);
}.
}
Пример: реализация режимов работы программы
Последним рассматриваемым примером будет электронный словарь, который позволяет переводить с японского языка на английский и наоборот. Словарь демонстрирует использование режимов программы — область программирования на языке ActionScript, где применяются пространства имен, с самым большим потенциалом. Находясь в «режиме японского языка», словарь возвращает английский перевод для японских слов; находясь в «режиме английского языка», словарь возвращает японский перевод для английских слов. Каждый режим представляется пространством имен: j apanese для японско-английского режима и english для англо-японского режима.
В этом примере задействованы следующие участники:
Japanese — пространство имен для переменных и методов, относящихся к японскому языку;
English — пространство имен для переменных и методов, относящихся к английскому языку;
QueryManager — класс, осуществляющий поиск слов;
Searchoptions — этот класс содержит базовые настройки для операции поиска;
JapaneseSearchOptions — класс, содержащий настройки, характерные для операции поиска на японском языке;
Engl ishSearchOpt ions — данный класс хранит настройки, характерные для операции поиска на английском языке;
JEDictionary — основной класс приложения.
Рассмотрим всех перечисленных участников по отдельности, принимая во внимание, что данный пример не является полнофункциональным, и в тех местах, где должен осуществляться реальный поиск по базе данных, в нем используется код-заполнитель.
Начнем с рассмотрения определений пространств имен j apanese и english, чей код уже должен быть вам знаком:
package {
public namespace english = "http://www.example.com/jed1ct/engl1sh";
}
package {
public namespace Japanese = "http://www.example.com/jed1ct/japanese";
}
Далее идет класс QueryManager, который определяет два метода для поиска слова, — Japanese :: search ( ) и english:: search ( ). Вызов подходящего метода происходит в зависимости от текущего режима программы. Каждый метод search ( ) принимает аргумент'орМопз, который определяет настройки поиска в виде либо объекта класса JapaneseSearchOptions, либо объекта класса EnglishSearchOpt ions соответственно. Далее при рассмотрении класса JEDictionary мы увидим, что настройки поиска выбираются в соответствии с текущим режимом программы. Вот код класса QueryManager:
package {'
public class QueryManager {
Japanese function search (word:Str1ng,
options.-JapaneseSearchOptions):Array {
trace ("Now searching for '" + word + '"An"
+ " Match type: " + options.getMatchType( ) + "\n"
+ " English language variant: " + options.getEngl1shVarlant( ));
// Расположенный здесь код (не показан) должен выполнять поиск // в японско-английском словаре и возвращать результаты.*
// но для эксперимента мы будем просто возвращать предопределенный // список результатов:
return ["English Word 1", "English Word 2", "etc"];
}
english function search (word.-String,
options:EnglIshSearchOptIons) :Array { traceCNow searching for '" + word + '"An"
+ " Match type: " + options.getMatchType( ) + "\n"
+ " Use kanjl 1n results: " + options.getKanj1InResults( ));
// Расположенный здесь код (не показан) должен выполнять поиск // в англо-японском словаре и возвращать результаты,
// но для эксперимента мы будем просто возвращать предопределенный
// список результатов:
return ["Japanese Word 1", "Japanese Word 2", "etc"];
}
}
}
Теперь рассмотрим три класса, предоставляющие настройки поиска: Searchoptions и два его подкласса JapaneseSearchOptions и EnglishSearchOptions. Класс Searchoptions задает, с использованием какого режима программа должна выполнять поиск указанной строки: «точного совпадения» (искомое слово должно полностью совпадать со строкой поиска), «совпадает начало» (все искомые слова должны начинаться со строки поиска) или «содержит совпадение» (все искомые слова должны включать строку поиска).
Различные типы совпадений представлены такими константами, какМАТСН_ЕХАСТ, MATCH_STARTSWITH и MATCH_CONTAINS. Тип совпадений для текущего поиска может быть установлен и получен с помощью методов setMatchType ( ) и getMatchType ( ). Рассмотрим класс Searchoptions:
package {
public class SearchOptlons {
public static const MATCH_EXACT:String = "Exact";
public static const MATCH_STARTSWITH:String = "StartsWIth";
public static const MATCH_CONTAINS:String = "Contains";
private var matchType;String;
public function SearchOptlons ( ) {
// По умолчанию используется режим «точного совпадения».
setMatchType(SearchOpt1ons.MATCH_EXACT);
public function getMatchType ( ):String { return matchType;
}
public function setMatchType (newMatchType:String):void { matchType = newMatchType;
}
}
Класс JapaneseSearchOptions расширяет класс Searchoptions, добавляя настройки, характерные только для японско-английского режима поиска, — определение того, какой вариант английского языка должен использоваться для возвращаемых результатов: U.S. English (американский) или U.K. English (британский). Эти два варианта английского языка представляются константами ENGLISH_UK и ENGLISH_US. Вариант английского языка для текущего поиска может быть установлен и получен с помощью методов setEnglishVariant ( ) и getEnglishVariant ( ).
package {
public class JapaneseSearchOptlons extends Searchoptions {
public static const ENGLISH_UK;Str1ng = "EngHshUK";
public static const ENGLISH_US:String = "Engl1shUS";
private var engl1shVarlant:String;
public function JapaneseSearchOptlons ( ) {
setEngl1shVar1ant(JapaneseSearchOpt1ons.ENGLISH_UK);
}
public function getEngllshVarlant ( ):Str1ng {
return engl1shVarlant;
}
public function setEngllshVarlant (newEngl1shVarlant:Str1ng):void { engllshVarlant = newEngl1shVarlant;
}
} }
Каки JapaneseSearchOptlons, класс EnglishSearchOptions расширяет класс Searchoptions, добавляя настройки, характерные только для англо-японского режима поиска, — определение того, набор каких символов должен использоваться для возвращаемых результатов: кандзи (набор идеографических символов) или хирагана (набор фонетических символов). Набор символов для текущего поиска может быть установлен или получен с помощью методов setKanj ilnResults ( ) иgetKanjilnResults( ): package { *
public class EngllshSearchOptlons extends Searchoptions {
private var kanj1InResults:Boolean = false;
public function getKanjlInResults ( ):Boolean {
return kanjlInResults;
}
public function setKanjlInResults (newKanjlInResults:Boolean):vo1d { kanjlInResults = newKanjlInResults;
}
}
}
Наконец, рассмотрим основной класс приложения JEDict ionary, в котором происходит основная «магия», связанная с использованием пространств имен. Бегло просмотрите код класса, представленный в листинге 17.7, после чего мы рассмотрим его более подробно.
Листинг 17.7. Класс JEDictionary
package {
Import flash.display.Sprite;
public class JEDictionary extends Sprite {
private var queryMan:QueryManager;
Japanese var options:JapaneseSearch0pt1ons;
engllsh var options:Engl1shSearch0pt1ons;
private var lang:Namespace:
public function JED1ct1onary( ) {
queryMan = new QueryManager( ):
Japanese::opt1ons = new JapaneseSearch0pt1ons( );
Japanese::opt1ons.setMatchType(Search0pt1ons.MATCH_STARTSWITH):
Japanese::opt1ons.setEngllshVarlant(JapaneseSearchOptlons.ENGLISH_US):
engllsh::options = new Engl1shSearch0pt1ons( );
engl 1sh::opt1ons.setMatchType(Search0pt1ons.MATCH_CONTAINS):
engl1sh::options.setKanJ1InResults(true):
// Найти перевод японского слова...
setModeJapaneseToEngl1sh( );’
f1ndWord("sakana"):
// Найти перевод английского слова...
setModeEngl1shToJapanese( ):
f1ndWord("f1sh");
public function flndWord (word:Str1ng):void {
var words:Array = queryMan.lang::search(word, lang::options);
traceC Words found: " + words):
public function setModeEngllshToJapanese ( ):vo1d { lang = engllsh:
public function setModeJapaneseToEngllsh ( ):vo1d { lang = Japanese:
}
Итак, основной класс приложения JEDictionary расширяет класс Sprite:
public class JEDictionary extends Sprite {
Для поиска класс JEDictionary создает экземпляр класса QueryManager, который присваивается переменной queryMan:
private var queryMan:QueryManager;*
Затем класс JEDictionary создает две переменные, каждая из которых имеет локальное имя options, уточняемое пространствами имен j apanese и english. Эти переменные хранят настройки поиска, которые будут передаваться в метод экземпляра search ( ) класса QueryManager. Обратите внимание, что их типы данных соответствуют типу выполняемого поиска:
Japanese var options:JapaneseSearchOptions;
engllsh var options:Engl1shSearchOpt1ons;
После этого идет определение важной переменной lang, которая ссылается на пространство имен, соответствующее текущему режиму словаря (японскому или английскому):
private var lang .-Namespace:
Это все, что касается переменных класса JEDictionary; теперь рассмотрим его методы: setModeEnglishTo Japanese ( ), setModeJapaneseToEnglish ( ) и findWord ( ). Они активизируют различные режимы словаря, присваивая переменной lang пространство имен engllsh или j арапеse соответственно:
public function setModeEngl1shToJapanese ( ):vo1d {
lang = engllsh:
}
public function setModeJapaneseToEngllsh ( ):vo1d {
lang = Japanese:
}
Метод findWord ( ) применяет объект класса QueryManager для выполнения поиска в словаре, используя подходящий метод search ( ). Вызов метода search ( ) является самой важной строкой кода в нашем примере со словарем:
queryMan.lang::search(word, lang::options)
Обратите внимание, что пространство имен (режим программы) определяет не только тип выполняемого поиска (поведение), но и тип вариантов, используемых для этого поиска (данные). Когда переменной lang присвоено пространство имен j арапеse, вызывается метод j арапе se: : search ( ), в который передается объект JapaneseSearchOptions. Когда переменной lang присвоено пространство имен english, вызывается метод english: : search ( ), в который передается объектEnglishSearchOptions.
Результат вызова метода search ( ) присваивается локальной переменной words, после чего полученные результаты отображаются в виде отладочного сообщения:
public function findWord (word:Str1ng):void {
var words:Array = queryMan.lang::search(word, lang::options);
traceC Words found: " + words);
}
Для демонстрационных целей метод-конструктор класса JEDictionary выполняет поиск по словарю двух предопределенных слов (хотя в полнофункциональном приложении поиск по словарю обычно осуществляется в ответ на введенную пользователем строку). Процедура поиска выполняется экземпляром приложения QueryManager, который создается в конструкторе, как показано ниже:
queryMan = new QueryManagert );
Стандартные настройки для всех японско-английских и англо-японских поисков также задаются в конструкторе:
Japanese::opt1ons = new JapaneseSearchOpt1ons( );
Japanese::opt1ons.setMatchType(SearchOpt1ons.MATCH_STARTSWITH);
Japanese::opt1ons.setEngl1shVar1ant(JapaneseSearchOpt1ons.ENGLISH_US):
english::opt1ons = new Engl1shSearchOpt1ons( ):
engl 1 sh::opt1ons.setMatchType(SearchOptions.MATCH_CONTAINS):
engl1sh::opt1ons.setKanJiInResults(true);
Для осуществления поиска конструктор устанавливает режим словаря, после чего передает строку поиска в метод экземпляра findWord ( ) класса JEDictionary:
// Найти перевод японского слова...
setModeJapaneseToEngl1sh( );
f1ndWord("sakana");
И Найти перевод английского слова...
setModeEngl1shToJapanese( );
findWordCfish");
}
В зависимости от режима словаря вызывается подходящий метод search ( ) и используются соответствующие варианты поиска.
Мы рассмотрели наш словарь! Кроме того, подошло к концу наше изучение пространств имен. Помните, что вы можете загрузить исходный код для приложения словаря и других примеров из этой главы по адресу http://www.moock.org/eas3/ examples.
Последние основные темы
Мы почти завершили рассмотрение базовых возможностей языка ActionScript. В двух последующих главах описываются две последние темы: создание и управление XML-данными и ограничения безопасности приложения Flash Player.
Язык XML и расширение Е4Х
С момента появления приложения Flash Player 5 язык ActionScript включает инструменты для работы со структурированными данными XML. В ActionScript 1.0 и ActionScript 2.0 создание и управление данными XML осуществлялось с помощью переменных и методов внутреннего класса XML (например, fir s tChi Id, next S ibl ing, appendchild( ) ит. д.). Класс XML был основан на стандарте Document Object Model (Объектная модель документа) консорциума W3C, или DOM, — стандарте для программного взаимодействия с документами XML (дополнительную информацию об этом стандарте можно найти по адресу http://www.w3.org/DOM).
В языке ActionScript 3.0 набор инструментов для создания и управления данными XML был полностью переработан. ActionScript 3.0 реализует стандарт ECMAScript for XML (Е4Х) — официальное расширение языка ЕСМ А-262 для работы с данными XML в качестве встроенного типа данных. Стандарт Е4Х призван улучшить использование и гибкость работы с данными XML в языках, основанных на спецификации ЕСМ А-262 (включая языки ActionScript и JavaScript).
Данные XML в виде иерархии
Перед тем как познакомиться с возможностями управления данными XML с помощью расширения Е4Х, мы должны понять общий принцип представления данных XML в виде иерархии. И прежний класс XML, и расширение Е4Х представляют данные XML в виде иерархического дерева, в котором каждый элемент и текстовый блок считается узлом дерева (то есть ветвью или листом). Например, рассмотрим фрагмент XML, приведенный в листинге 18.1 {фрагмент XML — это часть данных XML, взятых из документа XML).
Листинг 18.1. Пример XML-фрагмента
<ВООК ISBN="0141182806">
<TITLE>Ulysses</TITLE>
<AUTHOR>Joyce, James</AUTHOR>
<PUBLISHER>Penguin Books Ltd</PUBLISHER>
</BOOK>
Элементы <BOOK>, <TITLE>, <AUTHOR> и<PUBLISHER>, атакже текст "Ulysses", "Joyce, James" и "Penguin Books Ltd" считаются узлами дерева, как показано на рис. 18.1.
Элемент <ВООК> является корнем дерева, который еще называется корневым узлом структуры данных XML. Любой корректный XML-документ должен иметь всеобъемлющий корневой элемент наподобие элемента <ВООК>, который включает все остальные элементы.
Рис. 18.1. Пример иерархии XML
Когда узел содержится в другом узле, он называется ребенком содержащего его узла. С другой стороны, узел, содержащий узел-ребенка, называется его родителем. В нашем примере элемент <TITLE> является ребенком элемента <ВООК>, а элемент <ВООК> — родителем элемента <TITLE>.
Как ни удивительно, но элемент <TITLE> — это не первый по счету ребенок элемента <ВООК>, а второй. Первым ребенком фактически являются так называемые незначащие пробелы (новая строка и два пробела) в исходном коде фрагмента XML между тегами <ВООК> и <TITLE>. В расширении Е4Х незначащим пробелом может являться любой из следующих четырех символов форматирования: пробел (\u0020), возврат каретки ( \ и0 0 0 D), перевод строки ( \ и 000А) и символ табуляции (\u0009). В дереве документа XML текстовые блоки — даже если они содержат только пробельные символы — считаются узлами дерева. Таким образом, элемент <ВООК> имеет не три ребенка, а семь, четыре из которых являются так называемыми пробельными узлами (текстовые узлы, которые содержат только незначащие пробелы).
Семь детей узла <ВООК> называются узлами-братьями, поскольку они находятся на одном уровне в иерархии. Например, мы говорим, что следующим братом элемента <TITLE> является пробельный узел, а предшествующим братом элемента <AUTHOR> является другой пробельный узел. Вы видите, как текстовые узлы мешают при перемещении по иерархии от одного брата к другому. К счастью, по умолчанию, пробельные узлы игнорируются парсером расширения Е4Х. Расширение Е4Х позволяет считать элемент <AUTHOR> следующим братом элемента <TITLE>, что в большинстве случаев нам и нужно. В расширении Е4Х не придется обрабатывать пробельные узлы самостоятельно до тех пор, пока это действительно не потребуется (за данное поведение отвечает переменная экземпляра ignoreWhitespace класса XML, которая рассматривается далее,
в подразд. «Преобразование элемента XML в строку» разд. «Преобразование объектов XML и XMLList в строки»).
На последнем уровне иерархии мы видим, что у каждого из узлов <Т I TLE>, <AUTHOR> и <PUBLISHER> есть один текстовый узел-ребенок: "Ulysses", "Joyce, James" и "Penguin Books Ltd" соответственно. Текстовые узлы являются конечными узлами в дереве.
• В исходном коде XML текст, содержащийся в элементе, считается узлом-ребенком данного ^ j ■ элемента в соответствующей древовидной иерархии документа XML.
Мы рассмотрели дерево данных XML из листинга 18.1, но по-прежнему ничего не знаем о месте атрибутов в этой иерархии. Можно предположить, что атрибут ISBN элемента <ВООК> превращается в узел-ребенка с именем ISBN. Однако на практике атрибут считается не ребенком элемента, определяющего этот атрибут, а его характеристикой. Мы рассмотрим способы обращения к атрибутам в расширении Е4Х далее, в подразд. «Обращение к атрибутам» разд. «Обращение к данным XML».
Теперь, когда известно, как данные XML могут быть представлены в виде концептуальной иерархии, можем рассмотреть способы представления, создания и обработки данных XML в расширении Е4Х.
Представление данных XML в расширении Е4Х
В расширении Е4Х данные XML представляются одним из двух встроенных типов данных языка ActionScript — XML и XMLList, а также их соответствующих классов с такими же именами — XML и XMLList.
...
Поскольку в расширении Е4Х появился тип данных XML, существующий класс XML из । языков ActionScript 1.0 и ActionScript 2.0 в языке ActionScript 3.0 был переименован в класс
XMLDocument и перемещен в пакет flash.тх.
родительского экземпляра класса XML. Каждый экземпляр класса XMLLis t представляет собой обычную коллекцию, состоящую из одного или более экземпляров класса XML. Например, экземпляр класса XMLList может представлять собой следующее:
набор атрибутов или элементов, возвращаемых в результате поиска;
группу фрагментов XML, каждый из которых имеет собственный корневой элемент;
коллекцию текстовых узлов документа;
коллекцию комментариев документа;
коллекцию инструкций обработки документа.
Узлы-дети элемента, представленного экземпляром класса XML, всегда заключаются в экземпляр класса XMLList. Даже если элемент имеет только одного ребенка (скажем, только текстовый узел), этот ребенок все равно будет заключен в экземпляр класса XMLList. Если элемент XML имеет атрибуты, комментарии или инструкции обработки, все они подобным образом заключаются в объект XMLList родительского экземпляра класса XML. Однако комментарии и инструкции обработки по умолчанию игнорируются парсером расширения Е4Х (чтобы исключить игнорирование этих элементов, присвойте статическим переменным XML.ignoreComments и XML.ignoreProcessinglnstructions значение false).
Рассмотрим пример, демонстрирующий, как фрагмент XML представляется экземплярами классов XML и XMLList в расширении Е4Х. Вспомним исходный код XML из листинга 18.1:
<ВООК ISBN="0141182806">
<TITLE>Ulysses</TITLE>
<AUTHOR>Joyce, James</AUTHOR>
<PUBLISHER>Penguin Books Ltd</PUBLISHER>
</BOOK>
С точки зрения расширения E4X элемент <ВООК> в данном коде представляется экземпляром класса XML. Он содержит два экземпляра класса XMLList — один для атрибутов элемента <ВООК>, а второй — для его элементов-детей. Элемент <ВООК> имеет только один атрибут, поэтому экземпляр класса XMLList для атрибутов элемента <ВООК> содержит только один экземпляр класса XML (представляющий атрибут ISBN). Экземпляр класса XMLList для элементов-детей элемента <ВООК> содержит три экземпляра класса XML, представляющих три элемента — <TITLE>, <AUTHOR> и <PUBLISHER>. Каждый из этих экземпляров XML отдельно включает в себя экземпляр класса XMLList, содержащий по одному экземпляру класса XML, представляющего соответственно текстовые узлы-дети "Ulysses”, " Joyce, James" и "Penguin Books Ltd". Эта структура изображена на рис. 18.2. На рисунке каждый элемент иерархии с корневым элементом <ВООК> обозначен буквой (от А до М), чтобы в дальнейшем было проще ссылаться на эти элементы.
Теперь применим рассмотренную теорию на практике, создав фрагмент с корневым элементом <ВООК> из листинга 18.1 с помощью методик расширения Е4Х.
м I XML*] (ISBN="0141182806")м I XML*] (ISBN="0141182806")|| Экземпляр класса XML
м I XML
*] (ISBN="0141182806")
м I XML
*] (ISBN="0141182806")
(элемент)
|| Экземпляр класса XML
(атрибут)
|| Экземпляр класса XML
(текстовый узел)
СFIСFIXML к(Ulysses) JXML к(Ulysses) Jшы-детишы-детиXML(<TITLE>)XML(<TITLE>)DGJDGJРис. 18.2. Фрагмент с корневым элементом <ВООК>, представленный в расширении Е4ХРис. 18.2. Фрагмент с корневым элементом <ВООК>, представленный в расширении Е4ХЭкземпляр класса XMLList
СFI
СFI
XML к
(Ulysses) J
XML к
(Ulysses) J
шы-дети
шы-дети
XML
(<TITLE>)
XML
(<TITLE>)
DGJ
DGJ
Рис. 18.2. Фрагмент с корневым элементом <ВООК>, представленный в расширении Е4Х
Рис. 18.2. Фрагмент с корневым элементом <ВООК>, представленный в расширении Е4Х
Создание данных XML
с помощью расширения Е4Х
У нас есть три основных варианта создания фрагмента XML с корневым элементом <ВООК>, представленного в листинге 18.1, с использованием расширения Е4Х.
Использовать конструктор класса XML, чтобы создать сначала новый экземпляр класса XML, а затем программным путем — оставшуюся часть фрагмента, применяя методики, описанные далее, в разд. «Изменение или создание нового содержимого XML».
Использовать конструктор класса XML, чтобы создать новый экземпляр класса XML, а затем импортировать фрагмент из загруженного внешнего файла, как рассматривается далее, в разд. «Загрузка XML-данных».
Ввести наши XML-данные в форме литерала, как обычную строку или число, в любом месте, где ActionScript допускает использование литералов.
Пока мы воспользуемся третьим подходом — создадим XML-фрагмент с помощью литерала XML. Это демонстрирует листинг 18.2. В нем переменной novel присваивается значение литерала XML (XML-фрагмент из листинга 18.1).
Листинг 18.2. Присваивание литерала XML переменной
var novel:XML = <ВООК ISBN="0141182806">
<TITLE>Ulysses</TITLE>
<AUTHOR>Joyce, James</AUTHOR>
<PUBLISHER>Pengu1n Books Ltd</PUBLISHER>
</BOOK>;
При выполнении предыдущего кода среда Flash создает новый экземпляр класса XML расширения Е4Х, представляющий литерал фрагмента XML, и присваивает его переменной novel.
Чтобы просмотреть исходный код XML экземпляра класса XML (наподобие экземпляра, на который ссылается переменная novel), используйте метод экземпляра toXMLString() класса XML, как показано в следующей строке:
trace(novel.toXMLStr1ng( ));
Метод toXMLString() рассматривается далее, в разд. «Преобразование объектов XML и XMLList в строки».
Обратите внимание, что использование переводов строк и кавычек в предыдущем литерале XML является абсолютно нормальным. Компилятор знает, что они являются частью данных XML, и интерпретирует их так, как это необходимо. Где это возможно, компилятор даже конвертирует определенные зарезервированные символы в сущности языка XML. Дополнительную информацию можно найти в подразд. «Использование сущностей XML для специальных символов» разд. «Изменение или создание нового содержимого XML».
Язык ActionScript также позволяет использовать динамические выражения в литерале XML, поэтому названия элементов, атрибутов, значения атрибутов и содержимое элементов можно генерировать программным путем. Чтобы указать динамическое выражение в литерале XML, включите его в фигурные скобки ({ }). Например, следующий код задает название тега <ВООК> динамически:
var elementName:String = "BOOK";
var novel:XML = <{elementName}/>:
Следующий код представляет слегка усложненный пример, в котором создается иерархия XML, приведенная в листинге 18.2, но при этом все названия элементов, названия атрибутов, значения атрибутов и содержимое элементов задаются динамически.
var rootElementName:String = "BOOK";
var rootAttrlbuteName:String = "ISBN";
var chlldElementNames:Array = ["TITLE", "AUTHOR", "PUBLISHER"];
var book ISBN .-String = "0141182806";
var bookT1tle:Str1ng = "Ulysses";
var bookAuthor:String = "Joyce, James";
var bookPubHsher:String = "Penguin Books Ltd";
var novel:XML = <{rootElementName} {rootAttr1buteName}={bookISBN}> <{ch1ldElementNames[0]}>{bookT1tle}</{ch1ldElementNames[0]}> <{ch1 IdElementNames[!]}>{bookAuthor}</{ch1ldElementNames[l]}> <{ch1IdElementNames[2]}>{bookPub!1sher}</{chlldElementNames[2]}>
</{rootElementName}>:
Стоит отметить, что, поскольку символы { } применяются для обозначения динамического выражения, их использование в некоторых частях литерала XML недопустимо. В частности, внутри названия элемента, названия атрибута или содержимого элемента для представления символов { и } должны использоваться сущности &#х7В; и } соответственно. Тем не менее в виде литерала символы
{ и } могут быть использованы внутри значения атрибута, раздела СВАТА, инструкции обработки или комментария.
Теперь, когда у нас появилась переменная novel, определенная в листинге 18.2, которая ссылается на фрагмент XML из листинга 18.1, рассмотрим, как можно обращаться к различным частям фрагмента с помощью методик кодирования расширения Е4Х.
Обращение к данным XML
Расширение Е4Х предлагает два основных набора инструментов для обращения к данным в иерархии XML:
методы обращения к содержимому классов XML и XMLList (attribute ( ), attributes ( ), child ( ), children ( ), comments ( ), descendants ( ), elements ( ), parent ( ), processinginstructions ( ) и text ( ) );
обращение в стиле доступа к переменным с помощью операторов «точка» (.), «потомок» (. .) и «атрибут» (@).
Обращение в стиле доступа к переменным предлагается в качестве удобства для программиста и всегда соответствует вызову одного или нескольких методов класса XML или XMLList. Однако эти два подхода не являются полностью взаимозаменяемыми. Для обращения к следующим типам содержимого должен использоваться подходящий метод класса XML или XMLList:
родитель экземпляра класса XML (обращение через метод parent ( ) );
комментарии (обращение через метод comments ( ) );
инструкции обработки (обращение через метод processinginstructions ( ) );
элементы или атрибуты, названия которых включают симролы, считающиеся недопустимыми в идентификаторе языка ActionScript (обращение через методы attribute ( ), child ( ), descendants ( ) или elements ( ) ).
Используя наш пример с корневым элементом <ВООК>, рассмотрим несколько наиболее распространенных способов обращения к данным XML.
Обращение к корневому узлу XML
В листинге 18.2 мы присвоили фрагмент XML из листинга 18.1 переменной novel. Для обращения к корневому элементу <ВООК> этого фрагмента (элемент А на рис. 18.2) мы просто используем переменную novel. Например, следующий код передает элемент <ВООК> (и, как следствие, всех его детей) в гипотетический метод addToOrder ( ):
addloOrder(novel);
Обратите внимание, что элемент <ВООК> не имеет названия. Иными словами, мы пишем addToOrder (novel), а не так:
addloOrder(novel.BOOK); // Неправильно.
addToOrder(novel.chiId("BOOK")); // Также неправильно.
В двух предыдущих примерах элемент <ВООК> ошибочно считается ребенком объекта, на который ссылается переменная novel, хотя это не так. Как обращаться к элементам-детям, мы рассмотрим в следующем разделе.
Стоит отметить, что не существует прямого способа обратиться к корневому узлу из любого заданного ребенка. Однако мы можем использовать метод экземпляра parent ( ) (рассматриваемый далее) класса XML, чтобы подняться вверх по иерархии элементов к корневому узлу, как показано в листинге 18.3.
Листинг 18.3. Пользовательский метод для обращения к корневому узлу
// Возвращает корневой узел иерархии XML из любого заданного ребенка public function getRoot (ch11dNode:XML):XML {
van parentNode:XML = ch1ldNode.parent( );
1f (parentNode != null) { return getRoot(parentNode);
} else {
return ch1ldNode:
// Применение:
getRoot(некийРебенок):
Обращение к узлам-детям
Для обращения к экземпляру класса XMLLi st, представляющего узлы-детей элемента <ВООК> (элемент В на рис. 18.2), мы используем метод экземпляра children ( ) класса XML, не принимающего никаких аргументов. Например:
novel.ch11dren( ) // Возвращает объект XMLLIst, представляющий узлы-детей // элемента <ВООК>
В качестве альтернативы мы можем обратиться к узлам-детям элемента <ВООК> с помощью более удобного группового символа свойств (*) расширения Е4Х. Например:
novel.* // Также возвращает объект XMLLIst, представляющий // узлы-детей элемента <ВООК>
Для обращения к определенному ребенку в объекте XMLList мы используем уже знакомый оператор доступа к элементу массива — [ ]. Например, чтобы обратиться ко второму ребенку элемента <ВООК> — элементу <AUTHOR> (элемент D на рис. 18.2), мы используем:
novel.ch11dren( )[1] // Обращаемся ко второму узлу-ребенку элемента <ВООК>
или:
novel.*[1] // Также обращаемся ко второму узлу-ребенку элемента <ВООК>
Хотя в расширении Е4Х нет переменной firstChild или lastchild (как в существующем классе XMLDocument), обратиться к первому ребенку в списке узлов- детей можно следующим образом:
узел.ch1ldren( )[0].
К последнему ребенку в списке узлов-детей можно обратиться следующим образом:
узел.ch11dren( )Еузел.ch11dren( ).length( )-l]
Однако обращение к узлу-ребенку по его позиции в списке может быть затруднительным, и поэтому значимость данного метода обращения в расширении Е4Х была снижена. В расширении Е4Х обращение к узлам-детям обычно происходит по их именам, а не по позиции. Для обращения к узлу-ребенку по имени применяется метод экземпляра child ( ) класса XML, который возвращает объект XMLList со всеми элементами-детьми, соответствующими указанному имени. Например, чтобы получить объект XMLList со всеми детьми элемента <ВООК> с именем ’’AUTHOR”, используется следующий код:
novel.ch1ld("AUTHOR") // Возвращает все элементы-детей элемента <ВООК> // с именем "AUTHOR"
В качестве альтернативы мы можем обратиться к узлам-детям по имени, используя более удобный синтаксис для доступа к переменным расширения Е4Х. Следующий код возвращает такой же результат, как и предыдущий, но при этом использует более удобный синтаксис обращения к переменной расширения Е4Х:
novel.AUTHOR // Также возвращает все элементы-детей элемента <ВООК> // с именем "AUTHOR"
Если элемент <ВООК> содержит два элемента <AUTHOR>, выражение nove 1. AUTHOR вернет объект XMLList с двумя экземплярами класса XML, представляющими данные элементы. Для обращения к первому элементу мы могли бы использовать выражение novel. AUTHOR [ 0 ]. Для обращения ко второму элементу — выражение novel. AUTHOR [ 1 ], как показано в следующем коде:
var novel:XML = <ВООК>
<AUTHOR>Jacobs, Tom</AUTHOR>
<AUTHOR>Schumacher, Jonathan</AUTHOR>
</BOOK>:
novel.AUTHORED]; // Обращение к <AUTHOR>Jacobs, Tom</AUTHOR>
novel.AUTHORE1]; // Обращение к <AUTHOR>Schumacher, Jonathan</AUTHOR>
Безусловно, элемент <BOOK> из листинга 18.1 содержит только одного ребенка с именем ’’AUTHOR”, поэтому объект XMLList, возвращаемый выражением novel. AUTHOR, имеет только один экземпляр класса XML (представляющий единственный элемент <AUTHOR>). Для обращения к данному элементу <AUTHOR> мы могли бы использовать следующий код:
novel.AUTHORED] // Обращение к экземпляру элемента <AUTHOR>
Однако (и это замечательно!) в большинстве случаев включать [0] не требуется. Чтобы сделать обращение к узлу более удобным, расширение Е4Х реализует специальное поведение для объектов XMLList, имеющих только один экземпляр класса XML (как в случае с выражением novel. AUTHOR в нашем примере). Когда метод класса XML вызывается над объектом XMLList, имеющим только один экземпляр класса XML, этот вызов метода автоматически переадресуется данному экземпляру. Выполняя переадресацию вызова метода, расширение Е4Х позволяет
программисту рассматривать объект XMLLi s t с одним экземпляром класса XML так, будто данный объект XMLList и является экземпляром класса XML. Как указано в спецификации, расширение Е4Х «намеренно стирает различие между отдельным объектом класса XML и объектом класса XMLList, содержащим только его».
Предположим, что мы хотим изменить название элемента <AUTHOR> с "AUTHOR" на "WRITER". Мы могли бы использовать следующий код, который явно обращается к экземпляру элемента <AUTHOR>:
novel.AUTHORED].setName("WRITER");
Однако обычно используется следующий более удобный код, который неявно обращается к экземпляру элемента <AUTHOR>, опуская оператор обращения к элементу массива ( [ 0 ], следующий за выражением novel. AUTHOR):
novel.AUTHOR.setName("WRITER");
Когда мы вызываем метод setName ( ) непосредственно над объектом XMLList, возвращаемым выражением novel .AUTHOR, среда выполнения Flash распознает, что данный список содержит только один экземпляр класса XML (<AUTHOR>) и автоматически переадресует вызов метода setName ( ) данному экземпляру. В результате название единственного элемента, содержащегося в объекте novel .AUTHOR, изменяется с "AUTHOR” на "WRITER”.
В большинстве случаев данный трюк языка ActionScript упрощает написание XML- кода и делает его интуитивно понятным. Однако использовать эту методику следует осторожно. Например, следующий код вызывает метод setName ( ) над объектом XMLList, который содержит несколько экземпляров класса XML:
van novel:XML = <ВООК>
<AUTHOR>Jacobs, Tom</AUTHOR>
<AUTHOR>Schumacher, Jonathan</AUTHOR> .
</BOOK>;
novel.AUTHOR.setName('WRITER');
При выполнении предыдущего кода среда Flash сгенерирует следующую ошибку:
The setName method works only on lists containing one Item.
На русском языке она будет выглядеть так: Метод setName работает только для списков, содержащих один элемент.
Представление объекта XMLList, содержащего только один экземпляр классаXML, является важным и зачастую неверно трактуемым аспектом программирования с использованием расширения Е4Х, поэтому мы будем возвращаться к этой теме несколько раз в процессе чтения данной главы.
Обращение к текстовым узлам
Как уже известно из разд. «Данные XML в виде иерархии», текст, содержащийся в элементе, представляется в виде узла в иерархии XML. Например, в следующем XML-фрагменте (повторяемом из листинга 18.2)текст "Ulysses” является текстовым узлом. Он представляется экземпляром класса XML, типом узла которого является текст, как и текстовые узлы "Joyce, James" и "Penguin Books Ltd".
var novel:XML = <ВООК ISBN="0141182806">
<TITLE>Ulysses</TITLE>
<AUTHOR>Joyce. James</AUTHOR>
<PUBLISHER>Penguin Books Ltd</PUBLISHER>
</BOOK>:
К текстовым узлам можно обращаться различными способами в зависимости от наших потребностей. Когда необходимо обратиться к текстовому узлу как к экземпляру класса XML, нужно использовать синтаксис обращения к узлу-ребенку, рассмотренный в предыдущем разделе. Например, чтобы обратиться к тексту ’’Ulysses”, который является первым ребенком элемента <TITLE>, мы можем использовать следующий код:
novel.TITLE.children( )[0] // Обращаемся к текстовому узлу Ulysses
Или, в качестве альтернативы, мы можем использовать групповой символ свойств:
novel.TITLE.*[0] // Тоже обращаемся к текстовому узлу Ulysses
Оба предыдущих примера возвращают объект XML (а не строку), который представляет текст элемента ” U1 у s s е s ”. Мы можем вызывать методы класса XML над этим объектом точно так же, как и над любым другим объектом XML. Например:
novel.TITLE.*Е0].parent( )// Обращение к элементу <TITLE>
novel.TITLE.*[0].nodeKindt ) // Возвращает строку "text"
novel.TITLE.*[0].toString( ) // Возвращает строку "Ulysses"
Однако если мы хотим просто обратиться к содержимому текстового узла, как к значению типа String, а не к экземпляру класса XML, то можем использовать метод экземпляра toString ( ) класса XML над его родительским элементом. Для таких элементов, как, например, <Т I TLE>, которые содержат только один текстовый узел- ребенок (без других промежуточных элементов), метод toString ( ) возвращает текст этого узла-ребенка, опуская начальные и конечные теги родительского элемента. Таким образом, выражение novel. TITLE . toString ( ) вернет строку ’’Ulysses”:
tracetnovel.TITLE.toStringt )): // Выводит: Ulysses
Обдумывая предыдущую строку кода, не забудьте, что на самом деле это сокращенный вариант следующего кода:
tracetnovel.TITLE[0].toStringt )): // Выводит: Ulysses
Сокращенный вариант выражения novel. TITLE. toString ( ) возвращает значение ”Ulysses”, поскольку среда выполнения Flash знает, что объект XMLList, на который ссылается выражение novel. TITLE, имеет всего один экземпляр класса XML (<TITLE>), и автоматически переадресует вызов метода toString ( ) данному экземпляру.
При обращении к содержимому текстового узла как к значению типа String мы можем опускать явный вызов метода toString ( ), поскольку среда выполнения Flash вызывает метод toString ( ) автоматически, когда вместо строки используется нестроковое значение. Например, функция trace ( ) в качестве аргумента принимает строку, поэтому вместо явного вызова метода toString ( ):
tracetnovel.TITLE.toStringt )): // Выводит: Ulysses
мы можем позволить среде выполнения Flash вызвать этот метод неявно:
trace(novel.TITLE); // Также выводит: Ulysses
Подобным образом при присваивании содержимого текстового узла Ulysses переменной типа String вместо использования такого полностью явного кода:
var t1tleName:Str1ng = novel.TITLE[0].toStr1ng( ):
мы можем использовать просто:
var titleName:String = novel.TITLE:
Замечательная возможность. И зачастую именно этот способ применяется для получения текста, содержащегося в элементе, в расширении Е4Х.
Для текстовых узлов, которые разбросаны между другими элементами, можно использовать метод экземпляра text ( ) класса XML, чтобы получить текстовые узлы, не содержащиеся в элементах. Чтобы проиллюстрировать данную возможность, временно добавим элемент <DESCRIPTION> к элементу <ВООК>, как показано в следующем примере:
var novel:XML = <ВООК ISBN="0141182806">
<TITLE>Ulysses</TITLE>
<AUTHOR>Joyce, James</AUTHOR>
<PUBLISHER>Penguin Books Ltd</PUBLISHER>
<DESCRIPTION>A <B>very</B> thick book.</DESCRIPTION>
</BOOK>:
Элемент <DESCRIPTION> содержит как элементы-детей, так и текстовые узлы- детей:
А (текстовый узел);
<B>very</B> (элемент с текстовым узлом-ребенком);
thick book, (текстовыйузел).
Чтобы получить объект XMLList, содержащий два текстовых узла А и thick book., мы используем следующее выражение:
novel.DESCRIPTION.text( )
Для обращения к этим текстовым узлам используется оператор доступа к элементу массива:
traceCnovel.DESCRIPTION.text( )[0]); // Выводит: А
traceCnovel.DESCRIPTION.text( )[1]): // Выводит: thick book.
Метод text ( ) также можно применять для получения текстовых узлов из всего объекта XMLList, а не только из одного элемента XML. Предположим, что у нас есть объект XMLList, представляющий всех детей элемента <ВООК> из листинга 18.2 (до момента добавления элемента <DESCRIPTION>):
novel.*
Чтобы поместить текстовые узлы каждого ребенка из этого списка в объект XMLList для последующей обработки, например, для создания пользовательского интерфейса, применяется следующий код:
novel.*.text( )
И снова для обращения к текстовым узлам мы используем оператор доступа к эле
менту массива:
trace(novel .*.text( )[0]): // Выводит: Ulysses
trace(novel.*.text( )[1]); // Выводит: Joyce, James
trace(novel.*.text( )[2]): // Выводит: Penguin Books Ltd
Однако метод экземпляра text ( ) класса XMLList оказывается менее полезным при использовании над списком элементов, который содержит и текстовые узлы- детей, и элементы-детей. Если узел содержит и текстовые узлы-детей, и элементы- детей (например, узел <DESCRI PTION>), то возвращается только первый текстовый узел-ребенок; остальные дети игнорируются. Например:
van novel:XML = <ВООК ISBN="014118280б">
<TITLE>Ulysses</TITLE>
<AUTHOR>Joyce, James</AUTHOR>*
<PUBLISHER>Pengu1n Books Ltd</PUBLISHER>
<DESCRIPTION>A <B>very</B> thick book.</DESCRIPTION>
</BOOK>:
trace(novel.*.text( )[3]): // Выводит: A
// остальные узлы-дети - <B>very</B> // и thick book. - игнорируются
Обращение к узлам-родителям
Для обращения к узлу-родителю данного узла используется метод экземпляра parent ( ) класса XML, не принимающий аргументов. Предположим, что переменная pub содержит ссылку на элемент <PUBLI SHER> из листинга 18.2.
var pub:XML = novel.PUBLISHER[O];
Для обращения к родителю узла <PUBLISHER> (которым является <ВООК>) мы используем следующий код:
pub.parent( )
Метод parent ( ) может так же успешно применяться для обращения к любому узлу-предку, как показано в следующем коде:
// Создаем иерархию XML с тремя уровнями.
var doc:XML = <grandparent><parent><ch1ld></ch1ld></parent></grandparent>:
// Присваиваем ссылку на элемент <ch1ld> var k1d:XML = doc.parent.ch1ld[0];
// Используем метод parentt ) для последовательного обращения к элементу // <grandparent> из элемента <ch1ld>
var grandparent:XML = kid.parent( ).parent( ):
В отличие от методов children() и child(), метод экземпляра parent() класса XML не имеет альтернативного синтаксиса в стиле обращения к переменным.
Когда метод parent ( ) применяется к экземпляру класса XMLLis t, он возвращает значение null, если только родителем всех элементов списка не является один и тот же элемент, который и возвращается в этом случае. Например, в следующем коде мы получаем экземпляр класса XMLList, представляющий три ребенка элемента <ВООК>, а затем вызываем метод parent ( ) над этим списком. Поскольку родителем всех трех детей является один и тот же элемент, возвращается этот родитель, var bookDetai1s:XMLL1st = novel.*;
var book:XML = bookDetaiIs.parent( ); // Возвращает элемент <BOOK>
Вызов метода parent ( ) над объектом XMLLis t, содержащим всего один экземпляр класса XML, идентичен вызову метода parent ( ) над этим экземпляром. Например, следующие две строки кода являются тождественными:
novel.PUBLISHEREOJ.parent( ) // Обращается к <ВООК> novel.PUBLISHER.parent( )// Также обращается к <ВООК>
Когда метод parent ( ) вызывается над экземпляром класса XML, представляющим атрибут, возвращается элемент, для которого этот атрибут определен. Это демонстрирует следующий код, в котором используется еще не рассмотренный метод доступа к атрибутам (этот метод будет описан в ближайшее время): novel.@ISBN.parent( ) // Возвращает элемент <ВООК>
Обращение к узлам-братьям
Как уже известно из разд. «Данные XML в виде иерархии», узел-брат — это узел, который находится непосредственно возле другого узла на данном уровне иерархии XML. Например, в знакомой нам иерархии <ВООК> элемент <TITLE> является предшествующим братом элементов <AUTHOR> и <PUBLI SHER> и следующим братом элемента <AUTHOR>.
var novel:XML = <BOOK ISBN="014118280б">
<TITLE>Ulysses</TITLE><!--Предшествующий брат -->
<AUTHOR>Joyce, James</AUTHOR>
<PUBLISHER>Pengu1n Books Ltd</PUBLISHER> <!--Следующий брат -->
</BOOK>:
В расширении Е4Х отсутствует встроенная поддержка перемещений между узлами-братьями в иерархии XML. Переменные nextsibling и previousSibling, поддерживаемые в модели DOM, не являются частью интерфейса API расширения Е4Х. Однако следующий брат любого узла может быть получен с помощью следующего кода, предполагая, что у данного узла есть узел-родитель: некийУзел.раrente ) *^некийУзел.childIndex( )+!];
Предшествующий брат может быть найден с помощью следующего кода: некийУзел.раrente ).*Е^екииУзел.ch11dlndex( )-!];
Например, данный код обращается к предшествующему и следующему братьям элемента <AUTHOR>:
var author:XML = novel.AUTHORED];
// Предшествующий брат
trace(author.parent( ) .*[author.ch1ldlndex( )-!]); // Выводит: Ulysses // Следующий брат
trace(author.parent( ).*[author.ch1ldlndex( )+1]): // Выводит:
•// Penguin Books Ltd
В листинге 18.4 представлен код пользовательского метода для обращения к предшествующему брату данного узла. Обратите внимание, что метод добавляет код для проверки того, что указанный узел действительно имеет предшествующего брата, перед тем как вернуть его.
Листинг 18.4. Пользовательский метод previousSibling()
public function prevlousSIbling (theNode:XML):XML {
// Проверяем, что узел действительно имеет предшествующего брата,
// перед тем как вернуть его
1f (theNode.parent( ) != null && theNode.ch1ldlndex( ) > 0) {
return theNode.parent( ).*[theNode.ch1ldIndex( )-!];.
} else { return null;'
}
И Использование:
prevlousS1bl 1 ng(некийУзел):
В листинге 18.5 определен метод nextsibling ( ) — метод-компаньон пользовательского метода previous Sibling ( ), определенного в листинге 18.4. Обратите внимание, что метод добавляет код для проверки, что указанный узел действительно имеет следующего брата, перед тем как вернуть его.
Листинг 18.5. Пользовательский метод nextSibling()
public function nextSIbling (theNode:XML):XML {
1f (theNode.parent( ) != null
&& theNode.ch1ldlndex( ) < theNode.parent( ).ch1ldren( ).length( )-l) { return theNode.parent( ).*[theNode.ch1ldIndex( )+l];
} else {■‘
return null:
// Использование:
nextSIbl 1 ng(некийУзел):
Расширение E4X уменьшает необходимость доступа к узлам-братьям, поскольку основное внимание уделяется обращению к элементам по их имени. Например, для обращения к элементу <TITLE> с помощью расширения Е4Х мы обычно используем простую запись novel.TITLE, а не author.parent( ).*[author.childlndex( )-1].
Обращение к атрибутам
Для обращения к объекту XMLList, представляющему все атрибуты элемента, используется метод экземпляра attributes ( ) класса XML, не принимающий аргументов. Он имеет следующий общий вид: некийЭлемент.attributes( )
Например, следующий код возвращает объект XMLLi st, представляющий атрибуты элемента <ВООК> (элемент L на рис. 18.2):
novel.attributes( ).
В качестве альтернативы для обращения к объекту XMLList, представляющему атрибуты элемента, можно использовать более удобный синтаксис специального символа атрибутов (@ *) расширения Е4Х, который записывается следующим образом:
некийЭлемент,@* // Возвращает объект XMLList, представляющий все атрибуты // элемента некийЭлемент
Например, приведенный ниже код, который является эквивалентом выражения novel .attributes ( ), возвращает объект XMLLi st, представляющий атрибуты элемента <ВООК> (элемент L на рис. 18.2):
novel.@*
Как и в случае с элементами, для обращения к атрибутам в объекте XMLList можно использовать оператор доступа к элементу массива ( [ ] ). Например, следующий код обращается к первому и единственному атрибуту элемента <ВООК> — ISBN (элемент М на рис. 18.2): novel.attributes( )[0]
Следующий код также обращается к первому атрибуту элемента <ВООК> (снова ISBN), но использует синтаксис специального символа атрибутов расширения Е4Х:
novel.@*[0]
Однако ни выражение novel. @* [0 ] ,ни выражение novel .attributes ( ) [0] не представляют обычный код расширения Е4Х. В расширении Е4Х обращение к атрибутам редко происходит по их порядковому номеру в документе XML. Обычно к атрибутам обращаются по имени, используя либо метод attribute ( ), либо более удобный синтаксис обращения к переменным расширения Е4Х. Для обращения к атрибуту по его имени с помощью метода attribute ( ) используется следующий обобщенный код:
некийЭлемент .аШАЬ\)ШиимяАтрибутаи)
Данный код возвращает объект XMLList, содержащий атрибут с именем им я Атрибута элемента некийЭлемент. Например, следующий код возвращает объект XMLList, который содержит один экземпляр класса XML, представляющий атрибут ISBN (элемент М на рис. 18.2) элемента <ВООК>:
novel.attrlbute("ISBN")
Данное выражение является эквивалентом обращения к атрибуту по имени с использованием синтаксиса обращения к переменной:
некийЭлемент.^имяАтрибута
Например, следующий код также вернет объект XMLList, содержащий один экземпляр класса XML, который представляет атрибут ISBN элемента <ВООК>, но в данном случае используется синтаксис обращения к переменной:
novel.@ISBN
КакисЫ1с1( ), метод attribute ( ) возвращает объект XMLLi st, содержащий экземпляры класса XML, которые соответствуют указанному имени. Однако, поскольку два или более атрибута одного элемента не должны иметь одинаковые имена, объект XMLList, возвращаемый методом attribute ( ), всегда содержит только один экземпляр класса XML (представляющий атрибут с указанным именем).
Для обращения к экземпляру класса XML, который содержится в объекте XMLLi st, возвращаемом выражением novel. @ ISBN, мы могли бы использовать следующий код:
novel.@ISBN[0]
Но при вызове метода класса XML над данным экземпляром мы обычно опускаем оператор обращения к элементу массива ([ 0 ]), как показано в следующем коде:
novel .^5^.некийМетодКлассаХМ1( )
Можно опустить запись [ 0 ], поскольку, как мы уже знаем, когда метод класса XML вызывается над объектом XMLList, содержащим только один экземпляр этого класса, вызов метода автоматически переадресуется данному экземпляру. Например, следующий явный код:
novel.@ISBN[O].parent( ) // Возвращает узел <ВООК>
является эквивалентом такого неявного кода:
novel.@ISBN.parent( ) // Также возвращает узел <ВООК>
С другой стороны, экземпляры класса XML, представляющие атрибуты, никогда не имеют детей и, следовательно, большая часть методов класса XML остается невостребованной. Вместо этого экземпляр класса XML, представляющий атрибут, используется всего лишь для хранения значения данного атрибута. Для обращения к значению атрибута используется метод экземпляра toString ( ) класса XML. Например, следующий код присваивает значение атрибута ISBN элемента <ВООК> переменной booklSBN, используя полностью явное выражение:
var booklSBN:String = novel.@ISBNEO].toStrlng( );
Однако не забывайте, что мы можем вызвать метод toS t г ing ( ) непосредственно над результатом выражения novel. @ ISBN (вместо выражения novel. @ ISBN [ 0 ] ), поскольку возвращаемый объект XMLList содержит только один экземпляр класса XML. Вот более короткая и более типичная запись:
var booklSBN-.String = novel .@ISBN.toStr1ng( ); H Опущена запись [0]
Приведенную строку кода можно сделать еще короче. Класс XML является динамическим. Таким образом, мы можем использовать возможность автоматического преобразования типов данных языка ActionScript, чтобы преобразовать значение любой переменной экземпляра класса XML к строке (правила преобразования типов данных языка ActionScript описаны в гл. 8):
var booklSBN:String = novel.@ISBN;
В данном коде переменная novel представляет экземпляр динамического класса (XML). Следовательно, когда мы присваиваем типизированной переменной booklSBN значение переменной ISBN этого экземпляра, компилятор откладывает проверку типов до этапа выполнения программы. На этапе выполнения, поскольку
тип данных переменной booklSBN является примитивным (String), значение переменной ISBN автоматически преобразуется к этому типу.
Достаточно удобно. Эту возможность можно использовать и для преобразования к другим примитивным типам данных. Например, следующий код преобразует значение атрибута ISBN к числу путем простого присваивания этого значения переменной с типом данных Number:
var booklSBN:Number = novel.@ISBN;
При работе с атрибутами следует помнить, что значение атрибута всегда имеет тип String, даже когда кажется, что с логической точки зрения оно должно иметь другой тип. Для использования этого значения в качестве другого типа данных (не String) необходимо выполнить его явное или неявное преобразование. Чтобы избежать неприятных сюрпризов, следует постоянно помнить о правилах преобразования типов данных, которые были рассмотрены в гл. 8. В частности, запомните, что строковое значение "false" преобразуется в значение true типа Boolean! По этой причине при работе с атрибутами, которые хранят булеву информацию, проще использовать сравнение строк, чем преобразовывать значение атрибута к типу данных Boolean.
Например, следующий код добавляет новый атрибут INSTOCK, который обозначает доступность книги в настоящий момент, к элементу <ВООК>. Чтобы отобразить сообщение о доступности книги, сравним значение выражения novel. @INSTOCK со строкой "false” вместо того, чтобы преобразовывать значение выражения novel. @ INSTOCK в значение типа Boolean. Перед сравнением в качестве меры предосторожности мы также преобразуем все символы значения атрибута к нижнему регистру.
При сравнении атрибутов помните, что они всегда являются строками, а сравнение выполняется с учетом регистра символов.
var novel:XML = <ВООК ISBN="0141182806" INSTOCK="false">
<TITLE>Ulysses</TITLE>
<AUTHOR>Joyce, James</AUTHOR>
<PUBLISHER>Penguin Books Ltd</PUBLISHER>
</BOOK>;
// Сравниваем co строкой "false" вместо преобразования в тип Boolean
if (novel.@INSTOCK.toLowerCase( ) == "false") { traceC'Not Available!");
} else {
traceC'Available!");
Обращение к комментариям и инструкциям обработки
Двумя последними типами узлов, к которым можно обращаться с помощью расширения Е4Х, являются комментарии и инструкции обработки. Комментарии языка XML имеют следующий вид:
<!-- Здесь находится текст комментария -->
Инструкции обработки языка XML принимают такой вид:
<?некоеЦелевоеПриложение некиеДанные?>
Для обращения к этим двум вспомогательным типам данных можно использовать методы экземпляра comments ( ) Hprocessinglnstructions( ) класса XML. Оба метода возвращают объект XMLList, представляющий всех непосредственных детей элемента, которые являются либо комментариями, либо инструкциями обработки соответственно. Однако по умолчанию парсер расширения Е4Х игнорирует и комментарии, и инструкции обработки. Чтобы получить доступ к комментариям документа XML или фрагмента XML, перед обработкой данных переменной XML. ignoreComments необходимо присвоить значение false, как показано в следующем коде:
XML.IgnoreComments = false:
Подобным образом, для того чтобы получить доступ к инструкциям обработки документа XML или фрагмента XML, перед обработкой данных переменной XML.ignoreProcessinglnstructions необходимо присвоить значение false, как показано в следующем коде:
XML.IgnoreProcessinglnstructions = false:
Следует обратить внимание на то, что переменные XML. ignoreComments и XML. ignoreProcessinglnstructions являются статическими, значения им присваиваются через класс XML, а не через отдельные экземпляры класса XML. Значения, присвоенные переменным XML. ignoreComments и XML . ignoreP rocessinglnstructions, влияют на все последующие операции обработки XML-данных.
В листинге 18.6, например, с корневым узлом <ВООК> добавляются два комментария и две инструкции обработки, а также показано, как обращаться к добавленным элементам. Обратите внимание, что переменным XML. ignoreComments и XML. ignoreProcessinglnstructions присваивается значение false до того, как литерал XML будет присвоен переменной novel. Обратите также внимание, что, хотя комментарии и инструкции обработки разбросаны между детьми элемента<ВООК>,методы comments ( ) Hprocessinglnstructions ( ) игнорируют других детей и возвращают список, состоящий только из комментариев и инструкций обработки.
Листинг 18.6. Обращение к комментариям и инструкциям обработки
XML.IgnoreComments = false:’
XML.IgnoreProcessinglnstructions = false:
// Создаем XML-фрагмент, который содержит комментарии и инструкции обработки var novel:XML = <ВООК ISBN="0141182806">
<!--Heilo world-->
<?appl someData?>
<TITLE>Ulysses</TITLE>
<AUTHOR>Joyce, James</AUTHOR>
<?app2 someData?>
<PUBLISHER>Pengu1n Books Ltd</PUBLISHER>
<!--Goodbye world-->
</ВООК> •
trace(novel.comments( )[0]);// <!--Hei 1 о world-->
trace(novel.comments( )[!]);// <!--Goodbye world-->
trace(novel.process!nglnstructions( )[0J); // <?appl someData?> trace(novel.process!nglnstructions( )[!]); // <?app2 someData?>
Чтобы получить объект XMLList, представляющий все комментарии и инструкции обработки для всего дерева XML (а не только непосредственных детей узла), используйте оператор «потомок» в сочетании с групповым символом свойств, как показано в следующем коде:
var tempRoot:XML = <tempRoot/>;
tempRoot.appendCh!ld(novel):
trace(tempRootcomments( )[0J); // Первый комментарий в документе
Мы рассмотрим представленный метод более подробно далее, в разд. «Обход деревьев XML».
Обращение к атрибутам и элементам с зарезервированными символами в именах
Если имя атрибута или элемента содержит символ, который считается недопустимым для использования в идентификаторах языка ActionScript (например, дефис), вы не сможете обратиться к этому атрибуту или элементу с помощью оператора «точка». Вместо этого необходимо использовать метод attribute ( ), child ( ) или оператор [ ]. Например:
var saleEndsDate:XML = <DATE TIME-ZONE="PST">February 1. 2006</DATE> trace(saleEndsDate.@TIME-ZONE):// НЕДОПУСТИМО! He делайте так.
trace(saleEndsDate.attr!bute("TIME-ZONE")): // Допустимо. Делайте так. traceCsaleEndsDate.@["TIME-ZONE"]);// Тоже допустимо.
В случае с недопустимым кодом saleEndsDate . @TIME-ZONE среда выполнения Flash трактует дефис как операцию вычитания и интерпретирует выражение как saleEndsDate . OTIME минус ZONE! По всей видимости, переменная (или метод) с именем ZONE не существует, поэтому среда выполнения Flash сгенерирует следующее сообщение об ошибке:
Access of undefined property 'ZONE'
По-русски это будет выглядеть так: Обращение к неопределенному свойству 'ZONE*.
Однако если бы переменная ZONE существовала, ее значение было бы вычтено из пустого объекта XMLList, представленного выражением saleEndsDate. @Т1МЕ, и никакой ошибки не возникло бы! Без сообщений об ошибках неправильное обращение к элементу saleEndsDate . @TIME-ZONE будет очень сложно выявить. Принимая во внимание, что атрибут saleEndsDate. @TI ME не существует, нам бы хотелось, чтобы среда выполнения Flash сгенерировала ошибку «несуществующего атрибута», но, к сожалению, в версии спецификации Е4Х, реализованной в языке ActionScript 3.0, оговаривается, что в результате обращения к несуществующим атрибутам должен возвращаться пустой объект XMLL i s t, не приводя к возникновению ошибки. Будущие версии языка ActionScript могут исправить эту ситуацию.
Мы завершили рассмотрение базовых приемов обращения к данным XML Перед тем как продолжить изучение расширения Е4Х, еще раз вернемся к важной теме, касающейся интерпретации экземпляра класса XMLList в качестве экземпляра класса XML.
Интерпретация объекта XMLList как экземпляра класса XML
Как мы уже знаем, в расширении Е4Х ссылка на объект XMLList, содержащий всего один экземпляр класса XML, может рассматриваться как ссылка на этот экземпляр. Например, мы видели, что выражение:
novel.AUTHORED].setName("WRITER");
эквивалентно выражению:
novel.AUTHOR.setName("WRITER"): // Опущен [0]
Они являются эквивалентными, потому что выражение novel .AUTHOR ссылается на объект XMLList, содержащий всего один экземпляр класса XML (элемент <AUTHOR>).
Интерпретация экземпляра класса XMLL 1st как экземпляра класса XML делает использование расширения Е4Х более простым и удобным, но при этом порождает некоторые сбивающие с толку детали, особенно когда эта возможность применяется вместе с автоматическим преобразованием строк. Поближе познакомимся с этой проблемой.
Предположим, что мы создаем пользовательский интерфейс для книжного интернет-магазина, где каждая книга представлена XML-фрагментом, структура которого совпадает со структурой нашего примера с фрагментом <ВООК>. Когда пользователь выбирает книгу, на экране появляется соответствующее имя автора.
В нашем коде мы создаем метод displayAuthor ( ), который выводит имя автора. В первой реализации метода мы будем требовать, чтобы имя автора передавалось в виде строки:
public function displayAuthor (name:Str1ng):void {
// authorFleld ссылается на экземпляр класса TextFleld,
// в котором отображается имя автора authorFleld.text = name:
}
Когда пользователь выбирает книгу, мы получаем имя ее автора из элемента <AUTHOR> и передаем его в метод displayAuthor ( ), используя код наподобие следующего: displayAuthor(novel.AUTHOR):
Данная инструкция проста и интуитивно понятна, но, как мы уже знаем из этой главы, «за кадром» происходит очень много действий. В качестве повторения проанализируем, как это работает. Во-первых, среда выполнения Flash передает выражение novel. AUTHOR в метод displayAuthor ( ) в качестве значения параметра name. Типом данных параметра name является String, поэтому среда Flash автоматически пытается преобразовать значение выражения novel. AUTHOR в строку, используя следующее выражение:
novel.AUTHOR.toString( )
По умолчанию вызов метода toString( ) над объектом возвращает строку в формате [obj ect ИмяКласса], но выражение novel .AUTHOR представляет экземпляр класса XMLList, а класс XMLList переопределяет метод toString ( ) собственной версией. В частности, версия метода toString ( ) класса XMLList узнает, что значение выражения novel .AUTHOR содержит только один элемент, поэтому возвращается результат вызова метода toS t г ing ( ) класса XML над этим элементом. Таким образом, вызов novel. AUTHOR. toString ( ) автоматически преобразуется в вызов novel. AUTHOR [ 0 ] . toString ( ). Что же является возвращаемым значением выражения novel. AUTHOR [ 0 ] . toString ( )? Как мы уже знаем, ответ основан на факте, что выражение novel .AUTHOR [0] представляет простой элемент XML, который не содержит других элементов-потомков. Для элемента XML, не содержащего других элементов, метод toString ( ) класса XML возвращает текстовый узел данного элемента в виде строки, исключая охватывающие теги. Значит, выражение novel. AUTHOR [0] .toString( ) в качестве окончательного значения, передаваемого в метод displayAuthor ( ), вернет значение "Joyce, James” (а не ”<AUTHOR>Joyce, James</AUTHOR>").
Подведем итоги.
Передача значения выражения novel. AUTHOR в качестве параметра типа String приводит к неявному преобразованию значения выражения novel.AUTHOR в строку.
Значение выражения novel. AUTHOR преобразуется в строку с помощью вызова novel .AUTHOR. toString ( ).
Выражение novel .AUTHOR. toString ( ) автоматически возвращает результат выражения novel. AUTHOR [ 0 ] . toString ( ), поскольку значение выражения novel. AUTHOR представляет экземпляр класса XMLList с одним- единственным элементом.
Выражение novel. AUTHOR [0] . toString ( ) возвращает текст, содержащийся в элементе <AUTHOR> ("Joyce, James”), в соответствии с реализацией метода toString ( ) класса XML (дополнительную информацию можно найти далее, в разд. «Преобразование объектов XML и XMLList в строки»).
После всего сказанного и сделанного выражение
d1splayAuthor(novel.AUTHOR);
преобразуется в выражение.
displayAuthor("Joyce, James");
которое мы и предполагали увидеть.
В большинстве случаев мы можем игнорировать предыдущее усложнение, поскольку расширение Е4Х, говоря ненаучным языком, «делает то, что подразумевается». Однако существуют моменты, когда необходимо понимать действия «автопилота» в лице расширения Е4Х, чтобы осуществлять «ручное управление». Предположим, мы решили, что в книжном магазине должно выводиться не только имя, но и дата рождения каждого автора. Изменим структуру нашего фрагмента XML, чтобы включить дату рождения в качестве ребенка элемента <AUTHOR>, как показано в следующем коде:
var novel:XML = <ВООК ISBN="014118280б">
<TITLE>Ulysses</TITLE>
<AUTHOR>
<NAME>Joyce, James</NAME>
<BIRTHDATE>February 2 1882</BIRTHDATE>
</AUTHOR>
<PUBLISHER>Pengu1n Books Ltd</PUBLISHER>
</BOOK>.
Соответственно изменим метод displayAuthor ( ), чтобы он принимал элемент <AUTHOR> в качестве параметра и получал имя и дату рождения автора непосредственно из элементов-детей <NAME> и <BIRTHDATE>:
public function displayAuthor (author:XML):void {
authorFIeld.text = "Name: " + author.NAME
+ " Birthdate: " + author.BIRTHDATE:
Обратите внимание, что в данном коде тип данных параметра был изменен с типа String на XML. Если сейчас мы попытаемся передать значение выражения novel .AUTHOR в метод displayAuthor ( ), на этапе выполнения возникнет ошибка несоответствия типов, поскольку среда Flash не может осуществить неявное преобразование значения выражения novel .AUTHOR (которое является объектом XMLList) к экземпляру класса XML:
d1splayAuthor(novel.AUTHOR); //Ошибка #1034: Ошибка операции приведения //типов: невозможно преобразовать XMLList в XML
Чтобы исправить данную ошибку, мы должны явно ссылаться на экземпляр класса XML, представляющий элемент <AUTHOR>, при передаче его в метод displayAuthor ( ), как показано в следующем коде:
d1splayAuthor(novel.AUTHORED]): // Передаем единственный экземпляр класса
// XML, принадлежащий значению выражения’ // novel.AUTHOR, в метод dlsplayAuthor( )
Обратите внимание на важное отличие: когда мы хотим обратиться к тексту, содержащемуся в элементе <AUTHOR>, как к значению типа String, мы можем положиться на автоматическое поведение расширения Е4Х. Однако когда мы хотим обратиться к настоящему экземпляру класса XML, представляющему элемент <AUTHOR>, то должны явно ссылаться на этот экземпляр.
Теперь предположим, что нас попросили изменить наш магазин для поддержки книг с несколькими авторами. Мы снова изменим структуру нашего XML-фрагмента, чтобы включить несколько элементов <AUTHOR>. В листинге 18.7 представлен пример фрагмента XML, демонстрирующий новую структуру (даты рождения авторов являются вымышленными).
Листинг 18.7. Фрагмент <ВООК> с несколькими авторами
var oopBook:XML = <ВООК ISBN="0596007124">
<TITLE>Head First Design Patterns</TITLE>
<AUTHOR>
<NAME>Er1c Freeman</NAME>
<BIRTHDATE>January 1 1970</BIRTHDATE>
</AUTH0R>
<AUTH0R>
<NAME>E11sabeth Freeman</NAME>
<BIRTHDATE>January 1 1971</BIRTHDATE>
</AUTH0R>
<AUTH0R>
<NAME>Kathy S1erra</NAME>
<BIRTHDATE>January 1 1972</BIRTHDATE>
</AUTH0R>
<AUTH0R>
<NAME>Bert Bates</NAME>
<BIRTHDATE>January 1 1973</BIRTHDATE>
</AUTH0R>
<PUBLISHER>0'Reilly Media, Inc</PUBLISHER>
</B00K>:
Для работы с новой структурой XML мы изменим метод displayAuthor ( ), чтобы он принимал объект XMLList, представляющий несколько элементов <AUTHOR> (а не один элемент <AUTHOR> из предыдущего примера). В новой версии метода displayAuthor ( ) для перемещения по элементам <AUTHOR> используется инструкция for-each-in (мы рассмотрим использование инструкции for-each-in далее, в разд. «Обработка данных XML с помощью циклов for-each-in и for-in»).
public function displayAuthor (authors:XMLList):vo1d {’
for each (var author:XML 1n authors) {
authorFleld.text += "Name: " + author.NAME
+ ", Birthdate: " + author.BIRTHDATE + "\n";
}
}
Чтобы передать список элементов <AUTHOR> в метод displayAuthor ( ), мы используем следующий код:
d1splayAuthor(oopBook.AUTHOR);
Эта строка кода соответствует нашему первоначальному подходу, а именно: displayAuthor(novel.AUTHOR);
На этот раз объект XMLList передается непосредственно в метод displayAuthor ( ) без преобразования, поскольку типом данных получаемого параметра является XMLList, а не String. И снова обратите внимание на отличие: если при передаче объекта XMLList в функцию мы хотим преобразовать список в значение типа String, то для получаемого параметра указываем тип данных String и позволяем «колдовать» расширению Е4Х. Однако если мы хотим сохранить тип данных списка, то должны указать XMLList в качестве типа данных получаемого параметра. И сама ссылка (oopBook. author), и тип данных получаемого параметра (authors) оказывают влияние на поведение кода.
В табл. 18.1 представлены результаты передачи различных выражений расширения Е4Х, которые мы уже рассмотрели, в качестве параметров различных типов данных.
Таблица 18.1. Обзор: выражения расширения Е4Х и результаты
Выражение
Тип данных параметра
Результат.
novel .AUTHOR
String
"Joyce, James"
novel.AUTHOR
XML
Ошибка несоответствия типов (невозможно преобразовать тип XMLList к типу XML)
novel.AUTHOR[0]
String
"Joyce, James"
novel.AUTHOR[0]
XML
Экземпляр класса XML, представляющий элемент <AUTHOR>
oopBook. AUTHOR
String
Строка, содержащая исходный код XML для четырех элементов <AUTHOR>
oopBook. AUTHOR
XMLList
Объект XMLList с четырьмя экземплярами класса XML, представляющими четыре элемента <AUTHOR>
Не беспокойтесь. Расширение Е4Х отлично продумано. Пусть его автоматическое поведение не тревожит вас. Большую часть времени оно будет помогать вам. Тем не менее при обращении к узлам XML с использованием синтаксиса обращения к переменным (оператор «точка») имейте в виду следующие потенциальные источники недоразумений.
Выражение узелРодитель .имяУзлаРебенка является эквивалентным выражению узелРодитель .child (имяУзлаРебенка) и всегда ссылается на экземпляр класса XMLList, а не на экземпляр класса XML.
Когда экземпляр класса XMLLi s t содержит только один экземпляр класса XML, методы класса XML могут вызываться над экземпляром класса XMLList. Он автоматически переадресует эти вызовы экземпляру класса XML.
Чтобы получить объектную ссылку на экземпляр класса XML, который содержится в элементеузелРодитель. имяУзлаРебенка, необходимо использовать выражение вида узелРодитель .имяУзлаРебенка [индекс], даже если нужный экземпляр класса XML является единственным элементом в объекте XMLLi s t (в этом случае для обращения к элементу используется выражениеузелРодитель. имяУзлаРебенка [ 0 ]).
Если XML-элемент содержит только текст (и не содержит других элементов- детей), в результате преобразования этого элемента в строку будет возвращен содержащийся в нем текст без окружающих тегов (например, в результате преобразования элемента <TITLE>Ulysses</TITLE>B строку будет возвращена строка "Ulysses", а не "<TITLE>Ulysses</TITLE>").
Если XML-элемент содержит текст и элементы-детей, в результате его преобразования в строку будет получен исходный код данного элемента вместе с тегами. Например, в результате преобразования элемента
<AUTHOR>Joyce, <FIRSTNAME»James</FIRSTNAME></AUTHOR>
в строку будет получено
"<AUTHOR>Jоусе, <FIRSTNAME>James</FIRSTNAME></AUTHOR>"
а не
Joyce, James
Если вы сомневаетесь, то можете воспользоваться методами класса XML для обращения к интересующему вас содержимому. Явные названия методов класса XML иногда легче понять, несмотря на более громоздкую запись.
Обработка данных XML с помощью циклов for-each-in и for-in
Структурированные документы в формате XML зачастую содержат наборы данных, которые должны обрабатываться систематично. Например, XML-документ может содержать информацию о населении разных стран мира или точек на карте либо стоимость товаров в заказе. Независимо от данных, базовый подход одинаков: каждый элемент должен быть обработан и использован приложением определенным способом. Чтобы упростить процесс обработки информации в формате XML, расширение Е4Х вводит в язык ActionScript новый вид цикла, называемый циклом for-each-in.
Как уже рассказывалось в гл. 15,цикл for-each-inoбecпeчивaeтпpocтoйдocтyп к значениям динамических переменных экземпляра объекта или элементам массива. Напомним обобщенный синтаксис цикла for-each-in:
for each (значениеПеременнойИлиЭлемента in некийОбъект) { инструкции
}
Мы можем применять приведенный синтаксис для обработки экземпляров класса XML, содержащихся в объекте XMLList, так же легко, как для обработки элементов массива или динамических переменных экземпляра объекта. Это продемонстрировано в листинге 18.8.
Листинг 18.8. Использование цикла for-each-in для обработки экземпляров класса XML
var novel:XML = <ВООК ISBN="0141182806">
<TITLE>Ulysses</TITLE>
<AUTHOR>Joyce, James</AUTHOR>
<PUBLISHER>Pengu1n Books Ltd</PUBLISHER>
</BOOK>;
for each (var ch1ld:XML in novel.*) { trace(ch11d):
}
Цикл for-each-in в листинге 18.8 выполняется три раза, по одному для каждого узла-ребенка в объекте XMLList, который возвращается выражением novel. *. При выполнении цикла в первый раз переменной child присваивается ссылка на первый узел-ребенок элемента <ВООК> (то есть на экземпляр класса XML, представляющий элемент <TITLE>). При выполнении цикла во второй раз переменной child присваивается ссылка на второй узел-ребенок элемента <ВООК> (экземпляр класса XML, представляющий элемент <AUTHOR>). При выполнении цикла в третий раз переменной child присваивается ссылка на третий узел-ребенок элемента <ВООК> (экземпляр класса XML, представляющий элемент <PUBLI SHER>). Результат выполнения цикла выглядит следующим образом:
Ulysses
Joyce. James
Penguin Books Ltd
В листинге 18.9 представлен более сложный сценарий — подсчет общей стоимости заказа покупателя. Разобраться в этом коде помогут комментарии.
Листинг 18.9. Подсчет общей стоимости заказа
// Формируем заказ. В обычной ситуации заказ формируется программным путем
// в ответ на действия пользователя, но в этом примере мы включим
// в код уже сформированный заказ.
van order:XML = <ORDER>
<ITEM SKU="209">
<NAME>Trinket</NAME>
<PRICE>9.99</PRICE>'
<QUANTITY>3</QUANTITY>
</ITEM>
<ITEM SKU="513">
<NAME>Gadget</NAME>
<PRICE>149.99</PRICE>.
<QUANTITY>1</QUANTITY>
</ITEM>
<ITEM SKU="374">
<NAME>Toy</NAME>
<PRICE>39.99</PRICE>
<QUANTITY>2</QUANTITY>'
</ITEM>
</ORDER>
// Создаем текстовое поле, в котором будет отображаться описание заказа.
van outF1eld:TextFIeld = new TextF1eld( );
outField.width = 300;
outField.height = 300;
outFleld.text =• "Here 1s your orderAn";
addChl1d(outF1 el d);
// Изначально общая стоимость заказа равна 0.
var total;Number = 0;
// Этот цикл выполняется по одному разу для каждого элемента <1ТЕМ>.
for each (var item;XML in order.*) {
// Отображаем описание данного элемента в текстовом поле outField.
outFleld.text += Item.QUANTITY
+ " " + item.NAME + "(s)."
+ " $" + item.PRICE + " each An";
// Прибавляем стоимость этого элемента к общей стоимости заказа.
// Обратите внимание, что операция умножения автоматически преобразует
// значения количества и стоимости в числа.
total += item.QUANTITY * item.PRICE;
// Отображаем общую стоимость заказа. outField.appendText("TOTAL; " + total);
■ Вот результат выполнения кода из листинга 18.9:
Here 1s your order:
3 Trinket(s). $9.99 each.
1 Gadget(s). $149.99 each.
2 Toy(s). $39.99 each.
TOTAL: 259.94
Рассмотрим последний пример, демонстрирующий возможности управления содержимым заказа с помощью цикла f or-each-in. Этот код присваивает одно и то же значение всем элементам <PRICE> из листинга 18.9:
// Большая РАСПРОДАЖА!
// Все по цене $1!
for each (var item:XML 1n order.*) { item.PRICE = 1;
}
Более подробно возможность изменения содержимого элемента XML будет рассмотрена далее, в разд. «Изменение или создание нового содержимого XML».
Ошибочно полагать, что имена переменных экземпляров класса XML в объекте XMLList совпадают с названиями соответствующих элементов XML. Вместо этого экземпляры класса XML в объекте XMLList, как и элементы массива, расположены по порядку и в качестве имен переменных используются их порядковые номера. Это демонстрируется в следующем коде с помощью цикла f or-in. Имена 0,1 и 2 представляют порядковый номер каждого экземпляра класса XML в объекте XMLList, возвращаемом выражением order. *.
for (var cMldName: String in order.*) { trace(childName);
// Вывод:
// 0
// 1
// 2
Более подробную информацию по инструкциям for-each-in и for-in можно найти в гл. 15.
Обращение к потомкам
Мы уже достаточно попрактиковались в обращении к узлам-детям элемента XML. Теперь рассмотрим обращение не только к узлам-детям данного элемента, но и к так называемым узлам-потомкам. Потомками элемента являются все узлы, содержащиеся в этом элементе, на любом уровне иерархии XML (то есть узлы-внуки, узлы- правнуки и т. д.).
Например, рассмотрим XML-фрагмент из листинга 18.10, представляющий взятые из библиотеки книги и фильмы.
Листинг 18.10. Запись о взятых из библиотеки источниках
var loan:XML = <LOAN>
<BOOK ISBN="0141182806" DUE="1136091600000">
<TITLE>Ulysses</TITLE>
<AUTHOR>Joyce, James</AUTHOR>
<PUBLISHER>Pengu1n Books Ltd</PUBLISHER>
</BOOK>
<DVD ISBN="0790743086" DUE="1136610000000">
<TITLE>2001 A Space Odyssey</TITLE>
<DIRECTOR>Stanley Kubr1ck</DIRECTOR>
<PUBLISHER>Warner Home V1deo</PUBLISHER>
</DVD>
<DVD ISBN="078884461X" DUE="1137214800000">
<TITLE>Sp1r1ted Away</TITLE>
<DIRECTOR>Hayao М1уazak1</DIRECTOR>
<PUBLISHER>Walt Disney V1deo</PUBLISHER>
</DVD>
</LOAN>
В данном примере к потомкам элемента <LOAN> относятся:
непосредственные дети: элемент <ВООК> и два элемента <DVD>;
внуки: все элементы <TITLE>, <AUTHOR>, <PUBLISHER> и <DIRECTOR>;
правнуки: все текстовые узлы, содержащиеся в элементах <TITLE>, <AUTHOR>,
<PUBLISHER>И<DIRECTOR>.
Для обращения к потомкам элемента используется оператор «потомок» (. .) расширения Е4Х, записываемый в следующем виде:
элемент, .идентификатор
Выражение для обращения к потомкам возвращает объект XMLLi s t, представляющий всех потомков элемента элемент, имена которых соответствуют имени идентификатор. Например, следующее выражение возвращает объект XMLList, содержащий два экземпляра класса XML, которые представляют два элемента <DIRECTOR> из листинга 18.10:
loan..DIRECTOR
Обратите внимание, что элементы <DIRECTOR> не являются непосредственными детьми элемента <LOAN>; они являются его внуками. Оператор «потомок» предоставляет непосредственный, простой доступ к узлам, находящимся в любом месте иерархии XML. Например, чтобы получить список всех элементов <TITLE> в записи о взятых из библиотеки источниках, мы используем следующий код:
loan..TITLE
Чтобы вывести названия всех взятых источников, мы можем использовать код наподобие следующего:
traceC'You have borrowed the following Items:");
for each (var t1tle:XML 1n loan..TITLE) {
trace(tltle);
}
// Вывод:
You have borrowed the following Items:
Ulysses
2001 A Space Odyssey
Spirited Away
Это очень удобно!
Выражение а.Ь возвращает список всех непосредственных элементов-детей с име- *\ # нем Ь; выражение а..Ь возвращает список всех элементов-потомков с именем Ь. Синтаксис иУ намеренно сделан похожим — единственным отличием является глубина возвращаемых узлов.
Оператор «потомок» работает и с атрибутами. Чтобы получить список атрибутов- потомков, а не элементов, используется запись следующего вида:
элемент. .^имяАтрибута
Например, следующее выражение возвращает объект XMLList, имеющий три экземпляра класса XML, которые представляют три атрибута DUE из листинга 18.10.
loan..@DUE
Вот еще один удобный фрагмент кода:
traceC'Your items are due on the following dates:"):
for each (var due:XML in loan..@DUE) { trace(new Date(Number(due)));
// В часовом поясе стандартного восточного времени будут выведено следующее:
Your items are due:
Sun Jan 1 00:00:00 GMT-0500 2006
Sat Jan 7 00:00:00 GMT-0500 2006
Sat Jan 14 00:00:00 GMT-0500 2006
Чтобы получить объект XMLList, включающий все узлы, которые являются потомками данного элемента, используйте следующую запись: элемент. .*
Например, следующий код возвращает объект XMLList и 21 потомок элемента
<LOAN>:
loan. .*
Можете определить всех потомков? Все они представлены в листинге 18.11, нарисованном с помощью удобной псевдографики. Позиция каждого узла в объекте XMLList, возвращаемом выражением loan. . *, выделена круглыми скобками. Вы не забыли текстовые узлы, правда? Помните, что они считаются потомками?
Листинг 18.11. Узлы, возвращаемые выражением loan..*
BOOK (1)
|-TITLE (2)
||-Ulysses (3)
|-AUTHOR (4)
||-Joyce, James (5)'
|-PUBLISHER (6)
|-Penguin Books Ltd (7)
DVD (8)
|-TITLE (9)
|1-2001 A Space Odyssey (10)
I
|-AUTHOR (11)
||-Stanley Kubrick (12)
• |-DIRECTOR (13)
|-Warner Home Video (14)
DVD (15)
|-TITLE (16)
||-Spirited Away (17)
|-AUTHOR (18)
I |- Hayao Miyazaki (19)
I
|-DIRECTOR (20)
|- Walt Disney Video (21)
Чтобы получить объект XMLLis t, который включает все атрибуты, определенные как в самом элементе, так и во всех его потомках, используется запись следующего вида: элемент. .@*
Например, следующий код возвращает объект XMLLis t, который содержит все атрибуты, определенные в потомках элемента <LOAN> (всего шесть). Стоит отметить, что если бы в элементе <LOAN> были определены атрибуты (у элемента <LOAN> они отсутствуют), они были бы включены в этот список.
loan..@*
Следующий код выводит атрибуты, возвращаемые выражением loan. . @ *, с помощью цикла f or-each-in. Для каждого атрибута отображается его имя и значение, а также содержимое элемента-ребенка <TITLE> его родителя.
for each (var attribute:XML 1n loan..@*) {
trace(attr1bute.parent( ).TITLE
+ ": " + attribute.name( ) + "=" + attribute):
// Вывод:
Ulysses: ISBN=0141182806
Ulysses: DUE=1136091600000
2001 A Space Odyssey: ISBN=0790743086
2001 A Space Odyssey: DUE=1136610000000
Spirited Away: ISBN=078884461X
Spirited Away: DUE=1137214800000
Чтобы получить объект XMLList, который включает все атрибуты, определенные в потомках элемента, исключая атрибуты самого элемента, применяется запись следующего вида: элемент. .*.@*
или следующий более громоздкий, но менее загадочный код:
элемент. .*.attributes( )
Предыдущий код читается следующим образом: «вызвать метод экземпляра attributes ( ) класса XMLList над объектом XMLList, который представляет потомки элемента элемент». Результатом этого выражения является объект XMLList, представляющий все атрибуты, определенные в потомках элемента элемент. Чтобы освежить в памяти описание метода attributes ( ), обратитесь к подразд. «Обращение к атрибутам» разд. «Обращение к данным XML».
Для обращения к атрибутам или элементам, имена которых содержат символы, считающиеся недопустимыми в идентификаторах языка Actionscript, вместо оператора «потомок» необходимо использовать метод экземпляра descendants() класса XML. Оператор «потомок» не позволяет использовать запись вида элемент..["некоеИмя"].
Оператор «потомок» полезен сам по себе, однако при использовании возможностей фильтрации расширения Е4Х он становится просто незаменимым. Как только вы разберетесь с оператором «потомок» и возможностями фильтрации расширения Е4Х, сможете быстро и легко выполнять практически любую обработку данных в формате XML. Мы рассмотрим это в следующем разделе.
Фильтрация данных XML
Оператор филътруюгцего предиката расширения Е4Х — это простой, но очень мощный инструмент поиска. Он может принимать любой объект XMLList и возвращать подмножество элементов из этого списка в соответствии с указанным условием.
Й
Термин «предикат» заимствован из спецификации языка XPath консорциума W3C. Более подробную информацию можно найти по адресу http://www.w3.org/TR/xpath20/#id- predicates.
Оператор фильтрующего предиката записывается в следующем обобщенном виде:
объектХМИ 1st. (условноеВыражение)
Для каждого элемента в объекте oObeKTXMLList выражениеусловноеВыражение выполняется один раз. Если для элемента выражение условноеВыражение возвращает значение true, этот элемент добавляется в объект XMLList, который возвращается после обработки всех элементов. Стоит отметить, что при каждом выполнении выражения условноеВыражение текущий элемент временно добавляется в начало цепочки областей видимости, позволяя внутри выражения непосредственно обращаться к его потомкам и атрибутам по имени.
Использовать оператор фильтрующего предиката чрезвычайно просто. Рассмотрим новый XML-фрагмент и выполним фильтрацию. В листинге 18.12 новый фрагмент представляет список сотрудников компании.
Листинг 18.12. Список сотрудников
var staff:XML = <STAFF>
<EMPLOYEE ID="501" HIRED="1090728000000">
<NAME>Marco Crawley</NAME>
<MANAGER>James Porter</MANAGER>
<SALARY>25000</SALARY>
<POSITION>Designer</POSITION>
</EMPLOYEE>
<EMPLOYEE ID="500" HIRED="1078462800000">
<NAME>Graham Barton</NAME>
<MANAGER>James Porter</MANAGER>
<SALARY>35000</SALARY>
<POSITION>Designer</POSITION>
</EMPLOYEE>
<EMPLOYEE ID="238" HIRED="1014699600000">
<NAME>James Porter</NAME>
<MANAGER>Dor1an Schapiro</MANAGER>
<SALARY>55000</SALARY>
<POSITION>Manager</POSITION>
</EMPLOYEE>
</STAFF>
Теперь выполним нашу первую операцию по фильтрации данных: предположим, что мы хотим получить список сотрудников, которыми руководит James Porter. Мы можем отфильтровать список элементов <EMPLOYEE> из листинга 18.12 следующим образом:
// Сначала получаем объект XMLList, представляющий все элементы <EMPLOYEE> var all Employees:XMLList = staff.*;
// Теперь фильтруем список элементов <EMPLOYEE>
var employeeslInderJames: XMLList = all Employees. (MANAGER == "James Porter");
Выражение allEmployees . (MANAGER == "James Porter") возвращает объект XMLList, включающий все элементы из фрагмента allEmployees, у которых элемент <MANAGER> содержит текст "James Porter”. Вам должна понравиться простота и читабельность кода расширения Е4Х. Просто помните, что предыдущая строка кода работает потому, что каждый раз при выполнении выражения (MANAGER == ”James Porter”) проверяемый элемент из фрагмента allEmployees добавляется в цепочку областей видимости. Таким образом, выполняемое выражение (MANAGER == ” James Porter”) имеет следующее концептуальное значение, записанное в псевдокоде:
if (текущийСотрудник.MANAGER == "James Porter")
// добавить текущийСотрудник в список результатов
Для сравнения приведем реальный код на языке ActionScript, который делает то же самое, что и выражение allEmployees . (MANAGER == "James Porter"): var resultList:XMLList = new XMLList( );
van countertint = 0;
for each (var employee:XML in allEmployees) {
if (employee.MANAGER == "James Porter") {
resulttist[counter] = employee; counter++;
}
}
Рассмотрим еще несколько примеров, которые демонстрируют, как можно обращаться к информации из листинга 18.12, основываясь на множестве условий. Следующее выражение возвращает список сотрудников, зарплата которых меньше либо равна $35 000.
staff.*.(SALARY <= 35000)
Следующее выражение возвращает список сотрудников с зарплатой от $35 000 до 50 000:
staff.*.(SALARY >= 35000 && SALARY <= 50000)
Это выражение возвращает список дизайнеров, работающих в компании:
staff.*.(POSITION == "Designer")
Следующее выражение возвращает список сотрудников с идентификационным номером 238 (так получилось, что в этом примере только один сотрудник с указанным номером, но данный элемент все равно помещается в экземпляр класса XMLList).
staff.*.(@ID == "238")
Следующий код получает список сотрудников, которые работают в компании с 2004 года (для представления времени мы используем стандартный формат «мил- лисекунды-с-1970-года», применяемый в классе Date):
staff.*.(@HIRED >= 1072933200000 && @HIRED <= 1104555600000)
Наконец, мы выводим дату, когда был нанят сотрудник Graham:
// В часовом поясе стандартного восточного времени будет отображено:
// Fri Маг 5 00:00:00 GMT-0500 2004
trace(new Date(Number(staff.*.(NAME == "Graham Barton").@HIRED)));
Забавно, не правда ли? Предикаты — это сильно!
Чтобы отфильтровать список, в котором не каждый элемент имеет заданный атрибут или элемент-ребенка, мы должны использовать метод hasOwnProperty() для проверки существования данного атрибута или ребенка перед применением фильтра. В противном случае возникнет ошибка обращения. Например, следующий код возвращает все элементы документа некийДокумент, у которых для атрибута color установлено значение "red":
некийДокумент. .*.(hasOwnProperty("@color") && @color == "red")
Мы познакомились с множеством способов обращения к конкретным узлам и группам узлов внутри XML-документа. Далее рассмотрим использование обхода дерева для обращения не к определенным узлам документа, а к каждому его узлу.
Обход деревьев XML
В терминах программирования обход означает обращение к каждому узлу в структуре данных и его обработку. Обход дерева означает использование рекурсивного алгоритма для обхода узлов древовидной структуры.
В реализациях языка XML, основанных на модели DOM (например, унаследованный класс flash. xml. XMLDocument), для поиска информации программисты часто пишут собственный код, осуществляющий обход деревьев XML. Например, программа для работы с персоналом может включать код, который просматривает весь документ XML в поисках сотрудников с должностью «руководитель» или с зарплатой, находящейся в заданном интервале. Как мы уже видели в предыдущем разделе, такой пользовательский код для обхода деревьев почти не нужен в расширении Е4Х, поскольку большинство операций поиска могут быть выполнены с помощью операторов «потомок» и фильтрующего предиката расширения Е4Х. Однако бывают ситуации, в которых необходимо выполнить обход дерева даже в расширении Е4Х. К счастью, для этих целей код расширения Е4Х прост.
В расширении Е4Х мы можем использовать оператор «потомок» вместе с групповым символом свойств, чтобы получить объект XMLList, содержащий все узлы- потомки для данного элемента, как показано в следующем коде:
некийЭлемент..* // Возвращает список, содержащий все потомки
// элемента некийЭлемент
Можно также использовать инструкцию for-each-in для перемещения по всем элементам объекта XMLList. Объединив эти методики вместе, мы легко обойдем любой узел в дереве XML, как показано в следующем коде:
for each (var ребенок:XML in некийЭлемент..*) {
// обработка элемента ребенок...
}
Однако стоит отметить, что предыдущий код не в полном объеме соответствует классическому определению обхода дерева, поскольку он никогда не обращается к корневому элементу иерархии (некийЭлемент). Если корневой узел должен обрабатываться вместе с его детьми, просто временно добавьте его к другому экземпляру класса XML, как показано ниже:
var tempRoot:XML = <root/>:
tempRoot. appendChi ШнекийЗлекент) :
for each (var ребенок:XNL in tempRoot..*) {
// Обработка элемента ребенок...
Рассмотрим простой пример реального обхода дерева. Предположим, что мы создаем форум, который позволяет пользователям оставлять ответы, включающие
разметку HTML. Чтобы ответы соответствовали стандарту XHTML, мы хотим, чтобы все имена тегов, найденные в ответах пользователей, преобразовывались в нижний регистр. Вот пример ответа, который включает проблематичный верхний регистр и смешанные регистры в именах тегов:
var message:XML = <message>
<B>HEY!</B> I just wanted to say that your site 1s so cool I!
You should <A Href="http://mys1te1scooltoo.com/">v1s1t m1ne</A> sometime. </message>;
Рассмотрим код для обхода дерева, который преобразует имена всех элементов и атрибутов из предыдущего XML-фрагмента в нижний регистр:
for each (var ch1ld:XML in message..*) {
// Если узел является элементом...
if (child.nodeK1nd( ) == "element") {■
// ...преобразуем его имя в нижний регистр.
child.setName(ch1ld.name( ).toString( ).toLowerCase( ));
// Если узел имеет атрибуты, преобразуем их имена в нижний регистр.
for each (var attr1bute:XML in child.@*) {
attribute.setName(attr1bute.name( ).toString( ).toLowerCase( ));
}
}
}
Вот новый фрагмент XML, полученный в результате выполнения предыдущего кода, — все имена тегов и атрибутов преобразованы в нижний регистр.
<message>
<b>HEY!</b>I just wanted to say that your site 1s so cool!!
You should <a href="http.7/mys1te1scooltoo.com/">v1s1t mine</a> sometime.
</message>
На протяжении всей этой главы мы знакомились со способами обращения к содержимому существующих XML-документов. Теперь рассмотрим, как создавать или изменять это содержимое.
Изменение или создание нового содержимого XML
В расширении Е4Х наиболее распространенные операции добавления и изменения существующего экземпляра класса XML могут быть выполнены с помощью обычных операторов присваивания. Тем не менее результаты операторов присваивания расширения Е4Х отличаются и зависят от типа присваиваемого значения и типа целевого объекта присваивания. Рассмотрим различные сценарии по отдельности.
Изменение содержимого элемента
Чтобы изменить содержимое XML-элемента, мы присваиваем ему любое значение, не являющееся объектом XMLList или XML. Это значение преобразуется в строку и заменяет текущее содержимое элемента. Вспомним наш фрагмент <ВООК>:
var novel:XML = <ВООК ISBN="0141182806">
<TITLE>Ulysses</TITLE>
<AUTHOR>Joyce, James</AUTHOR>
<PUBLISHER>Pengu1n Books Ltd</PUBLISHER>
</BOOK>•
Чтобы изменить содержимое элемента <TITLE> со строки ’’Ulysses” на строку "The Sun Also Rises", мы используем следующий код:
novel.TITLEE0] = "The Sun Also Rises";
Однако не забывайте, что расширение Е4Х по возможности позволяет интерпретировать объект XMLList в виде объекта XML. Поскольку объект XMLLis t, возвращаемый выражением novel. TITLE, имеет один-единственный экземпляр класса XML, мы можем использовать следующий более удобный код:
novel.TITLE = "The Sun Also Rises"; // Опущено [0]
Однако если бы объект XMLList, возвращаемый выражением novel .TITLE, содержал несколько элементов <TITLE>, операция присваивания имела бы другой результат, описываемый далее, в подразд. «Присваивание значений объекту XMLList» разд. «Изменение или создание нового содержимого XML».
Й
Если вы хотите вспомнить отличие между выражением novel.TITLE[O] и novel.TITLE, обратитесь к подразд. «Интерпретация объекта XMLList как экземпляра класса XML» разд. «Обращение к данным XML».
Теперь также изменим имя автора и название издательства:
novel.AUTHOR = "Hemingway. Ernest"; novel.PUBLISHER = "Scribner";
В качестве альтернативы содержимое элемента можно изменить с помощью метода экземпляра setchildren ( ) класса XML. Например:
novel.TITLE.setChl1dren("The Sun Also Rises");
Изменение значения атрибута
Чтобы изменить значение атрибута XML, просто присвойте атрибуту любое новое значение, используя оператор присваивания. Новое значение будет преобразовано в строку и заменит существующее значение атрибута. Например, следующий код изменяет значение атрибута ISBN со строки "0141182806" на строку "0684800713”:
novel.@ISBN = "0684800713";
В этом коде использование строки вместо числа в качестве нового значения позволяет сохранить первый нуль.
Если присваиваемое атрибуту значение является объектом XMLL i s t, содержащим атрибуты, то значения атрибутов из этого объекта XMLList будут объединены в одну строку (в качестве разделителей используются пробелы), которая затем будет присвоена атрибуту. Это слегка необычное поведение может использоваться для объединения группы атрибутов в один атрибут. Например:
var books:XML = <B00KS>
<B00K ISBN=”0141182806”/>
<B00K ISBN=”0684800713”/>
<B00K ISBN=”0198711905”/>
</B00KS>:
var order:XML = ORDER ITEMS=””/>: order.@ITEMS = books.*.@ISBN;
// Выдает:
ORDER ITEMS=”0141182806 0684800713 0198711905”/>
Замена всего элемента
Чтобы заменить элемент XML новыми элементами, ему присваивается либо объект XMLLis t, либо объект XML. Например, в следующем коде элемент <DIV> заменяет элемент <Р>:
var doc:XML = ООО
<P ALIGN="CENTER">E4X 1s fun</P>
</DOO;
doc.P = OIV>E4X 1s conven1ent</DIV>;
// Выдает:
ООО
OIV>E4X 1s conven1ent</DIV>
</DOO
Содержимое элемента может также быть заменено с помощью метода экземпляра replace ( ) класса XML. Например:
// Тождественно: doc.P = OIV>E4X 1s conven1ent</DIV>
doc.replaceCP”, OIV>E4X 1s conven1ent</DIV>):
Обратите внимание, что, когда XML-элемент заменяется содержимым из другого документа, новое содержимое представляет собой копию содержимого элемента другого документа, а не ссылку на него. Например, рассмотрим два следующих фрагмента XML:
var userl:XML = <USERDETAILS>
<LOGIN>joe</LOGIN>
<PASSWORD>11nuxRules</PASSWORD>
</USERDETAILS>;
var user2:XML = OSERDETAILS>
<LOGIN>ken</LOGIN>
<PASSWORD>default</PASSWORD>
</USERDETAILS>;
Мы можем заменить элемент < PASS WORD> фрагмента us er 2 элементом <PASSWORD> фрагмента userl следующим образом:
user2.PASSWORD = userl.PASSWORD:
После замены два элемента <PASSWORD> будут иметь одинаковое содержимое: trace(userl.PASSWORDE0] == user2.PASSWORDE0]): // Выводит: true
Но они ссылаются на разные экземпляры класса XML:
trace(userl.PASSWORD[0] === user2.PASSWORD[OJ): // Выводит: false
Получить информацию о различиях между двумя предыдущими выражениями равенства можно далее, в разд. «Определение равенства в расширении Е4Х».
Добавление новых атрибутов и элементов
Мы можем добавлять новые атрибуты и элементы в документ, используя тот же синтаксис присваивания, который применяется для изменения и замены существующих атрибутов и элементов.
В расширении Е4Х, когда значение присваивается несуществующему атрибуту или элементу, среда выполнения Flash автоматически добавляет указанный атрибут или элемент в документ. В качестве примера создадим наш фрагмент <ВООК> * с нуля. Мы начнем с пустого элемента <ВООК>:
var novel:XML = <ВООК/>;
Затем добавим атрибут ISBN:
novel.@ISBN = "0141182806”:
Наконец, добавим элементы <TITLE>, <AUTHOR> и <PUBLISHER>:
novel.TITLE = "Ulysses":
novel.AUTHOR = "Joyce. James":
novel.PUBLISHER = "Penguin Books Ltd":
Для каждой операции присваивания к тегу <ВООК> в качестве нового последнего ребенка добавляется новый элемент. Таким образом, в результате выполнения предыдущего кода будет получен следующий XML-фрагмент:
<ВООК ISBN="0141182806">
<TITLE>Ulysses</TITLE>
<AUTHOR>Joyce, James</AUTHOR>
<PUBLISHER>Pengu1n Books Ltd</PUBLISHER>
</BOOK>
Синтаксис присваивания также может быть использован для добавления вложенной структуры XML с помощью одного оператора. Предположим, что мы хотим добавить следующее вложенное содержимое, описывающее место действия романа, к элементу <ВООК>:
<SETTING>
<CITY>Dubl1n</CITY>
<COUNTRY>Irel and</COUNTRY>
</SETTING>
Для этого можно воспользоваться следующим кодом:
novel.SETTING.CITY = "Dublin":
novel.SETTING.COUNTRY = "Ireland":
Когда среда Flash пытается исполнить первую инструкцию, она определяет, что в документе нет ни элемента <SETT ING>, ни элемента <С ITY>, и, следовательно, создает оба этих элемента. Когда среда Flash исполняет вторую инструкцию, она видит, что элемент <SETTING> уже существует, и поэтому не создает его повторно. Вместо этого среда выполнения просто добавляет элемент <COUNTRY> к существующему элементу <SETTING>. Вот так выглядит получившийся фрагмент XML:
<ВООК ISBN="0141182806">
<TITLE>Ulysses</TITLE>
<AUTHOR>Joyce, James</AUTHOR>
<PUBLISHER>Pengu1n Books Ltd</PUBLISHER>
<SETTING>
<CITY>Dubl1n</CITY>
<COUNTRY>Ireland</COUNTRY>
</SETTING>
</BOOK>
Мы можем использовать аналогичный подход, чтобы представить информацию о месте действия в одном элементе, имеющем следующий формат:
<SETTING CITY="Dubl1n" COUNTRY="Irei and"/>
Для этого мы просто присваиваем желаемым атрибутам необходимые значения, как показано в следующем коде:
novel.SETTING.@CITY = "Dublin";
novel.SETTING.@COUNTRY = "Ireland";
//Выдает:
<BOOK ISBN="0141182806">
<TITLE>Ulysses</TITLE>
<AUTHOR>Joyce. James</AUTHOR>
<PUBLISHER>Pengu1n Books Ltd</PUBLISHER>
<SETTING CITY="Dublin" COUNTRY=" Irei and "/>
</BOOK>
В этом разделе мы узнали, что присваивание значения несуществующему элементу приводит к добавлению этого элемента в документ. Но что делать, если мы хотим добавить элемент с таким же именем, как имя существующего элемента? Например, как добавить несколько элементов <AUTHOR> к элементу <ВООК>? Ответы на этот вопрос вы найдете далее. По мере чтения следующих разделов обратите внимание на использование аддитивного оператора (+), который создает новый объект XMLList из набора экземпляров классов XML или XMLList. Аддитивный оператор принимает следующий вид:
ЭкземплярКлассаХМ1ИлиХМ111stl + ЭкземплярКлассаХМЫлиХМШ st2
Он возвращает новый экземпляр класса XMLList, содержащий объединенный список всех экземпляров класса XML из экземпляров ЭкземплярКлассаХМЬИлиХМЬМ stl и ЭкземплярКлассаХМкИлиХМШ st2.
Добавление нового ребенка за всеми существующими детьми
Чтобы добавить нового ребенка последним к существующему элементу, используйте один из следующих способов:
родитель .InsertChi Alfter (род и тель .★[родитель length ( )-1], <новыйРебенок/>')
или:
родитель .★[родитель.*.length( )-1] = родитель .★[родитель .*.length( )-1] + <новыйРебенок/>
или:
родитель. appendCh 11 <А(<новыйРебенок/>)
Например, следующий код добавляет новый элемент <DESCRIPTION> к <ВООК> сразу за существующим элементом <PUBLISHER>:
van novel:XML = <BOOK ISBN="0141182806">
<TITLE>Ulysses</TITLE>
<AUTHOR>Joyce, James</AUTHOR>
<PUBLISHER>Pengu1n Books Ltd</PUBLISHER>
</BOOK>
novel,1nsertCh1ldAfter(novel.*[novel,*.length( )-l],
<DESCRIPTION>A modern class1c</DESCRIPTION>):
Приведенная строка является синонимом следующего кода, который заменяет последнего ребенка элемента <ВООК> объектом XMLList, содержащим последнего ребенка элемента <ВООК> (элемент <PUBLISHER>) и элемент <DESCRIPTION>: novel.*[novel,*.length( )-l] = novel.*[novel,*.length( )-l]
+ <DESCRIPTION>A modern classlc</DESCRIPTION>:
Чтобы облегчить восприятие, рассмотрим данную строку кода еще раз, записав ее с помощью псевдокода:
// ПСЕВДОКОД:
<PUBLISHER> = <PUBLISHER> + <DESCRIPTION>A modern classlc</DESCRIPTION>
To же самое мы можем записать, используя более сжатую форму (это настоящий код на языке ActionScript), как показано ниже:
novel.*[novel.*.length( )-1] += <DESCRIPTION>A modern classlc</DESCRIPTION>:
А вот наиболее удобный подход:
novel.appendChlld(<DESCRIPTION>A modern class1c</DESCRIPTION>):
Добавление нового ребенка за указанным существующим ребенком
Чтобы добавить нового ребенка за указанным существующим ребенком, используйте один из следующих способов:
родитель .insertChi АбА^ег^родитель .существующийРебенок[п^. <новыйРебенок/>)
или:
родитель ,существующийРебенок[пА = родитель .существующийРебенок[п^ + <новыйРебенок/>
или:
родитель .★[индексРебенка^ = родитель .★[индексРебенка^ + <новыйРебенок/>
Например, следующий код добавляет второй элемент <AUTHOR> к элементу
<ВООК> сразу за существующим элементом <AUTHOR>:
novel. 1 nsertChl1dAfter(novel.AUTHORED], <AUTHOR»Dave Luxton</AUTHOR»);
В качестве первого аргумента в метод insertChildAf ter ( ) необходимо передавать экземпляр класса XML (а не класса XMLList!), поэтому мы должны использовать прямую ссылку на экземпляр класса XML — novel. AUTHOR [ 0 ].
Чтобы вспомнить отличия между экземплярами классов XML и XMLList, обратитесь к подразд. «Интерпретация объекта XMLList как экземпляра класса XML» разд. «Обращение к данным XML».
В качестве альтернативы подходу с применением метода insertChildAfter( ) можно использовать следующий код:
novel.AUTHORED] = novel.AUTHORED] + <AUTHOR»Dave Luxton</AUTHOR»:
Или более сжато:
novel.AUTHORED] += <AUTHOR»Dave Luxton</AUTHOR»:
А вот еще один аналогичный подход:
// Добавляем новый элемент XML за вторым ребенком элемента novel novel.*[1] = novel.*[1] + <AUTHOR»Dave Luxton</AUTHOR»;
И вновь предыдущая строка может быть записана более сжато:
novel.*Е1] += <AUTHOR»Dave Luxton</AUTHOR>:
Добавление нового ребенка перед указанным существующим ребенком
Чтобы добавить нового ребенка перед указанным существующим ребенком, используйте один из следующих способов:
родитель. 1 nsertChl 1 dBefore(рох/ите/ть .существующийРебенок^п^, <новыйРебенок/>)
или:
родитель .существующийРебенок№ = родитель .существующийРебенок^ + <новыйРебенок/>
или:
родитель *^индексРебенка1 = родитель *^индексРебенка^ + <новыйРебенок/>
Например, следующий код добавляет новый элемент <PRICE> к нашей книге непосредственно перед первым элементом <AUTHOR>:
novel.1nsertCh1ldBefore(novel.AUTHORED], <PRICE>19.99</PRICE>);
Как и в случае с методом insertChildAfter ( ), обратите внимание, что первым аргументом метода insertChildBef ore ( ) должен быть экземпляр класса XML (а не класса XMLList!).
Предыдущая строка является синонимом следующей строки:
novel.AUTHOR = <PRICE»19.99</PRICE> + novel.AUTHOR:
Вот еще один аналогичный подход:
// Добавление нового элемента XML // перед вторым ребенком элемента novel novel.*[1] = <PRICE>19.99</PRICE> + novel.*[!]:
Добавление нового ребенка перед всеми существующими детьми
Чтобы добавить новый элемент в качестве первого ребенка существующего элемента, используйте любой из следующих способов:
родитель. 1 nsertChlldBefore(родитель .*[0], <новыйРебенок/>')
или:
родитель.*[0] = <новыйРебенок/> + родитель .*[0]
или:
родитель .prependChl Ш<новыйРебенок/>)
Например, следующий код добавляет новый элемент < PAGECOUNT > к нашей книге непосредственно перед существующим элементом <TITLE>: novel.1nsertChlldBefore(novel .*[0]. <PAGECOUNT>1040</PAGECOUNT>);
Предыдущая строка аналогична следующей:
novel.*[0] = <PAGECOUNT>1040</PAGECOUNT> + novel.*[0]:
А вот наиболее удобный подход:
novel.prependChl ld(<PAGECOUNT>1040</PAGECOUNT>);
Удаление элементов и атрибутов
Чтобы удалить элемент или атрибут из документа, используйте оператор delete следующим образом: delete элементИлиАтрибут
Например, следующий код удаляет атрибут ISBN из элемента <ВООК>: delete novel.@ISBN:
Следующий код удаляет элемент <TITLE> из элемента <ВООК>: delete novel.TITLE:
Вот как можно удалить всех детей, содержащихся в элементе:
delete novel.*: // Удаляет <TITLE>, <AUTHOR> и <PUBLISHER>
// из исходного XML-фрагмента.
Та же методика может применяться при удалении текстового содержимого из элемента:
delete novel.TITLE.*: // Удаляет "Ulysses"
// из исходного XML-фрагмента.
Вот как можно удалить все атрибуты элемента:
delete novel.@*: // Удаляет все атрибуты (в данном случае ISBN)
Ссыпки на части документа не являются обновляемыми
Изменяя или добавляя новое содержимое в объект XML, имейте в виду, что любые вносимые изменения не отражаются на переменных, которые ссылаются на части этого документа. Например, следующий код создает переменную children, которая ссылается на узлы-детей элемента <ВООК>:
var novel:XML = <ВООК ISBN="0141182806**>
<TITLE>Ulysses</TITLE>
<AUTHOR>Joyce, James</AUTHOR>
<PUBLISHER>Pengu1n Books Ltd</PUBLISHER>
</BOOK>
var ch11dren:XMLL1st = novel.*:
Если теперь мы удалим элемент <PUBLISHER>, изменение будет внесено в исходный документ, но не затронет переменную children:
// Удаляем <PUBLISHER> delete novel.PUBLISHER: trace(novel): // Выводит: <BOOK ISBN=,,0141182806">
//<TITLE>Ulysses</TITLE>
//<AUTHOR>Joyce, James</AUTHOR>
//</BOOK>
trace(children); // Выводит: <TITLE>Ulysses</TITLE>
//<AUTHOR>Joyce, James</AUTHOR>
//<PUBLISHER>Pengu1n Books Ltd</PUBLISHER>
// <PUBLISHER> по-прежнему существует!
Возможно, будущие версии расширения Е4Х будут поддерживать обновляемые ссылки на части документа.
Испвльзвванив сущностей XML для специальных симвопов
В расширении Е4Х реализованы особая интерпретация и правила для определенных символов пунктуации, когда они используются в литерале XML или в выражении присваивания значения XML-элементу. В табл. 18.2 показано, как включать эти символы в документ XML с помощью языка ActionScript. В левом столбце таблицы перечислены символы, а в остальных столбцах показан код, необходимый для включения этих символов в четырех различных контекстах. Для сравнения следующий код демонстрирует пример каждого из четырех типов контекста (контекст представлен текстом некийТекст).
11 Текст литерала атрибута
var xml:XML = <некийЭлемент некийАтрибут="некийТекст"!>
/I Текст, присваиваемый атрибуту
xml.@другойНекийАтрибут = "некийТекст"
И Текстовый узел в литерале элемента
var xml:XML = <некийЭлемент>^екииТекст</некийЭлемент>
И Текстовый узел, присваиваемый элементу xml.другойНекийЭлемент = "некийТекст";
Таблица 18.2. Присваивание специальных символов пунктуации
Символ
Текст литерала атрибута
Текст, присваиваемый атрибуту
Текстовый узел в литерале элемента
Текстовый узел, присваиваемый элементу
\
\\
\\
^♦♦**
\\
&
&
&
&
&
"
\" или "
\"
•
’**
•
•
<
<
<
<
<•
>
>
>
>
>
Новая строка (\П)
Не поддерживается*
Не поддерживается*
Не поддерживает-
**♦
\п
{
{
{
&#х7В
{
}
}
}
}
}
В данных контекстах последовательность новой строки \п автоматически преобразуется в сущность &#хА;.
Чтобы включить символ * в значение атрибута, отделенного символами', используйте управляющую последовательность '.
Допускается применять последовательность \п, если значение элемента является вычисляемым. Например,
var val:String = "Newlines \n are \n okay \n here!":
var paragraph:XML = <p>{val}</p>:
В отличие от строк, в литерале XML символ обратного слэша (\) никогда не интерпретируется как начало управляющей последовательности.
Стоит отметить, что, хотя символы > и & могут быть использованы в любом литерале XML, когда среда Flash встречает их в текстовом узле при парсинге XML-документа, она автоматически преобразует эти символы в сущности > и &ашр; соответственно. Подобным образом, когда среда выполнения встречает символ & в значении атрибута при парсинге документа XML, она автоматически преобразует этот символ в сущность &ашр;. Однако при использовании в контексте строки эти сущности будут преобразованы обратно в исходные символы. Чтобы увидеть текстовый узел без преобразования его сущностей, используйте метод экземпляра toXMLString ( ) класса XML. Это демонстрирует следующий код:
var р:XML = <р>&></р>:
trace(p.toStr1ng( )):// Выводит: &>
trace(p.toXMLString( )); // Выводит: <p>&:>:</р>
Наконец, обратите внимание, что, хотя символ ’ может использоваться для отделения значения атрибута в литерале XML, в процессе парсинга он преобразуется в символ ”. Это демонстрирует следующий код:
var p:XML = <р align='left'/>:
trace(p.toXMLStr1ng( )): // Выводит: <р al 1gn="1 eftм/>
Присваивание значений объекту XMLList
Как уже говорилось в подразд. «Изменение содержимого элеми 1та», не существует разницы между присваиванием значения объекту XMLList, содержащему один- единственный экземпляр класса XML, и присваиванием значения непосредственно этому экземпляру класса XML. Тем не менее присваивание значения объекту XMLList, содержащему более одного экземпляра класса XML, может иметь множество различных результатов. В зависимости от типа присваиваемого значения и типа экземпляров класса XML, находящихся в списке, список может быть изменен или даже полностью заменен.
Единственный типичный сценарий использования операции присваивания значения экземпляру класса XMLList — замена ребенка элемента-родителя новым XML-элементом или списком элементов. Например, следующий код заменяет два ребенка <Р> элемента <DOC> одним элементом <Р>:
var doc:XML = <DOC TOPIC="Code Tips" AUTHOR="Col1n">
<p>Errors are your fr1ends</P>
<P>Backup often</P>
</DOC>:
doc.* = <P>Pract1ce coding everyday</P>;
// Выдает:
<DOC TOPIC="Code Tips" AUTHORS Goli n">
<P>Practice coding everyday</P>
</DOC>
Присваивание значения объекту XMLList является редко используемой операцией, поэтому ее тщательное рассмотрение выходит за рамки этой книги. Читателям, интересующимся гротескными ситуациями в программировании, которой, например, является попытка присвоить список инструкций обработки списку атрибутов, предоставляется возможность самостоятельно познакомиться с ними.
Загрузка XML-данных
Для наглядности в большинстве примеров этой главы ХМL-данные были записаны в виде литералов. Однако в реальных приложениях они зачастую загружаются из внешнего источника.
Для загрузки ХМL-данных из внешнего источника в экземпляр класса XML используйте такую последовательность действий.
Создайте объект URLReques t, описав местоположение внешних данных XML (это может быть либо файл, либо серверный сценарий, возвращающий данные в формате XML).
Создайте объект URLLoader и используйте его метод load ( ) для загрузки данных XML.
Подождите, пока загрузятся данные XML.
Передайте загруженные данные XML в конструктор нового экземпляра класса XML.
Хотя подробное рассмотрение классов URLRequest и URLLoader выходит за рамки этой главы, в листинге 18.13 представлен код, необходимый для загрузки XML-данных в экземпляр класса XML. Используемый в примере класс XMLLoader расширяет класс Sprite, чтобы его можно было откомпилировать в качестве основного класса приложения для тестирования. Информацию о классах URLRequest и URLLoader можно найти в справочнике по языку ActionScript корпорации Adobe. Информацию об обработке событий можно получить в гл. 12.•
Листинг 18.13. Загрузка данных XML из внешнего источника
package {
Import fl ash.di splay.*;
import fl ash.events.*;
import flash.net.*;
// Демонстрирует код, необходимый для загрузки XML-данных
// из внешнего источника
public class XMLLoader extends Sprite {
// Переменная, которой будут присвоены загруженные XML-данные private var novel:XML;
// Объект, используемый для загрузки XML-данных
private var urlLoader:URLLoader;
// Конструктор
public function XMLLoader ( ) {
// Указываем местоположение внешнего источника XML-данных
var urlRequest:URLRequest = new URLRequest("novel.xml");
// Создаем объект, который умеет загружать внешние текстовые данные urlLoader = new URLLoader( );
// Регистрируем обработчик, чтобы получить событие об окончании
// загрузки XML-данных
urlLoader.addEventL1stener(Event.COMPLETE, completeListener);
// Загружаем XML-данные
urlLoader.1oad(ur1 Request);
}
// Метод, вызываемый автоматически по окончании загрузки XML-данных private function completeListener(e:Event):void {
// Строка, содержащая загруженные XML-данные, присваивается переменной
// data объекта URLLoader (то есть urlLoader.data). Чтобы создать
// новый экземпляр класса XML из этой загруженной строки, мы передаем
// ее в конструктор класса XML
novel = new XML(urlLoader.data);
trace(novel.toXMLString( )); // Отображаем загруженные XML-данные, // преобразованные в объект XML }
}
Обратите внимание, что все операции загрузки данных в языке ActionScript, включая операцию, представленную в листинге 18.13, попадают под действие ограничений безопасности приложения Flash Player. Полную информацию об ограничениях безопасности можно найти в гл. 19.
Использование пространств имен XML
В языке XML пространства имен используются для предотвращения конфликтов имен в разметке, а конечной целью их использования является возможность мирного сосуществования разметок из различных XML-словарей в одном документе.
В языке ActionScript пространства имен поддерживаются и как часть расширения Е4Х, и как базовый инструмент программирования. В этом разделе описываются приемы работы с пространствами имен при помощи синтаксиса расширения Е4Х, но предполагается, что вы знакомы с базовыми концепциями, изложенными в определении пространств имен консорциума W3C для языка XML. Данная информация изложена на следующих интернет-страницах:
статья Рональда Бурета (Ronald Bouret) «XML Namespaces FAQ»: http://www.
rpbourret.com/xml/NamespacesFAQ.htm;
рекомендации консорциума W3C «Namespaces in XML 1.1»: http://www.w3.org/ TR/xml-namesll/;
статья Дэвида Мартсона (David Martson) «Plan to use XML namespaces, Part 1»: http ://www-128. ibm.com/developerworks/libra ry/x-nmspace.html.
Информацию об использовании не относящихся к языку XML пространств имен в программировании на языке ActionScript можно найти в гл. 17.
Обращение к элементам и атрибутам, уточненным пространствами имен
Ранее рассказывалось, как обращаться к элементам и атрибутам, которые не уточняются пространством имен. Чтобы познакомиться с дополнительными способами, необходимыми для обращения к элементам и атрибутам, уточненным пространством имен, рассмотрим новый пример XML-фрагмента, приведенный в листинге 18.14. Фрагмент представляет собой часть гипотетического каталога мебели. Просматривая пример, обратите внимание на следующие детали, относящиеся к пространствам имен:
идентификатор URI http://www.example.com/furniture и сопутствующий префикс shop;
пространство имен по умолчанию http: //www.w3.org/1999/xhtml;
три элемента, которые квалифицированы пространством имен http: / / www . example . сот/furniture: <shop : table>, <shop : desc> и <shop : price>;
один атрибут, уточненный пространством имен http: //www. example. com/ furniture: shop: id.
Листинг 18.14. Использование пространств имен в каталоге мебели
var catalog:XML = <html xmlns:shop="http://www.example.com/furn1ture"
xmlns="http://www.w3.org/1999/xhtml">
<head>
<t1tle>Catalog</t1tle>
</head>
<body>
<shop:table shop:1d="4875">
<table border="l">
<tr a!1gn="center">
<td>Item</td>
<td>Pr1ce</td>
</tr>
<tr al1gn="left">
<td><shop:desc>3-legged Coffee Table</shop:desc></td>
<td><shop:pr1ce>79.99</shop:p r1ce></td>
</tr>
</table>
</shop:table>
</body>
</html>
В листинге 18.14 в основном представлен XHTML-документ, предназначенный для отображения в браузерах, но кроме этого он содержит разметку, представляющую предметы из каталога мебели. Разметка каталога мебели придает документу семантическую структуру, позволяя обрабатывать этот документ не только браузерами, но и другими клиентами. В каталоге используется пространство имен, чтобы устранить неоднозначность между разметкой XHTML и разметкой каталога мебели. Как результат, элемент <table> может представлять, с одной стороны, предмет мебели (стол), а с другой — графический элемент макета веб-страницы. При этом конфликты имен отсутствуют.
Для обращения к уточненным пространствам имен элементам и атрибутам из листинга 18.14 мы должны сначала получить ссылку на используемые пространства имен. Чтобы получить ссылку на пространство http: / /www. example .сот/ furniture, мы вызываем метод экземпляра namespace ( ) класса XML над корневым узлом документа, передавая в качестве аргумента префикс ’’shop”. В результате метод name space ( ) возвращает объект Name spa се, представляющий пространство имен http://www.example.com/furniture. Мы присваиваем этот объект переменной shopNS для дальнейшего использования.
var shopNS:Namespace = catalog. namespaceCshop");
В качестве альтернативы, если известен идентификатор URI пространства имен, можно создать ссылку на объект Namespace, используя конструктор одноименного класса:
var shopNS:Namespace = new Namespace("http://www.example.com/furn1ture");
Чтобы получить ссылку на пространство имен, используемое по умолчанию, мы вызываем метод namespace ( ) над корневым узлом документа, не передавая префикс пространства имен:
var htmlNS:Namespace = catalog.namespace( ):
В качестве альтернативы, если известен идентификатор URI пространства имен, мы можем создать ссылку на объект Namespace, используемый по умолчанию, с помощью конструктора одноименного класса:
var htmlNS:Namespace = new NamespaceChttp://www.w3.org/1999/xhtml");
Для обращения к пространствам имен документа могут использоваться и методы inScopeNamespaces ( ) и namespaceDeclarations ( ). Дополнительную информацию можно найти в справочнике по языку ActionScript корпорации Adobe.
В расширении Е4Х атрибуты пространств имен XML не представляются в виде атрибутов (то есть к ним нельзя обратиться с помощью метода attributes() или выражения некий- Элемент.©*). Вместо этого для обращения к объявлениям пространств имен элемента применяется метод экземпляра namespaceDeclarations() класса XML.
Теперь, когда у нас есть ссылка на объект Namespace, мы можем обращаться к уточненным пространством имен элементам и атрибутам, используя уточненные имена в следующем общем формате:
пространствоИмен: ;локальноеИмяЭлемента
пространствоИмен::^локальноеИмяАтрибута
Например, вот так записывается уточненное имя элемента <shop: price> в коде на языке ActionScript:
shopNS::pr1ce
Обратите внимание на использование оператора уточнителя имени (: :), который отделяет имя пространства имен от локального имени.
Вот так можно обратиться к элементу <body>, который уточняется пространством имен по умолчанию (http: //www. w3 . org/1999/xhtml):
catalog.htmlNS::body
Для обращения к элементу <shop:table>, который является ребенком элемента
<body>, используется следующая запись:
catalog.htmlNS: -.body.shopNS::table•
Для обращения к атрибуту shop: id используется такая запись:
catalog.htmlNS::body.shopNS::table.@shopNS::1d
Для обращения к элементу <shop:price> мы можем использовать следующий «кошмарный» код:
catalog.htmlNS::body.shopNS: -.table.htmlNS::table.htmlNS: :tr[
.htmlNS::td[l].shopNS::price
Однако мы будем спать спокойнее, если воспользуемся преимуществом оператора «потомок» (. .) в двух местах, как показано в следующем коде:
catalog. .shopNS: -.table. .shopNS: :pr1ce
И все равно повторное использование shopNS: : слегка раздражает. Мы можем избежать нескольких лишних нажатий клавиш, попросив язык ActionScript автоматически уточнять все неуточненные имена элементов и атрибутов с помощью
выбранного пространства имен. Для этого мы используем инструкцию назначения пространства имен XML по умолчанию, которая имеет следующий вид:
default xml namespace = пространствоИменИлиСтрокаий!
Например, следующий код заставляет язык ActionScript автоматически уточнять все неуточненные имена элементов и атрибутов с помощью пространства имен http://www.example.com/furniture:
default xml namespace = shopNS:
После выполнения этой инструкции пространство имен http: / / www. example. сот/ furniture применяется ко всем неуточненным ссылкам на элементы и атрибуты, поэтому мы можем сократить следующий код:
catalog..shopNS::table..shopNS::pr1ce
до записи:
catalog..table..price
Из-за ошибки в приложении Flash Player 9 при выполнении предыдущего примера кода (catalog..table..price) в первый раз возвращается значение undefined.
В более полном примере документ каталога, скорее всего, будет содержать несколько элементов <shop: tablex Для обращения к определенному столу нам придется использовать фильтрующий предикат, как показано в следующем коде:
catalog..table.(@id == 4875)..price
В листинге 18.15 приведен код, который можно использовать для обращения и отображения информации обо всех столах из каталога.
Листинг 18.15. Отображение всех столов из каталога
var shopNS:Namespace = catalog.namespaceCshop"):
default xml namespace = shopNS:
for each (var table:XML in catalog..table) { trace(table..desc + ": " + table..price):
Как и в случае с именами элементов и атрибутов, мы можем использовать групповой символ свойств (*) с пространствами имен. Например, следующий код возвращает объект XMLList, представляющий все элементы <table> во всех пространствах имен:
catalog..*:: table
Чтобы получить всех потомков на всех уровнях иерархии во всех пространствах имен или за пределами пространства имен, применяется следующий код: объектХМЬ .*: :*// элементы
объектХМк. .@*: :* // атрибуты
Чтобы получить всех детей во всех пространствах имен или за пределами пространства имен, используется такой код:
объектХМЬ*::*// элементы
объектХМЬ.^: :* // атрибуты
Создание элементов и атрибутов, уточняемых пространствами имен
Для создания элементов и атрибутов, которые уточняются пространствами имен, мы используем синтаксис обращения к уточненным именам, рассмотренный в предыдущем разделе, вместе с методиками создания элементов и атрибутов, описанными в разд. «Изменение или создание нового содержимого XML».
Перед созданием имен, уточняемых пространствами имен, мы должны создать (или получить) ссылку на объект Namespace. Например, следующий код создает два объекта Namespace и присваивает их переменным htmlNS и shopNS для дальнейшего использования в уточненных именах:
var html NS‘.Namespace = new NamespaceChtml".
"http://www.w3.org/1999/xhtml"):
var shopNS:Namespace = new NamespaceC'shop".
"http ://www. exampl e. com/furniture"):
Когда создается не один элемент или атрибут, а целый документ, обычно (и это более удобно) применяется пространство имен по умолчанию, которое указывается в инструкции default XML namespace. Например, следующий код в качестве пространства имен по умолчанию устанавливает http: / / www. w3 . org/1999/xhtml: default xml namespace = htmlNS:
Как только будет установлено пространство имен по умолчанию, все вновь создаваемые элементы (но не атрибуты), для которых пространство имен не указано явным образом, будут автоматически уточняться с помощью пространства имен по умолчанию. Например, следующий код создает элемент с локальным именем "html"; для него явно не указано пространство имен, поэтому это имя автоматически уточняется с помощью пространства имен по умолчанию (http: / / www. w3 . org/1999/xhtml):
var catalog:XML = <html/>;
Данная строка кода генерирует следующий исходный код XML:
<html xmlns="http://www.w3.org/1999/xhtml" />
Чтобы добавить объявление пространства имен к указанному элементу, используется метод экземпляра addNamespace ( ) класса XML. Например, следующий код добавляет объявление нового пространства имен к предыдущему элементу:
catalog.addNamespace(shopNS):
Результирующий исходный код XML выглядит так:
<html xml ns:shop="http://www.example.com/furniture" xmlns="http://www.w3.org/1999/xhtml" />
Возможно, вы узнали приведенный элемент — это первая строка кода из документа каталога, представленного в листинге 18.14. Достроим оставшуюся часть этого документа. Вот теги <head> и <title>. Их имена автоматически уточняются пространством имен по умолчанию (http: //www. w3 . org/1999/xhtml).
catalog.head.title = "Catalog";
Теперь создадим элемент <shop: table> и его атрибут shop: id. Их имена уточняются пространством имен http: //www. example . сот/furniture. Мы хотим получить исходный код XML, который выглядит следующим образом:
<shop:table shop:id="4875">
Для того чтобы создать данный элемент, воспользуемся следующим кодом на языке ActionScript:
catalog.body.shopNS: .-table = "":
catalog.body.shopNS::tabi e.@shopNS::id = "4875":
Приведенный код вам должен быть знаком. За исключением синтаксиса уточнителя пространства имен shopNS : :, он аналогичен коду, который мы использовали ранее для создания элементов и атрибутов. Уточнитель пространства имен просто задает пространство для локальных имен table и id. В листинге 18.16 применяется та же методика для создания оставшейся части документа каталога. В примере обратите внимание на следующую строку кода:
catalog.body.shopNS::table.table.tr.td[l] = "Price":
Она создает новый элемент с именем "td" непосредственно за существующим элементом catalog. body. shopNS : : table . table . tr. td [ 0 ].
Листинг 18.16. Создание каталога мебели
// Создание пространств имен
var htmlNS:Namespace = new Namespace("html",
"http://www.w3.org/1999/xhtml");
var shopNS:Namespace = new NamespaceC'shop",
"http://www.example.com/furni ture"):
// Задание пространства имен по умолчанию default xml namespace = htmlNS:
// Создание корневого элемента var catalog:XML = <html/>;
// Добавление пространства имен furniture к корневому элементу catalog.addNamespace(shopNS):
// Создание оставшейся части документа
catalog.head.title = "Catalog":
catalog.body.shopNS::table = "":
catalog.body.shopNS:-.table.@shopNS::id = "4875":
catalog.body.shopNS: .-table.table = "":
catalog.body.shopNS::table.table.@border = "1":
catalog.body.shopNS::table.table.tr.td = "Item":
catalog.body.shopNS::table.table.tr.td[l] = "Price":
catalog.body.shopNS: .-table.table.tr.@align = "center":
catalog.body.shopNS::table.table.tr[l] = "":
catalog.body.shopNS::table.table.tr[l].@align = "left":
catalog.body.shopNS::table.tabie.tr[1].td.shopNS::desc =
"3-1 egged Coffee Table":
catalog.body.shopNS::table.table.tr[l].td[l] = "":
catalog.body.shopNS: :table.table.tr[l] .td[l] .shopNS: .-price = "79.99":
Вот мы и рассмотрели все важнейшие темы, касающиеся расширения Е4Х. В оставшейся части этой главы будут рассмотрены два дополнительных вопроса: преобразование и равенство данных XML.
Преобразование объектов XML и XMLList в строки
Как мы уже видели на протяжении этой главы, расширение Е4Х реализует собственные правила для преобразования экземпляров классов XML и XMLList в строку. Для информации в этом разделе описываются правила расширения Е4Х, применяемые для преобразования объектов XML и XMLList в строку. Не забывайте, что экземпляр класса XML может представлять пять различных типов содержимого: элемент, атрибут, текстовый узел, комментарий или инструкцию обработки. Мы рассмотрим правила преобразования для каждого типа в отдельности, но начнем с рассмотрения преобразования объекта XMLList в строку, чтобы подготовиться к дальнейшему обсуждению.
Преобразование объекта XMLList в строку
Когда объект XMLList содержит один-единственный экземпляр класса XML, результат вызова метода toString( ) класса XMLList полностью совпадает с результатом вызова метода toString ( ) над этим единственным экземпляром класса XML. Например, в следующем коде переменная title ссылается на объект XMLList, чей единственный экземпляр класса XML представляет элемент <TITLE>. В результате преобразования значения переменной title в строку возвращается значение Ulysses — именно оно было бы получено в результате вызова метода toString ( ) непосредственно над единственным экземпляром класса XML:
var novel:XML = <ВООК ISBN="0141182806">
<TITLE>Ulysses</TITLE>
<AUTHOR>Joyce, James</AUTHOR>
<PUBLISHER>Pengu1n Books Ltd</PUBLISHER>
</BOOK>•
// Создаем объект XMLList с одним-единственным экземпляром класса XML var t1tle:XMLL1st = novel.TITLE:
// Преобразуем объект XMLList в строку и отображаем ее.
trace(tltle): // Отображает: Ulysses
Когда объект XMLList содержит несколько экземпляров класса XML, вызов метода toString ( ) класса XMLList возвращает строку, которая получается в результате вызова метода toXMLS tring ( ) над каждым экземпляром класса XML и объединения содержимого этих экземпляров, при этом содержимое каждого экземпляра размещается на отдельной строке. Например, в следующем коде объект XMLList, присваиваемый переменной details, содержит три экземпляра класса XML, которые представляют три элемента — <TITLE>, <AUTHOR> и <PUBLISHER>:
// Создаем объект XMLList с тремя экземплярами класса XML var details:XMLList = novel.*:
Преобразование значения переменной details в строку возвращает исходный код ХМЕдля элементов <TITLE>, <AUTHOR> и <PUBLISHER>:
// Преобразуем объект XMLList в строку и отображаем ее trace(detalls); // Выводит:
// <TITLE>Ulysses</TITLE>
// <AUTHOR>Joyce. James</AUTHOR>
// <PUBLISHER>Pengu1n Books Ltd</PUBLISHER>
Преобразование элемента XML в строку
Для экземпляров класса XML, представляющих элементы, метод toSt ring ( ) этого класса возвращает один из двух результатов в зависимости от содержимого данного элемента. Если элемент содержит детей, метод toS t г ing ( ) класса XML возвращает исходный XML-код для этого элемента и его детей, отформатированный в соответствии с настройками переменных XML. ignoreWhitespace, XML. prettyPrinting и XML. pre tty Indent. Например, в следующем коде элемент <ВООК> имеет три элемента-ребенка (<TITLE>, <AUTHOR> и <PUBLISHER>):
var novel:XML = <BOOK ISBN=,,0141182806">
<TITLE>Ulysses</TITLE>
<AUTHOR>Joyce, James</AUTHOR>
<PUBLISHER>Penguin Books Ltd</PUBLISHER>
</BOOK>;
Преобразование этого элемента в строку вернет исходный XML-код:
trace(novel.toStr1ng( )); //Отображает:
// <ВООК ISBN="0141182806">
// <TITLE>Ulysses</TITLE>
// <AUTHOR>Joyce, James</AUTHOR>
// <PUBLISHER>Penguin Books Ltd</PUBLISHER>
// </BOOK>;
Для элемента, не имеющего детей, метод toString( ) класса XML вернет текст, содержащийся в этом элементе, без открывающего и закрывающего тегов. Например, следующий код преобразует элемент <TITLE> в строку. Результатом является строка Ulysses, а не <TITLE>Ulysses</TITLE>.
trace(novel.TITLE.toStr1ng( )): // Выводит: Ulysses
Если мы хотим получить строку, включающую текстовый узел и окружающие его теги, используется метод toXMLString ( ) класса XML, как показано в следующем коде: trace(novel.TITLE.toXMLString( )): // Выводит: <TITLE>Ulysses</TITLE>
Стоит отметить, что правила преобразования строк для элементов XML, определенные в расширении Е4Х, изменяют способ обращения к концевым текстовым узлам в языке ActionScript. В языках ActionScript версий 1.0 и 2.0 для обращения к текстовым узлам использовалась переменная экземпляра first Chi Id класса XML (которая теперь, в языке ActionScript 3.0, является переменной экземпляра firstChild класса XMLDocument). Например, устаревшим эквивалентом следующей инструкции расширения Е4Х:
trace(novel.TITLE.toStr1ng( )):
будет являться:
t гасе(novel.f 1rstChl1d.f1rstChi 1d.f1rstChlId);
В расширении E4X к тексту элемента, не имеющего элементов-детей, в контексте строки можно обратиться непосредственно через имя этого элемента. Вот еще два примера кода с использованием расширения Е4Х (на этот раз мы опустили явный вызов метода toString ( ), поскольку среда Flash автоматически вызывает этот метод над любым аргументом, передаваемым в функцию trace ( ) ):
trace(novel.AUTHOR);// Выводит: Joyce. James
tracetnovel.PUBLISHER): // Выводит: Penguin Books Ltd
Далее представлено прямое сравнение устаревшего метода доступа к текстовым узлам с аналогичным методом доступа расширения Е4Х:
// Доступ к текстовому узлу в расширении Е4Х var msg:XML = <GREETING>
<TO>World</TO>
<FROM>J. Programmer</FROM>
<MESSAGE>Hello</MESSAGE>
</GREETING>
trace(msg.TO);//Выводит:World
trace(msg.FROM);//Выводит:J. Programmer
trace(msg.MESSAGE): // Выводит: Hello
// Устаревший метод доступа к текстовому узлу
var msgDoc:XMLDocument = new XMLDocument("<GREETING>"
+ "<TO>World</TO>"
+ "<FROM>J. Programmer</FROM>"
+ "<MESSAGE>Hello</MESSAGE>"
+ "</GREETING>"):
trace(msgDoc.f1rstChild.f1rstChlld.f1rstChl1d):// Выводит: World
tracetmsgDoc.f1rstChlld.ch1ldNodes[l].firstChlId); // Выводит: J. Programmer trace(msgDoc.f1 rstChl 1 d.chi* 1 dNodesE2J.f1 rstChl 1 d): // Выводит: Hello
Преобразование атрибута в строку
Для экземпляров класса XML, которые представляют атрибуты, метод toString ( ) возвращает только значение этого атрибута, а не все его определение целиком. Например, следующий код преобразует атрибут ISBN предыдущего элемента <ВООК> в строку. Результатом преобразования является строка 0141182806, а не ISBN=’0141182806'.
trace(novel.@ISBN.toStr1ng( )); // Выводит: 0141182806
Прввбразввание квмментариев и инструкций вбрабвтки в стрвки
Когда метод toString ( ) класса XML вызывается над экземпляром класса XML, представляющим комментарий или инструкцию обработки, этот комментарий или инструкция обработки возвращается целиком:
XML.IgnoreComments = false;•
XML.1gnoreProcessingInstruct1ons = false;
// Создаем фрагмент XML, включающий и комментарий, и инструкцию обработки
// (выделены полужирным шрифтом)
var novel:XML = <ВООК ISBN="0141182806">
<1--Это комментарий-->
<?someTargetApp someData?>
<TITLE>Ulysses</TITLE>
<AUTHOR>Joyce, James</AUTHOR>
<PUBLISHER>Penguin Books Ltd</PUBLISHER>
</BOOK>;
// Преобразуем комментарий в строку.-
// Выводит: <■—Это комментарий-->
trace(novel.comments( )[ОJ.toString( ));
// Преобразуем инструкцию обработки в строку.
// Выводит: <?someTargetApp someData?>
traceCnovel .process1nglnstructions( )[0].toString( )):
Определение равенства в расширении Е4Х
В этом разделе рассматриваются специальные правила языка ActionScript для определения равенства объектов XML, XMLList, QName и Namespace. Стоит отметить, однако, что представленная информация применима только к оператору равенства (==) — она не касается оператора строгого равенства (===). Расширение Е4Х не изменяет семантику оператора строгого равенства. В частности, этот оператор считает два экземпляра класса XML, XMLList — QName или Namespace — равными тогда, и только тогда, когда они указывают на одну и ту же объектную ссылку.
Равенство объектов XML
Оператор равенства (==) считает два экземпляра класса XML, представляющие элементы, равными, если они представляют одну и ту же иерархию XML. Например, в следующем коде переменные х1 и х2 указывают на различные объектные ссылки, но считаются равными, поскольку представляют одну и ту же иерархию XML:
van xl:XML = <a><b></b></a>:
var x2:XML = <a><b></b></a>:
trace(xl == x2); // Выводит: true
По умолчанию расширение E4X игнорирует пробельные узлы, поэтому два экземпляра класса XML, представляющие элементы, считаются равными, когда имеют одинаковую разметку, даже если используется различное форматирование. Например, в следующем коде исходный XML-код для экземпляра класса XML, хранящегося в переменной xl, не содержит пробельные узлы, в отличие от исходного XML-кода для экземпляра класса XML, хранящегося в переменной х2, который содержит два пробельных узла. Однако, несмотря на это различие, экземпляры по-прежнему
считаются равными, поскольку пробельные символы игнорируются — это значит, что иерархии XML остаются одинаковыми.
var xl:XML = <a><b></b></a>:
var x2:XML = <a>
<b></b>
</a>;
tracetxl == x2): // По-прежнему выводит: true
Если перед парсингом кода XML мы скажем среде Flash учитывать пробельные узлы, экземпляры класса XML из предыдущего примера больше не будут считаться равными, как показано в следующем коде:
XML.1gnoreWhltespace = false: // Не игнорировать пробельные узлы
var xl:XML = <a><b></b></a>:
var x2:XML = <a>
<b></b>
</a>:
tracetxl == x2); // Теперь выводит: false
Экземпляр класса XML, представляющий элемент, считается равным экземпляру класса XML, представляющему атрибут, если элемент не имеет элементов-детей и содержащийся в нем текст совпадает со значением атрибута. Например, в следующем коде атрибут QUANTITY считается равным элементу <COST>, поскольку элемент <COST> не имеет элементов-детей и содержит текст, который совпадает со значением атрибута QUANTITY:
var product:XML = <PRODUCT QUANTITY="1"><COST>1</COST></PRODUCT>: trace(product.@QUANTITY == product.COST); // Выводит: true
Подобным образом экземпляр класса XML, представляющий элемент, считается равным экземпляру класса XML, представляющему текстовый узел, если элемент не имеет элементов-детей и содержащийся в нем текст совпадает со значением текстового узла. Например, в следующем коде текстовый узел, содержащийся в элементе <COST>, считается равным элементу <QUANTITY>, поскольку второй элемент не имеет элементов-детей и содержит текст, который совпадает со значением текстового узла-ребенка первого элемента:
var product:XML = <PRODUCT>
<COST>1</COST>
<QUANTITY>1</QUANTITY>
</PRODUCT>;
trace(product.COST.*[0] == product.QUANTITY): // Выводит: true
Во всех остальных случаях, если типы узлов двух экземпляров класса XML отличаются, эти два экземпляра считаются разными. Когда типы узлов совпадают, два экземпляра считаются равными, если типом обоих узлов является:
«атрибут», а значения атрибутов совпадают;
«текст», а текст узлов совпадает;
«комментарий», а текст, расположенный между открывающими и закрывающими разделителями комментария (<! — и —>), совпадает;
«инструкция обработки», а текст, расположенный между открывающими и закрывающими разделителями инструкции обработки (<? и ?>), совпадает.
Равенство объектов XMLList
Чтобы определить, являются ли два экземпляра класса XMLList равными, среда выполнения Flash сравнивает по порядку все экземпляры в этих объектах, используя правила определения равенства объектов XML, которые были рассмотрены в предыдущем разделе. Если хотя бы один элемент из первого экземпляра класса XMLList не равен соответствующему элементу из второго экземпляра, два экземпляра класса XMLList считаются неравными. Например, в следующем коде объект XMLList, возвращаемый выражением msgl. *, считается равным объекту XMLList, возвращаемому выражением msg2 . *, поскольку каждый экземпляр класса XML из результата выражения msgl. * считается равным экземпляру класса XML в соответствующей позиции из результата выражения msg2 .
var msgl:XML = <GREETING>
<TO>World</TO>
<FROM>J. Programmer</FROM>
<MESSAGE>Hello</MESSAGE>
</GREETING>:.
var msg2:XML = <GREETING>
<TO>World</TO>
<FROM>J. Programmer</FROM>
<MESSAGE>Hel1o</MESSAGE>
</GREETING>:
traceCmsgl.* == msg2.*); // Выводит: true
Экземпляр класса XML и объект XMLList, содержащий один-единственный экземпляр класса XML, сравниваются точно так же, как два экземпляра класса XML:
trace(msgl.FROM == msg2.*[l]); // Выводит: true
Это значит, что оператор равенства (==) считает объект XMLList с одним-един- ственным экземпляром класса XML равным этому экземпляру!
tracetmsgl.FROM == msgl.FROMEOJ): И Выводит: true
Чтобы отличить объект XMLList, содержащий один-единственный экземпляр класса XML, от этого экземпляра, используйте оператор строгого равенства (===):
trace(msgl.FROM === msgl.FR0MEOJ): // Выводит: false
Равенство объектов QName
Класс QName представляет имя элемента или атрибута, уточняемое пространством имен. Два экземпляра класса QName считаются равными, если их названия пространств имен и локальные имена совпадают (то есть они имеют одинаковые значения переменных uri и localName). Например, следующий код создает объект QName с помощью конструктора класса QName и сравнивает этот объект с объектом QName, полученным из XML-документа. Оба объекта QName имеют одинаковые названия пространств имен и локальные имена, поэтому считаются равными.
var product:XML = <someCorp:PRODUCT
xml ns:someCorp="http://www.example.com/someCorp"><someCorp:PRICE>99.99</someCorp:PRICE>
</someCorp:PRODUCT>;
var someCorp:Namespace = product. namespaceCsomeCorp");
var qnl:QName = new QNameC'http://www.example.com/someCorp", "PRICE");
var qn2:QName = product.someCorp:.PRICE.name( );
trace(qnl == qn2): // Выводит: true
Равенство объектов Namespace
Класс Name spa се представляет уточняющую часть имени, которое уточняется с помощью пространства имен. Два объекта Namespace считаются равными тогда, и только тогда, когда они содержат одно и то же название пространства имен (то есть когда их переменные uri хранят одно и то же значение), независимо от префикса. Например, следующий код создает объект Name space с помощью конструктора класса Name space и сравнивает созданный объект с объектом Name spa се, полученным из XML-документа. Оба объекта Namespace содержат один и тот же идентификатор URI, поэтому считаются равными, несмотря на то, что префиксы отличаются.
var product:XML = <someCorp:PRODUCT
xml ns:someCorp="http://www.example.com/someCorp"> <someCorp:PRICE>99.99</someCorp:PRICE>
</someCorp:PRODUCT>;
var nsl:Namespace = product. namespaceCsomeCorp"):
var ns2:Namespace = new NamespaceCsc". "http://www.example.com/someCorp"): trace(nsl == ns2): // Выводит: true
Дальнейшее изучение
В этой главе была рассмотрена большая часть основной функциональности расширения Е4Х, однако исчерпывающее описание выходит за рамки данной книги. Для дальнейшего изучения посмотрите на описание методов и переменных классов XML и XMLList в справочнике по языку ActionScript корпорации Adobe. Все технические детали можно найти в спецификации расширения Е4Х по адресу http://www.ecma-international.org/publications/standards/Ecma-357.htm.
Далее по программе — знакомство с ограничениями безопасности приложения Flash Player. Если изучение этой темы не кажется вам приятным занятием, можете перейти сразу к части II, где будут рассматриваться вопросы отображения содержимого на экране. Просто помните, что если в процессе разработки вы столкнетесь с ошибками безопасности, глава 19 поможет вам решить появившиеся проблемы.
Ограничения безопасности Hash Player
Чтобы предотвратить передачу данных несанкционированным получателям без соответствующего разрешения, приложение Flash Player тщательно проверяет все запросы на загрузку или на доступ к внешним ресурсам либо на взаимодействие с другими SWF- или HTML-файлами. Любой запрос к внешнему ресурсу из SWF-файла (к ресурсу, который не является частью скомпилированного SWF-файла, осуществляющего запрос), отвергается или принимается на основании таких факторов, как:
операция языка ActionScript, используемая для доступа к ресурсу;
статус безопасности SWF-файла, выполняющего запрос;
местоположение ресурса;
набор явных прав доступа для ресурса, которые определены либо создателем ресурса, либо его распространителем;
явные права доступа, предоставленные пользователем (например, разрешение на подключение к камере или микрофону пользователя);
тип приложения Flash Player, выполняющего SWF-файл (например, версия встраиваемого расширения, автономная версия, отладочная версия среды разработки Flash).
В предыдущем списке и на протяжении всей этой главы будут использоваться следующие термины.
Распространитель ресурса — сторона, которая занимается распространением данного ресурса. Обычно это оператор сервера, например администратор сайта или сокетного сервера.
Создатель ресурса — сторона, которая фактически является автором ресурса. Для SWF-файлов создателем ресурса является разработчик на языке ActionScript, который скомпилировал данный SWF-файл.
Пользователь — пользователь компьютера, на котором выполняется приложение Flash Player.
В этой главе сначала рассматриваются ограничения безопасности приложения Flash Player в общих чертах, после чего описывается конкретное влияние безопасности на загрузку содержимого и на обращение к внешним данным.
В этой главе мы рассмотрим ограничения безопасности одной конкретной среды Flash: приложения Flash Player (версии, реализованной в виде модуля расширения браузера, и автономной версии). Информацию об ограничениях безопасности, налагаемых другими средами выполнения Flash (например, приложениями Adobe AIR и Flash Lite), можно найти в документации корпорации Adobe.
Чего нет в этой главе
Перед тем как перейти к изучению материала, проясним один момент: безопасность — это очень обширная тема. Всестороннее рассмотрение безопасности приложения Flash Player выходит за рамки этой книги. Более того, в этой главе рассматриваются функции безопасности, предназначенные лишь для защиты пользователей Flash-содержимого, но не обсуждаются вопросы разработки защищенных приложений, например сайтов для электронной коммерции. Гораздо более полную информацию о безопасности, включая вопросы разработки защищенных приложений, например использование протокола Secure Sockets Layer (SSL), создание собственных алгоритмов шифрования и защиту данных, передаваемых по протоколу RTMP, можно найти в таких ключевых ресурсах, как:
документация корпорации Adobe, раздел Programming ActionScript 3.0 ► Flash Player APIs ► Flash Player Security;.
«Центр по вопросам безопасности» (Security Topic Center) корпорации Adobe: http://www.adobe.com/devnet/security/;
технический документ корпорации Adobe, посвященный безопасности: http:// www.adobe.com/go/fp9_0_security;
статья «Security Changes in-Flash Player 8» Денеба Мекеты (Deneb Meketa), в основном посвященная локальной безопасности: http://www.adobe.com/devnet/ flash/articles/fplayer8_security.html;
статья «Security Changes in Flash Player 7» Денеба Мекеты, в основном посвященная файлам политики безопасности: http://www.adobe.com/devnet/flash/ articles/fplayer_security.html;
интерактивная справка приложения Flash Player корпорации Adobe, где описываются настройки безопасности, доступные пользователям: http://www.adobe. com/support/documentation/en/flashplayer/help/index.html.
Теперь посмотрим, как безопасность приложения Flash Player влияет на загрузку содержимого и на доступ к внешним данным.
Локальная область действия, удаленная область действия и удаленные регионы
Как будет видно на протяжении этой главы, ограничения безопасности среды выполнения Flash зачастую основываются на местоположении SWF-файлов и внешних ресурсов. Оценивая местоположение ресурса с точки зрения безопасности, среда Flash различает ресурсы в удаленных местоположениях и ресурсы в локальных местоположениях.
В этой главе мы будем использовать термин «удаленная область действия» в отношении логической группы всех возможных удаленных местоположений, например Интернета. Соответственно мы будем использовать термин «локальная область действия» в отношении логической группы всех возможных локальных местопо-
ложений. Локальное местоположение — это любое местоположение, к которому может обратиться пользователь компьютера, выполняющего приложение Flash Player либо с помощью протокола file: (обычно применяется для обращения к локальной файловой системе), либо с помощью пути, соответствующему универсальному соглашению об именах (UNС — universal naming convention) (обычно применяется для обращения к компьютерам в локальной сети).
Сама по себе удаленная область действия подразделяется на различные регионы, концептуально ограничиваемые распространителями ресурсов. Мы будем называть такие регионы удаленными. В частности, удаленный регион может являться:
доменом Интернета;
поддоменом Интернета;
IP-адресом, который указывает на компьютер, находящийся в удаленной области действия.
Таким образом, в соответствии с предыдущим списком:
sitea.com и siteb.com, games.example.com и finances.example.com, 192.150.14.120 и 205.166.76.26 — это разные удаленные регионы;
192.150.18.117 и adobe.com — это разные удаленные регионы, несмотря на то что IP-адрес 192.150.18.117 закреплен за доменом adobe.com (поскольку для приложения Flash Player IP-адреса, заданные в числовом виде, и их эквивалентные доменные имена считаются разными).
Термины «удаленная область действия», «локальная область действия» и «удаленный регион» в настоящий момент не являются частью официальной терминологии по безопасности корпорации Adobe. Они используются в этой книге исключительно в пояснительных целях.
Типы безопасности песочниц
Среда выполнения Flash присваивает статус безопасности, называемый типом безопасности песочницы, каждому SWF-файлу, открываемому или загружаемому в приложения Flash Player. Существует четыре возможных типа безопасности песочницы: удаленный (remote), локальный с поддержкой файловой системы (local- with-filesystem), локальный с поддержкой сети (local-with-networking) и локальный с установленным доверием (local-trusted). Каждый тип безопасности песочницы определяет специальный набор правил, который регламентирует возможности SWF-файла по выполнению операций с внешними источниками данных. В частности, к операциям с внешними источниками данных, которые потенциально могут быть запрещены типами безопасности песочниц, относятся:
загрузка содержимого;
обращение к содержимому в виде данных;
кросс-скриптинг;
загрузка данных;
отправка данных на внешний адрес URL;
обращение к камере и микрофону пользователя;
обращение к совместно используемым локальным объектам;
выгрузка и загрузка файлов, выбранных пользователем;
скриптинг HTML-страницы из SWF-файла и наоборот;
подключение к каналу Localconnection.
В этой главе мы увидим, как каждый из перечисленных типов безопасности песочниц влияет на первые пять типов операций с внешними источниками данных из предыдущего списка. Чтобы узнать, как типы безопасности песочниц влияют на оставшиеся типы операций с внешними источниками данных, обратитесь к документации корпорации Adobe — раздел Programming ActionScript 3.0 ► Flash Player APIs ► Flash Player Security.
Стоит отметить, что, если операция завершилась неудачно из-за ограничений безопасности Flash Player, среда Flash сгенерирует либо ошибку Secur it yError, либо выполнит диспетчеризацию события Secur ityErrorEvent. SECURITY ERROR. Более подробную информацию по обработке ошибок безопасности можно найти в разд. «Обработка нарушений безопасности» ближе к концу этой главы.
Как присваиваются типы безопасности песочниц. Чтобы определить тип безопасности песочницы для конкретного SWF-файла, среда выполнения Flash сначала принимает во внимание местоположение, из которого этот SWF-файл был загружен или открыт. Всем SWF-файлам из удаленной области действия присваивается тип безопасности песочницы «удаленный». В отличие от этого, SWF-файлам из локальной области действия присваивается один из оставшихся типов безопасности песочниц — «локальный с установленным доверием», «локальный с поддержкой сети» или «локальный с поддержкой файловой системы». Конкретный тип безопасности песочницы, присваиваемый локальному SWF-файлу, зависит от двух факторов:
была ли включена поддержка сети при компиляции SWF-файла (дополнительную информацию можно найти далее, в разд. «Выбор локального типа безопасности песочницы»);
установлено ли явное доверие для SWF-файла (говорят, что для SWF-файла установлено явное доверие, если этот файл открыт из надежного локального местоположения; дополнительную информацию можно найти далее, в подразд. «Установка локального доверия» разд. «Выбор локального типа безопасности песочницы»).
Всем SWF-файлам из локальной области действия, для которых установлено явное доверие, присваивается тип безопасности песочницы «локальный с установленным доверием». Подобным образом, для исполняемых файлов проектора (то есть отдельных файлов, включающих SWF-файл и определенную версию приложения Flash Player) доверие установлено всегда.
Если для SWF-файлов из локальной области действия не установлено явное доверие, то им присваивается либо тип безопасности песочницы «локальный с поддержкой сети» (для SWF-файлов, которые были откомпилированы с поддержкой сети),
либо тип безопасности песочницы «локальный с поддержкой файловой системы» (для SWF-файлов, откомпилированных без поддержки сети).
Для краткости в этой главе мы будем называть SWF-файлы, которым присвоен тип безопасности песочницы «удаленный», удаленными SWF-файлами. Подобным образом мы будем использовать термины локальный SWF-файл с поддержкой файловой системы, локальный SWF-файл с поддержкой сети и локальный SWF-файл с установленным доверием в отношении SWF-файлов с типами безопасности песочниц «локальный с поддержкой файловой системы», «локальный с поддержкой сети» и «локальный с установленным доверием» соответственно.
Как правило, локальные SWF-файлы с поддержкой сети имеют больше возможностей для доступа к удаленной области действия, чем к локальной области действия. В отличие от этого, локальные SWF-файлы с поддержкой сети имеют больше возможностей для доступа к локальной области действия, чем к удаленной области действия.
Чтобы определить тип безопасности песочницы SWF-файла на этапе выполнения, используйте значение переменной flash.system.Security.sandboxType внутри этого SWF-файла.
Поскольку приложение Flash Player присваивает всем SWF-файлам из удаленной области действия тип безопасности песочницы «удаленный», интернет-разработчи- ки должны всегда учитывать ограничения данного типа безопасности песочницы.
В отличие от этого, разработчики, создающие SWF-содержимое, которое предназначено для локальной загрузки или открытия, могут использовать настройки компилятора, файлы конфигурации, инсталляторы и инструкции для выбора одного из трех локальных типов безопасности песочниц. Выбирая тип безопасности песочницы, такие разработчики фактически определяют для своего содержимого логический набор возможностей для доступа к внешним источникам данных. '
В следующих разделах мы узнаем, как типы безопасности песочниц SWF-файлов влияют на возможности доступа к внешним источникам данных, а затем подробно рассмотрим механизмы (и логическое обоснование) выбора одного из трех локальных типов безопасности песочниц.
Обобщения в вопросах безопасности вредны
В оставшейся части этой главы мы будем очень подробно рассматривать конкретные операции и ограничения безопасности. При описании правил безопасности в этой книге исключены обобщения в ущерб точности, поскольку обобщения в вопросах безопасности зачастую являются источником досадных недоразумений. Помните, что, если в документации или сторонних ресурсах делаются обобщения, касающиеся вопросов безопасности приложения Flash Player, важные исключения могут остаться без должного внимания. Например, следующее утверждение большей частью является справедливым, и поэтому делается заманчивое обобщение: SWF-файл, типом безопасности песочницы которого является «локальный с поддержкой файловой системы», имеет полный доступ к локальной области действия.
Однако из этого утверждения существует множество важных исключений, включая следующие:
локальные SWF-файлы с поддержкой файловой системы не могут подключаться к сокетам;
локальные SWF-файлы с поддержкой файловой системы не могут загружать другие локальные SWF-файлы с поддержкой сети;
локальные SWF-файлы с поддержкой файловой системы не могут обращаться к данным локальных SWF-файлов с установленным доверием без разрешений создателя;
для обращения к пользовательской камере и микрофону требуется разрешение пользователя;
пользователи для любого SWF-файла могут полностью отключить или ограничить возможность сохранения данных в совместно используемых локальных объектах.
Чтобы избежать недоразумений, если в процессе разработки вы столкнетесь с проблемой безопасности, всегда фокусируйтесь на деталях. Определите операцию, которую вы желаете выполнить, тип безопасности песочницы вашего SWF-файла и конкретные ограничения, которые накладывает данный тип безопасности песочницы на выполняемую операцию. Имея на руках эту информацию, вы сможете уверенно работать с любыми ограничениями безопасности или найти способ, чтобы обойти данные ограничения.
В этой главе не рассматриваются абсолютно все ограничения безопасности, налагаемые средой выполнения Flash. Чтобы определить ограничения, которые налагает среда Flash на операции, не рассматриваемые в этой главе, обратитесь к разделам, посвященным данным операциям, в справочнике по языку ActionScript корпорации Adobe.
Теперь рассмотрим, как влияет каждый из четырех типов безопасности песочниц на загрузку содержимого, обращение к содержимому в виде данных, кросс-скриптинг и загрузку данных.
Ограничения на загрузку содержимого, обращение к содержимому о оиде данных, кросс-скриптинг и загрузка данных
Для многих разработчиков первое знакомство с системой безопасности языка ActionScript происходит в тот момент, когда выполняемая операция блокируется из соображений безопасности. В этом разделе будет рассказано о четырех наиболее часто блокируемых внешних операциях: загрузке содержимого, обращении к содержимому в виде данных, кросс-скриптинге и загрузке данных. После этого мы рассмотрим условия, при которых происходит блокировка данных распространенных операций.
Загрузка содержимого
Загрузка содержимого подразумевает получение любого внешнего ресурса для его дальнейшего отображения или воспроизведения. По существу, операции загрузки содержимого позволяют разработчикам представлять внешнее содержимое пользователю даже в тех случаях, когда правила безопасности среды выполнения Flash запрещают программный доступ к данным этого содержимого.
Методы языка ActionScript, относящиеся к операциям «загрузки содержимого» с точки зрения безопасности, перечислены в табл. 19.1.
Таблица 19.1. Операции загрузки содержимого
Метод загрузки содержимого
Тип содержимого
Конкретные форматы файлов, поддерживаемые приложением Flash Player 9
flash.display.Loader.Ioad()
Изображение, файл Adobe Flash
JPEG, GIF, PNG, SWF
flash.media.Sound.load()
Аудио
MP3
flash.net.NetStream.play()
Прогрессивное видео
FLV
Для удобства в этой главе время от времени используется термин «ресурсы содер- жгимого» в отношении ресурсов, загруженных с помощью одного из методов, представленных в табл. 19.1. Стоит отметить, однако, что внешняя операция становится операцией загрузки содержимого благодаря конкретному методу, используемому для загрузки, а не типу файла данного ресурса. Например, загрузка изображения в формате JPEG с помощью метода экземпляра load ( ) класса Loader считается операцией загрузки содержимого, однако загрузка того же JPEG-изображения через бинарный сокет или с помощью метода экземпляра load ( ) класса URLLoader уже не считается операцией загрузки содержимого. Это отличие существенно, поскольку к различным категориям операций применяются различные правила безопасности.
Обращение к содержимому о виде данных
Обращение к содержимому в виде данных подразумевает чтение внутренней информации ресурса содержимого, например чтение пикселов растрового изображения или спектра звука. В табл. 19.2 представлены методы языка ActionScript, которые считаются операциями «обращения к содержимому в виде данных» с точки зрения безопасности.
Таблица 19.2. Обращение к содержимому в виде данных, примеры операций
Операция
Описание
Обращение к изображению через переменную экземпляра content класса Loader
Получает объект Bitmap языка ActionScript, представляющий загруженное изображение
Вызов метода экземпляра draw() класса BitmapData
Копирует пикселы отображаемого элемента в объект BitmapData
Вызов метода экземпляра computeSpectrum() класса SoundMixer
Копирует данные текущей звуковой волны* в объект ByteArray
Обращение к переменной экземпляра id3 класса Sound
Читает метаданные в формате ID3 звукового файла
Кросс-скриптинг
Кросс-скриптинг подразумевает обращение к загруженному SWF-файлу программным путем. Многие операции языка ActionScript могут быть применены для кроссскриптинга SWF-файла, включая следующие, но не ограничиваясь ими:
использование переменной экземпляра content класса Loader для получения объекта, представляющего загруженный SWF-файл;
обращение к переменным загруженного SWF-файла;
вызов методов загруженного SWF-файла;
привязывание к классу, определенному в загруженном SWF-файле;
использование метода экземпляра draw ( ) класса BitmapData для копирования пикселов загруженного SWF-файла в объект BitmapData.
Описание остальных операций кросс-скриптинга можно найти в справочнике по языку ActionScript корпорации Adobe, где явно указаны ограничения безопасности, которые применяются к каждой операции языка ActionScript.
Загрузка данных
В общем смысле термин «загрузка данных» может использоваться для описания широкого спектра операций загрузки приложения Flash Player, включая загрузку файлов с сервера через метод экземпляра download ( ) класса FileRef erence, загрузку объектов с помощью приложения Flash Remoting, загрузку бинарных данных через объект Socket и т. д. Однако для текущего обсуждения (и для оставшейся части данной главы) загрузка данных подразумевает следующее:
загрузку внешнего текста, бинарных данных или переменных с помощью метода экземпляра load ( ) класса URLLoader;
загрузку данных с помощью метода экземпляра load ( ) класса URLStrearn.
Чтобы узнать об ограничениях, налагаемых средой Flash на операции загрузки данных, которые не рассматриваются в этой главе, обратитесь к справочнику по языку ActionScript корпорации Adobe.
Для метода экземпляра load ( ) класса URLLoader формат загружаемых данных (текст, бинарные данные или переменные) задается переменной экземпляра dataFormat класса URLLoader. К обычным текстовым форматам файлов относятся форматы XML, ТХТ и HTML. К обычным форматам бинарных данных относятся изображения, SWF-файлы и сериализованные объекты в формате ActionScript Message Format (AMF). Тем не менее бинарными данными может быть любой файл или содержимое, загруженное в объект ByteArray для дальнейшей обработки в исходном бинарном формате. Переменные загружаются в од- ном-единственном формате: преобразованные в URL-строки переменные, которые были загружены в виде пар «имя/значение» из внешнего текстового файла или сценария.
Стоит отметить, что, как и в случае с загрузкой содержимого, внешняя операция становится операцией загрузки данных благодаря конкретному методу,
используемому для загрузки, а не типу файла данного ресурса. Например, загрузка SWF-файла с помощью метода экземпляра load ( ) класса URLLoader считается операцией загрузки данных; загрузка того же SWF-файла с помощью метода экземпляра load ( ) класса Loader считается операцией загрузки содержимого.
Ограничения на загрузку содержимого, обращение к содержимому в виде данных, загрузку данных и кросс-скриптинг
Теперь, когда мы разобрались, что представляют собой операции загрузки содержимого, обращения к содержимому в виде данных, кросс-скриптинга и загрузки данных, посмотрим, как каждый из четырех типов безопасности песочниц приложения Flash Player ограничивает эти операции.
В следующих четырех таблицах (табл. 19.3-19.6) перечислены условия, при которых каждый тип безопасности песочницы разрешает или запрещает выполнять операции загрузки содержимого, обращения к содержимому в виде данных, кроссскриптинга и загрузки данных. В каждой таблице представлены конкретные правила, устанавливаемые отдельным типом безопасности песочницы, — разрешается или запрещается использовать внешние операции, перечисленные в крайнем левом столбце, для обращения к ресурсам, перечисленным в оставшихся столбцах таблицы.
Как видно из таблиц, некоторые операции допускаются только при наличии разрешения создателя или распространителя. Разрешение создателя подразумевает, что SWF- файл включает надлежащий вызов статического метода allowDomain ( ) класса Security (или, в редких случаях, вызов методаallowInsecureDomain ( ) ). Разрешение распространителя подразумевает, что распространитель ресурса сделал доступным надлежащий файл междоменной политики безопасности. Более подробную информацию можно найти далее, в разд. «Разрешения создателя (allowDomain( ))» и «Разрешения распространителя (файлы политики безопасности)».
Как видно из табл. 19.3-19.6, загрузка содержимого разрешается в большем количестве ситуаций по сравнению с загрузкой содержимого в виде данных, кроссскриптингом и загрузкой данных. Например, приложению может быть дано разрешение на загрузку и отображение растрового изображения, но запрещен доступ к исходным пиксельным данным этого изображения. Подобным образом приложению может быть дано разрешение на загрузку и отображение внешнего SWF- файла, но может требоваться разрешение на кросс-скриптинг этого SWF-файла.
Стоит отметить, что в табл. 19.3-19.6 рассмотрены разрешения только для одного направления взаимодействия, когда SWF-файл загружает или обращается к внешнему ресурсу. В этих таблицах не описано обратное направление взаимодействия, когда загруженный SWF-файл взаимодействует с SWF-файлом, загрузившим его. Информацию по двунаправленному взаимодействию между SWF-файлами можно найти в разделе Programming ActionScript 3.0 ► Flash Player APIs ► Flash Player Security ► Cross-scripting документации корпорации Adobe.
В табл. 19.3 перечислены правила, устанавливаемые типом безопасности песочницы «удаленный». Здесь выражение «регион происхождения SWF-файла» подразумевает удаленный регион, из которого был открыт или загружен данный SWF-файл. Например, если файл hiscores . swf загружается из удаленного местоположения http://coolgames.com/hiscores.swf, то регионом происхождения файла hiscores. swf является cool games . com (дополнительные сведения по удаленным регионам можно найти в разд. «Локальная область действия, удаленная область действия и удаленные регионы»).
В табл. 19.3 демонстрируются следующие ключевые правила типа безопасности песочницы «удаленный».
Операции загрузки содержимого, обращения к содержимому в виде данных, кросс-скриптинга и загрузки данных не могут использоваться вместе с ресурсами из локальной области действия.
Все ресурсы из всей удаленной области действия могут загружаться в виде содержимого.
Операции загрузки содержимого, обращения к содержимому в виде данных, кросс-скриптинга и загрузки данных могут использоваться для всех ресурсов из региона происхождения SWF-файла.
К ресурсам удаленной области действия, находящимся за пределами региона происхождения SWF-файла, можно обращаться как к данным или загружать их как данные, если установлено соответствующее разрешение распространителя.
Для SWF-файлов из удаленной области действия, находящихся за пределами региона происхождения SWF-файла, может быть выполнен кросс-скриптинг, если установлено соответствующее разрешение создателя.
Таблица 19.3. Тип безопасности песочницы «удаленный», допустимые и запрещенные операции
Операция
Локальная область действия
Ресурсы удаленной области действия из региона происхождения SWF-файла
Ресурсы удаленной области действия, находящиеся за пределами региона происхождения SWF-файла
Загрузка содержимого
Запрещается
Допускается
Допускается
Обращение к содержимому в виде данных
Запрещается
Допускается
Допускается только по разрешению распространителя
Кросс-скриптинг
Запрещается
Допускается
Допускается только по разрешению создателя
Загрузка данных
Запрещается
Допускается
Допускается только по разрешению распространителя
В табл. 19.4 перечислены следующие ключевые правила, устанавливаемые типом безопасности песочницы «локальный с поддержкой файловой системы».
Операции загрузки содержимого, обращения к содержимому в виде данных, кросс-скриптинга и загрузки данных не могут использоваться вместе с ресурсами из удаленной области действия.
Операции загрузки содержимого, обращения к содержимому в виде данных и загрузки данных могут использоваться для всех ресурсов, не являющихся SWF-файлами, из локальной области действия.
Загрузка локальных SWF-файлов с поддержкой сети строго запрещается.
Допускается загрузка и кросс-скриптинг других локальных SWF-файлов с поддержкой файловой системы.
Для кросс-скриптинга локальных SWF-файлов с установленным доверием требуется разрешение создателя.
Таблица 19.4. Тип безопасности песочницы «локальный с поддержкой файловой системы», допустимые и запрещенные операции
Операция
Ресурсы, не являющиеся SWF-файлами, в локальной области действия
Локальные SWF-файлы с поддержкой файловой системы
Локальные SWF-файлы с поддержкой сети
Локальные SWF-файлы с установленным доверием
Ресурсы вудаленной области действия
Загрузка содержимого
Допускается
Допускается
Запрещается
Допускается
Запрещается
Обращение к содержимому в виде данных
Допускается
—
—
—
Запрещается
Кроссскриптинг
—
Допускается
Запрещается
Допускается только по разрешению создателя
Запрещается
Загрузка данных
Допускается
—
—
—
Запрещается
В табл. 19.5 перечислены следующие ключевые правила, устанавливаемые типом безопасности песочницы «локальный с поддержкой сети».
Операции загрузки содержимого могут использоваться для ресурсов в удаленной области действия.
Операции загрузки данных и обращения к содержимому в виде данных могут применяться для ресурсов в удаленной области действия, если установлено соответствующее разрешение распространителя.
Операции загрузки содержимого могут использоваться для ресурсов, не являющихся SWF-файлами, в локальной области действия.
Операции загрузки данных и обращения к содержимому в виде данных не могут применяться для ресурсов в локальной области действия.
Загрузка локальных SWF-файлов с поддержкой файловой системы строго запрещается.
Допускается загрузка и кросс-скриптинг других локальных SWF-файлов с поддержкой сети.
Для кросс-скриптинга локальных SWF-файлов с установленным доверием или удаленных SWF-файлов требуется разрешение создателя.
Таблица 19.5. Тип безопасности песочницы «локальный с поддержкой сети», допустимые и запрещенные операции
Операция
Ресурсы, не являющиеся SWF- файлами, в локальной области действия
Локальные SWF-файлы с поддержкой файловой системы
Локальные SWF-файлы с поддержкой сети
Локальные SWF-файлы с установленным доверием
Ресурсы в удаленной области действия
Загрузка содержимого
Допускается
Запрещается
Допускается
Допускается
Допускается
Обращение к содержимому в виде данных
Запрещается
Допускается только по разрешению распространителя
Кросс-скриптинг
—
Запрещается
Допускается
Допускается только по разрешению создателя
Допускается только по разрешению создателя
Загрузка данных
Запрещается
Допускается только по разрешению распространителя
В табл. 19.6 перечислены следующие ключевые правила, устанавливаемые типом безопасности песочницы «локальный с установленным доверием».
Операции загрузки содержимого, обращения к содержимому в виде данных, кросс-скриптинга и загрузки данных могут использоваться для любых ресурсов в локальной и удаленной области действия.
Тип безопасности песочницы «локальный с установленным доверием» дает SWF-файлу максимально возможную степень свободы из всех, которые может предоставить приложение Flash Player.
Таблица 19.6. Тип безопасности песочницы «локальный с установленным доверием», допустимые и запрещенные операции
Операция
Ресурсы, не являющиеся SWF-файлами, в локальной области действия
Локальные SWF-файлы с поддержкой файловой системы
Локальные SWF-файлы с поддержкой сети
Локальные SWF-файлы с установленным доверием
Ресурсы в удаленной области действия
Загрузка содержимого
Допускается
Допускается
Допускается
Допускается
Допускается
Обращение к содержимому в виде данных
Допускается
—
—
—
Допускается
Кросс-скриптинг
—
Допускается
Допускается
Допускается
Допускается
Загрузка данных
Допускается
—
—
—
Допускается
Мы познакомились с правилами, которые устанавливаются каждым из четырех типов безопасности песочниц для четырех типов операций. Перед тем как перейти к другим вопросам, касающимся безопасности, рассмотрим еще один тип операции — подключение к сокету.
Безопасность сокетов
В языке ActionScript подключение к сокетам осуществляется посредством классов XMLSocket, Socket и NetConnection. В табл. 19.7 и 19.8 перечислены конкретные местоположения и порты, к которым можно открывать сокетные соединения с помощью методов классов XMLSocket и Socket. В таблицах не описан класс NetConnection, который используется в приложениях Adobe Flash Media Server и Adobe Flex. Информацию по безопасности классаNetConnection можно найти в документации по этим продуктам.
И в табл. 19.7, и в табл. 19.8 термин разрешение распространителя» подразумевает, что оператор сервера сделал доступным надлежащий файл междоменной политики безопасности. Более подробную информацию можно найти далее, в разд. «Разрешения распространителя (файлы политики безопасности)».
В табл. 19.7 показано, может ли удаленный SWF-файл устанавливать сокетное соединение с четырьмя перечисленными местоположениями.
Таблица 19.7. Удаленный тип безопасности песочницы, допустимые и запрещенные сокетные соединения
Локальная область действия, любой порт
Удаленная область действия внутри региона происхождения SWF-файла, порт 1024 и выше
Удаленная область действия внутри региона происхождения SWF-файла, порт 1023 и ниже
Удаленная область действия за пределами области происхождения SWF-файла, любой порт
Допускается только по разрешению распространителя
Допускается
Допускается только по разрешению распространителя
Допускается только по разрешению распространителя
В табл. 19.8 показано, может ли SWF-файл, тип безопасности песочницы которого представлен в крайнем левом столбце, устанавливать сокетное соединение с местоположениями, перечисленными в остальных столбцах.
Таблица 19.8. Локальные типы безопасности песочниц, допустимые и запрещенные сокетные соединения
Тип безопасности песочницы
Локальная область действия, любой порт
Удаленная область действия, любой порт
Локальный с поддержкой файловой системы
Запрещается
Запрещается
Локальный с поддержкой сети
Допускается только по разрешению распространителя
Допускается только по разрешению распространителя
Локальный с установленным доверием
Допускается
Допускается
Примеры сценариев безопасности
Чтобы подкрепить практикой изученный материал, рассмотрим несколько примеров, которые демонстрируют, как система безопасности приложения Flash Player позволяет предотвратить получение данных посторонними лицами. В каждом сценарии сначала описывается способ, которым мог бы воспользоваться хакер для получения данных при отсутствии системы безопасности приложения Flash Player, а затем порядок действий системы безопасности при предотвращении попытки хакера завладеть целевыми данными.
Шпионское вложение о электронном письме — Вез системы безопасности Hash Player
Джо Хакер хочет похитить персональные данные Дэйва Юзера. Джо знает, что Дэйв заполняет свои налоговые декларации с помощью приложения АВСТах, работающего под управлением операционной системы Windows. Джо проводит небольшое исследование и обнаруживает, что приложение АВСТах хранит информацию о годовой налоговой декларации в XML-файле, который находится по адресу c:\ABCTax\taxreturn.xml. Если Джо сможет получить этот файл, он сможет воспользоваться содержащейся в нем информацией, чтобы открыть банковский счет и обратиться за получением кредитной карты от лица Дэйва. Итак, Джо отправляет по электронной почте письмо Дэйву, прикрепив к письму внешне безобидную анимацию cartoon, swf. Дэйв открывает электронное письмо и воспроизводит анимацию в браузере на своей локальной машине. Без ведома Дэйва файл cartoon. swf тайно использует метод URLLoader. load ( ) для получения файла taxreturn. xml из локальной файловой системы. После этого файл cartoon. swf использует метод flash. net. sendToURL ( ), чтобы выгрузить файл taxreturn. xml на сайт Джо.
Джо получает кредитную карту на имя Дэйва и покупает приставку Nintendo Wii с множеством отличных игр.
Шпионское вложение в электронном письме — с системой безопасности Flash Player
Как и раньше, Джо отправляет Дэйву электронное письмо, к которому прикреплена внешне безобидная анимация cartoon. swf. Дэйв открывает электронное письмо и воспроизводит анимацию в браузере на своей локальной машине. Поскольку файл cartoon.swf открывается из локальной области действия, приложение Flash Player проверяет, была ли включена поддержка сети при компиляции файла cartoon. swf.
Сначала предположим, что файл cartoon. swf был скомпилирован без поддержки сети. В этом случае приложение Flash Player присваивает файлу cartoon, swf тип безопасности песочницы «локальный с поддержкой файловой системы». Как и раньше, файл cartoon. swf тайно использует метод URLLoader. load ( ) для получения файла taxreturn. xml из локальной файловой системы. В соот-
ветствии с табл. 19.4 файлу cartoon. swf разрешается загрузить эти локальные данные. После этого он пытается использовать метод flash. net. sendToURL ( ), чтобы выгрузить файл taxreturn, xml на сайт Джо, однако эта попытка блокируется, поскольку локальным SWF-файлам с поддержкой файловой системы не разрешается выполнять операции flash. net. sendToURL ( ).
В предыдущих таблицах не рассматривались ограничения безопасности конкретно для метода flash.net.sendTollRL(), однако, как отмечалось ранее, определить ограничения безопасности для любого метода интерфейса API приложения Flash Player можно в справочнике по языку ActionScript корпорации Adobe.
Теперь предположим, что файл cartoon. swf был скомпилирован с поддержкой сети. В данном случае приложение Flash Player присваивает ему тип безопасности песочницы «локальный с поддержкой сети». Как и раньше, файл cartoon, swf пытается тайно использовать метод URLLoader. load ( ) для получения файла taxreturn. xml из локальной файловой системы. Однако эта попытка блокируется, поскольку, в соответствии с табл. 19.5, локальные SWF-файлы с поддержкой сети не могут использовать операции загрузки данных для ресурсов в локальной области действия.
Джо вынужден покупать приставку Nintendo Wii за свои деньги.
Внутренняя корпоративная информация — без системы безопасности Flash Player
Джо Хакер хочет получить некую служебную информацию, чтобы совершить выгодную сделку на бирже. Джо раньше работал в корпорации WYZ, у которой есть общедоступный сайт www.wyzcorp.com. Джо остался в хороших отношениях с корпорацией WYZ, поэтому его наняли по контракту, чтобы обновить сведения о корпорации в файле profile. swf на сайте www.wyzcorp.com. Джо знает, что корпорация WYZ планирует выпустить важный продукт, что повлияет на стоимость акций компании. Джо также знает, что даты выпуска новых продуктов корпорации WYZ хранятся на внутреннем сайте, который находится за межсетевым экраном, по следующему адресу: strategy.wyzcorp.com/releasedates.html. Если Джо сможет тайно получить дату выпуска нового продукта, то сможет скупить акции корпорации WYZ за день до выхода этого продукта, а затем выгодно продать их.
Итак, Джо добавляет некий код в файл profile. swf, использующий метод URLLoader . load ( ), чтобы попытаться загрузить файл: strategy.wyzcorp.com/ releasedates.html. После этого сотрудник корпорации WYZ просматривает сведения о корпорации по адресу www.wyzcorp.com/profile.swf. Поскольку компьютер сотрудника находится за межсетевым экраном, он имеет доступ к сайту strategy.wyzcorp.com, поэтому попытка загрузить файл releasedates . html оказывается успешной! Без ведома сотрудника файл profile .swf использует метод flash. net. sendToURL ( ), чтобы выгрузить файл releasedates . html на сайт Джо.
Акции корпорации WYZ взлетают в цене, а Джо теперь может позволить себе заниматься любимым делом.
Внутренняя корпоративная информация — с системой безопасности Hash Player
Как и раньше, Джо размещает файл profile . swf на сайте www.wyzcorp.com, который использует метод URLLoader. load ( ), чтобы попытаться загрузить файл strategy.wyzcorp.com/releasedates.htmL После этого сотрудник корпорации WYZ просматривает сведения о корпорации по адресу www.wyzcorp.com/profile.swf. Поскольку файл profile .swf открывается в удаленной области действия, среда выполнения Flash присваивает ему тип безопасности песочницы «удаленный». Когда файл www.wyzcorp.com/profile.swf пытается загрузить файл strategy.wyzcorp.com/releasedates. html, попытка блокируется, поскольку, в соответствии с табл. 19.3, удаленный SWF- файл не может использовать операции загрузки данных для ресурсов, находящихся за пределами удаленного региона происхождения этого файла.
Джо надеется получить гигабайт трафика за баннерную рекламу нового продукта корпорации WYZ, чтобы оплатить жилье в следующем месяце.
Межсайтовая информация — без системы безопасности Hash Player
Джо Хакер хочет похитить информацию о некоторых банковских счетах. Он работает в агентстве Hipster Ad Agency, занимающемся производством рекламы для банка ReallyHuge Bank. У этого банка есть система интернет-банкинга, доступная по адресу www.reallyhugebank.com/bank.swf. Приложение bank, swf загружает рекламу из файла www.hipsteradagency.com/ad.swf. Джо изучил структуру файла bank, swf с помощью декомпилятора SWF-файлов и теперь знает, в каких переменных приложение bank, swf хранит номера банковских счетов и пароли. С преступным намерением Джо добавляет в файл ad. swf код, который считывает значения этих переменных у своего родителя bank. swf, и затем использует метод flash. net. sendToURL ( ) для отправки похищенной информации на сайт Джо. Всякий раз, когда пользователь приложения bank. swf обращается к своему счету, Джо получает номер счета и пароль.
Джо жертвует баснословно большие суммы денег организации «Гринпис».
Межсайтввая информация — с системой безопасности Hash Player
Как и раньше, Джо добавляет в файл ad. swf код, который считывает значения нужных переменных у своего родителя bank. swf. Пользователь запускает приложение www.reallyhugebank.com/bank.swf, а оно, в свою очередь, загружает «зловредный» файл Джо www.hipsteradagency.com/ad.swf. Поскольку файл ad. swf открывается из удаленной области действия, среда выполнения Flash присваивает ему тип безопасности песочницы «удаленный». Когда файл ad. swf пытается прочитать значения переменных файла bank. swf, эта попытка блокируется, поскольку, в соответствии с табл. 19.3, удаленный SWF-файл не может использовать операции
загрузки данных для ресурсов, находящихся за пределами удаленного региона происхождения этого файла.
Джо жертвует скромную сумму денег организации «Гринпис».
Выбор локального типа безопасности песочницы
Вы получили хорошее представление о мерах безопасности, обеспечиваемых каждым типом безопасности песочниц. Кроме того, вы узнали, что SWF-файлам, открытым или загруженным из местоположений удаленной области действия, всегда присваивается тип безопасности песочницы «удаленный», а SWF-файлам, открытым или загруженным из местоположений локальной области действия, присваивается один из трех локальных типов безопасности песочниц..
Теперь поближе познакомимся с механизмами, применяемыми для выбора одного из трех локальных типов безопасности песочниц. В каждом из трех последующих разделов представлен сценарий, в котором разработчик использует один из трех локальных типов безопасности песочниц. Каждый сценарий описывает и логическое обоснование, и сам механизм для выбора каждого типа безопасности песочницы.
Компиляция локального SWF-файла с поддержкой файлооой системы
Сьюзен разрабатывает приложение-календарь calendar. swf, которое будет размещаться на сайте отеля. Календарь загружает информацию о праздниках из внешнего XML-файла holiday. xml. Приложение практически готово, поэтому Сьюзен необходимо отправить его на утверждение заказчику. Несмотря на то что приложение calendar, swf со временем будет размещено на сайте, заказчик хочет показать его множеству людей в отеле. В процессе демонстрации заказчик не желает иметь постоянное подключение к Интернету. Итак, Сьюзен отправляет файлы calendar . swf и holiday. xml заказчику.
Чтобы в процессе демонстрации приложение calendar, swf могло загружать файл holiday.xml из локальной файловой системы, Сьюзен скомпилировала SWF-файл календаря с установленным в значение false флагом компилятора -use-network. В зависимости от используемой среды разработки применяются различные механизмы для установки флага компилятора -use-network. В приложении Flex Builder 2 Сьюзен выполняет следующие шаги, чтобы установить в значение false флаг компилятора-use-network.
На палитре Navigator (Навигатор) Сьюзен выбирает папку проекта для приложения-календаря.■
В меню Project (Проект) она выбирает команду Properties (Свойства).
В окне Properties (Свойства) она выбирает раздел ActionScript Compiler (Компилятор ActionScript).
В поле ввода Additional compiler arguments (Дополнительные аргументы компилятора) она вводит -use-network=false.
Чтобы подтвердить установку, Сьюзен нажимает кнопку ОК.
В среде разработки Flash Сьюзен выполняет следующие шаги, чтобы установить в значение false флаг компилятора -use-network:
В меню File (Файл) Сьюзен выбирает команду Publish Settings (Настройки публикации).
В окне Publish Settings (Настройки публикации) она переходит на вкладку Flash.
В раскрывающемся списке Local playback security (Безопасность локального воспроизведения) она выбирает пункт Access local files only (Обращение только к локальным файлам).
Чтобы подтвердить установку, Сьюзен нажимает кнопку ОК.
При использовании консольного компилятора из бесплатного инструментария разработчика Flex SDK Сьюзен указывает значение флага -use-network в качестве параметра компилятора mxmlc. Вот команда, которую выполняет Сьюзен, работая в операционной системе Microsoft Windows:
mxmk.exe -use-network=false -file-specs c:\projects\calendar\Calendar.as
-output c:\projects\calendar\b1n\Calendar.swf
Компиляция локального SWF-файла с поддержкой сети
Дориан разрабатывает видеоигру race. swf для сайта своей компании. Посетители сайта могут играть в эту игру и отправлять свои лучшие результаты в режиме онлайн. Дориан хочет сделать загружаемую версию своей игры, в которую можно будет играть при отсутствии подключения к Интернету. Когда у пользователя отсутствует подключение к Интернету, загружаемая версия игры будет сохранять лучшие результаты в совместно используемом локальном объекте и отправит их на сервер, как только пользователь подключится к Интернету.
Дориан знает, что большая часть посетителей предпочитает не запускать исполняемые файлы из неизвестных источников, поэтому она решает сделать свою игру в виде загружаемого SWF-файла, а не в виде исполняемого файла проектора. Чтобы позволить игре, выполняемой в виде локального SWF-файла, подключаться к серверу, на котором хранятся лучшие результаты, Дориан компилирует приложение race . swf с установленным в значение true флагом компилятора -usenetwork.
Чтобы установить флаг -use-network, Дориан использует тот же механизм, который использовала Сьюзен в предыдущем сценарии с приложением calendar. swf, но при установке флага -use-network вместо значения false указывает значение true. При использовании среды разработки Flash Дориан выбирает для параметра Local playback security (Безопасность локального воспроизведения) значение Access network only (Обращение только к сети) вместо значения Access local files only (Обращение только к локальным файлам).
Установка локального доверия
Колин создает инструмент администрирования admin. swf для сокетного приложения-сервера. Файл admin .swf предназначен для работы либо в том же домене, в котором находится сокетный сервер, либо в локальной файловой системе администратора этого сервера. Инструмент администрирования подключается к удаленному сокетному серверу и не загружает никакие локальные файлы, поэтому Колин компилирует приложение как локальный SWF-файл с поддержкой сети.
Первый экран инструмента администрирования представляет собой простую форму для ввода имени сервера и пароля. При входе в систему инструмент администрирования предлагает сохранить введенный пароль сервера. Если пользователь соглашается, то инструмент администрирования сохраняет пароль в совместно используемом локальном объекте. В следующий раз при входе в систему инструмент администрирования автоматически заполнит текстовое поле для ввода пароля.
В процессе разработки Колин вдруг осознает, что, поскольку файл admin. swf является локальным SWF-файлом с поддержкой сети, другие локальные SWF-файлы с поддержкой сети, находящиеся на том же компьютере, на котором выполняется приложение admin. swf, смогут загрузить это приложение и прочитать пароль из текстового поля!
Чтобы закрыть эту потенциальную брешь в безопасности, Колин принимает разумное решение: файлу admin. swf должен присваиваться тип безопасности песочницы «локальный с установленным доверием». В результате другие локальные SWF-файлы с поддержкой сети не смогут прочитать значение из текстового поля для ввода пароля.
Чтобы превратить файл admin, swf в локальный SWF-файл с установленным доверием, Колин создает инсталлятор, который устанавливает доверие для местоположения файла admin. swf путем помещения конфигурационного файла в директорию Global Flash Player Trust на локальной машине. В соответствии с официальным форматом языка конфигурационный файл содержит одну-единственную текстовую строку: местоположение файла admin. swf в локальной файловой системе. В итоге, когда приложение Flash Player загружает файл admin. swf из указанного местоположения, этому файлу присваивается тип безопасности песочницы «локальный с установленным доверием».
Полную информацию, посвященную созданию и управлению устанавливающими доверие конфигурационными файлами, можно найти в разделе Programming ActionScript 3.0 ► Flash Player APIs ► Flash Player Security ► Overview of permission controls ► Administrative user controls документации корпорации Adobe.
Колин также понимает, что пользователи инструмента администрирования могут захотеть переместить файл admin. swf в любое произвольное местоположение. Чтобы позволить пользователю перемещать файл admin. swf в новое местоположение, не теряя статус «локальный с установленным доверием», Колин включает инструкцию в документацию по инструменту администрирования (см. врезку выше).
Описанный сценарий с инструментом администрирования сокетного сервера демонстрирует два доступных механизма установления доверия для локального SWF-файла: конфигурационные файлы на компьютере, на котором выполняется приложение Flash Player (обеспечиваемые инсталлятором Колина), и инструмент Flash Player Settings Manager (к которому обращается пользователь). Подробное описание инструмента Flash Player Settings Manager можно найти в разделе Programming ActionScript 3.0 ► Flash Player APIs ► Flash Player Security ► Overview of permission controls ► User controls документации корпорации Adobe.
Перенос файла admin.swf в произвольное местоположение. Перед тем как перенести файл admin. swf в новое местоположение, не забудьте зарегистрировать его как локальный SWF-файл с установленным доверием, выполнив такую последовательность действий.
Откройте инструмент Flash Player Settings Manager, загрузив в браузере следующую страницу: http://www.macromedia.com/support/documentation/en/flashplayer/ help/settings_manager04.html.
Щелкните кнопкой мыши на ссылке Edit locations (Управление местоположениями) параметра Always trust files in these locations (Всегда доверять файлам в следующих местоположениях) в разделе Global Security Settings (Глобальные настройки безопасности) и выберите команду Add location (Добавить местоположение).
Введите или выберите местоположение, для которого вы хотите установить доверие.
Стоит отметить, что, если приложение Flash Player выполняется в тот момент, когда устанавливается доверие (либо с помощью конфигурационных файлов, либо с помощью инструмента Flash Player Settings Manager), новый доверительный статус для указанного SWF-файла не вступит в силу до тех пор, пока приложение не будет перезапущено. Для версий Flash Player, реализованных в виде дополнительных модулей или элементов управления ActiveX, «перезапуск» подразумевает выключение всех экземпляров приложения Flash Player — даже тех, которые выполняются в других окнах браузера!
Для разработчиков доверие устанавливается автоматически
Чтобы упростить тестирование локального содержимого, предназначенного для публикации в Интернете, приложение Flex Builder 2 корпорации Adobe автоматически устанавливает доверие для разрабатываемых проектов. Для этого оно добавляет запись, описывающую путь для выходной папки каждого проекта (обычно /bin/), в файл flexbuilder. cf д, находящийся в директории User Flash Player Trust. Подобным образом отладочная версия приложения Flash Player среды разработки Flash автоматически устанавливает доверие для всех открываемых или загружаемых SWF-файлов в локальной области действия.
Вследствие этого при загрузке элементов в процессе разработки вы можете не столкнуться с проблемами безопасности, которые возникнут у конечного пользователя. Например, SWF-файл, находящийся в папке проекта/bin/, сможет загрузить локальный файл, даже если у него есть только разрешение для доступа к сети.
Чтобы протестировать приложение в тех условиях, в которых будет находиться ваш конечный пользователь, выполняйте его в соответствующей целевой среде. Например, для веб-приложений тестирование необходимо проводить в Интернете. Для локальных приложений без установленного доверия, разрабатываемых в приложении Flex Builder 2, тестирование проводите из локальной папки, для которой не установлено доверие (Рабочий стол операционной системы обычно является именно такой папкой). Для локальных приложений без установленного доверия, разрабатываемых в среде разработки Flash, используйте команду меню File ► Publish Preview ► HTML (Файл ► Просмотр публикации ► HTML), чтобы просмотреть приложение в браузере (среда разработки Flash не устанавливает автоматически доверие для содержимого, просматриваемого в браузере).
В процессе отладки вы должны всегда убеждаться в том, что тип безопасности песочницы вашего приложения соответствует типу безопасности песочницы, который будет использоваться при внедрении приложения.
Чтобы проверить тип безопасности песочницы SWF-файла на этапе выполнения, получите значение переменной flash. system. Security. sandboxType внутри этого SWF-файла.
Чтобы проверить, для каких папок на данном компьютере установлено доверие, просмотрите конфигурационные файлы, находящиеся в директориях User Flash Player Trust и Global Flash Player Trust, или воспользуйтесь онлайн-инструментом Flash Player Settings Manager, который доступен по адресу http://www.adobe.com/support/ documentation/en/flashplayer/help/index.html.
Чтобы удалить доверие для проекта приложения Flex Builder 2 (это позволит имитировать работу конечного пользователя с приложениями без установленного доверия), удалите соответствующий путь из файла flexbuilder. cf д, находящегося в директории User Flash Player Trust. Стоит отметить, однако, что, поскольку приложение Flex Builder 2 автоматически восстанавливает файл flexbuilder. cf д при создании нового проекта, вам придется удалять данный путь из файла после каждого создания или импорта проекта. Узнать местоположение директорий User Flash Player Trust и Global Flash Player Trust можно в разделе Programming ActionScript 3.0> Flash Player APIs ► Flash Player Security ► Overview of permission controls документации корпорации Adobe.
Используемый по умолчанию тип безопасности песочницы
И приложение Flex Builder 2, и консольный компилятор mxmlc устанавливают флаг компилятора -use-network в значение true, если это значение не указано явно. Таким образом, по умолчанию, если SWF-файл, скомпилированный с помощью приложения Flex Builder 2 или компилятора mxmlc, запускается в локальной области действия из любого местоположения, для которого не установлено доверие, ему будет присвоен тип безопасности «локальный с поддержкой сети».
Каким бы странным это ни казалось, но значением по умолчанию для параметра Local playback secutiry (Безопасность локального воспроизведения) среды разработки Flash является Access local files only (Обращение только к локальным файлам).
Поэтому по умолчанию, если SWF-файл, скомпилированный с помощью среды разработки Flash, запускается в локальной области действия из любого местоположения, для которого не установлено доверие, ему будет присвоен тип безопасности песочницы «локальный с поддержкой файловой системы».
Чтобы избежать недоразумений, всегда явно указывайте желаемое значение для флага компилятора -use-network и параметра публикации Local playback secutiry (Безопасность локального воспроизведения) среды разработки Flash.
Разрешения распространителя (файлы политики безопасности)
На протяжении этой главы мы неоднократно видели, как система безопасности приложения Flash Player ограничивает доступ SWF-файла к внешним ресурсам. Теперь рассмотрим, как в некоторых случаях распространитель ресурса может использовать разрешения распространителя, чтобы обойти эти ограничения.
Напомним, что «распространитель ресурса» — это сторона, которая предоставляет ресурс из некоторого удаленного региона. Например, и администратор сайта, и администратор сокетного сервера являются распространителями ресурсов.
Как сторона, отвечающая за ресурсы из конкретного удаленного региона, распространитель ресурса может устанавливать доверие для SWF-файлов из внешних источников, чтобы они могли обращаться к этим ресурсам. Чтобы установить доверие для SWF-файлов на доступ к определенному набору ресурсов, распространитель ресурса использует особый механизм разрешений, называемый файлом политики безопасности. Файл политики безопасности — это простой XML-документ, который содержит список доверенных источников SWF-файлов. Вообще говоря, файл политики безопасности предоставляет SWF-файлам из своего списка доверенных источников доступ к ресурсам, которые в обычной ситуации оказываются недоступными из-за ограничений безопасности приложения Flash Player.
К типам операций, которые потенциально могут быть разрешены файлом политики безопасности,относятся:
загрузка содержимого в виде данных;
загрузка данных;
подключение к сокету;
импортирующая загрузка (рассматривается далее, в разд. «Импортирующая загрузка»).
С помощью файла политики безопасности невозможно разрешить операции кросс-скриптинга. Узнать подробнее о разрешении операции кросс-скриптинга можно в разд. «Разрешения создателя (allowDomain())».
Обычно файлы политики безопасности используются для разрешения взаимодействия между различными удаленными регионами. Например, файл политики
безопасности может дать файлу http://site-a.com/map.swf разрешение на чтение пикселов из файла http://site-b.com/satellite-image.jpg или разрешение на загрузку файла http://siteb.com/map-data.xml.
В соответствии с данными из табл. 19.3,19.5,19.7 и 19.8 файл политики безопасности позволяет предоставить SWF-файлу доступ к ресурсам, которые оказываются недоступными, когда:
удаленный SWF-файл пытается выполнить операцию доступа к содержимому в виде данных для ресурса в удаленной области действия, находящегося за пределами его региона происхождения;
удаленный SWF-файл пытается выполнить операцию загрузки данных для ресурса в удаленной области действия, находящегося за пределами его региона происхождения;
локальный SWF-файл с поддержкой сети пытается выполнить операцию доступа к содержимому в виде данных для ресурса в удаленной области действия;
локальный SWF-файл с поддержкой сети пытается выполнить операцию загрузки данных для ресурса в удаленной области действия;
удаленный SWF-файл пытается подключиться к сокету внутри его региона происхождения, но к порту ниже 1024;
удаленный SWF-файл пытается подключить к сокету за пределами его региона происхождения;
локальный SWF-файл с поддержкой сети пытается подключиться к сокету в удаленной области действия.
В следующих разделах описываются механизмы использования файлов политики безопасности распространителями ресурсов для разрешения доступа к ресурсам в каждой из перечисленных ситуаций.
Дополнительную информацию по файлам политики безопасности можно найти в разделе Programming Actionscript 3.0 ► Flash Player APIs ► Flash Player Security ► Overview of permission controls ► Web Site controls (cross-domain policy files) документации корпорации Adobe.
В приложении Flash Player 6 файлы политики безопасности применялись исключительно для разрешения междоменного взаимодействия и поэтому назывались файлами междоменной политики безопасности. С момента появления приложения Flash Player версии 7.0.19.0 файлы политики безопасности также начали использоваться для разрешения сокетных подключений к портам из нижнего диапазона. Чтобы как-то отразить это расширенное назначение, в данной книге используется более короткий термин «файл политики безопасности», однако в других источниках вы будете встречать первоначальный термин — «файл междоменной политики безопасности».
Разрешение операций загрузки данных и обращения к содержимому в виде данных
Чтобы предоставить SWF-файлам из определенного подмножества источников разрешение на выполнение операций загрузки данных или обращения к содержимому
в виде данных для заданного набора удаленных ресурсов, используйте следующую общую последовательность действий.
Создайте файл политики безопасности.
Разместите созданный файл политики безопасности в том же удаленном регионе (то есть в том же домене или для того же IP-адреса), где находится ресурс, для которого устанавливается разрешение.
Предыдущие шаги будут подробно описаны в следующих двух разделах. Познакомившись с тем, как создаются и размещаются файлы политики безопасности, мы рассмотрим процесс получения SWF-файлом разрешения из файла политики безопасности для выполнения операций загрузки данных и обращения к содержимому в виде данных.
Создание файла политики безопасности
Для создания файла политики безопасности используйте такую последовательность действий.
Создайте новый текстовый файл.
Добавьте в файл список желаемых разрешенных источников, используя официальный синтаксис корпорации Adobe для файлов политики безопасности.
Сохраните текстовый файл.
Официальный синтаксис корпорации Adobe для файлов политики безопасности основан на языке XML и имеет следующую структуру:
<?xml version="1.0"?>
<!DOCTYPE cross-domain-policy
SYSTEM "http://www.adobe.com/xml/dtds/cross-domain-policy.dtd">
<cross-domain-policy>
<allow-access-from йогтп=''доменИли1Р"/>
</cross-domain-policy>
Здесь доменИли!Р определяет доменное имя или IP-адрес разрешенного источника. SWF-файлу, загруженному из разрешенного источника, разрешается выполнять операции загрузки данных и обращения к содержимому в виде данных для заданного набора ресурсов. Как вы узнаете из следующего раздела, конкретный набор ресурсов, доступ к которым разрешает файл политики безопасности, определяется местоположением этого файла.
Файл политики безопасности может содержать любое количество тегов <allow- access-from>. Например, следующий файл политики безопасности определяет три разрешенных источника: examplel.com, example2.com и example3.com.
<?xml version="1.0"?>
<!DOCTYPE cross-domain-policy
SYSTEM "http://www.adobe.com/xml/dtds/cross-domain-policy.dtd">
<cross-domai n-po1i cy>
<a11ow-acces s-from domai n="exampl el.com"/>
<al1ow-access-from domain="example2.com"/>
<al1ow-access-from domain="example3.com"/>
</cross-domain-policy>
Когда символ * используется в значении атрибута domain, он обозначает подстановочный символ. Например, следующий файл политики безопасности разрешает доступ для сайта examplel.com и его любого поддомена, независимо от уровня вложенности (например, games.examplel.com, driving.games.examplel.com и т. д.):
<?xml vers1on="l.0"?>
<!DOCTYPE cross-doma1n-pol1cy
SYSTEM "http://www.adobe.com/xml/dtds/cross-doma1n-pol1cy.dtd">
<cross-doma1n-po11cy>
<al1ow-access- from domaln="*.exampl el.com"/>
</cross-domaln-pol1cy>
Сам по себе символ * разрешает доступ для всех источников:
<?xml vers1on="l.0"?>
<!DOCTYPE cross-doma1n-pol1cy
SYSTEM "http://www.adobe.com/xml/dtds/cross-domain-policy.dtd">
<c ros s-doma1n-po11cy>
<allow-access-from doma1n="*"/>
</cross-doma1n-po!1cy>
Чтобы включить локальную область действия в список разрешенных источников, файл политики безопасности должен явным образом установить доверие для всех источников. Для этого должен быть указан символ * (любой источник) в качестве значения атрибута domain. Таким образом, чтобы локальные SWF-файлы с поддержкой сети могли загружать XML-файлы с сайта, атрибуту domain файла политики безопасности этого сайта должно быть установлено значение *.
Размещение файла политики безопасности
После создания файл политики безопасности должен быть размещен в том же удаленном регионе (то есть домене или IP-адресе), где находится ресурс, к которому разрешается доступ. Например, если файл политики безопасности разрешает доступ к содержимому сайта www.example.com, файл политики безопасности должен быть также размещен на сайте www.example.com.
Набор ресурсов, к которым файл политики безопасности разрешает доступ, определяется конкретным местоположением этого файла. Если файл политики безопасности размещается в корневой директории сайта, то доступ будет разрешен ко всему сайту. Например, файл политики безопасности, размещенный по адресу http:// www.example.com, разрешает доступ ко всему содержимому сайта www.example.com.
Когда файл политики безопасности размещается в поддиректории сайта, он разрешает доступ только к этой директории и к ее поддиректориям. Например, файл политики безопасности, размещенный по адресу http://www.example.com/assets, разрешает доступ ко всему содержимому директории /assets/ и ее поддиректорий, но не разрешает доступ ни к корневой директории сайта www.example.com, ни к любой другой поддиректории этого сайта.
С целью автоматизации процесса загрузки файлов политики безопасности язык ActionScript определяет используемое по умолчанию имя и местоположение для файлов политики безопасности. Любой файл политики безопасности с именем crossdomain. xml, размещенный в корневой директории сайта, считается
размещаемым в используемом по умолчанию местоположении файла политики безопасности и называется используемым по умолчанию файлом политики безопасности этого сайта. Как вы узнаете в следующих двух разделах, размещение файла политики безопасности в используемом по умолчанию местоположении файла политики безопасности сокращает объем кода, необходимого для получения разрешений из этого файла политики безопасности.
Получение разрешения на загрузку данных из файла политики безопасности
Когда на сайте размещается используемый по умолчанию файл политики безопасности, устанавливающий разрешение для определенного удаленного региона, SWF-файлы из этого региона могут загружать данные с сайта, просто выполняя желаемую операцию загрузки данных. Предположим, что на сайте site-a.com размещен следующий используемый по умолчанию файл политики безопасности, который разрешает доступ для источников site-b.com и www.site-b.com:
<?xml vers1on="L0"?>
<!DOCTYPE cross-domain-policy
SYSTEM "http://www.adobe.com/xml/dtds/cross-doma1n-pol1cy.dtd">
<cross-domaln-poli cy>
<al1ow-access- from domaln="www.s1te-b.com"/>
<allow-access-from doma1n="s1te-b.com"/>
</cross-domain-policy>
Чтобы загрузить файл http://site-a.com/assets/file.xml, любой SWF-файл из источника www.site-b.com или site-b.com может использовать следующий код:
var urlloader-.URLLoader = new URLLoader( ):
urlloader.load(new URLRequest("http://s1te-a.com/assets/f1le.xml")):
Поскольку файл политики безопасности сайта site-a.com размещается в используемом по умолчанию местоположении, приложение Flash Player находит его автоматически и разрешает загрузить файл file. xml.
С другой стороны, если файл политики безопасности сайта размещается не в используемом по умолчанию местоположении, SWF-файлы из разрешенных удаленных регионов должны вручную загрузить этот файл перед тем, как попытаться загрузить данные с этого сайта. Чтобы загрузить файл политики безопасности вручную, используется статический метод loadPolicyFile ( ) класса Security, который имеет следующий общий вид:
Securlty.1oadPol1cyF11e("http://доменИли1Р/путьКФайлуПолитикиБезопасностип);
В приведенном обобщенном коде доменИли1Р — это домен или IP-адрес сайта, на котором размещается файл политики безопасности, а путьКФайлуПолитикиБезопас- ности — местоположение файла политики безопасности на этом сервере. Как уже упоминалось ранее, IP-адреса, заданные в числовом виде, и их эквивалентные доменные имена для приложения Flash Player считаются разными.
Предположим, что сайт site-c.com размещает следующий файл политики безопасности по адресу http://site-c.com/assets/policy.xml. Этот файл политики безопасности разрешает доступ для источников site-d.com и www.site-d.com.
<?xml vers1on='T.0"?>
<!DOCTYPE cross-domain-policy
SYSTEM "http://www.adobe.com/xml/dtds/cross-domain-pollcy.dtd">
<cross-doma1n-pol1cy>
<al1ow-access-from domaln="www.site-d.com"/>
<a11ow-access-from doma1n="s1te-d.com"/>
</cross-domaln-pol1cy>
Чтобы загрузить файл http://site-c.com/assets/file.xml, любой SWF-файл из источников www.site-d.com или site-d.com может использовать следующий код:
// Сначала загружаем файл политики безопасности
Secur1ty.1oadPol 1cyFi 1 e("http://si te-c.com/assets/policy. xml");
// Затем выполняем операцию загрузки
var url1oader:URLLoader = new URLLoader( ):
urlloader.load(new URLRequestChttp://s1te-c.com/assets/f1le.xml")):
Обратите внимание, что в приведенном коде вызов команды загрузки данных происходит сразу после вызова команды загрузки файла политики безопасности. Приложение Flash Player автоматически дожидается загрузки файла политики безопасности перед тем, как перейти к выполнению операции загрузки данных.
После того как файл политики безопасности будет загружен с помощью метода Security. loadPolicyFile ( ), его разрешения будут действовать для всех последующих операций загрузки данных, осуществляемых этим SWF-файлом. Например, следующий код вручную загружает файл политики безопасности, после чего выполняет две операции загрузки, которые зависят от разрешений этого файла политики безопасности:
// Один раз загружаем файл политики безопасности
Securlty. 1 oadPol IcyFileChttp://s1te-c.com/assets/pol1cy.xml"):
// Выполняем две разрешенные операции загрузки
var urlloaderl:URLLoader = new URLLoader( ):
urlloaderl.load(new URLRequestChttp://s1te-c.com/assets/f1 lei.xml")):
var urlloader2:URLLoader = new URLLoader(’ ):
urlloader2. load(new URLRequestChttp://s1te-c.com/assets/f1le2.xml"));
Рассмотрим практический пример, который демонстрирует, как файл политики безопасности, размещенный в поддиректории сайта, может быть использован в реальной ситуации. Предположим, Грейм поддерживает сайт с бесплатной информацией о котировках акций stock-feeds-galore.com. Он сохраняет самую последнюю полученную информацию в XML-файле, который размещается по следующему адресу:
stock-feeds-gal ore.com/1atest/feed.xml
Грейм хочет сделать так, чтобы содержимое директории /latest/ было доступно всем SWF-файлам из любого источника, но не хочет делать доступным весь сайт. Таким образом, Грейм размещает следующий файл политики безопасности с именем policy. xml в директории /latest/ (обратите внимание на использование подстановочного символа * в значении атрибута domain):
<?xml version="1.0"?>
<!DOCTYPE cross-domain-policy
SYSTEM "http://www.adobe.com/xml/dtds/cross-doma1n-pol1cy.dtd">
<с ros s-doma1n-ро11 су>'
<allow-access-from doma1n="*"/>
</cross-doma1n-po!1cy>
После этого Грейм размещает на сайте stock-feeds-galore.com сообщение, которое информирует разработчиков на языке ActionScript о местоположении файла политики безопасности:
stock - feeds-gal ore.com/1atest/pol1cy.xml
Тем временем Джеймс создает приложение stockticker. swf для отображения котировок акций, которое он собирается разместить на своем сайте www.some-news- site.com. Приложение Джеймса загружает последнюю информацию об акциях с сайта Грейма. Поскольку файл политики безопасности сайта www.stock-feeds-galore.com не находится в местоположении, используемом по умолчанию, Джеймс вынужден загрузить файл политики безопасности перед тем, как выполнить операцию загрузки информации об акциях. Вот код, который использует Джеймс для загрузки файла политики безопасности Грейма:
Security.1oadPol1cyF1le("http://stock-feeds-galore.com/latest/pol1 cy.xml")
Инициировав запрос на загрузку файла политики безопасности, Джеймс использует объект URLLoader для загрузки файла feed. xml, как показано в следующем коде:
var urlLoader:URLLoader = new URLLoader( );
urlLoader.load(new URLRequest("http://stock-feeds-galore.com/latest/feed.xml")):
В результате выполнения предыдущего кода приложение Flash Player загружает файл http://stock-feeds-galore.com/latest/policy.xml, находит необходимое разрешение в этом файле политики безопасности и переходит к загрузке файла feed. xml.
Теперь, когда мы познакомились с механизмом получения разрешения из файла политики безопасности на загрузку данных, рассмотрим механизм получения из файла политики безопасности разрешения на выполнение операции обращения к содержимому в виде данных.
Получение разрешения на доступ к содержимому в виде данных из файла политики безопасности
Код, используемый для получения разрешения на доступ к содержимому в виде данных из файла политики безопасности, зависит от типа данных, к которым происходит обращение. Чтобы получить разрешение на обращение к изображению в виде данных из файла политики безопасности, выполняйте следующие шаги.
Если файл политики безопасности не находится в местоположении, используемом по умолчанию, загрузите его методом Security. loadPolicyFile ( ) (как описывалось в предыдущем разделе).
Создайте объект Loadercontext и присвойте значение true его переменной checkPolicyFile.
Загрузите нужное изображение с помощью метода Loader. load ( ); в качестве параметра context метода Loader. load ( ) передайте объект Loadercontext, созданный на шаге 2.
После загрузки изображения выполните операцию обращения к содержимому в виде данных.
Предположим, что сайт site-a.com размещает следующий файл политики безопасности по адресу http://site-a.com/assets/policy.xml. Файл разрешает доступ для источников site-b.com и www.site-b.com.
<?xml vers1on="l.0"?>
<!DOCTYPE cross-domain-pollсу
SYSTEM "http://www.adobe.com/xml/dtds/cross-doma1n-pol1cy.dtd">
<c ros s-doma1n-po11cy>
<a 11ow-access-from doma1n="www.s11e-b.com"/>
<al1ow-access - from doma1n="s1te-b.com"/>
</cross-doma1n-pol1cy>•
Чтобы обратиться к файлу http://site-a.com/assets/image.jpg в виде данных, любой SWF-файл из источника www.site-b.com или site-b.com может использовать следующий код:
// Шаг 1: Файл политики безопасности не находится в местоположении.
// используемом по умолчанию, поэтому загружаем его вручную.
Security.loadPollcyF1le("http://s1te-a.com/assets/pol1 су.xml");
// Шаг 2: Создаем объект Loadercontext и присваиваем его переменной
// checkPol1cyF1le значение true.
var loadercontext = new Loadercontext( ):
loaderContext.checkPol1cyF1le = true;
// Шаг 3: Загружаем изображение. Передаем объект Loadercontext в метод
// Loader.load( ).
theLoader.load(new URLRequest("http://s1te-a.сот/assets/Image.jpg"). loadercontext);
// Шаг 4: Позднее, когда приложение убедится, что загрузка изображения
// завершена, обращаемся к содержимому изображения в виде данных. trace(theLoader.content);
Чтобы получить разрешение из файла политики безопасности на обращение к внешнему звуковому файлу в виде данных, выполняйте следующие шаги.
Если файл политики безопасности не находится в местоположении, используемом по умолчанию, загрузите его методом Security. loadPolicyFile ( ) (как описывалось в предыдущем разделе).
Создайте объект SoundLoaderContext и присвойте значение true его переменной checkPolicyFile.
Загрузите желаемый звуковой файл с помощью метода экземпляра load ( ) класса Sound. В качестве параметра context метода load ( ) передайте объект SoundLoaderContext, созданный на шаге 2.
После успешного завершения загрузки звукового файла (определить окончание загрузки можно с помощью событий класса Sound, информирующих о ходе выполнения загрузки) выполните разрешенную операцию обращения к содержимому в виде данных.
Предположим, что на сайте site-c.com размещен следующий используемый по умолчанию файл политики безопасности, который разрешает доступ для источников site-d.com и www.site-d.com.
<?xml version="1.0"?>
<!DOCTYPE cross-domain-policy
SYSTEM "http://www.adobe.com/xml/dtds/cross-domain-policy.dtd"> <cross-domain-policy>
<al1ow-access-from domain="www.site-d.com"/>
<a11ow-access - from domai n="site-d.com"/>
</c ros s-domain-poli cy>
Чтобы обратиться к файлу http://site-c.com/sounds/song.mp3 в виде данных, любой SWF-файл из источника www.site-d.com или site-d.com может использовать следующий код:
// Шаг 1: Файл политики безопасности находится в местоположении.
// используемом по умолчанию, поэтому загружать его вручную не нужно
// Шаг 2: Создаем объект SoundLoaderContext и присваиваем его переменной
// checkPolicyFile значение true. "
var SoundLoaderContext = new SoundLoaderContext( );
SoundLoaderContext.checkPolicyFile = true;
// Шаг 3: Загружаем звуковой файл. Передаем объект SoundLoaderContext
// в метод Loader.load( ).
theSound.1oad(new URLRequest("http://example.com/sounds/song.mp3");
// Шаг 4: Позднее, когда приложение убедится, что загрузка метаданных
// в формате ID3 звукового файла завершена (это можно определить
// по событию Event.ID3), обращаемся к содержимому звукового файла
// в виде данных.
trace(theSound.id3);
Следует отметить, что присваивание значения true переменной экземпляра checkPolicyFile классов Loadercontext или SoundLoaderContext не влияет на загрузку элемента. При выполнении метода load ( ) классов Loader или SoundLoader элемент загружается всегда, даже если файл политики безопасности не разрешает доступ для региона происхождения данного SWF-файла. Тем не менее, если код в этом SWF-файле попытается обратиться к загруженному элементу в виде данных, приложение Flash Player сгенерирует исключение SecurityError.
Рассмотрим реальный пример, который демонстрирует, как используемый по умолчанию файл политики безопасности сайта может быть применен для разрешения операции обращения к содержимому в виде данных.
Помните сайт Грейма stock-feeds-galore.com? Сайт работает так хорошо, что у Грей- ма появляется свободное время. Он решает поэкспериментировать с программированием растровой графики на языке ActionScript и создает приложение для распознавания лиц, которое может автоматически добавлять забавную шляпу для вечеринок на любую фотографию лица человека. Грейм очень доволен собой.
Друг Грейма Энди управляет компанией, организующей лотереи, у которой есть рекламный сайт www.lotterylotterylottery.com. Энди увидел приложение Грейма и решил, что оно позволит провести хорошую рекламную кампанию. Кампания заключается в том, что победители лотерей размещают свои фотографии на сайте photos.lotterylotterylottery.com. После этого основной сайт www.lotterylotterylottery.com выбирает случайную фотографию для домашней страницы, отображая победителя лотереи в шляпе для вечеринок. Энди нанимает Грейма, чтобы реализовать программный код для этой кампании.
Грейм размещает свое приложение для распознавания лиц partyhat. swf на сайте www.lotterylotterylottery.com. После этого он пишет сценарий на языке Perl randompic. pl, который возвращает случайную фотографию (JPG-файл) с сайта photos.lotterylotterylottery.com. Он размещает сценарий randompic. pl в директории photos.lotterylotterylottery.com/cgi-bin.
Файлу partyhat. swf с сайта www.lotterylotterylottery.com требуется доступ к пикселам фотографий, загруженных с сайта photos.lotterylotterylottery.com. Чтобы разрешить этот доступ, Грейм размещает следующий файл политики безопасности в корневой директории сайта ph6tos.lotterylotterylottery.com и присваивает ему имя crossdomain. xml:
<?xml version="1.0"?>
<!DOCTYPE cross-domain-policy
SYSTEM "http://www.adobe.com/xml/dtds/cross-domaln-pol1cy.dtd">
<c ros s-doma1n-po11cy>.
<al1ow-access- from domaln="www.1otterylottery1ottery.com"/>
<al1ow-access -from domaln="1otterylotterylottery.com"/> </cross-doma1n-po!1cy>
Обратите внимание, что Грейм добавил оба источника — www.lotterylotterylottery.com и lotterylotterylottery.com — в файл политики безопасности. Таким образом, приложение partyhat. swf будет функционировать правильно независимо от того, с какого из указанных URL-адресов оно будет загружено. Грейм также не позабыл исключить домен «*», поскольку его политика безопасности применяется только к конкретным доменам, а не ко всему миру.
Чтобы загрузить фотографию, Грейм использует следующий код (обратите внимание, что вызывать метод Security. loadPolicyFile ( ) не обязательно, поскольку Грейм разместил файл политики безопасности в используемом по умолчанию местоположении файла политики безопасности).
var loadercontext = new LoaderContext( ); loaderContext.checkPol1cyF1le = true;
loader.load(
new URLRequest("http://photos.1ottery1otterylottery.com/randomplc.pl"). loadercontext);
В результате выполнения приведенного кода приложение Flash Player загружает файл http.7/photos.lotterylotterylottery.com/crossdomain.xml, находит в нем требуемое разрешение, загружает фотографию, возвращаемую сценарием random! с. pl, и после этого разрешает приложению partyhat. swf обратиться к пикселам загруженной фотографии.
После загрузки фотографии приложение partyhat. swf благополучно обращается к ее данным. Например, вот код, используемый Греймом для вызова метода приложения pa г t yha t. s wf, который добавляет шляпу для вечеринок к загруженной фотографии (стоит отметить, что для обращения к объекту Bitmap загруженного изображения loader. content требуется разрешение):
addHat(loader.content):
Теперь, когда мы познакомились с механизмами использования файлов политики безопасности для разрешения операций загрузки данных и обращения к содержимому в виде данных, рассмотрим, как можно использовать файлы политики безопасности для разрешения сокетных соединений.
Использование файла политики безопасности для разрешения сокетных соединений
Чтобы разрешить сокетные соединения с помощью файла политики безопасности, используйте следующую общую последовательность действий.
Создайте файл политики безопасности.
Сделайте так, чтобы этот файл был доступен через сокетный сервер или НТТР- сервер, запущенный в том же домене или для того же IP-адреса, с которым планируется установить сокетное соединение.
Описанные шаги подробно рассматриваются в следующих трех разделах.
Создание файла политики безопасности
Файлы политики безопасности, разрешающие установку сокетных соединений, в основном имеют такой же синтаксис, как и файлы политики безопасности, разрешающие выполнение операций загрузки данных и обращения к содержимому в виде данных. Однако в файлах первого типа тег <allow-access-f rom> содержит дополнительный атрибут to-ports, как показано в следующем коде:
<?xml vers1on="l.0"?>
<!DOCTYPE cross-domain-policy
SYSTEM "http://www.adobe.com/xml/dtds/cross-doma1n-pol1cy.dtd">
<cross-doma1n-po!1cy>
<allow-access-from йота"\п="доменИли1Р" to-ports="порты"/> </cross-doma1n-po!1cy>
Атрибут to-ports определяет порты, к которым может подключаться SWF-файл из источника доменИли1Р. Порты можно задавать по отдельности (разделяя значения запятыми) или диапазонами (разделяя значения символом -). Например, приведенный далее файл политики безопасности устанавливает следующие разрешения:
□ SWF-файлы из источника examplel.com могут подключаться к портам 9100 и 9200;
□ SWF-файлы из источника example2.com могут подключаться к портам в диапа- ■ зоне от 10 000 до 11 000.
<?xml vers1on="l.0"?>
<!DOCTYPE cross-domaln-policy
SYSTEM "http://www.adobe.com/xml/dtds/cross-donia1n-pol1cy.dtd">
<cross-doma1 n-pо11cy>
<allow-access-from doma1n="examplel.com" to-ports="9100,9200"/>
<allow-access-from domaln="example2.com" to-ports="10000-11000"/>
</c ros s-doma1n-po11cy>
В значении атрибута to-ports символ * является подстановочным символом. Когда файл политики безопасности загружается через сокет на порте меньшем чем 1024, символ * означает, что доступ разрешен к любому порту. Когда файл политики безопасности загружается через сокет на порте, большем или равном 1024, символ * означает, что можно обращаться к любому порту, большему или равному 1024.
Поскольку порты ниже 1024 считаются привилегированными, файл политики безопасности, получаемый через порт 1024 или выше, не сможет разрешить доступ к портам ниже 1024, даже если они будут указаны явно.
Например, если получение следующего файла политики безопасности осуществляется через порт 2000, SWF-файлам с сайта example3.com будет дано разрешение на подключение ко всем портам выше или равным 1024.
<?xml vers1on="l.0"?>
<!DOCTYPE cross-domaln-pol1су
SYSTEM "http://www.adobe.com/xml /dtds/сross-domaln-pol1cy.dtd">
<cross-domaln-pol 1 cy>
<allow-access-from doma1n="example3.com" to-ports="*"/>
</cross-doma1n-pol1cy>
Но если получение того же файла политики безопасности осуществляется через порт 1021 (который меньше чем 1024), то SWF-файлам с сайта example3.com будет дано разрешение на подключение к любому порту.
Таким образом, чтобы SWF-файлы из любого местоположения могли подключаться к любому порту, получение следующего файла политики безопасности должно осуществляться через порт ниже 1024:
<?xml vers1on="l.0"?>
<!DOCTYPE cross-doma1n-pol1cy
SYSTEM "http://www.adobe.com/xml/dtds/cross-doma1n-pol1cy.dtd">
<cross-doma1n-po!1cy>
<allow-access-from doma1n="*" to-ports="*"/>
</cross-doma1n-pol1cy>
Когда получение файла политики безопасности осуществляется через сокет, атрибут to-ports является обязательным. Если этот атрибут не указан, то доступ будет запрещен ко всем портам.
Теперь, когда мы знаем, как создавать файл политики безопасности, разрешающий сокетное соединение, рассмотрим, как SWF-файл может получить разрешение из этого файла политики безопасности.
Получение файла политики безопасности через сокет
Файлы политики безопасности, разрешающие сокетные соединения, могут передаваться либо непосредственно через сокет, либо по протоколу HTTP. Файлы политики безопасности, передаваемые через сокет, должны размещаться в том же домене или на том же IP-адресе, с которым планируется устанавливать соединение. При этом можно использовать либо порт, с которым устанавливается соединение, либо другой порт. В любом случае сервер, обслуживающий порт, через который передается файл политики безопасности, должен общаться с приложением Flash Player с помощью очень простого протокола получения файла политики безопасности. Протокол состоит из одного тега <policy-file-request/>, который отправляется приложением Flash Player через сокет, когда оно желает загрузить файл политики безопасности, разрешающий сокетное соединение. В ответ сокетный сервер должен отправить приложению Flash Player текст файла политики безопасности в формате ASCII вместе с нулевым байтом (то есть пустым символом таблицы ASCII) и после этого закрыть соединение.
Таким образом, пользовательские серверы, желающие обрабатывать запросы на получение файла политики безопасности и осуществлять нормальное взаимодействие на одном и том же порте, должны реализовать и код, отвечающий на запросы на получение файла политики безопасности, и код, который управляет обычным сокетным взаимодействием. Если сервер обрабатывает запросы на получение файла политики безопасности и осуществляет обычное взаимодействие на одном и том же порте, то SWF-файлы из разрешенных регионов могут подключаться к этому серверу, выполняя желаемую операцию сокетного соединения.
Предположим, что многопользовательский игровой сервер, размещенный на сайте site-a.com, обрабатывает игровые запросы и запросы на получение файла политики безопасности на порте 3000. Файл политики безопасности этого сервера разрешает доступ для источников www.site-b.com и site-b.com, как показано в следующем коде: <?xml version="1.0"?>
<!DOCTYPE cross-domain-policy
SYSTEM "http://www.adobe.com/xml/dtds/cross-doma1n-pol1cy.dtd">
<cross-doma1n-po11cy>
<allow-access-from doma1n="www.s1te-b.com" to-ports="3000"/>
<allow-access-from doma1n="s1te-b.com" to-ports="3000"/>
</c ros s-doma1n-po11cy>
Чтобы подключиться к порту 3000 сайта site-a.com, любой SWF-файл, загруженный из источника www.site-b.com или site-b.com, может использовать следующий код: var socket:Socket = new Socket( ): try { .
socket.connect("s1te-a.com". 3000);
} catch (e:Secur1tyError) {
trace("Connection problem!");
trace(e.message):
}
При выполнении предыдущего кода перед тем, как будет разрешено требуемое подключение к порту 3000, приложение Flash Player автоматически создает отдельное
подключение к порту 3000 и отправляет сообщение <policy-file-request/> игровому серверу. Игровой сервер отправляет в ответ файл политики безопасности сайта site-a.com и после этого закрывает соединение. В списке разрешенных регионов данного файла политики безопасности содержится источник SWF-файла, пытающегося установить соединение, что позволяет разрешить исходное сокетное соединение. Вообще, создается два различных подключения: одно для получения файла политики безопасности и затем еще одно для выполнения исходного запроса на установление сокетного соединения.
В некоторых ситуациях для сервера не представляется возможным ответить на запрос приложения Flash Player на получение файла политики безопасности. Например, SWF-файл может захотеть подключиться к существующему почтовому SMTP- серверу, который не понимает назначения инструкции <policy-file-request/>. Чтобы разрешить это соединение, администратор почтового сервера должен сделать файл политики безопасности доступным через другой порт того же домена или того же IP-адреса, где находится этот почтовый сервер. Сервер, прослушивающий другой порт, может быть чрезвычайно простым сокетным сервером, который просто ожидает подключения, получает инструкции <policy-file-request/>, в ответ возвращает файл политики безопасности и затем закрывает подключение.
Когда получение файла политики безопасности осуществляется через порт, отличный от порта желаемого сокетного соединения (как в нашем примере с почтовым сервером), SWF-файлы из разрешенных регионов должны загружать этот файл политики безопасности вручную перед тем, как выполнить запрос на установление желаемого сокетного соединения. Чтобы вручную загрузить файл политики безопасности через произвольный порт, применяется следующий обобщенный код:
Security.1oadPol1 су F11е("xml socket://доменИлиТР:номерПорта"):
Здесь доменИлиТР — это доменное имя или IP-адрес сервера, а номерПорта — номер порта, через который будет получен файл политики безопасности. Повторим, что IP-адреса, заданные в числовом виде, и их эквивалентные доменные имена для приложения Flash Player считаются разными. В предыдущем коде обратите внимание на обязательное использование протокола xml socket: //. Название протокола описывает тип подключения, используемого для получения файла политики безопасности, а не тип подключения, который разрешает этот файл политики безопасности.
Файл политики безопасности, загруженный с помощью протокола xmlsocket://, разре- ** ^ е шает подключения с использованием обоих классов Socket и XMLSocket, а не только _—_3£ с использованием класса XMLSocket.
Отправив инициированный вручную запрос на получение файла политики безопасности, можно сразу же отправлять последующий запрос на подключение к желаемому порту. Предположим, что на порте 1021 сайта site-c.com запущен простой сервер, обслуживающий запросы на получение файла политики безопасности, и что файл политики безопасности сайта site-c.com разрешает установление соединений к порту 25 из источников site-d.com и www.site-d.com. Вот файл политики безопасности:
<?xml vers1on="l.0"?>
<!DOCTYPE cross-domain-policy
SYSTEM "http:Z/www.adobe.com/xml/dtds/cross-domain-pol 1 cy.dtd">
<cross-domain-pollcy>
<allow-access-from domain="www.s1te-d.com" to-ports="25"/>
<allow-access-from doma1n="site-d.com" to-ports="25"/>
</cross-doma1n-pol1cy>
Чтобы подключиться к порту 25 сайта site-c.com, любой SWF-файл, загруженный из источников site-d.com или www.site-d.com, может использовать следующий код. Обратите внимание, что SWF-файл запрашивает сокетное соединение с портом 25 сразу после отправки запроса на получение файла политики безопасности через порт 1021. Приложение Flash Player терпеливо дожидается окончания загрузки файла политики безопасности перед тем, как продолжить подключение к порту 25.
// Загружаем файл политики безопасности вручную
Security.1oadPol1cyF11e("xml socket://s1te-c.com:1021");
var socket:Socket = new Socket( );
try {
// Пытаемся установить соединение (сразу после того, как был запрошен файл
// политики безопасности)
socket.connect("s1te-c.com", 25):
} catch (e:Secur1tyError) {
trace("Connection problem!"); trace(e.message);
При выполнении предыдущего кода приложение Flash Player перед тем, как разрешить запрашиваемое подключение к порту 25, устанавливает отдельное подключение к порту 1021 и отправляет сообщение <policy-file-request/> серверу, прослушивающему этот порт. Сервер отправляет в ответ файл политики безопасности сайта site-c.com и после этого закрывает подключение. В списке разрешенных регионов этого файла политики безопасности содержится источник SWF-файла, устанавливающего соединение, поэтому установление соединения с портом 25 может быть продолжено. Теперь рассмотрим альтернативный способ для разрешения сокетного соединения: файл политики безопасности, передаваемый по протоколу HTTP.
Получение файла политики безопасности по протоколу НИР
Приложение Flash Player до версии 7.0.19.0 требовало, чтобы файлы политики безопасности, разрешающие сокетные соединения, передавались по протоколу HTTP. Язык ActionScript 3.0, в основном для обратной совместимости, продолжает поддерживать механизм разрешения сокетных соединений посредством файлов политики безопасности, передаваемых по протоколу HTTP. Тем не менее, чтобы разрешить сокетное соединение, файл политики безопасности, передаваемый по протоколу HTTP, должен удовлетворять следующим требованиям:
называться crossdomain.xml;
размещаться в корневой директории веб-сервера;
передаваться через порт 80 домена или IP-адреса, с которым устанавливается желаемое сокетное соединение;
□ в языке ActionScript 3.0 файл должен загружаться вручную с помощью метода Security. loadPolicyFile ( ).
Более того, в файлах политики безопасности, передаваемых по протоколу HTTP, не используется атрибут to-ports. Вместо этого доступ предоставляется ко всем портам, большим или равным 1024.
Файл политики безопасности, передаваемый по протоколу HTTP, не может разрешать сокетные подключения к портам ниже 1024 (однако стоит отметить, что до появления приложения Flash Player версии 9.0.28.0 это правило не действовало из-за ошибки).
Чтобы получить разрешение на установление заданного сокетного соединения из файла политики безопасности, передаваемого по протоколу HTTP, необходимо вручную загрузить этот файл до того, как будет предпринята попытка установить соединение, как показано в следующем обобщенном коде:
Security. 1 oadPol 1 cyFi1 е( "http: //z/oweH^TP/crossdomai n.xml");
В предыдущем коде доменИли1Р — это точное имя домена или точный IP-адрес желаемого сокетного соединения.
Отправив запрос на получение файла политики безопасности по протоколу HTTP, можно сразу же отправлять последующий запрос на подключение к желаемому порту. Предположим, что у сайта site-a.com есть следующий файл политики безопасности, размещенный на веб-сервере по адресу http://site-a.com/crossdomain.xml. Этот файл политики безопасности разрешает доступ для источников site-b.com и www.site-b.com:
<?xml version="1.0"?>
<!DOCTYPE cross-domain-policy
SYSTEM "http://www.adobe.com/xml/dtds/cross-domain-policy.dtd"> <cross-domain-policy>
<allow-access-from domain="www.site-b.com"/>
<allow-access-from domain="site-b.com"/>
</cross-domain-policy>
Чтобы подключиться к порту 9100 сайта site-a.com, любой SWF-файл, загруженный из источников site-b.com или www.site-b.com, может использовать следующий код.
// Запрашиваем файл политики безопасности по протоколу HTTP перед попыткой
// установления соединения
Security.1oadPolicyFile("http://site-a.com/crossdomain.xml"); var socket:Socket = new Socket( ): try {
// Пытаемся установить соединение (сразу после того, как был отправлен
// запрос на получение файла политики безопасности
socket.connect("site-a.com", 9100):
} catch (e:SecurityError) {
trace("Connection problem!"); trace(e.message):
}
При выполнении предыдущего кода приложение Flash Player перед тем, как разрешить запрашиваемое подключение к порту 9100, загружает файл политики
безопасности сайта site-c.com по протоколу HTTP. В списке разрешенных регионов этого файла политики безопасности содержится источник SWF-файла, устанавливающего соединение, поэтому подключение к порту 9100 может быть продолжено.
Мы познакомились со способами, с помощью которых распространитель ресурса может предоставить внешним SWF-файлам разрешение на загрузку данных, обращение к содержимому в виде данных и подключение к сокетам. В следующем разделе мы продолжим изучение механизмов разрешений приложения Flash Player, рассмотрев, как создатель SWF-файла может разрешить операцию кросс-скриптинга для SWF-файлов из внешних источников.
Разрешения создателя (allowDomain())
Как уже говорилось, разрешения распространителя позволяют выполнять операции обращения к содержимому в виде данных, загрузки данных и сокетных соединений. Разрешения распространителя называются так потому, что они должны быть установлены распространителем ресурса, к которому предоставляется доступ.
В отличие от этого, разрешения создателя — это разрешения, устанавливаемые создателем SWF-файла, а не его распространителем. Разрешения создателя более ограниченны, чем разрешения распространителя; они разрешают только операции кросс-скриптинга и скриптинга SWF-файлов из HTML-файлов.
В этой книге не рассматриваются операции скриптинга SWF-файлов из HTML-файлов. Подробную информацию о безопасности и операциях скриптинга SWF-файлов из HTML- файлов можно найти в разделах, описывающих статические методы allowDomain() и allowInsecureDomain(), справочника по языку ActionScript корпорации Adobe.
В отличие от разрешений распространителя, не зависящих от содержимого, к которому предоставляется доступ, разрешения создателя устанавливаются из SWF- файлов. Вызывая метод Security. allowDomain ( ) из SWF-файла, разработчик может разрешить SWF-файлам из внешних источников выполнять операции кросс-скриптинга над этим SWF-файлом. Например, файл app.swf содержит следующую строку кода:
Secur1ty.al 1owDomaln("s1te-b.com");
В этом случае любой SWF-файл, загруженный из источника site-b.com, может выполнять кросс-скриптинг файла app.swf. Более того, поскольку вызов метода allowDomain ( ) происходит внутри SWF-файла, предоставляемые разрешения остаются действительными независимо от размещения этого SWF-файла.
В отличие от разрешений распространителя, разрешения создателя передаются вместе с SWF-файлом, для которого они установлены.
Метод allowDomain ( ) имеет следующий обобщенный вид:
Security .allowDoma1n("/7OweHW^ . пдоменИли1Р2".... "доменИли1Рп")
где "доменИли1Р1", пдоменИли1Р2" . . . ”доменИли!Рп" — это список строк, содержащих доменные имена или IP-адреса разрешенных источников. SWF-файл, загруженный из разрешенного источника, может выполнять операции кросс-скриптинга над SWF-файлом, вызвавшим метод allowDomain ( ).
Как и в случае с файлами политики безопасности, символ * обозначает подстановочный символ. Например, следующий код разрешает доступ для всех источников (то есть любой SWF-файл из любого источника может выполнять кросс-скриптинг SWF-файла, который содержит следующую строку кода):
Security.al 1owDomaln("*");
Чтобы включить локальную область действия в список разрешенных источников, в качестве разрешаемого домена в метод allowDomain ( ) должен передаваться символ * (любой источник). Например, SWF-файл, желающий разрешить операцию кросс-скриптинга для локальных SWF-файлов с поддержкой сети, должен указать символ * в качестве разрешаемого домена.
Тем не менее, когда символ * используется в параметрах метода allowDomain ( ), он не может применяться в качестве подстановочного символа поддомена (это слегка необычное поведение отличается от использования группового символа в файлах политики безопасности). Например, следующий код не разрешает доступ для всех поддоменов сайта example.com:
// Внимание: Не используйте этот код! Подстановочные символы поддоменов // не поддерживаются.
Secu г1ty.al 1owDomaln ("*.example.com"):
Сразу после вызова метода allowDomain ( ) любой SWF-файл из разрешенного источника может немедленно приступать к выполнению разрешенных операций. Предположим, что телевизионная сеть использует универсальное приложение для воспроизведения анимации, которое размещается на сайте www. sometvnetwork. com. Проигрыватель загружает анимационные ролики в формате SWF с сайта animation.sometvnetwork.com. Для управления воспроизведением загруженных роликов проигрыватель вызывает основные методы класса MovieClip (play ( ), stop ( ) и т. д.) над этими роликами. Поскольку проигрыватель и анимационные ролики загружаются из различных поддоменов, проигрыватель должен получить разрешение на вызов методов классаMovieClip над роликами. Таким образом, каждый конструктор основного класса анимационного ролика включает следующую строку кода, которая предоставляет необходимое разрешение проигрывателю:
Secuг 1 ty. а 1*1 owDomaln("www. sometvnetwork. com". "sometvnetwork. com");
Обратите внимание, что, поскольку проигрыватель может быть открыт из источника www.sometvnetwork.com или sometvnetwork.com, анимационные файлы разрешают доступ для обоих доменов. Для загрузки анимационных роликов проигрыватель использует следующий код:
var loader:Loader = new Loadert ): loader.load(
new URLRequest("http://an1 mat1 on.sometvnetwork.com/названиеАнимации.swf"));
Сразу после выполнения конструктора основного класса анимационного ролика проигрыватель может приступать к управлению загруженным роликом.
Чтобы гарантировать, что разрешения на выполнение операций кросс-скриптинга будут предоставлены сразу после инициализации SWF-файла, вызывайте метод Security.allowDomain() внутри метода-конструктора основного класса этого SWF-файла.
SWF-файл может определить, есть ли у него разрешение на выполнение операций кросс-скриптинга над загруженным SWF-файлом, проверив значение переменной childAllowsParent объекта Loaderinfo загруженного файла.
Дополнительную информацию о загрузке SWF-файлов можно найти в гл. 28. Информацию по вызову методов клипа над загруженными SWF-файлами можно получить в разд. «Проверка типов на этапе компиляции для динамически загружаемых элементов» гл. 28.
Разрешение операций кросс-скриптинга над SWF-файлами, загружаемыми по протоколу HTTPS, для файлов, загружаемых по протоколу HTTP. Когда SWF- файл загружается по протоколу HTTPS, приложение Flash Player запрещает вызов метода allowDomain ( ), разрешающий доступ для источников, не использующих протокол HTTPS. Тем не менеё разработчики, желающие разрешить доступ для источников, не использующих протокол HTTPS, из SWF-файла, загружаемого по протоколу HTTPS, могут, соблюдая должную осторожность, использовать метод Security. allowInsecureDomain ( ).
' 1<§й Разрешение доступа для источника, не использующего протокол HTTPS, из SWF-файла, । загружаемого по протоколу HTTPS, считается угрожающе опасным и категорически не
рекомендуется.
Синтаксис и использование метода allowInsecureDomain ( ) такие же, как и у метода allowDomain ( ), рассмотренного в предыдущем разделе. Единственное отличие заключается в том; что метод allowInsecureDomain ( ) позволяет разрешить доступ для источников, не использующих протокол HTTPS, из SWF-файла, загружаемого по протоколу HTTPS. В подавляющем большинстве ситуаций для предоставления разрешений создателя следует использовать метод allowDomain ( ) вместо allowInsecureDomain ( ). Найти описание особых ситуаций, требующих использования метода allowInsecureDomain ( ), можно в разделе, посвященном методу Security. allowInsecureDomain ( ), справочника по языку ActionScript корпорации Adobe.
Импортирующая загрузка
В гл. 28 будет рассказано, как SWF-файл родителя может особым образом загрузить SWF-файл ребенка, что позволит родителю непосредственно использовать классы ребенка так, будто они определены в родителе. Эта методика требует, чтобы SWF- файл родителя импортировал классы SWF-файла ребенка в свой домен приложения. Рассмотрим базовый код, который должен включать SWF-файл родителя (обратите внимание на использование переменной экземпляра applicationDomain класса Loadercontext):
var loaderContext:LoaderContext = new LoaderContext( );
1oaderContext.appl1cationDomaln = Appl1cationDomaln.currentDomaln; var loader:Loader = new Loadert );
loader, load (new URLRequestCpe^OK.swf"). loaderContext);
При выполнении приведенного кода попытка импортировать классы ребенка в домен приложения родителя будет заблокирована системой безопасности приложения Flash Player в следующих ситуациях:
□ если SWF-файл родителя и SWF-файл ребенка загружены из различных удаленных регионов удаленной области действия;
□ если SWF-файл родителя загружен из локальной области действия и имеет тип безопасности песочницы, отличный от типа безопасности песочницы SWF- файла ребенка.
В первом случае распространитель SWF-файла ребенка может использовать файл политики безопасности, чтобы предоставить разрешение SWF-файлу родителя на импорт классов SWF-файла ребенка. Ниже представлены шаги, которые должны выполнить распространитель SWF-файла ребенка и создатель SWF-файла родителя.
Распространитель SWF-файла ребенка должен разместить файл политики безопасности, разрешающий доступ для источника SWF-файла родителя, как было описано в разд. «Разрешения распространителя (файлы политики безопасности)».•
Если файл политики безопасности находится не в применяемом по умолчанию местоположении, родитель должен загрузить его вручную, используя метод Security. loadPolicyFile ( ), опять же как было описано в разд. «Разрешения распространителя (файлы политики безопасности)».
При загрузке SWF-файла ребенка SWF-файл родителя должен передать в метод load ( ) объект LoaderContext, переменной securityDomain которого присвоено значение flash. system. SecurityDomain. currentDomain.
Предположим, что на сайте site-a.com размещен следующий используемый по умолчанию файл политики безопасности, который разрешает доступ для источников site-b.com и www.site-b.com.
<?xml version="1.0"?>
<!DOCTYPE cross-domaln-pol1 су
SYSTEM "http;//www.adobe.com/xml/dtds/cross-domaln-pol1cy.dtd"> <cross-doma1n-pol1cy>
<allow-access-from doma1n="www.s1te-b.com"/>
<allow-access-from doma1n="site-b.com"/>
</cross-domal n-policy>
Теперь предположим следующее: файл site-b.com/parent.swf желает импортировать классы файла site-a.com/child.swf в свой домен приложения. Для этого файл site-b.com/parent.swf использует следующий код (обратите внимание, что метод Security. loadPolicyFile ( ) не используется, поскольку файл политики безопасности находится в используемом по умолчанию местоположении файла политики безопасности):
var loaderContext:LoaderContext = new LoaderContext( ):
1oaderContext.appl1cationDomaln = Appl1cationDomaln.currentDomal n; loaderContext.securityDomain = SecurityDomain.currentDomaln;
1 oader.1oad(new URLRequest("http://s1te-a.com/chi1d.swf"), 1oaderContext);
Использование переменной securityDomain для получения разрешения распространителя на импорт классов SWF-файла в домен приложения (как показано в предыдущем коде) называется ампортируюгцей загрузкой.
Стоит отметить, что, когда некоторый файл а. swf применяет импортирующую загрузку для загрузки другого файла b. swf, приложение Flash Player считает, будто файл b. swf был сначала скопирован, а затем загружен непосредственно с сайта файла а. swf. Таким образом, к файлу b. swf применяются привилегии безопасности файла а. swf, а исходные привилегии безопасности файла b. swf, связанные с его реальным источником, аннулируются. Например, файл b. swf теряет возможность обращаться к ресурсам из своего реального источника с помощью относительных URL-адресов. Следовательно, при использовании импортирующей загрузки всегда проверяйте функционирование загруженного SWF-файла.
Импортирующая загрузка не требуется в следующих ситуациях, поскольку SWF- файлу родителя, по сути, разрешается импортировать классы SWF-файла ребенка в свой домен приложения:
локальный SWF-файл импортирует классы из другого локального SWF-файла с таким же типом безопасности песочницы;
удаленный SWF-файл импортирует классы из другого удаленного SWF-файла, находящегося в том же регионе.
Механизмы обращения к классам в загруженных SWF-файлах рассматриваются в гл. 28 и 31.
Обработка нарушений безопасности
В этой главе мы рассмотрели несколько правил безопасности, которые влияют на способность SWF-файла выполнять различные операции языка ActionScript. Когда операция не может быть выполнена из-за нарушения правила безопасности, среда выполнения либо генерирует исключение SecurityError, либо осуществляет диспетчеризацию события SecurityErrorEvent. SECURITY_ERROR.
Исключение SecurityError генерируется в том случае, когда можно сразу определить, что операция нарушает правило безопасности. Например, если локальный SWF-файл с поддержкой файловой системы пытается открыть сокетное соединение, среда выполнения ActionScript немедленно выявляет факт нарушения безопасности и генерирует исключение SecurityError.
В отличие от этого, диспетчеризация события SecurityErrorEvent. SECURITY_ERROR происходит в том случае, когда после ожидания завершения некоторой асинхронной задачи среда Flash определяет, что было нарушено правило безопасности. Например, когда локальный SWF-файл с поддержкой сети использует метод экземпляра load ( ) класса URLLoader для загрузки файла из удаленной области действия,
среда Flash должна асинхронно проверить наличие подходящего файла политики безопасности, разрешающего операцию загрузки. Если операция проверки файла политики безопасности завершится неудачей, среда Flash выполнит диспетчеризацию события SecurityErrorEvent. SECURITY_ERROR (заметьте — не исключение SecurityError).
В отладочной версии приложения Flash Player выявить необработанные исключения SecurityError и события SecurityErrorEvent. SECURITY_ERROR очень просто. Всякий раз, когда возникает данное исключение или событие, приложение Flash Player выводит окно, в котором описывается возникшая проблема. Отладочная версия приложения Flash Player абсолютно отличается от рабочей версии, в которой никакая информация о необработанных исключениях SecurityError и событиях SecurityErrorEvent. SECURITY_ERROR не отображается, поэтому выявить проблему может оказаться чрезвычайно сложно.
Чтобы убедиться, что никакие нарушения безопасности не остались незамеченными, всегда проверяйте код в отладочной версии приложения Flash Player.
Для обработки ошибок безопасности используется инструкция try/catch/ finally. Для обработки событий SecurityErrorEvent. SECURITY_ERROR применяются приемники событий. Например, следующий код генерирует исключение SecurityError, пытаясь установить сокетное подключение к порту выше 65 535. При возникновении ошибки код добавляет сообщение о причине ее возникновения в объект TextField, отображаемый на экране.
var socket:Socket = new Socket( );
try {
socket-.connectC'example.com". 70000);
} catch (e:Secur1tyError) {
output.appendText("Connection problem!\n");
output.appendText(e.message);
Подобным образом, пытаясь загрузить файл данных с сайта, не имеющего файла политики безопасности, локальный SWF-файл с поддержкой сети, содержащий следующий код, вызовет диспетчеризацию события SecurityErrorEvent. SECURITY_ERROR. Перед тем как попытаться осуществить операцию загрузки, код регистрирует приемник события, который выполняется при диспетчеризации события SecurityErrorEvent.SECURITY_ERROR.
var url1 odder:URLLoader = new URLLodder( );
// Регистрируем приемник события
urlloader.addEventLI stener(SecurityErrorEvent.SECURITY-ERROR, secur1tyErrorL1stener);
// Вызываем нарушение безопасности
urlloader.load(new URLRequestChttp://www.example.com/1ndex.xml"));
На момент издания этой книги на сайте example.com не было файла политики безопасности, размещенного в местоположении, используемом по умолчанию, поэтому предыдущий код приводил к диспетчеризации события SecurityErrorEvent. SECURITY_ERROR.
Приемник для предыдущего события SecurityErrorEvent. SECURI TY_ERROR, код которого приведен ниже, добавляет сообщение о причине возникновения ошибки в объект TextField, отображаемый на экране, — output:
private function securityErrorListener (e:SecurityErrorEvent):void {
output.appendText("Loading problem!\n");
output.appendText(e.text);
}
Чтобы определить, может ли эта операция генерировать исключение Secur ityError или приводить к диспетчеризации события SecurityErrorEvent. SECURI TY_ERROR, обратитесь к соответствующему разделу справочника по языку ActionScript корпорации Adobe. Описание каждой операции содержит список возможных исключений SecurityError под заголовком Throws (Генерирует) и список возможных событий SecurityErrorEvent. SECURITY_ERROR под заголовком Events (События).
В большинстве случаев класс, который определяет операцию, генерирующую событие SecurityErrorEvent. SECURITY_ERROR, одновременно является классом, в котором должны регистрироваться приемники событий. Например, класс URLLoader определяет операцию load ( ), которая может приводить к диспетчеризации событий SecurityErrorEvent. SECURI TY_ERROR. Приемники событий, обрабатывающие события SecurityErrorEvent. SECURITY_ERROR, вызванные методом экземпляра load ( ) класса URLLoader, регистрируются в том экземпляре класса URLLoader, над которым вызывается метод load ( ). Это демонстрирует следующий код:
// При использовании класса URLLoader регистрируйтесь на события
// в экземпляре класса URLLoader.
var urlloader:URLLoader = new URLLoader( );
url 1 odder.addEventLi stener(SecurityErrorEvent.SECURITY-ERROR, securityErrorListener);
Однако в некоторых случаях класс, определяющий операцию, которая генерирует событие SecurityErrorEvent. SECURITY_ERROR, не является одновременно классом, в котором должны регистрироваться приемники событий. Например, класс Loader определяет операцию load ( ), которая может приводить к диспетчеризации событий SecurityErrorEvent. SECURITY_ERROR. Но приемники событий, обрабатывающие данные события, должны регистрироваться в экземпляре класса Loaderinfo, ассоциированном с операцией load ( ), а не в экземпляре класса Loader, над которым вызывается метод load ( ). Как и раньше, это демонстрирует следующий код:
// При использовании класса Loader регистрируйтесь на события
// в экземпляре класса Loaderinfo.
var loader:Loader = new Loader( );
oader.contentLodderInfo.dddEventListener(SecurityErrorEvent.SECURITY-ERROR, securityErrorListener);
Чтобы определить класс, в котором должны регистрироваться приемники событий SecurityErrorEvent. SECURITY_ERROR для данной операции, обратитесь к справочнику по языку ActionScript корпорации Adobe. В частности, эту информа-
цию можно найти в описании класса, определяющего операцию, которая приводит к диспетчеризации события SecurityErrorEvent. SECURI TY_ERROR.
Домены безопасности
В этом разделе вы получите общее представление о термине «домен безопасности» и его обычном эквиваленте «песочница безопасности», который часто применяется в документации корпорации Adobe и других сторонних источниках. В данной книге ни один из этих терминов не используется. Причины этого будут описаны далее.
Определенный SWF-файл и логический набор ресурсов, к которым этот SWF-файл может свободно обращаться, используя операции обращения к содержимому в виде данных, загрузки данных и кросс-скриптинга (в соответствии с табл. 19.3-19.6), вместе концептуально формируют группу, называемую доменом безопасности. В табл. 19.9 перечислены составляющие домена безопасности SWF-файла каждого из четырех типов безопасности песочниц.
Не путайте понятия «тип безопасности песочницы» и «домен безопасности». Тип безопасности песочницы — это общий статус безопасности SWF-файла, а домен безопасности — это логический набор ресурсов. Тип безопасности песочницы SWF-файла на самом деле определяет домен безопасности этого файла во многом аналогично тому, как уровень доступа сотрудника компании может определять доступные зоны в здании компании.
Таблица 19.9. Домены безопасности по типу безопасности песочницы
Тип безопасности песочницы SWF-файла
Составляющие домена безопасности
Удаленный
Ресурсы в формате, отличном от формата SWF, из региона происхождения данного SWF-файла.
SWF-файлы из региона происхождения данного SWF-файла
Локальный с поддержкой файловой системы
Ресурсы в формате, отличном от формата SWF, в локальной области действия.
Локальные SWF-файлы с поддержкой файловой системы в локальной области действия
Локальный с поддержкой сети
Локальные SWF-файлы с поддержкой сети в локальной области действия
Локальный с установленным доверием
Любые ресурсы в формате, отличном от формата SWF, в локальной и удаленной области действия.
Локальные SWF-файлы с установленным доверием в локальной области действия
При обсуждении домены безопасности часто описываются в терминах регионов — метафорических безопасных зон. Таким образом, можно сказать, что SWF-файл принадлежит домену безопасности, находится в нем или помещается в свой домен безопасности. Подобным образом можно сказать, что ресурс доступен для SWF- файла, поскольку он принадлежит домену безопасности этого SWF-файла.
Существует всего четыре типа безопасности песочницы, однако для каждого из них есть множество доменов безопасности. Например, любой SWF-файл в удаленной
области действия имеет один и тот же тип безопасности песочницы — «удаленный». Но удаленный SWF-файл из источника site-a.com и удаленный SWF-файл из источника site-b.com являются частями двух различных доменов безопасности (один — для источника site-a.com, а другой — для источника site-b.com). Подобным образом любой SWF-файл из местоположения с установленным доверием в локальной области действия имеет один и тот же тип безопасности песочницы — «локальный с установленным доверием». Однако два локальных SWF-файла с установленным доверием из различных корпоративных локальных сетей являются частями двух различных доменов безопасности (каждый для своей локальной сети).
В документации корпорации Adobe при описании ресурсов, к которым имеет или не имеет доступ SWF-файл, часто используется термин «домен безопасности» (и его обычный эквивалент «песочница безопасности»).
Двусмысленное использование термина «песочница». Как уже известно из предыдущего раздела, и в неофициальной литературе, посвященной безопасности приложения Flash Player, и в документации корпорации Adobe часто используется термин «песочница безопасности» и даже просто «песочница» в качестве обычного эквивалента формального термина «домен безопасности». Более того, в некоторых редких случаях, в неофициальной литературе и в документации корпорации Adobe также применяется термин «песочница безопасности» в качестве обычного эквивалента термина «тип безопасности песочницы».
*lC$5 ПРИ чтении документации, посвященной безопасности, помните, что термин «песочница» । обычно используется для обозначения домена безопасности, а в некоторых случаях — для
обозначения типа безопасности песочницы.
Чтобы избежать подобной путаницы, в этой книге обычные термины «песочница безопасности» и «песочница» не используются вообще, а официальный термин «домен безопасности» используется только в случае крайней необходимости (например, при обсуждении внутреннего класса Secur ityDomain). Кроме того, статус безопасности SWF-файла всегда описывается по отношению к типу безопасности песочницы этого SWF-файла. Ресурсы, к которым может обращаться SWF-файл, в этой книге перечисляются явным образом вместо использования общего термина «домен безопасности» для описания логической группы доступных ресурсов.
Например, рассмотрим такое предложение из раздела Programming ActionScript 3.0 ► Flash Player APIs ► Flash Player Security ► Security Sandboxes ► Local sandboxes документации корпорации Adobe:
Local files that are registered as trusted are placed in the local-trusted sandbox.
Если использовать термины, которым отдается предпочтение в этой книге, предыдущая цитата будет звучать так: Локальным файлам, зарегистрированным в качестве файлов с установленным доверием, присваивается тип безопасности песочницы «локальный с установленным доверием».
Далее рассмотрим следующее предложение, на этот раз из раздела Programming ActionScript 3.0 ► Flash Player APIs ► Flash Player Security ► Accessing loaded media as data документации корпорации Adobe:
By default, a SWF file from one security sandbox cannot obtain pixel data or audio data from graphic or audio objects rendered or played by loaded media 1n another sandbox.
Если использовать термины, которым отдается предпочтение в этой книге, приведенная цитата будет звучать так: По умолчанию SWF-файл из одного домена безопасности не может получать данные о пикселах либо аудиоданные из графических или звуковых объектов, отображаемых или воспроизводимых загрузившим их элементом за пределами данного домена безопасности.
Если значение термина «песочница» в документации корпорации Adobe или в неофициальных источниках кажется двусмысленным, сосредоточьте внимание на изученных типах безопасности песочниц, а также на разрешенных и запрещенных операциях. В противном случае просто попытайтесь выполнить желаемую операцию и используйте сообщения об ошибках, связанных с нарушением безопасности, которые генерируются компилятором или на этапе выполнения, чтобы определить, разрешена ли данная операция. Тем не менее, чтобы гарантировать, что будут отображены все сообщения обо всех возможных ошибках, связанных с нарушениями безопасности, следуйте рекомендациям, представленным ранее в подразд. «Для разработчиков доверие устанавливается автоматически» разд. «Выбор локального типа безопасности песочницы», и проводите тестирование в отладочной версии приложения Flash Player. Помните также, что вы можете проверить тип безопасности песочницы SWF-файла на этапе выполнения, получив значение переменной flash, system. Security. sandboxType. Знание типа безопасности песочницы SWF-файла поможет вам определить ограничения, накладываемые на этот SWF- файл приложением Flash Player.
Две распространенные пробпемы разработки, связанные с безопасностью
При изучении этой главы мы рассмотрели множество ограничений безопасности и механизмов предоставления разрешений. Чтобы завершить наше изучение системы безопасности приложения Flash Player, рассмотрим два сценария, связанных с безопасностью, которые часто встречаются в типичном процессе разработки приложений на языке ActionScript: обращение к поддоменам Интернета и обращение к переменной экземпляра context класса Loader. В каждом сценарии описывается ограничение и соответствующий обходной путь для него.
Обращение к поддоменам Интернета
Из представленной ранее табл. 19.3 известно, что удаленный SWF-файл может загружать данные только из своего удаленного региона происхождения. Из разд. «Локальная область действия, удаленная область действия и удаленные регионы» вы также узнали, что два различных поддомена Интернета, например www.example.com и games.example.com, считаются разными удаленными регионами. Таким образом, SWF-файл, загруженный из источника http://example.com, может загружать любой
файл данных, размещенный в источнике http://example.com, но не может загружать файлы данных, размещенные в любом другом домене, включая поддомены, например games.example.com. Как ни удивительно, но это означает, что SWF-файл, загруженный из источника http://example.com, не может использовать абсолютный URL-адрес для обращения к файлу, размещенному на сайте www.example.com. Для предоставления SWF-файлу, загруженному из источника example.com, разрешения на загрузку элементов с сайта www.example.com используется файл политики безопасности — этот механизм был рассмотрен ранее в разд. «Разрешения распространителя (файлы политики безопасности)».
Следующая последовательность шагов описывает действия владельца сайта example.com, желающего создать файл политики безопасности, который разрешает SWF-файлам, загружаемым из источника example.com, загружать файлы данных с сайта www.example.com и наоборот.
Создайте новый текстовый файл с именем crossdomain. xml. .
Откройте файл crossdomain. xml в текстовом редакторе.
Добавьте следующий XML-код в этот файл:
<?xml version="1.0"?>
<!DOCTYPE cross-domain-policy
SYSTEM "http://www.adobe.com/xml/dtds/cross-domain-pol1cy.dtd"> <c ross-doma1n-po11cy>
<allow-access-from domain="www.example.com" />
<allow-access-from domain="example.com" />
</cross-doma1n-po!1cy>
Сохраните файл crossdomain. xml.
Выгрузите файл crossdomain. xml в корневую директорию сайта example.com (чтобы этот файл был доступен по адресу http://example.com/crossdomain.xml).
Обращение к переменной экземпляра content класса Loader
Когда отображаемый элемент из внешнего источника загружается с помощью объекта Loader, экземпляр загруженного элемента помещается в переменную content объекта Loader. Как было сказано ранее в подразд. «Обращение к содержимому в виде данных» разд. «Ограничения на загрузку содержимого, обращение к содержимому в виде данных, кросс-скриптинг и загрузку данных», обращение к значению переменной content считается либо операцией обращения к содержимому в виде данных (если объект, содержащийся в переменной content, является изображением), либо операцией кросс-скриптинга (если объект, содержащийся в переменной content, является экземпляром основного класса SWF-файла). Таким образом, в соответствии с ограничениями типов безопасности песочниц, представленными в табл. 19.3-19.5, обращение к загруженному элементу с помощью переменной content без необходимого разрешения приведет к возникновению ошибки безопасности в ситуациях, когда:
□ удаленный SWF-файл использует переменную content для обращения к ресурсу, загружаемому из другого удаленного региона;
локальный SWF-файл с поддержкой сети использует переменную cont ent для обращения к ресурсу, загружаемому из удаленной области действия;
локальный SWF-файл с поддержкой сети использует переменную content для обращения к локальному SWF-файлу с установленным доверием;
локальный SWF-файл с поддержкой файловой системы использует переменную content для обращения к локальному SWF-файлу с установленным доверием.
Если вы столкнетесь с любой из описанных ситуаций в своем коде, то должны рассмотреть возможность полностью избежать использования переменной content. Если ваше приложение должно только отображать загруженный элемент на экране, то обращаться к переменной content совершенно не обязательно. Чтобы отобразить загруженный элемент на экране, не обращаясь к переменной content, просто добавьте объект Loader этого элемента — а не значение переменной content — прямо в список отображения. Дополнительную информацию и пример кода можно найти в подразд. «Отображение загруженного элемента на экране» разд. «Использование класса Loader для загрузки отображаемых элементов на этапе выполнения» гл. 28.
Стоит отметить, однако, что в следующих ситуациях использование переменной content обязательно, и, чтобы избежать ситуаций нарушения безопасности, должны быть установлены соответствующие разрешения создателя или распространителя:
SWF-файлу, загружающему элемент, требуется доступ к данным элемента, например, чтобы прочитать пикселы растрового изображения;
SWF-файлу, загружающему элемент, необходимо выполнить операцию кроссскриптинга для загруженного элемента;
к загруженному элементу необходимо обращаться непосредственно в виде объекта, например, когда объект, представляющий загруженный элемент, должен передаваться в метод, аргументом которого является объект Bitmap.
Дополнительную информацию о классе Loader можно найти в гл. 28, про список отображения вы прочитаете в гл. 20.
К части II!
В первой части вы познакомились с большинством основополагающих концепций языка ActionScript. В части II мы сосредоточимся на конкретной составляющей интерфейса API среды выполнения Flash, называемой API отображения. Впереди нас ожидает множество примеров кода и реальных сценариев программирования, поэтому будьте готовы применить свои знания базового языка ActionScript, заработанные таким тяжелым трудом!
ЧАСТЬ II
Отображение и интерактивность
В этой части представлены методы отображения содержимого на экране и обработки событий ввода. К рассматриваемым темам* относятся API отображения среды выполнения Flash, иерархическая обработка событий, реализация интерактивности с использованием клавиатуры и мыши, анимация, векторная и растровая графика, текст и операции загрузки содержимого.
Прочитав часть II, вы сможете добавлять графическое содержимое и интерактивные возможности в ваши собственные приложения.
Глава 20 «API отображения и список отображения».
Глава 21 «События и иерархии отображения».
Глава 22 «Интерактивность».
Глава 23 «Обновления экрана».
Глава 24 «Программная анимация».
Глава 25 «Рисование с помощью векторов».
Глава 26 «Программирование растровой графики».
Глава 27 «Отображение и ввод текста».
Глава 28 «Загрузка внешних отображаемых элементов».
API отображения и список отображения
Одной из основных задач в программировании на языке ActionScript является отображение объектов на экране. В этой связи платформа Flash предлагает широкий набор инструментов для создания и управления графическим содержимым. Данные инструменты можно разделить на две общие категории.
API отображения среды выполнения Flash — набор классов для работы с интерактивными графическими объектами, растровыми изображениями и векторным содержимым.
Готовые компоненты пользовательского интерфейса:
набор компонентов пользовательского интерфейса платформы разработки Flex — развитый набор настраиваемых компонентов пользовательского интерфейса, построенный на базе API отображения;
набор компонентов пользовательского интерфейса среды разработки Flash — набор компонентов пользовательского интерфейса, благодаря которым уменьшается размер файла приложения и снижается потребление памяти, однако данные компоненты обладают более ограниченными возможностями по сравнению с набором компонентов пользовательского интерфейса платформы разработки Flex.
Интерфейс API отображения встроен непосредственно во все среды выполнения Flash и, как результат, доступен для всех SWF-файлов. Интерфейс API отображения предназначен для создания максимально настраиваемых пользовательских интерфейсов или визуальных эффектов наподобие тех, которые часто встречаются в мультипликационной графике и играх. В этой главе все внимание сосредоточено на интерфейсе API отображения.
Набор компонентов пользовательского интерфейса платформы разработки Flex является частью платформы разработки Flex — внешней библиотеки классов, поставляемой вместе с приложением Adobe Flex Builder. Эта библиотека также доступна для бесплатной загрузки по адресу http://www.adobe.com/go/flex2_sdk. Набор компонентов графического интерфейса платформы разработки Flex разработан для построения приложений с относительно стандартными элементами управления пользовательского интерфейса (полосами прокрутки, раскрывающимися меню, таблицами данных и т. д.). Элементы интерфейса платформы разработки Flex обычно используются в приложениях MXML, но могут включаться и в приложения, разработанные в основном с использованием языка ActionScript. Подробности использования платформы разработки Flex в приложениях на языке ActionScript можно найти в гл. 30.
Набор компонентов пользовательского интерфейса среды разработки Flash предназначен для использования в SWF-файлах, созданных в среде разработки Flash, а также, когда размер файла и низкое потребление памяти оказываются гораздо важнее расширенных возможностей компонента, например связывания данных и улучшенных возможностей стилизации. Набор компонентов пользовательского интерфейса среды разработки Flash и набор компонентов пользовательского интерфейса платформы разработки Flex используют очень похожий интерфейс API, что позволяет разработчикам применять полученные знания при переходе от одного набора компонентов к другому.
В приложении Flash Player 8 и более старых версиях язык ActionScript предоставлял следующие четыре основных строительных блока для создания и управления графическим содержимым.
Клип — контейнер для графического содержимого, реализующий интерактивные возможности, простейшее рисование, иерархическое размещение элементов и анимационные возможности.
Текстовое поле — прямоугольная область, содержащая отформатированный текст.
Кнопка — элемент ввода, представляющий собой очень простую интерактивную кнопку.
Растровое изображение (появилось в приложении Flash Player 8) — графическое изображение в растровом формате.
Перечисленные элементы остаются доступными в интерфейсе API отображения, однако представляющие их классы в языке ActionScript 3.0 (MovieClip, Text Field, SimpleButton и Bitmap) были улучшены, переработаны и приобрели больше возможностей.
Обзор API отображения
В языке ActionScript все графическое содержимое создается и управляется с помощью классов интерфейса API отображения. Даже элементы интерфейса платформы разработки Flex и среды разработки Flash используют интерфейс API отображения в качестве графической основы. Многие классы API отображения непосредственно представляют конкретный тип графического содержимого, выводимого на экран. Например, класс Bitmap представляет растровые изображения, класс Sprite — интерактивную графику, а класс TextField — отформатированный текст.
При обсуждении мы будем называть классы, которые непосредственно представляют отображаемое на экране содержимое (и суперклассы этих классов), базовыми классами отображения. Остальные классы API отображения определяют вспомогательную графическую информацию и функциональность, но сами не представляют содержимое на экране. Например, классы CapStyle и Jointstyle определяют константы, представляющие настройки для рисования линий, в то время как классы Graphics и BitmapData задают множество примитивных операций рисования. Мы будем называть такие классы, не отображающие информацию на
экране, вспомогательными классами отображения. Большинство базовых и вспомогательных классов API отображения находятся в пакете flash. display.
Базовые классы отображения, представленные на рис. 20.1, образуют иерархию, которая отражает три базовых уровня функциональности: отображение, пользовательскую интерактивность и содержание. Соответственно тремя важнейшими классами API отображения являются: Displayobject, InteractiveObject и DisplayObjectContainer. Непосредственно создать экземпляры этих классов невозможно, однако они определяют абстрактную функциональность, которая реализуется различными конкретными подклассами.
Как уже говорилось в гл. 6, ActionScript 3.0 не поддерживает настоящие абстрактные классы. Поэтому на рис. 20.1 классы Displayobject, InteractiveObject и DisplayOb j ectContainer показаны не как абстрактные классы, а как классы абстрактного типа. Тем не менее, несмотря на эту техническую деталь, для краткости в оставшейся части этой главы мы будет использовать термин «абстрактный» при описании архитектурной роли, которую играют классы Displayobject, InteractiveObject иDisplayObjectContainer.
Конкретный класс отображения
|| Содержимое, доступное
только в среде разработки
о Класс абстрактного типа
MovieClip
Рис. 20.1. Иерархия базовых классов отображения
Класс DisplayOb j ect — корневой элемент в иерархии базовых классов отображения, он определяет первый уровень графической функциональности API отображения — вывод на экран. Все классы, унаследованные от DisplayOb j ect, получают общий набор основных графических характеристик и возможностей. Например, для любого потомка класса DisplayOb j ect можно изменить его позицию, размеры и угол поворота с помощью переменных х, у, width, height и rotation. Класс
DisplayOb j ect — это не просто базовый класс; это источник многих расширенных возможностей в API отображения, включая следующие, но не ограничиваясь ими:
преобразование координат (ознакомьтесь с описанием методов экземпляра localToGlobal ( ) и globalToLocal ( ) класса DisplayObject в справочнике по языку ActionScript корпорации Adobe);
определение пересечений между объектами и точками (ознакомьтесь с описанием методов экземпляра hitTestObject ( ) и hitTestPoint ( ) класса DisplayOb j ect в справочнике по языку ActionScript);
применение фильтров, трансформаций и масок (ознакомьтесь с описанием переменных экземпляра filters, transform и mask класса Displayobject в справочнике по языку ActionScript);
непропорциональное изменение масштаба для «растягиваемых» графических элементов (ознакомьтесь с описанием переменной экземпляра scale 9gr id класса DisplayOb j ect в справочнике по языку ActionScript корпорации Adobe).
Обратите внимание, что иногда в этой книге используется неофициальный термин «отображаемый объект», который обозначает любой экземпляр класса, унаследованного от класса DisplayOb j ect.
Конкретные непосредственные подклассы класса DisplayOb j есt — Video, Bitmap, Shape, MorphShape и StaticText — представляют простейший тип отображаемого содержимого: базовую графику, выводимую на экран, которая не может получать вводимые данные или содержать другое вложенное графическое содержимое. Класс Video представляет потоковое видео. Класс Bitmap визуализирует растровые изображения, созданные и управляемые вспомогательным классом BitmapData. Класс Shape предоставляет простой, облегченный холст для векторного рисования. Специальные классы MorphShape и StaticText представляют соответственно фигуры с преобразуемой формой и статический текст, созданные в среде разработки Flash. Ни класс MorphShape, ни класс StaticText не могут быть созданы на языке ActionScript.
Единственный абстрактный подкласс Interact iveObj ect класса DisplayOb j ect образует второй уровень функциональности в API отображения — интерактивность. Все унаследованные от него классы получают возможность отвечать на события ввода от мыши и клавиатуры пользователя.
Конкретные непосредственные подклассы TextField и SimpleButton класса InteractiveObject представляют два различных типа интерактивного графического содержимого. Класс TextField представляет прямоугольную область для отображения отформатированного текста и получения вводимых пользователем данных. Класс SimpleButton представляет символы Button (Кнопка), создаваемые в среде разработки Flash, а также позволяет быстро создавать интерактивные кнопки из кода на языке ActionScript. Обрабатывая события ввода, передаваемые классами TextField или SimpleButton, программист может добавлять интерактивность в приложение. Например, экземпляр класса TextField может быть запрограммирован так, чтобы в ответ на событие FocusEvent. FOCUS IN изменялся цвет фона этого экземпляра, а экземпляр класса SimpleButton может быть запрограммирован так, чтобы в ответ на событие MouseEvent. CLICK форма отправлялась на сервер.
Абстрактный подкласс DisplayOb j ectContainer класса InteractiveOb j ect представляет основу третьего и последнего функционального уровня в API отображения — содержание. Все унаследованные от него классы получают возможность содержать любой другой экземпляр класса DisplayOb j ect.
Контейнеры используются для объединения нескольких графических объектов, что позволяет обрабатывать их вместе. Всякий раз, когда контейнер перемещается, поворачивается или трансформируется, все содержащиеся в нем объекты наследуют это перемещение, вращение или трансформацию. Подобным образом всякий раз, когда контейнер удаляется с экрана, содержащиеся в нем объекты удаляются вместе с ним. Более того, контейнеры могут быть вложены внутрь других контейнеров для создания иерархических групп отображаемых объектов.
При описании объектов в иерархии отображения в этой книге применяется стандартная терминология для описания древовидных структур. Например, объект, который содержит другой объект в иерархии отображения, называется родителем этого объекта, а содержащийся объект называется ребенком этого родителя. В многоуровневой иерархии отображения объекты, расположенные выше данного объекта в иерархии, называются предками этого объекта. С другой стороны, объекты, расположенные ниже данного объекта в иерархии, называются потомками этого объекта. Наконец, объект самого верхнего уровня в иерархии (объект, потомками которого являются все остальные объекты) называется корневым объектом.
Не путайте объекты-предки и объекты-потомки в иерархии отображения с классами- предками и классами-потомками в иерархии наследования. Для ясности в этой книге иногда используются термины «предки отображения» и «потомки отображения» для описания объектов-предков и объектов-потомков в иерархии отображения.
Каждый из подклассов класса DisplayObj ectContainer — Sprite, MovieClip, Stage и Loader — обеспечивает уникальный тип пустой содержащей структуры, ожидающей заполнения содержимым. Класс Sprite — это важнейший элемент среди классов-контейнеров. Являясь потомком классов InteractiveObject и DisplayOb j ectContainer, класс Sprite предоставляет отличную основу для построения собственных элементов пользовательского интерфейса с нуля. Класс MovieClip — это расширенный тип класса Sprite, представляющий анимированное содержимое, которое было создано в среде разработки Flash. Класс Stage представляет основную область отображения (видимую область внутри границ окна приложения) среды выполнения Flash. Наконец, класс Loader используется для загрузки внешнего графического содержимого из локального источника или через Интернет.
Й
До появления языка ActionScript 3.0 класс MovieClip использовался как универсальный графический контейнер (подобно использованию класса Sprite в языке ActionScript 3.0). С появлением версии 3.0 ActionScript класс MovieClip применяется только для управления экземплярами символов клипов, созданных в среде разработки Flash. Поскольку язык ActionScript 3.0 не предоставляет способ для создания элементов временной шкалы, например кадров и фигур с изменяемой формой, нет необходимости создавать пустые клипы на этапе выполнения приложения, написанного на языке ActionScript 3.0. Вме-
сто этого любое графическое содержимое, создаваемое программным путем, должно являться экземпляром одного из подходящих базовых классов отображения (Bitmap, Shape, Sprite, TextField и т. д.).
Интерфейс API отображения предоставляет широкие возможности, которые доступны через сотни методов и переменных. Многие из них рассматриваются в этой книге. В следующих же разделах мы сосредоточимся не на систематическом рассмотрении каждого метода и переменной, а на фундаментальных концепциях. Описание всех методов и переменных API отображения можно найти в справочнике по языку ActionScript корпорации Adobe.
Расширение иерархии базовых классов отображения. Хотя в большинстве случаев базовые классы отображения могут эффективно использоваться без внесения каких-либо изменений, большинство нетривиальных программ расширяют функциональность базовых классов отображения, создавая подклассы для собственных целей. Например, программа, рисующая геометрические фигуры, может определить классы Ellipse, Rectangle и Triangle, расширяющие класс Shape. Подобным образом, в приложении для просмотра новостей может быть определен класс Heading, который расширяет класс TextField, а в гоночной игре может быть определен класс Саг, который расширяет класс Sprite. На самом деле элементы пользовательского интерфейса в платформе разработки Flex являются потомками класса Sprite. В последующих главах мы увидим множество примеров пользовательских классов отображения. По мере изучения базовых классов отображения задумайтесь о том, как можно расширить их функциональность. Зачастую программисты на языке ActionScript расширяют и улучшают базовые классы отображения с помощью собственного кода. Дополнительную информацию можно найти далее, в разд. «Пользовательские графические классы».
Список отображения
Как уже говорилось, базовые классы отображения представляют типы графического содержимого, доступного в языке ActionScript. Чтобы создать реальную графику из этих теоретических типов, мы создаем экземпляры базовых классов отображения, а затем добавляем эти экземпляры в список отображения. Список отображения — это иерархия всех графических объектов, отображаемых средой выполнения Flash в настоящий момент. Когда отображаемый объект добавляется в список отображения и помещается в видимую область, среда Flash визуализирует содержимое этого объекта на экране.
Корневым элементом списка отображения является экземпляр класса Stage, который создается автоматически при запуске среды выполнения Flash. Этот особый, автоматически создаваемый экземпляр класса Stage выполняет две задачи. Во-первых, он выступает в качестве внешнего контейнера для всего графического содержимого, отображаемого средой выполнения Flash (то есть является корнем списка отображения). Во-вторых, он предоставляет информацию о глобальных характеристиках области отображения и позволяет управлять ими. Например, переменная экземпляра qualitу класса Stage определяет качество визуализации всей
отображаемой графики; переменная scaleMode задает способ масштабирования графики при изменении размеров области отображения; переменная f rameRate определяет текущую предпочтительную скорость (кадров в секунду) для всех анимационных роликов. Как будет рассказано в этой главе, обращение к экземпляру класса Stage всегда осуществляется через некоторый объект в списке отображения с помощью переменной экземпляра stage класса Displayobject. Например, если output_txt — экземпляр класса TextField, который в настоящий момент находится в списке отображения, обратиться к экземпляру класса Stage можно выражением output_txt. stage.
До появления языка ActionScript 3.0 класс Stage не содержал объекты из списка отображения. Более того, ко всем его методам и переменным можно было обращаться непосредственно через сам класс, как показано в следующем коде:
trace(Stage.align);
В языке ActionScript 3.0 к методам и переменным класса Stage нельзя обратиться через класс Stage, кроме того, не существует глобальной точки, ссылающейся на экземпляр класса Stage. В языке ActionScript 3.0 приведенная строка кода вызовет следующую ошибку:
Access of possibly undefined property 'align' through a reference with static type 'Class'
На русском языке она будет звучать так: Обращение к возможно неопределенному свойству 'align* через ссылку на статический класс 'Class'.
Чтобы избежать появления этой ошибки, обращайтесь к экземпляру класса Stage с помощью следующего подхода:
trace(некийОтображаемыйОбъект.stage.align):
Здесь некийОтображаемыйОбъект — это объект, который в настоящий момент находится в списке отображения. Архитектура класса Stage в языке ActionScript 3.0 позволяет в будущем иметь несколько экземпляров класса Stage, а также вносит вклад в систему безопасности приложения Flash Player (поскольку неавторизованные объекты, загруженные из внешних источников, не имеют глобальной точки для обращения к экземпляру класса Stage).
На рис. 20.2 представлено состояние списка отображения для пустой среды выполнения Flash до момента открытия SWF-файла. Левая часть рисунка демонстрирует символическое представление среды выполнения Flash, а правая часть — соответствующую иерархию списка отображения. Когда среда Flash пуста, иерархия списка отображения содержит всего один элемент (единственный экземпляр класса Stage). Но скоро появятся другие элементы!
Когда пустая среда Flash открывает новый SWF-файл, она находит основной класс этого SWF-файла, создает экземпляр данного класса и добавляет созданный экземпляр в список отображения в качестве первого ребенка экземпляра класса Stage.
Напомним, что основной класс SWF-файла должен быть унаследован либо от класса Sprite, 4 е либо от класса MovieClip, каждый из которых является потомком класса Displayobject.
Методики определения основного класса SWF-файла рассматриваются в гл. 7.
Список отображенияСписок отображенияРис. 20.2. Список отображения для пустой среды выполнения FlashРис. 20.2. Список отображения для пустой среды выполнения FlashЭкземпляркласса StageЭкземпляркласса Stage
Список отображения
Список отображения
Рис. 20.2. Список отображения для пустой среды выполнения Flash
Рис. 20.2. Список отображения для пустой среды выполнения Flash
Экземпляркласса Stage
Экземпляркласса Stage
Экземпляр основного класса SWF-файла является точкой входа программы и первым графическим объектом, отображаемым на экране. Даже если экземпляр основного класса не создает никакую графику, он все равно добавляется в список отображения, готовый содержать любую графику, создаваемую приложением в будущем. Экземпляр основного класса первого SWF-файла, открываемого средой выполнения Flash, играет особую роль в языке ActionScript; он определяет конкретные глобальные настройки среды, например разрешение относительных URL-адресов и тип ограничений безопасности, применяемых к операциям с внешними источниками.
В честь особой роли, которую играет экземпляр основного класса первого SWF-файла, открываемого средой выполнения Flash, он иногда называется владельцем сцены.
Список отображенияСписок отображенияЭкземпляркласса StageЭкземпляркласса StageРассмотрим пример, который демонстрирует, как создается владелец сцены. Предположим, мы запустили автономную версию приложения Flash Player и открыли файл с именем GreetingApp. swf, основным классом которого является GreetingApp. Если файл GreetingApp. swf содержит только этот класс и класс GreetingApp не создает никакой графики, то список отображения приложения Flash Player будет включать всего два элемента: экземпляр класса Stage и экземпляр класса GreetingApp (содержащийся в экземпляре класса Stage). Это показано на рис. 20.3.
Список отображения
Список отображения
Экземпляркласса Stage
Экземпляркласса Stage
Экземпляр классаGreetingAppфайла GreetingApp.swf
Рис. 20.3. Список отображения для файла GreetingApp.swf
Как только экземпляр основного класса SWF-файла будет добавлен в экземпляр класса Stage, программа сможет добавлять новое содержимое на экран в такой последовательности.
Создать отображаемый объект (то есть экземпляр любого базового класса отображения или любого класса, который расширяет базовый класс отображения).
Вызвать метод экземпляра addChild ( ) класса DisplayObjectContainer либо над экземпляром класса Stage, либо над экземпляром основного класса и передать в метод addChild ( ) отображаемый объект, созданный на шаге 1.
Попробуем выполнить вышеописанные общие шаги, создав класс GreetingApp, а затем добавив прямоугольник, круг и текстовое поле в список отображения с помощью метода addChild ( ). Сначала приведем основу класса GreetingApp: package {
Import flash.display
Import flash.text.TextField;
public class GreetingApp extends Sprite {
public function GreetingApp ( ) {
}
}
}
В нашем классе GreetingApp будут использованы классы Shape и Sprite, поэтому мы импортируем целиком весь пакет flash. display, который содержит эти классы. Подобным образом в классе GreetingApp будет использован класс TextField, поэтому мы импортируем пакет flash. text. TextField.
Обратите внимание на то, что класс GreetingApp по необходимости расширяет класс Sprite. GreetingApp должен расширять либо класс Sprite, либо класс MovieClip, поскольку он является основным классом программы.
В языке ActionScript 3.0 основной класс SWF-файла должен расширять либо класс Sprite, либо класс MovieClip, либо их любой подкласс.
Когда основной класс представляет корневую временную шкалу FLA-файла, он
должен расширять класс MovieClip. Во всех остальных случаях основной класс должен расширять класс Sprite. В нашем примере класс GreetingApp расширяет класс Sprite, поскольку он не ассоциирован с FLA-файлом. В результате компиляции этого класса должно получиться автономное приложение ActionScript.
Теперь создадим прямоугольник и круг в методе-конструкторе класса GreetingApp. И прямоугольник, и круг мы нарисуем внутри одного объекта Shape. Объекты Shape (и все графические объекты) создаются с помощью оператора new, как и объекты любого другого типа. Вот код, который используется для создания нового объекта Shape:
new Shape( )
Безусловно, в дальнейшем нам придется обращаться к этому объекту, чтобы нарисовать в нем элементы, поэтому присвоим его переменной rectAndCircle:
var rectAndCIrclе:Shape = new Shape( );
Для рисования векторов в языке ActionScript применяется вспомогательный класс отображения Graphics. Каждый объект Shape хранит свой собственный экземп-
ляр класса Graphics в переменной экземпляра graphics. Таким образом, чтобы нарисовать прямоугольник и круг внутри нашего объекта Shape, мы вызываем соответствующие методы над объектом rectAndCircle . graphics. Вот этот код:
// Задаем толщину линии, равную одному пикселу rectAndC1 rd е.g га ph1cs.11neStyle(1):
// Рисуем синий прямоугольник
rectAndCircle.graphics.beginFill(OxOOOOFF, 1); rectAndC1rcle.graphics.drawRect(l25. 0. 150, 75);
// Рисуем красный круг
rectAndCircle.graphics.beginFill(OxFFOOOO. 1);
rectAndC1rcle.graphics.drawC1rcle(50, 100, 50);
Дополнительную информацию о вектррном рисовании в языке ActionScript 3.0 можно найти в гл. 25.
Операции векторного рисования не ограничиваются классом Shape. Класс Sprite также предоставляет ссылку на объект Graphics через свою переменную экземпляра graphics, поэтому, чтобы нарисовать прямоугольник и круг, вместо объекта Shape мы могли бы создать объект Sprite. Тем не менее, поскольку для хранения объекта Sprite требуется больше памяти, чем для объекта Shape, лучше использовать объект Shape при создании векторной графики, не содержащей дочерних объектов и для которой не требуется интерактивности.
Строго говоря, если бы мы хотели добиться минимального расходования памяти в примере приложения GreetingApp, мы бы рисовали наши фигуры непосредственно внутри экземпляра класса GreetingApp (помните, что класс GreetingApp расширяет класс Sprite, поэтому он поддерживает векторное рисование). Наш код выглядел бы следующим образом:
package {
import flash.display.*;
public class GreetingApp extends Sprite {
public function GreetingApp ( ) {
graphics.lineStyle(l);
// Прямоугольник
graphics.beginFill(OxOOOOFF, 1);
graphics.drawRect(125, 0, 150, 75);
// Круг
graphics.beginFill(OxFFOOOO, 1);
graphics.drawCircle(50, 100, 50);
}
}
}
Этот код успешно рисует прямоугольник и круг на экране, но данный подход менее гибок, чем подход с помещением фигур в отдельный объект Shape. Помещение
рисунков в объект Shape позволяет переносить их, размещать по слоям, модифицировать и удалять независимо от остального графического содержимого в приложении. Например, возвращаясь к нашему предыдущему подходу с рисованием в экземпляре класса Shape (rectAndCircle), для перемещения фигур в новую позицию мы могли бы использовать следующий код:
// Перемещаем объект rectAndCircle вправо на 125 пикселов
// и вниз на 100 пискелов
rectAndCIrcle.x = 125;
rectAndd rcl е .у = 100;
Отметим, что в настоящий момент у нас есть отображаемый объект rectAndCircle, который пока не добавлен в список отображения. Обращение и управление отображаемыми объектами, которые не добавлены в список отображения, является допустимой и распространенной практикой. Отображаемые объекты в любой момент жизненного цикла программы могут быть добавлены в список отображения или удалены из него, а программное взаимодействие с этими объектами может осуществляться независимо от того, находятся они в списке отображения или нет.
Обратите внимание, что предыдущее позиционирование объекта rectAndCircle осуществляется до того, как этот объект будет помещен в список отображения! Каждый отображаемый объект сохраняет свое собственное состояние, независимо от родителя, с которым он связан, — фактически независимо от того, добавлен объект в список отображения или нет. Когда объект rectAndCircle будет добавлен в контейнер отображения, он будет автоматически помещен в позицию (125; 100) координатного пространства этого контейнера. Если в дальнейшем объект rectAndCircle будет удален из этого контейнера и добавлен в другой контейнер, он будет помещен в позицию (125; 100) координатного пространства нового контейнера.
Любой отображаемый объект сохраняет свои характеристики при перемещении из одного контейнера в другой и даже при удалении из списка отображения.
Теперь наступает момент, которого мы с нетерпением ожидали. Чтобы отобразить фигуры на экране, мы вызываем метод addChild ( ) над экземпляром класса GreetingApp внутри конструктора GreetingApp и передаем в этот метод ссылку на экземпляр класса Shape, хранящуюся в переменной rectAndCircle.
// Отображаем объект rectAndCircle на экране, добавляя его // в список отображения
addChild(rectAndCircle);
В результате приложение Flash Player добавляет объект rectAndCircle в список отображения в качестве ребенка экземпляра класса GreetingApp.
Как подкласс класса Sprite, класс GreetingApp является потомком класса DisplayObjectContainer и, следовательно, наследует метод addChild() и возможность содержать детей. Чтобы вспомнить иерархию классов API отображения, вернитесь к рис. 20.1.
Отображение объектов на экране — это забавно! Проделаем это еще раз. Добавление следующего кода в конструктор класса GreetingApp приведет к отображению на экране текста «Hello world»:
// Создаем объект TextField, который будет содержать некий текст var greet1ng_txt;TextF1eld = new TextF1eld( );
// Указываем отображаемый текст
greet1ng_txt.text = "Hello world";'
// Задаем позицию объекта TextField
greeting_txt.x = 200;
greet1ng_txt.y = 300;
// Отображаем текст на экране, добавляя объект greetingtxt
// в список отображения.
addCh 11 d (greeti ngtxt);
Когда объект будет добавлен в контейнер отображения, обратиться к этому контейнеру можно будет через переменную экземпляра parent класса DisplayOb j ect. Например, в конструкторе класса GreetingApp следующее выражение является допустимой ссылкой на экземпляр класса GreetingApp:.
greeting_txt.parent
Если отображаемый объект еще не был добавлен в список отображения, его переменная parent имеет значение null..
Листинг 20.1 демонстрирует код приложения GreetingApp целиком.
Листинг 20.1. Графическое приложение «Hello world»
package {
Import flash.display.*;
Import flash.text.TextField;
public class GreetingApp extends Sprite {
public function GreetingApp( ) {
// Создаем объект Shape
var rectAndCIrcle:Shape = new Shape( );.
// Задаем толщину линии один пиксел rectAndC1rd е.graphics.11neStyle(1);
// Рисуем синий прямоугольник
rectAndCircle.graph1cs.beg1nF1ll(OxOOOOFF, 1);
rectAndCIrcle.graphics.drawRectC125, 0. 150, 75);
// Рисуем красный круг
rectAndCIrd e.graphlcs.beg1nF111 (OxFFOOOO. 1);
rectAndCIrcle.graphlcs.drawC1rcle(50, 100, 50);
// Перемещаем фигуры вправо на 125 пикселов и вниз на 100 пискелов rectAndCIrcle.x = 125: rectAndCIrcle.у = 100;
// Выводим объект rectAndCircle на экране, добавляя его // в список отображения
addChild(rectAndCircle);
// Создаем объект TextField, который будет содержать некий текст var greet1ng_txt:TextField = new TextF1eld( );
// Указываем отображаемый текст greet1ng_txt.text = "Hello world";
// Задаем позицию текста greet1ng_txt.x = 200; greet1ng_txt.y =300;.
// Выводим текст на экране, добавляя объект greet1ng_txt
// в список отображения
addCh1ld(greet1ng_txt);
}"
}
}
На рис. 20.4 в графическом виде показаны результаты выполнения кода из листинга 20.1. Как и на двух предыдущих рисунках, графика, отображаемая на экране, показана слева, а соответствующая иерархия списка отображения приложения Flash Player — справа.
ЭкземплярЭкземплярПроигрыватель FlashПроигрыватель Flashgreeti ng_txtgreeti ng_txtРис. 20.4. Список отображения для приложения GreetingAppРис. 20.4. Список отображения для приложения GreetingAppСписок отображенияСписок отображенияЭкземпляркласса StageЭкземпляркласса StageЭкземпляр класса GreetingApp файла GreetingApp.swfЭкземпляр класса GreetingApp файла GreetingApp.swfЭкземпляр К Экземпляр класса Shape I класса TextFieldЭкземпляр К Экземпляр класса Shape I класса TextField
Экземпляр
Экземпляр
Проигрыватель Flash
Проигрыватель Flash
greeti ng_txt
greeti ng_txt
Рис. 20.4. Список отображения для приложения GreetingApp
Рис. 20.4. Список отображения для приложения GreetingApp
Список отображения
Список отображения
Экземпляркласса Stage
Экземпляркласса Stage
Экземпляр класса GreetingApp файла GreetingApp.swf
Экземпляр класса GreetingApp файла GreetingApp.swf
Экземпляр К Экземпляр класса Shape I класса TextField
Экземпляр К Экземпляр класса Shape I класса TextField
Контейнеры и глубины
В предыдущем разделе мы добавили в приложение GreetingApp два отображаемых ребенка (rectAndCircle и greeting txt). На экране они были размещены так, чтобы не перекрывать друг друга. Если бы они перекрывались, один объект закрывал бы другой в соответствии с глубинами этих двух объектов.
Глубина отображаемого объекта — это целочисленное значение, которое определяет, как данный объект перекрывает другие объекты в одном и том же контейнере
отображаемых объектов. Когда два объекта перекрываются, тот объект, у которого позиция глубины больше («высший» из двух), закрывает другой объект («низший» из двух). Следовательно, можно считать, что все отображаемые объекты в контейнере размещаются по порядку в визуальном стеке наподобие колоды уложенных в стопку игральных карт, счет которых начинается с нуля. Самый нижний объект в стеке имеет позицию глубины, равную 0, а самый верхний — позицию глубины, равную количеству объектов-детей в контейнере отображаемых объектов минус один (по аналогии самая нижняя карта в колоде имеет позицию глубины, равную 0, а самая верхняя — позицию глубины, равную количеству карт в колоде минус один).
В API управления глубиной отображаемых объектов языка Actionscript 2.0 допускалось существование «незаполненных» глубин. Например, в контейнере, содержащем всего два объекта, первый объект мог иметь глубину, равную 0, а другой объект — глубину, равную 40, оставляя незаполненными глубины от 1 до 39. В API управления глубиной отображаемых объектов языка ActionScript 3.0 появление незаполненных глубин не допускается и вообще невозможно.
Отображаемым объектам, добавляемым в контейнер с помощью метода addChild ( ), позиции глубины присваиваются автоматически. Если взять пустой контейнер, то первый ребенок, добавленный через метод addChild ( ), помещается на глубину 0, второй — на глубину 1, третий — на глубину 2 и т. д. Таким образом, объект, добавленный последним через метод addChild ( ), всегда отображается поверх остальных детей.
В качестве примера продолжим работу с программой Greet ingApp из предыдущего раздела. На этот раз мы нарисуем круг и прямоугольник в отдельных экземплярах класса Shape, чтобы их можно было размещать в стеке независимо друг от друга. Кроме того, изменим позиции круга, прямоугольника и текста таким образом, чтобы они перекрывались. Рассмотрим измененный код (этот код и другие примеры данного раздела взяты из метода-конструктора класса GreetingApp):
// Прямоугольник
var reel:Shape = new Shape( ):
reel.graphi cs. 1 ineSty1e(l);
rect. graph! cs.beginFilKOxOOOOFF. 1):
rect.graph!cs.drawRect(O. 0. 75. 50);
// Круг
var c1rcle:Shape = new Shape( ):
ci rde.graph1cs.11neSty1e(l):
c1rcle.graphlcs.beg1 nF111(OxFFOOOO. 1) :
circle.graphics.drawC1rcle(0. 0. 25);
circle.x = 75;
circle.у = 35;
// Текстовое сообщение
var greeting_txt;TextF1eld = new TextFieldC );
greet!ng_txt.text = "Hello world":
greeting_txt.x = 60;
greet!ng_txt.y = 25;
Теперь попытаемся добавить прямоугольник, круг и текст в качестве детей экземпляра класса GreetingApp, используя различные последовательности. Следующий код сначала добавляет прямоугольник, затем круг и после него — текст:
addChi1d(rect):// Глубина О
addChild(circle):// Глубина 1
addChi1d(greet1ng_txt): // Глубина 2
Как показано на рис. 20.5, прямоугольник был добавлен первым, поэтому он отображается под кругом и текстом. Затем был добавлен круг, поэтому он отображается поверх прямоугольника, но под текстом. Текст был добавлен последним, поэтому он отображается поверх прямоугольника и круга.
Следующий код изменяет последовательность, добавляя сначала круг, затем прямоугольник и после этого — текст. На рис. 20.6 показан результат. Обратите внимание, как простое изменение последовательности, с учетом которой добавляются объекты, влияет на конечный результат.
addChlld(cjrcle):// Глубина О
addChild(rect):// Глубина 1
addChi1d(greet1ng_txt); // Глубина 2
Рассмотрим еще один пример. Следующий код сначала добавляет текст, затем окружность и после нее — прямоугольник. На рис. 20.7 показан результат.
addChi1d(greet1ng_txt): // Глубина О
addChi1d(c1rclе):// Глубина 1
addChiId(rect);// Глубина 2
Рис. 20.5. Прямоугольник,Рис. 20.5. Прямоугольник,круг, тексткруг, текстРис. 20.6. Круг, прямоугольник, текстРис. 20.6. Круг, прямоугольник, текстРис. 20.7. Текст, круг, прямоугольникРис. 20.7. Текст, круг, прямоугольник
Рис. 20.5. Прямоугольник,
Рис. 20.5. Прямоугольник,
круг, текст
круг, текст
Рис. 20.6. Круг, прямоугольник, текст
Рис. 20.6. Круг, прямоугольник, текст
Рис. 20.7. Текст, круг, прямоугольник
Рис. 20.7. Текст, круг, прямоугольник
Для того чтобы получить позицию глубины любого объекта в контейнере отображаемых объектов, нужно использовать метод экземпляра getChildlndex ( ) класса DisplayObjectContainer:
trace(getCh11dlndex(rect)); // Выводит: 2
Чтобы добавить новый объект в определенную позицию глубины, используется метод экземпляра addChildAt ( ) класса DisplayObjectContainer (обратите внимание: addChildAt ( ), а не addChild ( ) ). Этот метод принимает следующий вид:
контейнер.addChi1dAt(отображаемыйОбъект. позицияГпубины)
Значение параметра позицияГпубины должно находиться в пределах от 0 до значения контейнер. numchildren включительно.
Если указанная позиция позицияГпубины уже занята существующим ребенком, объект отображаемыйОбъект будет помещен позади этого существующего объекта (то есть позиции глубины всех отображаемых объектов, которые равны указанному значе-
нию или выше его, увеличиваются на единицу, чтобы освободить место для нового ребенка).
Повторяйте про себя это мнемоническое правило метода addChildAt(): «Если глубина занята, новый ребенок помещается позади».
Для добавления нового объекта поверх всех существующих детей используется следующий код:
контейнер.addChl1dAt(отображаемыйОбъект. контейнер.numChi1dren)
что аналогично следующей записи:
контейнер. addChl ШотображаемыйОбъект)
Обычно метод addChildAt ( ) применяется совместно с методом экземпляра getChildlndex ( ) класса DisplayObj ectContainer для добавления объекта ниже существующего ребенка в заданном контейнере. Вот общий формат: контейнер.addChl 1 dAt(новыйРебенок.
контейнер.де^АДбУпбех^существующийРебеноЮ)
Испытаем этот подход, добавив новый треугольник позади круга в приложении GreetingApp, используя самое последнее воплощение данного приложения, изображенное на рис. 20.7.
Рассмотрим код, который создает треугольник:
var trianglе:Shape = new Shape( );
triangle.graph!cs.11neSty1e (1);
tri angle.graphics.beg!nFi11(OxOOFFOO. 1):
triangle.graphics.moveTo(25, 0):
triangle.graphics.l!neTo(50, 25):
tri angle.graphics.1!neTo(0, 25):
tri angle.graph!cs.lineTo(25. 0):
triangle.graphics.endFill( ):
triangle.x = 25:
triangle.у = 10:
Теперь рассмотрим код, который делает объект triangle новым ребенком экземпляра класса GreetingApp, размещая его ниже существующего объекта circle (обратите внимание, что методы addChildAt ( ) и getChildlndex ( ) неявно вызываются над текущим объектом GreetingApp). На рис. 20.8 показаны результаты.
addChi1dAt(triangle. getCh!1dIndex(c1rde)):
Рис. 20.8. Новый ребенок-треугольник
Как недавно было сказано, когда новый объект добавляется в позицию глубины, занятую существующим ребенком, позиции глубины существующего ребенка и всех
детей, расположенных выше его, увеличиваются на единицу. Новый объект затем занимает позицию глубины, которая была освобождена существующим ребенком. Например, перед добавлением объекта triangle глубины детей экземпляра класса GreetingApp выглядели следующим образом:
О 12О 12greet1ng_txt circle
О 1
2
О 1
2
reel
После добавления объекта triangle позиция глубины объекта circle изменилась с 1 на 2, позиция глубины объекта rect — с 2 на 3, а объект triangle занял глубину 1 (предыдущая глубина объекта circle). Между тем позиция глубины объекта greet ing_txt не изменилась, поскольку с самого начала она была меньше глубины объекта circle. Вот измененные глубины после добавления объекта triangle:
greeting_txtО
triangle1
circle2
rect3
Чтобы изменить глубину существующего ребенка, мы можем поменять местами позиции глубины этого ребенка и другого существующего ребенка с помощью методов экземпляра swapchildren ( ) или swapChildrenAt ( ) класса DisplayObjectContainer. Можно также непосредственно задать глубину для этого ребенка, используя метод экземпляра setchildindex ( ) класса DisplayObjectContainer.
Метод swapchildren ( ) принимает следующий вид:
контейнер. swapChi 1бгег\(существующийРебенок1, существующийРебенок2):
Здесь существующийРебенок! и существующийРебенок2 — дочерние объекты контейнера контейнер. Метод swapchildren ( ) меняет местами глубины объектов существующийРебенок! и сущее твующийРебенок2. На обычном языке приведенный код означает следующее: «Поместить объект существующийРебенок! на глубину, занимаемую объектом сущеет вующийРебе нок2, и поместить объект существующий Ребе нок2 на глубину, занимаемую объектом существующийРебенок!».
Метод swapChildrenAt ( ) принимает следующий вид:
контейнер.swapCh11drenAt(существующаяГпубина!, существующаяГпубина2);
Здесь существующая Глубина! и существующаяГлубина2 — глубины, занимаемые детьми контейнера контейнер. Метод swapChildrenAt ( ) меняет местами глубины детей, находящихся на глубинах существующаяГлубина! и существующаяГлубина2. На обычном языке предыдущий код означает следующее: «Поместить ребенка, который в настоящий момент находится на глубине существующаяГпубина!, на глубину существующаяГпубина2, а ребенка, который в настоящий момент находится на глубине существующаяГпубина2, поместить на глубину существующаяГпубина!».
Метод setchildindex ( ) принимает следующий вид:
контейнерлеШпШпбех(существующийРебенок. новаяПозицияГлубины);
Здесь существующийРебенок — ребенок контейнера контейнер. Позиция новаяПозиция- Гпубины должна быть позицией глубины, в настоящий момент занимаемой объектом-ребенком контейнера контейнер. Иными словами, метод setchildindex ( ) позволяет только изменять позиции существующих объектов-детей, но не позволяет добавлять новые позиции глубины. Значение параметра новаяПозицияГпубины метода setchildindex ( ) обычно получают вызовом метода getChildlndex ( ) над существующим ребенком, как показано в следующем коде:
контейнер. setChl 1 dIndex(существующийРебенок!.
контейнер.деШпШпбех(существующийРебенок2));
Это означает: «Поместить ребенка существующийРебенок! на глубину, которая в настоящий момент занята ребенком существующийРебенок2».
Стоит отметить, что, когда глубина объекта увеличивается на новую позицию с помощью метода setchildindex ( ) (то есть объект перемещается выше), глубина всех объектов, находящихся между старой и новой позициями, уменьшается на 1, тем самым заполняя освободившуюся позицию в результате перемещения объекта. Таким образом, перемещенный объект появляется перед объектом, который раньше находился в указанной новой позиции. Например, продолжая работу над последней версией приложения GreetingApp (которая была показана на рис. 20.8), изменим позицию глубины объекта greet ing_txt с 0 на 2. До выполнения следующего кода позицию глубины 2 занимает объект circle.
setCh1ldIndex(greet1ng_txt. getChl1dlndex(c1rclе)):
Когда объект greeting_txt перемещается в позицию глубины 2, позиции глубины объектов circle и triangle уменьшаются до 1 и 0 соответственно, поэтому объект greet ing txt отображается перед этими объектами. Результаты показаны на рис. 20.9.
Рис. 20.9. Перемещение текста вверхРис. 20.9. Перемещение текста вверх
Рис. 20.9. Перемещение текста вверх
Рис. 20.9. Перемещение текста вверх
В отличие от этого, когда глубина объекта уменьшается на новую позицию с помощью метода setchildindex ( ) (то есть объект перемещается ниже), позиция глубины всех объектов, находящихся в новой позиции или выше ее, увеличивается на 1, тем самым освобождая пространство для нового объекта. Таким образом, перемещенный объект появляется позади объекта, который раньше находился в указанной новой позиции (как если бы объект был добавлен с помощью метода addChildAt ( ) ). Обратите внимание на важное различие между перемещением объекта на высокую глубину и перемещением объекта на низкую глубину.
Объект, перемещенный на большую глубину, отображается перед объектом, который находился в целевой позиции, однако объект, перемещенный на меньшую глубину, отображается позади объекта, который находился в целевой позиции.
Например, продолжая работать над кодом, результаты выполнения которого показаны на рис. 20.9, изменим позицию глубины объекта rect с 3 на 1 (1 — это глубина, в настоящий момент занимаемая объектом circle):
setCh 11 d Index (reel. getCh 11 dI ndex(c'i rc 1 e)):
Когда объект rect перемещается в позицию глубины 1, позиции глубины объектов circle и greet ing_txt увеличиваются до 2 и 3 соответственно, поэтому объект rect отображается позади этих объектов (как показано на рис. 20.10).
Чтобы поместить объект поверх всех объектов в данном контейнере, используйте следующий код:
контейнер.s etCh11dIndex(сущеетвующийРебенок, контейнер.numChi1dren-1)
Например, следующий код помещает треугольник поверх всех дочерних объектов экземпляра класса Greet ingApp (код используется в классе Greet ingApp, поэтому объект контейнер в предыдущем выражении опускается и неявно преобразуется в this — текущий объект):
setChildlndex(tr1anglе, numChildren-1);
Рис. 20.10. Перемещение прямоугольника внизРис. 20.10. Перемещение прямоугольника внизНа рис. 20.11 показаны результаты выполнения кода.
Рис. 20.10. Перемещение прямоугольника вниз
Рис. 20.10. Перемещение прямоугольника вниз
Рис. 20.11. Треугольникперемещен вперед
Вы сможете легко разобраться с поведением метода setchildindex ( ), если представите детей объекта DisplayObjectContainer в виде колоды карт, как уже говорилось ранее. Если вы перемещаете нижнюю карту колоды вверх, остальные карты смещаются вниз (то есть карта, которая находилась поверх нижней карты, сама становится новой нижней картой). Если вы перемещаете верхнюю карту колоды вниз, остальные карты смещаются вверх (то есть карта, которая была нижней, теперь будет находиться поверх новой нижней карты).
Удаление элементов из контейнеров
Для удаления объекта из контейнера объектов отображения используется метод экземпляра removechild ( ) класса DisplayObj ectContainer, который принимает следующий вид:
контейнер. removeChl 1 бЛсуществующийРебеноЮ
Здесь контейнер — это контейнер, который в настоящий момент содержит объект сущеетвующийРебенок. Например, чтобы удалить треугольник из экземпляра класса GreetingApp, мы бы использовали следующий код:
removeChild(triangle):
В качестве альтернативы мы можем удалить ребенка, используя его глубину, с помощью метода removeChildAt ( ), который принимает следующий вид:
контейнер.removeChi1dAt(глубина)
После выполнения метода removeChi Id ( ) или removeChi IdAt ( ) переменной parent удаленного объекта присваивается значение null, поскольку удаленный ребенок больше не имеет контейнера. Если удаленный ребенок находился в списке отображения перед вызовом метода removechild ( ) или removeChi IdAt ( ), он удаляется из этого списка. Если удаленный ребенок отображался на экране перед вызовом метода removechild ( ) или removeChildAt ( ), он также удаляется с экрана. Если удаленный ребенок является объектом DisplayOb j ectContainer со своими детьми, его дети будут также удалены с экрана.
Удаление элементов из памяти
Важно отметить, что методы removechild ( ) и removeChildAt ( ), рассмотренные в предыдущем разделе, не обязательно приводят к уничтожению удаленного объекта в памяти; они только удаляют объект из иерархии отображения родительского объекта DisplayObjectContainer. Если на удаленный объект ссылается переменная или элемент массива, то этот объект продолжает существовать и может быть в дальнейшем заново добавлен в другой контейнер. Например, рассмотрим следующий код, который создает объект Shape, присваивает его переменной rect и затем добавляет этот объект в иерархию отображения объекта parent:
var rect:Shape = new Shape( ):
reel.graphics.11neStyle (1):
reel.graphics.beg1nF1ll(OxOOOOFF, 1);
rect.graphics.drawRect(O, 0. 75, 50);
parent.addChlld(rect);
Если теперь мы воспользуемся методом removechild ( ), чтобы удалить объект Shape из объекта parent, переменная rect будет по-прежнему ссылаться на объект Shape:
parent.removeChi1d(rect);
trace(rect); // Выводит: [object Shape]
До тех пор пока переменная rect существует, мы можем использовать ее для повторного добавления объекта Shape в иерархию отображения объекта parent, как показано в следующем коде:
parent.addChl1d(rect);
Чтобы полностью удалить отображаемый объект из программы, мы должны удалить не только его с экрана с помощью метода removechild ( ), но и все ссылки на него. Чтобы удалить все ссылки на объект, мы должны вручную удалить его из всех массивов, содержащих этот объект, и присвоить значение null (или любое другое значение) всем переменным, которые ссылаются на него. Как только все ссылки на объект будут удалены, он становится доступным для сборки мусора и в определенный момент будет удален из памяти сборщиком мусора языка ActionScript.
Однако, как уже говорилось в гл. 14, даже после того, как все ссылки на объект будут удалены, он продолжает быть активным до тех пор, пока сборщик мусора не удалит его из памяти. Например, если объект зарегистрировал приемники для события Event. ENTER FRAME, то это событие будет по-прежнему приводить к выполз нению кода. Подобным образом, если объект запустил таймеры, используя метод
setinterval ( ) или класс Time г, эти таймеры будут по-прежнему приводить к выполнению кода. Точно так же, если объект является экземпляром класса MovieCI ip, воспроизводимым в настоящий момент, его головка воспроизведения будет продолжать перемещаться, приводя к выполнению существующих сценариев кадров.
Пока объект ожидает начала процесса сборки мусора, приемники событий, таймеры и сценарии кадров могут вызывать незапланированное выполнение кода, приводя к расходованию памяти или к нежелательным побочным эффектам.
Чтобы избежать нежелательного выполнения кода при удалении отображаемого объекта из программы, убедитесь, что вы полностью деактивировали этот объект перед тем, как освободить все ссылки на него. Дополнительную информацию о деактивации объектов можно найти в гл. 14.
Всегда деактивируйте отображаемые объекты перед их уничтожением.
Удаление всех детей
Язык ActionScript не предоставляет прямого способа для удаления всех детей объекта. Следовательно, чтобы удалить всех отображаемых детей из конкретного объекта, мы должны использовать циклы while или for. Например, следующий код использует цикл while для удаления всех детей объекта родитель в направлении снизу вверх. Сначала удаляется ребенок на глубине 0, затем глубина всех детей уменьшается на 1, после этого удаляется новый ребенок на глубине 0, и этот процесс повторяется до тех пор, пока у объекта не останется детей.
// Удаляем всех детей- объекта родитель while (родитель .numChlldren > 0) {•
родитель .removeChlldAt(O);'
}
Следующий код также удаляет всех детей объекта родитель, но в направлении сверху вниз.. Однако использования такого кода следует избегать, поскольку он медленнее предыдущего, применяемого для удаления детей в направлении снизу вверх.
while (родитель .numChlldren > 0) {
родитель. гето^еШ^/ХКродитель.numCh 11 dren-1);
}
Следующий код удаляет всех детей в направлении снизу вверх с помощью цикла for вместо цикла while:
for (;numChlldren > 0;) {
родитель.removeChl1dAt(0);’
Если вам потребуется удалить детей в направлении сверху вниз (возможно, для того, чтобы обработать их в таком порядке перед удалением), будьте осторожны, чтобы не использовать цикл, в котором значение счетчика не уменьшается, а увеличивается. Например, никогда не используйте код наподобие следующего:
// ВНИМАНИЕ: ПРОБЛЕМНЫЙ КОД! НЕ ИСПОЛЬЗОВАТЬ!
for (var i:int = 0: i < родитель.numChlldren; 1++) { родитель.removeChi 1 dAt(1);
}
Что же неправильно с предыдущим циклом for? Представьте, что у объекта родитель есть три ребенка — А, В и С, — которые находятся на глубинах 0,1 и 2 соответственно:
ДетиГлубины
А0
В1
С2
Когда цикл выполняется в первый раз, значение счетчика i равно 0, поэтому удаляется объект А. После удаления объекта А глубины объектов В и С автоматически уменьшаются на 1, таким образом, глубина объекта В теперь равна 0, а глубина объекта С — 1:
ДетиГлубины
В0
С1
Когда цикл выполняется во второй раз, значение счетчика i равно 1, поэтому удаляется объект С. После удаления объекта С значение переменной родитель. numchildren становится равным 1 и цикл завершается, поскольку значение переменной i перестает быть меньше значения переменной родитель . numchildren. Но объект В никогда не будет удален!
Изменение родителей элементов
В языке ActionScript версии 3.0 удаление ребенка из одного экземпляра объекта Displayedj ectContainer и его перенос в другой экземпляр является совершенно допустимой и распространенной операцией. На самом деле действие по добавлению объекта в контейнер приводит к автоматическому удалению этого объекта из любого контейнера, в котором он находился до настоящего момента.
Чтобы продемонстрировать эту методику, в листинге 20.2 представлено простое приложение WordHighlighter, в котором объект Shape (присвоенный переменной bgRect) перемещается между двумя экземплярами класса Sprite (присвоенными переменным wordl и word2). Экземпляры класса Sprite содержат экземпляры класса TextField (присвоенные переменным textl и text2), которые отображают слова Продукты и Услуги. Объект Shape — это прямоугольник с закругленными углами, который служит для выделения слова, находящегося в настоящий момент под указателем мыши, как показано на рис. 20.12. Когда указатель мыши находится над одним из экземпляров класса TextField, объект Shape перемещается в тот экземпляр класса Shape, который содержит данный объект TextField.
[ Продукты ) Услуги
Рис. 20.12. Перемещение объекта между контейнерами
Мы еще не рассматривали методики обработки событий мыши, которые применяются в листинге 20.2. Информацию об обработке событий ввода можно найти в гл. 22.
Листинг 20.2. Перемещение объекта между контейнерами
package {
Import flash.display.*;
Import fl ash.text.*:
Import fl ash.events.*;
public class WordH1ghl1ghter extends Sprite {
// Первое слово
private var wordl;Spr!te;
private var textl:TextFleld;
// Второе слово
private var word2:Spr1te;
private var text2;TextF1eld;
// Выделяющая фигура private var bgRect .-Shape;
public function WordH1ghl1ghter ( ) {
// Создаем первый объект TextFleld и Sprite
wordl = new Spr1te( );
textl = new TextF1eld( );•
text1.text = "Products";
textl.selectable = false;
textl.autoSize = TextF1eldAutoS1ze.LEFT;
wordl.addChiId(textl)
textl.addEventLIstener(MouseEvent.MOUSE_OVER. mouseOverLIstener);
// Создаем второй объект TextFleld и Sprite
word2 = new Spr1te( );
text2 = new TextF1eld( );
text2.text = "Services";
text2.selectable = false;
text2.autoSize = TextF1eldAutoS1ze.LEFT;
word2.x = 75;
word2.addCh1ld(text2)
text2.addEventLIstener(MouseEvent.MOUSE_OVER, mouseOverLIstener);
• // Добавляем экземпляры класса Sprite в иерархию отображения
// объекта WordH1ghl1ghter
addChlld(wordl);
addCh1ld(word2);
// Создаем объект Shape (прямоугольник с закругленными углами)
bgRect = new Shape( );
bgRect.graph!cs.11neStyle(l);
bgRect.graphics.beg!nF! 11(OxCCCCCC, 1);
bgRect.graphics.drawRoundRect(0. 0. 60. 15, 8);
}
// Вызывается при перемещении указателя мыши над текстовым полем.
private function mouseOverLIstener (е:MouseEvent):void {
// Если родительский объект Sprite экземпляра объекта TextFleld
// не содержит выделяющую фигуру, перемещаем фигуру в этот объект.
// D1splayObjectConta1пег.cental ns( ) возвращает true, если указанный
// объект является потомком данного контейнера.
1f (!е.target.parent.cental ns(bgRect)) {
e.target.parent.addChi1dAt(bgRect, 0);
}
}
}
}
В таком виде код из листинга 20.2 всегда оставляет выделенным одно из текстовых полей. Для удаления выделения при выходе указателя мыши за пределы обоих текстовых полей мы должны сначала зарегистрировать приемник в обоих текстовых полях для получения события MouseEvent. MOUSE_OUT:
textl.addEventLIstener(MouseEvent.MOUSE_OUT, mouseOutLIstener);
text2.addEventLIstener(MouseEvent.MOUSE_OUT, mouseOutLIstener);
Затем нам придется реализовать код, который удаляет прямоугольник в ответ на событиеMouseEvent.MOUSE_OUT:
private function mouseOutLIstener (e:MouseEvent):void {
// Если выделение присутствует...
1f (e.target.parent.contains(bgRect)) {
// ...удаляем его
e.target.parent.removeChl1d(bgRect):
}
}
Обход объектов в иерархии отображения
Обход объектов в иерархии отображения означает систематическое обращение к некоторым или ко всем дочерним объектам контейнера, в основном для обработки этих объектов.
Для обращения к непосредственным детям контейнера (но не к правнукам или к любым другим детям-потомкам) используется инструкция цикла. Цикл обрабатывает каждую позицию глубины в контейнере. Внутри тела цикла мы обращаемся к каждому peбeнкyпoeгoпoзицииглyбины,иcпoльзyямeтoдэкзeмпляpagetChildAt ( ) класса DisplayObjectContainer. Следующий код демонстрирует общий подход; он отображает строковые значения всех объектов, содержащихся в объекте контейнер: for (var 1:1nt=0; 1 < кояге^яер.питСЬПЬгеп; 1++) {
trace(Kowre^ep.getCh1ldAt(1) .toStr1ng( ));
}
В листинге 20.3 приведено более конкретное и слегка причудливое приложение для обхода отображаемых дочерних объектов. Оно создает 20 экземпляров класса
Shape, содержащих прямоугольники, и затем использует описанный подход для обхода объектов, чтобы выполнять вращение этих экземпляров, когда на них щелкают кнопкой мыши. Код, осуществляющий обход, выделен полужирным шрифтом. В следующих разделах мы рассмотрим приемы векторного рисования и обработки событий мыши, применяемые в этом примере.
Листинг 20.3. Вращение прямоугольников
package {
Import flash.display.*;
Import fl ash.events.*;
public class RotatlngRectangles extends Sprite {
public function RotatlngRectangles ( ) {
// Создаем 20 прямоугольников
var rects:Array = new Array( );
for (var 1:1 nt = 0; 1 < 20; 1++) {
rects[1] = new Shape( );
rects[1].graphics.11neSty1e(1);
rects[1].graphlcs.beg1nF111(Math.floor(Math.random( )*OxFFFFFF), 1) ;
rects[i].graphics.drawRecUO, 0. 100, 50);
rects[1].x = Math.f1oor(Math.random( )*500);
rects[1].y = Math.floor(Math.random( )*400); addChl1d(rects[1J);
// Регистрируем приемник для щелчков кнопкой мыши
stage.addEventListener(MouseEvent.MOUSE_DOWN, mouseDownLIstener);
// Вращает прямоугольники, когда пользователь щелкает кнопкой мыши private function mouseDownLIstener (e:Event):void {
// Случайным образом вращает каждого отображаемого ребенка
// данного объекта.
for (var 1:1nt=0; 1 < numChlldren; 1++) {*
getChlldAtd). rotation = Math.floor(Math.random( )*360):
}
}
}
}
Чтобы обращаться не только к непосредственным детям контейнера, но и ко всем его потомкам, мы интегрируем предыдущий цикл for в рекурсивную функцию. В листинге 20.4 представлен общий подход.
Листинг 20.4. Рекурсивный обход дерева списка отображения
public function processchildren (container:DisplayObjectContainer);void {
for (var 1;1nt = 0; 1 < container.numChlldren; 1++) {
// Обрабатываем ребенка здесь. Например, следующая строка выводит
// строковое значение данного ребенка на консоль.
var thisChild:DisplayObject = container.getChlldAtd);
trace(thisChild.toString( ));
// Если этот ребенок сам по себе является контейнером, приступаем // к обработке его детей.
if (th1sChild is DisplayObjectContainer) { processChi1dren(DisplayObjectContainer(thisChiId));
}
}
}
Следующая функция rotateChildren ( ) использует обобщенный код из листинга 20.4. Она случайным образом поворачивает всех потомков указанного контейнера (а не только детей). Однако обратите внимание на небольшое изменение в подходе, представленном в листинге 20.4: функция rotateChildren ( ) вращает только тех детей, которые не являются контейнерами.
public function rotateChildren (container:DisplayObjectContainer):void {
for (var i:int = 0; i < container.numChiIdren; i++) {
var thisChiId:DisplayObject = container.getChildAt(i);
if (thisChild is DisplayObjectContainer) {
rotateChi1dren(DisplayObjectContainer(thisChild));
} else {
thisChild.rotation = Math.floor(Math.random( )*360);
}
}-
}
Управление одновременно несколькими объектами в контейнерах
Ранее в разд. «Обзор API отображения» было сказано, что дочерние объекты автоматически перемещаются, вращаются и трансформируются при перемещении, вращении и трансформировании их предков. Мы можем использовать эту возможность для выполнения коллективных визуальных модификаций над группами объектов. Чтобы познакомиться с этой методикой, создадим два экземпляра класса Shape, представляющих прямоугольники, в экземпляре класса Sprite:
// Создаем два прямоугольника var recti:Shape = new Shape( );
recti.graphi cs.1ineSty1e(1):
recti.graphics.beginFill(OxOOOOFF, 1):
recti.graphics.drawRect(O, 0, 75, 50);
var rect2:Shape = new Shape( );
rect2.graphi cs.1ineSty1e(1);
rect2.graphics.beginFill(OxFFOOOO, 1);
rect2.graphics.drawRect(0, 0, 75, 50);
rect2.x = 50;
rect2.y = 75;
// Создаем контейнер
var group:Sprite = new Sprite( );
// Добавляем прямоугольники в контейнер
group.addChi1d(recti):
group.addCh1ld(rect2);
// Добавляем контейнер в основное приложение некоеОсновноеПриложение.addChiId(group);
На рис. 20.13 показан результат выполнения предыдущего кода.
Теперь с помощью следующего кода переместим контейнер, изменим его масштаб и выполним вращение:
group.х = 40;
group.scaleY = .15;
group.rotation = 15;
Изменения затрагивают дочерние экземпляры класса Shape, как показано на рис. 20.14.
Трансформации контейнера влияют и на дочерние элементы, добавленные в контейнер после выполнения трансформаций. Например, если сейчас мы добавим третий экземпляр класса Shape, представляющий прямоугольник, в объект group, этот экземпляр класса Shape будет перемещен, масштабирован и повернут в соответствии с существующими трансформациями объекта group:
// Создаем третий прямоугольник var rect3;Shape = new Shape( ); rect3.graphics.11neSty1e(1); rect3.graphics.beg1nF1ll(OxOOFFOO, 1); rect3.graph1cs.drawRect(0, 0, 75, 50); rect3.x = 25;
rect3.y = 35;
group.addChild(rect3);
На рис. 20.15 показан результат.
В любой момент мы можем удалить или изменить трансформацию контейнера — модификации затронут все дочерние объекты. Например, следующий код вернет контейнер в его исходное состояние:
group.scaleY = 1;
group.х = 0;
group.rotation = 0;
На рис. 20.16 показан результат. Обратите внимание, что теперь размеры и позиция третьего прямоугольника соответствуют указанным значениям.
Цветовые и координатные трансформации, осуществляемые через переменную экземпляра transform класса Displayobject, также наследуются всеми потомками этого экземпляра. Например, следующий код применяет черную цветовую трансформацию к объекту group, в результате чего все три прямоугольника окрашиваются в сплошной черный цвет.
1mport fl ash.geom.ColorTransform;
var blackTransform;ColorTransform = new ColorTransform( );
blackTransform.color = 0x000000;
group.transform.colorTransform = blackTransform;
Рис. 20.15. Третий прямоугольникРис. 20.15. Третий прямоугольникРис. 20.13. Двапрямоугольникав контейнереРис. 20.13. Двапрямоугольникав контейнереРис. 20.14.Перемещение,масштабированиеи вращениеРис. 20.14.Перемещение,масштабированиеи вращениеРис. 20.16.ТрансформацииудаленыРис. 20.16.ТрансформацииудаленыПодробную информацию о типах цветовых и координатных трансформаций, доступных в языке ActionScript, можно найти в описании пакета flash.geom.Transform в справочнике по языку ActionScript корпорации Adobe.
Рис. 20.15. Третий прямоугольник
Рис. 20.15. Третий прямоугольник
Рис. 20.13. Двапрямоугольникав контейнере
Рис. 20.13. Двапрямоугольникав контейнере
Рис. 20.14.
Перемещение,масштабированиеи вращение
Рис. 20.14.
Перемещение,масштабированиеи вращение
Рис. 20.16.
Трансформацииудалены
Рис. 20.16.
Трансформацииудалены
Трансформации, выполняемые над вложенными контейнерами, являются составными. Например, следующий код помещает прямоугольник в объект Sprite, который вложен в другой объект Sprite. Каждый из экземпляров класса Sprite будет повернут на 45°. В результате прямоугольник окажется повернутым на 90° (45 + 45).
// Создаем прямоугольник
van rectl;Shape = new Shape( ): recti.graphi cs.11neSty1e(1); recti.graphics.begi nF1l1(OxOOOOFF, 1); rectl.graphics.drawRect(O, 0, 75, 50);
var outerGroup:Spr1te = new Spr1te( );
var innerGroup;Sprite = new Spr1te( );
1nnerGroup.addChi1d(recti);
outerGroup.addChi1d(innerGroup);
1nnerGroup.rotation = 45;
outerGroup.rotation = 45;
Обращение к экземпляру основного класса SWF-файла из потомков
В языке ActionScript 3.0 отображаемые потомки экземпляра основного класса SWF- файла могут получать ссылку на этот экземпляр через переменную экземпляра root класса Displayobject. Например, рассмотрим код из листинга20.5, представляющий основной класс SWF-файла Арр. При выполнении этого кода среда Flash автоматически создает экземпляр класса Арр и выполняет его конструктор. Внутри конструктора два потомка экземпляра класса Арр (объект Sprite и объект Shape) обращаются к экземпляру класса Арр через переменную root.
Листинг 20.5. Обращение к экземпляру основного класса SWF-файла из потомков package {
import flash.display.*;
import flash.geom.*;
public class Арр extends Sprite {
public function Арр ( ) {
// Создаем потомков...
var rect:Shape = new Shape( );
rect.g raph1cs.11neSty1e(1);
rect.graphics.beg1nF111(OxOOOOFF, 1);
rect.graphlcs.drawRect(O. 0. 75. 50);
var spr1te:Spr1te = new Spr1te( );
sprite.addChlld(rect);
addChild(sprite);
// Используем выражение Displayobject.root для обращения
// к данному экземпляру класса Арр
trace(rect.root); // Выводит; [object Арр] trace(sprlte.root); // Выводит: [object Арр] }
}
}
Когда объект находится в списке отображения, но не является потомком экземпляра основного класса SWF-файла, его переменная stage возвращает ссылку на экземпляр класса Stage. Например, следующий код модифицирует класс Арр из листинга 20.5 таким образом, чтобы объект Sprite и его дочерний объект Shape добавлялись непосредственно в экземпляр Stage. Поскольку объекты Sprite и Shape не являются потомками экземпляра основного класса SWF-файла, их переменные root ссылаются на экземпляр класса Stage.
package {
Import flash.display.*;
import flash.geom.*;
public class App extends Sprite {
public function App ( ) {
var rect:Shape = new Shape( );
rect.graphlcs.11neSty1e(1);
rect.graphics.beg1nF111(OxOOOOFF. 1);
rect.graphlcs.drawRect(O. 0. 75. 50);
var spr1te:Spr1te = new Spr1te( );
sprite.addChl1d(rect);
// Добавляем дочерний объект к экземпляру класса Stage,
// а не к данному экземпляру класса Арр
stage.addChi1d(sprite);
trace(rect.root); // Отображает: [object Stage] trace(spr1te.root); // Отображает: [object Stage] }
}
}
Для объектов, которые находятся в списке отображения, но не являются потомками экземпляра основного класса SWF-файла, переменная экземпляра root класса Displayobject тождественна его переменной экземпляра stage.
В первом SWF-файле, открытом средой выполнения Flash, переменной root всех отображаемых объектов, которые не находятся в списке отображения, присвоено значение null.
В SWF-файлах, которые загружаются другими SWF-файлами, значение переменной root устанавливается следующим образом:
если отображаемые объекты являются отображаемыми потомками экземпляра основного класса, то переменная root ссылается на этот экземпляр, даже если экземпляр основного класса не находится в списке отображения;
для отображаемых объектов, которые не являются отображаемыми потомками экземпляра основного класса и не находятся в списке отображения, переменной root присваивается значение null.
Возрождение переменной _root
В языке ActionScript 2.0 и в более старых версиях языка глобальная переменная root ссылалась на самый верхний клип текущего уровня level. До появления языка ActionScript 3.0 обычный здравый смысл подсказывал, что использования переменной root следует избегать, поскольку ее значение было непостоянным (объект, на который ссылалась данная переменная, изменялся при загрузке SWF- файла в клип).
В языке ActionScript 3.0 глобальную переменную root заменяет переменная экземпляра root класса DisplayOb j ect. Переменная root класса DisplayOb j ect не подвержена непостоянству, которое было свойственно ее предку, и считается чистым, безопасным членом API отображения.
Й
Программисты на языке ActionScript, долгое время работавшие с предыдущими версиями языка и избегавшие применения устаревшей переменной „root, не должны испытывать чувство страха или вины при использовании переменной экземпляра root класса Displayobject в языке ActionScript 3.0.
Для чего нужна переменная Jevel?
В языках ActionScript 1.0 и 2.0 функция loadMovieNum ( ) использовалась для размещения внешних SWF-файлов на независимых уровнях приложения Flash Player. Для обращения к каждому уровню использовался следующий формат: _leveln, где п обозначает порядковый номер уровня в стеке уровней. В интерфейсе API среды выполнения Flash языка ActionScript 3.0 концепция слоев полностью отсутствует.
В языке ActionScript версии 3.0 ближайшим аналогом слоев являются дочерние объекты экземпляра класса Stage. Тем не менее, если в языках ActionScript 1.0 и 2.0 внешние SWF-файлы могли быть загружены непосредственно на уровень _level, в языке ActionScript 3.0 внешние SWF-файлы не могут быть загружены непосредственно в список дочерних объектов экземпляра класса Stage. Вместо этого, чтобы добавить внешний SWF-файл в список дочерних объектов экземпляра класса Stage, мы должны сначала загрузить его с помощью объекта Loader, а затем
поместить его в экземпляр класса Stage через вызов метода stage. addChild ( ), как показано в следующем коде:
var loader:Loader = new Loader( ):
1oader.1oad(new URLRequest("newContent.swf"));
stage.addChl1d(1oader);
Более того, в языке ActionScript 3.0 невозможно удалить все содержимое из приложения Flash Player, выполнив выгрузку уровня level0. Код наподобие следующего больше не является допустимым:
// Очистить все содержимое в приложении Flash Player.
// Исключено в языке ActionScript 3.0.
unioadMovIeNum(0);
Ближайшей заменой выражения unloadMovieNum(0) в языке ActionScript3.0 является следующее выражение:
stage.removeChl1dAt(0):
Выражение stage . removeChildAt (0) удаляет первый дочерний объект экземпляра класса Stage из списка отображения, но не обязательно удаляет его из программы. Если в программе существуют другие ссылки на этот дочерний объект, он продолжит свое существование, при этом его можно повторно добавить в любой другой контейнер. Как было показано в подразд. «Удаление элементов из памяти» этого раздела, чтобы полностью удалить отображаемый объект из программы, необходимо не только удалить объект из контейнера, но и удалить все ссылки на него. Более того, вызов метода stage. removeChildAt (0) затрагивает только первый дочерний объект экземпляра класса Stage; другие дочерние объекты не удаляются из списка отображения (в отличие от вызова функции unloadMovieNum (0) в языках ActionScript 1.0 и 2.0, которая удаляет содержимое со всех уровней level). Чтобы удалить все дочерние объекты экземпляра класса Stage, используется следующий код внутри объекта, находящегося на глубине 0 экземпляра класса Stage:
while (stage.numChlldren > 0) {
stage.removeChl1dAt(stage.numChl1dren-1);
// Когда удаляется последний дочерний объект, переменной stage
// присваивается значение null, поэтому завершаем цикл if (stage == null) {
break:
Подобным образом следующий устаревший код, который очищает приложение Flash Player от всего содержимого и затем помещает файл newContent. swf на уровень _level 0, больше не является допустимым:
1oadMovIeNum("newContent.swf", 0);
В ActionScript 3.0 эквивалент подобного выражения отсутствует. Но вполне вероятно, что в будущих версиях языка снова появится возможность очищать среду выполнения Flash от всего содержимого, заменяя его новым внешним SWF-файлом.
События контейнеров
Мы уже знаем, как использовать методы addChi1 d ( ) и addChi IdAt ( ) для добавления нового отображаемого дочернего объекта в объект Displayedj ectContainer. Вспомним обобщенный код:
// Метод addChild( )
некийКонтейнер. addCh 11 бКновыйРебенок)
И Метод addChildAt( )
некийКонтейнер.addCh11d(новыйРебенок, глубина)
Мы также знаем, что существующие дочерние отображаемые объекты могут быть удалены из объекта Displayedj ectContainer с помощью методов removechild ( ) и removeChildAt ( ). Опять же вспомним следующий обобщенный код:
// Метод removeCh1ld( )
некийКонтейнер. removeChi ШребенокДляУдаления)u
// Метод removeChildAt( )
некийКонтейнер.гетомеМ^ККглубинаРебенкаДляУдаления)
Наконец, мы знаем, что существующий дочерний отображаемый объект может быть удален из контейнера путем перемещения этого объекта в другой контейнер либо с помощью метода addChild ( ), либо с помощью метода addChildAt ( ). Вот этот код:
// Добавление объекта ребенок в контейнер некийКонтейнер
некийКонтейнер.addChi1б(ребенок) ,
// Удаление объекта ребенок из контейнера некийКонтейнер путем
// его перемещения в контейнер некийДругойКонтейнер
некийДругойКонтейнер.addChi1б(ребенок)
Каждая из этих операций добавления и удаления дочерних объектов сопровождается внутренним событием среды выполнения Flash — Event.ADDED или Event. REMOVED. В следующих трех разделах рассматривается, как эти два события используются в программировании экранного вывода.
Для изучения следующих разделов вам потребуется хорошее понимание системы иерархической диспетчеризации событий языка ActionScript, рассматриваемой в гл. 21. Если вы еще не до конца знакомы с иерархической диспетчеризацией событий, прочтите гл. 21 перед тем, как приступить к изучению следующих разделов.
События Event.ADDED и Event.REMOVED
После того как новый дочерний отображаемый объект добавляется в объект DisplayedjectContainer, среда Flash выполняет диспетчеризацию события Event. ADDED, получателем которого является новый дочерний объект. Подобным образом, когда существующий дочерний отображаемый объект удаляется из объекта Displayed j ectContainer, среда Flash выполняет диспетчеризацию события Event. REMOVED, получателем которого является удаленный дочерний объект.
Как будет рассмотрено в гл. 21, когда при диспетчеризации получателем события является объект в иерархии отображения, уведомление об этом событии получают данный объект и все его предки. Следовательно, когда возникает событие Event. ADDED, уведомление о добавленном дочернем объекте получают сам объект, его новый родительский контейнер и все предки данного контейнера. Подобным образом, когда возникает событие Event. REMOVED, уведомление об удаленном дочернем объекте получают сам объект, его старый родительский контейнер и все предки данного контейнера. Таким образом, события Event. ADDED и Event .REMOVED могут использоваться двумя различными способами:
экземпляр класса DisplayObjectContainer может использовать эти события, чтобы определить, когда у него появляется или теряется отображаемый потомок;
экземпляр класса Di spl а у Ob j ес t может использовать данные события, чтобы определить, когда он будет добавлен в родительский контейнер или удален из него.
Рассмотрим обобщенный код, который демонстрирует описанные сценарии, начиная с контейнера, определяющего факт появления нового потомка.
Сначала мы создадим два объекта Sprite: один из них будет играть роль контейнера, а другой — дочернего объекта:
var cental пег:Sprite = new Spr1te( );
var ch11d:Sprite = new Spr1te( );
Теперь мы создадим метод-приемник addedListener ( ), который будет регистрироваться в объекте container для получения событий Event .ADDED:
private function addedListener (e:Event):void {
trace("Added was triggered");
После этого мы регистрируем метод addedListener ( ) в объекте container:
contа1 пег.addEventLIstener(Event.ADDED, addedLlstener):
Наконец, мы добавляем объект child в объект container:
cental пег.addCh11d(ch11d);
При выполнении предыдущего кода среда Flash выполняет диспетчеризацию события Event. ADDED, получателем которого является объект child. В результате, поскольку объект container является отображаемым предком объекта child, на фазе всплытия события будет вызвана функция addedListener ( ), зарегистрированная в объекте container (дополнительную информацию по фазе всплытия можно найти в гл. 21).
Когда событие Event.ADDED вызывает приемник события на фазе захвата или всплытия, мы знаем, что у объекта, в котором зарегистрирован приемник, появился новый отображаемый потомок.
Теперь добавим новый дочерний объект в объект child, превратив container в гордого прародителя:
var grandchild:Spr1te = new Spr1te( ); child.addCh11d(g randch11d);
При выполнении предыдущего кода среда Flash снова осуществляет диспетчеризацию события Event .ADDED, получателем которого на этот раз является объект grandchild, и на фазе всплытия вновь вызывается метод addedListener ( ). Поскольку приемник вызван на фазе всплытия, мы знаем, что у объекта container появился новый потомок, но не уверены, является ли этот потомок непосредственным ребенком объекта container. Чтобы определить это, мы проверяем, совпадает ли значение переменной parent объекта child с объектом container, как показано в следующем коде:
private function addedListener (e:Event):void {
// Помните, что переменная Event.currentTarget ссылается на объект.
// в котором зарегистрирован выполняемый в настоящий момент приемник. -
// в данном случае, на объект container. Помните также, что переменная
// Event.target ссылается на получатель события, в данном случае -
// на объект grandchild.
1f (D1splayObject(е.target.parent) == e.currentTarget) { traceCA direct child was added");
} else {
traceCA descendant was added");
Продолжая работать с нашим примером, снова сделаем объект container ребенком, добавив его (и соответственно два его потомка) в экземпляр класса Stage:
stage.addChlld(conta1пег);
При выполнении предыдущего кода среда Flash снова осуществляет диспетчеризацию события Event .ADDED, получателем которого является объект container. И снова вызывается метод addedListener ( ) — на этот раз на фазе получения, а не на фазе всплытия.
Й
Когда событие Event.ADDED вызывает приемник события на фазе получения, мы знаем, что объект, в котором зарегистрирован приемник, был добавлен в родительский контейнер.
Чтобы различать ситуации, когда объект container приобретает нового потомка и когда сам объект container добавляется в родительский контейнер, мы проверяем текущую фазу события, как показано в следующем коде:
private function addedListener (e:Event):void {
// Если этот приемник был вызван на фазе захвата или всплытия...
1f (е.eventPhase != EventPhase.AT_TARGET) {
// ...контейнер получил нового потомка traceCnew descendant: " + е.target);
} else {
// ...в противном случае контейнер был добавлен к новому родителю traceCnew parent: " + D1 splayObject(е.target) .parent);
}
}
Теперь перейдем к событию Event. REMOVED. Оно работает аналогично событию Event. ADDED, но его диспетчеризация выполняется при удалении объектов, а не при их добавлении.
Следующий код регистрирует приемник события Event. REMOVED с именем removedListener( ) в объекте container для события Event. REMOVED:
centalпег.addEventHstener(Event.REMOVED. removedListener); *
Теперь удалим потомка из объекта container:
child.removeChl1d(grandch11d)
При выполнении предыдущего кода среда Flash осуществляет диспетчеризацию события Event .REMOVED, получателем которого является объект grandchild, и метод removedListener ( ) вызывается на фазе всплытия.
Далее следующий код удаляет сам объект container из экземпляра класса Stage:
stage.removeChl1d(conta1пег)
При выполнении приведенного кода среда Flash осуществляет диспетчеризацию события Event. REMOVED, получателем которого является объект container, и метод removedListener ( ) вызывается на фазе получения.
Как и в случае с методом addedListener ( ), в методе removedListener ( ) мы можем различать ситуации, когда объект container теряет потомка и когда сам объект container удаляется из своего родительского контейнера, проверяя текущую фазу события, как показано в следующем коде:
private function removedListener (e:Event):void {
// Если этот приемник был вызван на фазе захвата или на фазе всплытия...
if (е.eventPhase != EventPhase.AT_TARGET) {
// ...из контейнера удаляется потомок
traceC'a descendant was removed from container: " + e.target);
} else {
// ...в противном случае контейнер удаляется из своего родителя traceCcontainer 1s about to be removed from Its parent: "
+ D1splayObject(e.target).parent);
}
}
В листинге 20.6 представлены предыдущие примеры кода для событий Event. ADDED и Event. REMOVED в контексте тестового класса ContainmentEventDemo. Мы рассмотрим реальные примеры использования событий контейнеров в двух следующих разделах.
Листинг 20.6. Демонстрация событий контейнера
package {
Import flash.display.*:
Alport A A ash. e\i ents .*;
public class ContainmentEventDemo extends Sprite {
public function ContainmentEventDemo ( ) {
// Создаем объекты Sprite
var contalпег:Spr1te = new Spr1te( );
var chi 1d:Sprite = new Spr1te( );
var grandch1ld:Spr1te = new Spr1te( );
// Приступаем к приему событий Event.ADDED и Event.REMOVED contalner.addEventLi stener(Event.ADDED. addedLlstener);
container.addEventListener(Event.REMOVED, removedLlstener):
// Добавляем объект child в объект container
container.addChlld(chlld); // Вызывает метод addedLlstener( ) // на фазе всплытия
// Добавляем объект grandchild в объект child
child.addChlld(grandchlld); // Вызывает метод addedtlstener( ) // на фазе всплытия
// Добавляем объект container в экземпляр класса-Stage
stage.addChl1d(conta1 пег); // Вызывает метод addedtlstener( ) // на фазе получения
// Удаляем объект grandchild из объекта child
child.removeChlld(grandchlld) // Вызывает метод removedLlstener( ) // на фазе всплытия
// Удаляем объект container из экземпляра класса Stage
stage.removeChlld(conta1ner) // Вызывает метод removedLlstener( ) // на фазе получения
// Обрабатывает события Event.ADDED
private function addedLlstener (e:Event):void {
1f (e.eventPhase != EventPhase.AT_TARGET) {
traceC'contalner has a new descendant: " + e.target);
} else {
traceC'contalner was added to a new parent: "
+ D1splayObject(e.target).parent);
}
// Обрабатывает события Event.REMOVED
private function removedLlstener (e:Event):void {
1f (e.eventPhase != EventPhase.AT_TARGET) {
traceC'a descendant was removed from container: " + e.target): } else {
traceC'contalner was removed from Its parent: "
+ D1splayObject(e.target).parent):
}
// В результате выполнения приложения ContalnmentEventDemo // выводятся следующие строки:
container has a new descendant: [object Sprite] container has a new descendant: [object Sprite] container was added to a new parent: [object Stage] a descendant was removed from container: [object Sprite] container was removed from Its parent: [object Stage]
Реальный пример использования событий контейнера
Теперь, когда известно, как работают события Event. ADDED и Event. REMOVED в теории, рассмотрим, как можно использовать их в реальном приложении. Предположим, что мы создаем класс IconPanel, который управляет визуальным расположением графических значков. Класс IconPanel используется в качестве одной из частей большего оконного компонента в интерфейсе, основанном на оконном представлении. Всякий раз при добавлении нового или удалении существующего значка из объекта IconPanel этот объект исполняет алгоритм по размещению значков. Чтобы определить моменты добавления и удаления дочерних значков, объект IconPanel регистрирует приемники для событий Event. ADDED и Event. REMOVED.
В листинге 20.7 представлен код класса IconPanel, который намеренно был упрощен, чтобы продемонстрировать использование событий Event.ADDED и Event. REMOVED. Обратите внимание, что приемники событий Event. ADDED и Event. REMOVED выполняют код по размещению значков только в том случае, когда объект IconPanel приобретает нового или теряет существующего непосредственного ребенка. Код по размещению значков не выполняется в следующих ситуациях:
когда объект IconPanel приобретает или теряет потомка, который не является непосредственным ребенком;
если сам объект IconPanel добавляется в родительский контейнер.
Листинг 20.7. Размещение значков в классе IconPanel
package {
Import flash.display.*;
Import flash.events.*:
public class IconPanel extends Sprite {
public function IconPanel ( ) {
addEventL1stener(Event.ADDED, addedLlstener): addEventLIstener(Event.REMOVED, removedLlstener):
}
public function updateLayout ( ):vo1d {
// Выполняет алгоритм размещения значков (код не приводится) }
// Обрабатывает события Event.ADDED
private function addedLlstener (e:Event):void {
1f (D1splayObject(e.target.parent) == e.currentTarget) {
updateLayout( );
}
}
// Обрабатывает события Event.REMOVED
private function removedListener (e:Event):void {
if (DisplayObject(e.target.parent) == e.currentTarget) { updateLayout( );
}
}
}
События ADDED_TO_STAGE и REMOVED _FROM_STAGE
Как мы уже знаем из двух приведенных выше разделов, события Event .ADDED и Event.REMOVED возникают, когда экземпляр класса Displayobject добавляется в экземпляр класса DisplayObjectContainer или удаляется из него. Однако по событиям Event. ADDED и Event. REMOVED нельзя определить, находится данный объект в настоящий момент в списке отображения или нет. Чтобы определить, когда экземпляр класса Displayobject добавляется в список отображения или удаляется из него, используются события Event. ADDED_TO_STAGE и Event .REMOVED_FROM_STAGE, которые были добавлены в API отображения, начиная с приложения Flash Player 9.0.28.0.
Когда отображаемый объект (или один из его предков) добавляется в список отображения, Flash выполняет диспетчеризацию события Event. ADDED_TO_STAGE, получателем которого является данный объект. С другой стороны, когда отображаемый объект (или один из его предков) удаляется из списка отображения, среда Flash выполняет диспетчеризацию события Event. REMOVED_FROM_STAGE, получателем которого является данный объект.
^В отличие от событий Event.ADDED и Event.REMOVED, у событий Event.ADDED_TO_STAGE
^ 4 * И Event.REMOVED_FROM_STAGE отсутствует фаза всплытия. Для получения события
U^ Event.ADDED_TO_STAGE или Event.REMOVE_FROM_STAGE через предка объекта зарегистрируйте приемник в этом предке для фазы захвата события.
Обобщенный код, который необходим для регистрации приемника события Event. ADDED_TO_STAGE в экземпляре класса DisplayObj ect, выглядит следующим образом:
отображаемыйОбъект.a dd Еv ent L1 stener(Event.ADDED_TO_STAGE, приемникСобытияАббе(По51аде'):
Код, необходимый для приемника события Event. ADDED_TO_STAGE, выглядит таким образом:
private function пpиeмникCoбытияAddedToStage (e:Event):void { }
Обобщенный код, который необходим для регистрации приемника события Event.REMOVED_FROM_STAGE в экземпляре класса Displayobject, выглядит следующим образом:
отображаемыйОбъект.addEventListener(Event.REMOVED_FROM_STAGE, npneMHHKCo6wTHHRemovedFromStage);
Теперь рассмотрим обобщенный код, необходимый для приемника события Event.REMOVED_FROM_STAGE:
private function npneMHHKCo6wTHHRemovedFromStage (e:Event):void { }
Отображаемые объекты обычно используют событие Event. ADDED_TO_STAGE, чтобы убедиться в доступности объекта Stage перед обращением к его методам, переменным или событиям. Предположим, что мы создаем класс CustomMousePointer, который представляет пользовательский указатель мыши. Наш класс CustomMousePointer расширяет класс Sprite, поэтому его экземпляры могут добавляться в список отображения. Мы хотим, чтобы наш класс был зарегистрирован в экземпляре класса Stage для получения событий MouseEvent . MOUSE_EVENT, благодаря чему мы сможем синхронизировать позицию пользовательского указателя мыши с позицией системного указателя мыши.
Однако после создания новый объект CustomMousePointer не находится в списке отображения, поэтому не имеет доступа к экземпляру класса Stage и не может зарегистрироваться для получения события MouseEvent .MOUSE MOVE. Вместо этого объект должен ожидать уведомления о том, что он был добавлен в список отображения (через событие Event. ADDED_TO_STAGE). Как только объект CustomMousePointer будет добавлен в список отображения, его переменная stage будет ссылаться на экземпляр класса Stage и он сможет успешно зарегистрироваться для получения события MouseEvent .MOUSE_MOVE. Следующий код демонстрирует соответствующий фрагмент кода, относящийся к событию Event. ADDED_TO_STAGE, из класса CustomMousePointer. Полный листинг кода класса CustomMousePointer можно найти в подразд. «Определение позиции указателя мыши» разд. «События мыши» гл. 22.
package {
public class CustomMousePointer extends Sprite { public function CustomMousePointer ( ) {
// Просим сообщить, когда этот объект будет добавлен
// в список отображения
addEventListener(Event.ADDEDJT)_STAGE, addedToStageListener);
}" "
// Вызывается, когда этот объект добавляется в список отображения private function addedToStageListener (e:Event)-.void {
// Теперь можно безопасно регистрироваться в экземпляре класса Stage
// на получение событий MouseEvent.MOUSE_MOVE
stage.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveListener);
}"
}
}
Собственные события Event.ADDED_TO_STAGE и Event.REMOVE_FROM_
STAGE. Первая версия приложения Flash Player 9 не содержала ни события Event. ADDED_TO_STAGE, НИ события Event. REMOVED_FROM_STAGE. Тем не
менее, воспользовавшись обычным интерфейсом API отображения и проявив немного изобретательности, мы можем вручную определить, что данный объект был добавлен в список отображения или удален из него. Для этого мы должны отслеживать состояние предков данного объекта с помощью событий Event .ADDED и Event .REMOVED.
В листинге 20.8 демонстрируется данный подход. В этом примере пользовательский класс StageDetector следит за отображаемым объектом, чтобы определить, когда он добавляется в список отображения или удаляется из него. Класс StageDetector рассылает пользовательское событие:
StageDetector. ADDED_TO_STAGE — когда объект добавляется в список отображения;
StageDetector. REMOVED_FROM_STAGE — когда объект удаляется из списка отображения.
Вы вполне можете применять пользовательские события ADDED TO STAGE и REMOVED_FROM_STAGE, даже не имея ни малейшего представления о том, как устроен и функционирует класс StageDetector. Однако он позволяет провести интересный обзор методик программирования, относящихся к списку отображения, которые были рассмотрены в этой главе, поэтому посмотрим, как он работает.
В классе StageDetector объект, для которого отслеживаются пользовательские события ADDED_TO_STAGE и REMOVED_FROM_STAGE, присваивается переменной watchedRoot. Рассмотрим общий подход, применяемый в классе StageDetector для определения присутствия объекта watchedOb j ect в списке отображения.
Нужно отслеживать события Event. ADDED и Event. REMOVED для объекта watchedRoot.
Когда объект watchedRoot добавляется в объект DisplayOb j ectContainer, проверять, находится ли watchedOb j ect в настоящий момент в списке отображения (он находится в списке отображения, если значение его переменной stage не равно null). Если в настоящий момент объект watchedObject находится в списке отображения, то следует выполнить диспетчеризацию события StageDetector. ADDED_TO_STAGE. Если нет, то приступить к отслеживанию событий Event .ADDED и Event. REMOVED для нового объекта watchedRoot. .
Когда объект watchedOb j ect есть в списке отображения, если watchedRoot или любой из его потомков удаляется из объекта DisplayObjectContainer, проверять, является ли удаленный объект предком watchedOb j ect. Если да, то выполнить диспетчеризацию события StageDetector. REMOVED_FROM_STAGE и приступить к отслеживанию событий Event .ADDED и Event. REMOVED для нового корня иерархии отображения объекта watchedObj ect.
Теперь рассмотрим код класса StageDetector.
Листинг 20.8. Пользовательские события ADDED_TO_STAGE и REMOVED_FROM_STAGE
package {•
Import fl ash.di splay.*;
Import fl ash.events.*;
// Наблюдает за указанным отображаемым объектом, чтобы определить,
// когда этот объект добавляется или удаляется из экземпляра класса Stage, // и рассылает соответствующие пользовательские события
// StageDetector.ADDED_TO_STAGE и StageDetector.REMOVED_FROM_STAGE.
// ИСПОЛЬЗОВАНИЕ:
// var StageDetector:StageDetector = new StageDetector(someDisplayObject):
// StageDetector.addEventtistener(StageDetector.ADDED_TO_STAGE,
//addedToStageListenerFunction):
// stageDetector.addEventtistener(StageDetector.REMOVED_FROM_STAGE,
//removedFromStagetistenerFunction);
public class StageDetector extends EventDispatcher {
// Событийные константы
public static const ADDED_TO_STAGE:String = "ADDED_TO_STAGE”:
public static const REMOVED_FROM_STAGE:String = ”REMOVED_FROM_STAGE”:
// Объект, для которого будут генерироваться события ADDED_TO_STAGE
// и REMOVED_FROM_STAGE
private var watchedObject:DisplayObject = null:
// Корень иерархии отображения, содержащей объект watchedObject
private var watchedRodt.*Dj splayObject = null:
// Флаг, который говорит, находится ли объект watchedObject
// в настоящий момент в списке отображения
private var onstage .-Boolean = false:
// Конструктор
public function StageDetector (objectToWatch:DisplayObject) {
// Приступаем к мониторингу указанного объекта setWatchedObj ect(objectToWatch);
} ■
// Приступает к мониторингу указанного объекта, чтобы определить,
// добавлен объект в список отображения или удален из него
public function setWatchedObject (objectToWatch:DisplayObject):void {
// Сохраняем отслеживаемый объект
watchedObject = objectToWatch:
// Помечает, находится ли объект watchedObject в настоящий момент
// в списке отображения
if (watchedObject.stage != null) {
onstage = true:
}‘
// Находит корень иерархии отображения, содержащей объект
// watchedObject, и регистрируем в найденном объекте приемники
// для событий ADDED/REMOVED. Проверяя, добавлен или удален
// корень объекта watchedObject, мы сможем определить,
// находится объект watchedObject в списке отображения или нет. setWatchedRoot(findWatchedObjectRoot( )):
// Возвращает ссылку на отслеживаемый объект
public function getWatchedObject ( ):DisplayObject { return watchedObject;
}
// Освобождает ресурсы данного объекта StageDetector. Вызываем этот
// метод перед уничтожением объекта StageDetector.
public function dispose ( ):vo1d {
clearWatchedRoot( );
watchedObject = null;
}
// Обрабатывает события Event.ADDED, получателем которых является
// корневой объект иерархии отображения -объекта watchedObject
private function addedLlstener (e:Event):vo1d {
// Если текущий объект watchedRoot был добавлен...
1f (е.eventPhase == EventPhase.AT_TARGET) {
// ...проверяем, находится ли объект watchedObject в настоящий
// момент в списке отображения
1f (watchedObject.stage != null) {
// Помечаем, что объект watchedObject теперь находится
// в списке отображения onstage = true;
// Сообщаем приемникам, что объект watchedObject теперь
// находится в списке отображения
d1spatchEvent(new Еvent(StageDetector.ADDED_TO_STAGE));
}" "
// Объект watchedRoot был добавлен в другой контейнер, поэтому
// сейчас корнем иерархии отображения объекта, содержащей объект
// watchedObject, является новый объект. Находим этот новый корень // и регистрируемся в нем для получения событий ADDED и REMOVED. setWatchedRoot(f1ndWatchedObjectRoot( ));
}
}
// Обрабатывает события Event.REMOVED для корневого объекта иерархии
// отображения объекта watchedObject
private function removedLlstener (e:Event):void {
// Если объект watchedObject находится в списке отображения...
1f (onstage) {
// ...проверяем, был ли удален объект watchedObject
// или один из его предков
var wasRemoved:Boolean = false;
var ancestor:Displayobject = watchedObject;
var target:Displayobject = D1splay0bject(e.target);
while (ancestor != null) {
if (target == ancestor) {
wasRemoved = true;
break;
}
ancestor = ancestor.parent;
// Если объект watchedObject или один из его предков был удален... if (wasRemoved) {
// ...регистрируемся для получения событий ADDED и REMOVED
// от удаленного объекта (который является новым корнем
// иерархии отображения объекта watchedObject).
setWatchedRoot(ta rget);
// Помечает, что объект watchedObject больше не находится
// в списке отображения onstage = false;
// Сообщаем приемникам, что объект watchedObject был удален
// из объекта Stage
dispatchEvent(new Event(StageDetector.REMOVED_FROM_STAGE));
}" "
}
}•
// Возвращает корневой" объект иерархии отображения, в настоящий момент
// содержащий объект watchedObject
private function flndWatchedObjectRoot ( ):Displayobject {
var watchedObjectRoot:Displayobject = watchedObject;
while (watchedObjectRoot.pa rent != null) {
watchedObjectRoot = watchedObjectRoot.parent;
}
return watchedObjectRoot;
// Начинает отслеживание событий ADDED и REMOVED, получателем
// которых является корневой объект иерархии отображения
// объекта watchedObject
private function setWatchedRoot (newWatchedRoot:Displayobject):void { clearWatchedRoot( );
watchedRoot = newWatchedRoot;
reg1sterLIsteners(watchedRoot);
}
// Удаляет приемники событий из объекта watchedRoot и ссылку
// на объект watchedRoot из данного объекта StageDetector
private function clearWatchedRoot ( ):vo1d {
1f (watchedRoot != null) {
unreglsterLIsteners(watchedRoot);
watchedRoot = null;
}
}
// Регистрирует приемники событий ADDED и REMOVED в объекте watchedRoot private function reg1sterLIsteners (target:D1splayObject):void {
target.addEventListener(Event.ADDED, addedListener):
target.addEventListener(Event.REMOVED, removedListener);
И Отменяет регистрацию приемников событий ADDED и REMOVED
И в объекте watchedRoot
private function unregisterLIsteners (target:D1splay0bject):void {
target.removeEventLIstener(Event.ADDED, addedListener);
target.removeEventLIstener(Event.REMOVED, removedLlstener);
}
}'
}
О том, как пользовательские события StageDetector. ADDED_TO_STAGE и Stage . REMOVED_FROM_STAGE применяются в классе CustomMousePointer, будет рассказано в гл. 22.
Мы завершили изучение интерфейса API, связанного с контейнерами. Напоследок рассмотрим одну небольшую, но очень важную тему в программировании экранного вывода: пользовательские графические классы.
Пользовательские графические классы
В этой главе мы нарисовали множество прямоугольников, окружностей и треугольников. Так много, что некоторые из рассмотренных примеров содержали «код с погрешностями»: код повторялся и, как результат, способствовал ошибкам.
Дополнительную информацию о «коде с погрешностями» (общие признаки потенциальных проблем в коде) можно найти по адресу http.7/xp.c2.com/CodeSmell.html.
Чтобы обеспечить возможность повторного применения и модульность при работе с примитивными фигурами, мы можем перенести повторяющиеся процедуры рисования в пользовательские классы, которые расширяют класс Shape. Начнем с пользовательского класса Rectangle, применив чрезвычайно простой подход, который предоставляет весьма ограниченный набор вариантов контура и заливки и не позволяет изменять прямоугольник после того, как он будет нарисован (мы расширим возможности класса Rectangle в гл. 25). Этот код продемонстрирован в листинге 20.9.
Листинг 20.9. Rectangle — простой подкласс класса Shape
package {
Import flash.display.Shape:
public class Rectangle extends Shape { public function Rectangle (w:Number, h:Number,
HneThickness: Number, HneColor:u1nt, f1l1 Col or:u1nt) {
g raph1cs.11neStyle(11neThlckness, 11neColor);
graphics.beg1nF111(fill Col or, 1);
graphics.drawRect(O, 0, w, h);
}
}
}
Поскольку класс Rectangle расширяет класс Shape, он наследует переменную graphics класса Shape и может использовать ее для рисования прямоугольника.
Для создания нового экземпляра класса Rectangle применяется следующий знакомый нам код:
var reel:Rectangle = new RectangleQOO, 50, 3, OxFFOOOO, OxOOOOFF);
Поскольку класс Shape является потомком Displayobject, класс Rectangle наследует возможность быть добавленным в список отображения (как и любой другой потомок класса DisplayObj ect), наподобие следующего кода:
некийКонтейнер.a ddCh11d(rect);
Являясь потомком класса Displayobject, объект Rectangle может быть позиционирован, повернут и подвергнут другим действиям, как и любой другой отображаемый объект. Например, следующий код устанавливает горизонтальной позиции объекта Rectangle значение 15, а вертикальной — значение 30: ' rect.x = 15; rect.у = 30;
Однако развлечения на этом не заканчиваются. Любой класс API отображения может быть расширен. Например, приложение может расширить класс Text Field для отображения специализированной текстовой формы. Это демонстрирует код из листинга 20.10, который представляет подкласс класса TextField, создающий текстовый заголовок с возможностью перехода по ссылке.
Листинг 20.10. ClickableHeading — подкласс класса TextField package {
Import flash.display.*:
public class ClickableHeading extends TextField {
public function ClickableHeading (headText;String, URL;Str1ng) {
html = true:‘
autoSize = TextF1eldAutoS1ze.LEFT;
htmlText = "<a href='" + URL + '">" + headText + "</a>";
border = true;
background = true;
}
}
}
Вот как можно использовать класс ClickableHeading в приложении:
var head:ClIckableHeading = new CHckableHead1ng(
"Essential Act1onScr1pt 3.0", "http://www.moock.org/eas3");
addChl1d(head);
На рис. 20.17 показано результирующее содержимое, отображаемое на экране. При выполнении этого примера в среде Flash текст будет связан с сопутствующим сайтом для этой книги.
Essential ActionScript 3.0 |
Рис. 20.17. Экземпляр класса ClickableHeading
В следующих главах мы встретим множество примеров отображаемых подклассов. Разрабатывая графические элементы, необходимые для ваших приложений, подумайте над возможностью расширения существующего класса отображения вместо того, чтобы создавать классы с нуля.
Переходим к цепочке диспетчеризации событий
После прочтения этой главы вы должны чувствовать себя достаточно комфортно, создавая отображаемое содержимое и выводя его на экран. Многие примеры, представленные далее в" книге, опираются на принципы, рассмотренные в этой главе, поэтому у вас появится масса возможностей, чтобы вспомнить пройденный материал и расширить полученные знания. Из следующей главы мы узнаем, как событийная архитектура языка ActionScript 3.0 применяется к объектам в списке отображения.
События и иерархии отображения
В гл. 12 мы в общих чертах ознакомились с внутренней событийной архитектурой языка ActionScript. В этой главе мы подробно рассмотрим, как эта событийная архитектура адаптируется к объектам в иерархиях отображений.
Система диспетчеризации событий через иерархию объектов языка ActionScript, о которой пойдет речь в этой главе, основана на спецификации Document Object Model (DOM) Level 3 Events Specification консорциума W3C, доступной по адресу http://www.w3.org/ TR/DOM-Level-3-Events.
Иерархическая диспетчеризация событий
Как мы уже видели в гл. 12, когда среда Flash выполняет диспетчеризацию события, получателем которого является объект, не входящий в состав иерархии отображения, этот получатель будет единственным, кто узнает о возникновении события. Например, когда завершается воспроизведение звукового файла в объекте Sound, среда Flash выполняет диспетчеризацию события Event. COMPLETE, получателем которого выступает соответствующий объект Soundchannel. Этот объект не входит в состав иерархии отображения, поэтому он будет единственным объектом, который узнает о возникновении этого события.
В отличие от этого, когда среда Flash выполняет диспетчеризацию события, получателем которого является объект, входящий в состав иерархии отображения, этот получатель и все его предки в иерархии отображения узнают о возникновении события. Например, если объект Sprite содержит объект TextField и пользователь щелкает кнопкой мыши на втором объекте, то и TextField (получатель события), и Sprite (предок получателя события) узнают о том, что произошел щелчок кнопкой мыши.
Система иерархической диспетчеризации событий языка ActionScript позволяет каждому контейнеру отображаемых объектов регистрировать приемники для обработки событий, получателями которых являются отображаемые объекты-потомки этого контейнера. Например, объект Sprite, представляющий окно, может зарегистрировать приемник, обрабатывающий события о щелчке кнопкой мыши, получателем которых является вложенный элемент управления «кнопка ОК». Или объект Sprite, представляющий форму для авторизации, может зарегистрировать приемник, обрабатывающий события фокуса, получателями которых являются вложенные поля ввода.
Такая централизованная архитектура позволяет сократить объемы повторяющегося кода, особенно реагирующего на события пользовательского ввода. Далее, в разд. «Использование цепочки диспетчеризации события для централизации кода», мы рассмотрим пример, который демонстрирует преимущества централизованной обработки событий. Но для начала познакомимся с основами иерархической диспетчеризации событий и регистрации.
В этой главе термины «предок» и «потомок» в основном используются для обозначения объектов в иерархии отображения, а не суперклассов и подклассов в иерархии наследования. Чтобы избежать путаницы, в этой главе иногда используются неофициальные термины «отображаемый предок» и «отображаемый потомок» для обозначения объектов-предков и объектов-потомков в иерархии отображения.
Фазы диспетчеризации событий
Как уже известно, когда среда Flash выполняет диспетчеризацию события, получателем которого является объект в иерархии отображения, о возникновении события узнает не только данный получатель, но и все его отображаемые предки. Процесс, в результате которого о возникновении события узнают получатель и все его предки, разбивается на три отдельные фазы. На первой фазе процесса диспетчеризации события, называемой фазой захвата, уведомление о возникновении события получают все предки объекта-получателя. Как только все предки объекта-получателя получат уведомление о возникновении события, начинается вторая фаза процесса диспетчеризации события, называемая фазой получения. На этой фазе среда выполнения Flash уведомляет объект-получатель о возникновении события.
Для некоторых типов событий процесс диспетчеризации завершается сразу после окончания фазы получения. Для остальных типов событий процесс диспетчеризации переходит в третью фазу, называемую фазой всплытия. На этой фазе предки объекта-получателя узнают о том, что получатель был успешно уведомлен о возникновении события. События, имеющие фазу всплытия, называются всплывающими', события, не имеющие фазу всплытия, называются невсплывающими.
У четырех типов событий — Event.ACTIVATE, Event.DEACTIVATE, Event. ENTER_FRAME и Event.RENDER — есть только фаза получения. Процесс диспетчеризации всех остальных событий, получателем которых является объект в иерархии отображения, включает фазу захвата и фазу получения. Некоторые типы событий также имеют фазу всплытия.
Порядок, в котором объекты узнают о возникновении события в процессе диспетчеризации, зависит от фазы события. На фазе захвата уведомление предков начинается от корневого объекта иерархии отображения объекта-получателя и, проходя вниз по всем потомкам, завершается на непосредственном родителе объекта-получателя. На фазе захвата уведомление самого получателя не происходит. На фазе всплытия уведомление предков происходит в порядке, обратном порядку на фазе захвата, — начинается от непосредственного родителя объекта-получателя и, проходя вверх, заканчивается на корневом объекте иерархии. Процесс, в результате
которого уведомление о событии передается вниз через предков объекта-получателя (фаза захвата) к объекту-получателю (фаза получения) и обратно через его предков (фаза всплытия), называется цепочкой диспетчеризации события. Когда уведомление о событии проходит по цепочке диспетчеризации события, говорят, что событие передается от объекта к объекту.
Рассмотрим простой пример цепочки диспетчеризации события. Предположим, что экземпляр класса Stage содержит объект Sprite, который, в свою очередь, содержит объект TextField, как показано на рис. 21.1. Видно, что корнем иерархии отображения объекта TextField является экземпляр класса Stage, а непосредственным родителем объекта TextField — объект Sprite.
Теперь предположим, что пользователь вводит некий текст в объект TextField, в результате чего среда Flash вынуждена выполнить диспетчеризацию события TextEvent. TEXT INPUT, получателем которого является объект TextField. Поскольку объект TextField является частью иерархии отображения, событие передается по цепочке диспетчеризации события. В первой фазе процесса (фазе захвата) уведомление о возникновении события сначала получает экземпляр класса Stage, а затем — экземпляр класса Sprite. Во второй фазе (фазе получения) уведомление о возникновении события получает сам объект TextField. Наконец, в третьей фазе процесса (фазе всплытия) уведомление о том, что получатель был уведомлен о возникновении события, сначала получает экземпляр класса Sprite, а затем — экземпляр класса Stage. Всего в процессе диспетчеризации события TextEvent. TEXT INPUT происходит пять уведомлений о возникновении события, как показано на рис. 21.2.
Экземпляр класса StageЭкземпляр класса StageФазазахватаФазазахватаУведомленэкземпляркласса StageАУведомленобъект SpriteУведомленэкземпляркласса StageАУведомленобъект SpriteЭкземпляркласса StageЭкземпляркласса StageУведомленэкземпляркласса StagetУведомленобъект SpriteУведомленэкземпляркласса StagetУведомленобъект SpriteФазавсплытияФазавсплытияОбъект SpriteОбъект SpriteОбъект TextFieldОбъект TextFieldРис. 21.1. Пример иерархии отображенияРис. 21.1. Пример иерархии отображенияОбъект SpriteОбъект SpriteУведомлен объект TextFieldУведомлен объект TextFieldФаза полученияФаза полученияРис. 21.2. Цепочка диспетчеризации для события TextEvent.TEXT_INPUTРис. 21.2. Цепочка диспетчеризации для события TextEvent.TEXT_INPUT
Экземпляр класса Stage
Экземпляр класса Stage
Фазазахвата
Фазазахвата
Уведомленэкземпляркласса Stage
А
Уведомленобъект Sprite
Уведомленэкземпляркласса Stage
А
Уведомленобъект Sprite
Экземпляркласса Stage
Экземпляркласса Stage
Уведомленэкземпляркласса Staget
Уведомленобъект Sprite
Уведомленэкземпляркласса Staget
Уведомленобъект Sprite
Фазавсплытия
Фазавсплытия
Объект Sprite
Объект Sprite
Объект TextField
Объект TextField
Рис. 21.1. Пример иерархии отображения
Рис. 21.1. Пример иерархии отображения
Объект Sprite
Объект Sprite
Уведомлен объект TextField
Уведомлен объект TextField
Фаза получения
Фаза получения
Рис. 21.2. Цепочка диспетчеризации для события TextEvent.TEXT_INPUT
Рис. 21.2. Цепочка диспетчеризации для события TextEvent.TEXT_INPUT
Приемники событий и цепочка диспетчеризации событий
Как мы только что увидели, в процессе диспетчеризации события, получателем которого является некоторый отображаемый объект, отображаемые предки этого
объекта получают уведомление о возникновении события на фазе захвата и теоретически на фазе всплытия (если событие является всплывающим). Соответственно, при регистрации приемника в предке получателя события мы должны указать, когда вызывать этот приемник — в фазе захвата или в фазе всплытия.
Чтобы зарегистрировать приемник в предке получателя события для фазы захвата диспетчеризации события, мы устанавливаем третьему параметру useCapture метода addEventListener ( ) значение true, как показано в следующем коде:
предок.addEventListener(событие. приемник, true)
Эта строка кода заставляет метод приемник( ) выполняться всякий раз, когда среда Flash осуществляет диспетчеризацию события событие, получателем которого является один из потомков объекта предок, до того как потомки получат уведомление о возникновении этого события.
Чтобы зарегистрировать приемник в предке получателя события для фазы всплытия диспетчеризации события, мы устанавливаем третьему параметру useCapture метода addEventListener ( ) значение false, как показано в следующем коде:
предок.addEventListener(событие, приемник, false)
В качестве альтернативы, поскольку в качестве значения по умолчанию параметра useCapture используется false, мы можем просто опустить аргумент useCapture, как показано в следующем коде:
предок.addEventListener(событие, приемник)
Приведенная строка кода заставляет метод приемник( ) выполняться всякий раз, когда среда Flash осуществляет диспетчеризацию события событие, получателем которого является один из потомков объекта предок, после того как потомки получат уведомление о возникновении этого события.
I Для краткости в оставшейся части этой главы мы будем использовать неофициальный *Д J термин «приемник предка», который обозначает «приемник события, зарегистриро-
——-3$ ванный в отображаемом предке получателя события». Подобным образом, мы будем использовать термин «приемник получателя», который обозначает «приемник события, зарегистрированный непосредственно в получателе события».
При регистрации приемника предка для невсплываюгцего события мы всегда выполняем регистрацию для фазы захвата (то есть в качестве значения параметра useCapture передаем true). В противном случае этот приемник вызван не будет. При регистрации приемника предка для всплывающего события мы выбираем уведомления либо в фазе захвата (значение параметра useCapture — true), либо в фазе всплытия (значение параметра useCapture — false), или же оба типа уведомлений, в зависимости от потребностей приложения.
Фаза захвата дает возможность приемникам предков обработать событие до того, как приемники получателя события ответят на него. Обычно приемники, зарегистрированные для фазы захвата, используются для прекращения передачи события его получателю в зависимости от некоторого условия. Например, элемент пользовательского интерфейса, представляющий панель с состояниями
«доступна» и «недоступна», может использовать приемник, зарегистрированный для фазы захвата, чтобы предотвратить передачу событий мыши потомкам этой панели, когда панель находится в недоступном состоянии (как останавливать события, будет описано далее, в разд. «Остановка процесса диспетчеризации события»).
В отличие от этого, фаза всплытия дает возможность приемникам предков обработать событие после того, как приемники получателя события уже отреагируют на него. Обычно фаза всплытия применяется для реакции на изменения в состоянии целевого объекта перед тем, как будет продолжено выполнение программы и обновлено содержимое на экране. Например, элемент пользовательского интерфейса, представляющий панель, которая содержит перетаскиваемые значки, может использовать приемник, зарегистрированный для фазы всплытия, чтобы автоматически выравнивать значки после перетаскивания одного из них.
В отличие от приемников предков, приемники, зарегистрированные в получателе события, могут вызываться только в одной фазе — фазе получения. Чтобы зарегистрировать приемник в получателе события для фазы получения процесса диспетчеризации события, мы регистрируем этот приемник с помощью вызова метода addEventListener ( ), третьему параметру useCapture которого устанавливается значение false, — точно так же, как мы регистрируем приемник предка для получения уведомлений на фазе всплытия. Этот подход демонстрирует следующий обобщенный код:
получательСобытия.addEventListener(событие. приемник, false)
Или просто:
получательСобытия.addEventListener(событие, приемник)
Приведенная строка кода заставляет метод приемник( ) выполняться всякий раз, когда среда Flash выполняет диспетчеризацию события событие, получателем которого является объект получательСобытия, после того как предки объекта получательСобытия на фазе захвата получат уведомление о возникновении этого события.
При регистрации приемника события непосредственно в получателе события для уведом- ^ а е лений на фазе получения параметр useCapture должен быть всегда установлен в значение ц?.‘ false или вообще опущен. В противном случае приемник никогда не будет вызван.
В следующих разделах представлено множество примеров применения параметра useCapture и рассматривается несколько вопросов, связанных с регистрацией для получения событий на конкретных фазах.
Регистрация приемника предка для фазы захвата
Как мы уже знаем, чтобы зарегистрировать приемник предка для уведомлений о возникновении события в фазе захвата, мы устанавливаем параметру useCapture метода addEventListener ( ) значение true, как показано в следующем коде:
предок.addEventListener(событие. приемник, true)
Теперь используем этот код в работающем примере. Для тестовой иерархии отображения возьмем сценарий, который был изображен на рис. 21.1, — экземпляр класса Stage включает в себя объект Sprite, который, в свою очередь, содержит объект TextField. В листинге 21.1 представлен код для создания этой иерархии.
Листинг 21.1. Тестовая иерархия отображения
// Создаем экземпляр класса Sprite var theSprlte:Sprite = new SpriteC );
// Создаем экземпляр класса TextField
var theTextF1eld:TextF1eld = new TextFieldC );
theTextFI eld.text = "enter Input here";
theTextField.autoSize = TextFieldAutoSize.LEFT;•
theTextField.type = TextFieldType.INPUT;
// Добавляем объект TextField в объект Sprite theSprite.addChi1d(theTextFIeld);
// Добавляем объект Sprite в экземпляр класса Stage. Обратите внимание.
// что объект некийОтображаемыйОбъект должен находиться в списке
// отображения, чтобы иметь доступ к экземпляру класса Stage.’
некийОтображаемыйОбъект.stage.addChiId(theSprite);
Предположим, что мы хотим зарегистрировать функцию textlnputListener ( ) в объекте theSprite для событий TextEvent. TEXT_INPUT. Вот код функции textlnputListener ( ):
private function textlnputListener (e:TextEvent):void { traceCThe user entered some text"):
Мы хотим, чтобы функция textlnputListener ( ) вызывалась в фазе захвата (то есть до того, как объект TextField получит уведомление о возникновении события), поэтому для ее регистрации используем следующий код:
theSprite.addEventListener(TextEvent.TEXT_INPUT. textlnputListener. true)
Предыдущая строка кода заставляет функцию textlnputListener ( ) выполняться всякий раз, когда среда Flash осуществляет диспетчеризацию события TextEvent. TEXT_INPUT, получателем которого является объект theTextField, до того как объект theTextField получит уведомление о возникновении этого события.
Регистрация приемника предка для фазы всплытия
Напомним, что для регистрации приемника предка для уведомлений о возникновения события в фазе всплытия мы устанавливаем параметру useCapture метода addEventListener ( ) значение false, как показано в следующем коде:
предок.addEventListener(событие, приемник, false)
Продолжая работу с нашим объектом TextField из листинга 21.1, предположим, что мы хотим зарегистрировать функцию textlnputListener ( ) в объекте
theSprite для событий TextEvent. TEXT_INPUT. При этом мы хотим, чтобы функция textlnputListener ( ) вызывалась в фазе всплытия (то есть после получения уведомления о возникновении события объектом TextField). Мы используем следующий код:
theSprlte.addEventLIstener(TextEvent.TEXT_INPUT, textInputLIstener, false)
Можно сделать то же самое, полностью опустив значение параметра useCapture: theSprite.addEventLIstener(TextEvent.TEXT_INPUT, textlnputListener)
Эта строка кода заставляет функцию textlnputListener ( ) выполняться всегда, когда среда Flash осуществляет диспетчеризацию события TextEvent. TEXT_INPUT, получателем которого является объект theTextField, но после того, как объект theTextField получит уведомление о возникновении этого события.
Обратите внимание, что, если бы событие TextEvent. TEXT^INPUT было невсплывающим, функция textlnputListener ( ) никогда бы не была вызвана. Стоит еще раз повторить то, о чем мы узнали ранее: если приемник предка регистрируется для невсплывающего события либо с опущенным параметром useCapture, либо с параметром useCapture, которому установлено значение true, этот приемник никогда не будет вызван. Чтобы приемник предка вызывался при диспетчеризации невсплывающего события, он должен быть зарегистрирован для фазы захвата с параметром useCapture, которому установлено значение true.
Чтобы определить, каким является событие, можно воспользоваться любым из следующих способов.
□ Обратиться к описанию события в справочнике по языку ActionScript корпорации Adobe.
□ Обработать событие с помощью приемника события либо в фазе захвата, либо на фазе получения, и проверить значение переменной bubbles объекта Event, переданного в этот приемник. Если значение переменной bubbles равно true, событие является всплывающим; в противном случае — невсплывающим.
Следующий код демонстрирует последнюю методику:
// Регистрируем функцию cl 1ckL1stener( ) в экземпляре класса Stage
// для событий MouseEvent.CLICK. Обратите внимание, что объект
// некийОтображаемыйОбъект должен находиться в списке отображения,
// чтобы иметь доступ к экземпляру класса Stage.
некийОтображаемыйОбъект.stage.addEventLIstener(MouseEvent.CLICK, cl1ckL1stener);
// ...далее в коде определяем функцию cl 1ckL1stener( )
private function c!1ckL1stener (e:MouseEvent):void {
// Когда возникает событие, проверяем, является ли оно всплывающим if (е.bubbles) {
traceCThe MouseEvent.CLICK event 1s a bubbling event.");
} else {
traceC'The MouseEvent.CLICK event 1s a non-bubbling event.");
Для удобства поиска во всех разделах справочника по языку ActionScript корпорации Adobe, где описываются внутренние события, указано значение переменной экземпляра bubbles класса Event. Как правило, большинство внутренних событий, получателями которых являются отображаемые объекты, — всплывающие.
Регистрация приемника предка для фазы захвата и фазы всплытия
Чтобы указать, что приемник предка должен вызываться и в фазе захвата, и в фазе всплытия (то есть до и после того, как получатель будет уведомлен о возникновении события), мы должны зарегистрировать этот приемник дважды — один раз параметр useCapture должно быть установлено значение true, а другой раз — значение false. Например, возвращаясь к нашему сценарию с объектом TextField, предположим, что мы хотим зарегистрировать наш приемник textlnputListener ( ) в объекте theSprite для событий TextEvent. TEXT_INPUT и чтобы функция textlnputListener ( ) вызывалась и в фазе захвата, и в фазе всплытия. Мы используем следующий код:
theSprite.addEventLIstener(TextEvent.TEXT_INPUT, textlnputListener, true) theSprite.addEventL1stener(TextEvent.TEXT_INPUT. textlnputListener, false) ’
Если необходимо сделать так, чтобы приемник предка вызывался и в фазе захвата, и в фазе всплытия процесса диспетчеризации события, он должен быть зарегистрирован для этого события дважды.
Регистрация приемника в получателе события
Напомним, что для регистрации приемника получателя для фазы получения уведомления мы устанавливаем параметру useCapture метода addEventLIstener ( ) значение false, как показано в следующем коде:
получа тель События.addEventLIstener(событие, приемник, false)
Таким образом, возвращаясь к нашему текущему сценарию с объектом TextField, чтобы зарегистрировать функцию textlnputListener ( ) вобъекте theTextField для событий TextEvent. TEXT_INPUT, мы используем следующий код: theTextField.addEventLIstener(TextEvent.TEXT_INPUT, textlnputListener, false)
Или просто:
theTextField.addEventLIstener(TextEvent.TEXT_INPUT, textlnputListener)
Приведенная строка кода заставляет функцию textlnputListener ( ) выполняться всякий раз, когда среда Flash осуществляет диспетчеризацию события TextEvent. TEXT_INPUT, получателем которого является объект theTextField. Функция textlnputListener ( ) выполняется после того, как экземпляр класса Stage и объект theSprite получат уведомления о возникновении события в фазе захвата, но до того, как экземпляр класса Stage и объект theSprite получат уведомления в фазе всплытия.
Двойное назначение параметра useCapture
Как было показано в двух предыдущих разделах, параметру useCapture метода addEventListener ( ) устанавливается значение false в двух различных ситуациях:
когда регистрируемый приемник предка должен вызываться в фазе всплытия;
когда регистрируемый приемник получателя должен вызываться в фазе получения.
Следовательно, когда при регистрации приемника для события параметр useCapture установлено значение false, этот приемник будет вызываться в процессе диспетчеризации события, если справедливо любое из следующих условий:
получателем события является объект, в котором зарегистрирован приемник (в данном случае приемник вызывается в фазе получения);.
получателем события является потомок объекта, в котором зарегистрирован приемник (в данном случае приемник вызывается на фазе всплытия, после того как потомок обработает это событие).
Например, следующий код регистрирует функцию clickListener ( ) в экземпляре класса Stage для событий MouseEvent. CLICK:
некийОтображаемыйОбъект.stage.add Еvent L1stener(MouseEvent.CLICK,
clickListener. false);
Поскольку параметру useCapture установлено значение false, функция clickListener ( ) будет вызываться в следующих ситуациях:
когда пользователь щелкает кнопкой мыши в области отображения (в этом случае среда Flash выполняет диспетчеризацию события, получателем которого является экземпляр класса Stage);
когда пользователь щелкает кнопкой мыши на любом отображаемом объекте, видимом на экране (в этом случае среда Flash выполняет диспетчеризацию события для объекта-получателя, на котором щелкнули кнопкой мыши, — данный объект всегда является потомком экземпляра класса Stage).
Обратите внимание, что, хотя функция clickListener( ) зарегистрирована в одном объекте (в экземпляре класса Stage), на этапе выполнения она может вызываться в процессе диспетчеризации событий, получателями которых является как данный объект, так и потомки данного объекта! По этой причине в некоторых случаях функция приемника должна включать код, игнорирующий процессы диспетчеризации событий, которые ее не интересуют. Мы рассмотрим код, необходимый для игнорирования процессов диспетчеризации событий, далее, в разд. «Отличие событий, получателем которых является некий объект, от событий, получателями которых являются его потомки».
Удаление приемников событий
При отмене регистрации приемника события в объекте, находящемся в иерархии отображения, мы должны указать, для получения уведомлений в какой фазе был
зарегистрирован этот приемник изначально — в фазе захвата или в фазах получения или всплытия. Для этого мы используем третий параметр useCapture метода removeEventListener ( ), который полностью аналогичен параметру useCapture метода addEventListener ( ).
Если приемник, для которого отменяется регистрация, изначально был зарегистрирован для фазы захвата (то есть параметру useCapture метода addEventListener ( ) было установлено значение true), мы должны отменить его регистрацию, присвоив параметру useCapture метода removeEventListener ( ) значение true. Если приемник был изначально зарегистрирован для уведомлений на фазах получения или всплытия (то есть параметру useCapture метода addEventListener ( ) было установлено значение false), мы должны отменить его регистрацию, присвоив параметру useCapture метода removeEventListener ( ) значение false.
В случае отмены регистрации приемника значение параметра useCapture метода removeEventListener() должно всегда соответствовать значению, установленному для параметра useCapture при исходном вызове метода addEventListener().
Например, в следующем коде мы регистрируем функцию clickListener( ) в объекте некийОтображаемыйОбъект для фазы захвата, указывая в качестве параметра useCapture метода addEventListener ( ) значение true:
некийОтображаемыйОбъект.addEventListener(MouseEvent.CLICK,
cHckListener, true):
Соответственно при отмене регистрации функции clickLis tener ( ) в объекте некийОтображаемыйОбъект мы должны указать значение true в качестве параметра useCapture метода removeEventListener ( ):
некийОтображаемыйОбъект Temo\/eE\/entL\stener(V\ou^^ .CLICK,
cHckListener, true):
При отмене регистрации приемника события, который был дважды зарегистрирован в одном и том же объекте (для получения уведомлений как в фазе захвата, так и в фазах получения или всплытия), мы должны подобным образом дважды вызвать метод removeEventListener ( ). Например, следующий код дважды регистрирует приемник события MouseEvent. CLICK в экземпляре класса Stage, чтобы этот приемник вызывался и в фазе захвата, и в фазах получения или всплытия:
некийОтображаемыйОбъект.stage.addEventLi stener(MouseEvent.CLICK, cHckListener, true):
некийОтображаемыйОбъект.stage.addEventListener(MouseEvent.CLICK, cHckListener, false):
Следующий код удаляет два предыдущих приемника события MouseEvent. CLICK. Поскольку метод cHckListener ( ) был зарегистрирован отдельно для фазы захвата и отдельно для фазы получения или всплытия, его регистрация должна также отменяться отдельно для каждой из этих фаз.
некийОтображаемыйОбъект.stage.removeEventListener(MouseEvent.CLICK, clickListener, true):
некийОтображаемыйОбъект.stage.removeEventListener(MouseEvent.CLICK, -clickListener,
false);
Поскольку каждая регистрация приемника с помощью метода addEventListener() считается отдельной операцией, отмена каждой регистрации должна осуществляться соответствующим вызовом метода removeEventListener().
Теперь, когда мы получили общее представление о цепочке диспетчеризации события, рассмотрим пример, который демонстрирует, как цепочка диспетчеризации события может помочь централизовать код в реальном приложении.
Использование цепочки диспетчеризации событий для централизации кода
Ожидая появления свободной комнаты в полностью забронированном отеле, проще попросить управляющего гостиницей сообщить вам, когда освободится комната, чем спрашивать каждого постояльца о том, когда он планирует уезжать. Подобным образом при обработке диспетчеризаций событий зачастую бывает гораздо эффективнее зарегистрировать приемники событий в контейнере отображаемых объектов, чем регистрировать приемники в каждом из потомков этого контейнера.
Предположим, что мы создаем простой элемент управления «флажок», состоящий из двух следующих классов:
CheckBox — подкласс класса Sprite, который выступает в роли контейнера для всего элемента управления;
CheckBoxI con — подкласс класса Sprite, который представляет графический значок флажка.
container(экземпляркласса CheckBox)container(экземпляркласса CheckBox)Щелкните здесьЩелкните здесьНа этапе выполнения каждый экземпляр класса CheckBox создает два дочерних объекта: экземпляр класса CheckBoxIcon для значка флажка и экземпляр класса TextField для текстовой надписи флажка. Для справочных целей назовем экземпляр основного класса CheckBox именем container, а два его дочерних объекта — icon и label. На рис. 21.3 представлена схема нашего элемента управления «флажок».
container(экземпляркласса CheckBox)
container(экземпляркласса CheckBox)
Щелкните здесь
Щелкните здесь
. lconlabel
(экземпляр(экземпляр
класса CheckBoxIcon) ^^ TextFie,d)
Рис. 21.3. Объекты элемента управления «флажок»
Мы хотим максимально упростить использование нашего флажка, поэтому проектируем его таким образом, чтобы состояние флажка — установлен или снят — изменялось в тот момент, когда пользователь щелкает кнопкой мыши на значке флажка или на его надписи. Соответственно, в нашей реализации мы должны отслеживать события щелчка кнопкой мыши, получателями которых являются объекты icon и label.
Мы могли бы зарегистрировать отдельные приемники для события щелчка кнопкой мыши в каждом из указанных объектов. Однако регистрация двух приемников событий приведет к увеличению длительности разработки и из-за повторения практически идентичного кода для регистрации приемников увеличит вероятность появления ошибок в нашем флажке. Вместо этого, чтобы избежать появления повторяющегося кода, мы можем обрабатывать все события щелчка кнопкой мыши в одном приемнике, зарегистрированном в объекте container. Поскольку объект container является отображаемым предком и для объекта icon, и для объекта label, он получает уведомления всякий раз, когда среда Flash выполняет диспетчеризацию события щелчка кнопкой мыши, получателем которого является любой из этих объектов. Когда выполняется код приемника объекта container, обрабатывающий события щелчка кнопкой мыши, мы знаем, что пользователь щелкнул либо на значке, либо на надписи, и в ответ на это действие мы можем изменить состояние флажка — установить или снять.
В листинге 21.2 представлен код для нашего примера с флажком. Части кода, связанные с обработкой событий, выделены полужирным шрифтом.
Листинг 21.2. Иерархическая обработка событий класса CheckBox
// Файл CheckBox.as package {
import flash.display
Import fl ash.events.*;
Import fl ash.text.*;
// Очень простой элемент управления «флажок»
public class CheckBox extends Sprite {
private var label;TextF1eld; // Текстовая надпись флажка
private var 1con:CheckBoxIcon; // Графический значок флажка
private var checked;Boolean; // Флаг, который указывает, установлен
// ли флажок в настоящий момент
// Конструктор
public function CheckBox (msg;Str1ng) {
// При создании объекта флажок не установлен checked = false;
// Создаем графический значок Icon = new CheckBoxIcon( );
// Создаем текстовую надпись
label = new TextF1eld( );
label.text = msg;
label.autoSize = TextFIeldAutoSIze.LEFT;.
label.selectable = false;
// Размещаем текстовую надпись рядом с графическим значком label.х = icon.x + Icon.width + 5;
// Добавляем объекты label и icon к данному объекту в качестве
// его отображаемых детей
addChild(icon);
addChiIdClabel);
// Регистрируем приемник для получения событий щелчка кнопкой мыши, // получателем которых является данный объект или любой
// из его дочерних объектов (то есть label или icon) addEventListener(MouseEvent.CLICK, clickListener);
// Обрабатывает события щелчка кнопкой мыши. Этот метод выполняется // всякий раз, когда пользователь щелкает на объекте label или icon, private function clickListener (e:MouseEvent):void {
if (checked) {
icon.uncheck( );
checked = false;
} else {
icon.check( );
checked = true;
}
// Файл CheckBoxIcon.as
package {
import flash.display.*;
// Графический значок для элемента управления «флажок» public class CheckBoxIcon extends Sprite {
// Конструктор
public function CheckBoxIcon ( ) {
uncheck( );
// Рисует значок флажка в состоянии «установлен» public function check ( ):void {
graphics.clear( );
graphics.lineStyle(l);
graphics.beginFill(OxFFFFFF);
graphics.drawRect(O, 0. 15, 15);
graphics.endFill( );
graphics.lineTo(15, 15);
graphics.moveTo(0, 15);
graphics.11пеТо(15, 0);
}
// Рисует значок флажка в состоянии «снят»
public function uncheck ( ):void {
graphics.clear( ):
graphics.lineStyle(l);
graphics.beginFill(OxFFFFFF);
graphics.drawRectCO, 0. 15. 15):
}
// Файл CheckBoxDemo.as (основной класс, который использует класс CheckBox) package {
Import flash.display.Sprite;
// Демонстрирует использование класса CheckBox
public class CheckboxDemo extends Sprite {
public function CheckboxDemo( ) {
var c;CheckBox = new CheckBox("Click here");
addChlld(c);
}
Мы познакомились с основами системы иерархической диспетчеризации событий языка ActionScript, но нам осталось рассмотреть еще несколько тем. Не будем сдаваться.
Определение текущей фазы события
Как уже известно из подразд. «Регистрация приемника предка для фазы захвата и фазы всплытия» разд. «Приемники событий и цепочка диспетчеризации событий», дважды вызвав метод addEventListener ( ), можно зарегистрировать одну и ту же функцию-приемник события как для фазы захвата, так и для фазы всплытия процесса диспетчеризации события. В подразд. «Двойное назначение параметра useCapture» разд. «Приемники событий и цепочка диспетчеризации событий» мы также узнали, что приемник события, при регистрации которого параметру useCapture было установлено значение false, может вызываться как в фазе получения, так и в фазе всплытия диспетчеризации события. Следовательно, когда в ответ на возникшее событие выполняется функция-приемник события, текущая фаза события будет известна не всегда. В соответствии с этим язык ActionScript предоставляет переменную экземпляра event Phase класса Event, которая может быть использована внутри функции-приемника события для определения текущей фазы события.
Переменная eventphase содержит информацию о том, в какой фазе находится текущий процесс диспетчеризации события — захвата, получения или всплытия.
Когда процесс диспетчеризации события находится в фазе захвата, переменной eventPhase присваивается значение Event Phase . CAPTURING_PHASE, которое означает, что объект-получатель еще не получил уведомление о возникновении события.
Когда процесс диспетчеризации события находится в фазе получения, переменной event Phase присваивается значение EventPhase. AT_TARGET, которое означает, что в настоящий момент объект-получатель обрабатывает событие.
Когда процесс диспетчеризации события находится в фазе всплытия, переменной eventPhase присваивается значение EventPhase . BUBBLING_PHASE, которое означает, что объект-получатель завершил обработку события.
Обычно константам EventPhase . CAPTURING_PHASE, EventPhase . AT_TARGET и EventPhase.BUBBLING_PHASE присваиваются значения 1, 2 и 3 соответственно, но эти значения со временем могут измениться, поэтому использовать их непосредственно в коде не следует. Вместо этого, чтобы определить текущую фазу события внутри функции-приемника события, всегда сравнивайте значение переменной eventPhase с константами класса EventPhase. Например, всегда используйте код наподобие следующего:
private function someLlstener (e:Event):vo1d {
1f (e.eventPhase = EventPhase.AT TARGET) {
// Этот приемник был вызван в фазе получения...
}
}
И никогда не используйте код наподобие следующего:
private function someLlstener (e:Event):void {
// Плохой код! Никогда не используйте в коде
// непосредственные значения
// констант класса EventPhase!
if (е.eventPhase == 2) {
// Этот приемник был вызван в фазе получения...
}
}
Следующий код демонстрирует общий подход к использованию переменной event Phase. Сначала в экземпляр класса Stage добавляется объект TextField. Затем в экземпляре класса Stage регистрируется приемник clickListener ( ) для получения уведомлений о возникновении события MouseEvent. CLICK в фазе захвата.
Наконец, в экземпляре класса Stage регистрируется приемник clickListener ( ) для получения уведомлений о возникновении события MouseEvent. CLICK в фазе получения и в фазе всплытия.
При выполнении приемника clickListener ( ) на консоль выводится текущая фаза. Обратите внимание, что она определяется путем сравнения значения переменной event Phase с тремя константами класса EventPhase.
var t:TextF1eld = new TextF1eld( ); t.text = "click here":
t. autoSize = TextF 1 el dAutoSi" ze. LEFT:
stage.addChild(t):
// Регистрируем приемник для фазы захвата
stage.addEventListener(MouseEvent.CLICK. clickListener. true):
// Регистрируем приемник для фазы получения или всплытия
stage.addEventListenerCMouseEvent.CLICK. clickListener, false);
II ... где-то в классе
private function clickListener (e.-MouseEvent) ;void {
var phase:String;
switch (e.eventPhase) {
case EventPhase.CAPTURING_PHASE:
phase = "Capture";
break:
case EventPhase.AT_TARGET:
phase = "Target";
break;'
case EventPhase.BUBBLING_PHASE:
phase = "Bubbling":
break:
trace!"Current event phase: " + phase): }
Если при выполнении предыдущего кода пользователь щелкнет кнопкой мыши на объекте TextField, то среда Flash осуществит диспетчеризацию события MouseEvent. CLICK, получателем которого является объект TextField, и в результате будет выведена следующая информация:
Current event phase: Capture
Current event phase: Bubbling
He забывайте, что приемник clickListener( ) был зарегистрирован в экземпляре класса Stage и для фазы захвата, и для фазы всплытия, поэтому в процессе диспетчеризации событий, получателями которых являются потомки экземпляра класса Stage, он вызывается дважды.
С другой стороны, если пользователь щелкнет кнопкой мыши в области отображения, среда Flash выполнит диспетчеризацию события MouseEvent. CLICK, получателем которого является объект Stage, и в результате будет выведена следующая информация:
Current event phase: Target
Как будет рассмотрено в следующем разделе, переменная eventPhase обычно используется для отличия событий, получателем которых является некий объект, от событий, получателями которых являются потомки этого объекта. Реже переменная event Phase применяется для отличия фазы захвата от фазы всплытия внутри приемников предка, зарегистрированных для обеих фаз.
Отличие событий, получателем которых является некий объект, от событий, получателями которых являются его потомки
Когда переменной eventPhase объекта Event, передаваемого в функцию- приемник, присвоено значение EventPhase. AT_TARGET, мы знаем, что получателем события является объект, в котором зарегистрирован данный приемник. С другой стороны, когда переменной eventPhase присвоено значение EventPhase.CAPTURING_PHASE или EventPhase.BUBBLING_PHASE, мы знаем, что получателем события является потомок объекта, в котором зарегистрирован данный приемник.
Таким образом, приемник может использовать следующий код, чтобы игнорировать события, получателями которых являются потомки объекта, зарегистрировавшего этот приемник:
private function некийПриемник (е:НекоеСобытие):void {
if (е.eventPhase == EventPhase.AT_TARGET) {
// Этот код выполняется только в том случае, если получателем события // является объект, зарегистрировавший данный приемник.
}
Мы можем использовать предыдущую методику, чтобы написать код, который реагирует на события ввода, получаемые неким конкретным объектом, но не его потомками. Например, представьте приложение, в котором экземпляр класса Stage содержит множество кнопок, текстовых полей и других объектов для ввода данных. Чтобы реагировать только на щелчки кнопкой мыши, которые происходят над незаполненными областями экземпляра класса Stage, мы используем следующий код:
// Регистрируем приемник в экземпляре класса Stage для событий
// MouseEvent.CLICK. В результате метод clickListener( ) будет вызываться
// всегда, когда щелкают на *любом* объекте в списке отображения, stage.addEventListener(MouseEvent.CLICK, clickListener);
// ...где-то в классе определяем приемник события MouseEvent.CLICK private function clickListener (e:MouseEvent):void {
// Если этот приемник был вызван в фазе получения...
if (е.eventPhase == EventPhase.AT_TARGET) {
// ...значит щелкнули на экземпляре класса Stage. Продолжаем выполнение
// кода для ситуации «Щелкнули на экземпляре класса Stage».
}
}
Чтобы создать приемник, игнорирующий события, получателем которых является зарегистрировавший его объект, мы используем следующий код:
private function некийПриемник {е'.некоеСобытиеУ.^о^ {
1f (е.eventPhase != EventPhase.AT_TARGET) {
// Этот код выполняется только в том случае, если получателем события
// является потомок объекта, в котором был зарегистрирован данный
// приемник.
}
}
Например, следующий приемник реагирует на щелчки кнопкой мыши, которые происходят над любым объектом в списке отображения, но не над пустой областью экземпляра класса Stage:
// Регистрируем приемник в экземпляре класса Stage для событий
// MouseEvent.CLICK.
stage.addEventLIstener(MouseEvent.CLICK, cl 1ckL1stener);
// ...где-то в классе определяем приемник события MouseEvent.CLICK private function cHckLIstener (e:SomeInputEvent):void {
// Если этот приемник не был вызван на фазе получения...
1f (е.eventPhase != EventPhase.AT_TARGET) {
// ...получателем события является потомок экземпляра класса Stage.
// Следовательно, в момент щелчка указатель мыши находился над одним
// из объектов в списке отображения, но не над пустой областью
// экземпляра класса Stage.
}
}
Перейдем к следующей теме, относящейся к процессу иерархической диспетчеризации событий, — рассмотрим остановку процесса диспетчеризации события.
Остановка процесса диспетчеризации события
В любой точке цепочки диспетчеризации события каждый приемник события — включая приемники, зарегистрированные в объекте-получателе, и приемники, зарегистрированные в предках объекта-получателя, — может остановить весь процесс диспетчеризации. Остановка процесса диспетчеризации события называется поглощением события.
Чтобы остановить процесс диспетчеризации события, мы вызываем метод экземпляра stopImmediatePropagation ( ) или stoppropagation ( ) класса Event над объектом Event, передаваемым в функцию-приемник. Метод stoplmmediat ePropagation ( ) останавливает процесс диспетчеризации события немедленно, не позволяя вызвать оставшиеся приемники; метод stoppropagation ( ) останавливает процесс диспетчеризации события после того, как среда Flash вызовет оставшиеся приемники, зарегистрированные в объекте, который на настоящий момент получил уведомление о возникновении события.
Предположим, что у нас есть экземпляр класса Sprite — container, который содержит объект TextField — child:
var contalпег:Spr1te = new Spr1te( ):
var ch1ld:TextF1eld = new TextF1eld( ):
child.text = "click here":
child.autoSize = TextF1eldAutoS1ze.LEFT:’
container.addChl1d(ch11d):
Предположим также, что у нас есть три функции-приемника: containerClickLis tenerOne ( ), containerClickListenerTwo ( ) и childClickListener ( ). Регистрируем функции containerClickListenerOne ( ) и containerClic kListenerTwo ( ) в объекте container для получения уведомлений о возникновении события MouseEvent. CLICK в фазе захвата:
container.addEventLIstener(MouseEvent.CLICK,
contalnerCl1ckL1stenerOne,
true);
contalner.addEventLIstener(MouseEvent.CLICK,
contalnerCl1ckL1stenerTwo, true):
После этого регистрируем функцию childClickListener ( ) в объекте chi Id для уведомлений о возникновении события MouseEvent. CLICK в фазе получения:
child.addEventLIstener(MouseEvent.CLICK, ch11dCl1ckL1stener, false);
В обычной ситуации, когда пользователь щелкает кнопкой мыши на объекте child, вызываются все три приемника события: два в фазе захвата и один в фазе получения. Если тем не менее функция containerClickListenerOne ( ) поглотит событие путем вызова метода stopImmediatePropagation ( ), ни containerClickLi stenerTwo ( ), ни childClickListener ( ) вызваны не будут.
public function containerClickListenerOne (e:MouseEvent):void {
// Исключаем получение события функциями contalnerCl1ckL1stenerTwo( )
// и ch11dCl1ckL1stener( )
e.stopImmed1atePropagat1on( );
}
С другой стороны, если функция containerClickListenerOne ( ) поглотит событие путем вызова метода stoppropagation ( ) вместо метода stoplmme diatePropagation ( ), то перед остановкой процесса диспетчеризации события будут вызваны оставшиеся приемники события MouseEvent .CLICK объекта container. Следовательно, функция containerClickListenerTwo ( ) получит событие, а функция childClickListener ( ) — нет.
public function containerClickListenerOne (e:MouseEvent):void {
// Исключаем получение события только функцией ch1ldCHckL1stener( ) е.stopPropagatlon( );
Обратите внимание, что предыдущий пример основывается на условии, что функция containerClickListenerOne ( ) была зарегистрирована перед функцией containerClickListenerTwo ( ). Дополнительную информацию о порядке, в котором вызываются приемники событий, можно найти в гл. 12.
Поглощение событий обычно происходит для того, чтобы остановить или переопределить стандартную реакцию программы на событие. Предположим, что подкласс
ToolPanel класса Sprite содержит группу элементов управления интерфейса, каждый из которых позволяет вводить данные. Класс ToolPanel имеет два рабочих состояния: активен и неактивен. Когда объект ToolPanel неактивен, пользователь не должен иметь возможность взаимодействовать с любым из его вложенных элементов управления интерфейса.
Для реализации состояния «неактивен» в каждом объекте ToolPanel регистрируется метод clickListener ( ) для уведомления о возникновении события MouseEvent .CLICK в фазе захвата. Когда объект ToolPanel неактивен, метод clickListener ( ) останавливает все события щелчка кнопкой мыши до того, как они достигнут дочерних объектов Tool. В листинге 21.3 представлен класс ToolPanel, который был сильно упрощен, чтобы акцентировать внимание на коде, поглощающем событие (выделен полужирным шрифтом). В этом листинге дочерние элементы управления интерфейса класса ToolPanel являются экземплярами базового класса Tool, который отсутствует в листинге. Однако в реальном приложении эти элементы управления могут быть кнопками, меню или любыми другими видами интерактивных инструментов.
Листинг 21.3. Поглощение события
package {
import fl ash.display.Sprite;
import fl ash.events.*;
public class ToolPanel extends Sprite {
private var enabled:Boolean;
public function ToolPanel ( ) { enabled = false;
var tool 1 Kool = new TooK );
var too!2;Tool = new TooK );
var tool3;Tool = new TooK );
tool 2.x = tool 1.width + 10;
tool3.x = too!2.x + too!2.width + 10;
addChiId(tooll);
addChi1d(tool 2);
addChi1d(tool3);
// Регистрируем приемник в этом объекте для уведомлений
// о возникновении события MouseEvent.CLICK в фазе захвата addEventListener(MouseEvent.CLICK, clickListener, true):
private function clickListener (e:MouseEvent):void {
// Если данный объект ToolPanel неактивен...
if (!enabled) {
// ...останавливаем процесс диспетчеризации данного события -
// щелчка кнопкой мыши, чтобы оно не достигло потомков данного
// объекта ToolPanel
e.stopPropagation( );
traceC'Panel disabled. Click event dispatch halted."):
В повседневной разработке приложений метод stoppropagation ( ) используется гораздо более часто, чем stopImmediatePropagation ( ). Тем не менее второй метод применяется в следующих ситуациях:
когда объект-получатель желает, чтобы его собственные приемники не вызывались в результате возникновения события;
когда программа не желает, чтобы приемники реагировали на данное событие. Рассмотрим пример каждой из описанных ситуаций, начав с объекта-получателя, который желает, чтобы его собственные приемники реагировали на событие. Представьте игру «космический шутер», которая включает следующие классы:
GameManager — класс, управляющий процессом игры;
□ PlayerShip — класс, который представляет космический корабль игрока.
Класс GameManager определяет собственное событие GameManager. SHIP HIT, диспетчеризация которого осуществляется всякий раз, когда вражеская ракета попадает в корабль игрока. Получателем каждого события GameManager. SHI PH IT является объект PlayerShip. Этот объект регистрирует два приемника, которые реагируют на события GameManager. SHIP_HIT. Один приемник проигрывает анимацию, имитирующую взрыв, а другой приемник воспроизводит звук взрыва. Когда корабль игрока погибает, создается новый корабль, и на протяжении пяти секунд он остается неуязвимым. До тех пор пока корабль остается неуязвимым, приемники события GameManager. SHIP_HIT объекта PlayerShip не должны воспроизводить анимацию или звук «повреждения корабля».
Чтобы исключить выполнение приемников события GameManager. SHIP_HIT до тех пор, пока корабль остается неуязвимым, класс PlayerShip регистрирует третий приемник hit Listener ( ), предназначенный для поглощения событий GameManager. SHI PH IT на основании текущего статуса корабля (неуязвим или уязвим). Регистрация метода hitListener ( ) с приоритетом int,MAX_VALUE происходит в конструкторе класса PlayerShip, как показано в следующем коде: public class PlayerShip {
public function PlayerShip ( ) {
addEventLIstener(GameManager.HIT, hitListener. false. 1 nt.MAX_VALUE);
В гл. 12 рассказывалось, что по умолчанию приемники событий объекта вызываются в том порядке, в котором они были зарегистрированы. Мы также знаем, что этот используемый по умолчанию «порядок вызова» может быть перекрыт с помощью параметра priority метода addEventLIstener ( ).
Поскольку при регистрации метода hitListener ( ) в конструкторе класса PlayerShip используется максимально возможный приоритет, из всех прием-
ников события GameManager.SHIP_HIT класса PlayerShip этот приемник всегда будет вызываться первым. Если объект PlayerShip является уязвимым и возникает событие GameManager. SHIP_HIT, метод hitListener ( ) не выполняет никаких действий. Но если объект PlayerShip не является уязвимым и возникает событие GameManager. SHIP_HIT, метод hitListener ( ) сначала поглощает это событие, а затем выполняет диспетчеризацию нового события PlayerShip. HIT_DEFLECTED. После этого приемники, зарегистрированные для события PlayerShip. HIT_DEFLECTED, воспроизводят специальную анимацию и звук, которые сообщают о том, что корабль не был поврежден.
Далее представлен код метода hitListener ( ); обратите внимание на использование метода stopImmediatePropagation ( ):
private function hitListener (e:Event):void {
1f (Invincible) {
// Исключаем получение другими приемниками объекта PlayerShip
// уведомления о возникновении события
e.stopImmediatePropagation( );
// Рассылаем новое событие
d1spatchEvent(new Event(PlayerShlр.HIT_DEFLECTED, true));
}-
}
В предыдущем сценарии с классом PlayerShip стоит отметить, что, хотя объект PlayerShip может предотвратить вызов своих собственных приемников события GameManager. SHI Р_Н1Т, он не может предотвратить вызов приемников события GameManager. SHIP HIT, зарегистрированных в его отображаемых предках. В частности, любые приемники, зарегистрированные для фазы захвата в отображаемых предках объекта PlayerShip, будут всегда получать уведомление о возникновении события GameManager .SHIP_HIT, даже если объект PlayerShip поглотит это событие. Однако после того, как объект PlayerShip поглотит событие GameManager. SHIP_HIT, его предки не получат уведомление в фазе всплытия.
Теперь перейдем ко второму сценарию с использованием метода stopImmediatePropagation ( ), в котором программа желает, чтобы никакие приемники не отвечали на данное событие. Предположим, мы создаем набор компонент пользовательского интерфейса, которые автоматически переходят в неактивное состояние, когда среда выполнения теряет фокус операционной системы, и возвращаются в активное состояние, когда среда получает фокус операционной системы. Чтобы определить момент получения или потери фокуса операционной системы, наши компоненты регистрируют приемники для внутренних событий Event. ACTIVATE и Event. DEACTIVATE (дополнительные сведения об этих событиях можно найти в гл. 22).
Предположим, мы разрабатываем тестовое приложение для выполнения нагрузочных испытаний наших компонентов. Наше приложение программным путем вызывает интерактивное поведение компонентов. В тесте мы должны гарантировать, что внутреннее событие Event. DEACTIVATE не переводит наши тестируемые компоненты в неактивное состояние. В противном случае наше тестовое приложение не сможет работать с ними программным путем. Таким образом, в конструкторе основного класса нашего текстового приложения мы регистрируем приемник для события Event. DEACTIVATE в экземпляре класса Stage. Этот приемник использует
метод stop Immediate Propagation ( ) для поглощения всех внутренних событий Event. DEACTIVATE, как показано в следующем коде:
private function deactivateListener (е: Event):void { e.stopImmediatePropagationt );
}
Поскольку разрабатываемое нами тестовое приложение поглощает все события Event. DEACTIVATE, компоненты никогда не получат уведомления о возникновении события Event. DEACTIVATE и, следовательно, никогда не перейдут в неактивное состояние в ответ на потерю фокуса средой Flash. В процессе тестирования оператор тестового приложения сможет в любой момент устанавливать или убирать фокус со среды выполнения, не оказывая никакого влияния на способность тестового приложения управлять компонентами программным путем.
Приоритет и цепочка диспетчеризации событий
Когда приемник события регистрируется в объекте, находящемся в иерархии отображения, параметр priority влияет на порядок вызова только тех приемников, которые зарегистрированы в этом объекте. Параметр priority не изменяет и не может изменить порядок, в котором происходит уведомление объектов в цепочке диспетчеризации событий.
Не существует способа сделать так, чтобы приемник одного объекта в цепочке диспетчеризации события вызывался до или после приемника другого объекта в той же цепочке.
Например, представьте объект Sprite, содержащий объект TextField. Объект Sprite регистрирует приемник spriteClickListener( ) для события MouseEvent. CLICK — параметру useCapture установлено значение false, а параметру priority присвоено значение 2:
o^b^rSprite.addEventListener(MouseEvent.CLICK, spriteClickListener, false, 2)
Точно так же объект TextField регистрирует приемник textClickListener ( ) для события MouseEvent. CLICK — значение параметра useCapture установлено в false, а параметру priority присвоено значение 1:
o6beKrlextF7e/d.addEventListener(MouseEvent.CLICK, textClickListener, false, 1)
Когда пользователь щелкает кнопкой мыши на объекте TextField, среда Flash выполняет диспетчеризацию события MouseEvent. CLICK, получателем которого является объект TextField. В результате метод textClickListener ( ) вызывается в фазе получения перед методом spriteClickListener ( ), который вызывается в фазе всплытия. Два приемника события вызываются в порядке, устанавливаемом цепочкой диспетчеризации события, даже несмотря на то, что метод spriteClickListener ( ) был зарегистрирован с более высоким приоритетом, чем textClickListener ( ).
Дополнительную информацию о приоритетах событий можно найти в гл. 12.
Изменение иерархии отображения и цепочка диспетчеризации событий
Непосредственно перед тем, как приступить к диспетчеризации заданного события, среда выполнения Flash заранее определяет для него всю цепочку диспетчеризации, учитывая текущее состояние иерархии отображения его получателя. Другими словами, список объектов, которые будут уведомлены о возникновении события, и порядок уведомления этих объектов определяются заранее — до того как начнется процесс диспетчеризации события. После начала процесса диспетчеризации уведомление объектов о возникновении события осуществляется в соответствии с этим предопределенным порядком, даже если в процессе диспетчеризации структура иерархии отображения объекта-получателя будет изменена приемниками событий.
Предположим, у нас есть экземпляр класса TextField, содержащийся в экземпляре класса Sprite, который, в свою очередь, содержится в экземпляре класса Stage. Пусть также мы регистрируем приемник stageClickListener ( ) вэкземпляре класса Stage для уведомления о возникновении события MouseEvent. CLICK в фазе захвата, как показано в следующем коде:
stage.addEventL1stener(MouseEvent.CLICK, stagedickL1stener. true);
Наконец, предположим, что зарегистрированная функция stageClickListener ( ) содержит код, который удаляет объект TextField из его родительского объекта Sprite, как показано в следующем коде:
private function stageClickListener (e:MouseEvent):void {
// Если щелкнули кнопкой мыши на объекте TextField...
1f (е.target == textFleld) {
// ...то удаляем его
removeCh1ld(textF1eld); textFleld = null;
Когда пользователь щелкает кнопкой мыши в текстовом поле, среда Flash выполняет диспетчеризацию событияMouseEvent. CLICK, получателем которого является объект TextField. Перед началом процесса диспетчеризации среда выполнения заранее определяет всю цепочку диспетчеризации события, как показано ниже:
ФАЗА ЗАХВАТА:
Объект Stage
Объект Sprite
ФАЗА ПОЛУЧЕНИЯ:
(3) Объект TextField
ФАЗА ВСПЛЫТИЯ:
Объект Sprite
Объект Stage
Когда начинается процесс диспетчеризации, среда Flash сначала уведомляет о возникновении события объект Stage (1). В результате этого уведомления вызывается приемник stageClickListener ( ) объекта Stage, который удаляет объект TextField из списка отображения. Далее, несмотря на то, что объект Sprite больше не является потомком объекта TextField, среда выполнения уведомляет о возникновении события объект Sprite (2). Затем, несмотря на то
что объекта Text Field больше нет в списке отображения, среда выполнения уведомляет о возникновении события объект TextField (3). Наконец, в фазе всплытия среда Flash снова уведомляет о возникновении события объекты Sprite (4) и Stage (5). Даже несмотря на то, что иерархия отображения получателя события была изменена в процессе диспетчеризации, событие все равно проходит по всей предопределенной цепочке диспетчеризации события.
Как только для данного события будет установлена цепочка диспетчеризации, она останется неизменной до окончания этого процесса диспетчеризации.
В листинге 21.4 представлен код для приведенного сценария в контексте тестового класса D i s арр е а г i ngT е х t F i е 1 d. В этом листинге экземпляр пользовательского класса DisappearingTextField (подкласс класса Sprite) играет роль объекта Sprite из описанного сценария.
Листинг 21.4. Неизменяемая цепочка диспетчеризации события
package {
Import flash.display.*;
Import flash.events.*;
Import flash.text.*;
public class DisappearingTextField extends Sprite {
private var textField.-TextField;.
public function DisappearingTextField ( ) {
// Создаем объект TextField
textField = new TextField( );
textField.text = "Click here";
textField.autoSize = TextFieldAutoSize.LEFT;
// Добавляем объект TextField в объект DisappearingTextField addChi1d(textField);
// Регистрируем приемник в экземпляре класса Stage для событий
// MouseEvent.CLICK
stage.addEventListener(MouseEvent.CLICK, staged ickListener. true);
// Чтобы доказать, что объект TextField получает уведомление
// о возникновении события MouseEvent.CLICK даже после того, как он
// будет удален из данного экземпляра класса DisappearingTextField,
// регистрируем приемник в объекте TextField для событий
// MouseEvent.CLICK'
textField.addEventListener(MouseEvent.CLICK, textFieldClickListener);
// Эта функция выполняется, когда пользователь щелкает кнопкой мыши
// на любом объекте в списке отображения
private function staged 1ckL1stener (e:MouseEvent):void {
// Если щелкнули кнопкой мыши на объекте TextField...
if (е.target == textField) {
// ...то удаляем его
removeChl1d(textFIeld);
textField = null:
}
}
// Эта функция выполняется, когда пользователь щелкает кнопкой мыши
// на объекте TextField
private function textFieldClicktistener (e:MouseEvent):void {
// На данный момент метод stageClickListenert )
// уже удалил объект TextField,
// однако приемник все равно вызывается.
trace("textFieldClickL1stener triggered");
Изменение списка приемников события. Как мы уже знаем, когда возникает некоторое событие, среда выполнения уведомляет надлежащие объекты в соответствии с предопределенным порядком, устанавливаемым цепочкой диспетчеризации события. В свою очередь, когда каждый объект получает уведомление о возникновении события, вызываются приемники события этого объекта. Список конкретных приемников, вызываемых при возникновении данного события, определяется непосредственно перед началом процесса уведомления этого объекта. Как только начнется процесс уведомления, изменить этот список приемников будет невозможно.
Например, рассмотрим процесс диспетчеризации события MouseEvent. CLICK, получателем которого является объект Sprite, содержащийся в экземпляре класса Stage. Цепочка диспетчеризации события включает в себя три уведомления о возникновении события, как показано ниже:
ФАЗА ЗАХВАТА: (1) Объект Stage уведомлен
ФАЗА ПОЛУЧЕНИЯ: (2) Объект Sprite уведомлен
ФАЗА ВСПЛЫТИЯ: (3) Объект Stage уведомлен
Предположим, что на этапе первого уведомления (1) код в приемнике объекта Stage регистрирует новый приемник для события MouseEvent. CLICK в объекте Sprite. Поскольку событие еще не было передано в объект Sprite, новый приемник будет вызван на этапе второго уведомления (2).
Теперь предположим, что на этапе первого уведомления (1) код в приемнике объекта Stage регистрирует новый приемник для события MouseEvent .CLICK в экземпляре класса Stage, который будет вызываться в фазе всплытия. Поскольку этап первого уведомления (1) уже начался, список приемников экземпляра класса Stage уже заморожен, поэтому новый приемник не будет вызван на этапе первого уведомления (1). Тем не менее новый приемник появится в цепочке диспетчеризации события и будет вызван на этапе третьего уведомления (3).
Наконец, предположим, что на этапе второго уведомления (2) код в приемнике объекта Sprite отменяет регистрацию существующего приемника для события MouseEvent. CLICK в объекте Sprite. Поскольку этап второго уведомле-
ния (2) уже начался, его список приемников был заморожен, поэтому удаленный приемник будет все равно вызван на этапе второго уведомления. Конечно, когда возникнет другое событие MouseEvent. CLICK, удаленный приемник не будет вызываться.
"1 В любой момент процесса диспетчеризации данного события список вызываемых при- Jемников на текущем этапе уведомления изменить невозможно, однако можно изменить
Да*список приемников, вызываемых на дальнейших этапах уведомления цепочки диспет
черизации события.
Пользовательские события и цепочка диспетчеризации события
Иерархическая событийная система языка ActionScript применяется ко всем событиям, получателями которых являются отображаемые объекты, — даже к тем событиям, которые генерируются вручную программистом. Когда получателем пользовательского события является объект в иерархии отображения, предки этого объекта получат уведомление о возникновении данного события.
Обобщенный код, показанный в листинге 21.5, демонстрирует, как пользовательские события, аналогично внутренним событиям, передаются по цепочке диспетчеризации события. В этом листинге тестовый класс CustomEventDemo говорит среде Flash выполнить диспетчеризацию пользовательского события, получателем которого является объект Sprite в списке отображения.
Листинг 21.5. Пользовательское событие, передаваемое по цепочке диспетчеризации
package {
Import flash.display
Import fl ash.events.*;
Import flash.text.*;
public class CustomEventDemo extends Sprite {
public static const SOME_EVENT:String = "SOME_EVENT";
public function CustomEventDemo ( ) {
var spr1te:Spr1te = new Spr1te( ); addChlld(sprite);
// Регистрируем приемник someEventL1stener( ) в экземпляре класса Stage // для уведомлений о возникновении события CustomEventDemo.SOME_EVENT. stage.addEventtlstener(CustomEventDemo.SOME_EVENT. someEventtlstener);
// Осуществляем диспетчеризацию события CustomEventDemo.SOME_EVENT,
// получателем которого является объект в списке отображения.
// Второй параметр конструктора класса Event устанавливаем в значение
// true, чтобы у события появилась фаза всплытия.
sprite.d1spatchEvent(new Event(CustomEventDemo.SOME_EVENT, true));
private function someEventtistener (e:Event):void { trace("SOME_EVENT occurred."):
} "
В результате вызова метода dispatchEvent ( ) из листинга 21.5 среда выполнения Flash осуществит диспетчеризацию события Cus tomEventDemo. SOME_EVENT, получателем которого является объект sprite, через цепочку диспетчеризации события. Цепочка выглядит следующим образом: •
Экземпляр класса Stage *
|-> Объект CustomEventDemo
|-> Объект Sprite
В фазе захвата событие CustomEventDemo. SOME_EVENT проходит от экземпляра класса Stage до объекта CustomEventDemo. В фазе получения событие переходит к объекту Sprite. Наконец, в фазе всплытия событие снова переходит к объекту CustomEventDemo и затем вновь к экземпляру класса Stage. Когда экземпляр класса Stage в фазе всплытия получает уведомление о возникновении события, вызывается функция someEventLis tener ( ). Несмотря на то что событие CustomEventDemo. SOME_EVENT является пользовательским, оно все равно передается по цепочке диспетчеризации события.
Как и в случае с внутренними событиями, иерархическая событийная архитектура языка ActionScript позволяет централизовать код, реагирующий на пользовательские события. Предположим, что мы создаем интернет-систему подачи заказов с элементом управления «корзина», который содержит значки выбранных продуктов. Элемент управления «корзина» представляется экземпляром пользовательского класса ShoppingBasket. Подобным образом значок каждого продукта представляется экземпляром пользовательского класса Product. Экземпляры этого класса являются отображаемыми детьми экземпляра класса ShoppingBasket. Экземпляр класса ShoppingBasket имеет строку заголовка, которая выводит название выбранного на настоящий момент продукта.
Когда пользователь выбирает значок продукта в элементе управления «корзина», приложение осуществляет диспетчеризацию пользовательского события Product. PRODUCT SELECTED, получателем которого является соответствующий экземпляр класса Product. Поскольку экземпляр класса ShoppingBasket является предком всех экземпляров класса Product, он получает уведомления всякий раз, когда возникает событие Product. PRODUCT_SELECTED.
Таким образом, чтобы синхронизировать текст строки заголовка экземпляра ShoppingBasket с выбранным в настоящий момент продуктом, мы просто регистрируем единственный приемник productSelectedListener ( ) для события Product.PRODUCT_SELECTED в экземпляре класса ShoppingBasket. Когда вызывается метод productSelectedListener ( ), мы знаем, что был выбран продукт, поэтому заменяем текст строки заголовка корзины названием нового выбранного продукта.
В листингах 21.6 и 21.7 показаны классы ShoppingBasket и Product. Пояснения к коду представлены в виде комментариев. Части кода, относящиеся к событиям, выделены полужирным шрифтом.
Листинг 21.6. Класс ShoppingBasket
package {
import flash.display.*;
Import fl ash.text.*;
Import flash.events.*;
// Интернет-корзина, которая может визуально содержать объекты Product.
public class ShoppingBasket extends Sprite {
// Отображаемая на экране строка заголовка панели «корзина»
private var t1tlе;TextFIeld;
// Массив товаров в этой корзине
private var products;Array;
// Выбранный в настоящий момент продукт private var seiectedProduct;Product;
// Конструктор
public function ShoppingBasket ( ) {
// Создаем новый пустой массив для хранения объектов- Product products = new Array( );
// Создаем отображаемую на экране строку заголовка
title = new TextFIeld( );
title.text = "No product selected";
title.autoSize = TextFIeldAutoSIze.LEFT;
title.border = true;
title.background = true;
title.selectable = false;
addChlld(tltle);
// Регистрируем приемник для событий Product.PRODUCT-SELECTED,
// получателями которых являются дочерние объекты Product.
addEventListener(Product.PRODUCT-SELECTED, productSelectedListener);
}"
// Добавляет новый объект Product в корзину
public function addProduct (product:Product):void {
// Создаем новый продукт и добавляем его в массив products products.push(product);
// Добавляем новый продукт в иерархию отображения данного объекта addChlId(products[products.length-1]);
// Теперь, когда у нас появился новый продукт, изменяем
// положение всех продуктов updateLayout( );
// Очень простой алгоритм размещения продуктов.
// упорядочивающий все продукты в одну строку
// в том порядке, в котором они были добавлены
// в корзину, слева направо
public function updateLayout ( ):vo1d {
var totalX:Number = 0;
for (var 1:1nt = 0; 1 < products.length; 1++) {
products[1].x = totalX;
totalX += products[1].width + 20; // 20 - интервал между колонками products[i].y = title.height + 20; // 20 - интервал между строками
// Реагирует на возникновение событий Product.PRODUCT_SELECTED,
// получателями которых являются дочерние объекты Product.
// Когда продукт выбран, этот метод обновляет
// строку заголовка корзины, используя
// название выбранного продукта.
private function productSelectedlistener (e:Event):void {
// Запоминаем выбранный продукт на тот случай,
// если нам в дальнейшем потребуется
// обратиться к нему
selectedProduct = Product(е.target);
// Обновляем строку заголовка корзины
title.text = selectedProduct.getName( );
Листинг 21.7. Класс Product
package {
Import flash.display.*;
Import fl ash.events.*;
Import flash.text.*;
// Значок продукта, который может быть помещен в объект ShopplngBasket
// с помощью метода ShopplngBasket.addProduct( ).
// В этой упрощенной версии класса значок - просто текстовое поле
// без соответствующего графического значка.
public class Product extends Sprite {
// Событийная константа для пользовательского события PRODUCT_SELECTED public static const PRODUCT-SELECTED:String = "PRODUCT-SELECTED";
// Отображаемая на экране надпись, представляющая название продукта private var label:TextF1eld;
// Название продукта
private var productName:String;
// Конструктор
public function Product (productName:Str1ng) {
// Сохраняем название продукта
this.productName = productName;
// Создаем отображаемую на экране надпись
label = new TextF1eld( );
label.text = productName;
label.autoSize = TextF1eldAutoS1ze.LEFT;
label.border = true;
label.background = true;
label.selectable = false:
addChlld(label);
// Регистрируем приемник для событий щелчка кнопкой мыши.
// Регистрируя приемник для событий MouseEvent.CLICK в этом объекте,
// мы будем получать уведомление о возникновении события всякий раз, // когда пользователь щелкает кнопкой мыши на его дочерних объектах // (например, на надписи).
addEventListener(MouseEvent.CLICK, clickListener);
// Возвращает название продукта
public function getName ( ):String {
return productName;
}
// Обрабатывает события MouseEvent.CLICK. В этом примере, чтобы выбрать
// продукт и осуществить диспетчеризацию события
// Product.PRODUCT_SELECTED, достаточно просто щелкнуть кнопкой мыши
// на названии продукта. В более сложной реализации могут учитываться
// другие факторы. Например, можно добавить возможность выбора
// продуктов с помощью клавиатуры, а на время трансакции с сервером
// отключать возможность выбора продуктов.
private function clickListener (е:MouseEvent):void {
// Уведомляем всех зарегистрированных приемников о том, что был выбран
// данный продукт. Благодаря системе иерархической диспетчеризации
// событий языка ActionScript, в процессе диспетчеризации
// пользовательского события, получателем которого является данный
// объект, вызываются не только приемники события
// Product.PRODUCT-SELECTED данного объекта, но и приемники события
// Product.PRODUCT-SELECTED, зарегистрированные в экземпляре класса
// ShoppingBasket.
dispatchEvent(new Event(Product.PRODUCT-SELECTED, true));
}
}
В листинге 21.8 представлено очень простое приложение, демонстрирующее основы использования классов ShoppingBasket и Product из листингов 21.6 и 21.7.
Листинг 21.8. Демонстрация использования класса ShoppingDemo
package {
Import flash.display.Sprite;
public class ShopplngBasketDemo extends Sprite {
public function ShopplngBasketDemo ( ) {
var basket:ShoppingBasket = new ShopplngBasket( ):
basket.addProduct(new Product("Nintendo W11"));
basket.addProduct(new Product("Xbox 360")):
basket.addProduct(new ProducK"PlayStation 3")); addChi1dCbasket):
Переходим к событиям овода
Мы рассмотрели практически все вопросы, касающиеся основных процессов, происходящих в иерархической событийной системе языка ActionScript. В следующем разделе мы применим полученные теоретические знания на практике, знакомясь с внутренними событиями пользовательского ввода приложения Flash Player.-
Интерактивность
В этой главе мы рассмотрим, как можно добавить интерактивность в приложение, реагируя на события ввода Flash Player. В частности, мы познакомимся с пятью различными категориями событий ввода:
мыши;
фокуса;•
клавиатуры;.
текстовыми событиями;
уровня приложения Flash Player.
Для каждой из перечисленных категорий мы рассмотрим конкретные события, предлагаемые интерфейсом API приложения Flash Player, и код, необходимый для обработки этих событий.
Представленные в этой главе описания событий относятся к приложению Flash Player (к версии, реализованной в виде модуля расширения браузера, и к автономной версии), но в целом данная информация применима и к любой другой среде, поддерживающей ввод данных с помощью мыши и клавиатуры (например, приложение Adobe AIR). Если вы используете другие среды выполнения, обязательно просмотрите соответствующую документацию по событиям ввода. Официальную справочную информацию, относящуюся к событиям ввода приложения Flash Player, можно найти в разделе Constants описания класса Event и его подклассов в справочнике по языку ActionScript корпорации Adobe. Полезная информация также находится в разделе Events описания классов TextField, Displayobject, InteractiveObjectи Stage.
Перед тем как приступить к нашему знакомству с конкретными событиями ввода, бегло рассмотрим некоторые основные правила, относящиеся ко всем событиям ввода.
Только экземпляры класса InteractiveObject. Уведомления о возникновении событий ввода отправляются экземплярам только тех классов, которые наследуются от класса InteractiveObject (Sprite, TextField, Stage, Loader, MovieClip, SimpleButton и подклассов этих классов). Объекты других типов не получают уведомления о возникновении событий ввода, даже если эти объекты находятся в списке отображения. Например, экземпляры класса Shape могут помещаться в список отображения, однако класс Shape не наследуется от класса InteractiveObject, поэтому экземпляры класса Shape не получают уведомления о возникновении событий ввода. Если объект Shape визуально перекрывает объект TextField и пользователь щелкает кнопкой мыши на объекте Shape, получателем результирующего события щелчка будет являться не Shape,
a TextField. Чтобы организовать взаимодействие с объектом Shape или объектом Bitmap, поместите его в контейнер (Sprite или MovieClip) и зарегистрируйте приемник в этом контейнере для событий ввода.
Только объекты из списка отображения. Объекты, не находящиеся в списке отображения на момент диспетчеризации приложением Flash Player некоторого события ввода, не смогут получить уведомление о возникновении этого события.
Поведение по умолчанию. Некоторые события ввода вызывают стандартную реакцию приложения Flash Player, называемую поведением по умолчанию. Например, перемещение указателя мыши над экземпляром класса SimpleButton приводит к тому, что этот экземпляр отображает графическое изображение, связанное с состоянием «над» (когда указатель мыши находится над данным экземпляром). В некоторых случаях поведение по умолчанию приложения Flash Player может быть отменено путем вызова метода экземпляра preventDefault ( ) класса Event. Дополнительную информацию можно найти в разд. «Отмена стандартного поведения событий» гл. 12.
Теперь переходим непосредственно к событиям!
События мыши
Приложение Flash Player выполняет диспетчеризацию событий мыши, когда пользователь производит манипуляции с системным указательным устройством. К указательным устройствам, которые могут генерировать события мыши, относятся: мышь, трекбол, сенсорный планшет ноутбука, джойстик ноутбука и перо. Тем не менее для удобства в этой книге используется всеобъемлющий термин «мышь», подразумевающий системное указательное устройство. События мыши могут возникать в результате следующих типов манипуляций:
нажатие или отпускание левой кнопки мыши;
перемещение указателя;
использование колесика прокрутки мыши (например, вращение).
Обратите внимание, что «щелчок правой кнопкой мыши» (то есть нажатие вспомогательной кнопки мыши) не включен в приведенный список. Приложение Flash Player генерирует события мыши только для основной (левой) кнопки мыши. Тем не менее стандартное контекстное меню приложения Flash Player, которое открывается щелчком вспомогательной кнопкой мыши, является настраиваемым. Дополнительную информацию можно найти в описании класса Con textMenu справочника по языку ActionScript корпорации Adobe.
Внутренние события мыши приложения
Flash Player
В табл. 22.1 перечислены типы внутренних событий приложения Flash Player. Для каждого типа события столбец «Тип события» содержит константу класса
MouseEvent, представляющую официальное строковое название типа события. В столбце «Описание» указывается конкретное действие пользователя, приводящее к возникновению этого события. Столбец «Получатель» определяет объект, который играет роль получателя события при его диспетчеризации. Столбец «Поведение по умолчанию» описывает стандартную реакцию приложения Flash Player на данное событие. Столбец «Всплывает» содержит информацию о том, имеет ли данное событие фазу всплытия. Столбец «Тип данных объекта, передаваемого в функцию-приемник» определяет тип данных объекта, передаваемого в функцию-приемник, обрабатывающую данное событие. Наконец, столбец «Примечание» содержит важную информацию, касающуюся использования данного события.
Потратьте немного времени, чтобы познакомиться с событиями мыши приложения Flash Player, внимательно изучив табл. 22.1. Однако сначала рассмотрим несколько основных моментов, которые необходимо иметь в виду при чтении информации, представленной в таблице.
Системный фокус — следующие события генерируются даже тогда, когда приложение Flash Player не имеет системного фокуса: MouseEvent .MOUSE_MOVE, MouseEvent. MOUSE_OVER, MouseEvent. MOUSE_OUT, MouseEvent. ROLL_OVER и MouseEvent. ROLL_OUT. Все остальные события мыши генерируются только в том случае, когда приложение имеет системный фокус.
Местоположение имеет значение — диспетчеризация событий не выполняется, когда пользователь манипулирует мышью за пределами области отображения приложения Flash Player, с одним исключением: если пользователь нажимает основную кнопку мыши в области отображения приложения Flash Player и затем отпускает ее за пределами этой области, выполняется диспетчеризация события MouseEvent.MOUSE_UP.
Для того чтобы получить уведомление, когда указатель мыши покидает область отображения приложения Flash Player, зарегистрируйте приемник для события Event .MOUSE_MOVE, как рассматривается далее в разд. «События ввода уровня приложения Flash Player».
Векторные изображения игнорируются в экземпляре основного класса — взаимодействие мыши с векторным содержимым, нарисованным через переменную экземпляра graphics основного класса SWF-файла, не вызывает генерацию событий мыши. Тем не менее генерация событий мыши происходит в результате взаимодействия мыши с векторным содержимым, нарисованным через переменную экземпляра graphics любого другого экземпляра класса InteractiveObj ect или его подклассов.
Поведение по умолчанию отменить нельзя — поведение по умолчанию приложения Flash Player нельзя отменить ни для какого типа событий мыши.
Мгновенное обновление экрана — чтобы обновить содержимое на экране после обработки любого события мыши, используйте метод экземпляра updateAf terEvent ( ) класса MouseEvent. Полную информацию можно найти в разд. «Постсобытийные обновления экрана» гл. 23.
Тип события
Описание
Получатель
Поведение по умолчанию
Всплывает
Тип данных объекта, передаваемого в функцию- приемник
Примечание
MouseEvent.
MOUSE_DOWN
Нажатие основной кнопки мыши, когда указатель мыши находится над областью отображения приложения Flash Player
Объект InteractiveObject, находящийся под указателем мыши в момент нажатия основной кнопки мыши
Если получателем является объект SimpleButton, отображается графика, на которую ссылается его переменная downState. Если получателем является объект TextField, для которого включена возможность выделения, начинается процесс выделения. Отменить нельзя
Да
MouseEvent
MouseEvent. MOUSE_UP
Отпускание основной кнопки мыши, когда указатель мыши находится над областью отображения приложения Flash Player
Объект InteractiveObject, находящийся под указателем мыши в момент отпускания основной кнопки мыши
Если получателем является объект SimpleButton, отображается графика, на которую ссылается его переменная overstate. Если получателем является объект TextField, для которого включена возможность выделения, заканчивается процесс выделения. Отменить нельзя
Да
MouseEvent
MouseEvent. CLICK
Нажатие и последующее отпускание основной кнопки мыши над одним и тем же объектом InteractiveObject. Или активизация пользователем экземпляра класса SimpleButton, Sprite или MovieClip клавишей Пробел или Enter. Дополнительную информацию можно найти далее, в разд. «События фокуса»
Объект InteractiveObject, на котором щелкнули кнопкой мыши или активизировали
Отсутствует
Да
MouseEvent
Таблица 22.1. События мыши приложения Flash Player
События мыши
Продолжение ^Продолжение ^СПСП
Продолжение ^
Продолжение ^
СП
СП
Тип события
Описание
Получатель
Поведение по умолчанию
Всплывает
Тип данных объекта, передаваемого в функцию- приемник
Примечание
MouseEvent.
DOUBLE_CLICK
Два события MouseEvent. CLICK, происходящих одно за другим над одним и тем же объектом InteractiveObject
Объект InteractiveObject, на котором дважды щелкнули кнопкой мыши
Если получателем является объект TextField, для которого включена возможность выделения, выделяется слово, находящееся под указателем мыши
Да
MouseEvent
Возникает, только если программист заранее присвоил переменной doubleClickEnabled объекта-получателя значение true.
В последовательности двойного щелчка первый генерирует событие MouseEvent. CLICK; второй — событие MouseEvent. DOUBLE_CLICK.
Скорость двойного щелчка определяется операционной системой
MouseEvent.
MOUSE_MOVE
Указатель мыши перемещается над областью отображения приложения Flash Player
Объект Interactive Object, находящийся под указателем мыши в момент его перемещения
Если получателем является объект TextField с выделенным текстом, происходит обновление выделения. Отменить нельзя
Да
MouseEvent
MouseEvent.
MOUSE_OVER
Указатель мыши переместился на отображаемый объект
Объект InteractiveObject, на который переместился указатель мыши
Когда получателем является объект SimpleButton, при нажатой основной кнопке мыши отображается объект, на который ссылается переменная upstate. Если основная кнопка мыши отпущена, отображается объект, на который ссылается переменная overstate. Отменить нельзя
Да
MouseEvent
Не генерируется для экземпляра класса Stage. Чтобы обратиться к объекту InteractiveObject, над которым до настоящего момента находился указатель мыши, используйте переменную MouseEvent. relatedObject
Таблица 22.1 (продолжение)
Глава 22. Интерактивность
MouseEvent. MOUSE_OUT
Указатель мыши переместился за границы отображаемого объекта
Объект InteractiveObject, за границы которого переместился указатель мыши
Если получателем является объект SimpleButton, отображается объект, на который ссылается переменная upstate. Отменить нельзя
Да
MouseEvent
He генерируется для экземпляра класса Stage. Чтобы обратиться к объекту InteractiveObject, над которым находится указатель мыши, используйте переменную MouseEvent. relatedObject
MouseEvent. ROLL_OVER
Указатель мыши переместился на некоторый объект InteractiveObject или на одного из его потомков
Объект InteractiveObject, зарегистрировавший приемник события
Отсутствует
Нет
MouseEvent
Не генерируется для экземпляра класса Stage. Чтобы обратиться к объекту InteractiveObject, над которым до настоящего момента находился указатель мыши, используйте переменную MouseEvent. relatedObject
MouseEvent. ROLL_OUT
Указатель мыши прежде переместился на некоторый объект InteractiveObject или одного из его потомков, но больше не находится над этим отображаемым объектом или одним из его потомков
Объект InteractiveObject, зарегистрировавший приемник события
Отсутствует
Нет
MouseEvent
Не генерируется для экземпляра класса Stage. Чтобы обратиться к объекту InteractiveObject, над которым сейчас находится указатель мыши, используйте переменную MouseEvent. relatedObject
MouseEvent.
MOUSE_WHEEL
Когда приложение Flash Player имело системный фокус, было использовано устройство прокрутки мыши
Объект InteractiveObject, над которым находился указатель мыши в момент использования устройства прокрутки
Если получателем является объект TextField, происходит прокручивание его данных. Нельзя отменить с помощью метода экземпляра preventDefault() класса Event, но см. столбец «Примечание»
Да
MouseEvent
Чтобы предотвратить прокручивание текстовых полей, присвойте переменной mouseWheelEnabled получателя значение false
9 СП
3 X л
Z Z Е
Регистрация приемников для событий мыши
Для регистрации приемника для события мыши используется следующая базовая процедура.
Применяя информацию о событии в столбце «Описание» табл. 22.1, найдите константу для желаемого типа события в столбце «Тип события».
Создайте функцию-приемник с единственным параметром, имеющим тип данных MouseEvent.
Просмотрите столбец «Получатель» табл. 22.1, чтобы определить объект-получателя события.
Наконец, зарегистрируйте функцию, определенную на шаге 2 либо в объекте- получателе события (для уведомлений в фазе получения), либо в одном из предков объекта-получателя (для уведомлений в фазе захвата или в фазе всплытия). Большинство событий мыши обрабатывается приемниками, зарегистрированными в получателе события (то есть в объекте, который концептуально получает данные)..
Применим описанные шаги на примере. Предположим, мы хотим зарегистрировать функцию-приемник для получения уведомлений, когда пользователь щелкает кнопкой мыши на следующем объекте TextField:
var theTextField:TextField = new TextF1eld( );
theTextField.text="Clickhere";
theTextField.autoSize=TextFieldAutoSize.LEFT;
theTextField.border=true;
theTextField.background=true;
theTextField.selectable = false;.
Мы осуществляем следующие шаги.
Используя информацию в столбце «Описание» табл. 22.1, мы определяем, что константой события щелчка кнопкой мыши является MouseEvent. CLICK.
Далее мы создаем функцию clickListener ( ), которая будет получать уведомления о возникновении событий MouseEvent. CLICK. Будьте внимательны: типом данных параметра функции clickListener ( ) является MouseEvent. private function clickListener (e:MouseEvent):void {
trace("Mouse was clicked");
}
Далее в соответствии с информацией в столбце «Получатель» табл. 22.1 мы определяем, что получателем события Mouseclick.CLICK является объект InteractiveObj ect, на котором пользователь щелкнул кнопкой мыши. Мы хотим знать, когда щелкают на объекте theTextField, поэтому наш приемник события должен быть зарегистрирован либо в объекте theTextField, либо в одном из его отображаемых предков.
Для этого примера мы зарегистрируем приемник clickListener ( ) непосредственно в объекте-получателе TextField — theTextField, как показано в следующем коде:
theTextField.addEventListener(MouseEvent.CLICK, cl 1ckListener);
В результате выполнения описанных шагов наш метод clickLis tener ( ) будет вызываться всякий раз, когда пользователь щелкает кнопкой мыши на объекте theTextField. В листинге 22.1 представлен код, демонстрирующий предыдущие шаги в контексте простого класса ClickableText.
Листинг 22.1. Обработка события MouseEvent.CLICK
package {
Import flash.display.*;
Import flash.text.*;
Import fl ash.events.*;
public class ClickableText extends Sprite {
public function ClickableText ( ) {
var theTextF1eld:TextF1eld = new TextF1eld( );
theTextField.text = "Click here";
theTextField.autoSize = TextF1eldAutoS1ze.LEFT;
theTextField.border = true;
theTextField.background = true;
theTextField.selectable = false;
addChl1d(theTextF1eld);
theTextFIeld.addEventLIstener(MouseEvent.CLICK. cl 1ckL1stener);
}
private function c!1ckL1stener (e:MouseEvent):void { traceCMouse was clicked");
}
}
}
Все прошло практически без проблем. Рассмотрим другой пример. Следующий код регистрирует приемник mouseMoveListener ( ), выполняющийся всякий раз при перемещении мыши, когда указатель находится над объектом Sprite, на который ссылается переменная triangle.
// Создаем треугольник
var tr1angle;Spr1te = new Sprite( );
tг1 angle.graphics.11neSty1e (1);
tr1angle.graphics.beg1nF111 (OxOOFFOO. 1);
tr 1 angle.graphlcs.moveTo(25. 0);
tr1 angle.graphlcs.HneTo(50, 25);
triangle.graphics.HneTo(0, 25);
triangle.graphics.HneTo(25. 0);
triangle.graphics.endFIll( );
triangle.x = 200;
triangle.у = 100;
// Регистрируем приемник в объекте triangle для событий MouseEvent.MOUSE_MOVE tr1 angle.addEventLIstener(MouseEvent.MOUSE_MOVE. mouseMoveLIstener);
// ...где-то в классе определяем приемник
private function mouseMoveListener (e:MouseEvent);void {
trace("mouse move");
}
Как видно из предыдущего кода, приемники для событий мыши можно регистрировать в объекте, который не находится в списке отображения. Тем не менее такие приемники не будут вызываться до тех пор, пока объект не будет добавлен в список отображения.
Объект не сможет получать уведомления о возникновении событий ввода, пока он не будет добавлен в список отображения.
В листинге 22.2 предыдущий код, создающий треугольник, помещается в контекст основного класса MouseMotionSensor SWF-файла. Здесь объект triangle добавляется в список отображения, поэтому может получать уведомления о возникновении событий мыши.
Листинг 22.2. Обработка события MouseEvent. MOUSE_MOVE над треугольником package {
Import flash.display.*;
Import fl ash.events.*;
public class MouseMotlonSensor extends Sprite {
public function MouseMotlonSensor ( ) {
// Создаем треугольник
var triangle;Sprite = new Spr1te( );
t r1angle.g ra ph1cs.11neSty1e(1);
tr1angle.graphlcs.beg1nF111(OxOOFFOO, 1);
triangle.graphics.moveTo(25. 0);
tr1 angle.graphlcs.11neTo(50, 25);
triangle.graphics.HneTo(0. 25);
tr1 angle.graphlcs.lineTo(25. 0);
tr1angle.graphlcs.endFIl1( );
triangle.x = 200;
triangle.у = 100;
// Добавляем объект triangle в список отображения addChi* 1 d(tr1 angl е);
// Регистрируем приемник в объекте triangle для событий
// MouseEvent.MOUSE_MOVE
tг1anglе.add EventL1stener(MouseEvent.MOUSE_MOVE, mouseMoveLIstener);
}"
private function mouseMoveLIstener (e;MouseEvent):void { trace("mouse move");
}
}
}
Базовый код, описывающий приемник, и код, регистрирующий приемник, представленные в листинге 22.2, могут быть использованы для любого события из табл. 22.1.
Упражнение для читателя. Попробуйте добавить новый код в листинг 22.2, который регистрирует приемники для всех событий, перечисленных в табл. 22.1. В качестве шаблона используйте код, описывающий и регистрирующий приемник для события MouseEvent. MOUSE_MOVE. Следующий код, который требуется для регистрации приемника события MouseEvent .MOUSE_DOWN (первое событие, перечисленное в табл. 22.1), поможет вам начать.
// Добавьте этот код. регистрирующий приемник события, в конструктор класса tri a ng1е.addEventListener(MouseEvent.MOUSE_DOWN. mouseDownLIstener);
// Добавьте этот код. описывающий приемник, в тело класса private function mouseDownLIstener (e:MouseEvent):void { trace("mouse down");
}
События мыши и перекрывающиеся отображаемые объекты
По умолчанию, когда событие мыши возникает над двумя или более перекрывающимися экземплярами класса InteractiveObject, приложение Flash Player отправляет событие только одному экземпляру, который визуально расположен поверх остальных объектов. Объекты, находящиеся позади самого верхнего объекта, о возникновении события не уведомляются.
Например, если объект Text Field визуально перекрывает объект Sprite и пользователь щелкает кнопкой мыши на объекте TextField, приложение Flash Player выполняет диспетчеризацию события MouseEvent. CLICK, получателем которого является только объект TextField. Объект Sprite не получает уведомления о том, что произошел щелчок кнопкой мыши.
В листинге 22.3 представлено простое приложение, которое демонстрирует предыдущий сценарий «объект TextField над объектом Sprite». Основной класс приложения ClickSensor регистрирует приемник clickListener ( ) для события MouseEvent . CLICK в объекте Sprite — circle. Объект Sprite частично перекрывается объектом TextField — textfield. Когда вызывается метод clickListener ( ), происходит перемещение объекта circle на 10 пикселов вправо.
Листинг 22.3. Приемник событий мыши, зарегистрированный в частично перекрытом объекте
package {
Import flash.display.*;
Import fl ash.events.*;
Import flash.text.*;
public class ClickSensor extends Sprite {
public function ClickSensor ( ) {
// Создаем круг
var c1rcle;Spr1te = new Sprite( );
c1rcle.graphics.beg1nF111 (0x999999, 1);
ci rd e. graphi cs. 11 neSty 1 e (1);
circle.graphics.drawEl11pse(0, 0, 100, 100);
// Создаем объект TextField
var textfield:TextField = new TextField( );
textfield.text = "Click here";
textfield.autoSize = TextFieldAutoSize.LEFT;
textfield.x = 30;
textfield.y = 30;
textfield.border = true;
textfield.background = true;
// Добавляем объект circle в список отображения addChild(circle);
// Добавляем объект textfield в список отображения,
// поверх объекта circle addChild(textfield);
// Регистрируем приемник для получения уведомлений,
// когда пользователь щелкает кнопкой мыши на круге
ci rdе.addEventListener(MouseEvent.CLICK, clickListener);
// Обрабатывает события MouseEvent.CLICK, получателем которых является // объект circle.
private function clickListener (e:MouseEvent):void {
traceC'User clicked: " + e.target);
DisplayObjecUe.target) .x += 10;
}
}
}
На рис. 22.1 показан результат выполнения кода из листинга 22.3.
Рис. 22.1. Результат выполнения приложения ClickSensor
Если при выполнении приложения ClickSensor пользователь щелкнет кнопкой мыши на видимой части объекта circle, этот объект сместится вправо. Но если пользователь щелкнет кнопкой мыши на части объекта circle, которая перекрыта объектом textfield, объект circle не получит уведомления о возникновении события MouseEvent. CLICK и, следовательно, не будет смещен.
Однако существует возможность сделать так, чтобы объект textfield игнорировал любые события мыши, тем самым позволяя объекту circle определять щелчки
кнопкой мыши даже в тех местах, которые перекрыты объектом textfield. Чтобы объект textfield игнорировал все события мыши, мы присваиваем его переменной mouseEnabled значение false, как показано в следующем коде:
textfield.mouseEnabled = false;
Если бы эта строка кода была добавлена в метод-конструктор класса ClickSensor, все щелчки кнопкой мыши, происходящие над любой частью объекта circle, — видимой или невидимой, — приводили бы к перемещению объекта circle вправо.
Когда переменной mouseEnabled экземпляра класса InteractiveObject присвоено значение false, этот экземпляр не получает никаких уведомлений о возникновении событий мыши. Вместо этого события мыши отправляются следующему самому верхнему экземпляру класса InteractiveObject в списке отображения, для которого включена возможность обработки таких событий.
Определение позиции указателя мыши
Как было рассказано ранее, когда приложение Flash Player вызывает функцию- приемник события мыши, оно передает в эту функцию объект MouseEvent. Он хранит текущую позицию указателя мыши в следующих переменных экземпляра:
localXиlocalY;
stageX и stageY.
Переменные localX и localY представляют позицию указателя мыши в координатном пространстве получателя события (то есть относительно левого верхнего угла получателя события). В то же время переменные stageX и stageY представляют позицию указателя мыши в координатном пространстве экземпляра класса Stage (то есть относительно левого верхнего угла экземпляра класса Stage).
В листинге 22.4 демонстрируется использование переменных localX, localY, stageX и stageY. Здесь мы создаем объект TextField, добавляем его непосредственно в экземпляр класса St аде и затем размещаем его в позиции с координатами (100; 100). Когда пользователь щелкает кнопкой мыши на объекте TextField, мы выводим позицию указателя мыши относительно этого объекта (то есть получателя события) и относительно экземпляра класса Stage. Например, если пользователь щелкнет кнопкой мыши в точке, которая находится на 10 пикселов правее и 20 пикселов ниже левого верхнего угла объекта TextField, результат будет выглядеть следующим образом:
Position 1n TextFleld's coordinate space: (10. 20)'
Position in Stage Instance's coordinate space: (110, 120)
Вот этот код:
Листинг 22.4. Определение позиции указателя мыши
package {
Import flash.display.*;
Import fl ash.events.*;
Import flash.text.*;
public class MousePosItionChecker extends Sprite {
public function MousePosItionChecker ( ) {
// Создаем объект TextField
var textfield:TextField = new TextField( );
textfield.text = "Click here";
textfield.autoSize = TextFieldAutoSize.LEFT;
textfield.x = 100; textfield.у = 100;
// Добавляем объект textfield в список отображения в качестве // непосредственного ребенка экземпляра класса Stage stage.addChi1d(textfield);
// Регистрируем приемник в объекте textfield
// для событий щелчка кнопкой мыши
textfield.addEventListener(MouseEvent.CLICK, clickListener);
}
// Когда пользователь щелкает кнопкой мыши на объекте textfield,
// отображаем позицию указателя мыши
private function clickListener (e:MouseEvent):void {
// Позиция указателя мыши относительно объекта TextField trace(’’Position in TextField's coordinate space: C
+ e.localX + ", " + e.localY + ")");
11 Позиция указателя мыши относительно экземпляра класса Stage trace("Position in Stage instance's coordinate space: ("
+ e.stageX + ", " + e.stageY + ")");
}
}
}
Обновляя позицию объекта в ответ на изменения позиции мыши, мы можем сделать так, чтобы этот объект следовал за мышью. В листинге 22.5 представлен код на языке ActionScript 3.0, реализующий пользовательский указатель мыши. В данном листинге применяются многие методики, с которыми мы познакомились на протяжении этой книги. В частности, код из листинга использует класс StageDetector, рассмотренный в подразд. «События ADDEDTOSTAGE и REMOVED FROM STAGE» разд. «События контейнеров» гл. 20. В листинге также применяются две методики, которые мы еще не рассматривали: преобразование координат и постсобытийные обновления экрана. Перекрестные ссылки на дополнительную информацию указаны в комментариях.
Листинг 22.5. Пользовательский указатель мыши package {
import fl ash.di splay.*;
import flash.ui.*;
import fl ash.events.*;
import flash.geom.*;*
// Отображаемый класс, который заменяет указатель мыши новым изображением.
// Когда объект CustomMousePointer добавляется в список отображения, он
// автоматически скрывает системный указатель и начинает следовать за его // позицией. Когда объект CustomMousePointer удаляется из списка
// отображения, он автоматически восстанавливает системный указатель мыши, public class CustomMousePointer extends Sprite {
// Конструктор
public function CustomMousePointer ( ) {
// Создаем синий треугольник, который будем применять в качестве
// пользовательского указателя мыши
graphics.lineStyle(l);
graphics.beginFill(OxOOOOFF, 1):
graphics.lineTo(15, 5);
graphics.lineTo(5, 15);
graphics.lineTo(0, 0);
graphics.endFi11( );
// Регистрируем приемник для получения уведомлений, когда этот объект // добавляется в список отображения или удаляется из него (требуется // пользовательский вспомогательный класс StageDetector) var StageDetector:StageDetector = new StageDetector(this);
StageDetector.addEventtistener(StageDetector.ADDED_TO_STAGE, addedToStagetistener);
StageDetector.addEventtistener(StageDetector.REMOVED_FROM_STAGE, removedFromStagetistener);
// Обрабатывает события StageDetector.ADDED_TO_STAGE
private function addedToStagetistener (e:Event):void {
// Прячем системный указатель мыши
Mouse.hi de( );
// Регистрируем приемник для получения уведомлений, когда системный // указатель мыши перемещается над областью отображения приложения
// Flash Player или выходит за ее пределы
stage.addEventtistener(MouseEvent.MOUSE_MOVE, mouseMovetistener);
stage.addEventtistener(Event.MOUSE_LEAVE, mouseteavetistener);
// Обрабатываем события StageDetector.REMOVED_FROM_STAGE private function removedFromStagetistener (e:Event):void {
// Отображаем системный указатель мыши
Mouse.show( );
// Отменяем регистрацию приемников для событий мыши в экземпляре
// класса Stage
stage.removeEventtistener(MouseEvent.MOUSE_MOVE, mouseMovetistener);
stage.removeEventtistener(Event.MOUSE_LEAVE, mouseteavetistener);
// Обрабатываем события Event.MOUSE_LEAVE private function mouseteavetistener (e:Event):void {
// Когда мышь выходит за пределы области отображения приложения Flash
// Player, прячем пользовательский указатель. В противном случае // пользовательский указатель мыши и системный указатель мыши будут // отображаться на экране одновременно.
visible = false; }
// Обрабатывает события MouseEvent.MOUSE_MOVE
private function mouseMovetistener (e:MouseEvent):void {
// При перемещении мыши обновляем позицию пользовательского указателя, // чтобы она соответствовала позиции системного указателя.
// (Информацию по преобразованию точек между координатными
// пространствами можно найти в описании метода
// Displayobject.globalTotocal( ) в справочнике по языку ActionScript
// корпорации Adobe)..•
var pointlnParent:Point = parent.globalTotocal(new Point(e.stageX, e.stageY));
x = pointlnParent.x;
у = pointlnParent.у;
// Запрашиваем постсобытийное обновление экрана, чтобы анимация // указателя была максимально плавной. Дополнительную информацию // о методе MouseEvent.updateAfterEvent( ) можно найти в гл. 23. e.updateAfterEvent( );
// Возникло событие MouseEvent.MOUSE_MOVE, поэтому системный указатель
// должен находиться внутри области отображения приложения Flash
// Player. Таким образом, убеждаемся, что пользовательский указатель
// мыши отображается на экране (он может быть скрыт, поскольку // системный указатель мог покидать пределы области отображения // приложения Flash Player). Здесь этот код расположен неудачно -
// он по праву принадлежит событию Event.MOUSE_ENTER, однако
// в приложении Flash Player 9 такого события не существует.
if (Ivisible) { visible = true;
}
}
}
}
В листинге 22.6 представлен простой тестовый класс, который демонстрирует использование класса CustomMousePointer из листинга 22.5.
Листинг 22.6. Демонстрационный класс, представляющий использование класса
CustomMousePointer
package {
import flash.display.*;
// Демонстрирует использование класса CustomMousePointer
public class CustomMousePointerDemo extends Sprite { private var pointer-.CustomMousePointer;
// Конструктор
public function CustomMousePolnterDemo ( ) {
// Создаем новый объект CustomMousePolnter и добавляем его в список
// отображения. В результате добавления объекта CustomMousePolnter
// в список отображения системный указатель мыши автоматически
// заменяется объектом CustomMousePolnter.
pointer = new CustomMousePolnter( );
addChl1d(po1nter);
}
}
}
Упражнение для читателя. Попытайтесь восстановить цепочку выполнения, которая начинается в конструкторе класса CustomMousePolnterDemo из листинга 22.6 и завершается вызовом метода экземпляра a dde dToStageListener( ) класса CustomMousePolnter. В некоторый момент времени вам потребуется мысленно выполнить код класса StageDetector из гл. 20, что поможет получить более глубокие знания по API отображения и списку отображения. Ниже перечислены семь первых шагов в цепочке выполнения, которые помогут вам начать.
Создаем новый объект CustomMousePolnter.
Выполняем метод-конструктор объекта CustomMousePolnter, созданного на шаге 1.
Рисуем синий треугольник в объекте CustomMousePolnter.
Создаем новый объект StageDetector, передавая в его конструктор объект CustomMousePolnter.
Вызываем метод setWatchedOb j ect ( ) объекта StageDetector, передавая объект CustomMousePolnter в качестве его единственного аргумента.
Присваиваем объект CustomMousePolnter переменной watchedOb j ect объекта StageDetector.
Значение переменной watchedObj ect. stage равняется null (поскольку объект CustomMousePolnter на настоящий момент не находится в списке отображения), поэтому переменной onstage объекта StageDetector присваиваем значение false.
Вы можете продолжить цепочку выполнения с этого момента. Желаем приятного времяпрепровожд ен ия!
I Мысленное выполнение кода — это хороший способ понять, как работает программа.
uy J ш оу
«Глобальная» обработка событий мыши
В приложении Flash Player отсутствуют настоящие глобальные события мыши. Однако, зарегистрировав приемник событий мыши в экземпляре класса Stage, мы можем обрабатывать взаимодействия с мышью независимо от того, где они произошли в пределах области отображения приложения. Например, следующий
код регистрирует метод mouseMoveListener ( ) в экземпляре класса Stage для событий MouseEvent.MOUSE_MOVE:
package {
Import flash.display.*:
Import fl ash.events.*:
public class GlobalMouseMotlonSensor extends Sprite {
public function GlobalMouseMotlonSensor ( ) {
stage.addEventLIstener(MouseEvent.MOUSE_MOVE, mouseMoveLIstener):
}■
private function mouseMoveListener (e:MouseEvent);void { trace("The mouse moved."):
}
}
}
Всякий раз, когда при выполнении предыдущего кода указатель мыши перемещается над областью отображения Flash Player, приложение осуществляет диспетчеризацию события MouseEvent. MOUSE MOVE, в результате чего вызывается метод mouseMoveListener ( ).
Рассмотрим еще один пример «глобальной» обработки событий мыши. Чтобы выявить все моменты нажатий кнопки мыши в приложении, мы используем следующий код:
package {
Import flash.display.*;
Import fl ash.events.*;
public class GlobalMouseDownSensor extends Sprite {
public function GlobalMouseDownSensor ( ) {
stage.addEventLIstener(MouseEvent.MOUSE_DOWN. mouseDownLIstener);
}"
private function mouseDownLIstener (e:MouseEvent);void { trace("The primary mouse button was pressed.");
}
}
}
Всякий раз, когда при выполнении предыдущего кода нажимается основная кнопка мыши и при этом указатель находится над областью отображения Flash Player, приложение осуществляет диспетчеризацию события MouseEvent. MOUSE_DOWN, в результате чего вызывается метод mouseDownListener ( ).
Когда кнопка мыши нажимается над «пустым» участком области отображения приложения Flash Player (то есть над участком, где отсутствуют созданные программой отображаемые объекты), получателем события является экземпляр класса Stage. Когда нажатие кнопки мыши происходит над любым другим отображаемым объектом, получателем события является этот объект. Таким образом, проверяя получателя события в методе mouseDownListener ( ), мы можем создать код, ко-
торый реагирует именно на нажатие кнопки мыши над пустыми участками области отображения приложения Flash Player. Описанную методику демонстрирует следующее приложение CircleClicker. Когда пользователь щелкает кнопкой мыши на пустом участке области отображения Flash Player, приложение CircleClicker рисует круг случайного размера и закрашивает его случайным цветом. Когда же пользователь щелкает кнопкой мыши на круге, приложение CircleClicker удаляет этот круг с экрана.
package {
import fl ash.di splay.*;
import flash.events.*;
public class CircleClicker extends Sprite {'
public function CircleClicker ( ) {
stage.addEventListener(MouseEvent.CLICK. clickListener);
}
private function clickListener (e:MouseEvent):void {
// Если получателем события является экземпляр класса Stage.
if (е.target == stage) {
// ...рисуем круг
drawC!rcle(e.stageX, e.stageY);
} else {
// ...в противном случае получателем события должен являться
// объект Sprite, содержащий круг, поэтому удаляем данный объект removeChi1d(Di s playObject(e.target));
}
}
public function drawCircle (x:int. y:int);void {
var randomColor:int = Math.floor(Math.random( )*0xFFFFFF);
var randomSize:!nt = 10 + Math.floor(Math.random( )*150);
var circle:Sprite = new Sprite( )
circle.graphics.beg!nF!11(randomColor. 1);
circle.graph!cs.lineStyle( );
circle.graphics.drawEllipse(0. 0. randomSize. randomSize);
circle.x = x-randomSize/2;
circle.у = y-randomSize/2; addChild(circle);
}}
}
Стойт отметить, что по соображениям безопасности загруженному SWF-файлу может быть запрещено обращаться к экземпляру класса Stage приложения Flash Player. В подобных ситуациях для «глобальной» обработки событий мыши применяйте методики, описанные в разд. «Обработка событий между границами зон безопасности» гл. 12.
Теперь перейдем к рассмотрению другого типа событий ввода — событий, возникающих в результате смены фокуса.
События фокуса
Когда объект получает фокус ввода с клавиатуры, он выступает в роли логического приемника всех введенных с клавиатуры данных и становится получателем всех событий клавиатурного ввода. Объект может получить фокус ввода с клавиатуры либо программным путем (через переменную экземпляра focus класса Stage), либо в результате взаимодействия с пользователем посредством мыши, клавиши Tab или клавиш управления курсором. Однако для получения фокуса ввода с клавиатуры объект должен быть экземпляром класса, который наследуется от класса InteractiveObject. Более того, в приложении Flash Player фокус ввода с клавиатуры единовременно может иметь только один объект.
Для краткости вместо термина «фокус ввода с клавиатуры» обычно используется сокращенный термин «фокус».
Установка фокуса на объекты программным путем
Чтобы установить фокус на объект программным путем, мы присваиваем этот объект переменной focus экземпляра класса Stage.
Например, следующий код создает объект Sprite и затем немедленно устанавливает на него фокус (предполагается, что объект someDisplayContainer находится в списке отображения):
var rect:Sprite = new SpriteC ):
rect.graphi cs.11neSty1e (1):
rect.graphics.beginFill(OxOOOOFF):
rect.graph1cs.drawRect(0, 0, 150. 75):
someDisplayContainer.addCh11d(rect);
someDisplayContainer.stage.focus = rect:
При выполнении предыдущего кода объект rect получает фокус и, следовательно, становится получателем всех возникающих событий клавиатурного ввода.
Установка фокуса на объекты с помощью клавиатуры
Чтобы установить фокус на объект с помощью клавиатуры, пользователь нажимает клавишу Tab или клавиши управления курсором. Тем не менее, чтобы объект мог получать фокус с помощью указанных клавиш, он должен быть частью порядка перехода приложения Flash Player. Порядок перехода — это набор всех объектов, находящихся в списке отображения, которые теоретически могут получать фокус ввода с помощью клавиатуры. Порядок перехода также определяет последовательность, в которой объекты получают фокус при нажатии пользователем клавиши Tab.
В приложении Flash Player существует два различных порядка перехода: автоматический и пользовательский. Автоматический порядок перехода — это порядок перехода, который используется приложением Flash Player по умолчанию, когда не
определен пользовательский порядок перехода. Автоматический порядок перехода включает следующие объекты:
экземпляры класса TextField, находящиеся в списке отображения и переменной type которых присвоено значение TextFieldType . INPUT;
экземпляры классов Sprite или MovieClip, находящиеся в списке отображения и у которых переменной buttonMode или tabEnabled присвоено значение true;
экземпляры класса SimpleBitton, которые находятся в списке отображения.
Когда используется автоматический порядок перехода и пользователь нажимает клавишу Tab, фокус перемещается от одного объекта к другому в автоматическом порядке перехода. Последовательность автоматического порядка перехода приложения Flash Player определяется местоположением содержащихся в нем объектов — визуально перемещение фокуса происходит слева направо и затем сверху вниз (независимо от позиции этих объектов в иерархии отображения).
В отличие от автоматического, пользовательский порядок — это порядок перехода, определяемый программным путем и включающий произвольную последовательность объектов, переменной tabindex которых присвоено неотрицательное целое число. В пользовательский порядок перехода могут быть включены следующие типы объектов:
экземпляры класса TextField, переменной type которых присвоено значение TextFieldType.INPUT;
экземпляры классов Sprite, MovieClip или SimpleButton.
Когда по крайней мере одному находящемуся в настоящий момент в списке отображения объекта переменной tabindex присвоено значение 0 или большее, применяется пользовательский порядок перехода. В этом случае нажатие клавиши Tab приводит к установке фокуса на объекты в соответствии со значением их переменной tab Index, начиная с минимального значения и заканчивая максимальным.
Например, если у объекта, имеющего фокус в настоящий момент, переменной tab Index присвоено значение 2 и пользователь нажимает клавишу Tab, фокус устанавливается на объект, переменной tabindex которого присвоено значение 3. Если снова нажать клавишу Tab, фокус будет установлен на объект, переменной tabindex которого присвоено значение 4, ит. д. Если переменной tabindex двух объектов присвоено одно и то же значение, то в порядке перехода первым окажется объект с меньшей глубиной. Объекты, переменной tab Index которых значение не присвоено явно, исключаются из порядка перехода.
Независимо от того, какой порядок перехода используется в данный момент — автоматический или пользовательский, — когда фокус устанавливается на экземпляр класса Sprite, MovieClip или SimpleButton клавишей Tab, пользователь в дальнейшем может работать четырьмя клавишами для управления курсором, чтобы установить фокус на объект, расположенный в указанном направлении (сверху, снизу, слева или справа).
Чтобы исключить объект из автоматического или пользовательского порядка перехода, мы присваиваем переменной tabEnabled этого объекта значение false. Объекты, переменной_visib 1е которых присвоено значение false, автоматически исключаются из порядка перехода. Чтобы исключить всех потомков некоторого контейнера отображаемых объектов из автоматического или пользовательского порядка перехода, мы присваиваем переменной tabchildren этого контейнера значение false.
По умолчанию приложение Flash Player отображает желтый прямоугольник вокруг экземпляров классов Sprite, MovieClip или SimpleButton, если фокус был установлен с помощью клавиатуры. Чтобы отключить отображение желтого прямоугольника для конкретного объекта, мы присваиваем его переменной focusRect значение false. Если нужно отключить отображение желтого прямоугольника для всех объектов, мы присваиваем переменной stageFocusRect экземпляра класса Stage значение false. Стоит отметить, что значение переменной stageFocusRect не отражается на значении переменной focusRect отдельных объектов. Тем не менее присваивание значения переменной focusRect конкретного объекта перекрывает значение переменной stageFocusRect.
Установка фокуса на объекты с помощью мыши
Подобно тому как пользователь может устанавливать фокус ввода с клавиатуры, используя клавишу Tab или клавиши управления курсором, он может устанавливать фокус, щелкая на объекте кнопкой мыши. Однако по умолчанию с помощью мыши устанавливать фокус можно только на экземпляры классов SimpleButton HTextField. Чтобы предоставить пользователю возможность устанавливать фокус на экземпляры классов Sprite или MovieClip с помощью мыши, используется один из следующих подходов:
присвоить переменной buttonMode этого экземпляра значение true (убедившись, что его переменной tabEnabled явным образом не присвоено значение false);
переменной tabEnabled этого экземпляра установить значение true;
присвоить неотрицательное целое число переменной tabindex этого экземпляра (убедившись, что его переменной tabEnabled явным образом не присвоено значение false).
Например, следующий код создает объект Sprite, который получает фокус ввода с клавиатуры, когда на нем щелкают кнопкой мыши:
var rect:Sprite = new SpriteC );
rect.graphi cs.1ineSty1e (1);
rect.graphics.beg1nFi11(OxOOOOFF):
rect.graphics.drawRecKO, 0, 150, 75);
rect.tabEnabled = true;
Чтобы исключить установку фокуса на некоторый объект с помощью мыши, мы присваиваем переменной mouseEnabled этого объекта значение false. Чтобы исключить установку фокуса на потомков контейнера отображаемых
объектов, мы присваиваем переменной mousechildren этого контейнера значение false.
На объект нельзя установить фокус с помощью мыши, если переменной mouseEnabled этого объекта присвоено значение false или если этот объект является отображаемым потомком контейнера, переменной mousechildren которого присвоено значение false.
Более того, когда переменной tabEnabledэкземпляра класса Sprite, MovieClip или SimpleButton явным образом присваивается значение false, на этот экземпляр невозможно установить фокус с помощью мыши. Подобным образом, когда экземпляр класса Sprite, MovieClip или SimpleButton является потомком контейнера, переменной tabchildren которого присвоено значение false, на этот экземпляр невозможно установить фокус с помощью мыши. Тем не менее из- за ошибки в приложении Flash Player, даже если переменной tabEnabled объекта TextField будет явным образом присвоено значение f al se, на этот объект можно установить фокус с помощью мыши. Подобным образом из-за той же ошибки, даже если переменной tabchildren контейнера, потомком которого является объект TextField, будет присвоено значение false, на этот объект все равно можно установить фокус с помощью мыши.
Установка фокуса на потомков через одного предка. Чтобы среда Flash считала контейнер отображаемых объектов и всех его потомков одной группой, которая может получать фокус одним щелчком кнопкой мыши, выполните следующие шаги.
Включите возможность установки фокуса с помощью мыши для данного контейнера, присвоив его переменной buttonMode или tabEnabled значение true либо переменной tabindex любое неотрицательное целое число.
Отключите для дочерних объектов этого контейнера возможность взаимодействия с мышью, присвоив его переменной mousechildren значение false.
События фокуса приложения Hash Player
Когда фокус ввода с клавиатуры приложения переходит на новый объект (с использованием одного из способов, описанных в трех предыдущих разделах), приложение Flash Player выполняет диспетчеризацию одного или нескольких событий фокуса, определяющих данный переход. В табл. 22.2 перечислены типы внутренних событий фокуса приложения Flash Player. Для каждого типа события столбец «Тип события» содержит константу класса FocusEvent, представляющую официальное строковое название типа события. В столбце «Описание» указывается конкретное действие пользователя, приводящее к возникновению этого события. Столбец «Получатель» описывает объект, который выступает в роли получателя события при его диспетчеризации. Столбец «Поведение по умолчанию» описывает стандартную реакцию приложения Flash Player на данное событие. Столбец «Всплывает» содержит информацию о том, имеет ли данное событие фазу всплытия. Наконец, столбец «Тип данных объекта, передаваемого в функцию-приемник» определяет тип данных объекта, передаваемого в функцию-приемник, обрабатывающую данное событие.
Тип события
Описание
Получатель
Поведение по умолчанию
Всплывает
Тип данных объекта, передаваемого в функцию- приемник
FocusEvent. FOCUS_IN
Фокус был установлен на данный объект
Объект, получивший фокус. Чтобы обратиться к объекту, потерявшему фокус (если такой объект существует), используйте переменную экземпляра relatedObject класса FocusEvent
Отсутствует
Да
FocusEvent
FocusEvent. FOCUS_OUT
Фокус был потерян данным объектом
Объект, потерявший фокус. Чтобы обратиться к объекту, получившему фокус (если такой объект существует), используйте переменную экземпляра relatedObject класса FocusEvent
Отсутствует
Да
FocusEvent
FocusEvent.
KEY_FOCUS_CHANGE
Пользователь попытался изменить фокус с помощью клавиатуры
Объект с установленным на настоящий момент фокусом. Чтобы обратиться к объекту, на который пытается установить фокус пользователь (если такой объект существует), используйте переменную экземпляра relatedObject класса FocusEvent
Приложение Flash Player изменяет фокус. Может быть отменено методом экземпляра preventDefault() класса Event
Да
FocusEvent
FocusEvent.
MOUSE_FOCUS_CHANGE
Пользователь попытался изменить фокус с помощью мыши
Объект с установленным на настоящий момент фокусом. Чтобы обратиться к объекту, на который пытается установить фокус пользователь (если такой объект существует), используйте переменную экземпляра relatedObject класса FocusEvent
Приложение Flash Player изменяет фокус. Может быть отменено методом экземпляра preventDefault() класса Event
Да
FocusEvent
Глава 22. Интерактивность
Как видно из табл. 22.2, события FocusEvent. FOCUS_IN и FocusEvent. FOCUS_OUT используются для определения момента, когда объект получает или теряет фокус. На тот момент, когда происходит диспетчеризация этих событиii, изменение фокуса уже произошло. В отличие от этого, события FocusEvent. KEY_FOCUS_CHANGE и FocusEvent. MOUSE_FOCUS_CHANGE применяются для определения момента, когда объект собирается получить или потерять фокус, но еще нс получил или не потерял его. Приложение обычно использует события FocusEvent. KEY FOCUS CHANGE и FocusEvent. MOUSE_FOCUS_CHANGE, чтобы исключить изменение фокуса пользователем с помощью клавиатуры или мыши, — возможно, чтобы заставить пользователя взаимодействовать с определенной частью интерфейса, например с модальным диалогом.
Как и в случае с событиями мыши, в приложении Flash Player отсутствуют настоящие глобальные события фокуса. Тем не менее, зарегистрировав приемник для событий фокуса в экземпляре класса Stage, мы можем обрабатывать все изменения фокуса, которые происходят в приложении Flash Player. Эта методика продемонстрирована в листинге 22.7 — приложение создает два объекта TextField и, когда на них устанавливается фокус, меняет цвет их фона на зеленый.
Листинг 22.7. Глобальная обработка событий фокуса
package {
Import flash.display.*;
Import flash.events.*;
Import fl ash.text.*;
public class GlobalFocusSensor extends Sprite {
public function GlobalFocusSensor ( ) {
// Создаем текстовые поля
var f1eldl:TextF1eld = new TextF1eld( );
fleldl.width=100;
f1 eldl.height=30;
fleldl.border=true;
fleldl.background =true:
fleldl.type = TextFIeldType.INPUT;
var f1eld2:TextFIeld = new TextF1eld( );
f1 eld2.widthf1 eld2.widthf1 eld2.height f1eld2.yf1 eld2.height f1eld2.y= 100;= 30;= 50;= 100;= 30;= 50;f1eld2.borderf1eld2.border= true;= true;
f1 eld2.width
f1 eld2.width
f1 eld2.height f1eld2.y
f1 eld2.height f1eld2.y
= 100;
= 30;
= 50;
= 100;
= 30;
= 50;
f1eld2.border
f1eld2.border
= true;
= true;
f1eld2.background = true; . f1eld2.type = TextFIeldType.INPUT;
// Добавляем текстовые поля в список отображения addChlld(fleldl);
addCh1ld(f1eld2);
// Регистрируем приемник для событий FocusEvent.FOCUS_IN stage.addEventLIstener(FocusEvent.FOCUS_IN, focus Int1stener);
// Обрабатываем все события FocusEvent.FOCUS_IN в данном приложении private function focus InListener (e:FocusEvent):vo1d {
// Изменяем цвет фона объекта TextFleld, на который был установлен
// фокус, на зеленый
TextF1eld(e.target).backgroundcolor = OxFFOOFFOO;
// Изменяем цвет фона объекта TextFleld, потерявшего фокус, на белый
1f (е.relatedObject 1s TextFleld) {
TextFleld(e.relatedObject).backgroundcolor = OxFFFFFFFF;
}
}
События фокуса могут также обрабатываться приемниками, зарегистрированными в объекте-получателе события или в любом из отображаемых предков объекта-получателя события. В листинге 22.8 показано приложение, которое создает объект TextFleld, не позволяющий сменить фокус (после того как он был установлен) до тех пор, пока не будет введено по крайней мере три символа. Подобный код часто применяется в приложениях, которые проверяют данные, введенные через заполняемые формы, например через экран регистрации или форму заказа товара.
Листинг 22.8. Обработка событий фокуса для конкретного объекта
package {
Import flash.display
Import flash.events.*;
Import flash.text.*;
// Демонстрирует, как обрабатывать события FocusEvent.FOCUS_IN для
// отдельного объекта. Создает объект TextFleld, который после получения
// фокуса не позволяет его сменить до тех пор, пока не будет введено
// по крайней мере три символа.
public class ObjectFocusSensor extends Sprite {
private var namef1eld:TextF1eld;
private var passf1eld:TextF1eld;
public function ObjectFocusSensor ( ) {
// Создаем текстовые поля
namefield = new TextF1eld( );
namefield.width=100;
namefield.height=30;,
namefield.border=true;
namefl eld.background= true;
namefl eld.type = TextFleldType.INPUT;
passfield = new TextF1eld( );
passfield.width=100;
passfield.height=30;
passfield.у=50;
passfield.border=true;
passfield.background = true;
passfl eld.type = TextFIeldType.INPUT;
// Добавляем текстовые поля в список отображения addChlld(namefleld);
addChl1d(passf1 eld);
// Регистрируем приемник для событий изменения фокуса namefl eld.addEventLIstener(FocusEvent.MOUSE_FOCUS_CHANGE,
focusChangeLlstener);
namefl el d.addEventLI stener(FocusEvent.KEY_FOCUS_CHANGE, focusChangeLIstener);
// Обрабатывает все события изменения фокуса, получателем которых // является объе*кт namefield
private function focusChangeLlstener (e;FocusEvent);void {
1f (e.target == namefl eld && namefl eld.text.length < 3) { traceCName entered 1s less than three characters long"); e.preventDefaultt );
1
События ввода с клавиатуры
Приложение Flash Player выполняет диспетчеризацию событий ввода с клавиатуры, когда пользователь нажимает или отпускает клавишу. Вообще говоря, события ввода с клавиатуры обычно используются для инициирования ответного действия либо от всего приложения, либо от определенного элемента интерфейса. Например, нажатие клавиши S может вызывать глобальную команду сохранения пользовательских данных, а нажатие стрелки Ф может выбирать элемент в конкретном компоненте меню.
События ввода с клавиатуры, которые вызывают команды для всего приложения, обычно обрабатываются глобально с помощью приемников, зарегистрированных в экземпляре класса Stage приложения Flash Player. В отличие от этого, события ввода с клавиатуры, инициирующие ответное действие для конкретного элемента интерфейса, обычно обрабатываются приемниками, зарегистрированными в объекте, который на настоящий момент имеет фокус ввода с клавиатуры.
События ввода с клавиатуры приложения Flash Player предназначены для использования при разработке приложений, управляемых с помощью клавиатуры, но не подходят для реакции на ввод текста в объекты TextField. Для реакции на ввод текста применяйте событие TextEvent.TEXT_INPUT, которое рассматривается далее, в разд. «События текстового ввода».
В табл. 22.3 перечислены типы внутренних событий клавиатуры приложения Flash Player. Для каждого типа события столбец «Тип события» содержит константу класса KeyboardEvent, представляющую официальное строковое название типа события. Столбец «Описание» определяет конкретное действие пользователя, приводящее к возникновению этого события. Столбец «Получатель» описывает объект, который выступает в роли получателя события при его диспетчеризации. В столбце «Поведение по умолчанию» приводится стандартная реакция приложения Flash Player на данное событие. В отличие от событий мыши и событий фокуса, у событий клавиатуры отсутствует поведение по умолчанию. Столбец «Всплывает» содержит информацию о том, имеет ли данное событие фазу всплытия. Наконец, столбец «Тип данных объекта, передаваемого в функцию-приемник» определяет тип данных объекта, передаваемого в функцию-приемник, обрабатывающую данное событие.
Стоит отметить, что диспетчеризация событий клавиатуры осуществляется только тогда, когда Flash Player имеет системный фокус. Чтобы получать уведомления о получении или потере системного фокуса приложением Flash Player, зарегистрируйте приемник для событий Event. ACTIVATE и Event. DEACTIVATE (которые рассматриваются далее, в разд. «События ввода уровня приложения Flash Player»).
Таблица 22.3. События клавиатуры приложения Flash Player
Тип события
Описание
Получатель
Поведение по умолчанию
Всплывает
Тип данных объекта, передаваемого в функцию- приемник
KeyboardEvent. KEY_DOWN
Клавиша нажата
Объект InteractiveObject, имеющий фокус ввода с клавиатуры, либо, если никакой объект не имеет фокуса, экземпляр класса Stage
Отсутствует
Да
KeyboardEvent
KeyboardEvent. KEY_UP
Клавиша отпущена
Объект InteractiveObject, имеющий фокус ввода с клавиатуры, либо, если никакой объект не имеет фокуса, экземпляр класса Stage
Отсутствует
Да
KeyboardEvent
Глобальная обработка событий клавиатуры
Как и в случае с событиями мыши и фокуса, в приложении Flash Player отсутствуют настоящие глобальные события клавиатуры. Тем не менее, зарегистрировав приемник для событий клавиатуры в экземпляре класса Stage, можно обрабатывать все взаимодействия с клавиатурой, которые происходят в приложении Flash Player, когда оно имеет системный фокус. Эта методика продемонстрирована в листинге 22.9 — упрощенный класс отображает отладочное сообщение при нажатии любой клавиши.
Листинг 22.9. Глобальная обработка событий клавиатуры
package {
Import flash.display.*;
Import fl ash.events.*;
public class GlobalKeyboardSensor extends Sprite { public.function GlobalKeyboardSensor ( ) {
// Регистрируем приемник для получения уведомлений о нажатии клавиши stage.addEventLIstener(KeyboardEvent.KEY_DOWN, keyDownLIstener):
}
// Эта функция вызывается всякий раз при нажатии клавиши, когда
// приложение Flash Player имеет системный фокус
private function keyDownLIstener (e:KeyboardEvent):void { traceCA key was pressed.");
}
}
}
Обработка событий клавиатуры для конкретного объекта
Как видно из табл. 22.3, когда никакой объект не имеет фокуса ввода с клавиатуры, получателем всех событий клавиатуры является экземпляр класса Stage. В отличие от этого, когда экземпляр класса InteractiveObject имеет фокус ввода с клавиатуры, данный экземпляр является получателем всех событий клавиатуры, диспетчеризация которых выполняется приложением Flash Player.
Следовательно, чтобы реагировать на клавиатурный ввод, направленный в конкретный объект, мы регистрируем приемники в этом объекте. Это демонстрирует листинг 22.10, в котором показано приложение, создающее два объекта Sprite — recti и rect2. Когда фокус установлен на объекте recti и пользователь нажимает любую клавишу, приложение перемещает объект recti вправо. Когда фокус установлен на объекте rect2 и пользователь нажимает любую клавишу, приложение вращает объект rect2.
Листинг 22.10. Обработка событий клавиатуры для конкретного объекта package {
Import flash.display.*:
Import fl ash.events.*;
public class ObjectKeyboardSensor extends Sprite {
public function ObjectKeyboardSensor ( ) {
// Создаем прямоугольники
var recti:Sprite = new Sprite( );
recti.g raph 1 cs.11neSty1e(1);
recti.graphics.beg1nF111(OxOOOOFF):
rect^.graph!cs.drawRect(O, 0, 75, 75): recti.tabEnabled = true;
var rect2:Spr1te = new Spr1te( ):
rect2.graph!cs.1!neSty1e(1);
rect2.graphics.beginFill(OxOOOOFF);
rect2.graphics.drawRectCO, 0, 75. 75);
rect2.x = 200:
rect2.tabEnabled = true;
// Добавляем прямоугольники в список отображения addChild(recti);
addChild(rect2);
// Регистрируем приемники в прямоугольниках для событий клавиатуры recti.addEventLi stener(KeyboardEvent.KEY_DOWN, rectlKeyDowntistener); rect2.addEventLi stener(KeyboardEvent.KEY_DOWN. rect2KeyDownListener);
}
// Выполняется, когда фокус установлен на объекте recti и пользователь
// нажимает любую клавишу
private function rectlKeyDowntistener (e:KeyboardEvent):void { Spritete.target).x += 10;
}
// Выполняется, когда фокус установлен на объекте rect2 и пользователь
// нажимает любую клавишу
private function rect2KeyDowntistener (e:KeyboardEvent):void {
Spritete.target).rotation += 10;
}
}
}
Теперь, когда мы знаем, как определить момент нажатия или отпускания клавиши пользователем, выясним, как можно определить, какая клавиша была нажата или отпущена.
Определение последней нажатой или отпущенной клавиши
Приложение Flash Player присваивает обычный числовой идентификатор, называемый кодом клавиши, всем выбираемым клавишам. Чтобы определить код последней нажатой или отпущенной клавиши, мы получаем значение переменной экземпляра keyCode класса KeyboardEvent в функции-приемнике события KeyboardEvent. KEY_UP или KeyboardEvent. KEY_DOWN, как показано в листинге 22.11.
Листинг 22.11. Получение кода нажатой клавиши
package {
import flash.display.*;
import flash.events.*;
import flash.text.*;
// Отображаем код для любой нажатой клавиши public class KeyViewer extends Sprite {
private var keyoutput:TextFIeld;
public function KeyVIewer ( ) {
keyoutput = new TextF1eld( );
keyoutput.text = "Press any key...";
keyoutput.autoSize = TextFIeldAutoSIze.LEFT;
keyoutput.border = true;
keyoutput.background = true;
addChlld(keyoutput);
stage.addEventLIstener(KeyboardEvent.KEY_DOWN, keyDownLIstener);
private function keyDownLIstener (e;KeyboardEvent):vo1d {
// Отображаем код для нажатой клавиши
keyoutput.text = "The key code for the key you pressed 1s; "
+ e.key code;
}
} }
Чтобы определить момент, когда будет нажата или отпущена определенная клавиша, мы сравниванием ее код со значением переменной экземпляра keyCode класса KeyboardEvent в функции-приемнике событий KeyboardEvent. KEY_UP или KeyboardEvent. KEY_DOWN. Например, следующая функция-приемник события KeyboardEvent. KEY_DOWN определяет момент, когда будет нажата клавиша Esc, путем сравнения ее кода (27) со значением переменной keyCode. •
private function keyDownLIstener (e:KeyboardEvent):void {
if (e.keyCode = 27) {
traceCThe Escape key was pressed");
}
}
Коды для всех клавиш управления курсором и клавиш числовой клавиатуры представлены в виде констант класса flash.ui.Keyboard. Приведенный выше код обычно записывается следующим образом (обратите внимание на использование статической переменной ESCAPE класса Keyboard вместо значения литерала 27):
Import f 1 ash.u1.Keyboard;
private function keyDownLIstener (e:KeyboardEvent):void {
if (e.keyCode = Keyboard.ESCAPE) {•
traceCThe Escape key was pressed");
}
}
Коды клавиш зависят от выбранного языка и используемой операционной системы.
Список кодов клавиш на клавиатурах с раскладкой U.S. English можно найти по адресу http://livedocs.macromedia.eom/flash/8/main/00001686.html.
При написании выражений для определения момента нажатия или отпускания клавиши, отсутствующей среди констант класса flash. ui. Keyboard, всегда используйте такую последовательность действий.
Запустите приложение Keyviewer из листинга 22.11 на компьютере с такой же операционной системой и клавиатурой, как у конечного пользователя.
Нажмите желаемую клавишу.
Сохраните возвращенный код клавиши в виде константы.
Используйте константу, полученную на шаге 3, при определении момента нажатия или отпускания желаемой клавиши.
Предположим, что мы хотим определить момент, когда пользователь нажимает клавишу А на компьютере с операционной системой Mac OS и клавиатурой с раскладкой U.S. English. Мы запускаем приложение Keyviewer и нажимаем клавишу А. В ответ приложение Keyviewer отображает код клавиши — 65. Мы сохраняем этот код в виде константы пользовательского класса, например с именем KeyConstants, как показано в следующем коде:
public static const A_KEY:1nt = 65:
Затем, чтобы определить момент нажатия клавиши А, мы используем следующий код:
private function keyDowntlstener (е:KeyboardEvent):void {
1f (e.keyCode == KeyConstants.A_KEY) { traceC'The A key was pressed");
Следующий код демонстрирует описанную методику в контексте очень простого тестового приложения: package {
Import flash.display.*;
Import fl ash.events.*;
public class AKeySensor extends Sprite {
//
public static const A_KEY;1nt = 65;
public function AKeySensor ( ) {
stage.addEventLIstener(KeyboardEvent.KEY_DOWN. keyDowntlstener);
}
private function keyDowntlstener (e:KeyboardEvent);void { if (e.keyCode == AKeySensor.A_KEY) {
traceC'The A key was pressed");
}
}
}
Стоит отметить, что, когда используется редактор методов ввода (IME — Input Method Editor), переменная экземпляра keyCode класса KeyboardEvent не
поддерживается. Дополнительную информацию о редакторах IME можно найти в описании класса flash, system. IME справочника по языку ActionScript корпорации Adobe и в разделе Programming ActionScript 3.0 ► Flash Player APIs ► Client System Environment ► IME class документации корпорации Adobe.
Клавиши, расположенные в нескольких местах. На некоторых клавиатурах определенные клавиши, расположенные в нескольких местах, имеют одинаковые коды. Например, на компьютере с операционной системой Mac OS и клавиатурой с раскладкой U.S. English код клавиши 16 представляет и левую, и правую клавиши Shift; код клавиши 17 представляет и левую, и правую клавиши Ctrl; код клавиши 13 представляет и основную клавишу Enter, и клавишу Enter на числовой клавиатуре. Чтобы отличать подобные клавиши, расположенные в нескольких местах, используется переменная экземпляра keyLocation класса KeyboardEvent, значение которой обозначает логическое положение клавиши, представленное в виде одной из четырех констант класса flash. ui. KeyLocation (LEFT, NUM_PAD, RIGHT и STANDARD). Эту методику демонстрирует следующий код. В нем функция-приемник события KeyboardEvent.KEY_DOWN выводит одно отладочное сообщение в момент нажатия левой клавиши Shift, а другое — в момент нажатия правой клавиши Shift:
private function keyDowntlstener (e;KeyboardEvent):void {
1f (e.keyCode == Keyboard.SHIFT) {
1f (e.keyLocation == KeyLocation.LEFT) { traceC'The left Shift key was pressed");
} else 1f (e.keyLocation == KeyLocation.RIGHT) { traceC'The right Shift key was pressed");
}
} }
Определение одновременного нажатия нескольких клавиш
Чтобы определить нажатие клавиши Shift или Ctrl (клавиша Command на компьютерах Macintosh) в сочетании с любой другой клавишей, мы используем переменные экземпляра shif tKey и ctrlKey класса KeyboardEvent в функции-приемнике события KeyboardEvent. KEY DOWN. Например, следующее простое приложение определяет нажатие сочетания клавиш Ctrl+S (Command+S на компьютерах Macintosh): package {
Import flash.display.*;
Import flash.events.*;
public class CtrlSSensor extends Sprite { public static const S_KEY:1nt = 83;
public function CtrlSSensor ( ) {
stage.addEventLIstener(KeyboardEvent.KEY_DOWN. keyDownLIstener);
}
private function keyDowntlstener (e;KeyboardEvent):vo1d {
if (e.keyCode == CtrlSSensor.S KEY
&& e.Ctrl Key = true) {
trace("Ctrl+S was pressed");
В автономной версии приложения Flash Player и в его версии, реализованной в виде модуля расширения браузера, среда выполнения не может определить нажатие клавиши Alt (и клавиши F10).
Чтобы определить одновременное нажатие двух или более обычных клавиш, не являющихся Shift и Ctrl, мы должны вручную отслеживать текущее состояние каждой клавиши. Эту методику демонстрирует следующий код. В нем приложение отображает отладочное сообщение, когда происходит одновременное нажатие клавиш <— и Т. Подобный код может использоваться для поворота автомобиля или для перемещения по диагонали космического корабля в компьютерной игре.
package {
import flash.display.*;
import flash.events.*;
import flash.ui.*;
// Определяет одновременное нажатие клавиш «стрелка вверх» и «стрелка влево» public class UpLeftSensor extends Sprite {
// Отслеживает состояние стрелки «вверх»
// (true, когда нажата; false в противном случае)
private var upPressed;Boolean;
// Отслеживает состояние стрелки «влево»
// (true, когда нажата; false в противном случае)
private var leftPressed:Boolean;
public function UpLeftSensor ( ) {
//'Регистрируем приемники для событий клавиатуры
stage.addEventListener(KeyboardEvent.KEY_DOWN. keyDownLi stener);
stage.addEventListener(KeyboardEvent.KEY_UP. keyUpListener);
// Обрабатывает события KeyboardEvent.KEY_DOWN
private function keyDownListener (e:KeyboardEvent):void {
// Делаем пометку, была ли нажата клавиша «стрелка вверх» или «стрелка влево» if (e.keyCode == Keyboard.UP) {
upPressed = true;
} else if (e.keyCode == Keyboard.LEFT) { leftPressed = true;
}
// Если клавиши «стрелка вверх» и «стрелка влево» были нажаты одновременно...
if (upPressed && leftPressed) {
// ...выполняем определенное действие, например поворачиваем
// космический корабль по диагонали вверх и влево
traceCUp Arrow key and Left Arrow key are both pressed");
}•
}
// Обрабатывает события KeyboardEvent.KEY_UP
private function keyUpListener (e:KeyboardEvent):void {
// Делаем пометку, была ли отпущена клавиша «стрелка вверх»
// или «стрелка влево»
if (е.keyCode == Keyboard.UP) {
upPressed = false;
} else if (e.keyCode == Keyboard.LEFT) { leftPressed = false:
}
}
}
События мыши и клавиши-модификаторы
Подобно тому как язык ActionScript позволяет легко проверить, были ли нажаты клавиши Shift или Ctrl в процессе диспетчеризации события ввода с клавиатуры, он также дает возможность узнать, были ли нажаты клавиши Shift или Ctrl в процессе диспетчеризации события ввода с помощью мыши. Для этого внутри функции- приемника, зарегистрированной для данного события, используются переменные экземпляра shif tKey и ctrlKey класса MouseEvent. Например, следующий код выводит отладочное сообщение, когда происходит щелчок кнопкой мыши при нажатой клавише Shift. Подобный код может быть использован в программе рисования для ограничения перемещения объекта по горизонтальной или вертикальной оси. package {
Import flash.display
Import flash.events.*;
public class ControlClickSensor extends Sprite {
public function ControlClickSensor ( ) {
stage.addEventListener(MouseEvent.CLICK, clickListener);
}
private function clickListener (e;MouseEvent):void {
if (e.shiftKey) {
trace("Shift+click detected");
}
}
}
Определение символа, связанного с клавишей
Ранее рассказывалось, как можно определить код последней нажатой или отпущенной клавиши. Чтобы получить фактический символ, связанный с последней
нажатой или отпущенной клавишей, мы проверяем значение переменной экземпляра charCode класса KeyboardEvent внутри функции-приемника события KeyboardEvent. KEY_UP или KeyboardEvent. KEY_DOWN.
Когда используется клавиатура с раскладкой U.S. English, значение переменной charCode представляет код символа из таблицы ASCII, который логически соответствует последней нажатой или отпущенной клавише. В некоторых случаях для одной и той же клавиши переменная charCode может принимать два возможных значения в зависимости от того, была ли нажата клавиша Shift. Например, код символа для клавиши S на клавиатуре с раскладкой U.S. English соответствует значению 115 при отпущенной клавише Shift и значению 83 при нажатой клавише Shift. Для клавиш, у которых нет соответствующих отображаемых символов в таблице ASCII, переменной KeyboardEvent. charCode устанавливается значение 0.
Когда используется клавиатура с другой раскладкой, отличной от раскладки U.S. English, значение переменной charCode представляет код символа в таблице ASCII для эквивалентной клавиши на клавиатуре с раскладкой U.S. English. Например, на японской клавиатуре для клавиши с иероглифом "^, которая находится в той же позиции, что и клавиша А на клавиатуре с раскладкой U.S. English, переменная charCode будет по-прежнему возвращать либо значение 97, либо значение 65 (символы «а» и «А» из таблицы ASCII соответственно), но не значение 12 385 (кодовая точка Unicode для иероглифа 15).
Чтобы преобразовать код символа в фактическую строку, используется метод экземпляра f romCharCode ( ) класса String. Эта методика продемонстрирована в листинге 22.12 — измененный класс Keyviewer (который был представлен ранее в листинге 22.11) отображает символ, связанный с последней нажатой клавишей.
Листинг 22.12. Получение кода клавиши и кода символа нажатой клавиши package {
Import fl ash.display.*:
Import flash.events.*:
Import fl ash.text.*:
Import flash.u1.*: •
// Отображает код клавиши и код символа для любой нажатой клавиши
public class KeyVIewer extends Sprite {
private var keyoutput:TextF1eld:
public function KeyVIewer ( ) {
keyoutput = new TextF1eld( );
keyoutput.text = "Press any key...";
keyoutput.autoSize = TextF1eldAutoS1ze.LEFT:
keyoutput.border = true:
keyoutput.background = true:
addChi'ld(keyoutput) :
stage.addEventLIstener(KeyboardEvent.KEY_DOWN. keyDownLIstener);
private function keyDownLIstener (e:KeyboardEvent):void { keyoutput.text = "The key code for the key you pressed 1s: "
+ е.keyCode + "\п";
keyoutput.appendText("The character code for the key you pressed is: "
+ e.charCode + "\n"):
keyoutput.appendTextt"The character for the key you pressed is: "
+ String.fromCharCode(e.charCode)):
}
Результат выполнения приложения KeyViewer из листинга 22.12 для нажатой клавиши S на клавиатуре с раскладкой U.S. English выглядит следующим образом:
The key code for the key you pressed is: 83
The character code for the key you pressed is: 115
The character for the key you pressed is: s
Результат выполнения приложения KeyViewer из листинга 22.12 для нажатой клавиши Shift в сочетании с клавишей S на клавиатуре с раскладкой U.S. English выглядит следующим образом:
The key code for the key you pressed is: 83
The character code for the key you pressed is: 83
The character for the key you pressed is: S
Как и в случае с переменной экземпляра keyCode класса KeyboardEvent, переменная charCode не поддерживается, если используется редактор методов ввода, и не предназначена для использования в качестве средства получения вводимых текстовых данных. Для получения вводимых текстовых данных применяется событие TextEvent. TEXT INPUT совместно с объектом TextField, которые рассматриваются в следующем разделе.
События текстового овода
Приложение Flash Player выполняет диспетчеризацию событий текстового ввода в следующих ситуациях:
когда пользователь добавляет новый текст в поле;
когда пользователь активизирует гипертекстовую ссылку протокола event: в поле (щелкая кнопкой мыши на этой ссылке);
когда происходит прокрутка текстового поля либо программным путем, либо пользователем.
В табл. 22.4 перечислены типы внутренних событий текстового ввода приложения Flash Player. Для каждого типа события столбец «Тип события» содержит константу класса, представляющую официальное строковое название типа события. В столбце «Описание» указывается конкретное действие пользователя, приводящее к возникновению этого события. Столбец «Получатель» описывает объект, который выступает в роли получателя события при его диспетчеризации. В столбце «Поведение по умолчанию» приводится стандартная реакция приложения Flash Player на данное событие. Столбец «Всплывает» содержит информацию о том,
имеет ли данное событие фазу всплытия. Наконец, столбец «Тип данных объекта, передаваемого в функцию-приемник» определяет тип данных объекта, передаваемого в функцию-приемник, обрабатывающую данное событие.
Таблица 22.4. События текстового ввода приложения Flash Player
Тип события
Описание
Получатель
Поведение по умолчанию
Всплывает
Тип данных объекта, передаваемого в функцию- приемник
TextEvent.
TEXTJNPUT
Пользователь попытался добавить новый текст в поле
Объект TextField, в который пользователь попытался добавить новый текст
Текст добавляется в поле. Данное поведение по умолчанию может быть отменено методом экземпляра preventDefault() класса Event
Да
TextEvent
Event.
CHANGE
Новый текст был добавлен пользователем в поле
Объект TextField, в который был добавлен новый текст
Отсутствует
Да
Event
Event.
SCROLL
Произошла прокрутка поля либо программным путем, либо пользователем
Объект TextField, в котором произошла прокрутка
Отсутствует
Нет
Event
TextEvent. LINK
Активизирована гипертекстовая ссылка протокола event:
Объект TextField, содержащий активизированную ссылку
Отсутствует
Да
TextEvent
Подобно событиям мыши, клавиатуры и фокуса, событие текстового ввода может обрабатываться приемниками, зарегистрированными в получателе события или в любом отображаемом предке данного получателя. Тем не менее в следующих разделах мы сосредоточимся только на использовании приемников, зарегистрированных в получателе события.
Поближе познакомимся с четырьмя событиями, представленными в табл. 22.4.
События TextEvent.TEXT_INPUT и Event.CHANGE
События TextEvent. TEXT_INPUT и Event. CHANGE позволяют определить новый введенный пользователем текст. В частности, эти события могут возникать в результате использования таких методик, предназначенных для ввода текста, как:
нажатие клавиши;
вставка текста с помощью специальных сочетаний клавиш или встроенного контекстного меню приложения Flash Player (открываемого щелчком вспомогательной (правой) кнопки мыши);
ввод текста через программное обеспечение для распознавания речи; .
создание текстового содержимого в редакторе методов ввода.
Событие TextEvent. TEXT_INPUT сообщает о том, что пользователь пытается добавить новый текст в поле, и дает приложению возможность либо пресечь эту попытку, либо разрешить ее. Это событие предоставляет удобный способ для обращения к текстовому содержимому, добавляемому в текстовое поле, до того как оно на самом деле будет добавлено туда. В отличие от этого, событие Event. CHANGE сообщает о том, что попытка пользователя добавить новый текст в поле завершилась успешно и приложение Flash Player соответствующим образом обновило содержимое данного текстового поля.'
Обобщенный код, необходимый для регистрации приемника в объекте TextField для события TextEvent. TEXT_INPUT, выглядит следующим образом:
объектТех1Р1еId.addEventListener(TextEvent.TEXT_INPUT, textlnputLIstener);
Обобщенный код для приемника события TextEvent. TEXT_INPUT выглядит следующим образом:
private function text Input Listener (e:TextEvent):void { }
Чтобы предотвратить отображение введенного пользователем текста в объекте TextField, используется метод экземпляра pre vent De fault ( ) класса Event, как показано в следующем коде: ■
private function textlnputLIstener (e:TextEvent):void {
// Предотвращаем отображение введенного пользователем текста на экране e.preventDefault( );
}
Для обращения к тексту, введенному пользователем, применяется переменная экземпляра text класса TextEvent, как показано в следующем коде:
private function textlnputLIstener (e:TextEvent):void {
// Выводим отладочное сообщение, содержащее введенный пользователем текст trace(е.text);
}
Событие TextEvent. TEXT INPUT может быть использовано для автоматического форматирования вводимых пользователем данных при заполнении анкет в приложении, как показано в листинге 22.13. В этом примере весь текст, введенный в поле, преобразуется в верхний регистр. Подобный код может быть использован в разделе «адрес доставки» формы, с помощью которой оформляется заказ товара через Интернет.
Листинг 22.13. Преобразование введенного пользователем текста в верхний регистр package {
Import flash.display.*;
Import fl ash.events.*;
Import fl ash.text.*;
public class UppercaseConverter extends Sprite {
private var 1nputf1 eld:TextF1eld:
public function UppercaseConverter ( ) {
1nputf1eld = new TextF1eld( );
1nputf1eld.text = "";
Inputfield.width = 150;
1nputf1eld.height = 30;
1nputf1 eld.border= true;
1nputf1eld.background = true;
1nputf1 eld.type = TextFIeldType.INPUT; addChl1d(1nputf1 eld);
// Регистрируем приемник в объекте 1nputf1eld
// для событий TextEvent.TEXT_INPUT
nputf 1 eld.addEventLIstener(TextEvent.TEXT_INPUT, textlnputLIstener);
}-
// Вызывается всякий раз, когда пользователь пытается добавить новый
// текст в объект 1nputf1eld
private function textlnputLIstener (e:TextEvent);void { .
// Предотвращаем добавление введенного пользователем текста
// в поле•
е.preventDefault( );
// Добавляем в поле эквивалентный символ верхнего регистра
1nputf1 eld.replaceText(1nputf1 eld.caret Index,
1nputf1 eld.caretindex, e.text.toUpperCase( ));
// Устанавливаем точку ввода (знак вставки) в конец нового текста, // чтобы пользователь думал, что это он ввел данный текст var newCaretIndex:1nt = 1nputf1eld.caretindex + e.text.length;
inputfield.setSelect1on(newCaretIndex, newCaretlndex);
}
Теперь перейдем к событию Event. CHANGE. Обобщенный код, необходимый для регистрации приемника в объекте TextField для события Event. CHANGE, выглядит следующим образом:
o6beKTTextF1eld.addEventLIstener(Event.CHANGE, changelistener);
Обобщенный код для приемника события Event. CHANGE выглядит таким образом:
private function changeLIstener (e:Event):void { }
Событие Event. CHANGE может быть использовано для синхронизации содержимого двух текстовых полей, как показано в листинге 22.14. Здесь представлен фрагмент из гипотетического элемента управления «панель», содержащего помеченные фотографии. Для простоты код из листинга позволяет добавлять только метку фотографии без соответствующего изображения. В коде событие Event. CHANGE применяется для обновления строки заголовка панели в соответствии с названием текущей выбранной фотографии. Для обзора в этом коде также используются события FocusEvent. FOCUS_IN и FocusEvent. FOCUS_OUT, чтобы обновлять заголовок панели, когда пользователь меняет фокус в приложении.
Листинг 22.14. Синхронизация двух объектов TextField
package {
import flash.display
Import flash.events.*;
Import fl ash.text.*;
public class PhotoPanel extends Sprite {
private static const defaultT1tle:Str1ng =
"Photo Viewer [No photo selected]";
private static const defaultPhotoName:Str1ng =
"Enter Photo Name Here";
private var t1tle:TextF1eld;
private var photoname:TextField;
public function PhotoPanel ( ) {
// Создаем объект TextField для строки заголовка панели
title = new TextF1eld( );’
title.text = PhotoPanel.defaultTItle;
title.width = 350;
title.height = 25;
title.border = true;
title.background = true;
title.selectable = false;
addChlld(title);
// Создаем объект TextField для заголовка отдельной фотографии photoname = new TextF1eld( );
photoname.text = PhotoPanel.defaultPhotoName;
photoname.width =150;’
photoname.height = 30;
photoname.x = 100;
photoname.у = 150;
photoname.border = true;
photoname.background = true;
photoname.type = TextFleldType.INPUT addChlld(photoname);
// Регистрируем приемник в объекте photoname
// для событий Event.CHANGE
photoname.addEventLIstener(Event.CHANGE. changed stener);
// Регистрируем приемники в объекте photoname для событий получения
// и потери фокуса
photoname.addEventLIstener(FocusEvent.FOCUS_IN, photoFocus In L1stener); photoname.addEventLI stener(FocusEvent.FOCUS_OUT,
photoFocusOutLIstener);
// Регистрируем приемник в объекте stage
// для событий потери фокуса
stage.addEventLIstener(FocusEvent.FOCUS_OUT, panelFocusOutLIstener);
// Вызывается всякий раз при добавлении
// нового текста в объект photoname
private function changeLlstener (e;Event);vo1d {
// Название фотографии изменилось, поэтому обновляем строку заголовка,
// чтобы ее содержимое соответствовало тексту объекта photoname
1f (photoname.text.length == 0) {
title.text = "Photo Viewer [Unnamed Photo]";
} else { title.text = "Photo Viewer [" + photoname.text + "]";
// Вызывается всякий раз при получении фокуса объектом photoname
private function photoFocusIntlstener (e:FocusEvent);vo1d {
// Если для фотографии еще не было указано название...
1f (photoname.text == PhotoPanel.defaultPhotoName) {
// ...очищаем поле photoname, чтобы пользователь мог ввести название photoname.text = "";
// Обновляем строку заголовка панели, чтобы показать, что была
// выбрана фотография без названия
title.text = "Photo Viewer [Unnamed Photo]";
} else {
// ...выбранной фотографии уже присвоено название, поэтому обновляем
// строку заголовка панели, чтобы отобразить это название title.text = "Photo Viewer [" + photoname.text + "]";
} }
// Вызывается всякий раз, когда объект photoname теряет фокус
private function photoFocusOutLIstener (e:FocusEvent):vo1d {
// Если пользователь не ввел название для фотографии...
1f (photoname.text.length == 0) {
// ...присваиваем названию фотографии значение по умолчанию photoname.text = PhotoPanel.defaultPhotoName;
// Вызывается всякий раз, когда фокус теряет любой объект
private function panelFocusOutLIstener (e;FocusEvent);vo1d {
// Если на настоящий момент ни один объект не имеет фокуса...
1f (е.relatedObject == null) {
// ...присваиваем строке заголовка панели значение по умолчанию title.text = PhotoPanel .defaultTi'tle;
}
}
}
Событие EventSCROLL
Событие Event. SCROLL возникает всякий раз, когда изменяется значение любой из следующих переменных объекта TextField: scrollH, scrollV,maxscrollH
или maxscrollV. Другими словами, событие Event. SCROLL сообщает об одном из следующих изменений в текстовом поле:
произошла прокрутка поля по вертикали или по горизонтали (либо пользователем, либо программным путем с помощью переменных scrollH или scrollV);
поле получило новое содержимое, которое изменяет максимальный диапазон для вертикальной или горизонтальной прокрутки;
изменение размеров поля привело к изменению максимального диапазона для вертикальной или горизонтальной прокрутки поля.
Обобщенный код, необходимый для регистрации приемника в объекте TextField для события Event. SCROLL, выглядит следующим образом:
oObeKiTextFieId.addEventLIstener(Event.SCROLL, scro11 Listener);
Обобщенный код для приемника события Event. SCROLL выглядит следующим образом:*
private function scroll Listener (e: Event):void {
Обычно событие Event. SCROLL применяется для синхронизации интерфейса полосы прокрутки с содержимым поля, как показано в листинге 22.15. Полоса прокрутки в этом листинге обладает следующими возможностями:
может применяться к любому объекту TextField;
может перетаскиваться с помощью мыши для прокрутки поля по вертикали;
□ автоматически обновляется в ответ на изменения в размерах поля, его содержимого или позиции прокрутки.
Тем не менее для простоты данная полоса прокрутки не включает кнопки для прокручивания содержимого вниз и вверх. В листинге 22.15 применяются многие методики, которые были рассмотрены в этой главе, а также несколько еще не описанных методик. Там, где это необходимо, указаны перекрестные ссылки на дополнительные темы.
Листинг 22.15. Использование события Event.SCROLL для реализации полосы прокрутки package {
Import flash.display.*:
Import flash.text.*:
Import fl ash.events.*:
Import flash.utils.*:
Import flash.geom.*;
// Простая полоса прокрутки с возможностью перетаскивания, которая
// автоматически обновляется в ответ на изменения в размерах заданного // текстового поля.
// Использование:
// var theTextFIeld:TextF1eld = new TextF1eld( );
// someContalner.addCh11d(theText F1eld):
// var scrollbar:ScrollBar = new ScrollBar(theTextFleld):
// someContal ner.addCh11d(scrol1 bar);
public class ScrollBar extends Sprite {
// Текстовое поле, к которому применяется данная полоса прокрутки
private var t:TextF1eld;
// Текущая высота текстового поля. Если высота текстового поля
// изменяется, мы обновляем высоту данной полосы прокрутки.
private var tHelght: Number;,
// Фоновое изображение для полосы прокрутки
private var scrolITrack:Spr1te;
// Перетаскиваемый ползунок полосы прокрутки
private var scrol1 Thumb:Sprite;
// Ширина полосы прокрутки
private var scrollbarW1dth:1nt = 15;
// Минимальная высота ползунка полосы прокрутки
private var m1n1mumThumbHe1ght:1nt = 10;
// Флажок, который обозначает, перетаскивает ли пользователь ползунок
// в данный момент
private var dragging;Boolean = false:
// Флажок, который обозначает, нужно ли перерисовывать полосу прокрутки
// на следующем запланированном этапе обновления экрана private var changed:Boolean = false;
// Конструктор.
// Oparam textfleld Объект TextFleld, к которому применяется данная
//полоса прокрутки.
public function ScrollBar (textf1eld:TextF1eld) {
// Сохраняем ссылку на объект TextFleld, к которому применяется данная
// полоса прокрутки t = textfleld;
// Запоминаем высоту текстового поля, чтобы мы могли отслеживать
// изменения, требующие перерисовки полосы прокрутки.
Х\\елМ = Т .Х\^лМ'.
// Создаем фон полосы прокрутки
scrolITrack = new Spr1te( );
scrolITrack.graphlcs.l1neStyle( );
scrolITrack.graphics.beg1nF111(0x333333);
scrollTrack.graph1cs.drawRect(0, 0, 1, 1);
addChl1d(scrol1 Track);
// Создаем перетаскиваемый ползунок на полосе прокрутки
scrolIThumb = new SpriteC );
scroll Thumb, graphl cs.HneStyle( );
scrol IThumb.graphlcs.beg1nF111(OxAAAAAA);
scrollThumb.graph1cs.drawRect(0, 0, 1, 1);
addChl1d(scrol1 Thumb);
// Регистрируем приемник события Event.SCROLL, который будет обновлять И полосу прокрутки в соответствии с текущей позицией прокрутки поля t.addEventListener(Event.SCROLL, scrollListener);
// Регистрируем в объекте scrolIThumb приемник для событий нажатия
// кнопки мыши, который будет вызывать перетаскивание ползунка
scrol1 Thumb.addEventListener(MouseEvent.MOUSE_DOWN,mouseDownLIstener):
// Регистрируем приемник для получения уведомлений, когда данный // объект добавляется в список отображения или удаляется из него // (требуется пользовательский вспомогательный класс StageDetector). // Когда данный объект добавляется в список отображения, регистрируем // приемники для событий перемещения мыши и отпускания кнопки мыши // на уровне объекта stage, которые будут управлять операцией // перетаскивания ползунка.
var StageDetector:StageDetector = new StageDetector(this): StageDetector.addEventLi stener(StageDetector.ADDED_TO_STAGE, addedToStageListener);
StageDetector.addEventListener(StageDetector.REMOVED_FROM_STAGE, removedFromStageLlstener);
// Регистрируем приемник для получения уведомлений перед каждым
// обновлением экрана. Перед обновлением экрана проверяем,
// требуется ли перерисовка полосы прокрутки. Информацию по событию // Event.ENTER_FRAME можно найти в гл. 24.
addEventListener(Event.ENTER_FRAME, enterFrameListener);
// Инициируем первоначальную прорисовку полосы прокрутки, changed = true;
// Выполняется всякий раз, когда данный объект добавляется
// в список отображения
private function addedToStagetistener (e:Event):void {
// Регистрируем приемники для «глобальных» событий перемещения мыши // и отпускания кнопки мыши
stage.addEventListener(MouseEvent.MOUSE_UP, mousellpListener);
stage.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveListener);
}
// Выполняется всякий раз. когда данный объект удаляется
// из списка отображения
private function removedFromStageLlstener (e:Event):void {
// Отменяем регистрацию приемников для «глобальных» событий
// перемещения мыши и отпускания кнопки мыши
stage.removeEventListener(MouseEvent.MOUSE_UP, mousellpListener);
stage.removeEventListener(MouseEvent.MOUSE_MOVE, mouseMoveListener);
// Выполняется один раз для каждого обновления экрана. Этот метод // проверяет, произошли ли какие-либо изменения в позиции прокрутки // текстового поля, его содержимом или размерах с момента последней // перерисовки полосы прокрутки. Если да, то перерисовываем полосу // прокрутки. Выполняя эту проверку - «рисовать или нет» - всего один // раз перед обновлением экрана, мы избавляемся от ненужных вызовов // метода updateScrol1Ьаг( ), а также избегаем проблем в приложении // Flash Player, связанных с задержкой при изменении значения переменной // TextField.maxScrol 1V.
private function enterFrameListener (e:Event):void {
// Если высота поля изменилась, запрашиваем перерисовку
// полосы прокрутки
if (t.height != tHeight) {
changed = true;
tHeight = t.height;
// Высота изменилась, поэтому прекращаем любую происходящую // в настоящий момент операцию перетаскивания. Пользователь // будет вынужден щелкнуть снова, чтобы начать операцию // перетаскивания ползунка после перерисовки
// полосы прокрутки.
if (dragging) {•
scroll Thumb.stopDrag( );
dragging = false;
// Если требуется перерисовка полосы прокрутки...
if (changed) {
// ...вызываем процедуру отрисовки полосы прокрутки updateScrol1 bar( );
changed = false;
// Обрабатывает события Event.SCROLL
private function scrollListener (e;Event);void {
// В определенных случаях, когда строки удаляются из текстового поля, // приложение Flash Player выполняет диспетчеризацию двух событий: // одно событие связано с уменьшением значения переменной maxScrol1V // (диспетчеризация осуществляется немедленно), а другое -
// с уменьшением значения переменной scrollV (диспетчеризация
// осуществляется спустя несколько обновлений экрана). В подобных
// ситуациях переменная scrollV некоторое время имеет неправильное
// значение, которое превышает значение переменной maxScrolIV.
// В качестве обходного пути мы игнорируем событие, возникающее
// после изменения значения переменной maxScrollV, и ожидаем
// появления события, возникающего в результате изменения значения
// переменной scrollV (в противном случае отрисованная полоса
// прокрутки некоторое время не будет соответствовать фактическому
// содержимому поля).
if (t.scrollV > t.maxScrollV) {
return;
// Если на данный момент пользователь не перетаскивал ползунок полосы // прокрутки, помечаем, что данная полоса прокрутки должна быть // перерисована на следующем запланированном этапе обновления экрана. // (Если в данный момент пользователь перетаскивает ползунок, // изменение прокрутки, вызвавшее данное событие, явилось результатом // перетаскивания ползунка в новую позицию, поэтому обновлять полосу // прокрутки не нужно, поскольку ползунок уже находится в правильной // позиции.) if (!dragging) {
changed = true;
}
// Устанавливает размеры и позицию фонового изображения и ползунка
// полосы прокрутки в соответствии с размерами и содержимым связанного
// текстового поля. Информацию о переменных scrolIV, maxScrol1V
// и bottomScrollV класса TextField можно найти в справочнике
// по языку ActlonScript корпорации Adobe.
public function updateScrollbar ( );void {
// Устанавливаем размеры и позицию фонового изображения полосы прокрутки.
// Данный код всегда помещает полосу прокрутки справа от поля.
scrollTrack.x = t.x + t.width;
scrollTrack.y = t.y;
scrolITrack.height = t.height;
scrollTrack.width = scrollbarWidth; *
// Проверяем количество видимых на экране строк текстового поля
var numVisi bletines:int = t.bottomScrollV - (t.scrollV-1);
// Если часть строк в текстовом поле не видна на экране...
if (numVisi bletines < t.numLines) {
// ...отображаем ползунок
scrollThumb.visible = true;
// Теперь устанавливаем размеры ползунка
// Высота ползунка определяется процентным соотношением
// отображаемых строк, умноженным на высоту текстового поля
var thumbHeight:int = Math.floor(t.height *
(numVisi bletines/t.numLi nes));
// Высота ползунка не должна быть меньше значения minimumThumbHeight scrollThumb.height = Math.max(minimumThumbHeight, thumbHeight);
scroll Thumb.width = scrollbarWidth;
// Теперь устанавливаем позицию ползунка scrollThumb.х = t.x + t.width;
// Вертикальная позиция ползунка определяется количеством
// прокрученных строк в поле, выраженным в процентах и умноженным
// на высоту «пространства полосы» (это высота
// полосы прокрутки за вычетом высоты ползунка).
scrollThumb.у = t.y + (scrolITrack.height-scrolIThumb.height)
* ((t. scrol lV-l)/(t. maxScrol 1V-D);
} else { •
// Если в данный момент на экране отображаются все строки текстового
// поля, прячем ползунок полосы прокрутки scrolIThumb.visible = false;
// Устанавливает вертикальную позицию прокрутки текстового поля
// в соответствии с относительной позицией ползунка
public function synchTextToScrolIThumb ( ):void {
var scrolIThumbMaxY;Number = t.height-scrollThumb.height;
var scrolIThumbY:Number = scrollThumb.y-t.y;
t.scrollV = Math.round(t.maxScrol 1V
* (scrollThumbY/scrollThumbMaxY));
// Выполняется, когда пользователь нажимает основную кнопку мыши
// над ползунком
private function mouseDowntistener (e:MouseEvent):void {
// Начинаем операцию перетаскивания ползунка. (Метод startDrag( )
// наследуется из класса Sprite.)
var bounds:Rectangle = new Rectangle(t.x + t.width, t.y.
0,
t.height-scrol1 Thumb.height);
scrollThumb.startDrag(false, bounds);
dragging = true:
// Выполняется, когда пользователь отпускает основную кнопку мыши
// (в любом месте области отображения приложения Flash Player и даже
// за ее пределами)
private function mousellpLIstener (e:MouseEvent):void {
// Если пользователь перетащил ползунок, обновляем вертикальную
// позицию прокрутки поля, после чего прекращаем операцию
// перетаскивания ползунка
if (dragging) {
synchTextToScrollThumb( );
scrollThumb.stopDrag( ): dragging = false;
// Выполняется при перемещении указателя мыши (над областью отображения
// приложения Flash Player)
private function mouseMoveListener (e:MouseEvent):void {
// Если пользователь перетаскивает ползунок, устанавливаем
// вертикальную позицию прокрутки в соответствии с относительной
// позицией ползунка
if (dragging) { synchTextToScrollThumb( ):
}
}
}
В листинге 22.16 представлен простой тестовый класс, который демонстрирует использование класса 5сго11Вагиз листинга 22.15.
Листинг 22.16. Демонстрационный класс, представляющий использование класса ScrollBar
package {
import fl ash.di splay.*;
import fl ash.text.*;
import fl ash.events.*;
import fl ash.utils.*;
// Демонстрирует использование класса Scroll Ваг
public class ScrollBarDemo extends Sprite {
public function ScrollBarDemo ( ) {
// Создаем объект TextFleld
var 1nputf1eld;TextF1eld = new TextF1eld( );
// Заполняем текстовое поле начальным содержимым
1nputf1eld.text = "1\п2\пЗ\п4\п5\п6\п7\п8\п9";
1nputf1eld.height = 50;
1nputf1 eld.width = 100;
1nputf1 eld.border = true;
1nputf1 eld.background = true;
1nputf1 eld.type = TextFleldType.INPUT;
1nputf1 eld.multil 1 ne = true;
addChi'l d( 1 nputf 1 el d);
// Создаем полосу прокрутки и связываем ее
// с объектом TextFleld
var scrol 1 bar:Scrol 1 Bar = new ScrollBardnputfleld);
addChl1d(scrol1 bar);
Событие TextEvent.LINK
Событие Text Event. LINK применяется для вызова кода на языке ActionScript, когда пользователь щелкает кнопкой мыши на гипертекстовой ссылке в объекте TextField. Это событие возникает в тех случаях, когда пользователь щелкает кнопкой мыши на гипертекстовой ссылке, адрес URL которой начинается с псевдопротокола event.
Введение в использование гипертекстовых ссылок в текстовых полях языка ActionScript можно найти в гл. 27.
Обобщенный код, необходимый для создания гипертекстовой ссылки, которая вызывает код на языке ActionScript, выглядит следующим образом:
обьекгГех№е 7of.html Text = "<а hre^='^еп^содержимоеСсылки'>текстСсылки</д>и;
В предыдущем коде odbeKTlextField — это объект TextField, содержащий ссылку, а текстСсылки — текст, который отображается на экране и на котором щелкает кнопкой мыши пользователь. Когда пользователь щелкает кнопкой мыши на тексте текстСсылки, приложение Flash Player выполняет все приемники, зарегистрированные в объекте odbeKTTextField или в его отображаемых предках для события TextEvent. LINK. В каждый приемник передается объект TextEvent, значением переменной text которого является указанная строка содержимоеСсылки. Эта строка обычно обозначает операцию языка ActionScript, которая должна быть выполнена при щелчке кнопкой мыши на ссылке.
Обобщенный код, необходимый для регистрации приемника в объекте TextField для события TextEvent. LINK, выглядит следующим образом:
odbeKrTextFie/c/.addEventLIstenerdextEvent.LINK. приемник);
Обобщенный код для приемника события TextEvent. LINK выглядит следующим образом:
private function приемник (e:TextEvent):vo1d {
}
Используя приведенный обобщенный код в качестве подсказки, создадим пример гипертекстовой ссылки, которая запускает игру, когда пользователь щелкает на ней кнопкой мыши. Вот код для этой ссылки: обратите внимание, что задаваемая строка содержимоеСсылки обозначает название операции, вызываемой этой ссылкой: startGame.
var t:TextF1eld = new TextField( );
t.htmlText = "<a href='event:startGame'>P1ay now!</a>";
t.autoSize = TextF1eldAutoS1ze.LEFT;
addChlld(t):
Следующий код регистрирует метод linkListener( ) в предыдущем объекте TextField — t — для событий TextEvent. LINK:
t.addEventLIstener(TextEvent.LINK. UnkLIstener);
Наконец, следующий код демонстрирует методlinkListener ( ), который выполняется при щелчке кнопкой мыши на создаваемой ссылке. Внутри метода linkListener ( ) мы выполняем операцию, определенную в задаваемой строке содержимоеСсылки, к которой можно обратиться через переменную экземпляра text класса TextEvent.
private function UnkLIstener (e:TextEvent):void {•
var operatlonName:String = e.text:
if (operatlonName == "startGame") { startGame( ):
}
}
Теперь попытаемся создать гипертекстовую ссылку, которая не просто вызывает операцию на языке ActionScript, но и передает аргументы для этой операции. Код для этой гипертекстовой ссылки представлен ниже. Обратите внимание, что на этот раз задаваемая строка содержимоеСсылки содержит название операции (di splayMsg) и аргумент (hello world), которые отделены друг от друга произвольным разделителем (запятой).
var t:TextF1eld = new TextField( ):
t.htmlText = "<a href='event:d1splayMsg.hell о world'>click here</a>";
t.autoSize = TextFieldAutoSize.LEFT;
addChlld(t):
Следующий код регистрирует метод linkListener ( ) в предыдущем объекте TextField — t — для событий TextEvent. LINK:
t.addEventLIstener(TextEvent.LINK, UnkLIstener);
Наконец, следующий код демонстрирует метод linkListener( ), в котором для отделения названия операции (displayMsg) от аргумента (hello world) применяется метод экземпляра split ( ) класса String.
private function UnkLIstener (e:TextEvent):void {
var HnkContent:Array = e.text.spHtC,");
var operatlonName:String = HnkContent[0];
var argument:String = HnkContent[l];
if (operatlonName == "displayMsg") { dlsplayMsg(argument);
}
В отличие от языка JavaScript, обычный код на языке Actionscript нельзя включить непосредственно в атрибут HREF тега <А>.
В листинге 22.17 продемонстрировано использование события TextEvent. LINK в контексте гипотетического приложения для обмена сообщениями (чата), в котором пользователю предоставляется возможность запросить личную беседу, щелкнув кнопкой мыши на имени любого пользователя в поле приложения. Код, представленный в листинге 22.17, сильно упрощен, чтобы можно было сконцентрировать внимание на применении события TextEvent. LINK; в частности, опущен код, относящийся к реальному получению и отправке сообщений.
Листинг 22.17. Использование события TextEvent.LINK для создания имен пользователей, активизируемых щелчком кнопкой мыши
package {
Import fl ash.display.*;
Import fl ash.text.*;
Import fl ash.events.*;.
// Демонстрирует использование события TextEvent.LINK в примере упрощенного ' // раздела чата с именами пользователей, активизируемыми щелчком кнопкой мыши, public class ChatRoom extends Sprite {
// Текстовое поле, содержащее сообщения чата
private var messages:TextF1eld;
public function ChatRoom ( ) {
// Создаем текстовое поле co ссылками протокола event:
messages = new TextF1eld( );
messages.multi 11 ne = true;
messages.autoSize = TextF1eldAutoS1ze.LEFT;
messages.border = true:
'messages.background = true;
// Создаем тестовые сообщения чата с именами пользователей,
// активизируемыми щелчком кнопкой мыши
messages.htmlText =
"<а href=*event:pr1vateChat,userl'>Andy</a> says: What's up?<br>" + "<a href='event:pr1vateChat,user2’>M1ke</a> says: I'm busy...<br>" + "<a href='event:pr1vateChat,userr>Andy</a> says: Ok see you later"; addChlld(messages);
// Регистрируем приемник в объекте
// TextFleld 'messages' для событий
// TextEvent.LINK
messages.addEventLi stener(TextEvent.LINK, 11nk L1stener);
}
// Выполняется всякий раз, когда пользователь щелкает кнопкой мыши
// на ссылке протокола event: в объекте TextFleld 'messages'
private function UnkLIstener (e:TextEvent):void {
// Содержимое переменной e.text - это вся строка, следующая
// за названием протокола event: в атрибуте href. Например,
// "prlvateChat,userl". Эта строка разбивается
// на название операции ("prlvateChat")
// и соответствующий аргумент ("userl").
var requestedCommand:Array = e.text.spHtC,"):
var operatlonName:String = requestedCommand[0];
var argument .-String = requestedCommand[l];
// Если запрашиваемой операцией•
// является запрос личной беседы,
// то вызываем метод requestPrlvateChat( ).
1f (operatlonName == "prlvateChat") {'
requestPrlvateChat(argument):
}
}
// Отправляет приглашение указанному пользователю на участие
// в личной беседе
private function requestPrlvateChat (userID:Str1ng):void { trace("Now requesting private chat with " + userID): // Код для работы с сетью не показан...
1
События ввода уровня приложения
Flash Player
Как мы уже неоднократно видели на протяжении этой главы, подавляющее большинство событий ввода приложения Flash Player возникает в результате взаимодействия пользователя с определенными объектами в списке отображения. Тем не менее Flash Player также поддерживает небольшой набор событий, которые возникают в результате взаимодействия пользователя с самим приложением. Мы будем называть такие «события приложения» событиями ввода уровня приложения Flash Player. Диспетчеризация событий ввода уровня Flash Player выполняется в следующих ситуациях, когда:
изменяются размеры области отображения приложения Flash Player;
происходит перемещение указателя мыши над областью отображения Flash Player;
приложение получает или теряет фокус операционной системы (автономная версия Flash Player получает системный фокус, когда фокус устанавливается на окно приложения; версия Flash Player, реализованная в виде модуля расширения браузера, получает системный фокус, когда пользователь щелкает кнопкой мыши на области отображения приложения или, если такая возможность поддерживается, когда пользователь переходит на внедренный объект приложения с помощью клавиатуры).•
В табл. 22.5 перечислены типы событий ввода уровня приложения Flash Player. Для каждого типа события столбец «Тип события» содержит константу класса Event, представляющую официальное строковое название типа события. В столбце «Описание» указано конкретное действие пользователя, приводящее к возникновению этого события. Столбец «Получатель» описывает объект, который выступает в роли получателя события при его диспетчеризации. Столбец «Поведение по умолчанию» описывает стандартную реакцию приложения Flash Player на данное событие (у типов событий ввода уровня приложения Flash Player отсутствует поведение по умолчанию). Столбец «Всплывает» содержит информацию о том, имеет ли данное событие фазу всплытия. Столбец «Тип данных объекта, передаваемого в функцию- приемник» определяет тип данных объекта, передаваемого в функцию-приемник, обрабатывающую данное событие. Наконец, столбец «Примечание» содержит важную информацию, касающуюся использования этого события.
Таблица 22.5. События ввода уровня приложения Flash Player
Тип события
Описание
Получатель
Поведение по умолчанию
Всплывает
Тип данных объекта, передаваемого в функцию-приемник
Примечание
Event. ACTIVATE
Приложение Flash Player получило системный фокус
Отображаемый объект, в котором зарегистрирован приемник события
Отсутствует
Да
Event
Возникает даже в тех случаях, когда получатель не находится в списке отображения
Event. DEACTI
VATE
Приложение Flash Player потеряло системный фокус
Отображаемый объект, в котором зарегистрирован приемник события
Отсутствует
Да
Event
Возникает даже в тех случаях, когда получатель не находится в списке отображения
Event. RESIZE
Изменились размеры области отображения приложения
Экземпляр класса Stage
Отсутствует
Да
Event
Продолжение ^
Таблица 22.5 (продолжение)
Тип события
Описание
Получатель
Поведение по умолчанию
Всплывает
Тип данных объекта, передаваемого в функцию-приемник
Примечание
Event.
MOUSE, LEAVE
Указатель мыши переместился за пределы области отображения приложения
Экземпляр класса Stage
Отсутствует
Да
Event
Сопутствующее событие Event. MOUSE_ENTER отсутствует. Используйте событие MouseEvent. MOUSE_MOVE, чтобы определить, когда указатель мыши вновь появится в пределах области отображения Flash Player
Поближе познакомимся с четырьмя событиями, представленными в табл. 22.5.
события EvenUCTIVATE И EvenLDEACTIVATE
События Event .ACTIVATE и Event. DEACTIVATE обычно применяются для разработки приложений, которые самостоятельно активизируются или деакти- визируются в ответ на получение или потерю фокуса операционной системы проигрывателем Flash Player. Например, в ответ на потерю фокуса проигрывателем приложение может заглушить все звуки, закрыть открытое меню или приостановить воспроизведение анимации.
В отличие от других событий ввода, с которыми мы познакомились в этой главе, события Event. ACTIVATE и Event. DEACTIVATE не имеют фазы захвата и фазы всплытия. Вместо этого события Event .ACTIVATE и Event. DEACTIVATE могут быть обработаны приемниками, зарегистрированными в любом экземпляре любого класса, унаследованного от класса EventDispatcher (примечание: не только классов, унаследованных от класса Displayobject). Более того, когда функция-приемник для событий Event .ACTIVATE и Event. DEACTIVATE зарегистрирована в отображаемом объекте, она вызывается, даже когда данный объект не находится в списке отображения.
В листинге 22.18 демонстрируются основы использования событий Event. ACT IVATE и Event. DEACTIVATE — когда проигрыватель Flash Player получает системный фокус, приложение из листинга начинает воспроизведение анимации «вращающийся прямоугольник», а когда Flash Player теряет системный фокус, воспроизведение анимации останавливается (методики создания анимации будут рассмотрены в гл. 24).
Листинг 22.18. Реагирование на события Event.ACTIVATE и Event.DEACTIVATE package {
Import flash.display.*;
Import flash.utils.*;
Import fl ash.events.*;
public class Spinner extends Sprite {
private var t1mer;T1mer;
private var rect;Sprite;
public function Spinner ( ) {
// Создаем изображение прямоугольника
rect = new Spr1te( );
rect.x = 200;
rect.у = 200;
rect.g ra ph1cs.11neSty1e(1);
rect.graph1cs.beg1nF1ll(OxOOOOFF);
rect.graphics.drawRecttO, 0. 150, 75); addChlld(rect);
// Регистрируем приемник для получения уведомлений,
// когда приложение Flash Player
// получает или теряет системный фокус
addEventLIstener(Event.ACTIVATE, act1vateLIstener); addEventLIstener(Event.DEACTIVATE, deactlvateLIstener);
// Создаем таймер,
// который будет использован для анимации
timer = new T1mer(50, 0)-;
timer.addEventLIstener(TimerEvent.TIMER, timerListener);
}
// Вращает изображение прямоугольника
private function t1merL1stener (e;T1merEvent):void { rect.rotation += 10;
}
// Обрабатывает события Event.ACTIVATE
private function act1vateLIstener (e:Event):vo1d {
// Начинаем вращение изображения прямоугольника timer.start( );
}
// Обрабатывает события Event.DEACTIVATE
private function deactlvateLIstener (e.• Event):void {
// Останавливаем вращение изображения прямоугольника timer.stop( );
}
Событие Event.RESIZE
Событие Event .RESIZE обычно используется при разработке приложений с «растягивающимся» содержимым, когда размеры элементов интерфейса изменяются автоматически для соответствия доступному пространству в области отображения проигрывателя Flash Player.
Событие Event. RESIZE возникает тогда, когда переменной scaleMode экземпляра класса Stage Flash Player присвоено значение StageScaleMode .NO_SCALE и происходит изменение размеров области отображения проигрывателя. Изменение размеров происходит в любом из следующих случаев:
□ изменяются размеры окна автономной версии Flash Player либо пользователем, либо в результате вызова функции fscommand("fullscreen", "true”);
□ пользователь изменяет размеры окна браузера, содержащего SWF-файл, внедренный с применением процентных значений для атрибутов height или width тегов <ОВ JECT> или <EMBED>.
Следующий HTML-код демонстрирует, как можно внедрить SWF-файл с использованием процентных значений для атрибута width тегов <OBJECT> и <EMBED>. Обратите внимание, что для одного измерения задан фиксированный размер в пикселах (height="7 5"), а для другого — размер в процентах (width="100%").
<OBJECT classid="clsid:D27CDB6E-AE6D-llcf-96B8-444553540000"
codebase="http://fpdownload.macromedia.com/get/flashplayer/current/swfl ash.cab" width="100r.
height="75">
<PARAM NAME="movie" VALUE="app.swf">
<EMBED src="app.swf"
width="100r
height="75"
type="application/x-shockwave-fl ash"
plug1nspage="http://www.adobe.com/go/getflashplayer">
</EMBED>
</OBJECT>
Приемники для события Event. RES I ZE должны быть зарегистрированы в экземпляре класса Stage Flash Player, как показано в следующем коде. Обратите внимание, что переменной scaleMode обязательно должно быть присвоено значение StageScaleMode.NO_SCALE.
package {
import flash.display import flash.events.*;
public class ResizeSensor extends Sprite {
public function ResizeSensor ( ) {
stage.seal eMode = StageScaleMode.NO_SCALE:
stage.addEventtistener(Event.RESIZE. resizeListener);
}
private function res1zeL1stener (e;Event):void { traceCFlash Player was resized");
}
}
}
Листинг 22.19 расширяет предыдущий код, показывая, как размещать объект Sprite rect в правом верхнем углу области отображения Flash Player при каждом изменении размеров окна приложения. Обратите внимание, что приложение из листинга вручную вызывает код, осуществляющий исходное размещение объекта, поскольку при первоначальной загрузке SWF-файла в приложение Flash Player событие Event. RESIZE не возникает.
Листинг 22.19. Растягиваемая форма
package {
Import flash.display import flash.events.*;
// Помещает объект Sprite rect в правый верхний угол области отображения
// приложения Flash Player всякий раз при изменении размеров окна
// приложения Flash Player
public class StretchyLayout extends Sprite {
private var rect:Spr1te;
public function StretchyLayout ( ) {
// Создаем изображение прямоугольника и помещаем его
// в список отображения
rect = new Spr1te( );
rect.graph1cs.HneStyle( );
rect.g raph1cs.beg1nF111(OxOOOOFF);
rect.graphics.drawRecttO, 0. 150, 75); addChlld(rect);
// Предотвращаем масштабирование содержимого
stage.seal eMode = StageScaleMode.NO_SCALE;
// Помещаем SWF-файл в левый верхний угол области отображения
// приложения Flash Player
stage.align = StageAl1gn.TOP_LEFT;
// Регистрируем приемник для событий Event.RESIZE stage.addEventLIstener(Event.RESIZE. res1zeL1stener);
// Вручную вызываем код для исходного размещения объекта pos1t1onRectangle( );
}
// Обрабатывает события Event.RESIZE
private function res1zeL1stener (e;Event):vo1d { pos1t1onRectangle( );
}
// Помещает объект rect в правый верхний угол области отображения
// приложения Flash Player
private function posItlonRectangle ( ):vo1d {
rect.x = stage.stagewidth - rect.width; rect.y = 0;
}
}
}
Событие Event.MOUSE_LEAVE
Событие Event. MOUSE_LEAVE обычно применяется для отключения или удаления содержимого, взаимодействующего с мышью, когда указатель покидает пределы области отображения проигрывателя Flash Player. Например, в приложении, которое скрывает системный указатель мыши, заменяя его пользовательским изображением указателя мыши (как было показано ранее в листинге 22.5), изображение пользовательского указателя мыши скрывается, когда он перемещается за пределы области отображения приложения Flash Player.
Как и в случае с Event. RESIZE, приемники для события Event.MOUSE_LEAVE должны быть зарегистрированы в экземпляре класса Stage приложения Flash Player. Следующий пример демонстрирует базовый код, необходимый для обработки событий Event. MOUSE_LEAVE:
package {
Import flash.display.*;
Import fl ash.events.*;
public class MouseLeaveSensor extends Sprite {
public function MouseLeaveSensor ( ) {
// Регистрируем приемник для событий Event.MOUSE_LEAVE
stage.addEventLIstener(Event.MOUSE_LEAVE. mouseLeaveLIstener);
}
// Обрабатывает события Event.MOUSE_LEAVE•
private function mouseLeaveLIstener (e:Event);void { traceCThe mouse has left the building.");
}
}
}
Из программы на экран
На протяжении нескольких предыдущих глав мы рассмотрели множество методик для создания графического содержимого и его изменения в ответ на действия пользователя. В следующей главе мы узнаем, как происходит автоматическое обновление экрана для отображения текущего графического содержимого программы в средах выполнения Flash. Познакомившись с системой обновления экрана среды выполнения, мы перейдем к гл. 24, где будем использовать цикл обновления экрана для создания программной анимации.
Обновления экрана
Говоря по существу, все обновления экрана в языке ActionScript можно разбить на две категории: происходящие через регулярные интервалы времени (запланированные обновления) и происходящие сразу после выполнения определенных функций- приемников событий (постсобытийные обновления). Независимо от категории, все обновления экрана являются автоматическими. В ActionScript отсутствуют универсальные способы, позволяющие запросить немедленное обновление экрана. Вместо этого новое графическое содержимое, создаваемое программным путем или вручную в среде разработки Flash, отображается автоматически на этапе запланированного или постсобытийного обновления. В этой главе рассматриваются две разновидности обновлений экрана в языке ActionScript.
Хотя большая часть этой книги посвящена созданию кода с использованием чистого языка ActionScript, а не рассмотрению конкретных сред разработки SWF-файлов, для чтения следующего материала вам потребуются базовые знания временной шкалы и методик создания сценариев временной шкалы в среде разработки Flash. Если вы незнакомы со средой разработки Flash, вам следует прочитать гл. 29 перед тем, как продолжить изучение предложенного здесь материала.
Запланированные обновления экрана
В ActionScript обновления экрана неразрывно связаны с анимационными возможностями среды выполнения Flash. Даже те приложения, которые созданы исключительно с использованием языка ActionScript в приложении Flex Builder 2 или с помощью консольного компилятора mxmlc, подвержены влиянию системы обновления экрана, реализующей анимационные возможности среды Flash.
Система обновления экрана среды выполнения Flash разработана для поддержки модели среды разработки Flash, предназначенной для создания анимированного содержимого с использованием сценариев. В среде разработки Flash анимированное содержимое создается вручную в виде последовательности кадров на временной шкале аналогично кадрам на обычной киноленте. Каждый визуальный кадр может быть связан с блоком кода, называемым сценарием кадра. В самых общих чертах, когда среда выполнения воспроизводит анимацию, созданную в среде разработки, она придерживается следующего цикла обновления экрана.
Выполнить код текущего кадра.
Обновить экран.
Перейти к следующему кадру.
Повторить цикл.
Предположим, что у нас есть созданная в среде разработки Flash анимация, которая состоит из трех кадров, а с каждым кадром связан сценарий. Обобщенный процесс, в соответствии с которым среда выполнения Flash воспроизводит анимацию, выглядит следующим образом.
Выполнить сценарий кадра 1.
Отобразить содержимое кадра 1.
Выполнить сценарий кадра 2.
Отобразить содержимое кадра 2.
Выполнить сценарий кадра 3.
Отобразить содержимое кадра 3.
На шагах 1, 3 и 5 сценарий каждого кадра может создать новое или изменить существующее графическое содержимое. Таким образом, более точное описание предыдущих шагов процесса воспроизведения анимации выглядело бы следующим образом.
Выполнить сценарий кадра 1.
Отобразить содержимое кадра 1 и визуальные результаты выполнения сценария кадра 1.
Выполнить сценарий кадра 2.
Отобразить содержимое кадра 2 и визуальные результаты выполнения сценария кадра 2.
Выполнить сценарий кадра 3.
Отобразить содержимое кадра 3 и визуальные результаты выполнения сценария кадра 3.
В приведенном описании процесса обратите внимание, что перед тем, как отобразить визуальные результаты выполнения некоторого сценария кадра, среда Flash всегда полностью завершает выполнение данного сценария.
му * *Uyму * *UyСреда выполнения Flash никогда не прерывает выполнение сценария кадра для того, чтобы обновить экран.
му * *
Uy
му * *
Uy
Скорость, с которой выполняются шесть предыдущих шагов, определяется скоростью кадров среды Flash, которая измеряется количеством кадров в секунду. Предположим, что для предыдущей анимации была установлена очень медленная скорость кадров — один кадр в секунду. Кроме того, предположим, что выполнение сценария каждого кадра занимает ровно 100 мс, а визуализация содержимого каждого кадра — ровно 50 мс. Относительно момента начала воспроизведения анимации теоретические времена выполнения шести описанных шагов выглядели бы следующим образом:
Оме:Начало выполнения сценария кадра 1
ЮОмс: Завершение выполнения сценария кадра 1
ЮООмс: Начало визуализации содержимого кадра 1 и результатов выполнения сценария кадра
1050мс: Завершение визуализации содержимого кадра 1 и результатов выполнения сценария кадра
1051мс: Начало выполнения сценария кадра 2
1151мс: Завершение выполнения сценария кадра 2
2000мс; Начало визуализации содержимого кадра 2 и результатов выполнения сценария кадра
2050мс; Завершение визуализации содержимого кадра 2 и результатов выполнения сценария кадра
2051мс; Начало выполнения сценария кадра 3
2151мс: Завершение выполнения сценария кадра 3
ЗОООмс: Начало визуализации содержимого кадра 3 и результатов выполнения сценария кадра
3050мс: Завершение визуализации содержимого кадра 3 и результатов выполнения сценария кадра
Обратите внимание, что после завершения выполнения сценария каждого кадра среда Flash не осуществляет немедленное обновление экрана. Вместо этого она выводит результаты выполнения сценария на следующем запланированном этапе визуализации кадра. Следовательно, обновления экрана среды выполнения Flash могут считаться запланированными обновлениями экрана, поскольку они происходят в соответствии с установленным графиком, который определяется скоростью кадров.
Таким образом, еще более точное описание шагов предыдущего процесса воспроизведения анимации выглядело бы следующим образом.
Выполнить сценарий кадра 1.
Дождаться следующего запланированного этапа визуализации кадра.
Отобразить содержимое кадра 1 и визуальные результаты выполнения сценария кадра 1.
Выполнить сценарий кадра 2.
Дождаться следующего запланированного этапа визуализации кадра.
Отобразить содержимое кадра 2 и визуальные результаты выполнения сценария кадра 2.
Выполнить сценарий кадра 3.
Дождаться следующего запланированного этапа визуализации кадра.
Отобразить содержимое кадра 3 и визуальные результаты выполнения сценария кадра 3.
Теперь давайте представим, что сценарий кадра 1 регистрирует функцию-приемник clickListener ( ) в экземпляре класса Stage для событий Мои seEvent .CLICK. Всякий раз, когда выполняется функция clickListener ( ), из точки, где на настоящий момент находится указатель мыши, рисуется красная линия. Рассмотрим код сценария кадра для кадра 1:
import flash.events.*;
Import flash.display.*;
stage.addEventListener(MouseEvent.CLICK, clickListener);
function clickListener (e:MouseEvent):void {
graphics.HneStyle(2, OxFFOOOO);
graphics. HneTo(e.stageX, e.stageY);
}
Сразу после завершения выполнения сценария кадра 1 метод clickLis tener ( ) может получать уведомления о возникновении событий MouseEvent. CLICK.
Теперь предположим, что пользователь щелкнул кнопкой мыши в области отображения среды выполнения Flash через 500 мс после начала воспроизведения анимации (то есть в период ожидания, который представлен шагом 2 в предыдущем описании процесса). Метод clickLis tener ( ) выполняется немедленно, однако визуальные результаты этого не будут отображены до момента наступления следующего запланированного этапа визуализации кадра. На следующем этапе визуальные результаты выполнения метода clickListener( ) будут отображены вместе с содержимым кадра 1 и результатами выполнения сценария кадра 1.
Таким образом, еще более точное описание шагов предыдущего процесса воспроизведения анимации выглядело бы следующим образом..
Выполнить сценарий кадра 1.
Дождаться следующего запланированного этапа визуализации кадра. В процессе ожидания, если возникают какие-либо события, выполнять соответствующие приемники событий.
Отобразить содержимое кадра 1, визуальные результаты выполнения сценария кадра 1, визуальные результаты выполнения любых приемников событий на шаге 2.
Выполнить сценарий кадра 2.
Дождаться следующего запланированного этапа визуализации кадра. В процессе ожидания, если возникают какие-либо события, выполнять соответствующие приемники событий.
Отобразить содержимое кадра 2, визуальные результаты выполнения сценария кадра 2, визуальные результаты выполнения любых приемников событий на шаге 5.
Выполнить сценарий кадра 3.
Дождаться следующего запланированного этапа визуализации кадра. В процессе ожидания, если возникают какие-либо события, выполнять соответствующие приемники событий.
Отобразить содержимое кадра 3, визуальные результаты выполнения сценария кадра 3, визуальные результаты выполнения любых приемников событий на шаге 8.
Описанные шаги отражают поведение, по умолчанию используемое средой выполнения Flash для обновления экрана. Однако для некоторых типов событий среда Flash может выполнять обновление экрана более быстро. Дополнительную информацию можно получить в разд. «Постсобытийные обновления экрана» далее в этой главе.
Теперь предположим, что содержимое кадра 2 идентично содержимому кадра 1, сценарий кадра 2 не генерирует никаких визуальных результатов и никакие приемники событий не вызываются в промежутке между кадром 1 и кадром 2. В таком случае среда Flash не выполняет визуализацию области отображения. Вместо этого, когда наступает этап визуализации кадра для кадра 2, среда выполнения попросту проверяет, требуется ли обновление экрана. Кадр 2 не содержит визуальных изменений, поэтому повторная визуализация экрана не происходит.
Таким образом, еще более точное описание шагов предыдущего процесса воспроизведения анимации выглядело бы следующим образом.
Выполнить сценарий кадра 1.
Дождаться следующего запланированного этапа визуализации кадра. В процессе ожидания, если возникают какие-либо события, выполнять все зарегистрированные приемники событий.
На этапе визуализации кадра проверить, требуется ли обновление экрана. Обновление экрана требуется в том случае, когда справедливо любое из следующих условий:
кадр 1 включает изменения содержимого экземпляра класса Stage, созданные вручную в среде разработки Flash;
код сценария кадра 1 создал новое или изменил существующее графическое содержимое;
код функции-приемника, которая была выполнена на шаге 2, создал новое или изменил существующее графическое содержимое.
Если необходимо, обновить экран, чтобы отразить все изменения, произошедшие на шаге 3.
Повторить шаги 1-4 для кадров 2 и 3.
Для вашего сведения, в оставшейся части этой главы и в следующей главе мы будем называть проверку необходимости обновления экрана, происходящую на шаге 3, проверкой запланированного обновления экрана. Всякий раз, когда среда выполнения Flash проводит проверку запланированного обновления экрана, она осуществляет диспетчеризацию события Event. ENTER_FRAME (даже в тех случаях, когда обновления экрана на самом деле не происходит). Реагируя на событие Event. ENTER_FRAME, объекты могут выполнять повторяющиеся задачи, синхронизированные с операцией обновления экрана. В гл. 24 будет рассказано, как использовать событие Event.ENTER_FRAME для создания анимированного содержимого полностью программным путем.
Вы готовы рассмотреть последний гипотетический сценарий? Предположим, что мы удаляем кадры 2 и 3 из нашей анимации, оставляя только кадр 1. Как и раньше, сценарий кадра 1 определяет приемник события MouseEvent .CLICK — clickListener ( ). Как только содержимое кадра 1 и результаты выполнения сценария кадра будут визуализированы (шаг 4 в предыдущем описании процесса), воспроизведение анимации завершится. Тем не менее для продолжения обработки событий цикл обновления экрана среды выполнения Flash должен оставаться активным. Таким образом, для SWF-файла, содержащего всего один кадр, цикл
обновления экрана выглядит следующим образом (описанные шаги также применимы к многокадровому SWF-файлу, воспроизведение которого было просто приостановлено на кадре 1).
Выполнить сценарий кадра 1.
Дождаться следующего запланированного этапа визуализации кадра. В процессе ожидания, если возникают какие-либо события, выполнять все зарегистрированные приемники событий.
На этапе визуализации кадра проверить, требуется ли обновление экрана. Обновление экрана требуется в том случае, когда справедливо любое из следующих условий:
кадр 1 включает изменения содержимого экземпляра класса Stage, созданные вручную в среде разработки Flash;
код сценария кадра 1 создал новое или изменил существующее графическое содержимое;
код функции-приемника, которая была выполнена на шаге 2, создал новое или изменил существующее графическое содержимое.
Если необходимо, обновить экран, чтобы отразить все изменения, произошедшие на шаге 3.
Дождаться следующего запланированного этапа визуализации кадра. В процессе ожидания, если возникают какие-либо события, выполнять все зарегистрированные приемники событий.
На этапе визуализации кадра проверить, требуется ли обновление экрана. Обновление экрана требуется в том случае, когда код функции-приемника, выполненной на шаге 5, создал новое или изменил существующее графическое содержимое.
Если необходимо, обновить экран, чтобы отразить все изменения, произошедшие на шаге 6.
Повторить шаги 5-7.
Шаги 5-8 из предыдущего описания процесса постоянно повторяются до тех пор, пока SWF-файл выполняется в среде Flash, привязывая тем самым последующее выполнение кода к циклу обновления экрана, который зависит от скорости кадров.
В гл. 20 мы узнали, что, когда пустая среда выполнения Flash открывает новый SWF-файл, она находит основной класс этого SWF-файла, создает его экземпляр и добавляет созданный экземпляр в список отображения в качестве первого ребенка экземпляра класса Stage. Для программ, разработанных исключительно с использованием языка ActionScript, обновление экрана происходит сразу после завершения выполнения метода-конструктора основного класса. Все последующие обновления экрана происходят в соответствии с циклом обновления экрана, описанном на шагах 5-8 предыдущего списка и зависящем от скорости кадров.
Например, рассмотрим следующую чрезвычайно простую программу рисования, которая увеличивает частоту обновления экрана среды выполнения Flash путем установки скорости кадров, равной одному кадру в секунду:
package {
import flash.display.*;
Import flash.events.*;
public class S1mpleScr1bble extends Sprite {
public function S1mpleScribble ( ) {'
stage.frameRate = 1;
graphics.moveTotstage.mouseX, stage.mouseY);
stage.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveListener);
}
private function mouseMoveLIstener (e;MouseEvent);void { graphics. 11neStyle(2, OxFFOOOO);
graphics. HneTo(e.stageX, e.stageY);
}
}
}
Метод-конструктор класса SimpleSribble не создает никакого графического содержимого, но регистрирует приемник mouseMoveListener ( ) для события MouseEvent .MOUSE_MOVE. При перемещении мыши метод mouseMoveListener ( ) рисует линию в точку, где на настоящий момент находится указатель мыши. Однако нарисованная линия не отображается на экране до следующего этапа обновления экрана, которое происходит один раз в секунду. Следовательно, каждую секунду среда выполнения Flash обновляет экран набором линий, отражающих траекторию перемещения указателя мыши в области отображения с момента последнего обновления экрана. Для более «плавного» рисования мы могли бы увеличить скорость кадров до 30 в секунду или инициировать немедленные обновления экрана, используя методики, описываемые далее, в разд. «Постсобытийные обновления экрана».
Подведем промежуточные итоги, перечислив рассмотренные ключевые моменты.
Система обновления экрана языка ActionScript является полностью автоматической.
Для приложений, разработанных исключительно с использованием ActionScript, скорость кадров можно представить как количество автоматических проверок необходимости обновления экрана, проводимых средой выполнения Flash за одну секунду. Например, если скорость кадров среды выполнения Flash равна 1, все визуальные изменения, внесенные программой, будут автоматически отображаться один раз в секунду; если скорость кадров равна 10, визуальные изменения будут автоматически отображаться 10 раз в секунду (каждые 100 мс).
Если скорость кадров очень низкая (скажем, 1-10 кадров в секунду), то между выполнением кода, генерирующего визуальное содержимое, и отображением этого содержимого на экране могут происходить заметные задержки.
Всякий раз, когда среда Flash выполняет проверку запланированного обновления экрана, она осуществляет диспетчеризацию события Event. ENTER_FRAME.
Приложение Flash Player никогда не прерывает выполнение блока кода для того, чтобы обновить экран.
Последний из перечисленных моментов является чрезвычайно важным, поэтому рассмотрим его более подробно.
Никаких обновлений экрана внутри блоков кода
Повторим еще раз, что среда Flash никогда не прерывает выполнение блока кода для того, чтобы обновить экран. До того как произойдет запланированное обновление экрана, все функции в стеке вызовов и весь код в текущем кадре должны завершить свое выполнение. Подобным образом, перед тем как произойдет постсобытийное обновление экрана, приемник события, внутри которого был вызван метод updateAf terEvent ( ), должен завершить свое выполнение.
На самом деле, даже если обновление экрана запланировано на данное время, это обновление будет отложено до тех пор, пока не завершится выполнение текущего кода. Обновления экрана и выполнение кода являются взаимно исключающими задачами для среды Flash; они всегда происходят последовательно, но ни в коем случае не одновременно.
В качестве золотого правила запомните, что в ActionScript обновление экрана не может произойти между двумя строками кода. Например, следующая функция displayMsg ( ) создает объект Text Fie Id и дважды устанавливает его горизонтальное положение: сначала 50, а затем 100:
public function displayMsg ( ):void {
van t:TextF1eld = new TextF1eld( );
t.text = "Are we having fun yet?":
t.autoSize = TextF1eldAutoS1ze.LEFT;
addChlld(t);
t.x = 50;
t.x = 100;
}
При выполнении функции displayMsg ( ) экран никогда не будет и не может быть обновлен между двумя последними строками в этой функции. В результате объект TextField никогда не появится на экране в горизонтальной позиции 50. Вместо этого выполнение функции полностью завершится перед визуализацией экрана и объект Text Field будет отображен в горизонтальной позиции 100. Хотя переменной х на самом деле кратковременно присваивается значение 50, визуальный результат этого изменения никогда не будет отображен на экране.
В некоторых случаях выполнение кода может задерживать обновления экрана на много секунд, вплоть до максимального значения, определяемого параметром компиляторатах-execution-tirne, которому по умолчанию присваивается значение 15. Любой сценарий, выполнение которого не завершается в течение времени, определяемого параметром max-execution-time, генерирует исключение ScriptTimeoutEr ror. Информацию по обработке этого исключения можно найти в описании исключения flash. errors . ScriptTimeoutError в справочнике по языку ActionScript корпорации Adobe.
Чтобы избежать появления исключений ScriptTimeoutError, весь код должен быть разработан таким образом, чтобы его выполнение завершалось в течение ин-
тервала, определяемого параметром компиляторатах-execution-time. Для выполнения задачи, которой требуется больше времени, чем позволяет разрешенный лимит времени, разбейте ее на части, которые могут быть выполнены в течение времени, определяемого параметром max-execution-time, а затем используйте класс Timer, чтобы организовать выполнение этих частей кода.
Установка скорости кадров
Установить скорость кадров приложения Flash Player можно одним из следующих способов:
используя аргумент default-frame-rate компилятора mxmlc;
в окне Document Properties (Свойства документа) среды разработки Flash;
используя переменную экземпляра frameRate класса Stage внутри выполняемого SWF-файла.
Первый SWF-файл, загруженный в среду Flash, устанавливает начальную скорость кадров для всех SWF-файлов, которые будут загружены в дальнейшем.
Независимо от способа установки скорости кадров, она будет использована всеми загруженными в дальнейшем SWF-файлами (переопределяя их собственную заданную скорость кадров). Однако после загрузки первого SWF-файла установленная скорость кадров среды выполнения Flash может быть изменена переменной экземпляра frameRate класса Stage, принимающей значения в диапазоне от 0.01 (один кадр каждые 100 с) до 10 0 0 (1000 кадров в секунду). Например, следующий код устанавливает скорость кадров, равную 150 кадрам в секунду:
package {
import fl ash.display.*;
public class SetFrameRate extends Sprite {
public function SetFrameRate ( ) { stage.frameRate = 150;
}
Хотя скорость кадров может быть установлена через любой объект, имеющий доступ к экземпляру класса Stage, отображаемые объекты не могут выполняться с различными скоростями кадров. Визуализация всех объектов в списке отображения осуществляется одновременно, с учетом единой скорости кадров среды Flash.
До появления языка Actionscript 3.0 скорость кадров среды выполнения нельзя было изменять программным путем.
Назначенная скорость кадров в сравнении с реальной скоростью
Хотя среда Flash выполняет запланированные обновления экрана в соответствии со скоростью кадров, количество обновлений экрана в секунду, которое может быть
достигнуто на самом деле (реальная скорость кадров), зачастую оказывается меньше, чем скорость кадров, указанная программистом (назначенная скорость кадров). Реальная скорость кадров существенно зависит от таких факторов, как производительность компьютера, доступные системные ресурсы, физическая частота обновления устройства отображения и сложность содержимого, исполняемого в среде Flash. Следовательно, назначенную скорость кадров необходимо считать нижним пределом скорости. Реальная скорость никогда не будет меньше назначенной скорости, однако в некоторых условиях она не сможет достичь назначенной скорости кадров.
Приложение Flash Player не всегда сможет достигать назначенной скорости кадров.
Чтобы определить текущую назначенную скорость кадров, мы проверяем значение переменной экземпляра frameRate класса Stage. Например, следующий класс отображает назначенную скорость кадров в объекте TextField:
package {
import flash.display.*;
import fl ash.text.*;
public class ShowFrameRate extends Sprite {
public function ShowFrameRate ( ) {
var t;TextField = new TextF1eld( );
t.autoSize = TextFieldAutoSize.LEFT;
t.text = stage.frameRate.toStringt ); addChild(t);
}■
Для того чтобы определить реальную скорость кадров, мы используем событие Event. ENTER_FRAME, применяемое для измерения времени, прошедшего между проверками запланированных обновлений экрана среды выполнения Flash. Эта методика продемонстрирована в листинге 23.1. Более подробно с событием Event. ENTER_FRAME мы познакомимся в гл. 24.
Листинг 23.1. Измерение реальной скорости кадров package {
import flash.display.*;
import flash.events.*;
import flash.utils.*;
import flash.text.*;
public class FrameRateMeter extends Sprite {
private var lastFrameTime;Number;
private var output:TextField;
public function FrameRateMetert ) { output = new TextF1eld( );.
output.autoSize = TextFieldAutoSize.LEFT; output.border = true;
output.background = true;
output.selectable = false;
addChlld(output);
,addEventL1stener(Event.ENTER FRAME, enterFrametistener);
private function enterFrametistener (e:Event).-void {
var now:Number = getT1mer( );
var elapsed-.Number = now - lastFrameTIme;
var framesPerSecond;Number = Math. roundQOOO/elapsed);
output.text = "Time since last frame: " + elapsed
+ "\nExtrapolated actual frame rate: " + framesPerSecond
+ "\nDes1gnated frame rate: " + stage.frameRate; lastFrameTIme = now;
Реальная скорость кадров в отладочной версии среды выполнения Flash зачастую оказывается гораздо меньше реальной скорости кадров в рабочей версии.
Постсобытийные обновления экрана
Из предыдущего раздела мы узнали, что запланированные обновления экрана происходят автоматически через интервалы, определяемые скоростью кадров. Мы также узнали, что визуальные изменения, вносимые приемниками событий, не отображаются до следующего запланированного этапа обновления экрана. При использовании стандартной скорости кадров, равной 24 кадрам в секунду, задержка между выполнением приемника события и отображением его визуальных результатов обычно незаметна. Тем не менее для визуальных изменений, возникающих в результате взаимодействия пользователя с мышью или клавиатурой, даже небольшие задержки могут привести к тому, что приложение будет выглядеть дрожащим или замедленным. В связи с этим язык ActionScript дает каждой функции-приемнику событий мыши и клавиатуры специальную возможность инициировать постсобытийное обновление экрана. Это обновление, которое происходит непосредственно после диспетчеризации события, перед следующим запланированным обновлением.
Для того чтобы запросить постсобытийное обновление экрана в ответ на событие мыши, мы вызываем метод MouseEvent. updateAf terEvent ( ) над объектом MouseEvent, передаваемым во все функции-приемники событий мыши. Например, следующий код вызывает постсобытийное обновление экрана в ответ на событие MouseEvent.MOUSE_MOVE:
private function mouseMovetlstener (e:MouseEvent):vo1d { e.updateAfterEventt ); // Вызываем обновление
}
Чтобы запросить постсобытийное обновление экрана в ответ на событие клавиатуры, мы вызываем метод KeyboardEvent. updateAf terEvent ( ) над объектом KeyboardEvent, передаваемым во все функции-приемники событий клавиатуры. Например, следующий код вызывает постсобытийное обновление экрана в ответ на событие KeyboardEvent.KEY_DOWN:
private function keyDownLlstener (e:KeyboardEvent):void { e.updateAfterEvent( ); // Вызываем обновление
В обоих случаях вызов метода updateAfterEvent ( ) заставляет среду выполнения Flash обновить экран сразу после диспетчеризации события, перед следующим запланированным обновлением экрана. Тем не менее, хотя постсобытийное обновление экрана осуществляется перед следующим запланированным обновлением экрана, оно не произойдет до тех пор, пока все приемники событий, вызванные в процессе диспетчеризации события, не завершат свое выполнение.
Как и в случае с запланированными обновлениями экрана, среда Flash никогда не прерывает выполнение блока кода, чтобы осуществить постсобытийное обновление экрана.
Пример использования метода updateAf terEvent ( ) в реальном сценарии продемонстрирован в классе пользовательского указателя мыши Cus tomMousePointer, который был представлен в подразд. «Определение позиции указателя мыши» разд. «События мыши» гл. 22. Класс CustomMousePointer рисует синий треугольник в объекте Sprite, представляющем указатель, и использует приемник события MouseEvent. MOUSE MOVE, чтобы реализовать перемещение этого объекта Sprite за мышью. Метод updateAfterEvent ( ) применяется внутри метода mouseMoveListener ( ) для вызова постсобытийного обновления экрана, чтобы обеспечить плавное перемещение указателя, не зависящее от скорости кадров.
Рассмотрим код мeтoдamouseMoveListener ( ) из класса CustomMousePointer. Обратите внимание на вызов метода updateAfterEvent ( ), выделенный полужирным шрифтом:
private function mouseMoveListener (e:MouseEvent):vo1d {
// При перемещении мыши обновляем позицию пользовательского указателя
// мыши, чтобы она соответствовала позиции системного указателя
var po1nt!nParent:Po1nt = parent.globalToLocal(new Po1nt(e.stageX, e.stageY));
x = polntlnParent.x;
у = polntlnParent.у;
// Запрашиваем постсобытийное обновление экрана, чтобы анимация // указателя была максимально плавной
е.updateAfterEvent( );
// Убеждаемся, что пользовательский указатель мыши отображается на экране // (он может быть скрыт, поскольку системный указатель мог покидать // пределы области отображения приложения Flash Player).
1f (!v1s1ble) {
visible = true;
} }
Стоит отметить, что, когда среда Flash обновляет экран в ответ на вызов метода updateAfterEvent ( ), она отображает не только те изменения, которые были внесены функцией-приемником события, запросившей данное обновление, но и все визуальные изменения, произошедшие с момента последнего обновления экрана.
Постсобытийные обновления дня событий таймера
Для того чтобы разрешить обновление экрана сразу после истечения некоторого произвольного интервала времени, язык ActionScript предоставляет метод TimerEvent. updateAf terEvent ( ), который вызывает постсобытийное обновление экрана после возникновения события TimerEvent. TIMER.
Указанный метод точно так же используется внутри функций-приемников события TimerEvent. TIMER, как и методы MouseEvent. updateAf terEvent ( ) и KeyboardEvent. updateAf terEvent ( ) внутри функций-приемников событий мыши и клавиатуры..
Для демонстрации использования метода Time г Eve nt. updateAf terEvent ( ) создадим расширенный пример, который генерирует событие TimerEvent. TIMER в десять раз чаще, чем скорость кадров среды выполнения Flash. Мы начнем с установки скорости, равной одному кадру в секунду:
stage.frameRate = 1:
Далее мы создаем объект Timer, который осуществляет диспетчеризацию события TimerEvent. TIMER каждые 100 мс (10 раз в секунду):
var t1mer:T1mer = new T1mer(l00, 0);
Затем мы регистрируем функцию-приемник timerListener ( ) в объекте timer для событий TimerEvent. TIMER, как показано в следующем коде:
timer.addEventL1stener(T1merEvent.TIMER, timerListener);
После этого мы запускаем таймер:
timer.start( );
Теперь внутри функции timerListener ( ) рисуем прямоугольник и помещаем его в случайное место на экране. Для того чтобы гарантировать, что прямоугольник появится на экране сразу после завершения процесса диспетчеризации события TimerEvent. TIMER (а не на следующем запланированном этапе обновления экрана), мы используем метод TimerEvent. updateAf terEvent ( ) для запроса постсобытийного обновления экрана. Рассмотрим получившийся код для метода timerListener ( ):'
private function timerListener (e:T1merEvent):void {
// Создаем прямоугольник
var rect:Spr1te = new Spr1te( );
rect.g ra ph 1 cs.11neStyle(1);
rect.graphics.beginFIll(OxOOOOFF);
rect.graph1cs.drawRect(0, 0, 150, 75);
rect.x = Math.floor(Math.random( )*stage.stageWidth);
rect.y = Math.floor(Math.random( )*stage.stageheight);
// Добавляем прямоугольник на экран addChild(rect):
// Запрашиваем постсобытийное обновление экрана e.updateAfterEvent( );
}
В результате такого вызова метода TimerEvent.updateAf terEvent ( ) отображение визуальных изменений, вносимых внутри метода timerListener ( ), происходит приблизительно каждые 100 мс, а не раз в секунду.
Для информации следующий код демонстрирует наш предыдущий сценарий с таймером в контексте класса RandomRectangles:
package {
Import flash.display.*;.
Import flash events.*;
import flash.utils.*;•
public class RandomRectangles extends Sprite {
public function RandomRectangles ( ) {
stage.frameRate = 1;
var timer;Timer = new TimerdOO, 0);
timer.start( );
timer.addEventListener(TimerEvent.TIMER. timerListener);
}
private function timerListener (e:TimerEvent);void {
var rect;Sprite = new Sprite( );
rect.graphics.1ineSty1e (1);.
rect.graphics.beginFill(OxOOOOFF);'
rect.graphics.drawRect(O. 0. 150. 75);
rect.x = Math.floor(Math.random( )*stage.stageWidth);
rect.y = Math.floor(Math.random( )*stage.stageheight);
addChiId(rect);
e.updateAfterEvent( )
}
В гл. 24 мы продолжим наше изучение класса Timer, применяя его для создания движения и других форм анимации.
Й
Метод setlnterval() языка Actionscript 2.0 может также использовать метод updateAfterEvent() для вызова постсобытийного обновления экрана, однако вместо метода setlnterval() предпочтительнее использовать класс flash.utils.Timer, поскольку он предоставляет возможность запускать и останавливать события таймера, а также уведомлять о таймерных событиях сразу несколько приемников. Старайтесь избегать использования метода setlnterval() в языке Actionscript 3.0.
Автоматические постсобытийные обновления экрана
В приложении Flash Player 9 определенные «кнопочные» взаимодействия с объектами любого класса, наследуемого от класса Sprite, приводят к автоматическому постсобытийному обновлению экрана (аналогично тому, как программист вызывает метод updateAf terEvent ( )). В частности, автоматическое постсобытийное обновление экрана будут вызывать следующие взаимодействия:
перемещение указателя мыши над экземпляром класса, который наследуется от класса Sprite, или за пределы этого экземпляра;
нажатие или отпускание основной кнопки мыши, когда указатель мыши находится над экземпляром класса, наследуемого от Sprite;
использование клавиши Пробел или Enter для активизации экземпляра класса, наследуемого от класса Sprite.
Существует небольшая вероятность, что в будущих версиях приложения Flash Player такое особое поведение, относящееся к автоматическому обновлению экрана, будет применяться только к объектам SimpleButton. В связи с этим вы, вероятно, не захотите полагаться на него в своем коде.
Область перерисовки
Как уже известно из разд. «Запланированные обновления экрана», среда выполнения Flash обновляет экран только в тех случаях, когда это необходимо (то есть когда графическое содержимое было изменено или добавлено). Точнее говоря, когда среда выполнения обновляет экран, она визуализирует только те области, которые изменились с момента последнего обновления. Например, представим анимацию, состоящую из двух кадров, первый из которых содержит круг, а второй — тот же круг, но вместе с треугольником. Когда среда Flash визуализирует второй кадр, она перерисовывает прямоугольную область, содержащую треугольник, но не перерисовывает круг. Прямоугольная область, включающая все содержимое, которое было изменено, называется областью перерисовки (в программировании графики данная область иногда называется измененным прямоугольником).
Чтобы отобразить область перерисовки в отладочных версиях среды выполнения, можно щелкнуть правой кнопкой мыши в окне приложения Flash Player и в контекстном меню выбрать пункт Show Redraw Regions (Показать области перерисовки).
Оптимизация с использованием события EventRENDER
Событие Event. RENDER — это особый тип события обновления экрана, используемый в сложных ситуациях, когда графическая производительность имеет первостепенное значение. Его основное назначение заключается в предоставлении
программисту возможности отложить выполнение всех пользовательских процедур рисования точно до того момента, когда произойдет визуализация экрана, позволяя тем самым избежать повторного выполнения процедур рисования. В отличие от остальных внутренних событий среды разработки Flash, событие Event.RENDER должно быть запрошено программистом вручную. Среда Flash осуществляет диспетчеризацию события Event. RENDER, когда выполняются два следующих условия:•
среда выполнения Flash собирается проверить необходимость обновления экрана (либо при прохождении какого-либо кадра, либо в результате вызова метода updateAfterEvent ( ) );
программист вызвал метод stage. invalidate ( ) (с его помощью программист может попросить среду выполнения Flash осуществить диспетчеризацию события Event. RENDER в следующий раз, когда произойдет проверка обновления экрана).
Рассмотрим пример, который демонстрирует, как событие Event. RENDER может быть использовано для улучшения производительности. Предположим, что мы создаем класс Ellipse, который представляет фигуру эллипса на экране. Для простоты предположим, что эллипс всегда заполняется белым цветом и имеет контур черного цвета толщиной 1 пиксел. Наш класс Ellipse должен делать следующее:
управлять концептуальными данными эллипса (то есть хранить ширину и высоту эллипса);
рисовать эллипс на экране, используя данные концептуального эллипса, и перерисовывать эллипс на экране при изменении данных концептуального эллипса.
В соответствии с описанными назначениями, в листинге 23.2 представлен вариант реализации класса Ellipse, который приемлем в том случае, когда производительность не имеет решающего значения:
Листинг 23.2. Простейший класс Ellipse
package {
import flash.display.Shape;
public class Ellipse extends Shape {
private var w:Number;
private var h:Number;
public function Ellipse (width:Number, height:Number) {
w = width;
h = height; draw( );
}
public function setWidth (newWidth:Number):void {
w = newWidth; draw( );
}
public function getWidth ( ):Number {
return w;
}
public function setHelght (newHelght:Number):void { h = newHelght; draw( );
}
public function getHelght ( ):Number { return h;
}
private function draw ( ):vo1d {
graphics.11neStyle(l);
graphics.beg1nF1ll(OxFFFFFF, 1);
graphics.drawEl11pse(0, 0, w, h);
}
}
}
Обратите внимание, что в классе Ellipse есть три места, где происходит изменение данных концептуального эллипса: метод setwidth ( ), метод setHelght ( ) и метод-конструктор класса Ell ipse. Чтобы обеспечить соответствие между концептуальным эллипсом и эллипсом, отображаемым на экране, мы должны убедиться, что перерисовка эллипса, отображаемого на экране, осуществляется в каждом из трех перечисленных мест. Код, представленный в листинге 23.2, для удовлетворения этого требования использует метод решения «в лоб»; он просто вызывает метод draw( ) всякий раз, когда выполняются методы getWidth ( ), getHelght ( ) или метод-конструктор класса Ellipse. Разумеется, если внутри одного цикла обновления экрана эти функции вызываются несколько раз, дублиру!ощие вызовы метода draw ( ) являются избыточными. Это демонстрирует следующий код:
var e:EH1pse = new Ellipse (100. 200); // метод draw( ) вызывается здесь e.setW1dth(25);// метод draw( ) вызывается здесь снова
е.setHelght(50); // метод draw( ) вызывается здесь снова
При выполнении трех предыдущих строк кода метод draw ( ) вызывается три раза, однако на экране будут отображены результаты лишь последнего вызова. Первые два вызова являются избыточными и нерациональными. В простейшем приложении такая избыточность незаметна и, следовательно, может оказаться допустимой. Тем не менее в сложных приложениях подобная избыточность может приводить к тому, что процедуры рисования будут бесполезно выполняться сотни или тысячи раз, представляя собой потенциальный источник серьезных проблем, связанных с производительностью.
Чтобы избавиться от избыточности в классе Ellipse, мы должны изменить подход, применяемый для рисования фигуры. Вместо того чтобы вызывать метод draw ( ) всякий раз, когда изменяются данные концептуального эллипса, мы будем откладывать вызов этого метода до момента обновления экрана. Эта новая стратегия приведет к усложнению кода класса Ellipse, но при этом улучшит его производительность.
Первый шаг в реализации новой стратегии «один вызов метода dr aw ( )» заключается в удалении вызова метода draw ( ) из методов setWidht ( ) и setHeight ( ), а также вызова метода-конструктора класса Ellipse. Вместо непосредственного вызова метода draw ( ) эти функции будут вызывать метод stage. invalidate ( ), который приказывает среде выполнения Flash осуществить диспетчеризацию события Event. RENDER при очередной проверке необходимости обновления экрана. Затем из функции-приемника события Event. RENDER мы вызовем метод draw ( ). В листинге 23.3 представлен измененный класс Ellipse — отличия от кода из листинга 23.2 выделены полужирным шрифтом. Стоит отметить, что метод draw ( ) не должен вызываться, когда объект Ellipse не находится в списке отображения, поэтому вызов метода stage. invalidate ( ) происходит только в том случае, когда объект Ellipse находится в списке отображения. Чтобы определить, находится ли объект Ellipse в списке отображения, мы проверяем значение унаследованной переменной экземпляра stage этого объекта. Когда значение переменной stage равно null, объект Ellipse не находится в списке отображения.
Объект, запрашивающий уведомление о возникновении события Event.RENDER, получит это уведомление даже в том случае, если он не находится в списке отображения.
Обратите внимание, что на данном промежуточном этапе нашей разработки класс Ellipse не является полнофункциональным, поскольку он не регистрирует приемники для событий Event. RENDER. Эту проблему мы решим в ближайшее время.
Листинг 23.3. Измененный класс Ellipse, часть 1
package {
Import fl ash.display.Shape;
public class ElUpselnterlm extends Shape { private var w:Number;
private var h:Number;
public function ElUpselnterlm (width:Number, height:Number) { w = width;•
h = height;
// Если этот объект находится в списке отображения...
if (stage != null) {
// ...запрашиваем диспетчеризацию события Event.RENDER stage.invalidate( );
}
public function setwidth (newW1dth:Number):void { w = newWIdth;
if (stage ’= null) { stage.invalidate( );
public function getWIdth ( ):Number { return w;
public function setHelght (newHelght:Number):void { h = newHelght;
if (stage != null) { stage.invalidate( );
}
}
public function getHeight ( ):Number { return h;
}
// Приемник события вызывается перед обновлением
// экрана, если был вызван метод
// stage.invalidate( )
private function renderListener (e:Event):void { draw( );
}
private function draw ( ):void { graphics.clear( );
graphics.11neStyle(l);
graphics.beg1nF1ll(OxFFFFFF, 1);
graphics.drawEl11pse(0, 0. w, h);
}
} }
Чтобы метод renderListener ( ) выполнялся всякий раз, когда среда Flash осуществляет диспетчеризацию события Event. RENDER, мы должны зарегистрировать метод renderListener ( ) в экземпляре класса Stage для событий Event .RENDER. Однако когда объект Ellipse не находится в списке отображения, его переменной экземпляра stage присвоено значение null и, следовательно, она не может применяться для регистрации события. Для того чтобы обойти эту проблему, мы определим в классе Ellipse две функции-приемника событий — addedToStageListener( ) и removedFomStageListener( ), которые получают уведомления о возникновении пользовательских событий StageDetector. ADDED_TO_STAGE и S tageDetector. REMOVE D_FROM_S TAGE. Диспетчеризация первого события происходит, когда объект добавляется в список отображения, и при получении этого события класс Ellipse будет регистрировать метод renderListener ( ) для события Event. RENDER. Диспетчеризация второго события происходит в том случае, когда объект удаляется из списка отображения, и при получении этого события класс Ellipse будет отменять регистрацию метода renderListener ( ) для событий Event. RENDER.
В листинге 23.4 продемонстрирован измененный класс Ellipse (изменения, как и раньше, выделены полужирным шрифтом). Обратите внимание, что метод
addedToStageListener ( ) вызывает метод stage. invalidate ( ), гарантируя, что любые изменения, внесенные в объект Ellipse за то время, пока он не находился в списке отображения, будут визуализированы при добавлении этого объекта в список отображения.
В листинге 23.4 применяются пользовательские события StageDetector.ADDED_TO_STAGE и StageDetector. REMOVED_FROM_STAGE, диспетчеризация которых осуществляется пользовательским классом StageDetector. Детальное рассмотрение данного класса можно найти в подразд. «События ADDED_TO_STAGE и REMOVED_FROM_STAGE» разд. «События контейнеров» гл. 20.
Листинг 23.4. Измененный класс Ellipse, часть 2
package {
import fl ash.di splay.Shape;
Import fl ash,events.*;
public class ElUpselnterim extends Shape {
private var w:Number;
private var h:Number;
public function ElUpselnterim (width:Number, height;Number) { // Регистрируем приемники для получения уведомлений, // когда данный объект добавляется в список // отображения или удаляется из него var StageDetector-.StageDetector = new StageDetector(this); StageDetector.addEventLi stener(StageDetector.ADDED_TO_STAGE, addedToStageListener);
StageDetector. addEventLi stener (StageDetector. REMOVEDFROMSTAGE, removedFromStageListener);
w = width;
h = height;
if (stage != null) { stage.invalidate( );
}
}
public function setwidth (newWidth:Number):void {
w = newWidth:
if (stage != null) { stage.1nvalidate( ):
}
}
public function getWidth ( );Number { return w;
public function setHeight (newHeight;Number);void { h = newHeight;
if (stage != null) { stage.invalidate( );
}
}
public function getHeight ( ):Number { return h;
}
// Приемник события вызывается при добавлении этой фигуры
// в список отображения
private function addedToStageListener (e:Event):void {
// Регистрируем приемник для получения уведомлений
// об обновлениях экрана
stage.addEventListener(Event.RENDER, renderListener);
// Гарантируем, что любые изменения, внесенные в данный объект
// за то время, пока он не отображался на экране, будут
// визуализированы при его добавлении в список отображения.
stage.invalidate( );
}
// Приемник события вызывается при удалении этой фигуры из списка
// отображения
private function removedFromStageListener (е:Event).-void {
// Нет необходимости в получении событий
// обновления экрана, когда данный объект
// не находится в списке отображения
stage.addEventListener(Event.RENDER, renderListener);
}
private function renderListener (e:Event):void {
• draw( );
}
private function draw ( ):void { graphics.clear( );
graphics.HneStyle(l);
graphics.beg1nF1ll(OxFFFFFF, 1);
graphics.drawEl11pse(0, 0. w, h);
}
}
}
Класс Ellipse, представленный в листинге 23.4, теперь является полностью функциональным, однако в нем все еще остаются две существенные избыточности. Во-первых, метод addedToStageListener ( ) всегда вызывает метод stage. invalidate ( ), когда объект Ellipse добавляется в список отображения. В результате перерисовка фигуры происходит даже в тех случаях, когда в этом нет необходимости, поскольку за то время, пока эллипс не отображался на экране, данные концептуального эллипса не изменялись.
Во-вторых, не забывайте, что событие Event. RENDER возникает в том случае, когда любой объект — не обязательно текущий — вызывает метод stage. invalidate ( ). Таким образом, в текущем состоянии метод renderListener ( ) будет вызывать метод draw ( ) всякий раз, когда любой объект в приложении вызывает метод stage. invalidate ( ). В приложении с множеством объектов такая избыточность может привести к серьезным проблемам, связанным с производительностью.
Чтобы решить эти две оставшиеся проблемы, мы внесем последний набор изменений в класс Ellipse — добавим новую логику, позволяющую определить, требуется ли перерисовка эллипса при вызове методов addedToStageListener ( ) и renderListener ( ). Во-первых, добавим новую переменную экземпляра changed, которая будет сообщать о том, требуется ли перерисовка объекта El 1 ipse при очередном обновлении экрана. Затем, чтобы устанавливать и сбрасывать значение переменной changed, а также проверять ее статус, добавим три новых метода: setChanged ( ), clearChanged ( ) HhasChanged( ). Наконец, всякий раз при изменении эллипса (то есть всякий раз при вызове метода setwidth ( ), setHeight ( ) или метода-конструктора) мы будем присваивать переменной changed значение true.
В листинге 23.5 представлена окончательная версия класса Ellipse с комментариями, которые помогут вам понять код (изменения выделены полужирным шрифтом). Как отмечалось ранее, класс, представленный в листинге 23.5, безусловно, является более сложным, чем его первоначальная, неоптимизированная версия из листинга 23.2. Однако в приложениях, требующих максимальной графической производительности, подход с отложенной визуализацией, применяемый в листинге 23.5, является просто незаменимым. Дополнительную информацию по классам, представляющим фигуры и использующим отложенную визуализацию, можно найти в гл. 25.
Листинг 23.5. Окончательная, оптимизированная версия класса Ellipse
package {
Import fl ash.display.Shape;
Import fl ash.events.*;
public class Ellipse extends Shape {
private var w:Number;
private var h;Number;
private var changed:Boolean;
public function Ellipse (w1dth:Number, height:Number) {
// Регистрируем приемники для получения уведомлений, когда данный // объект добавляется в список отображения или удаляется из него var stageDetectoriStageDetector = new StageDetector(thls);
stageDetector.addEventL1stener(StageDetector.ADDED_TO_STAGE,
addedToStageLIstener);
stageDetector.addEventL1stener(StageDetector.REMOVED_FROM_STAGE, removedFromStageLlstener);
// Устанавливаем ширину и высоту w = width;
h = height;
// Помечаем, что объект изменился setChanged( );
public function setwidth (newW1dth:Number):void { w = newWIdth;
setChanged( );
public function getWIdth ( ):Number { return w;
public function setHelght (newHelght:Number):void { h = newHelght;
setChanged( );
public function getHelght ( ):Number { return h;
// Помечает, что в данной фигуре что-то изменилось private function setChanged ( ):void {
changed = true;
if (stage ’= null) {
stage.invalidate( );
}
}
// Помечает, что самые последние изменения
// были отображены на экране
private function clearChanged ( ):void {
changed = false;
// Сообщает о том, содержит ли данная фигура изменения, // которые еще не были отображены на экране protected function hasChanged ( ):Boolean {
return changed;
// Приемник события вызывается при добавлении этой фигуры
// в список отображения
private function addedToStageLIstener (e:Event):void {
// Регистрируем приемник для получения уведомлений
// об обновлениях экрана
stage.add Е ventL1 stener(Event.RENDER, renderLIstener);
// Если за то время, пока объект отсутствовал в списке отображения,
// произошли какие-либо изменения, нарисуем эти изменения
// при следующей визуализации экрана. Однако если с момента, // когда объект находился в списке отображения, никаких изменений
// не произошло, в его отрисовке нет необходимости.
if (hasChanged( )). {
stage.inval1date( );
}
}
// Приемник события вызывается при удалении этой фигуры из списка
// отображения
private function removedFromStagetlstener (e:Event):vo1d {
// Нет необходимости в получении событий обновления экрана, когда // данный объект не находится в списке отображения stage.addEventLIstener(Event.RENDER, renderLIstener);
// Приемник события вызывается перед обновлением экрана, если был вызван
// метод stage.Inval1date( )
private function renderLIstener (e:Event):vo1d {
// Вызываем метод draw ( ), если изменения, внесенные в данную фигуру, // еще не были отображены.
// Если это событие вызвал другой объект, но данный объект не был
// изменен, перерисовка данного объекта выполняться не будет.
if (hasChanged( )) {
draw( );
private function draw ( ):vo1d { graphics.clear( );
graphics.HneStyle(l);
graphics.beg1nF1ll(OxFFFFFF, 1);
graphics.drawEl11pse(0, 0, w, h);
Заставим его двигаться!
Теперь, когда мы познакомились с системой обновления экрана среды выполнения Flash, можно рассмотреть, как с помощью кода создается анимация и движение. Звучит забавно? Увидимся в следующей главе.
Дополнительную информацию о системе обновления экрана среды выполнения Flash можно найти в дневнике Тиника Уро (Tinic Uro), инженера, работающего над созданием приложения Flash Player. Этот дневник расположен по адресу: http://www.kaourantin. net/2006/05/frame-rates-in-flash-player.html.
Программная анимация
В этой главе описываются базовые методики создания анимации с помощью языка ActionScript. Основное внимание уделяется интеграции кода для создания анимации с автоматическими обновлениями экрана среды выполнения Flash. Однако в этой главе не рассматриваются углубленные вопросы, связанные с анимацией, например программирование движения, подчиняющегося законам физики, перемещение по траектории, обнаружение столкновения, эффекты растровой анимации или преобразование цветов.
Никаких циклов
Чтобы создать анимацию на ActionScript, мы постоянно изменяем графическое содержимое с течением времени, создавая иллюзию движения. Например, чтобы анимировать объект TextField, перемещая его по экрану в горизонтальном направлении, мы будем постоянно увеличивать или уменьшать значение переменной экземпляра х этого объекта. В некоторых языках программирования естественным механизмом для постоянного изменения значения переменной экземпляра является инструкция цикла. Таким образом, новички в программировании на языке ActionScript могут подумать, что анимация создается с помощью цикла while, как та, что показана в следующем коде:
public class TextAnlmation extends Sprite {
public function TextAnlmation ( ) {
// Создаем объект TextField
var t:TextF1eld = new TextF1eld( );*
t.text= "Hello";
t.autoSize= TextF1eldAutoS1ze.LEFT;
addChlld(t);
// Циклически обновляем горизонтальную позицию объекта TextField
// и останавливаемся в тот момент, когда объект достигнет
И координаты 300 по оси х
while (t.x <= 300) {
t.x += 10;
}
Предыдущий цикл while многократно увеличивает значение переменной экземпляра х объекта TextField, но, как в варианте создания анимации, в нем допущена роковая ошибка: при выполнении тела цикла обновление экрана не происходит.
На каждой итерации цикла горизонтальное положение объекта TextField изменяется, однако визуальный эффект данного изменения не отображается на экране. Визуализация изображения происходит только после завершения последней итерации цикла и выхода из функции-конструктора класса TextAnimation. Следовательно, в тот момент, когда произойдет визуализация изображения, объект TextField уже будет находиться в точке с координатой 300 по оси X.
'"1^<§й В языке ActionScript инструкции цикла не могут быть использованы для создания ани- I мации. Помните, что обновление экрана никогда не происходит внутри блока кода.
Дополнительную информацию можно найти в подразд. «Никаких обновлений экрана внутри блоков кода» разд. «Запланированные обновления экрана» гл. 23.
В языке ActionScript анимация создается не с помощью циклов, а с помощью многократного вызова функций, которые вносят визуальные изменения и затем завершаются, позволяя выполнить обновление экрана. Существует два механизма для многократного вызова подобных функций: события Event. ENTER_FRAME иTimerEvent.TIMER.
Создание анимации с помощью события ENTER_FRAME
Среда Flash осуществляет диспетчеризацию события Event. ENTER_FRAME всякий раз, когда выполняется проверка запланированного обновления экрана (как было описано в гл. 23). Любая функция, зарегистрированная для получения уведомлений о возникновении события Event. ENTER_FRAME, выполняется многократно с частотой, определяемой текущей скоростью кадров среды выполнения Flash. Визуальные изменения, вносимые любой функцией-приемником события Event. ENTER_FRAME, отображаются сразу после завершения этой функции.
Функция может быть зарегистрирована для получения уведомлений о возникновении события Event. ENTER_FRAME из любого экземпляра класса DisplayOb j ect, независимо от того, находится в настоящий момент этот экземпляр в списке отображения или нет. В качестве примера используем событие Event. ENTER_FRAME, чтобы реализовать анимацию, рассмотренную в предыдущем разделе, — объект TextField перемещается по экрану в горизонтальном направлении до точки с координатой 300 по оси X. Начнем с создания класса TextAnimation, который создает объект TextField и затем добавляет его в список отображения.
public class TextAnimation extends Sprite {
private var t:TextField;
public function TextAnimation ( ) {
// Создаем объект TextField
t = new TextFieldC );
t.text= "Hello":
t.autoSize= TextFieldAutoSize.LEFT:
addChlld(t);
}
}
Теперь создадим функцию-приемник moveTextRight ( ) для события Event. ENTER_FRAME, которая перемещает объект TextField t вправо на 10 пикселов. Многократный вызов функции moveTextRight ( ) создаст эффект анимации. Обратите внимание, что, поскольку функция moveTextRight ( ) является функцией-приемником события Event. ENTER_FRAME, она определяет единственный обязательный параметр, типом данных которого является Event.
public function moveTextRight (e:Event):void { t.x += 10; '
}
Наконец, внутри функции-конструктора класса TextAnimation мы регистрируем функцию moveTextRight ( ) для событий Event. ENTER_FRAME. Как только она будет зарегистрирована в качестве функции-приемника событий Event. ENTER-FRAME, она будет многократно вызываться с течением времени, в соответствии со скоростью кадров среды выполнения Flash. Новый код выделен полужирным шрифтом:
public function TextAnimation ( ) {
// Создаем объект TextField
t = new TextF1eld( );
t.text= "Hello";
t.autoSize= TextF1eldAutoS1ze.LEFT;
addChlld(t);
// Регистрируем функцию moveTextRight( )
// для получения уведомлений
// о возникновении события Event.ENTERFRAME addEventLIstener(Event.ENTER_FRAME. moveTextRight);
}-
В листинге 24.1 продемонстрирован класс TextAnimation, дополненный методом moveTextRight ( ).
Листинг 24.1. Анимация объекта TextField по горизонтали
public class TextAnimation extends Sprite {
private var t:TextF1eld;
public function TextAnimation ( ) {
// Создаем объект TextField
t = new TextF1eld( );
t.text= "Hello";.
t.autoSize = TextF1eldAutoS1ze.LEFT: addChlld(t);
// Регистрируем функцию moveTextRight( ) для получения уведомлений
// о возникновении события Event.ENTER_FRAME addEventLIstener(Event.ENTER_FRAME. moveTextRIght);
}-
public function moveTextRight (e:Event):void { t.x += 10;
Всякий раз, когда при выполнении кода из листинга 24.1 среда Flash проверяет запланированное обновление экрана, она осуществляет диспетчеризацию события Event .ENTER-FRAME. В результате вызывается функция moveTextRight ( ), и среда выполнения Flash обновляет экран. С течением времени многократный вызов функции moveTextRight ( ) создает анимацию объекта TextField, перемещая его по экрану. Однако пока функция moveTextRight ( ) перемещает объект TextField t вправо до бесконечности. Чтобы объект TextField не перемещался дальше позиции с координатой 300 по оси X, мы должны изменить метод moveTextRight ( ) — значение 10 должно прибавляться к значению переменной t. х только в том случае, когда значение переменной t. х меньше или равно 300, как показано ниже.
public function moveTextRight (e:Event):void {
// Добавляем 10 к значению переменной t.x только в том случае, когда
// значение переменной t.x меньше или равно 300.'
if (t.x <= 300) {•
t.x += 10;
// Не допускаем, чтобы значение переменной t.x превысило 300 if (t.x > 300) { t.x = 300;
}
}
}.
Предыдущий код справляется с задачей остановить объект TextField в точке с координатой 300 по оси X, но при этом он позволяет методу moveTextRight (* ) бесполезно продолжать свое выполнение даже после того, как объект TextField достигнет заданной координаты. Чтобы избежать ненужных вызовов функции, мы отменяем регистрацию приемника moveTextRight ( ) для событий Event. EVENT_FRAME, когда объект достигает точки с координатой 300 по оси X. Вот этот код:
public function moveTextRight (e:Event);vo1d {
1f (t.x <= 300) {'.
t.x += 10;
1f (t.x > 300) { t.x = 300;
}
} else {
// Прекращаем получать уведомления о возникновении события
// Event.ENTER_FRAME
removeEventListener(Event.ENTER_FRAME, moveTextRight);
}
}
Теперь, когда мы изменили метод moveTextRight ( ), чтобы получение уведомлений о возникновении события Event. ENTER_FRAME происходило только при необходимости, наш простой класс TextAnimation завершен. В листинге 24.2 показан окончательный код.
Листинг 24.2. Анимация объекта TextField по горизонтали до координаты 300 по оси X package {
Import flash.display.*;
Import fl ash.events.*;
Import fl ash.text.*;
public class TextAn1mat1on extends Sprite {
private var t:TextF1eld;
public function TextAn1mat1on ( ) {
// Создаем объект TextField t = new TextF1eld( ); t.text= "Hello";
t.autoSize= TextF1eldAutoS1ze.LEFT;
addChlld(t);
// Регистрируем функцию moveTextRIght( ) для получения уведомлений
// о возникновении события Event.ENTER_FRAME
addEventL1stener(Event.ENTER_FRAME, moveTextRIght);
}"
public function moveTextRIght (e;Event):void { 1f (t.x <= 300) { t.x += 10;
1f (t.x > 300) { t.x = 300;
}
} else {
// Прекращаем получать уведомления о возникновении события // Event.ENTER_FRAME removeEventLIstener(Event.ENTER_FRAME. moveTextRIght);
}
Обратите внимание, что в листинге 24.2 анимация одного объекта (TextField) осуществляется под управлением другого объекта (класса TextAnimation). Структура, в которой «один объект управляет анимацией другого объекта», является типичной для приложений с централизованным управлением анимацией. В подобных приложениях один класс выступает в роли режиссера для всех анимаций в приложении, регистрируя единственный метод для уведомлений о возникновении события Event. ENTER_FRAME и вызывая процедуры для создания анимации над всеми подчиняющимися объектами. В отличие от этого, в приложении с децентрализованным управлением анимацией отдельные классы управляют своей собственной анимацией самостоятельно, определяя свои собственные методы-приемники события Event. ENTER_FRAME. Для сравнения в листинге 24.3 показан подкласс TextTo300 класса TextField. Здесь, как в предыдущем примере, объект перемещается в точку с координатой 300 по оси X, но делает это самостоятельно. Обратите внимание, что класс TextTo300
определяет методы start ( ) и stop ( ), которые могут быть использованы для воспроизведения и остановки анимации.
Листинг 24.3. Децентрализованное управление анимацией
package {
Import flash.display
Import flash.events.*:
import fl ash.text.*:
public class TextTo300 extends TextField {
public function TextTo300 ( ) {
public function moveTextRight (e:Event):void {
if (x <= 300) {
x += 10:
if (t.x > 300) {
t.x = 300:
}
} else { stop( ):
public function start ( ):void {
// Начинаем воспроизведение анимации
addEventtistener(Event.ENTER_FRAME, moveTextRight):
public function stop ( ):void { // Останавливаем анимацию removeEventtistener(Event.ENTER_FRAME. moveTextRight);
}
}
Следующий код демонстрирует основной класс SWF-файла, в котором применяется класс TextTo300 из листинга 24.3:
package {.
import flash.display.*:
import fl ash.text.*:
public class TextAnimation extends Sprite {
private var t:TextTo300:
public function TextAnimation ( ) {
// Создаем экземпляр класса TextTo300
t = new TextTo300( ):
t.text= "Hello":
t.autoSize= TextFieldAutoSize.LEFT:
addChild(t):
// Запускаем анимацию t.start( ):
}
Влияние скорости кадров на анимации, создаваемые с помощью события Event.ENTERFRAME. Поскольку событие Event. ENTER_FRAME синхронизируется со скоростью кадров, для более высокой скорости функции-приемники события Event. ENTER-FRAME будут вызываться чаще по сравнению с более низкой скоростью. Таким образом, если мы перемещаем объект по экрану, используя функцию-приемник события Event. ENTER_FRAME, увеличение скорости кадров может предвещать увеличение скорости анимации.
Например, при программировании перемещения объекта t в предыдущем разделе мы неявно задавали его скорость относительно скорости кадров. Наш код говорит: «При прохождении каждого кадра перемещаем объект t на 10 пикселов вправо»: ball_mc._x += 10:
Следовательно, скорость объекта t зависит от скорости кадров. Если скорость кадров равна 12 кадрам в секунду, то скорость перемещения объекта t составит 120 пикселов в секунду. Если скорость кадров равна 30 кадрам в секунду, скорость перемещения объекта t составит 300 пикселов в секунду!
При создании анимаций на базе сценариев вы можете поддаться искушению рассчитать расстояние перемещения элемента с учетом назначенной скорости кадров. Например, если назначенная скорость кадров составляет 20 кадров в секунду и мы хотим, чтобы элемент перемещался со скоростью 100 пикселов в секунду, естественно предположить, что скорость объекта должна составлять 5 пикселов за один кадр (5 пикселов х 20 кадров в секунду = 100 пикселов в секунду).
Однако у этого подхода есть два существенных недостатка.
Всякий раз, изменяя назначенную скорость кадров, мы должны модифицировать весь код, который вычисляет скорость с учетом данной скорости кадров.
Как было сказано в гл. 23, среда выполнения Flash не всегда достигает назначенной скорости кадров. Если компьютер слишком медленный, чтобы отображать кадры со скоростью, соответствующей назначенной, анимация будет замедляться. Это замедление может варьироваться даже в зависимости от загрузки системы; если запущены другие программы или если среда Flash выполняет некую задачу с интенсивной загрузкой процессора, то скорость кадров может упасть на короткий промежуток времени, после чего будет восстановлен нормальный темп.
В некоторых случаях анимация, воспроизводимая со слегка различающимися скоростями, может считаться допустимой. Но когда визуальная точность имеет не последнее значение или когда мы создаем, скажем, игру с активными действиями, гораздо более подходящим вариантом является определение расстояния для перемещения объекта с учетом прошедшего времени, а не в зависимости от назначенной скорости кадров. Дополнительную информацию можно найти далее, в разд. «Анимация, основанная на скорости».
Создание анимации с использованием события TimerEventJIMER
В предыдущем разделе рассказывалось о том, каким образом использовать событие Event. ENTER FRAME для создания анимаций, которые синхронизируются со скоростью кадров среды выполнения Flash. В этом разделе мы познакомимся с тем, как синхронизировать анимации с произвольным промежутком времени, задаваемым с помощью класса flash. utils . Timer.
Класс Т ime г — это универсальный служебный класс, предназначенный для выполнения кода через указанный промежуток времени. Каждый объект Timer осуществляет диспетчеризацию событий Т imerEvent. TIMER с частотой, устанавливаемой программистом. Функции, которые желают выполняться с данной частотой, регистрируются в объекте Timer для событий Time г Event. TIMER.
Класс Timer не гарантирует частоту, с которой выполняются его функции-приемники. Если система или среда выполнения Flash оказалась занята в тот момент, когда объект Timer запланировал выполнить свои функции-приемники, выполнение функций будет отложено. Информацию о том, как избежать подобных задержек в анимации, можно найти в разд. «Анимация, основанная на скорости».
Для использования класса Timer необходимо выполнить следующую общую последовательность действий.
Создать новый объект Т ime г:
var timer:T1mer = new T1mer( );
Установить частоту (в миллисекундах), с которой должны генерироваться события TimerEvent. TIMER. Например, следующий код устанавливает частоту, равную 100 мс (за одну секунду осуществляется диспетчеризация десяти событий TimerEvent. TIMER):
timer.del ay = 100:
Установить общее количество генерируемых событий TimerEvent .TIMER. Например, следующий код говорит таймеру сгенерировать всего пять событий TimerEvent. TIMER:
timer.repeatCount = 5;
Значение 0 сбрасывает ограничение (генерировать события TimerEvent. TIMER постоянно или до тех пор, пока не скажут остановиться):
timer.repeatCount = 0: // Бесконечные события TimerEvent.TIMER
Создать одну или несколько функций, которые будут периодически вызываться в ответ на события TimerEvent. TIMER объекта Timer. Функции, регистрируемые для событий TimerEvent. TIMER, должны определять единственный параметр с типом данных TimerEvent.
function timerListener (e:T1merEvent):void {
// Этот код будет выполняться при возникновении события TimerEvent.TIMER }
Зарегистрировать функцию, созданную на шаге 4, в объекте Timer для событий TimerEvent.TIMER:
timer.addEventLIstener(T1merEvent.TIMER, timerListener);
Использовать метод экземпляра start ( ) класса Timer, чтобы запустить таймер. Как только таймер будет запущен, он начнет генерировать события TimerEvent .TIMER в соответствии со значениями, указанными для переменных delay и repeatcount: timer.start( );
В качестве альтернативы шагам 2 и 3 из приведенного списка установить значения переменных delay и repeatcount можно через параметры конструктора класса Timer, как показано в следующем коде:
var t1mer:T1mer = new UmerdOO. 5): // Переменной delay присваиваем
// значение 100, а переменной
*// repeatCount - значение 5
Следующий код демонстрирует применение предыдущих шагов в простой реальной ситуации: отображение слова «СО!» после трехсекундной задержки. Обратите внимание, что вторым аргументом функции-конструктора класса Timer является значение 1. Это значит, что произойдет диспетчеризация только одного события TimerEvent. TIMER. Подобный код может быть использован в начале теста с ограниченным временем выполнения или гоночной игры.
package {
Import flash.display.*;
Import fl ash.events.*:
Import flash.utils.*:
Import flash.text.*:
public class Race extends Sprite {
private var startMsg:TextF1eld:•
public function Race ( ) {
// Выполнить приемники события TimerEvent.TIMER один раз спустя
// 3 секунды
var t1mer:T1mer = new T1mer(3000, 1);
timer.addEventL1stener(T1merEvent.TIMER. t1merL1stener);
timer.start( ):
startMsg = new TextF1eld( ):
startMsg.autoSize = TextF1eldAutoS1ze.LEFT:
startMsg.text = "Get Ready!":
addChl1d(startMsg): '
}
private function tlmertlstener (e:T1merEvent):void { startMsg.text = "GO!";
}
}
}
Теперь, когда в целом мы чувствуем себя комфортно при работе с классом Timer, воспользуемся им для воссоздания класса TextAnimation из листинга 24.2. На этот раз вместо события Event. ENTER FRAME для создания анимации будет использован объект Timer. Как и раньше, мы начинаем работу с определения конструктора и свойств класса. На этот раз мы добавим новую переменную экземпляра timer, которая будет ссылаться на наш объект Timer.
public class TextAnimation extends Sprite {
private var t:TextF1eld;
private var timer:Timer;
public function TextAnimation ( ) {
// Создаем объект TextFleld
t = new TextF1eld( );
t.text= "Hello";
t.autoSize= TextF1eldAutoS1ze.LEFT;
addChlld(t):
}
}
Далее внутри конструктора класса TextAnimation мы создаем объект Timer, который будет генерировать события TimerEvent. TIMER каждые 50 мс (то есть 20 раз в секунду). После создания объекта Timer мы вызываем его метод start ( ), после чего этот объект начинает генерировать события TimerEvent. TIMER.
public function TextAnimation ( ) {
// Создаем объект TextFleld
t = new TextFIeld( );
t.text . = "Hello":
t.autoSize = TextF1eldAutoS1ze.LEFT:
addChi'ld(t):.
timer = new T1mer(50, 0);
timer.start( );
}
Затем мы создаем нашу функцию-приемник moveTextRight ( ), которая перемещает объект Text Field t вправо на 10 пикселов до тех пор, пока он не достигнет координаты 300 по оси X. На этот раз функция moveTextRight ( ) принимает события TimerEvent. TIMER, а не Event. ENTER_FRAME, поэтому она определяет единственный обязательный параметр, типом данных которого является TimerEvent.
public function moveTextRight (e:T1merEvent):void {
}
Как и раньше, мы хотим остановить анимацию, когда объект t достигнет координаты 300 по оси X. Для этого мы вызываем метод stop ( ) объекта Timer, который прекращает генерацию событий TimerEvent. TIMER:
public function moveTextRight (e:T1merEvent):void {
1f (t.x <= 300) {
t.x += 10:
1f (t.x > 300) {
t.x = 300:
}
} else {
// Останавливаем таймер,
// когда объект TextField достигнет
// своего места назначения timer.stop( );
}
}
Чтобы обновить экран сразу после выхода из функции moveTextRight ( ), мы используем метод экземпляра updateAfterEvent ( ) класса TimerEvent (метод updateAf terEvent ( ) был подробно рассмотрен в гл. 23).
public function moveTextRight (e:T1merEvent):void {
if (t.x <= 300) {'
t.x += 10:
if (t.x > 300) {
t.x = 300:
}
// Обновляем экран после выхода из этой функции
е.updateAfterEvent( );
} else {
// Останавливаем таймер,
// когда объект TextField достигнет
// своего места назначения timer.stop( ):
}
}
Наконец, мы регистрируем функцию moveTextRight ( ) в объекте Timer для событий TimerEvent .TIMER. Мы выполняем регистрацию этой функции непосредственно перед запуском таймера в конструкторе класса TextAnimation, как показано в следующем коде:
public function TextAnimat!on ( ) {
// Создаем объект TextField
t = new TextF1eld( );
t.text= "Hello":
t.autoSize= TextF1eldAutoS1ze.LEFT:
addChlld(t):
timer = new T1mer(50, 0):
timer.addEventListener(TimerEvent.TIMER, moveTextRight);
timer.start( ):
}
В листинге 24.4 представлен законченный код для версии класса TextAnimat ion, реализованной с использованием объекта Timer.
Листинг 24.4. Анимация объекта TextField по горизонтали до координаты 300 по оси X, версия с таймером package {
Import flash.display.*:
import flash.events.*;
Import flash.utils.*;
Import fl ash.text.*;
public class TextAn1mat1on extends Sprite {
private var t;TextF1eld;
private var timer:T1mer;
public function TextAn1mat1on ( ) {
// Создаем объект TextFleld
t = new TextF1eld( );
t.text= "Hello";
t:autoSize= TextFieldAutoSIze.LEFT;
addChlld(t);
timer = new T1mer(50, 0);
timer.addEventL1stener(T1merEvent.TIMER, moveTextRIght);
timer.start( );
}
public function moveTextRIght (e:TimerEvent):void {
if (t.x <= 300) {■
t.x += 10:
if (t.x > 300) {
t.x = 300;'
}
e.updateAfterEventt ); // Обновляем экран после выхода // из этой функции
} else {
// Останавливаем таймер, когда объект TextFleld достигнет
// своего места назначения timer.stop( );
}
}
}
}
Приведем еще одно сравнение между анимацией на основе объекта Timer и анимацией на основе события Event. ENTER_FRAME — в листинге 24.5 представлена аналогичная версия класса TextTo300, реализованная с использованием объекта Timer (класс TextTo300 был приведен ранее в листинге 24.3).
Листинг 24.5. Класс TextTo300, версия с таймером
package {
Import flash.display.*;
Import flash.events.*;
Import flash.utils.*;
Import flash.text.*;
public class TextTo300 extends TextFleld { private var t1mer:T1mer;
public function TextTo300 ( ) {
timer = new T1mer(50, 0):
t1mer.addEventLIstener(TimerEvent.TIMER, moveTextRIght);
}
public function moveTextRight (e:Event):void {
if (x <= 300) {
x += 10:
if (t.x > 300) { t.x = 300;
}
} else {
stop( );
}
}
public function start ( ):vo1d {
// Начинаем воспроизведение анимации timer.start( );
}
public function stop ( ):void {
// Останавливаем анимацию
timer.stop( );
}
}
}
В листинге 24.6 показан еще один пример анимации, созданной с использованием объекта Timer. Это версия мигающего текста, реализованная на языке ActionScript 3.0.
Листинг 24.6. Мигающий текст
package {
Import flash.display.TextFleld;
Import flash.ut11.Timer:
Import flash.events.*:
public class BUnkText extends TextFleld { private var t1mer:T1mer;
public function BUnkText (delay:Number = 1000) {
timer = new T1mer(delay, 0):
timer.addEventLIstener(TimerEvent.TIMER. t1merL1stener): timer.start( ):
}
private function t1merL1stener (e:T1merEvent):void {
// Скрываем данный объект, если в настоящее время он отображается
// на экране: или отображаем данный объект, если в настоящее время
// он скрыт.
visible = 'visible:
e.updateAfterEvent( ): }
public function setDelay (newDelay:Number):void { timer.del ay = newDelay;
}
public function startBlink ( ):void { timer.start( ):
}
public function stopBlink ( ):void { visible = true; timer.stop( );
}
} }
Влияние скорости кадров на таймеры. Хотя на первый взгляд может показаться, что класс Timer предоставляет абсолютно независимый способ для выполнения некоторой функции через определенный интервал времени, он, как бы удивительно это ни звучало, все равно зависит от скорости кадров среды выполнения Flash. Событие TimerEvent. TIMER может возникать не чаще десяти раз для каждой проверки запланированного обновления экрана (то есть в десять раз чаще скорости кадров). Например, если скорость кадров равна 1 кадру в секунду, событие TimerEvent. TIMER может возникать в лучшем случае каждые 100 мс, даже когда для параметра delay объекта Timer указано меньшее значение. Для скорости, равной 10 кадрам в секунду, событие TimerEvent. TIMER может возникать 100 раз в секунду (каждые 10 мс). Для скорости, равной 100 кадрам в секунду, событие TimerEvent. TIMER может возникать 1000 раз в секунду (каждую 1 мс).
Когда установленная частота возникновения события TimerEvent. TIMER больше скорости кадров, функция будет выполняться на этапе следующего запланированного обновления экрана после истечения интервала времени. Чтобы запросить обновление экрана до следующего запланированного обновления, используйте метод экземпляра update AfterEvent ( ) класса TimerEvent, рассмотренный в гл. 23.
Выбор между классом Timer и событием Event.ENTER_FRAME
Как мы уже знаем, и класс Timer, и событие Event. ENTER FRAME могут применяться для создания анимации. Так что же из них больше подходит для ваших целей? Ниже перечислены основные факторы, влияющие на выбор.
Скорость кадров может изменяться. Когда S WF-файл загружается другим приложением, скорость кадров этого приложения может значительно отличаться от
назначенной скорости кадров данного SWF-файла. Это может приводить к слишком быстрому или слишком медленному воспроизведению анимации. Загружаемый SWF-файл может, конечно, установить собственную скорость кадров, однако такое изменение, возможно, окажет нежелательное влияние на воспроизведение в родительском приложении. Определенную независимость от скорости кадров обеспечивает класс Timer (ограничения были рассмотрены в разд. «Создание анимации с использованием события TimerEvent.TIMER»).
Использование множества объектов Timer требует больше памяти. В архитектурах с децентрализованным управлением анимацией использование отдельного объекта Timer для управления анимацией каждого объекта требует больше памяти, чем это необходимо для аналогичной реализации с использованием события Event.ENTER_FRAME.
Использование множества объектов Timer может приводить к избыточному количеству запросов на обновление экрана. В архитектурах с децентрализованным управлением анимацией использование отдельного объекта Timer вместе с методом updateAfterEvent ( ) для управления анимацией каждого объекта ведет к возникновению нескольких независимых запросов на обновление экрана, что может привести к проблемам с производительностью.
Исходя из перечисленных факторов, мы рекомендуем следующее.
В приложениях, которые должны синхронизировать отображение содержимого, создаваемого программным путем, с отображением кадрового содержимого, создаваемого вручную в среде разработки Flash, используйте событие Event.ENTER_FRAME.
В приложениях, где должно минимизироваться влияние колебаний скорости кадров среды Flash, применяйте один объект Timer для управления всеми анимациями и создавайте анимации, основанные на скорости (дополнительную информацию можно найти в разд. «Анимация, основанная на скорости»).
Когда колебания скорости кадров среды выполнения Flash считаются приемлемыми, используйте событие Event. ENTER_FRAME (поскольку код для анимации, создаваемой с помощью события Event. ENTER_FRAME, в основном проще его эквивалента, реализуемого с помощью объекта Timer).
□ Избегайте использования независимых объектов Timer для анимации отдельных отображаемых объектов. Там, где это возможно, используйте один объект Timer для управления всеми анимациями. С другой стороны, если вы хотите обновлять различные объекты через различные интервалы времени, подходящим решением могут оказаться независимые объекты Timer.
Обобщенный класс Animator
Во многих приложениях, которые были представлены в этой главе, код для создания графического объекта и код, занимающийся анимацией этого объекта, объединялись в одном классе. Для реальных приложений разумнее выносить код, создающий анимацию, во внешние классы и повторно применять его в других классах.
Простой класс Animator, представленный в листинге 24.7, демонстрирует один из возможных путей абстрагировать реализацию возможностей для создания анимации от анимируемых объектов. Каждый экземпляр класса Animator может перемещать указанный объект DisplayOb j ect в заданную позицию за определенный промежуток времени. Стоит отметить, что в листинге 24.7 основное внимание уделяется структуре класса, который используется для вынесения кода, управляющего анимацией. В связи с этим класс Animator не реализует сложные анимационные возможности. Их можно реализовать в классе mx. effects . Tween платформы разработки Flex и классах fl. transitions . Tween и fl. mot ion .Animator среды разработки Flash CS3.
Ниже представлен листинг класса Animator. Понять код помогут комментарии.
Листинг 24.7. Обобщенный вспомогательный класс для создания анимации
package {
import flash.display.*;
Import fl ash.events.*;
Import flash.utils.*;•
// Очень простой класс для создания анимации, который демонстрирует, как // отделить реализацию анимационных возможностей от анимируемого объекта public class Animator extends EventDispatcher {
// Ссылается на анимируемый объект
private var target;Displayobject;
// Всякий раз, когда начинается воспроизведение анимации, мы записываем
// время начала в переменную startTime private var startTime;Number;
// Длительность анимации, в миллисекундах private var duration-.Number;
// Всякий раз, когда начинается воспроизведение анимации, мы сохраняем
// начальную позицию объекта target в переменных startX и startY
private var startX;Number;
private var startY;Number;
// Всякий раз, когда начинается воспроизведение анимации, мы сохраняем
// разницу между начальной и конечной позициями в переменных deltaX
// и deltaY
private var deltaX;Number;
private var deltaY;Number;
// Функция-конструктор принимает ссылку на анимируемый объект public function Animator (target;D1splayObject) {
this.target = target;
}
// Начинает воспроизведение анимации, которая заключается в перемещении // объекта target из его текущей позиции в новую позицию с координатами // (toX, toY) за 1 duration' миллисекунд public function animateTo (toX:Number, toY;Number, duration;Number);void {
// Запоминаем, где находился объект target в момент начала
// воспроизведения данной анимации startX = target.х;
startY = target.у;
// Вычисляем разницу между начальной и конечной позициями
// объекта target
deltaX = toX - target.х;
deltaY = toY - target.у;
startTime = getTimer( );
// Запоминаем длительность данной анимации this.duration = duration;
// Начинаем получать уведомления о возникновении событий
// Event.ENTER_FRAME. Всякий раз, когда происходит
// запланированное обновление экрана, мы будем
// обновлять позицию объекта target
target.addEventListener(Event.ENTER_FRAME, enterFrameListener);
// Обрабатывает события Event.ENTER_FRAME.
private function enterFrameListener (e:Event):void {
// Вычисляем время, прошедшее с момента начала
// воспроизведения анимации
var elapsed:Number = getTimer( )-startTime;
// Вычисляем, сколько времени прошло с момента начала воспроизведения // анимации в процентах от ее общей длительности
var percentDone:Number = elapsed/duration;
// Если анимация еще не завершена...
if (percentDone < 1) {
// ...обновляем позицию объекта target updatePosi ti on(percentDone);
} else {
// ...в противном случае помещаем объект target в его конечное // положение и прекращаем получать уведомления о возникновении // событий Event.ENTER-FRAME updatePosition(l);
target.removeEventListener(Event.ENTER_FRAME, enterFrameListener);
}"
}
// Устанавливает позицию объекта target, выраженную в процентах
// от расстояния между начальной и конечной точками анимации
private function updatePosition (percentDone.-Number):void {
target.x = startX + deltaX*percentDone;
target.у = startY + deltaY*percentDone;
Класс SlidingText, представленный далее в листинге 24.8, демонстрирует применение класса Animator. Каждый объект SlidingText — это текстовое поле, которое может быть перемещено в указанную позицию с использованием анимационных возможностей.
Платформа разработки Flex включает текстовые компоненты, которые могут быть анимированы и стилизованы с помощью множества настраиваемых эффектов. Дополнительную информацию можно получить в описании компонентов mx.controls.Text и mx.controls. TextArea справочника по платформе разработки Flex 2 корпорации Adobe.
Листинг 24.8. Класс, представляющий перемещающийся текст package {
import flash.text.*;
public class SlidingText extends TextFleld {
private var an1mator:An1mator:
public function SlidingText (toX:Number, toY:Number, duration:Number) { animator = new An1mator(th1s);
s!1deTo(toX, toY, duration);
}
public function slideTo (toX:Number, toY:Number. duration:Number):void { animator.an1mateTo(toX, toY, duration):
}
}
}
Класс AnimationLibDemo, представленный в листинге 24.9, демонстрирует, как использовать классы Animator и SlidingText. Он создает круг, который перемещается в текущую позицию указателя мыши, когда пользователь щелкает кнопкой мыши в области отображения среды выполнения Flash. Этот класс также перемещает текст «Hello» в позицию (300; 0) и закрепляет его там.
Листинг 24.9. Демонстрация использования класса Animator package {
Import flash.display.*;
Import flash.events.*;
Import fl ash.text.*;
// Демонстрирует использование класса Animator
public class AnimationLibDemo extends Sprite {
private var circleAn1mator:An1mator;
public function AnimationLibDemo ( ) {
// Создаем сообщение, которое с использованием анимационных
// возможностей перемещается в позицию (300, 0)
// за одну секунду (1000 мс)
var welcome:SlidingText = new Sl1d1ngText(300. 0. 1000):
welcome.text= "Welcome!";
welcome.autoSize = TextFIeldAutoSIze.LEFT;
addChlld(welcome);'
// Создаем круг для анимации
var circle:Shape = new Shape( ):
c1rde.graph1cs.11neSty1e(10, 0x666666);
drde.gra ph1cs.beg1nF111 (0x999999);
circle.graphics.drawCIrcle(0, 0, 25);
addCh1ld(c1rcle):
// Создаем объект Animator для анимации объекта circle drcl eAnimator = new Anlmator(drcle);
// Регистрируем приемник для событий мыши
stage.add EventL1stener(MouseEvent.MOUSE_DOWN. mouseDownLIstener);
}
// Когда пользователь щелкает кнопкой мыши на сцене, перемещаем
// объект circle в точку, где произошел щелчок.
private function.mouseDownLIstener (e:MouseEvent):void {
// Преобразуем точку из системы координат экземпляра класса Stage // в систему координат данного экземпляра класса
var mousePt:Po1nt = globalToLocal(new Po1nt(e.stageX, e.stageY));
c1rcleAn1mator.an1mateTo(mousePt.x, mousePt.y, 500);
При создании элементов управления пользовательского интерфейса с эффектами анимации рассмотрите возможность расширения класса mx.core.UIComponent платформы разработки Flex вместо разработки собственной библиотеки, реализующей анимационные возможности. В классе UlComponent предусмотрен расширенный набор инструментов для добавления эффектов к собственным элементам управления пользовательского интерфейса.
Анимация, основанная на скорости
В среде Flash невозможно гарантировать определенный временной интервал, через который будет выполняться проверка запланированных обновлений экрана или будут возникать события TimerEvent. TIMER. Событие Event. ENTER_FRAME обычно возникает позднее запланированного времени, которое определяется назначенной скоростью кадров, а события TimerEvent. TIMER — позднее времени, определяемого переменной delay объекта Timer.
Подобные задержки могут приводить к непредсказуемым эффектам в анимации. Чтобы гарантировать, что некоторый объект пройдет указанную дистанцию за определенный промежуток времени, мы должны устанавливать позицию этого объекта в соответствии с его скоростью (то есть в соответствии с его ускорением в определенном направлении). В листинге 24.10 продемонстрирована базовая методика.
Листинг 24.10. Вычисление позиции с учетом скорости
package {
Import flash.display.*;
Import flash.events.*;
Import flash.utils.*;
// Перемещает объект на указанное количество пикселов в секунду,
// независимо от скорости кадров
public class Animation'extends Sprite {
private var d1stancePerSecond;1nt = 50; // Количество пикселов,
// на которое должен
// перемещаться объект
// за одну секунду
private var now:1 nt;// Текущее время
private var then:1nt;// Время последнего обновления
// экрана
private var c1rcle;Shape;// Анимируемый объект
public function Animation ( ) {
// Создаем объект для анимации
circle = new Shape( );
c1rcle.graph1cs.beg1nF1ll(OxOOOOFF, 1);
circle, graphics. 11neStyle(1):
circle.graphics.drawEl11pse(0, 0, 25, 25);
addCh1ld(c1rcle);
// Инициализируем значения времени
then = getT1mer( );
now = then;
// Регистрируем приемник для получения уведомлений о проверках
//. запланированных обновлений экрана
addEventLIstener(Event.ENTER_FRAME, enterErametlstener);
}"
// Обрабатываем события Event.ENTER_FRAME
private function enterErametlstener (e;Event):void {
// Вычисляем, сколько времени прошло с момента последнего перемещения then = now;
now = getT1mer( );
var elapsed:1nt = now - then;
var numSeconds;Number = elapsed / 1000;
// Определяем количество пикселов, на которое должен переместиться
// объект, учитывая промежуток времени, прошедший с момента
// последнего перемещения
var moveAmount:Number = dlstancePerSecond * numSeconds;
// Перемещаем объект. В данном случае объект перемещается
// под углом 0 градусов.
circle.x += moveAmount;
}
}'
}
Класс Animator, представленный ранее в листинге 24.7, использует скорость аналогичным образом, чтобы гарантировать, что анимируемый объект пройдет заданное расстояние за указанный промежуток времени.
Переходим к контурам и заливкам
На протяжении нескольких последних глав большую часть времени мы потратили на рассмотрение вопросов, связанных с интерактивностью и анимацией. В последующих трех главах мы уделим особое внимание созданию трех конкретных типов графического содержимого: векторов, растровых изображений и текстовых полей.
Рисование с помощью векторов
В языке ActionScript элементарные векторы, линии и фигуры рисуются с помощью класса Graphics. Тем не менее экземпляры класса Graphics никогда не создаются напрямую; вместо этого каждый класс языка ActionScript, поддерживающий программное векторное рисование, создает экземпляр класса Graphics автоматически и предоставляет к нему доступ через переменную экземпляра graphics. К отображаемым классам, поддерживающим векторное рисование, относятся классы Sprite, MovieClip и Shape.
Объекты Shape потребляют меньше памяти, чем объекты Sprite и MovieClip. Таким образом, чтобы уменьшить потребление памяти, векторное содержимое лучше рисовать в объектах Shape, когда нет необходимости в контейнерных и интерактивных возможностях классов Sprite и MovieClip. ■
Обзор класса Graphics
Как видно из табл. 25.1, инструменты рисования класса Graphics можно разбить на пять общих категорий: рисование линий, рисование фигур (также называемых заливками), определение стилей линий, перемещение чертежного пера и удаление графики.
Таблица 25.1. Обзор класса Graphics
Назначение
Метод класса Graphics
Рисование линий
curveTo(), lineTo()
Рисование фигур
beginBitmapFill(), beginFill(), beginGradientFill(), drawCircle(), drawEllipse(), drawRect(), drawRoundRect(), drawRoundRectComplex(), endFill()
Определение стилей линий
lineGradientStyle(), lineStyle()
Перемещение чертежного пера
moveTo()
Удаление графики
clear()
По существу, в языке ActionScript линии и кривые рисуются гипотетическим «чертежным пером». Для всех новых объектов Sprite, MovieClip и Shape перо первоначально устанавливается в положение (0; 0). По мере рисования линий и кривых (с помощью методов 1 ineTo ( ) и curveTo ( ) ) перо перемещается по координатному пространству объекта, останавливаясь в конечной точке последней нарисованной линии или кривой. Текущая позиция пера всегда обозначает начальную точку следующей рисуемой линии или кривой. Чтобы установить начальную точку линии или кривой в произвольную позицию, мы используем метод move То ( ), который
«поднимает» чертежное перо и перемещает его в новую позицию, не рисуя линию к указанной точке.
Рисование линий
Для рисования прямых линий используется метод ИпеТо ( ), который рисует линию из текущей позиции чертежного пера в указанную точку (х; у). Например, следующий код создает новый объект Shape и рисует линию из точки (0; 0) в точку (25, 35):
var canvas:Shape = new Shape( );
canvas.graphics.11neTo(25, 35):
addChild(canvas);
Однако если вы попытаетесь выполнить этот код таким, как есть, то можете быть удивлены, обнаружив, что на экране не появилось никакой линии! По умолчанию все рисуемые линии и фигуры не имеют контура. Чтобы отобразить контур, мы должны использовать метод lineStyle( ), устанавливающий визуальные характеристики (толщина, цвет и т. д.) для всех линий и фигур, которые будут нарисованы в дальнейшем. Для справки ниже представлена сигнатура метода 1 ineStyle ( ), которая демонстрирует доступные визуальные параметры и их значения по умолчанию. Подробную информацию по каждому параметру можно найти в справочнике по языку ActionScript корпорации Adobe.
11neStyle(th1ckness:Number =1.0, color:uint = 0. alpha:Number =1.0, pixelHinting:Boolean = false, seal eMode:String = "normal", caps:String = null, joints:String = null, miterLimit:Number = 3)
Метод linestyle ( ) должен вызываться явно для каждого нового объекта Sprite, MovieClip и Shape, иначе никакой контур отображен не будет (хотя заполняемые области могут рисоваться без контура).
Рассмотрим несколько примеров, демонстрирующих различные способы изменения стиля линий объекта canvas. Следующий код удаляет стиль линий (нарисованные в дальнейшем линии, кривые и заливки не будут иметь контура):
canvas.graphics.lineStyle( )
Следующий код устанавливает для стиля линий толщину 1 пиксел и сплошной черный цвет:
canvas.graphi cs.1i neStylе(1)
Представленный далее код устанавливает для стиля линий толщину 1 пиксел и сплошной зеленый цвет:
canvas.graphics.1ineStyle(1, OxOOFFOO)
Следующий код устанавливает для стиля линий толщину 2 пиксела и зеленый цвет с прозрачностью 50 %:
canvas.graphics.UneStyleQ, OxOOFFOO, 50)
Теперь нарисуем линию из точки (0; 0) в точку (25; 35), как раньше, но на этот раз применим контур синего цвета толщиной 3 пиксела, заставив эту линию появиться на экране:
var canvas:Shape = new Shape( );
canvas.graphics.lineStyle(3, OxOOOOFF); // Применяем контур синего цвета
canvas.graphics.HneTo(25, 35): addChlld(canvas);
Стоит отметить, что если бы предыдущая линия была нарисована в объекте Sprite или MovieClip, содержащем дочерние отображаемые объекты, она бы отображалась позади этих объектов.
Дочерние отображаемые объекты всегда выводятся перед своим родителем и, следовательно, всегда заслоняют векторное содержимое, нарисованное с помощью языка ActionScript в этом родительском объекте.
Например, следующий код добавляет объект TextField в новый объект Sprite и затем рисует линию в этом объекте Sprite. Объект TextField перекрывает линию, поскольку является ребенком объекта Sprite.
// Создаем объект Sprite и помещаем его на экран
var cental пег:Sprite = new Spritef ); addChlld(contalner);
// Создаем объект TextField
var msg:TextF1eld = new TextF1eld( );
msg.text = "Hello":
msg.border = true:
msg.background = true:
msg.autoSize = TextFieldAutoSize.LEFT:
centalner.addChi1d(msg):
// Рисуем линию
centalner.graphlcs.11neStyle(3, OxOOOOFF):
centalner.graphl cs.HneTo(25, 35):
На рис. 25.1 показан результат выполнения предыдущего кода.
]не11о|
Рис. 25.1. Векторное содержимое позади объекта TextField
Содержимое, нарисованное с помощью объекта graphics в объекте Sprite или MovieClip, всегда отображается позади любых дочерних объектов данного объекта Sprite или MovieClip (то есть заслоняется).
При рисовании нескольких линий стиль контура можно установить для каждой в отдельности, вызывая метод 1 ineStyle ( ) перед рисованием каждой линии. Например, следующий код рисует квадрат с помощью постепенно утолщаемых линий, окрашенных в черный, красный, зеленый и синий цвет:
var canvas:Shape = new Shape( );
canvas.graphics.HneStyleQ, 0x000000);
canvas.graphics.UneToQOO, 0):
canvas.graphics.11neStyle(5, OxFFOOOO);
canvas, graphics. HneTo( 100, 100);
canvas.graphics.HneStyleClO, OxOOFFOO);
canvas.graphics.UneTotO, 100);
canvas.graphics.11neStyle(15, OxOOOOFF);
canvas.graphics.HneToCO, 0): addChlld(canvas);
На рис. 25.2 показаны результаты выполнения предыдущего кода.
Рис. 25.2. Линии с изменяющейся толщиной
Обратите внимание, что на рис. 25.2 конечные точки линий (называемые концами линии) по умолчанию закруглены. Чтобы вместо закругленных концов линий выбрать квадратные, используйте параметр caps метода linestyle ( ). Например, следующий код создает линию зеленого цвета толщиной 10 пикселов с квадратными концами:
canvas.graphics.11neStylе(10, OxOOFFOO, 1, false,
L1neScaleMode.NORMAL, CapsSty1e.SQUARE):
При нулевой толщине контур превращается в визирную линию (ее толщина составляет 1 пиксел и не изменяется даже при увеличении масштаба объекта или области отображения среды выполнения Flash). Другие варианты масштабирования линий можно установить параметром scaleMode метода linestyle ( ).
Чтобы полностью отключить отображение контура, установите толщине значение undefined или вызовите метод linestyle ( ) без параметров. Например:
canvas.graphics.11neStyle(undef1ned); // Выключаем линии в объекте canvas canvas.graphics.lineStyle( );//To же самое
Чтобы переместить чертежное перо, не рисуя при этом вообще никаких линий, используйте метод move То ( ). Предположим, что мы хотим нарисовать в новом объекте Shape одну прямую линию из точки (100; 100) в точку (200; 200). Мы сначала перемещаем перо из точки (0; 0) в точку (100; 100), используя метод moveTo ( ), а затем рисуем линию из этой точки в точку (200; 200) с помощью метода 1ineTo ( ), как показано в следующем коде:
var canvas:Shape = new Shape( ); // Создаем объект Shape для рисования canvas.graphics. 11 neStyle(D- // Устанавливаем контур черного цвета // толщиной 1 пиксел
canvas.graphics.moveToUOO, 100); // canvas.graphics.11пеТо(200, 200); // //canvas.graphics.moveToUOO, 100); // canvas.graphics.11пеТо(200, 200); // //Перемещаем перо, не рисуя линию Рисуем линию (в результате этого действия происходит перемещение пера)Перемещаем перо, не рисуя линию Рисуем линию (в результате этого действия происходит перемещение пера)
canvas.graphics.moveToUOO, 100); // canvas.graphics.11пеТо(200, 200); // //
canvas.graphics.moveToUOO, 100); // canvas.graphics.11пеТо(200, 200); // //
Перемещаем перо, не рисуя линию Рисуем линию (в результате этого действия происходит перемещение пера)
Перемещаем перо, не рисуя линию Рисуем линию (в результате этого действия происходит перемещение пера)
Рисование кривых
Для рисования кривых используется метод curve То ( ), который имеет следующую сигнатуру:'
curveTo(controlX:Number, controlY:Number, anchorX:Number, anchorY:Number)
Метод curveTo ( ) рисует кривую Безье второго порядка из текущей позиции чертежного пера в точку (anchorX; anchorY), используя управляющую точку (controlX; controlY), которая находится за пределами кривой. В каждой конечной точке кривая касается линии, проходящей через данную конечную точку и управляющую точку. Кривая Безье содержится в выпуклой оболочке, построенной по ее трем управляющим точкам.
Говоря по существу, прямая линия, проходящая из позиции пера в конечную точку (anchorX; anchorY), натягивается управляющей точкой (controlX; controlY), формируя кривую. Если любой из аргументов метода curveTo ( ) будет опущен, операция завершится без сообщения об ошибке и позиция чертежного пера останется неизменной. Как и в случае с методом 1 ineTo ( ), характеристики контура кривой (толщина, цвет, прозрачность и т. д.) определяются самым, последним вызовом функции lineStyle ( ).
Следующий код рисует кривую черного цвета толщиной в 4 пиксела из позиции по умолчанию (0; 0) чертежного пера в якорную точку (100; 0), используя управляющую точку (50; 100). Кривая, получающаяся в результате выполнения этого кода, изображена на рис. 25.3.
var canvas:Shape = new Shape( );
addChild(canvas);
canvas.graphics.HneStyle(4); // Устанавливаем контур толщиной 4 пиксела // черного цвета
canvas.graphics.curveTo(50, 100, 100, 0); // Рисуем кривую
Рис. 25.3. Кривая Безье второго порядкаРис. 25.3. Кривая Безье второго порядка
Рис. 25.3. Кривая Безье второго порядка
Рис. 25.3. Кривая Безье второго порядка
После того как кривая будет нарисована, чертежное перо останется в ее конечной точке. Таким образом, многократно вызывая функцию curveTo ( ) и/или lineTo ( ), можно нарисовать сложные кривые или замкнутые фигуры, например окружности или многоугольники, — эта методика будет рассмотрена в следующем разделе.
Кривые, нарисованные на дробных пикселах, зачастую выглядят размытыми. Для увели- $ ^ # чения резкости размытых, сглаженных линий присвойте параметру pixelHinting метода - lineStyle() значение true.
Иногда бывает более удобно указать три точки на кривой, нежели две якорные точки и управляющую точку. Следующий код определяет пользовательский метод curveThrough3Pts ( ), который принимает координаты трех точек в качестве аргументов и рисует кривую второго порядка, проходящую через эти точки. Предполагается, что вторая точка находится посередине кривой (t = .5):
// Адаптированный метод drawCurve3Pts( ) Роберта Пеннера (Robert Penner) public function curveThrough3Pts (g:Graph1cs,startX:Number, startY:Number. throughX:Number. throughY:Number. endX:Number, endY:Number) {
var controlX:Number = (2 * throughX) - .5 * (startX + endX);
var controlY:Number = (2 * throughY) - .5 * (startY + endY);
g.moveTo(startX, startY):
g.curveTo(controlX, controlY, endX, endY):
// Использование
var canvas:Shape = new Shape( ):'
addChlld(canvas):
canvas.graphics.lineStyle(2, OxOOOOFF):
curveThrough3Pts(canvas.graph1cs, 100, 100, 150, 50, 200, 100):
Дополнительную информацию по теории кривых в языке ActionScript можно найти в статье «TechNotes» Джима Армстронга (Jim Armstrong) по адресу http:// www.algorithmist.net/technotes.html.
Рисование фигур
Чтобы нарисовать фигуру произвольной формы (то есть закрасить некоторым цветом геометрическую область, образованную тремя или более точками), выполняйте такую последовательность действий.
Выберите начальную точку фигуры (либо точку по умолчанию (0,0), либо точку, указанную методом moveTo ( ) ).
Начните рисование с вызова метода beginBitmapFill ( ), beginFill ( ) или beginGradientFill ( ).
Нарисуйте контур фигуры, последовательно вызывая функцию lineTo ( ) и/или curveTo ( ). Конечная точка последнего сегмента контура должна совпадать с начальной точкой, указанной на шаге 1.
Завершите рисование фигуры вызовом метода endFill ( ).
Метод beginFill( ) позволяет заполнить фигуру сплошным цветом; метод beginGradientFill ( ) —градиентом (переходом между двумя или более цветами); втoвpeмякaкмeтoдbeginBitmapFill ( ) использует для заполнения фигуры указанное растровое изображение (при желании его можно разместить в виде мозаики).
Например, следующий код рисует треугольник красного цвета с контуром толщиной 5 пикселов черного цвета. Обратите внимание, что начальная точка контура (0; 0), устанавливаемая по умолчанию, совпадает с конечной точкой контура: var trianglе:Shape = new Shape( ): triangle.graphlcs.beg1nF111(OxFFOOOO, 1);
tri angle.graphics.11neSty1e(20);
triangle.graphics.lineTo(125, 125): // Рисует линию вниз и вправо
triangle.graphics.lineTo(250, 0);// Рисует линию вверх и вправо
triangle.graphics.11neTo(0, 0):// Рисует линию влево
triangle.graphics.endFilK ):
addChi1d(tri anglе):
На рис. 25.4 показаны результаты выполнения предыдущего кода.
Рис. 25.4. Треугольник
Обратите внимание, что углы треугольника на рис. 25.4 закруглены. Стиль отображения углов задается параметром joints метода linestyle ( ). Например, следующий код изменяет стиль отображения углов, чтобы они выглядели «скошенными», — для этого в качестве параметра joints передается константа Jointstyle.MITER:
triangle.graphics.1ineStyle(20, 0, 1. false. LineScaleMode.NORMAL, CapsSty1e.ROUND, JointSty1e.MITER):.
На рис. 25.5 показан результат данного изменения. Обратите особое внимание на новую форму углов треугольника.
Рис. 25.5. Треугольник со скошенными соединениями
Для рисования различных видов прямоугольников и эллипсов класс Graphics предоставляет следующие удобные методы: drawCircle ( ), drawEllipse ( ), drawRect ( ), drawRoundRect ( ) и drawRoundRectComplex ( ). Методы round rect рисуют прямоугольники с закругленными углами. Все методы, упрощающие рисование фигур, используются совместно с уже знакомыми вам методами linestyle ( ) HbeginFill( ). Тем не менее вызывать метод endFill ( )
после завершения рисования фигуры необязательно, поскольку каждый из перечисленных методов делает это автоматически.
Следующий код демонстрирует общий подход к использованию методов для рисования фигур. В нем применяется ме^од drawRect ( ) для рисования прямоугольника синего цвета с контуром толщиной 1 пиксел черного цвета:
var canvas:Shape = new Shape( ): addChild(canvas):
// Устанавливаем толщину, равную одному пикселу canvas.graphics.11neSty1e(1):
// Устанавливаем синий цвет заливки
canvas.graphics.beginFi11(OxOOOOFF);
// Рисуем фигуру
canvas.graph!cs.drawRect(0, 0, 150, 75):
//Обратите внимание на отсутствие вызова метода endFill( )
Удаление векторного содержимого
Для удаления всего векторного содержимого из объекта применяется метод экземпляра clear ( ) класса Graphics. Например:
var canvas:Shape = new Shape( ):
// Рисуем линию
canvas.graphics.lineStyle(3, OxOOOOFF): // Применяем контур синего цвета canvas.graphics.lineTo(25, 35):
addChild(canvas):
// Удаляем линию
canvas.graphics.clear( ):
Когда происходит вызов метода clear ( ), стиль линий объекта возвращается к значению undefined (без контура). После вызова метода clear ( ) метод linestyle ( ) должен быть вызван снова, иначе у линий и фигур будет отсутствовать контур. Вызов метода clear ( ) также сбрасывает позицию чертежного пера в точку (0; 0). Стоит отметить, что этот метод влияет на векторное содержимое только одного объекта. Если данный объект является экземпляром класса Sprite или MovieClip, то метод clear ( ) не удалит ни векторное содержимое в его дочерних объектах, ни сами дочерние объекты.
Следующий код каждые 250 мс рисует линию со случайными координатами и случайным стилем контура. Для удаления предыдущей нарисованной линии в нем используется метод с 1 е а г ( ).
package {
import fl ash.di splay.*:
import flash.utils.*:
import fl ash.events.*:
public class RandomLines extends Sprite {
private var s:Shape:
public function RandomLlnes ( ) { s = new Shape( );
addChlld(s);
van t:T1mer = new T1mer(250):
t.addEventL1stener(T1merEvent.TIMER. timerLIstener): t.start( );
}
private function timerLIstener (e:T1merEvent):void {
s.graphics.clear( ):
s.graphics.11neStyle(random(l. 10). random(0. OxFFFFFF)):
s.graphics.moveTo(random(0, 550). random(0. 400));
s.graphics.11neTo(random(0, 550). random(0. 400)):
}
// Возвращает число в диапазоне от mlnVal до maxVal включительно
public function random (minVakint. maxVal:int):1 nt {
return mlnVal + Math.floor(Math.random( ) * (maxVal + 1 - mlnVal)):
}
} }
Упражнение: для сравнения попробуйте удалить вызов метода clear ( ) в первой строке метода timerLIstener ( ).
Пример: библиотека объектно-ориентированных фигур
Графическое содержимое, создаваемое с помощью внутренних методов рисования фигур (drawEllipse ( ), drawRect ( ) и т. д.), не связано ни с каким объектом. После того как оно будет нарисовано, его невозможно изменить или удалить независимо от другого содержимого. В ActionScript отсутствуют классы, предоставляющие объектно-ориентированный доступ к соответствующим фигурам на экране. В этом разделе продемонстрирован один из способов устранения данного недостатка — пример реализации небольшой библиотеки классов для создания и управления фигурами как объектами.
В нашей библиотеке фигур представлены следующие классы: Basics Наре, Rectange, Ellipse, Star и Polygon. Класс BasicShape — это базовый класс библиотеки. Он расширяет внутренний класс Shape, который предоставляет базовую поверхность с минимальным потреблением ресурсов для рисования фигур. Класс BasicShape управляет стилями контура и заливки для всех фигур и определяет, когда фигура должна быть перерисована. Экземпляры остальных классов представляют геометрические фигуры, которые могут добавляться в список отображения или удаляться из него. Класс каждой фигуры реализует свою собственную процедуру рисования, учитывающую особенности построения
данной фигуры. После создания объекта фигуры ее штриховка, заливка и контур могут быть легко изменены.
В следующих шести примерах применяются на практике многие методики, которые были рассмотрены в этой книге, — особенно те, которые были рассмотрены в этой главе. Обращайте пристальное внимание на многочисленные комментарии; они помогут вам понять код.
В листинге 25.1 представлен класс BasicShape — класс абстрактного типа, который определяет базовую функциональность для всех фигур в нашей библиотеке классов. Его основные возможности реализуются с помощью следующих методов:
setStrokeStyle ( ) и setFillStyle ( ) — сохраняют визуальные характеристики фигуры;
draw ( ) — отображает фигуру, но делегирует конкретное рисование линий методу drawShape ( ) (абстрактному методу, реализуемому всеми подклассами);
setChanged( ), clearChanged ( ) и hasChanged( ) — позволяют отслеживать, изменились ли параметры фигуры с момента ее последнего отображения на экране;
□ reguestDraw( ), addedListener ( ), removedListener ( ), а также renderListener ( ) — в сочетании эти методы определяют момент, когда необходимо перерисовать фигуру.
Листинг 25.1. Класс BasicShape
package org.moock.drawl ng {
import flash.display.*;
Import flash.events.*;
Import fl ash.errors.IllegalOperatlonError;
// Базовый класс для отображаемых геометрических фигур
public class BasicShape extends Shape {
// Стиль заливки
protected var fill Col or .-Number = OxFFFFFF:
protected var fill Alpha .-Number = 1;
// Стиль линий. Используются скошенные соединения вместо закругленных
/ (настройка по умолчанию в языке Act1onScr1pt). Все остальные
// первоначальные настройки совпадают с настройками по умолчанию языка // Act1 onScnpt.
protected var UneThickness: Number = 1;
protected var HneColor:u1nt = 0;
protected var 1 IneAlpha:Number = 1;
protected var UnePixelHinting;Boolean = false;
protected var UneScal eMode: String = LIneScal eMode.NORMAL;
protected var UneJoints:String = Jointstyle.MITER;
protected var HneM1terL1m1t:Number = 3;
// Флажок, указывающий на необходимость перерисовки объекта.
// Предотвращает перерисовку данного объекта в тех случаях, когда
// событие RENDER было запрошено другим объектом, protected var changed:Boolean = false:
// Конструктор
public function BasicShape ( ) {
// Регистрируем приемники для получения уведомлений, когда данный // объект добавляется в список отображения или удаляется из него // (требуется пользовательский вспомогательный класс StageDetector) var StageDetector:StageDetector = new StageDetector(this): StageDetector.addEventLi stener(StageDetector.ADDED_TO_STAGE, addedToStageListener):
StageDetector.addEventListener(StageDetector.REMOVED_FROM_STAGE, removedFromStageListener):
// Устанавливает визуальные характеристики линии.
// отображаемой вокруг фигуры
public function setStrokeStyle (thickness:Number = 1.
color:uint = 0.
alpha:Number = 1.
pixel Hinting .-Boolean = false.
seal eMode:String = "normal".
joints:String = "miter".
miterLimit:Number = 10):void { lineThickness = thickness:, lineColor = color:
1 ineAlpha = alpha:
linePixelHinting = pixel Hinting:
lineScaleMode = seal eMode:
linejoints = joints:
1ineMiterLimit = miterLimit:
// Стиль линий изменился, поэтому просим уведомить нас о следующем // обновлении экрана. В тот момент перерисовываем фигуру.
setChanged( ):
}
// Устанавливает визуальные характеристики заливки фигуры public function setFillStyle (color:uint = OxFFFFFF.
alpha:Number = l):void {
fillColor = color:
fillAlpha = alpha:
// Стиль заливки изменился, поэтому просим уведомить нас о следующем // обновлении экрана. В тот момент перерисовываем фигуру.
setChanged( ):
// Создает графику фигуры, делегируя специфические операции рисования // линий конкретным подклассам класса BasicShape. Для повышения // производительности метод draw( ) вызывается только в тот момент.
// когда объект stage рассылает событие Event.RENDER.
private function draw ( ):void {
// Удаляет всю графику из данного объекта.
graphics.clear( ):
// Стиль концов линий не имеет значения для замкнутой фигуры, поэтому
// передаем значение null для этого аргумента.
graphics. lineStyledineThickness, 1 ineCol or, 1 ineAlpha,
linePixelHinting, lineScaleMode, null, linejoints, 1ineMiterLimit):
graphics.beginFill(fillColor, fill Alpha);
drawShape( ): // Вызываем процедуру рисования, реализуемую подклассом graphics.endFilК ):
// Делаем пометку, что на экране отображены самые последние изменения. clearChanged( ):
// Рисует фактические линии для фигуры каждого типа. Должен быть
// реализован всеми подклассами класса BasicShape.
protected function drawShape ( ):void {
// Предотвращает непосредственный вызов данного метода абстрактного типа
throw new II 1egalOperationError("The drawShape( ) method can be "
+ "invoked on BasicShape subclasses only.")
// Помечает, что в фигуре изменился какой-то параметр. Если на настоящий // момент фигура отображается на сцене, заставляет ее перерисоваться // на этапе следующей визуализации экрана protected function setChanged ( ):void {
changed = true:
requestDraw( ):
// Помечает, что самые последние изменения были отображены на экране protected function clearChanged ( ):void {
changed = false;
// Сообщает о том, были ли изменены какие-либо параметры фигуры, которые
// еще не были визуализированы
protected function hasChanged ( ):Boolean {
return changed:
// Если данная фигура отображается на экране, метод requestDraw( )
// заставляет ее перерисоваться на этапе следующего обновления экрана protected function requestDraw ( ):void {
if (stage != null) {
stage.invalidate( ):
// Приемник события, вызываемый при добавлении этой фигуры
// в список отображения
private function addedToStageLI stener (e:Event):void {
// Регистрируем приемник для получения уведомлений
// об обновлениях экрана
stage. addEventListener(Event. RENDER. renderLI stener):
// Если объект изменился за то время, пока он отсутствовал в списке
// отображения, отображаем эти изменения на этапе следующей
// визуализации экрана. Однако если объект не изменился с момента,
// когда он находился в списке отображения последний раз,
// нет необходимости перерисовывать его.
1f (hasChanged( )) {
requestDraw( );
}
}
// Приемник события, вызываемый при удалении данной фигуры
// из списка отображения
private function removedFromStageLlstener (e:Event):void {
// Нет необходимости получать уведомления о возникновении событий
// Event.RENDER, когда объект не находится в списке отображения stage.removeEventL1stener(Event.RENDER, renderLIstener);
}
// Приемник события, вызываемый перед обновлением экрана, если был
// вызван метод stage.1nval1date( ).
private function renderLIstener (erEvent):void {
// Вызываем метод draw( ), если изменения, внесенные в данную фигуру,
// не были отображены на экране.
// Если событие для визуализации было запрошено другим объектом,
// но данный объект не изменялся, он не будет перерисован.
if (hasChanged( )) {
draw( );
}
}
}
}
В листинге 25.2 представлен класс Ellipse — подкласс класса BasicShape. Обратите внимание, что специфический код, предназначенный для рисования эллипса, содержится в методе drawShape ( ). Более того, изменение размеров объекта Ellipse не приводит к немедленной перерисовке эллипса. Вместо этого, когда вызывается метод set Si ze ( ), объект вызывает метод setChanged ( ), сообщая о том, что данный объект должен быть перерисован на этапе следующей визуализации экрана, осуществляемой средой выполнения Flash.
Листинг 25.2. Класс Ellipse
package org.moock.drawl ng {
// Представляет эллипс, который может быть нарисован на экране
public class Ellipse extends BasicShape {
// Ширина и высота эллипса
protected var w:Number; protected var h:Number;
// Конструктор
public function Ellipse (width;Number = 100, height;Number =100) {
super( );
setS1ze(w1dth, height);
}
// Процедура рисования эллипса
override protected function drawShape ( ):vo1d {
graphics.drawEl11pse(0, 0. w, h);
}
// Устанавливает ширину и высоту эллипса
public function setSIze (newWi’dth: Number, newHelght;Number):void {
w = newWIdth;
h = newHelght;
// Поскольку установка ширины и высоты эллипса вызывает изменение его
// формы, он должен быть перерисован на этапе следующей визуализации
// экрана.,
setChanged( );
}
}
}
В листинге 25.3 представлен класс Polygon — еще один подкласс класса Bas ieShape. С помощью класса Polygon можно нарисовать любую многогранную фигуру. Он выступает в роли суперкласса для определенных типов многоугольников, например Rectangle и Star. Как и Ellipse, класс Polygon предоставляет свою собственную специфическую процедуру рисования в методе drawShape ( ). Всякий раз, когда задаются точки объекта Polygon (через метод setPoints ( ) ), вызывается метод setChanged ( ), сообщающий о том, что данный объект должен быть перерисован на этапе следующей визуализации экрана, осуществляемой средой выполнения Flash.
Листинг 25.3. Класс Polygon
package org.moock.drawl ng {
// Представляет многоугольник, который может быть нарисован на экране public class Polygon extends BasicShape {
// Точки многоугольника.
// Чтобы сократить потребление памяти, точки хранятся в виде двух
// массивов целочисленных значений, а не в виде одного массива объектов
// f1 ash.geom.Point.
private var xpolnts;Array;
private var ypo1nts;Array;
// Конструктор
public function Polygon (xpolnts;Array = null, ypo1nts;Array = null) {
super( );
setPo1nts(xpo1nts, ypoints);
}
// Процедура рисования многоугольника
override protected function drawShape ( ):void {
// Рисуем линии в каждую точку многоугольника
graphics.moveTo(xpo1nts[0], уро1ntsEO]);
for (var 1:1nt = 1; 1 < xpo1nts.length; 1++) {
graphics.11neTo(xpo1nts[1], ypo1ntsE1]);
}
// Замыкаем фигуру, возвращаясь в первую точку
graphics.11neTo(xpo1ntsЕО], ypo1nts[0]);
}
// Присваивает точки многоугольника
public function setPolnts (newXPolnts:Array, newYPolnts:Array):void {
1f (newXPolnts == null || newYPolnts == null) { return;
}
1f (newXPolnts.length != newYPolnts.length) {•
throw new Error("setPo1nts( ) requires a matching "
+ "number of x and у points");
}
xpolnts = newXPolnts;
ypoints = newYPolnts;
// Поскольку присваивание новых точек многоугольника вызывает
// изменение его формы, он должен быть перерисован на этапе
// следующей визуализации экрана.
setChanged( );
}
}■
}
В листинге 25.4 представлен класс Rectangle — подкласс класса Polygon. По структуре он похож на класс Ellipse, однако использует процедуру рисования из метода экземпляра drawShape ( ) класса Polygon, а не реализует собственную.
Листинг 25.4. Класс Rectangle
package org.moock.drawl ng {
// Представляет прямоугольник, который может быть нарисован на экране
public class Rectangle extends Polygon {
// Ширина и высота прямоугольника
protected var w:Number;
protected var h:Number;
// Конструктор
public function Rectangle (width:Number = 100, he1ght:Number = 100) {
super( );
setSize(w1dth, height);
}
// Устанавливает ширину и высоту многоугольника
public function setSize (newWidth:Number, newHeight:Number):void {
w = newWidth;
h = newHeight;
// Переводим ширину и высоту в точки многоугольника setPoints([0.w,w,0],[0,0,h,h]);
}
}
}
В листинге 25.5 представлен последний класс из библиотеки: Star, еще один подкласс класса Polygon. Как и Rectangle, класс Star использует метод экземпляра drawShape ( ) класса Polygon для отображения своего контура. Визуальные характеристики каждого объекта Star задаются через метод setstar ( )..
Листинг 25.5. Класс Star
package org.moock.drawing {
// Представляет фигуру звезды, которая может быть нарисована на экране .
public class Star extends Polygon {-
// Конструктор
public function Star (numTips:int,,
innerRadius:Number, outerRadius:Number, angle-.Number = 0) { super( );
setStar(numTips, innerRadius, outerRadius, angle);
}
// Устанавливает физические характеристики звезды.
// За основу взяты методы рисования Рика Эвинга (Ric Ewing) для языка
// ActionScript 1.0, доступные по адресу;
// http://www.adobe.com/devnet/flash/articles/adv_draw_methods.html
// numTips Количество концов (должно быть 3 или больше)
//innerRadius Радиус основания концов
//outerRadius Радиус вершин концов
// angle Начальный угол в градусах (по умолчанию 0)
public function setstar (numTips:int,
innerRadius:Number, outerRadius:Number, angle:Number = 0):void { // Вычисляем точки многоугольника-звезды if (numTips > 2) {
// Инициализируем переменные
var pointsX:Array = [];
var pointsY:Array = [];
var centerX:Number = outerRadius;
var centerY:Number = outerRadius;
var step-.Number, halfStep: Number, startAngle-.Number, dx:Number, dy:Number:
// Вычисляем расстояние между концами
step = (Math.PI*2)/numT1ps:
halfStep = step/2:
// Вычисляем начальный угол, в радианах
startAngle = (angle/180)*Math.PI:
// Задаем начальную точку
po1ntsX[0] = centerX+(Math.cos(startAngle)*outerRad1us):
po1ntsY[0] = centerY-(Math.s1n(startAngle)*outerRad1us);
// Добавляем оставшиеся точки
for (var 1:1nt=l: 1 <= numTips: 1++) {
dx = centerX+Math.cos(startAngle+(step*!)-halfStep)*1nnerRadi us:
dy = centerY-Math.s1n(startAngle+(step*1)-halfStep)*1nnerRadi us: pointsX.push(dx): polntsY.push(dy):
dx = centerX+Math.cos(startAngle+(step*1))*outerRad1us:
dy = centerY-Math.s1n(startAngle+(step*1))*outerRad1us: polntsX.push(dx);
polntsY.push(dy):
}
// Сохраняем вычисленные точки звезды
• setPolnts(ро1ntsX,ро1ntsY);
}
}
}
}
Наконец, в листинге 25.6 представлен класс ShapeRandomizer, который демонстрирует использование библиотеки классов фигур из пяти предыдущих примеров. Метод-конструктор класса ShapeRandomizer создает четыре фигуры. Щелчок кнопкой мыши на сцене случайным образом изменяет штриховку, заливку и контуры данных фигур.
Листинг 25.6. Класс ShapeRandomizer
package {
Import flash.display.Sprite:
Import flash.events.MouseEvent:
Import org.moock.drawl ng.*:
// Демонстрация использования библиотеки org.moock.drawl ng.
// Создает случайные фигуры, когда пользователь
// щелкает кнопкой мыши на сцене.
public class ShapeRandomizer extends Sprite {
// Фигуры
private var rect:Rectangle:
private var ell:Ellipse:
private var poly:Polygon:
private var star:Star;
// Конструктор
public function ShapeRandomlzer ( ) {
// Создаем прямоугольник
rect = new Rectangle(50, 100);
rect. setStrokeSty led, OxFFOOOO);
rect.setF111Style(OxOOOOFF):
// Создаем эллипс
ell = new Ell1pse(250, 50);
ell.setStrokeStyle(2, OxFFFFOO);
ell.setF111Style(0xED994F);
// Создаем треугольник (то есть трехгранный объект Polygon)
poly = new Polygon([0, 50, 100], [50, 0, 50]);
poly.setStrokeStyle(4, 0x333333);
poly.setF111Style(0x00FF00);
// Создаем звезду
star = new Star(5, 30, 80);
star.setStrokeStyle(4, 0x666666);
star.setF111Style(OxFFOOOO);
// Добавляем фигуры в список отображения
addChl1d(rect);
addCh1ld(ell);
addChl1d(poly);
addChl1d(star);
// Регистрируем приемник для событий
// щелчка кнопкой мыши
stage.addEventListener(MouseEvent.MOUSE_DOWN, mouseDownLIstener);
}
// Приемник событий, вызываемый в тот момент, когда пользователь щелкает
// в области отображения среды выполнения Flash Player
private function mouseDownLIstener (e;MouseEvent);void {
// Изменяем фигуры случайным образом
rect.width = randomd, 300);
rect.height = randomd, 300);
rect. setStrokeStyle( randomd, 10), random(0, OxFFFFFF));
rect.setF1HStyle(random(0, OxFFFFFF), Math.random( ));
ell.width = randomd, 300);
ell.height = randomd, 300);
ell .setStrokeStyle(randomd, 10), random(0, OxFFFFFF)); .
ell.setF1llStyle(random(0, OxFFFFFF), Math.random( ));
poly.setPo1nts([random(l, 300), randomd, 300), randomd, 300)], [randomd, 300), randomd, 300), randomd, 300)]);
poly.setStrokeStyle(randomd, 10), random(0, OxFFFFFF));
poly.setF111Style(random(0, OxFFFFFF), Math.random( ));
star.setStar(random(3, 15), randomdO, 20), random(30, 80));
star.setStrokeStylе(random(1, 10), random(0, OxFFFFFF)); star.setFillStyle(random(0. OxFFFFFF), Math.random( ));
// Возвращает число в диапазоне от mlnVal до maxVal включительно
public function random (minVal:int, maxVal:int):int {
return minVal + Math.floor(Math.random( ) * (maxVal + 1 - minVal)):
}
}
}
На рис. 25.6 продемонстрирован набор случайных фигур, созданных классом ShapeRandomizer.
Рис. 25.6. Фигуры, созданные классом ShapeRandomizerРис. 25.6. Фигуры, созданные классом ShapeRandomizer
Рис. 25.6. Фигуры, созданные классом ShapeRandomizer
Рис. 25.6. Фигуры, созданные классом ShapeRandomizer
От линий к пикселам
В этой главе вы узнали, как создавать векторное графическое содержимое и управлять им. В следующей главе мы рассмотрим методики создания и управления растровым графическим содержимым.
Дополнительную информацию по векторной графике можно найти в документации по классу Graphics в справочнике по языку Actionscript корпорации Adobe.
Программирование растровой графики
В терминах программирования растровое изображение — это изображение, которое хранится в растровом формате данных. Растровый формат данных представляет изображение в виде прямоугольной сетки пикселов, в которой каждому пикселу присваивается число, обозначающее его цвет.
Увеличенное изображение для показа пикселовУвеличенное изображение для показа пикселовКоординаты и значения цвета выбранных пикселовКоординаты и значения цвета выбранных пикселовРис. 26.1. Пример растрового изображенияРис. 26.1. Пример растрового изображенияНапример, если изображение, ширина и высота которого составляют 16 пикселов, представить в растровом формате данных, то оно будет сохранено в виде списка, состоящего из 256 чисел, каждое из которых обозначает конкретный цвет. Этот пример проиллюстрирован на рис. 26.1 — изображение размером 16 х 16 пикселов увеличено с целью отображения его отдельных пикселов. В правой части рисунка указаны позиции в таблице и значения цвета для трех выбранных в изображении пикселов. Обратите внимание, что позиции в таблице начинаются с нуля, поэтому координатой левого верхнего пиксела является (0; 0), а правого нижнего-(15; 15).
Увеличенное изображение для показа пикселов
Увеличенное изображение для показа пикселов
Координаты и значения цвета выбранных пикселов
Координаты и значения цвета выбранных пикселов
Рис. 26.1. Пример растрового изображения
Рис. 26.1. Пример растрового изображения
Исходноеизображение
В этой главе мы рассмотрим ряд распространенных методик, связанных с программированием растровой графики. Тем не менее имейте в виду, что исчерпывающему описанию программирования растровой графики в языке ActionScript могла бы быть посвящена целая книга. (
В качестве источника информации для дальнейшего изучения можно использовать справочник по языку ActionScript корпорации Adobe.
Классы BitmapData и Bitmap
В языке ActionScript класс BitmapData представляет данные изображения в растровом формате наподобие того, которое показано на рис. 26.1. Каждый экземпляр класса BitmapData содержит список значений цвета пикселов и переменные экземпляра width и height, которые управляют размещением этих пикселов на экране. С помощью класса BitmapData мы можем создать данные для совершенно нового растрового изображения или просмотреть и изменить данные любого существующего растрового изображения, включая растровые изображения, загружаемые извне.
Класс BitmapData предоставляет широкий набор инструментов для установки или получения значения цвета некоторого пиксела или группы пикселов, а также для создания распространенных графических эффектов, например эффекта размытия или падающей тени. Как мы увидим далее, класс BitmapData может быть использован даже для создания анимированных эффектов и определения столкновений на основе растровых изображений. Для работы с большей частью инструментов класса Bi tmapData мы должны получить представление о формате, используемом языком ActionScript для описания значения цвета пиксела, который рассматривается в следующем разделе. 1
Как видно из названия, объект BitmapData сам по себе не является изображением; он лишь хранит представляющие изображение данные в растровом формате. Чтобы создать реальное, отображаемое на экране изображение, используя информацию, хранящуюся в объекте BitmapData, мы должны соединить этот объект с экземпляром класса Bitmap, как описано далее в разд. «Создание нового растрового изображения». Класс Bitmap является потомком класса DisplayOb j ect, осуществляющим отображение объекта BitmapData на экране.
При работе с растровыми изображениями класс Bitmap используется для управления изображением как отображаемым объектом, а класс BitmapData — для управления нижележащими пиксельными данными изображения.
Благодаря разделению представления изображения (класс Bitmap) и хранилища данных (класс BitmapData), архитектура растровых изображений языка ActionScript позволяет нескольким различным объектам Bitmap одновременно отображать один и тот же объект BitmapData, при этом каждый объект Bitmap может иметь собственные визуальные характеристики (то есть различный масштаб, угол поворота, обрезку, фильтры, преобразования и прозрачность).
Перед тем как познакомиться с методикой создания нового растрового изображения, бегло рассмотрим способ представления цветов в языке ActionScript.
Значения цвета пикселов
В языке ActionScript значения цвета пикселов, формирующих растровые изображения, сохраняются в виде 32-битных беззнаковых целых чисел, обеспечивая огром-
ный диапазон из 4 294 967 296 возможных значений цветов. Каждое конкретное значение цвета в объекте BitmapData концептуально состоит из четырех отдельных значений, которые представляют четыре различных компонента цвета — Alpha (Альфа) (то есть прозрачность), Red (Красный), Green (Зеленый) и Blue (Синий). Эти четыре компонента называются цветовыми каналами. Величина каждого канала в любом цвете варьируется от 0 до 255. Соответственно в двоичном виде каждый канал занимает 8 из 32 бит значения цвета, как показано далее:
Alpha — биты 24-31 (самый старший байт);
Red — биты 16-23;
Green — биты 8-15;
Blue — биты 0-7.
Чем выше значение канала Red, Green или Blue, тем больший вклад вносит каждый цвет в результирующий цвет. Если значения всех трех каналов RGB равны, будет получен оттенок серого цвета; если значения всех каналов равны 0, будет получен черный цвет; если значения всех каналов равны 255, будет получен белый цвет. Данный 32-битный формат цвета позволяет задать 16 777 216 возможных цветов, при этом каждый цвет может иметь отдельный уровень канала Alpha, находящийся в диапазоне от 0 (прозрачный) до 255 (непрозрачный).
Например, чистый красный цвет описывается следующими значениями каналов:
Alpha: 255, Red: 255, Green: 0, Blue: О
Эти значения соответствуют следующим установкам битов в 32-битном беззнаковом целочисленном значении цвета (пробелы определяют границы четырех байтов):
11111111 ШПШ 00000000 00000000
В десятичном виде предыдущее целочисленное значение будет выглядеть следующим образом:
4294901760
Безусловно, когда значение цвета представлено в виде одного десятичного числа, уровни различных каналов в этом значении цвета неочевидны. В связи с этим значения цвета пикселов для удобочитаемости обычно записываются в шестнадцатеричном виде: OxAARRGGBB, где АА, RR, GG и ВВ — это двухразрядные шестнадцатеричные числа, представляющие каналы Alpha, Red, Green и Blue. Например, предыдущее значение для чисто красного цвета (А:255, R:255, G:0, В:0) в шестнадцатеричном виде записывается следующим образом:
OxFFFFOOOO // Гораздо проще читать!
Для сравнения на рис. 26.2 представлено изображение, заимствованное из рис. 26.1, но на этот раз значения цвета трех выбранных пикселов разбиты на соответствующие цветовые каналы, записанные в шестнадцатеричном виде.
Пример перевода чисел в шестнадцатеричную систему счисления можно найти по адресу http://www.moock.org/asdg/technotes/basePrimer.
Увеличенное изображение для показа пикселовУвеличенное изображение для показа пикселовКоординаты и значения цвета выбранных пикселовКоординаты и значения цвета выбранных пикселовРис. 26.2. Растровое изображение с шестнадцатеричными значениями цветаРис. 26.2. Растровое изображение с шестнадцатеричными значениями цветаИсходноеизображение
Увеличенное изображение для показа пикселов
Увеличенное изображение для показа пикселов
Координаты и значения цвета выбранных пикселов
Координаты и значения цвета выбранных пикселов
Рис. 26.2. Растровое изображение с шестнадцатеричными значениями цвета
Рис. 26.2. Растровое изображение с шестнадцатеричными значениями цвета
Чтобы получить значение отдельного канала из 32-битного значения цвета, мы можем использовать совместно оператор сдвига вправо и оператор побитового И, как показано в следующем коде:
var colorValue:uint = 0xFFFFCC99; // Выбранныйцвет
var alpha:u1nt = (colorValue » 24) & OxFF;//ВыделяемканалAlpha
var red:u1nt = (colorValue » 16) & OxFF;//ВыделяемканалRed
var green:uint = (colorValue » 8) & OxFF;//ВыделяемканалGreen
var blue:uint = colorValue & OxFF;//ВыделяемканалBlue
trace(alpha, red, green, blue): // Отображает: 255 255 204 153
Пример использования побитовых операций можно найти в технических записках по адресу http://www.moock.org/asdg/technotes/bitwise.
Хотя непосредственно изменить значение отдельного канала в существующем 32-битном значении цвета невозможно, мы можем достичь этого эффекта, используя комбинацию бинарных операций. Сначала мы очищаем байт нужного канала в существующем значении цвета; затем мы объединяем получившееся число с новым значением цветового канала. Эта методика продемонстрирована в следующем коде. При его выполнении создается число, которое является результатом вставки шестнадцатеричного значения АА в существующее значение цвета:
var colorValue:u1nt = 0xFFFFCC99; // Выбранный цвет
// Очищаем байт канала Red в исходном значении цвета и присваиваем результат
// обратно переменной colorValue
colorValue &= OxFFOOFFFF;
// Объединяем значение переменной colorValue с новым значением канала Red
colorValue |= (ОхАА«16);
trace(colorValue.toStr!ng(16)): // Выводит: ffaacc99
Внимательно посмотрите на последнюю строку кода:
trace(colorValue.toStr!ng(16)); // Выводит: ffaacc99
Этот код генерирует строку в шестнадцатеричном формате для числового значения цвета, вызывая над этим значением метод toStringt ) и передавая в качестве
параметра radix значение 16. Строка в шестнадцатеричном формате проще для чтения, чем ее числовой десятичный эквивалент. Тем не менее в качестве средства обеспечения удобочитаемости значения цвета метод toString( ) неидеален — он опускает ведущие нули. Например, для числа
var n:uint = 0х0000СС99;
выражение n.toString(16) вернет значение сс9 9, опустив четыре ведущих нуля. Чтобы улучшить удобочитаемость значений цветов на этапе отладки, мы можем написать собственный код, наподобие представленного в листинге 26.1. В этом листинге представлен класс Pixel, предназначенный для работы со значениями цветов. Класс Pixel помещает бинарные операции в удобные методы, например setRed ( ) и set Alpha ( ). Методы этого класса могут получать и устанавливать уровни отдельных цветовых каналов в значении цвета и генерировать строки, описывающие значения цвета с использованием различных удобочитаемых форматов. Описание класса Pixel доступно в Интернете по адресу http://www. moock.org/eas3/examples.
Листинг 26.1. Класс Pixel
package {
public class Pixel {
private var value:u1nt; // Значение цвета пиксела
public function Pixel (nlzulnt, n2:1nt=0, n3:1nt=0, n4:int=0) {
1f (arguments.length == 1) { value = nl;
} else {
value = nl«24 | n2«16 | n3«8 | n4;
public function setAlpha (n:1nt):vo1d {
1f (n < 0 || n > 255) {
throw new RangeError("Suppl1ed value must be in the range 0-255.");
}
value &= (OxOOFFFFFF):
value | = (n«24);
public function setRed (n:int):void {
if (n < 0 || n > 255) {
throw new RangeError("Supplied value must be in the range 0-255.");
}
value &= (OxFFOOFFFF);
value |= (n«16):
public function setGreen (n:int):void {
if (n < 0 || n > 255) {
throw new RangeErrorC"Supplied value must be in the range 0-255.");
}
value &= (OxFFFFOOFF); value |= (n«8);
public function setBlue (n:int):void {
if (n < 0 || n > 255) {
throw new RangeErrorCSupplied value must be in the range 0-255.");
value &= (OxFFFFFFOO);
value |= (n);
public function getAlpha ( ):int { return (value » 24) & OxFF;
public function getRed ( ):1nt { return (value » 16) & OxFF;
public function getGreen ( );int { return (value » 8) & OxFF;
public function getBlue ( ):int { return value & OxFF;
public function toString ( ): String { return toStringARGB( );
public function toStringARGB (radix;!nt = 16);String {
var s:String =
"A:" + ((value » 24)&0xFF) .toString(radix) .tollpperCase( ) + " R:" + ((value » 16)&0xFF) .toString(radix) .tollpperCase( ) + " G:" + ((value » 8)&0xFF) .toString(radix) .tollpperCase( ) + " B:" + (value&OxFF) .toString(radix) .tollpperCase( );
return s;
public function toStringAlpha (radix:int = 16):String { return ((value » 24)&0xFF).toString(radix).tollpperCase( );
public function toStringRed (radix:int = 16):String {
return ((value» 16)&0xFF) .toString(radix) .tollpperCase( );
public function toStringGreen (radix:int = 16):String { return ((value » 8)&0xFF) .toString(radix) .tollpperCase( );
public function toStrmgBlue (radix:int = 16):String { return (value&OxFF).toSt ring (radix).toUpperCase( );
}
}
}
// Примеры использования:
var p:P1xel = new Pixel(0xFFFFCC99); // Выбранный цвет p.setRed(OxAA):
trace(p);// Выводит: A:FF R:AA G:CC В:99
trace(p.getRed( ));// Выводит: 170
trace(p.toStr1ngRed( )); // Выводит: AA
var p2:P1xel = new Pixel (0x33,0x66,0x99,0x00;
trace(p2.toStringARGB(10)): // Выводит: A:51 R:102 G:153 B:204
Создание нового растрового изображения
Для создания и отображения совершенно нового растрового изображения нужно выполнить такую последовательность действий.
Создать объект BitmapData.
Установить желаемые цвета пикселов в созданном объекте BitmapData.
Связать объект BitmapData с объектом Bitmap.
Добавить объект Bitmap в список отображения.
Попробуем применить эти шаги на практике!
Наша цель — отобразить квадрат синего цвета размером 10x10 пикселов по центру фонового квадрата зеленого цвета размером 20 х 20 пикселов. Сначала мы создадим объект BitmapData, используя следующий обобщенный код:
new BitmapData(ширина, высота, прозрачность , цветЗаливки)
Параметры ширина и высота обозначают размеры изображения в пикселах — максимальное значение, которое могут принимать данные параметры, равняется 2880. После создания объекта BitmapData изменить размеры изображения невозможно. Параметр прозрачность определяет, должно ли изображение поддерживать прозрачность отдельных пикселов (то есть может ли уровень канала Alpha значения цвета любого пиксела быть меньше 255). Если необходимости в поддержке прозрачности изображения нет, то параметру прозрачность должно быть установлено значение false, поскольку среда Flash отображает непрозрачные изображения быстрее, чем прозрачные. Наконец, параметр цветЗаливки задает значение цвета, которое изначально присваивается всем пикселам изображения.
Изображение, которое мы хотим создать, представляет собой квадрат размером 20 х 20 пикселов, для него не требуется прозрачности, и оно имеет фон зеленого цвета. Таким образом, чтобы создать наш объект BitmapData, мы используем следующий код:
// OxFFOOFFOO означает Alpha: 255, Red: 0. Green: 255. Blue: 0
var ImgData .-BitmapData = new B1tmapData(20, 20, false, OxFFOOFFOO):
Теперь нам необходимо установить синий цвет для пикселов квадратной области размером Юх 10 пикселов. Класс BitmapData предоставляет несколько инструментов для установки цвета пикселов: set Pixel ( ), setPixel32( ), setPixels ( ), fillRect ( ) и floodFill ( ). Для наших целей отлично подходит метод fillRect ( ) — он присваивает пикселам заданной прямоугольной области указанный цвет. Задаваемый нами объект Rectangle имеет ширину и высоту, равную 10 пикселам, а его левый верхний угол находится в точке с координатами (5; 5). В результате все пикселы растрового изображения, формирующие прямоугольную область от точки (5; 5) до точки (14; 14) включительно, будут окрашены в синий цвет.
ImgData.fill Reel(new Rectangle(5, 5, 10, 10), OxFFOOOOFF):
Мы завершили установку цвета пикселов в нашем объекте BitmapData и готовы связать его с объектом Bitmap для дальнейшего отображения на экране. Связать объект BitmapData с объектом Bitmap можно двумя способами: передать объект BitmapData в конструктор класса Bitmap или присвоить объект BitmapData переменной экземпляра bitmapDatа существующего объекта Bitmap. Следующий код демонстрирует обе методики:
// Передаем объект BitmapData в конструктор класса Bitmap var bmp:B1tmap = new B1tmap(1mgData):
// Присваиваем объект BitmapData переменной экземпляра bitmapData
var bmp:Bitmap = new Bitmap( ): bmp.bitmapData = ImgData:
Как только объект BitmapData будет связан с объектом Bitmap, добавление данного объекта Bitmap в список отображения приведет к выводу изображения, описываемого объектом BitmapData, на экран:
// Выводим объект на экран addChlld(bmp);
Рассмотрим код, необходимый для создания и вывода на экран нового растрового изображения, содержащего квадрат синего цвета размером 10 х 10 пикселов, который размещается по центру фонового квадрата зеленого цвета размером 20 х 20 пикселов:
var ImgData:BitmapData = new BitmapData(20. 20, false, OxFFOOFFOO):
ImgData.fillRect(new Rectangle(5, 5, 10, 10), OxFFOOOOFF):
var bmp:B1tmap = new B1tmap(ImgData);
addChl1d(bmp);
На рис. 26.3 показан результат выполнения предыдущего кода.
Рис. 26.3. Растровое изображение, созданное с нуля
Как уже отмечалось ранее, несколько различных объектов Bitmap могут одновременно отображать представления одного и того же объекта BitmapData. Например, следующий код использует наш объект ImgData в качестве источника данных
для двух различных объектов Bitmap. Первый объект Bitmap представляет объект imgData без изменений, а второй объект Bitmap поворачивает и масштабирует исходное изображение.
var imgData:BitmapData = new BitmapData(20, 20, false, OxFFOOFFOO);
imgData.fi11Rect(new Rectangle(5, 5, 10, 10), OxFFOOOOFF);
var bmpl:Bitmap = new Bitmap(imgData);
addChiId(bmpl):
var bmp2:Bitmap = new Bitmap(imgData):
bmp2.rotation = 45;
bmp2.x = 50;
bmp2.scaleX = 2; // 200 %
bmp2.scaleY =2; H 200 %
addChild(bmp2);
Результаты выполнения этого кода показаны на рис. 26.4.
Рис. 26.4. Два растровых изображения с одним и тем же источником BitmapData
Обратите внимание, что преобразования, применяемые к объекту Bitmap, не оказывают никакого влияния на связанный с ним объект BitmapData. Непосредственно преобразовать (то есть повернуть, масштабировать или переместить) реальные пиксельные'данные, хранящиеся в объекте BitmapData, невозможно. Тем не менее это можно сделать в процессе их копирования в новый объект BitmapData. Дополнительная информация по этому вопросу представлена далее в разд. «Копирование графики в объект BitmapData».
Загрузка внешнего растрового изображения
В предыдущем разделе мы узнали, как создавать новое растровое изображение. Теперь попробуем загрузить существующее изображение с диска. К форматам растровых изображений, которые могут быть загружены и отображены на экране, относятся JPEG, GIF и PNG.
JPEG-изображения, загружаемые извне, могут быть в прогрессивном или обычном формате. Анимированные GIF-изображения не воспроизводятся; отображается только их первый кадр.
Внешние растровые изображения могут быть загружены двумя способами: на этапе выполнения с помощью класса Loader или на этапе компиляции с помощью тега метаданных [Embed]. Для справки в листингах 26.2 и 26.3 приведены примеры кода, демонстрирующие обе методики; гораздо более глубокое рассмотрение данного вопроса представлено в гл. 28.
Код из листинга 26.2 демонстрирует, как на этапе выполнения загрузить растровое изображение с именем photo.jpg. Предполагается, что файл растрового изображения и SWF-файл, загружающий данный файл, находятся в одной папке.
Листинг 26.2. Загрузка растрового изображения на этапе выполнения
package {
import fl ash.display.*;
Import fl ash.events.*;
Import flash.net.*;
// Простой пример, демонстрирующий, как загружать изображение public class BltmapLoader extends Sprite {
private var loader:Loader; // загрузчик растрового изображения
public function B1tmapLoader( ) {
// Создаем загрузчик loader = new Loader( );
// Регистрируем приемник для получения уведомления об окончании
// процесса загрузки и инициализации растрового изображения
1oader.contentLoaderlnfo.addEventL1stener(Event.INIT,
InitListener);
// Загружаем растровое изображение
1oader.1oad(new URLRequest("photo.jpg"));
}
// Вызывается, когда процесс загрузки и инициализации растрового
// изображения будет завершен
private function 1n1tL1stener (e;Event);void {
// Добавляем загруженное растровое изображение в список отображения addCh11d(1oader.content);
// Получаем значение цвета для левого верхнего пиксела загруженного // растрового изображения
trace(B1tmap(loader.content).bltmapData.getPixel(0, 0));
Стоит отметить, что после загрузки растрового изображения к его пиксельным данным можно обращаться через переменную экземпляра bitmap Dat а класса Bitmap, как показано в следующем коде (обратите внимание на операцию приведения к типу данных Bitmap, которая необходима для компиляции кода в строгом режиме; дополнительные сведения можно найти в гл. 8):
В1tmap(1oader.content).Ы tmapData
Код из листинга 26.3 демонстрирует, как на этапе компиляции встроить растровое изображение с именем photo .jpg. Предполагается, что файл класса, встраивающего это растровое изображение, и файл растрового изображения находятся в одной папке.
Тег метаданных [Embed], используемый в листинге 26.3, поддерживается приложением Flex Builder и консольным компилятором mxmlc, но не поддерживается приложением Flash CS3. В приложении Flash CS3 необходимо использовать библиотеку flex.swc, поддерживающую компилятор приложения Нех. Подробную информацию можно найти в разд. «Встраивание отображаемых элементов на этапе компиляции» гл. 28.
Листинг 26.3. Встраивание растрового изображения на этапе компиляции
package {
Import fl ash.display.*;
Import fl ash.events.*:
Import mx.core.BItmapAsset;
public class BltmapEmbedder extends Sprite {
// Встраиваем растровое изображение
[Embed(source="photo.jpg")]
private var Photo .-Class:
public function BltmapEmbedder ( ) {
// Создаем экземпляр встроенного растрового изображения
var photo:B1tmapAsset = new Photo( );
addChl1d(photo);•
trace(photo.b1tmapData.getP1xel(0, 0));
}
Как и в листинге 26.2, к пиксельным данным встроенного растрового изображения можно обращаться через переменную bitmapData, как показано в следующей строке кода (на этот раз операция приведения типов не требуется, поскольку тип данных объекта photo является потомком класса Bitmap):
photo.bitmapData
Анализ растрового изображения
Теперь, когда мы знаем, как создавать новые и загружать существующие растровые изображения, рассмотрим инструменты, предназначенные для анализа пикселов в существующем растровом изображении.
Чтобы получить полное 32-битное целочисленное значение цвета любого пиксела в растровом изображении, мы применяем метод экземпляра getPixe!32 ( ) класса BitmapData, который принимает следующий вид:
объектВ1tmapData.getР1 хе132(х, у)
Здесь объектВ1tmapData — экземпляр класса BitmapData, из которого будет получено значение цвета пиксела, а х и у — горизонтальное и вертикальное положения пиксела, для которого будет получено значение цвета. Например, следующий код создает растровое изображение, представляющее квадрат синего цвета, после чего отображает значение цвета левого верхнего пиксела созданного изображения (то есть пиксела с координатами (0; 0)):
var ImgData:В1tmapData = new B1tmapData(20, 20, false, OxFFOOOOFF);
trace(1mgData.getP1xel32(0, 0)); // Выводит: 4278190335
Значением цвета данного пиксела является большое число (4 278 190 335), поскольку значение канала Alpha равно 255, следовательно, все биты в самом старшем байте значения цвета равны 1:
11111111 00000000 00000000 11111111
В десятичном виде уровни отдельных каналов в значении цвета, возвращаемого методом get Pixel 32 ( ), не поддаются расшифровке, поэтому в отладочных целях для извлечения удобочитаемых значений каналов из числа, возвращаемого методом getPixel32 ( ), должен использоваться код наподобие представленного ранее в классе Pixel:
// Выводит: A:FF R:0 G:0 B:FF
trace(new Pixel(ImgData.getP1xe!32(0, 0)));
Стоит отметить, что значение канала Alpha для пикселов в непрозрачных растровых изображениях всегда равно 255, даже когда цвету пиксела присваивается другое значение канала Alpha. Например, следующий код создает квадрат синего цвета, представляющий непрозрачное растровое изображение, и присваивает каналу Alpha всех его пикселов значение 0x33. Поскольку растровое изображение является непрозрачным, операция присваивания значения каналу Alpha попросту игнорируется:
var ImgData:B1tmapData = new B1tmapData(20, 20, false, 0x330000FF): trace(1mgData.getP1xel32(0, 0)): // Выводит: 4278190335
// (значение Alpha равно OxFF, а не 0x33)
Для пикселов значение канала Alpha может быть установлено только в прозрачных растровых изображениях (то есть в растровых изображениях, при создании которых в качестве параметра transparent конструктора класса BitmapData было передано значение true). Например, следующий код снова создает растровое изображение, представляющее квадрат синего цвета, но на этот раз с включенной прозрачностью. Поскольку растровое изображение является прозрачным, операция присваивания значения 0x33 каналу Alpha завершается успешно.
var ImgData:BitmapData = new B1tmapData(20, 20, true, 0x330000FF); trace(1mgData.getP1xel32(0, 0)): // Выводит: 855638271
// (значение Alpha равно 0x33)
Метод getPixel32() в сравнении с методом getPixeK)
Язык ActionScript предоставляет удобный способ для получения значения цвета пиксела без информации о его канале Alpha — метод экземпляра get Pixel ( ) класса BitmapData. Этот метод принимает такой же вид, как и метод getPixel32 ( ), и также возвращает 32-битное целочисленное значение цвета. Однако, в отличие от метода getPixel32 ( ), он присваивает битам канала Alpha в возвращаемом целом числе значение 0. Иными словами, вызов метода get Pixel ( ) эквивалентен следующему выражению:
объектВ1tmapData,getP1xe!32( ) & OxOOFFFFFF
Реальное значение канала Alpha для указанного пиксела в растровом изображении остается неизменным; изменяется только возвращаемое число. Например, вспомним растровое изображение, представляющее квадрат синего цвета, из предыдущего раздела:
var ImgData:В1tmapData = new B1tmapData(20, 20, false, OxFFOOOOFF);
Если мы попытаемся получить значение цвета для левого верхнего пиксела в этом растровом изображении с помощью метода get Pixel ( ), будет возвращено значение 255, поскольку битам канала Alpha было установлено значение 0 (сравните значение 255 со значением 4 278 190 335, которое было возвращено ранее методом getPixel32 ( ) ):
tracedmgData.getPixel(0, 0)); // Выводит: 255
-*^*г-*^*гlb;lb;Метод getPixel ( ) должен использоваться только для получения комбинированного значения каналов Red, Green и Blue в виде одного числа. Если получаемое значение цвета будет использовано для дальнейшей обработки одного или нескольких каналов по отдельности, используйте метод getPixel32 ( ). Он подходит для большинства ситуаций, связанных с обработкой цвета.
-*^*г
-*^*г
lb;
lb;
Метод getPixel32() возвращает 32-битное целое число, представляющее полное четырехканальное значение цвета для некоторого пиксела. Метод getPixel() возвращает 32-битное целое число, которое содержит значения каналов Red, Green и Blue для некоторого пиксела и значение канала Alpha, равное 0.
Влияние прозрачности на получение значения цвета .
Из-за особенностей внутренней архитектуры механизма визуализации среды выполнения Flash нельзя гарантировать получение корректных значений цвета пикселов в прозрачных изображениях с помощью методов getPixel32 ( ), getPixel ( ) или любых других способов. Для повышения производительности процесса визуализации, когда значение цвета пиксела сохраняется в объекте BitmapData, среда Flash преобразует это значение во внутренний формат, называемый предумноженным значением цвета. Оно объединяет значение канала Alpha со значениями каналов Red, Green и Blue этого цвета. Например, если значением канала Alpha исходного цвета является 50 % от 255, то предумноженное значение цвета будет хранить 50 % от 255 для канала Alpha, 50 % от исходного значения канала Red, 50 % от исходного значения канала Green и 50 % от исходного значения канала Blue. В результате исходные значения, присвоенные каналам Red, Green и Blue, будут потеряны.
При получении значений цвета пикселов из прозрачного изображения среда Flash осуществляет их автоматическое преобразование из предумноженного формата в стандартный (неумноженный) формат ARGB, который мы использовали в данной главе, приводя к потере точности. Во многих случаях преобразованное, неумно- женное значение цвета не совпадает с исходным значением цвета, присвоенным пикселу. Например, следующий код создает новый объект BitmapData, в котором
каждый пиксел имеет чистый белый цвет и является полностью прозрачным (то есть значение канала Alpha равно 0):
var 1mgData:В1tmapData = new BitmapData(20, 20, true, OxOOFFFFFF);
Если получить значение цвета для любого пиксела из предыдущего растрового изображения, результатом будет являться значение 0 (то есть значения всех четырех каналов равны 0):
trace(1mgData.getPIхе!32(0, 0)); // Выводит: О
Исходные значения для каналов Red, Green и Blue, которые были равны 255, оказались потеряны.
Таким образом, если программа желает сохранить и в дальнейшем использовать значения цвета прозрачных пикселов без потери данных, она должна сохранить эти значения в объекте ByteArray. Вы можете руководствоваться общим правилом: значения цвета прозрачных пикселов, сохраненные в растровом изображении, должны считаться недоступными.
В отличие от этого, значения цвета непрозрачных пикселов могут быть получены в любой момент без риска потерять данные:
// Получение значения цвета пиксела из непрозрачного изображения var ImgData:BltmapData = new В1tmapData(20, 20, false, OxFFFFFFFF); trace(1mgData.getP1xel32(0, 0)); // Выводит: 4294967295
// (исходные данные были сохранены)
Как показано в следующем коде, значение цвета любого пиксела, уровень канала Alpha которого имеет значение 255, остается неизменным между последовательными операциями присваивания и получения значения цвета, даже если пиксел сохраняется в прозрачном растровом изображении.
// Получаем значение цвета пиксела, уровень канала Alpha которого
// установлен в 255, из прозрачного изображения
var ImgData:В1tmapData = new B1tmapData(20, 20, true, OxFFFFFFFF);
trace(1mgData.getP1xel32(0, 0)); // Выводит: 4294967295
// (исходные данные были сохранены)
Класс ColorPicker: пример использования метода getPixel32()
Теперь, когда мы понимаем, как получить значение цвета пиксела, применим наши знания в реальной ситуации. Предположим, что мы разрабатываем интернет-приложение для создания приглашений на вечеринки. Пользователи приложения сначала выбирают фотографию, которая будет помещена на приглашение, а затем задают подходящий цвет для текста приглашения. Чтобы пользователь мог поэкспериментировать с различными цветами, приложение предоставляет специальную форму для выбора цвета. Когда пользователь перемещает указатель мыши над выбранным изображением, цвет текста приглашения автоматически изменяется в соответствии с цветом пиксела, над которым в данный момент находится указатель мыши. В листинге 26.4 продемонстрирован код для палитры выбора цвета с тестовым изображением sunset .jpg. Изучите комментарии, чтобыпонять, как происходит получение значения цвета под указателем мыши.
Листинг 26.4. Палитра выбора цвета на основе изображения
package {
Import flash.display.*;
import flash.events.*;
import fl ash.text.*;
import flash.net.*;
// Устанавливает цвет объекта TextField в соответствии с цветом
// выбранного в изображении пиксела.
public class ColorPicker extends Sprite {
private varimg:Bitmap;//Объект Bitmap
private varimgContainer.'Sprite;//Контейнер для объектаBitmap
private vart;TextField;//Раскрашиваемый объектTextField
// Метод-конструктор
public function ColorPickerC ) {
// Создаем объект TextField и добавляем его в иерархию отображения
// объекта ColorPicker
t = new TextFi eld( );
t.text = "Please come to my party...";
t.autoSize = TextFieldAutoSize.LEFT;
addChild(t);
// Загружаем изображение
var loader-.Loader = new Loader ( );
1oader.contentLoaderInfo.addEventListener(Event.INIT,
initListener);
1oader.1oadtnew URLRequestC"sunset.jpg"));
}
// Вызывается, когда инициализация изображения завершена
private function initListener (e;Event):void {
// Получаем ссылку на загруженный объект Bitmap
img = е.target.content;
// Помещаем загруженное растровое изображение в объект Sprite, чтобы
// мы могли реагировать на взаимодействия с мышью
ImgContainer = new SpriteC );
imgContainer.addChi1d(i mg);
// Добавляем объект Sprite в иерархию отображения объекта ColorPicker addChi1d(1mgContai ner);
imgContainer.y = 30;
// Регистрируем приемник для получения уведомлений о перемещении мыши imgContainer.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveListener);
}
// Вызывается, когда происходит перемещение мыши над объектом Sprite,
// содержащим изображение
private function mouseMoveListener (e:MouseEvent):void {
// Устанавливаем цвет текста в соответствии с цветом пиксела,
// находящегося в данный момент под указателем мыши
t.textColor = 1mg.ЫtmapData.getP1xel32(е.1ocalX, e.localY);
Получение цвета области пикселов
MeтoдыэкзeмпляpagetPixel32 ( ) ngetPixel ( ) класса Bi tmapData применяются для получения значения цвета отдельного пиксела. В отличие от этого, метод экземпляра getPixels ( ) класса BitmapData используется для получения значений цвета целой прямоугольной области пикселов. Метод getPixels ( ) может быть использован в любом из следующих сценариев:
при передаче области растрового изображения между модулями программы;
при использовании собственного алгоритма для обработки фрагмента растрового изображения;
при отправке фрагмента или всего растрового изображения на сервер в необработанном бинарном формате.
Метод getPixels ( ) принимает следующий обобщенный вид:
объектВ1tmapData.get Р1xels(область)
Здесь объектВ1tmapData — объект BitmapData, из которого будут возвращаться значения цвета пикселов, а область — объект flash.geom.Rectangle, описывающий область возвращаемых пикселов. Метод getPixels ( ) возвращает объект ByteArray, содержащий 32-битные целочисленные значения цвета. Объект Byte Аг га у — это список значений цвета для пикселов в указанной прямоугольной области, обход которых происходит слева направо и сверху вниз. Например, рассмотрим следующую диаграмму растрового изображения размером 4x4, пикселы которого для простоты обозначены буквами от А до Р:
А В С D
Е F G Н
I J К L
М N О Р
Не забывая, что пиксел левого верхнего угла растрового изображения находится в точке с координатой (0; 0), если мы воспользуемся методом getPixels ( ) для получения значений цвета прямоугольной области пикселов от точки (2; 1) до точки (3; 3), возвращаемый объект ByteArray будет содержать следующие пикселы в таком порядке:
G. Н. К, L, 0. Р
Стоит отметить, что объект ByteArray представляет собой одномерный список и не содержит никакой информации о размерах и позиции прямоугольной области, из которой были получены данные пикселы. Таким образом, чтобы восстановить растровое изображение из пикселов, хранящихся в объекте ByteArray, в том порядке, в котором они находились ранее, мы должны иметь свободный доступ к ширине, высоте и позиции исходного прямоугольника. Информация об исходном прямоугольнике может быть присвоена переменной или даже добавлена в сам объект ByteArray.
Чтобы попрактиковаться в использовании метода get Pixel s ( ), скопируем прямоугольную область из одного растрового изображения в другое изображение. Сначала мы создадим два объекта BitmapData. Первый объект представляет квадрат синего цвета размером 20 х 20 пикселов, а другой — квадрат зеленого цвета размером 30 х 30 пикселов:
var blueSquare:BitmapData = new BitmapData(20. 20. false. OxFFOOOOFF);
var greenSquare:B1tmapData = new BitmapData(30. 30. false. OxFFOOFFOO);
Затем мы определяем прямоугольную область пикселов, которую хотим получить из квадрата зеленого цвета. Левый верхний угол прямоугольника находится в точке с координатой (5; 5), а его ширина и высота равна 10 пикселам.
var rectReglon:Rectangle = new Rectangle(5, 5. 10. 10);
Теперь мы получаем пикселы зеленого цвета:
var greenPixels;ByteArray = greenSquare.getP1xels(rectReg1on);
Чтобы перенести пикселы зеленого цвета на квадрат синего цвета, мы используем метод экземпляра set Pixels ( ) класса BitmapData. Однако перед вызовом метода set Pixel s ( ) мы должны установить указатель файла объекта By t eArray в значение 0, чтобы метод setPixels( ) начал чтение значений цвета пикселов с начала списка:
greenPixels.position = 0;
Теперь мы можем прочитать пикселы из объекта ByteArray greenPixels и сохранить их в объекте BitmapData blueSquare:
blueSquare.setPixels(rectReglon. greenPixels);
Чтобы убедиться, что все работает так, как ожидалось, мы отображаем два растровых изображения на экране:
var blueBmp:Bitmap = new Bitmap(blueSquare);
var greenBmp:Bitmap = new Bitmap(greenSquare);
addChl1d(blueBmp);
addChild(greenBmp);
greenBmp.x = 40;
На рис. 26.5 показаны результаты выполнения предыдущего кода.
□
Рис. 26.5. Пикселы, скопированные из объекта ByteArray
Если при копировании пикселов между двумя растровыми изображениями размеры копируемого прямоугольника и целевого прямоугольника совпадают (как в предыдущем примере), мы можем использовать удобный метод экземпляра copyР ixe 1 s ( ) клaccaBitmapDataвмecтoкoмбинaциимeтoдoвgetPixels ( ) HsetPixels( ). К другим внутренним методам экземпляра класса BitmapData, предоставляющим удобный доступ к типичным операциям копирования, относятся: copyChannel ( ), clone ( ), merge ( ) и draw ( ). Дополнительную информацию можно найти далее, в разд. «Копирование графики в объект BitmapData» этой главы.
Другие инструменты анализа
В этом разделе мы узнали, как анализировать пикселы объекта BitmapData, используя методы getPixel32 ( ), getPixel ( ) и getPixels ( ). Кроме того класс BitmapData предоставляет несколько других, более специализированных инструментов для анализа пикселов:
compare ( ) — проверяет, есть ли отличие между пикселами двух растровых изображений;
getColorBoundsRect ( ) — определяет, какая область растрового изображения содержит указанный цвет;
hitTest ( ) — определяет, перекрывают ли пикселы растрового изображения некоторую точку, прямоугольник или другое растровое изображение.
Подробную информацию о перечисленных методах можно найти в описании класса BitmapData в справочнике по языку ActionScript корпорации Adobe.
Внесение изменений в растровое изображение
Основные инструменты для присваивания новых цветов пикселам существующего растрового изображения являются точным отражением инструментов, предназначенных для анализа растрового изображения. К ним относятся методы setPixel32 ( ), setPixel ( ) и setPixels ( ). Метод setPixel32 ( ) присваивает новое четырехканальное значение цвета пикселу в виде 32-битного целого числа. Он принимает следующий вид:
o6beKiBitmapData.setP1xe!32(x. у, цвет)
Здесь o6beKiBitmapData — экземпляр класса Bi tmapData, содержащий пиксел, значение цвета которого будет изменяться; х и у — горизонтальная и вертикальная позиции данного пиксела; цвет — новое значение цвета, присваиваемое пикселу. Например, следующий код создает растровое изображение, представляющее квадрат синего цвета, и затем присваивает его левому верхнему пикселу значение белого цвета:
var ImgData:BitmapData = new B1tmapData(20, 20. false. OxFFOOOOFF); 1mgData.setP1xel32(0, 0. OxFFFFFFFF);
В отличие от этого, метод setPixel ( ), который принимает такой же общий вид, как и метод setPixel32( ), устанавливает только значения каналов Red, Green и Blue цвета пиксела, не изменяя исходное значение канала Alpha. Например, следующий код создает полупрозрачное растровое изображение, представляющее квадрат синего цвета, и затем присваивает его левому верхнему пикселу значение белого цвета. Поскольку вместо метода setPixel32( ) используется setPixel ( ), левый верхний пиксел сохраняет свое исходное значение канала Alpha (0x66):
var imgData:BitmapData = new BitmapData(20, 20, true, 0x660000FF); imgData.setPixel(0. 0, OxFFFFFF);
После завершения операции set Pixel ( ) значением цвета левого верхнего пиксела будет являться число 0x6 6FFFFFF.
Любое значение канала Alpha, указываемое в числе, которое передается в метод setPixel ( ), будет проигнорировано. Например, в следующем коде мы присваиваем значение цвета пиксела, используя число, в котором для канала Alpha указано значение сс. Несмотря на это, после завершения операции значением цвета левого верхнего пиксела по-прежнему будет являться число 0x66FFFFFF:
ImgData.setPixel(0, 0, OxCCFFFFFF);
Повышение производительности с помощью метода BitmapData.lock()
По умолчанию, всякий раз, когда над некоторым объектом BitmapData вызывается метод setPixel32 ( ) или setPixel ( ), экземпляры класса Bitmap, ссылающиеся на этот объект, получают уведомление об изменении данных. Когда методы setPixel32( ) или setPixel ( ) вызываются друг за другом внутри одного цикла кадра (например, когда каждому пикселу в растровом изображении присваивается значение цвета), подобные уведомления могут привести к снижению производительности. Для повышения производительности мы можем использовать метод экземпляра lock ( ) класса BitmapData.
Вызов метода lock ( ) над объектом BitmapData запрещает среде выполнения Flash уведомлять зависимые объекты Bitmap при вызове методов setPixel32( ) или setPixel ( ). Таким образом, если вы собираетесь использовать методы setPixel32 ( ) или setPixel ( ) друг за другом, всегда вызывайте метод lock ( ). После его вызова присвойте все желаемые значения цвета пикселов; затем вызовите метод экземпляра unlock ( ) класса BitmapData. Метод unlock ( ) позволяет среде Flash при необходимости уведомить все зависимые объекты Bitmap.
Данный подход продемонстрирован в листинге 26.5. В этом коде используется цикл для присваивания случайного цвета каждому пикселу в объекте Bi tmapData размером 500 х 500 пикселов. Обратите внимание на вызов метода lock ( ) перед циклом и вызов метода unlock ( ) после цикла, выделенные полужирным шрифтом.
Листинг 26.5. Использование метода BitmapData.Iock() для повышения производительности
// Создаем растровое изображение
var ImgData:BitmapData = new BitmapData(500. 500, true. 0x00000000);
var bmp:Bitmap = new Bitmap(imgData);
// Вызываем метод lock( )
imgData.lock( );
// Устаналиваем значения цвета пикселов var color:uint;
for (var 1:1nt = 0; 1 < imgData.height ; 1++) { for (var j:1nt = 0; j < imgData.width; j++) {
color = Math.floor(Math.random( )*OxFFFFFFFF); imgData.setPixel32(j, 1, color);
}
// Вызываем метод unlock( )
imgData.uni ock( );
При тестировании кода из листинга 26.5 в рабочей версии приложения Flash Player на компьютере с процессором Pentium 4 2,6 ГГц одна итерация цикла занимает приблизительно 100 мс. Без использования метода lock ( ) одна итерация занимает примерно 125 мс. Иными словами, при использовании метода lock ( ) код выполняется приблизительно на 20 % быстрее.
При измерении производительности среды Flash всегда выполняйте тесты в рабочей, а не в отладочной версии. Производительность в рабочей версии приложения зачастую оказывается в два раза выше, чем в отладочной.
Класс ScribbleAS3: пример использования метода setPixel32()
Присваивание цвета пикселу в растровом изображении имеет множество практических применений: от создания собственных эффектов до коррекции фотографий или генерации динамического интерфейса. Рассмотрим всего одно практическое применение метода set Pixel 32 ( ) — простую программу для рисования. В листинге 26.6 представлена адаптация на языке ActionScript 3.0 программы Scribble. Выполнение этого кода приводит к созданию пустого растрового изображения, на котором пользователь рисует линии с помощью мыши. Когда пользователь перемещает мышь, удерживая нажатой левую кнопку, на пустом растровом изображении рисуется пиксел черного цвета.
Листинг 26.6. Очень простая программа рисования ScribbleAS3
package
import flash.display.*:
Import flash.events.*;
Import flash.ui.*;
Import flash.geom.*:
// Простое приложение для рисования. Рисует одну точку на объекте
// BltmapData всякий раз, когда возникает событие MouseEvent.MOUSE_MOVE
// при нажатой левой кнопке мыши.
public class ScribbleAS3 extends Sprite {
// Растровое изображение, отображаемое на экране
private var canvas:Bitmap;
И Содержит растровое изображение, обеспечивая интерактивность private var canvasContaiпег:Sprite;
// Линия вокруг растрового изображения private var border:Shape;
// Сообщает о том, нажата ли кнопка мыши в настоящий момент private var isDrawing:Boolean = false:
// Конструктор
public function Seri bbleAS3 ( ) {
createCanvast ):
registerForlnputEventsC ):
// Предотвращаем изменение размеров окна приложения - stage.seal eMode = StageScaleMode.NO_SCALE:
}-
// Создает пустое растровое изображение, на котором будем рисовать private function createCanvas (width:int = 200, height:1nt = 200):void {
// Определяем объект BitmapData, который будет хранить пиксельные
// данные для рисунка пользователя
var canvasData:BitmapData = new BitmapData(width, height, false, OxFFFFFFFF);
// Создаем новый отображаемый объект Bitmap, используемый
// для отображения объекта canvasData canvas = new Bitmap(canvasData):
// Создаем объект Sprite, который будет содержать объект Bitmap. Класс
// Bitmap не поддерживает события ввода: следовательно, помещаем его
// в объект Sprite, чтобы пользователь мог взаимодействовать с этим
// объектом.
canvasContainer = new SpriteC ):
// Добавляем растровое изображение bitmap в экземпляр canvasContainer
// класса Sprite
canvasContainer.addChi1d(canvas):
// Добавляем экземпляр canvasContainer класса Sprite (и содержащийся
// в нем объект Bitmap) в иерархию отображения данного объекта addChild(canvasContainer):
// Создаем границу вокруг области рисования.
border = new Shape( ):
border.graphics.lineStyled, OxFFOOOOOO):
border.graphics.drawRectCO, 0, width, height): addChiId(border):
// Регистрирует приемники для необходимых событий мыши и клавиатуры private function registerForInputEvents ( ):void {
// Регистрируем приемники для событий нажатия кнопки мыши
// и перемещения мыши от объекта canvasContainer
canvasContainer.add EventListener(MouseEvent.MOUSE_DOWN, mouseDowntistener):
canvasContaiпег.addEventLi'stener(MouseEvent.MOUSE_MOVE, mouseMoveListener);
// Регистрируем приемники для событий отпускания кнопки мыши и нажатия // клавиши от объекта Stage (то есть для глобальных событий).
// Используем объект Stage, поскольку событие отпускания кнопки мыши
// должно всегда завершать рисование, даже если указатель мыши
// не находится над областью рисования. Подобным образом нажатие
// пробела должно всегда приводить к стиранию рисунка, даже когда
// объект canvasContaiпег не имеет фокуса.
stage. addEventLi'stener(MouseEvent.MOUSE_UP, mousellpLIstener) ;
stage.addEventListener(KeyboardEvent.KEY_DOWN, keyDownLIstener);
// Устанавливает цвет указанного пиксела
public function drawPoInt (x:1nt, y:1nt, color;u1nt = OxFFOOOOOO):void { canvas.b1tmapData.setP1xel32(x, y, color);
// Отвечает на события MouseEvent.MOUSE_DOWN
private function mouseDownLIstener (e:MouseEvent):void {
// Устанавливаем флажок, указывающий на то, что основная кнопка мыши
// в настоящий момент нажата'
IsDrawi’ng = true;
// Рисуем точку в позиции, где произошел щелчок кнопкой мыши.
drawPolnt(е.localX, e.localY);
// Отвечает на события MouseEvent.MOUSE_MOVE
private function mouseMoveListener (e;MouseEvent):void {
// Рисуем точку, когда мышь перемещается над областью рисования
// при нажатой левой кнопке мыши
1f (1sDraw1ng) {
// Используем переменные localX и localY, чтобы получить позицию
// указателя относительно объекта canvasContalner.
drawPolnt(е.1ocalX, e.localY);
// Обновляем экран сразу после завершения выполнения
// данной функции-приемника события
е.updateAfterEvent( );
// Отвечает на события MouseEvent.MOUSE_UP
private function mousellpLIstener (e;MouseEvent);void {
// Устанавливаем флажок, указывающий на то, что в настоящий момент
// основная кнопка мыши отпущена
1sDraw1ng = false;
// Отвечает на события KeyboardEvent.KEY_DOWN private function keyDownLIstener (e;KeyboardEvent);void {
// Стираем рисунок, когда пользователь нажимает клавишу Пробел. Чтобы
// очистить рисунок, мы присваиваем всем пикселам значение белого // цвета.
if (е.charCode == Keyboard.SPACE) {
canvas.bitmapData.fi!IRectCnew Rectangle(O, 0,
canvas.width, canvas.height), OxFFFFFFFF);
}}
Присваивание цвета области пикселов
Методы setPixel32( )nsetPixel( ) используются для присваивания значения цвета отдельному пикселу. В отличие от этого, метод экземпляра setPixels( ) класса BitmapData применяется для присваивания значений цвета целой прямоугольной области пикселов.
Метод set Pixels ( ) имеет следующий обобщенный вид:
объектВ!tmapData.setРixels(область. пикселыВубеАггау)
Здесь объектВ1tmapData — объект BitmapData, пикселам которого присваиваются значения цвета, область — объект flash. geom. Rectangle, описывающий область пикселов, которым будет присвоен цвет, а пикceлыByteArray — объект ByteArray, содержащий беззнаковые 32-битные целые числа, определяющие присваиваемые значения цвета.
Метод setPixels( ) заполняет указанную прямоугольную область в направлении слева направо и сверху вниз, начиная со значения цвета объекта пиксель^еАггау, находящегося в текущей позиции указателя файла (то есть в позиции пикceлыByteArray. position).
Например, рассмотрим следующую диаграмму растрового изображения размером 4x4, пикселы которого для простоты обозначены буквами от А до Р:
А В С D
Е F G Н
I J К L
М N О Р
Теперь рассмотрим следующую диаграмму массива байт, содержащего шесть 32-битных беззнаковых целочисленных значений цвета, обозначенных символами от С1 до С6:
Cl С2 СЗ С4 С5 Сб
Не забывайте, что пиксел левого верхнего угла растрового изображения находится в точке с координатой (0; 0). Если мы воспользуемся методом setPixels ( ) для заполнения прямоугольной области пикселов от точки (1; 0) до точки (3; 1) с помощью предыдущего массива байт, растровое изображение будет выглядеть следующим образом:
A Cl С2 СЗ
Е С 4 С5 Сб
I J К L
М N 0 Р
Попробуем проделать то же самое в коде. Сначала создадим квадрат красного цвета размером 4x4 пиксела:
var 1mgData:В1tmapData = new BitmapData(4, 4. false. OxFFFFOOOO);
Теперь мы создадим массив байт, который содержит шесть значений цвета — все они обозначают зеленый цвет. Для демонстрационных целей мы создадим массив байт вручную, однако обычно он формируется программным путем, возможно, с помощью вызова метода getPixels( ) или в результате выполнения пользовательского алгоритма, возвращающего значения цвета. Массив будет выглядеть следующим образом:
var byteArray:ByteArray = new ByteArrayC ): byteArray.writeUnsignedlnt(OxFFOOFFOO);
byteArray. wri tellnsi gnedlnt (OxFFOOFFOO): byteArray .wri tellnsi gnedlnt(OxFFOOFFOO): byteArray.writellnsignedlnt(OxFFOOFFOO): byteArray.writeUnsignedlnt(OxFFOOFFOO); byteArray.writeUnsignedlnt(OxFFOOFFOO):
Далее мы устанавливаем позицию, с которой метод set Pixels ( ) должен начать чтение значений цвета из массива байт. Мы хотим, чтобы метод setPixels ( ) начат! чтение с самого начала массива байт, поэтому присваиваем переменной экземпляра position класса ByteArray значение 0:
byteArray.position = 0;
Наконец, заполняем прямоугольную область в растровом изображении цветами та ш£ста^ G^m\
imgData.setPixels(new Rectanglе(1,0,3,2). byteArray):
Обратите внимание, что позиция и размеры объекта Rectangle, передаваемого в метод *£ ^ * setPixels(), определяются с помощью координаты левого верхнего угла и ширины/высоты ' ? aft прямоугольника, а не координат левого верхнего угла и правого нижнего угла.
Стоит отметить, что, если данные в объекте пикселыВу1еАггау закончатся до того, как будет заполнена указанная прямоугольная область, среда выполнения Flash сгенерирует исключение EOFError. Например, если мы увеличим размер предыдущей прямоугольной области с 3 х 2 пиксела (6 пикселов) до 3 х 3 пиксела (9 пикселов) следующим образом:
imgData.setPixels(new Rectanglе(1,0,3,3), byteArray);
произойдет следующая ошибка:
Error: Error #2030: End of file was encountered.
На русском языке она будет звучать так: Ошибка #2030: достигнут конец файла.
Кроме того, подобная ошибка может возникнуть, если после создания объекта ByteArray мы забудем установить его позицию в 0 (что является гораздо более
распространенной ошибкой в программировании, чем указание неправильных размеров прямоугольника или представление недостаточного количества значений цвета).
Перед вызовом метода setPixels() не забывайте устанавливать позицию указываемого входного массива байт.
Метод setPixels ( ) обычно применяется для создания растрового изображения на основе сериализованных бинарных данных, полученных из некоторого внешнего источника, например сервера или совместно используемого локального объекта.
Другие инструменты изменения изображений
В этом разделе мы узнали, как можно изменять пикселы в объекте BitmapData с помощью методов setPixel32 ( ), setPixel ( ) и setPixels ( ). Класс BitmapData также предоставляет несколько других, более специализированных инструментов для работы с пикселами:
fillRect ( ) — присваивает заданный цвет пикселам из прямоугольной области;
floodFill ( ) — присваивает заданный цвет всем пикселам, окружающим некоторый пиксел р, цвет которых соответствует цвету данного пиксела (подобно инструменту заливки, который присутствует во многих программах для работы с графикой);
scroll ( ) — изменяет позицию всех пикселов растрового изображения на заданную величину по горизонтали и вертикали.
Подробное описание перечисленных методов можно найти в описании класса BitmapData в справочнике по языку ActionScript корпорации Adobe.
Класс BitmapData также поддерживает различные фильтры, эффекты и операции копирования, которые могут быть использованы для управления пикселами растрового изображения. Дополнительную информацию можно получить далее, в разд. «Копирование графики в объект BitmapData» и «Применение фильтров и эффектов» этой главы.
Изменение размеров растрового изображения
Когда изменяются размеры объекта Bitmap, ссылающегося на объект BitmapDatа, с помощью переменных scaleX и scaleY или width и height, размеры изображения на экране меняются, однако нижележащий объект BitmapData остается неизменным. Чтобы изменить размер нижележащего объекта BitmapData на самом деле, мы должны произвести его повторную выборку с помощью метода экземпляра draw ( ) класса BitmapData (повторная выборка означает изменение числа пикселов в изображении). Общая методика выглядит следующим образом.
Получить ссылку на исходный объект BitmapData.
Нарисовать масштабированную версию исходного объекта BitmapData в новом объекте BitmapData.
Наконец, связать исходный объект Bitmap с новым, масштабированным объектом BitmapData.
Перечисленные шаги продемонстрированы в листинге 26.7.
Листинг 26.7. Повторная выборка растрового изображения
// Получаем временную ссылку на исходный объект BitmapData '
var or1g1nalВ1tmapData:В1tmapData = or1g1nalB1tmap.b1tmapData:
// Устанавливаем величину, которая будет определять коэффициент
// масштабирования растрового изображения
var scaleFactor:Number = .5:
// Вычисляем новые размеры масштабированного растрового изображения
var newWIdth:1nt = or1g1nalB1tmapData.width * scaleFactor;
var newHe1ght:1nt = or1g1nalB1tmapData.height * scaleFactor:
// Создаем новый объект BitmapData, размеры которого позволят уместить
// масштабированное растровое изображение
var sealedB1tmapData:BitmapData = new B1tmapData(newWIdth, newHelght, originalBitmapData.transparent):
// Создаем матрицу преобразований, с помощью которой будет происходить
// масштабирование растрового изображения
var seal eMatг1х:Matriх = new Matr1x( );
matrix.scaletscaleFactor, scaleFactor);
// Переносим масштабированное растровое изображение
// в новый объект BitmapData
sealedB1tmapData.draw(or1g1nalBitmapData, matrix);
// Заменяем исходный объект BitmapData.новым масштабированным объектом BitmapData or1g1nalBitmap.ЫtmapData = sealedB1tmapData:
В следующем разделе мы узнаем более подробно о методе draw ( ).
Копирование графики в объект BitmapData
Значения цвета пикселов могут быть скопированы в объект BitmapData из двух источников: другого объекта BitmapData или любого экземпляра DisplayObj ect.
Чтобы скопировать любой экземпляр класса DisplayOb j ect в объект BitmapData, мы применяем метод draw ( ), который копирует значения цвета из объекта-источника в объект-получатель Bi tmapData. В процессе копирования пикселы, сохраняемые в объекте BitmapData, могут быть преобразованы, смешаны или сглажены.
Чтобы скопировать значения цвета из другого объекта BitmapData, можно использовать либо метод draw ( ), либо любой из следующих методов класса BitmapData.
copyPixels ( ) — копирует значения цвета из прямоугольной области пикселов объекта-источника BitmapData в объект-получатель BitmapData. Источ-
ник и получатель могут являться одним объектом, позволяя копировать пикселы из одной области изображения в другую область того же изображения.
copyChannel( ) — копирует отдельный цветовой канал из прямоугольной области пикселов объекта-источника BitmapData в объект-получатель BitmapData. Источник и получатель могут являться одним объектом, позволяя копировать пикселы из одной области изображения в другую область того же изображения.
clone ( ) — создает новый объект BitmapData, дублируя существующий объект BitmapData.
merge ( ) — смешивает вместе каналы двух объектов BitmapData, создавая новое изображение, в котором одно изображение оказывается наложенным на другое. Объект-источник и объект-получатель BitmapData могут быть одним объектом, позволяя смешивать два канала одного и того же изображения.
В этом разделе мы сосредоточимся на методах draw ( ) ncopyPixels ( ). Дополнительную информацию о других методах копирования можно найти в описании класса BitmapData в справочнике по языку ActionScript корпорации Adobe.
Метод экземпляра draw() класса BitmapData
Метод draw ( ) имеет следующий обобщенный вид:
целевой0бъектВ1tmapData.draw(источник, матрицаПреобразования, цветовыеПреобразования, режимСмешения, областьОбрезки, сглаживание)
Здесь целевойОбъектВ1 tmapData — объект BitmapData, в который будут перенесены пикселы. Параметры метода draw ( ) описаны ниже.
источник — экземпляр класса Displayobject или BitmapData, графические данные которого будут перенесены в объект целевойОбъектВ!tmapData. Это единственный обязательный параметр метода draw ( ). Стоит отметить, что, когда значением параметра источник является объект Displayobject, при переносе в объект целевойОбъектВ1 tmapData его преобразования не включаются. Тем не менее преобразования объекта источник могут быть включены вручную путем передачи значения переменной источник.transform.matrix в качестве параметра матрицаПреобразований метода draw ( ), а значение переменной источник. t ransf о rm. col orTransform — в качестве параметра цветовоеПреобразование метода draw ( ). В качестве альтернативы объект целевой0бъектВ1 tmapData может быть связан с объектом BitmapData, переменная экземпляра transform которого ссылается на переменную источник.transform.
матрицаПреобразования — необязательный объект Matrix, описывающий любое перемещение (то есть изменение позиции), масштабирование, вращение и искажение, которое должно быть применено к пикселам, переносимым в объект целевойОбъектВ1 tmapData. Информацию об использовании объекта Matrix для выполнения графических преобразований можно найти в описании класса Matrix в справочнике по языку ActionScript корпорации Adobe и в разделе Programming ActionScript 3.0 ► Flash Player APIs ► Working With Geometry ► Using Matrix objects документации корпорации Adobe. Общий пример матричных преобразований можно найти по адресу http://windowssdk.msdn.microsoft.com/en-us/library/ms536397.aspx и http://www.senocular.com/flash/tutorials/transformmatrix.
Стоит отметить, что гарантировать достаточный размер объекта целевойОбъ- eKTBitmapData для хранения преобразованного объекта источник должен программист. В интерфейсе API приложения Flash Player 9 не предусмотрено никакой возможности для предварительного получения размера преобразованного объекта источник. Такая возможность может быть включена в будущие версии сред Flash, например, в виде метода generateTransformRect ( ) (разработанного после существующего метода generateFilterRect ( ) ). Чтобы отдать свой голос в поддержку подобного метода, посетите страницу http://www.adobe.com/ cfusion/mmform/index.cfm?name=wishform.
□ цветовыеПреобразования — необязательный объект ColorTransform, описывающий любые цветовые изменения, которые должны быть применены к пикселам, переносимым в объект целевойОбъектВИтарОаба. Цветовые преобразования задаются независимо для каждого цветового канала либо с помощью множителя (числа, на которое умножается существующее значение цветового канала), либо с помощью смещения (числа, которое прибавляется к существующему значению цветового канала), либо с помощью обоих способов. Информацию по использованию объекта ColorTransform для выполнения графических преобразований можно найти в описании класса ColorTransform в справочнике по языку ActionScript корпорации Adobe.
□ режимСмешения — необязательная константа класса BlendMode, обозначающая тип смешения, который должен быть применен к пикселам, переносимым в объект целевойОбъектВИтарОаба. Смешение означает использование формул для объединения значений цвета объекта источник с отображаемыми объектами, которые визуально располагаются позади него, обычно с целью создания эффекта наложения. Поддерживаемыми режимами смешения являются BlendMode .MULTIPLY, BlendMode . SCREEN, BlendMode . HARDLIGHT и многие другие, которые знакомы пользователям программы Adobe Photoshop. Реализация режимов смешения в языке ActionScript основывается на стандарте SVG консорциума W3C (описание этого стандарта доступно по адресу http://www.w3.org/TR/2003/WD-SVG12- 20030715/#compositing) и исследовании Дженса Грашела (Jens Gruschel), опубликованного по адресу http://www.pegtop.net/delphi/articles/blendmodes. Описание каждого доступного режима смешения и изображения, иллюстрирующие результаты применения этих режимов, можно найти в описании переменной экземпляра blendMode класса Displayobject в справочнике по языку ActionScript корпорации Adobe.
областьОбрезки — необязательный объект Rectangle, обозначающий прямоугольную область объекта целевойОбъектВ1 tmapData, в которую будут перенесены графические данные объекта источник.
сглаживание — необязательный параметр типа Boolean, который обозначает, должно ли выполняться сглаживание растрового изображения во время рисования. Этот параметр оказывает влияние на результат только в том случае, когда объект источник является объектом BitmapData и указанный объект матрицаПреобразования задает параметры масштабирования или вращения. При этом, когда параметру сглаживание присвоено значение true, объект источник отображается в объекте целевойОбъектВ1tmapData с использованием алгоритма сглаживания растровых изображений языка ActionScript. Когда параметру
сглаживание присвоено значение false, объект источник отображается в объекте целевойОбъектЕН tmapData без сглаживания. Изображение, выводимое с использованием сглаживания, выглядит менее «зазубренным» или «пикселизированным», чем изображение, отображаемое без сглаживания. Это проиллюстрировано на рис. 26.6, где показано небольшое исходное изображение (вверху), которое увеличивается в три раза с помощью объекта Matrix с применением сглаживания (слева) и без применения сглаживания (справа).
Вывод на экран растрового изображения с применением сглаживания занимает больше времени, чем вывод без сглаживания. Чтобы достичь максимально возможной производительности, передавайте в качестве параметра сглаживание значение false; чтобы достичь максимально возможного качества изображения, передавайте в качестве параметра сглаживание значение true. Параметр сглаживание оказывает влияние только на текущую операцию draw ( ); он никак не влияет на применение сглаживания к объекту целевойОбъектВ1tmapData в дальнейшем. '
Рис. 26.6. Сглаживание растрового изображенияРис. 26.6. Сглаживание растрового изображения
Рис. 26.6. Сглаживание растрового изображения
Рис. 26.6. Сглаживание растрового изображения
Метод draw ( ) обычно применяется для:
объединения нескольких отображаемых объектов в одно растровое изображение;
□ растеризации векторного содержимого (то есть преобразования векторов в растровое изображение) с целью применения некоторого эффекта.
Рассмотрим пример каждого случая. Сначала мы создадим две векторные фигуры — прямоугольник и эллипс — и перенесем их в один объект BitmapData. Этот код показан в листинге 26.8.
Векторные фигуры, переносимые в объект BitmapData, не обязаны находиться в списке отображения. Совершенно нормально создавать векторные объекты, не отображая их на экране, просто для того, чтобы скопировать эти объекты в растровое изображение (как показано в листингах 26.8 и 26.9).
Листинг 26.8. Отображаемые объекты, объединенные в растровом изображении
// Создаем прямоугольник
van reel:Shape = new Shape( );
reel.g ra ph1cs.beg1n F111(OxFFOOOO);
reel.graphics.drawRect(0,0.25.50);
// Создаем эллипс
var el 11pse:Shape = new Shape( );
el 11pse.graphlcs.beg1nF111(OxOOOOFF);
el 11pse.graphlcs.drawEl11pse(0.0.35.25);
// Создаем объект BitmapData. Он будет выступать в роли холста
// для рисования, поэтому мы присваиваем его переменной с именем canvas.
var canvas:BitmapData = new BitmapData(100, 100, false, OxFFFFFFFF);
// Переносим векторное изображение прямоугольника на растровое изображение canvas.draw(rect);
// Переносим векторное изображение эллипса на растровое изображение.
// Используем матрицу преобразования, чтобы поместить эллипс в точку
// с координатой (10, 10) внутри объекта BitmapData.
var matrix:Matrix = new Matrix( );
matrix.translateQO, 10);
canvas.draw(ellipse, matrix);
// Связываем объект BitmapData с объектом Bitmap, чтобы отобразить его
// на экране
var bmp;Bitmap = new Bitmap(canvas);
addChiId(bmp);
На рис. 26.7 показано растровое изображение, полученное в результате выполнения предыдущего кода, с увеличенным масштабом для более тщательного рассмотрения. Обратите внимание, что среда выполнения Flash сглаживает края эллипса, поэтому он смешивается с существующим прямоугольником.
" Сглаживание содержимого, переносимого в объект BitmapData, происходит по отношению ** < „ к существующему фону в растровом изображении.
Далее мы воспользуемся методом draw ( ) для выполнения растеризации объекта TextField, чтобы можно было применить к нему эффект растворения на уровне пикселов. Этот код представлен в листинге 26.9.
Рис. 26.7. Отображаемые объекты, объединенные в растровом изображении
Листинг 26.9. Растеризация и последующее растворение объекта TextField package {
import flash.display.*;
import flash.utils.*;
import flash.events.*;
import flash.geom.*;
import fl ash.text.*;
public class DissolveText extends Sprite {
// Переменные, используемые для эффекта растворения
private var randomSeed:int = Math.floor(Math.random( ) * int.MAX_VALUE);
private var destPoint:Point = new Point(0, 0);
private var numberOfPixels:int = 10;
private var destColor:uint = OxFFOOOOOO:
// Объект, в который будет переноситься текст private var bi tmapData .’BitmapData;
// Таймер, используемый для периодического вызова метода pixelDissolve( ) private var t:Timer;'
// Конструктор
public function DissolveText ( ) {
// Создаем текст
var txt:TextField = new TextField( );
txt.text = "Essential Actionscript 3.0";
txt.autoSize = TextFieldAutoSize.LEFT;
txt.textColor = OxFFFFFF;
// Создаем объект BitmapData с размерами,
// достаточными для размещения текста
bitmapData = new BitmapData(txt.width, txt.height, false, destColor);
// Переносим текст в объект BitmapData bitmapData.draw(txt);
// Связываем объект BitmapData с объектом Bitmap, чтобы отобразить его
// на экране
var bitmap:В1tmap = new Bitmap(bitmapData);
addChi1d(b1tmap);
// Начинаем периодически вызывать метод pixelDissolve( ) t = new Timer(lO);
t.addEventtistener(TimerEvent.TIMER, timertistener);
t.start( );
// Обрабатывает события TimerEvent.TIMER
private function timertistener (e;TimerEvent):void { dissolve( );•
// Выполняет растворение
public function dissolve( );void {
// Вызываем метод pixelDissolve( ), чтобы растворить указанное // количество пикселов, и запоминаем возвращенное псевдослучайное // число для следующего раза. Использование возвращаемого // псевдослучайного числа гарантирует плавное растворение. randomSeed = bitmapData.pixelDissolve(bitmapData, bitmapData.rect, destPoint, randomSeed, numberOfPixels, destColor);
// Прекращаем растворение, когда все пикселы будут иметь целевой цвет // (то есть когда ширина и высота области, в которой отсутствует // целевой цвет, будут равны 0) var coloredReglon:Rectangle =
bitmapData.getColorBoundsRect(OxFFFFFFFF, destColor, false): if (coloredRegion.width == 0 && coloredReglon.height == 0 ) { t.stop( ):
}
}
} }
Метод draw ( ) также используется для растеризации векторного содержимого с целью повышения производительности. Например, вспомните простую программу рисования ScribbleAS3, представленную ранее в листинге 26.6. Она рисует точки всякий раз, когда происходит перемещение мыши, но не соединяет нарисованные точки линиями. Одним из способов соединить точки является использование метода экземпляра 1 ineTo ( ) класса Graphics, который рисует векторную линию между двумя точками. Тем не менее применение векторов для рисования линий ограничивает производительность: теоретически можно нарисовать такое количество линий, которое не позволит приложению реагировать на действия пользователя (из-за ограничений в механизме отображения векторов среды выполнения Flash). Для решения этой проблемы мы можем рисовать линии с помощью метода 1 ineTo ( ) в экземпляре класса Shape, не отображаемом на экране. После рисования каждой линии мы копируем ее из объекта Shape в объект BitmapData, после чего очищаем данный экземпляр класса Shape. Поскольку за один раз рисуется только одна векторная линия, приложение никогда не прекратит реагировать на действия пользователя.
В листинге 26.10 продемонстрирован код, часть которого вам знакома из листинга 26.6. Обратите особое внимание на метод drawLine ( ), который выделен полужирным шрифтом.
Листинг 26.10. Приложение ScribbleAS3, версия с не отображаемыми на экране векторами
package {
Import flash.display.*:
Import flash.events.*:
Import flash.ui.*;
Import flash.geom.*:
// Простое приложение для рисования. В данной версии вектор рисуется
// за пределами экрана, после чего он копируется на поверхность растрового
// изображения, исключая снижение производительности, которое связано
// с рисованием слишком большого количества векторов.
public class Seri bbleAS3_VectorV2 extends Sprite {
private var canvas:B1tmap:// Холст растрового изображения,
// отображаемого на экране
private var virtual Canvas:Shape:// Холст векторного изображения.
// не отображаемого на экране
private var canvasContaiпег:Sprite: // Содержит растровое изображение.
// обеспечивая интерактивность
private var isDrawing:Boolean = false; // Сообщает о том. нажата ли
// кнопка мыши в настоящий момент
private var border:Shape:
// Линия вокруг растрового изображения
private var lastX:int:
// х-координата последней точки.
// в которой щелкнул кнопкой мыши пользователь
private var lastY:int;
// у-координата последней точки.
// в которой щелкнул кнопкой мыши пользователь
// Конструктор
public function Seri bbleAS3_VectorV2 ( ) { createCanvas( );•
registerForInputEvents( );
// Предотвращаем изменение размеров окна приложения stage.seal eMode = StageScaleMode.NO_SCALE:
// Создает холст растрового изображения, отображаемого на экране,
// и холст векторного изображения, не отображаемого на экране
private function createCanvas (width:int = 200, height:int = 200):void {
// Создаем новый объект, не отображаемый на экране, в котором будет
// происходить рисование векторных линий перед их переносом
// в объект canvasData
virtual Canvas = new Shape( );
// Определяем объект данных, который будет хранить реальные пиксельные
// данные для рисунка пользователя. Линии копируются из объекта
// virtual Canvas в данный объект.
var canvasData:BitmapData = new BitmapData(width.
height, false. OxFFFFFFFF);
// Создаем новый отображаемый объект Bitmap, используемый
// для отображения объекта canvasData canvas = new Bitmap(canvasData);
// Создаем объект Sprite, который будет содержать объект Bitmap. Класс
// Bitmap не поддерживает пересылаемые события ввода, поэтому помещаем его // в объект Sprite, чтобы пользователь мог взаимодействовать с этим объектом. canvasContainer = new SpriteC ):
canvasContaiпег.addChi1d(canvas);
// Добавляем экземпляр canvasContainer класса Sprite (и содержащийся
// в нем объект Bitmap) в иерархию отображения данного объекта
addChi 1 d(canvasConta1 пег);
// Создаем границу вокруг области рисования, border = new Shape( ):
border.graphics.1ineSty1e (1):
border.graphics.drawRectCO. 0, width, height): addChi1d(border);
// Регистрирует приемники для необходимых событий мыши и клавиатуры private function registerForInputEvents ( );void {
// Регистрируем приемники для событий нажатия кнопки мыши
// и перемещения мыши от объекта canvasContalner canvasContal пег.addEventLi stener(MouseEvent.MOUSE_DOWN, mouseDownListener);
canvasContalner.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveListener);
// Регистрируем приемники для событий отпускания кнопки мыши и нажатия // клавиши от объекта Stage (то есть для глобальных событий).
// Используем объект Stage, поскольку событие отпускания кнопки мыши // должно всегда завершать рисование, даже если указатель мыши // не находится над областью рисования. Подобным образом, нажатие // пробела должно всегда приводить к стиранию рисунка, даже когда // объект canvasContalner не имеет фокуса.
stage.addEventListener(MouseEvent.MOUSE_UP, mousellpListener);•
stage.addEventListener(Keyboardsvent.KEY_DOWN, keyDownListener);
}
// Устанавливает цвет указанного пиксела. Используем этот способ
// для рисования одиночного пиксела, поскольку метод Graphics.11пеТо( ) // не рисует одиночные пикселы public function drawPoint (x:int, y:int, color:uint = OxFFOOOOOO):void { // Устанавливаем цвет указанного пиксела canvas.bitmapData.setPixel(х, у, color);
},
// Рисует векторную линию в объекте virtual Canvas, а затем копирует
// растровое представление этой линии в объект canvasData (доступ // к растровому представлению осуществляется через переменную // canvas.bitmapData)
public function drawLine (xl:int, yl:int, x2:int, y2:int, col or:uint = OxFFOOOOOO):void { // Рисуем линию в объекте virtual Canvas virtualCanvas.graphics.cl ear( ): virtual Canvas, graphics. lineStyleU, 0x000000, 1, true,
LineScaleMode.NORMAL, CapsStyle.NONE); virtualCanvas.graphics.moveTo(xl, yl): virtualCanvas.graphics.1i neTo(x2, y2);
// Копируем линию в объект canvasData canvas.bitmapData.draw(virtualCanvas);
// Отвечает на события MouseEvent.MOUSE_DOWN
private function mouseDownListener (e;MouseEvent):void {
// Устанавливаем флажок, указывающий на то, что основная кнопка мыши // в настоящий момент нажата
isDrawing = true;
// Запоминаем точку, в которой щелкнул пользователь, чтобы в случае // перемещения мыши мы могли нарисовать линию из этой точки lastX = e.localX;
lastY = е.localY:
// Рисуем точку в позиции, где произошел щелчок кнопкой мыши drawPolnt(е.1ocalX, e.localY);
// Отвечает на события MouseEvent.MOUSE_MOVE
private function mouseMoveListener (e;MouseEvent);void {
// Рисуем линию, когда мышь перемещается над областью рисования
// при нажатой основной кнопке мыши
if (IsDrawing) {
// Используем переменные localX и localY, чтобы получить позицию
// указателя относительно объекта canvasContainer.
var thisX;int = e.localX;
var thisY:int = e.localY;
// Рисуем линию в новую позицию указателя мыши
drawLine(lastX, lastY, thisX, thisY);
// Запоминаем последнюю позицию указателя мыши
// для следующего раза
lastX = thisX;
lastY = thlsY;
// Обновляем экран сразу после завершения выполнения
// данной функции-приемника события
e.updateAfterEventt );
}
// Отвечает на события MouseEvent.MOUSE_UP
private function mousellpListener (e.-MouseEvent); void {
// Устанавливаем флажок, указывающий на то, что в настоящий момент
// основная кнопка мыши отпущена
IsDrawing = false;
// Отвечает на события KeyboardEvent.KEY_DOWN
private function keyDowntistener (e:Keyboardsvent):void {
// Стираем рисунок, когда пользователь нажимает клавишу Пробел.
// Чтобы очистить рисунок, мы присваиваем всем пикселам
// значение белого цвета.
if (е.charCode == Keyboard.SPACE) {
canvas.bitmapData.fillRect(new RectangleCO. 0,
canvas.width, canvas.height), OxFFFFFFFF);
}
}
}
}
Как метод draw( ) использует значения канала Alpha. Когда прозрачный объект-источник BitmapData копируется в прозрачный целевой объект BitmapData
с помощью метода draw ( ), каналы Alpha двух объектов BitmapData объединяются вместе на уровне пикселов с использованием алгоритма режима смешения BlendMode. SCREEN, который записывается следующим образом:
(значениеА1рМаИсходного0бъекта * (256-значениеА1рЬаЦелевого0бъекта) / 256) + значениеА1рМаЦелевого0бъекта
Когда значения канала Alpha двух объединяемых объектов находятся в диапазоне от 1 до 254, результатом будет являться значение канала Alpha с большей непрозрачностью, чем любое из исходных значений канала Alpha. Если объединяемый источник является полностью прозрачным, целевой объект BitmapData сохраняет свое исходное значение канала Alpha. Если целевой объект является полностью прозрачным, его значение канала Alpha заменяется значением канала Alpha объекта-источника.
Чтобы полностью заменить значения канала Alpha в целевом объекте BitmapData значениями объекта-источника BitmapData (вместо объединения двух значений), используйте метод copyPixels ( ) вместо метода draw ( ). Дополнительную информацию можно найти в подразд. «Метод экземпляра copyPixels( ) класса BitmapData» данного раздела.
Невозможность произвольного захвата изображения экрана. Стоит отметить, что в ActionScript невозможно захватить изображение экрана в произвольной прямоугольной области. Язык ActionScript позволяет лишь преобразовывать отображаемые объекты в растровый формат. В ActionScript ближайшим аналогом операции захвата изображения области отображения является использование экземпляра класса Stage в качестве параметра источник метода draw ( ), как показано в следующем коде:
var canvas:BitmapData = new BitmapData(100, 100, false, OxFFFFFFFF);
canvas Лгем(некийОбъектО1 spl ayObject .stage):
Здесь некийОбъектО1spl ayObject — это экземпляр класса Displayobject, находящийся в списке отображения. Предыдущий код создает растровое изображение, содержащее все объекты, которые в настоящий момент находятся в списке отображения, со следующими оговорками:•
цвет фона SWF-файла не копируется в растровое изображение;
если доступ к объектам, находящимся в списке отображения, запрещен из-за ограничений безопасности, они не копируются в растровое изображение и генерируется исключение SecurityError.
Метод экземпляра copyPixelsf) класса BitmapData
Как и draw ( ), метод copyPixels ( ) применяется для копирования значений цвета пикселов из объекта-источника в целевой объект BitmapData. Однако в отличие от метода draw ( ), который копирует пиксельные данные из любого экземпляра класса DisplayObj ect или объекта BitmapData, метод copyPixels ( ) может копировать их только из объектов BitmapData. Этот метод отличается производительностью и удобством использования. Тестирование показывает, что операции copyPixels ( ) быстрее эквивалентных операций draw ( ) на 25-300 %.
Чтобы достичь максимальной производительности при копировании значений цвета пикселов между двумя объектами BitmapData, используйте метод copyPixels() вместо метода draw().
Помимо того что метод copyPixels ( ) производительнее метода draw ( ), он предоставляет разработчику простой доступ к таким операциям, как:
размещение пикселов из объекта-источника в определенной точке объекта-получателя;
объединение канала Alpha одного растрового изображения с каналом Alpha другого растрового изображения;
перезапись значений канала Alpha целевого растрового изображения при копировании в него пикселов из исходного растрового изображения.
Хотя все три перечисленные операции также могут быть реализованы с помощью метода draw ( ) совместно с другими методами класса BitmapData, метод copyPixels ( ) обычно предпочтителен благодаря его удобству.
Метод copyPixels ( ) имеет следующий вид:
целевой0бъектВ1tmapData.соруР1xel s(исходный0бъектВ1tmapData, исходнаяОбласть, целеваяТочка, объектВ1tmapDataKaнaлaAIpha. точкаКаналаАIpha.
объединениеКаналовА Ipha)
Здесь целевой0бъектВ1tmapData — это объект BitmapData, в который будут перенесены пикселы. Рассмотрим параметры метода draw ( ).
исходный0бъектВ1tmapData — экземпляр класса BitmapData, который будет скопирован в объект целевойОбъектВ!tmapData. Объекты исходный0бъектВ1tmapData и це- левой0бъектВ1tmapData могут являться одним объектом, позволяя копировать пикселы из одной области изображения в другую область того же изображения.
исходнаяОбласть — объект Rectangle, определяющий область объекта исходный- ОбъектВ1tmapData, которая будет скопирована в объект целевой0бъектВ1tmapData. Чтобы скопировать весь объект исходный0бъектВ1tmapData, используйте переменную исходный0бъектВ1 tmapData.reel. Если в функцию передается аргумент объектВт tmapDataKaнaлaAльфa, данный параметр также определяет ширину и высоту прямоугольной области внутри объекта объектВ1tmapDataKaнaлaA Ipha, значения канала Alpha которой будут скопированы в объект целевойОбъект- BitmapData.
целеваяТочка — объект Point, определяющий позицию левого верхнего угла прямоугольной области внутри объекта целевойОбъектВ! tmapData, в которую будут помещены копируемые пикселы.
□ объектВ!tmapDataKaнaлaA Ipha — необязательный объект Bi tmapData, отличный от объекта исходныйОбъектВ! tmapData, значения канала Alpha которого станут новыми значениями канала Alpha пикселов, переносимых в объект целевойОбъектВ1 tmapData. Высота и ширина конкретной прямоугольной области, значения канала Alpha которой будут скопированы в объект целевойОбьектВт tmapData, определяются параметром исходнаяОбласть.
С помощью этого параметра мы можем объединять RGB-каналы одного растрового изображения (исходный0бъектВ1tmapData) с каналом Alpha другого растрового изображения (oбъeктBitmapDataKaнaлaA Ipha). Подобная методика может быть использована, например, для создания на фотографиях в электронном приложении, имитирующем альбом для наклеивания газетных вырезок, эффекта краев неправильной формы. Каждая фотография могла бы храниться в своем собственном объекте BitmapData, а края неправильной формы можно было бы хранить в виде значений канала Alpha в одном повторно используемом объекте BitmapData. С помощью параметра объектВ1 tmapDataKaнaлaA Ipha метода copyPixels ( ) канал Alpha растрового изображения с краями неправильной формы можно было бы объединять с фотографиями на этапе выполнения программы.
точкаКаналаА1рМа — объект Point, определяющий левый верхний угол прямоугольной области внутри объекта объектВ1 tmapDataKaнaлaA Ipha, из которой будут получены значения канала Alpha. Ширина и высота прямоугольной области задаются параметром исходнаяОбласть.
□ объединениеКаналовА Ipha — значение типа Boolean, которое показывает, должны ли значения каналов Alpha объектов целевой0бъектВ1tmapData и исходныйОбъ- ектВ1 tmapData в процессе копирования данных объединяться (true), или значения канала Alpha объекта исходный0бъектВ1 tmapData должны полностью заменять существующие значения канала Alpha объекта целевойОбъектВ1 tmapData (false). Этот параметр оказывает влияние на результат только в том случае, когда оба объекта целевойОбъектВ1 tmapData и исходный0бъектВ1 tmapData являются прозрачными растровыми изображениями. Значением по умолчанию является false, указывающее, что значения канала Alpha объекта исходный0бъектВ1 tmapData полностью заменяют существующие значения канала Alpha объекта целевойОбъ- eKTBitmapData. Алгоритм, используемый для объединения значений каналов Alpha, соответствует алгоритму, рассмотренному ранее в подразд. «Метод экземпляра draw( ) класса BitmapData» данного раздела.
Метод copyPixels ( ) предпочтительно применять для перемещения пикселов между двумя объектами BitmapData. Перемещение пикселов между растровыми изображениями является распространенной операцией в приложениях для работы с графикой и в видеоиграх. Рассмотрим несколько примеров.
Попрактикуемся в использовании базового синтаксиса метода copyPixels ( ), создав квадраты синего и красного цвета и скопировав область квадрата синего цвета в квадрат красного цвета.
// Создаем квадраты (размером 20 х 20 пикселов каждый)
var redSquare:В1tmapData = new BitmapData(20. 20. true. OxFFFFOOOO);
var blueSquare:B1tmapData = new B1tmapData(20. 20. true. OxFFOOOOFF);
// Определяем прямоугольную область, которая будет скопирована из объекта
// blueSquare в объект redSquare
var sourceRect:Rectangle = new Rectangle(5. 5. 10. 5);
// Определяем точку в объекте redSquare. в которую будет помещена // прямоугольная область из объекта blueSquare
var destPolnt:Point = new Point(0,0):
// Копируем пикселы
redSquare.copyPIxels(blueSquare, sourceRect. destPoInt);
// Связываем объект BitmapData redSquare с объектом Bitmap для отображения
// на экране
var b:B1tmap = new B1tmap(redSquare);
addChlld(b);
В листинге 26.11 представлен другой пример — создание фотографии с краями неправильной формы, как было описано ранее при рассмотрении параметра объ - eKTBItmapDataKaHanaAlpha. Понять код вам помогут комментарии. Обратите особое внимание на метод makeScrapbooklmage ( ).
Листинг 26.11. Эффект старой фотографии
package {
Import flash.display.*;
Import flash.events.*;
Import flash.geom.*;
Import flash.net.*;
public class Scrapbook Image extends Sprite {
private var numLoaded;1nt = 0;
private var photoLoader:Loader;// Загрузчик фотографии
private var borderLoader:Loader; // Загрузчик рамки
// Конструктор
public function Scrapbook Image ( ) {
// Загружаем фотографию
photoLoader = new LoaderC );
photoLoader.contentLoaderInfo.addEventLIstener(Event.INIT.
1n1tL1stener);
photoLoader.1oadtnew URLRequestC"photo.jpg"));
// Загружаем рамку*
borderLoader = new Loader( );
borderLoader.contentLoaderInfo.addEventL1stener(Event.INIT.
.1n1tL1stener);
borderLoader.load(new URLRequestC"border.png"));
}
// Обрабатывает события Event.INIT для загруженных изображений
private function 1n1tL1stener (e:Event):vo1d {
numLoaded++;
1f (numLoaded == 2) { makeScrapbookImage( );
}
}
// Объединяет изображение рамки с изображением фотографии, чтобы создать
// эффект старой фотографии
public function makeScrapbooklmage ( ):void {
// Получаем объект BitmapData для фотографии
var photoData:BltmapData = Bitmap(photoLoader.content).bitmapData: // Получаем объект BltmapData для рамки
var borderData:B1tmapData = BitmapCborderLoader.content).bitmapData: // Создаем объект BitmapData, который будет хранить завершенное // изображение фотографии
var scrapbook Image:BitmapData = new BitmapData(borderData.width, borderData.height, true, OxFFFFFFFF):
// Копируем пикселы из фотографии.
// применяя значения канала Alpha рамки scrapbook Image.copyPixels(photoData, borderData.rect, new Point(O.O), borderData, new Point(0,0), true);
// Связываем объект BitmapData scrapbookimage с объектом Bitmap
// для отображения на экране
var b:Bitmap = new Bitmap(scrapbooklmage):
addChild(b):
b.x = 100:
b.y = 75;
На рис. 26.8 проиллюстрированы результаты выполнения кода из листинга 26.11.
Исходное изображение показано слева, а изображение с «краями» — справа.
Рис. 26.8. Эффект старой фотографии
Изображения и код из листинга 26.11 доступны в Интернете по адресу http://www. moock.org/eas3/examples.
Метод copyPixels ( ) также предоставляет эффективный способ для повторного использования набора значений пикселов. Например, в двухмерных видеоиграх фоновые изображения зачастую генерируются динамически из небольшой группы готовых растровых изображений, называемых мозаиками. По мере перемещения игрока по виртуальному миру программа отображает соответствующий набор
фоновых мозаик. С помощью метода copyPixel s ( ) каждая мозаика копируется из повторно используемого объекта BitmapData в фоновое изображение, отображаемое на экране. Хотя подробное рассмотрение системы мозаичных фоновых изображений выходит за рамки данной книги, полнофункциональный пример мозаики на языке ActionScript может быть загружен с сайта http://www.moock.org/ eas3/examples.
Применение фильтров и эффектов
Для создания графических эффектов мы можем использовать следующий широкий диапазон инструментов, предоставляемых классом BitmapData.
colorTransform ( ) — из меняет цвета с помощью объекта ColorTransform, который предоставляет базовый интерфейс для простейших цветовых преобразований (для более сложного управления цветовыми преобразованиями используйте класс ColorMatrixFilter).
a ppi у Fil ter ( ) — изменяет растровое изображение с помощью предопределенных фильтров-эффектов, например падающей тени или размытия. Дополнительную информацию можно найти далее в разделе.
noise ( ) — заполняет растровое изображение случайными значениями цветов из настраиваемых диапазонов. На рис. 26.9 показано изображение, созданное с помощью метода п о i s е ( ).
Рис. 26.9. Растровое изображение, заполненное шумом
perlinNoise( ) — заполняет растровое изображение случайными образцами значений цветов, выполненных в органическом стиле. На рис. 26.10 показано изображение, сгенерированное с помощью метода perl inNoise ( ). Результаты выполнения метода perlinNoise ( ) обычно не используются напрямую; этот фильтр часто применяется вместе с другими фильтрами для создания имитации волн, пламени, облаков, воды, текстуры древесины и ландшафтов. Общее описание шума Перлина можно найти во вводной лекции Кена Перлина (Ken Perlin) по адресу http://www.noisemachine.com/talkl. Пример на языке ActionScript, демонстрирующий использование метода perlinNoise( ) для создания текстуры древесины, можно найти по адресу http://www.connectedpixel. com/blog/texture/wood. Пример создания текстуры мрамора вы найдете по адресу http://www.connectedpixel.com/blog/texture/marble.
1
Рис. 26.10. Растровое изображение, заполненное с помощью шума Перлина
paletteMap( ) — заменяет цвета в изображении цветами из таблицы перекодировки или другого изображения.
pixelDissolve ( ) — при циклическом использовании в анимации создает эффект перехода между двумя изображениями или пиксел за пикселом заменяет цвета изображения указанным цветом (пример замены цветов изображения указанным цветом можно найти в листинге 26.9).
threshold ( ) — преобразует пикселы из некоторого диапазона цветов к новому указанному значению цвета.
Хотя каждый из перечисленных методов предоставляет множество возможностей для работы с графикой, в этом разделе мы сосредоточим внимание на инструменте, который, возможно, обладает наиболее универсальной применимостью, — методе applyFilter ( ). Дополнительную информацию о других методах, предназначенных для создания эффектов, можно найти в описании класса BitmapData в справочнике по языку ActionScript корпорации Adobe.
Применение фильтров. Чтобы предоставить программистам удобный способ применения распространенных графических эффектов к растровому изображению, язык ActionScript предлагает набор готовых графических фильтров.
Фильтры, рассматриваемые в этом разделе, могут на постоянной основе применяться к объекту BitmapData на уровне пикселов, но они также могут применяться к любому отображаемому объекту или удаляться из него динамически. Дополнительную информацию можно получить в описании переменной экземпляра filters класса Displayobject в справочнике по языку ActionScript корпорации Adobe.
Каждый предопределенный фильтр представляется собственным классом в пакете flash. filter s. Например, фильтр размытия, который делает растровое изображение размытым, представляется классом flash. filters . BlurFilter.
Некоторые фильтры могут быть легко использованы даже теми разработчиками, которые не имеют никакого опыта в программировании графики. К этой категории относятся следующие фильтры: фаска, размытие, падающая тень и свечение, которые представляются классами BevelFil ter (и его разновидностью с градиентом GradientBevelFilter), BlurFilter, DropShadowFilter и GlowFilter (и его разновидностью с градиентом GradientGlowFilter).
Другие фильтры требуют понимания фундаментальных методик программирования графики, например таких, как искривление, замещение и цветовые матрицы. К этой категории относятся следующие фильтры: матричное искривление, карта замещения и преобразования цветовых матриц, которые представляются классами ConvolutionFilter, DisplacementMapFilter иColorMatrixFilter.
Независимо от типа фильтра, методика применения фильтра к растровому изображению в языке ActionScript остается одной и той же.
Создать экземпляр класса нужного фильтра.
Передать созданный экземпляр класса фильтра в метод applyFilter ( ).
Например, чтобы применить фильтр размытия к растровому изображению, мы создаем экземпляр класса BlurFilter, используя следующий обобщенный формат: new ВТигЕПТегСразмыгие/, размытиеУ, качество)
Здесь размытиеХ и размытиеУ обозначают дистанцию размытия каждого пиксела по горизонтали и вертикали, а качество — качество визуализации данного эффекта, выражаемое через одну из трех констант класса BitmapFilterQuality.
Следующий код создает эффект размытия среднего качества, охватывающий 15 пикселов по вертикали и горизонтали:
van blurFi1 ter:Bl urF11 ter =
new BlurF11ter(15. 15, B1tmapFI1terQuality.MEDIUM);
После создания фильтра мы применяем его к объекту BitmapData, используя следующий код:
целевойОбъектВ! tmapData. applyFi 1 ter(исходныйОбъектВ1tmapData, исходнаяОбласть.
целеваяТочка, фильтр);.
Здесь целевойОбъектВ!tmapData — это объект BitmapData, в который будут перенесены пикселы с примененным фильтром. Рассмотрим параметры метода applyFilter ( ).
исходныйОбъектВ1 tmapData — объект BitmapData, к которому будет применен фильтр. Объекты исходныйОбъектВ1 tmapData и целевой0бъектВ1tmapData могут быть одним объектом, позволяя применять фильтр непосредственно к некоторому объекту BitmapData.
исходнаяОбласть — объект Rectangle, определяющий область объекта исход- ныйОбъектВ1 tmapData, к которой будет применен фильтр. Чтобы применить фильтр ко всему растровому изображению, используйте переменную исход- ныйОбъектВ1tmapData.rect.
целеваяТочка — объект Point, определяющий позицию внутри объекта целевой- ОбъектВ1 tmapData, куда будут помещаться пикселы с примененным фильтром. Обратите внимание, что параметр целеваяТочка соответствует левому верхнему углу указанного объекта исходнаяОбласть, а не левому верхнему углу области пикселов, к которой применяется операция фильтрации. Дополнительная информация приводится далее, при рассмотрении метода generateFil terRect ( ).
фильтр — это объект используемого фильтра, например экземпляр какого- либо из следующих классов: BevelFilter, GradientBevelFilter,
BlurFilter, DropShadowFilter, GlowFilter, GradientGlowFilter, ConvolutionFilter, DisplacementMapFilter или ColorMatrixFilter.
Следующий код применяет созданный ранее объект BlurFilter ко всему объекту BitmapData:
ЫtmapData.applyFI1ter(b1tmapData, ЫtmapData.rect, new Polnt(O.O), blurFIlter);
На рис. 26.11 показаны результаты применения к изображению объекта BlurFilter размером 15x15 пикселов. .,
Рис. 26.11. Примененный фильтр размытияРис. 26.11. Примененный фильтр размытия
Рис. 26.11. Примененный фильтр размытия
Рис. 26.11. Примененный фильтр размытия
Когда фильтр применяется к растровому изображению, размеры результирующего растрового изображения зачастую оказываются больше размеров исходного. Например, результатом применения фильтра падающей тени может оказаться тень, выходящая за границы исходного растрового изображения. Чтобы полностью сохранить результаты применения фильтра, мы должны убедиться, что целевое изображение способно уместить все переносимые пикселы с примененным фильтром. Чтобы определить размеры растрового изображения, достаточные для сохранения результатов применения фильтра, мы используем метод экземпляра generateFilterRect ( ) класса BitmapData. Этот метод возвращает объект Rectangle, который обозначает область пикселов, затрагиваемую данной операцией фильтрации. Метод имеет следующий обобщенный вид:
исходный0бъектВ1tmapData.generateFI1terRect(исходнаяОбласть , фильтр)
а *а *Метод generateFilterRect ( ) возвращает объект Rectangle, который обозначает область пикселов, затрагиваемую указанным объектом фильтра (филь тр) в том случае, если этот фильтр будет применен к указанной прямоугольной области (исходнаяОбласть) указанного объекта BitmapData (исходный0бъектВ1tmapData).
а *
а *
Метод generateFilterRect() на самом деле не применяет фильтр. Он просто определяет область пикселов, которая будет затронута данным фильтром в случае его применения.
Попробуем применить метод generateFilterRect ( ) на практике. Наша цель — создать растровое изображение с эффектом падающей тени. Сначала мы создаем исходное растровое изображение без эффекта падающей тени. Исходное изображение представляет собой квадрат серого цвета размером 20 х 20 пикселов.
van origBItmap:BitmapData = new B1tmapData(20, 20. false, OxFFDDDDDD);
Далее мы создаем объект DropShadowFil ter. Конструктор его класса имеет следующий вид:
DropShadowF11 ter(расстояние:Number=4.0, угол:Number=45, цвет:u1nt=0, прозрачность :Number=l.О, размытиеХ:Number=4.О, размытиеУ:Number=4.О, интенсивность :Number=l.О, качество:1nt=l, внутренняя:Boolean=faIse,,
выколотка:Boolean = false, скрытьОбъект:Boolean = false)
Сведения о различных параметрах конструктора класса DropShadowFil ter можно найти в описании этого класса в справочнике по языку ActionScript корпорации Adobe. Вот наш объект DropShadowFilter:
var dsF11 ter:DropShadowF!1 ter = new DropShadowF1lter(4, 45, 0,
10, 10,
B1tmapFI1terQual1ty.MEDIUM);
/(алее используем метод generat eFil terRec t ( ), чтобы определить, насколько увеличатся размеры нашего исходного изображения после применения объекта DropShadowFilter:
var filterRect:Rectangle = or1gB1tmap.generateF1lterRect(or1gB1tmap.rect, dsF11 ter);
Теперь мы можем создать новое растровое изображение с необходимыми размерами, в которое будет перенесено исходное растровое изображение с примененным фильтром падающей тени. Обратите внимание, что мы указываем высоту и ширину нового растрового изображения с использованием результатов, возвращаемых методом generateFilterRect ( ) (выделены полужирным шрифтом):
var fjnalBitmap:BltmapData = new B1tmapData(filterRect.w1dth,
f 11terRect.height, true):
Целевой объект BitmapData для фильтра эффекта падающей тени должен быть прозрачным.
Теперь, когдау нас есть исходное растровое изображение, объект DropShadowFilter и целевое растровое изображение с подходящими размерами, мы можем применить наш фильтр падающей тени, как показано в следующем коде:
f 1 nalBitmap.a pp1уF11 ter(origB1tmap, origB1tmap.rect,
new Po1nt(-f1lterRect.x, -filterRect.y), dsFIlter);
В данном коде обратите внимание, что передаваемый параметр целеваяТочка смещает пикселы с примененным фильтром на значение, равное расстоянию, на которое результат применения фильтра выходит за верхнюю и левую границу указанного параметра исходнаяОбласть. В нашем примере эффект фильтра применяется ко всему растровому изображению, поэтому левый верхний угол объекта исходнаяОбласть находится в точке с координатой (0; 0). Размытие падающей тени расширяет исходное растровое изображение на 9 пикселов вверх и на 9 пикселов влево. Следовательно, координата по оси X сгенерированного фильтром прямоугольника, как и координата по оси Y, будет равна -9. Чтобы переместить левый верхний угол
области пикселов с примененным фильтром вниз и вправо (в левый верхний угол растрового изображения, содержащего результат применения фильтра), мы указываем объект целеваяТочка, который использует обратные значения координат по осям X и Y прямоугольника фильтра:
new Ро1nt(-f11terRect.х, -filterRect.y)
Для обзора ниже представлен весь код, создающий эффект падающей тени:
van or1gB1tmap:В1tmapData = new В1tmapData(20, 20, false, OxFFDDDDDD);
van dsF1lter:DropShadowF1lter = new DropShadowF1lter(4, 45, 0,
10, 10,
B1tmapF1IterQual1ty.MEDIUM): var f11terRect:Rectangle = or1gB1tmap.generateF1lterRect(or1gB1tmap.rect,
dsF11 ter);
var f1nalB1tmap:B1tmapData = new B1tmapData(f1lterRect.width,
f11terRect.height, true): f1nalBitmap.applyF1lter(or1gB1tmap, or1gB1tmap.rect,
new Po1nt(-f11terRect.x, -filterRect.y), dsFIlter):
На рис. 26.12 показаны результаты выполнения предыдущего кода.
J
Рис. 26.12. Изображение с примененным фильтром падающей тени
Теперь, когда мы рассмотрели основы использования фильтров, вернемся к листингу 26.11, чтобы улучшить эффект старой фотографии. В листинге 26.12 показан новый код. Общая методика создания и применения фильтров в этом примере уже должна быть вам знакома. Тем не менее в примере используется специальный фильтр, который мы еще не рассматривали: ColorMatrixFilter. Этот фильтр с помощью матричных преобразований изменяет цвета в растровом изображении для создания таких эффектов, как, например, настройка яркости, контраста и насыщенности, изменение оттенка. Этот пример демонстрирует, как использовать фильтр ColorMatrixFilter в его исходном виде, но по крайней мере два разработчика предоставляют бесплатный код для выполнения распространенных матричных преобразований:
класс ColorMatrix Марио Клингеманна (Mario Klingemann) — http://www. quasimondo.com/archives/000565.php;
класс ColorMatrix Гранта Скиннера (Grant Skinner) — http://www.gskinner.com/ blog/archives/2005/09/flash_8_source.html.
Общую информацию по цветовым матричным преобразованиям можно найти в статье «Using Matrices for Transformations, Color Adjustments, and Convolution Effects in Flash» Фила Чанга (Phil Chung), доступной по адресу http://www.adobe.com/devnet/ flash/articles/matrix_transformations_04.html.
Листинг 26.12. Эффект старой фотографии, теперь с фильтрами
package {
Import flash.display.*;
Import flash.events.*;
Import flash.geom.*;
Import flash.net.*:
Import flash.filters.*;
public class Scrapbook Image extends Sprite {
private var numLoaded;1nt = 0;
private var photoLoader .-Loader;// Загрузчик фотографии
private var borderLoader-.Loader; // Загрузчик рамки
public function Scrapbook Image ( ) {
// Загружаем фотографию
photoLoader = new Loader( );
photoLoader.contentLoaderInfo.addEventLIstener(Event.IN IT, 1n1tL1stener);
photoLoader.load(new URLRequest("photo.jpg"));
// Загружаем рамку
borderLoader = new Loader( );
borderLoader.contentLoaderInfo.addEventLIstener(Event.IN IT,
1n1tL1stener);
borderLoader.1oad(new URLRequest("border.png"));
// Обрабатывает события Event.INIT для загруженных изображений private function 1n1tL1stener (e:Event):vo1d {
numLoaded++;
// Применяем эффект, когда загружены оба изображения
1f (numLoaded == 2) { makeScrapbookImage( );
}
}
// Объединяет изображение рамки с изображением фотографии,
// чтобы создать эффект старой фотографии
public function makeScrapbookImage ( ):vo1d {
// Получаем объект BltmapData для фотографии
var photoData-.BltmapData = B1tmap(photoLoader.content).bltmapData;
// Получаем объект BltmapData для рамки
var borderData:B1tmapData = B1tmap(borderLoader.content).bltmapData;
// Создаем объект BltmapData, который будет хранить завершенное
// изображение фотографии
var tempBItmapData;BltmapData = new B1tmapData(borderData.width, borderData.helght, true, 0x00000000);
// Копируем пикселы из фотографии, применяя значения
// канала Alpha рамки
tempBItmapData.соруР1xels(photoData,
borderData.rect, new Po1nt(0,0),
borderData, new Point(0,0), false);
// Фильтр ColorMatrlxF11 ter,
// который увеличит яркость изображения
van brightnessoffset:int = 70;
var br1ghtnessF1lter;ColorMatr1xF1lter = new ColorMatr1xF1lter(
new Array(1, 0.0.0, br1ghtnessOffset,
0,1,0,0,br1ghtnessOffset,
0,0,1,0,br1ghtnessOffset,
0.0,0.1,0));
// Фильтр размытия, который делает изображение размытым var blurF11 ter:BlurF11 ter = new BlurF11 ter(1, 1);
// Фильтр падающей тени, который создает эффект изображения.
// наклеенного на бумагу
var dropShadowFIIter:DropShadowFIIter = new DropShadowFIIter(4. 35. 0x2E2305, .6, 5, 12, 4, B1tmapFI1terQual1ty.MEDIUM);
// Определяем область, необходимую для отображения изображения
// и его падающей тени
var f11teredlmageRect;Rectangle = tempB1tmapData.generateF1lterRect( tempBItmapData.rect, dropShadowFIIter);
// Создаем объект BltmapData, который будет хранить
// завершенное изображение
var scrapbook Image;BltmapData =
new B1tmapData(f11teredlmageRect.w1 dth, f11teredlmageRect.he1 ght, true,
OxFFFFFFFF);
// Применяем фильтр ColorMatr1xF1lter, увеличивающий яркость tempB1tmapData.applyF1lter(tempB1tmapData, tempBItmapData.rect, new Po1nt(0,0), br1ghtnessF1lter);
// Применяем фильтр BlurFilter
tempBItmapData.applyFIIter(tempBI tmapData, tempBItmapData.rect.
new Point(O.O),
blurFIlter);.
// Применяем фильтр DropShadowFIIter scrapbookImage.applyF1lter(tempB1tmapData, tempBItmapData.rect, new Po1nt(-f1lteredImageRect.x,
-f11teredlmageRect.у), dropShadowFIIter);
// Связываем объект BitmapData scrapbook Image с объектом Bitmap
// для отображения на экране
var b:B1tmap = new Bltmap(scrapbooklmage);
addChlld(b);
b.x = 100;
b.y = 75;
На рис. 26.13 показаны результаты выполнения кода из листинга 26.12.
Рис. 26.13. Эффект старой фотографии, теперь с фильтрами
Освобождение памяти, занимаемой . растровыми изображениями
Каждый пиксел в любом объекте BitmapData занимает небольшое количество системной памяти — 4 байта, если быть точным (один байт для каждого цветового канала). Хотя объем памяти, занимаемой каждым пикселом, сам по себе незначителен, в совокупности пикселы могут приводить к существенному расходованию памяти. Таким образом, чтобы уменьшить объем памяти, потребляемый средой Flash при работе с растровыми изображениями, каждая программа на языке ActionScript должна гарантировать, что все объекты BitmapData, когда в них отпадает необходимость, становятся доступными для сборки мусора.
Чтобы некоторый объект Bi tmapData стал доступен для сборки мусора, необходимо удалить все ссылки либо на него, либо на объекты, которые ссылаются на данный объект. В любом случае память, занимаемая объектом BitmapData, будет автоматически освобождена сборщиком мусора в следующем цикле сборки мусора.
Чтобы немедленно освободить память, занимаемую пикселами объекта BitmapData (вместо того чтобы ожидать освобождения памяти сборщиком мусора), используйте метод экземпляра dispose ( ) класса BitmapData. Например, следующий
код создает объект BitmapData, который занимает 1600 байт (ширина 20 пикселов х высота 20 пикселов х 4 байта на пиксел):
van ImgData:BitmapData = new B1tmapData(20, 20, false, OxFFOOFFOO):
Чтобы немедленно освободить 1600 байт памяти, мы используем метод dispose ( ), как показано в следующем коде:
ImgData.d1spose( ): // Освобождаем память, занимаемую объектом ImgData
Метод dispose ( ) освобождает память, в которой хранится информация о пикселах объекта imgData, но не освобождает память, занимаемую самим объектом imgData. Память, занимаемая объектом imgData, будет освобождена в соответствии с обычным циклом сборки мусора.
Как только над объектом BitmapData будет вызван метод dispose ( ), данный объект окажется недоступным. Обращение к его методам и переменным приведет к генерации исключения ArgumentError.
Метод dispose ( ) может быть полезен для управления памятью, потребляемой функциями или циклами, в которых используются временные растровые изображения, как, например, в случае создания изображения с применением фильтров, образующегося путем объединения нескольких временных изображений.
Слова, слова, слова
В двух предыдущих главах мы рассматривали методики создания изображений для отображения на экране. В следующей главе мы узнаем, как создавать текст для отображения на экране.
Отображение и ввод текста
Приложение Flash Player предоставляет расширенный, усовершенствованный интерфейс API для работы с текстом. В этой главе мы познакомимся с некоторыми из его ключевых возможностей — созданием и отображением текста, форматированием текста и обработкой текстового ввода.
Информация, представленная в этой главе, относится конкретно к приложению Flash Player (к автономной версии и к версии, реализованной в виде модуля расширения браузера). Однако в целом эта информация также применима к любой среде выполнения Flash, поддерживающей полнофункциональное отображение и ввод текста, например к приложению Adobe AIR, Стоит отметить, что, в отличие от Flash Player, приложение Adobe AIR обеспечивает полнофункциональную поддержку языка HTML и стилей CSS, аналогичную той, которая присутствует в таких браузерах, как Internet Explorer и Mozilla Firefox. При работе с другими средами выполнения Flash обязательно обращайтесь к соответствующей документации за информацией о поддержке текста.
Основным элементом API для работы с текстом приложения Flash Player является класс TextField, который обеспечивает управление текстом, отображаемым на экране.
В этой книге (и во многих источниках по языку ActionScript) термин «текстовое поле» в общем смысле обозначает некоторое текстовое поле на экране и его соответствующий экземпляр класса TextField языка ActionScript. Тем не менее фраза «объект TextField», в частности, обозначает объект языка ActionScript, который управляет текстовым полем.
Прежде чем приступить к созданию текста и работе с ним, бегло ознакомимся с основными классами API для работы с текстом приложения Flash Player, перечисленными в табл. 27.1. Набор возможностей API для работы с текстом можно разбить на следующие общие категории:
' управление текстом, отображаемым на экране;
форматирование текста;
установка параметров отображения текста для модуля FlashType;
управление шрифтами (например, определение доступных шрифтов);
получение метрик текста (характеристик);
предоставление константных значений.
В табл. 27.1 приводится краткое описание каждого класса API для работы с текстом. Они разбиты на категории в соответствии с предыдущим списком общих категорий. Все классы API для работы с текстом находятся в пакете flash. text. Стоит отметить, что эта глава является хорошим введением в API для работы с текстом языка
ActionScript, но она не дает исчерпывающего описания всех возможностей данного интерфейса. Интерфейс API для работы с текстом просто огромен. Для дальнейшего изучения познакомьтесь с описанием пакета flash. text в справочнике по языку ActionScript корпорации Adobe. Кроме того, чтобы узнать о дополнительных и более специализированных возможностях управления текстом, рассмотрите применение компонентов Label, Text, TextArea и Text Input, предоставляемых платформой разработки Flex, или компонентов Label, TextArea и Text Input, входящих в состав среды разработки Flash.
Таблица 27.1. Обзор API для работы с текстом
Назначение
Класс
Описание
Управление текстом, отображаемым на экране
TextField
Представляет следующие типы текстовых полей.
Текстовые поля, создаваемые из кода на языке ActionScript.
Текстовые поля типа «динамический текст» или «вводимый текст», создаваемые в среде разработки Flash
StaticText
Представляет текстовые поля типа static, создаваемые в среде разработки Flash
TextSnapshot
Строка, содержащая текст из всех статических текстовых полей некоторого экземпляра класса DisplayObjectContainer
Форматирование текста
Text Format
Простой класс данных, представляющий информацию о форматировании символов
StyleSheet
Представляет таблицу стилей, содержащую информацию о форматировании символов. Данный класс реализован на основании спецификации Cascading style sheet Level 1 (CSS1) консорциума W3C
Установка параметров отображения текста для модуля FlashType
CSMSettings
Простой класс данных, используемый для предоставления модулю отображения текста FlashType приложения Flash Player заданных параметров сглаживания для отображения определенного шрифта определенного размера. Применяется вместе со статическим методом set AdvancedAntiAliasingTable() класса TextRenderer
TextRenderer
Управляет настройками отображения для модуля FlashType приложения Flash Player
Управление шрифтами
Font
Предоставляет доступ к списку шрифтов, установленных в системе или внедренных в SWF- файлы, и регистрирует шрифты, загружаемые на этапе выполнения
Получение характеристик текста
TextLineMetrics
Описывает характеристики для одной строки текста в поле
Предоставление константных значений
AntiAliasType, Fontstyle, FontType, GridFitType, TextColorType, TextDisplayMode, TextFieldAutoSize, TextFieldType, TextFormatAlign
Определяют константы, применяемые для указания различных значений переменных и параметров в API для работы с текстом. Дополнительные сведения можно получить в табл. 27.2
В табл. 27.2 представлен краткий обзор классов API для работы с текстом, которые просто обеспечивают доступ к специальным значениям через константы класса.
Таблица 27.2. Классы API для работы с текстом, содержащие константные значения
Назначение
Класс
Описание
Константы, используемые при выборе модуля отображения текста
AntiAliasType
Определяет константы, которые описывают типы сглаживания. Применяется вместе с переменной экземпляра antiAliasType класса TextField
Константы, применяемые при установке значений модуля отображения FlashType
Fontstyle
Определяет константы, которые описывают вариации шрифта (например, полужирный, курсив). Применяется вместе со статическим методом setAdvancedAntiAliasingTable() класса TextRenderer и переменной экземпляра fontstyle класса Font
GridFitType
Определяет константы, которые описывают типы подбора по сетке элементов растра. Используется с переменной экземпляра gridFitType класса TextField
TextColorType
Определяет константы, которые описывают типы цвета текста (темный или светлый). Применяется вместе со статическим методом setAdv ancedAntiAliasingTable() класса TextRenderer
TextDisplayMode
Определяет константы, которые описывают типы межпикселного сглаживания. Применяется вместе со статической переменной displayMode класса TextRenderer
Константы, используемые при установке параметров текстовых полей
TextFieldAutoSize
Определяет константы, которые описывают параметры автоматического изменения размеров. Применяется вместе с переменной экземпляра autoSize класса TextField
TextFieldType
Определяет константы, которые описывают типы текстовых полей (dynamic или input). Используется вместе с переменной экземпляра type класса TextField
Константы, используемые при получении списков шрифтов
FontType
Определяет константы, которые описывают типы местоположений шрифтов (системные или внедренные). Применяется вместе со статическим методом enumerateFonts() класса Font
Константы, используемые при установке выравнивания текста
TextFormatAlign
Определяет константы, которые описывают типы выравнивания текста (то есть по центру, по левому краю, по правому краю или по ширине). Применяется вместе с переменной экземпляра align класса TextFormat
Теперь, когда мы получили общее представление об инструментах, доступных в API для работы с текстом, создадим какой-нибудь текст!
Создание и отображение текста
Чтобы отобразить текст с помощью ActionScript, мы сначала создаем объект TextField. Этот объект представляет прямоугольный текстовый контейнер, который может отображаться на экране и заполняться форматированным текстом
через код или пользовательский ввод. Например, следующий код создает объект TextField и присваивает его переменной t:
var t:TextF1eld = new TextF1eld( );
После создания объекта TextField мы используем переменную экземпляра text класса TextField, чтобы указать текст для отображения на экране. Например, после выполнения следующего кода объект t будет выводить текст Hello world: t.text = "Hello world":
Наконец, для того, чтобы показать текстовое поле на экране, мы передаем объект TextField в метод addChild ( ) или addChildAt ( ) любого объекта DisplayOb j ectContainer, который на настоящий момент находится в списке отображения. Например, если предположить, что объект некийКонтейнер находится в списке отображения, следующий код приведет к отображению текстового поля t на экране:
некийКонтейнер.a ddCh11d(t):
В листинге 27.1 предыдущий код представлен в контексте демонстрационного класса Не 11 eWorld. Обратите внимание, что в этом коде мы импортируем класс TextField (вместе с остальными классами в пакете flash, text) перед его использованием.
Листинг 27.1. Отображение текста
package {
Import flash.display.*:
Import flash.text.*: // Импортируем класс TextField и другие классы, // размещенные в пакете fl ash.text
public class HeiloWorld extends Sprite {
public function Hell eWorld ( ) {
// Создаем объект TextField
var t:TextF1eld = new TextF1eld( );
// Указываем текст для отображения t.text = "Hello world":
// Добавляем объект TextField в список отображения addChlld(t):
}
}
}
Результат выполнения кода из листинга 27.1 проиллюстрирован на рис. 27.1. Текст показан в том виде, в котором он по умолчанию отображается в операционной системе Windows ХР (шрифты и форматирование будут рассмотрены далее в этой главе).
Hello world
Рис. 27.1. Текстовое поле
Хотя на предыдущем рисунке показан текст в текстовом поле, на нем не видна прямоугольная область отображения поля. По умолчанию она имеет размеры 100 пик-
селов по ширине и высоте. Рисунок 27.2 представляет измененную версию рис. 27.1, в которой изображена штриховая линия, представляющая прямоугольную область отображения текстового поля.
^ello world 1
Рис. 27.2. Текстовое поле и его прямоугольная область отображения
Ширина и высота прямоугольной области отображения текстового поля могут быть указаны явно с помощью переменных экземпляра width и height класса Text Field. Например, следующий код устанавливает для прямоугольной области отображения объекта t ширину, равную 200 пикселам, и высоту, равную 50 пикселам: t.width = 200; t.height = 50:
Рисунок 27.3 демонстрирует результат предыдущих изменений, снова используя штриховую линию, которая представляет прямоугольную область отображения текстового поля.
^Hello world।
Рис. 27.3. Заданный размер для прямоугольной области отображения текстового поля
По умолчанию прямоугольная область отображения поля не показывается на экране. Тем не менее мы можем сделать ее видимой, присвоив одной или обеим переменным экземпляра background и border класса Text Fie Id значение true. Переменная background определяет, требуется ли заливка прямоугольной области отображения текстового поля сплошным цветом, а переменная border указывает, нужно ли показывать линию толщиной 1 пиксел вокруг прямоугольной области отображения текстового поля. Цвет фона и границы задаются путем присваивания 24-битных значений RGB-цвета переменным backgroundcolor и bordercolor.
В листинге 27.2 представлен наш обновленный класс Не 11 eWorld, который делает видимой прямоугольную область отображения объекта t с помощью границы темно-серого цвета и фона светло-серого цвета. Новый код выделен полужирным шрифтом.
Листинг 27.2. Отображение текста с границей и фоном
package {
Import flash.display.*:
Import flash.text.*: // Импортируем класс TextFleld и другие классы, // размещенные в пакете fl ash.text
public class Hell eWorld extends Sprite {
public function Hell eWorld ( ) {
var t:TextField = new TextField( ;
): // Создаем объект TextFleld
t.text = "Hello world";
// Указываем текст // для отображения
t.background = true;//
Включаем отображение фона
t.backgroundcolor = OxCCCCCC; //
В качестве цвета фона указываем
//
светло-серый цвет
t. border = true;//
Включаем отображение границы
t.borderColor = 0x333333;//
В качестве цвета границы указываем
//
темно-серый цвет
addChlld(t); // Добавляем объект TextFleld в список отображения }
}
}
Результат выполнения кода из листинга 27.2 показан на рис. 27.4.
Hello world
Рис. 27.4. Текстовое поле с границей и фоном
Перенос слов
По умолчанию, когда ширина текста в текстовом поле оказывается больше ширины прямоугольной области отображения этого текстового поля, текст, выходящий за пределы данной области, теряется из виду. Например, следующий код в качестве текста объекта t присваивает строку, ширина которой превышает 100 пикселов при использовании шрифта по умолчанию в операционной системе Windows ХР:
t.text = "Hello world, how are you?":
Результат продемонстрирован на рис. 27.5.
Hello world, how ar
Рис. 27.5. Текст, выходящий за границы, не отображается на экране
Чтобы предотвратить скрытие текста, ширина которого оказывается больше ширины прямоугольной области отображения текстового поля, мы можем включить возможность автоматического добавления разрывов строк в текстовом поле, присвоив переменной экземпляра wordwrap класса TextFie Id значение true. Когда
возможность автоматического добавления разрывов строк включена, происходит мягкий перенос длинных строк текста, то есть любая строка, ширина которой оказывается больше ширины прямоугольной области отображения данного текстового поля, будет автоматически перенесена на следующую строку. Например, следующий код включает возможность автоматического добавления разрывов строк для объекта TextField t:
t.wordwrap = true;
Результат продемонстрирован на рис. 27.6.
Hello world, how are you?
Рис. 27.6. Автоматическое добавление разрывов строк
Перенос слов является всего лишь свойством отображения. В тех местах, где переносится исходный текст, никакие символы возврата каретки или новой строки не добавляются. Если переменной wordwrap присвоено значение true, изменение значения переменной width текстового поля приведет к тому, что мягкий перенос будет происходить в другом месте (то есть изменится размещение текста). Жесткие переносы могут быть добавлены в текстовое поле с помощью служебной последовательности " \ п" или тега <BR> в тексте HTML (использование разметки HTML в текстовых полях мы рассмотрим далее, в разд. «HTML-форматирование текста»).
Не путайте переменную wordwrap с переменной multiline (рассматривается далее, в разд. «HTML-форматирование текста» и «Ввод через текстовые поля»). Переменная multiline влияет на возможность разметки HTML и пользовательского ввода вызывать разрывы строк, а переменная wordwrap определяет, должна ли среда выполнения Flash осуществлять автоматический перенос строк.
Автоматическое изменение размеров
Чтобы прямоугольная область отображения текстового поля автоматически изменяла свои размеры в соответствии с размером текста в текстовом поле, мы используем переменную экземпляра autoSize класса TextField. Если переменной autoSize присвоить любое значение, отличное от значения TextFieldAutoSize.NONE (установлено по умолчанию), размер текстового поля всегда будет достаточным для отображения текста, присваиваемого этому полю.
Переменная autoSize перекрывает любые абсолютные размеры, задаваемые через переменные height и width объекта TextField.
Переменная autoSize может принимать одно из следующих четырех возможных значений: TextFieldAutoSize .NONE, TextFieldAutoSize . LEFT, TextFieldAutoSize . RIGHT и TextFieldAutoSize . CENTER. Они определяют направление, в котором текстовое поле должно расширяться или сужаться, чтобы соответствовать размерам присвоенного ему текста.
Если переменной autoSize присвоено значение NONE, то размеры текстового поля остаются фиксированными. Если переменной присвоено значение LEFT, то левая граница текстового поля фиксируется, а правая — перемещается. Если переменной присвоено значение RIGHT, то правая граница текстового поля фиксируется, а левая — перемещается. Если же переменной присвоено значение CENTER, то происходит равномерное перемещение левой и правой границ текстового поля. В последних трех случаях, когда происходит перенос строк или встречаются твердые разрывы строк, нижняя граница текстового поля также перемещается для размещения нескольких строк текста.
В листинге 27.3 создается текстовое поле, прямоугольная область отображения которого изменяет свои размеры справа и, когда встречается разрыв строки, снизу.
Листинг 27.3. Перемещаемые правая и нижняя границы
package {
Import flash.display.*:
Import flash.text.*:
public class HeiloWorld extends Sprite {
public function Hell eWorld ( ) {
var t:TextF1eld = new TextF1eld( ):
t.text = "Hello world, how are you?":
t.background = true;
t.backgroundcolor = OxCCCCCC;
t.border = true:
t.borderColor = 0x333333:
// Прямоугольная область отображения объекта t
// будет автоматически изменять свои размеры, // чтобы вместить значение переменной t.text. t.autoSize = TextFieldAutoSize.LEFT;
addChlld(t):
}
}
}
Результат выполнения кода из листинга 27.3 показан на рис. 27.7. Сравните его с рис. 27.5, на котором было изображено текстовое поле, не использующее ни возможность автоматического изменения размеров, ни возможность переноса слов.
[Hello world, how are you?
Рис. 27.7. Перемещаемые правая и нижняя границы
Теперь предположим, что мы добавили разрыв строки в текст объекта t, как показано в следующем коде (разрыв строки вставляется с помощью последовательности символов "\п"):
t.text = "Hello world." + "\n" + "How are you?":
На рис. 27.8 показано результирующее текстовое поле. Обратите внимание, что среда выполнения Flash автоматически изменяет размеры прямоугольной области отображения поля, чтобы полностью вместить текст, путем перемещения ее левой и нижней границ.
Hello world.
How are you?
Рис. 27.8. Перемещаемые правая и нижняя границы, с разрывом строки
Если переменной wordwrap присвоить значение true, а переменной autoSize — любое значение, отличное от значения TextFieldAutoSize .NONE, нижняя граница текстового поля будет автоматически перемещаться вниз или вверх, но при этом его левая, правая и верхняя границы будут оставаться в исходном положении. Этот код продемонстрирован в листинге 27.4 — в нем создается текстовое поле с перемещаемой нижней границей.
Листинг 27.4. Перемещаемая нижняя граница
package {
import flash.display.*:
Import fl ash.text.*:
public class Hell eWorld extends Sprite {
public function Hell eWorld ( ) {
var t:TextF1eld = new TextF1eld( );
t.text = "Hello world, how are you?":
t.background = true:
t.backgroundcolor = OxCCCCCC:
t.border = true:
t.borderColor = 0x333333:
// Вместе две следующие строки кода делают нижнюю границу объекта t // автоматически перемещаемой для размещения значения переменной // t.text.
t. autoSize = TextFieldAutoSize.LEFT:
t.wordwrap = true:
addChlld(t):
}
}
}
Результат выполнения кода из листинга 27.4 показан на рис. 27.9. Обратите внимание, что ширина прямоугольного отображаемого контейнера зафиксирована и составляет 100 пикселов (по умолчанию), а для размещения текста с переносами перемещается нижняя граница.
Hello world, how are you?
Рис. 27.9. Перемещаемая нижняя граница
Чтобы создать текстовое поле с перемещаемой нижней границей и фиксированной шириной, присвойте переменной autoSize любое значение, отличное от значения TextFieldAutoSize.NONE, а переменной wordwrap присвойте значение true.
Встраиваемые шрифты для отображения повернутого, искаженного и прозрачного текста
По умолчанию приложение Flash Player не отображает повернутые или искаженные текстовые поля на экране. Например, если мы хотим добавить следующее текстовое поле в список отображения, текст «Hello world» не появится на экране, поскольку поле повернуто:
var t:TextF1eld = new TextF1eld( );
t.text = "Hello world";
t.rotation = 30; // Поворачиваем текст
Подобным образом, если мы захотим добавить следующее текстовое поле в список отображения, текст «Hello world» не появится на экране, поскольку поле искажено:
var t:TextF1eld = new TextF1eld( );
t.text = "Hello world";
t.transform.matrix = new Matrlxd, 1, 0, 1): // Искажаем текст
Кроме того, по умолчанию Flash Player для отображения всех текстовых полей использует полную непрозрачность, даже если для них устанавливается уровень прозрачности через переменную экземпляра alpha класса TextField. Например, если бы мы хотели добавить следующее текстовое поле в список отображения, на экране текст «Hello world» оказался бы полностью непрозрачным, хотя уровню канала Alpha данного поля установлено значение 20 %:
var t:TextF1eld = new TextF1eld( ): t.text = "Hello world";
t.alpha = .2;
Приложение Flash Player правильно отображает только те повернутые, искаженные и прозрачные текстовые поля, которые используют встраиваемые шрифты. Информацию о визуализации текста с использованием встраиваемых шрифтов можно найти далее, в разд. «Шрифты и отображение текста».
Изменение содержимого текстового поля
После того как текстовому полю будет присвоено текстовое содержимое, это содержимое можно изменить через переменную text. Например, следующий код создает объект TextField и присваивает его текстовому содержимому строку ’’Hello”:
var t:TextF1eld = new TextF1eld( ); t.text = "Hello";
Следующий код полностью заменяет текст объекта t строкой "Goodbye":
t.text = "Goodbye";
Чтобы добавить новый текст к существующему содержимому текстового поля (вместо того чтобы полностью заменять текст в текстовом поле), мы используем либо метод экземпляра appendText ( ) класса TextField, либо оператор +=. Например, следующий код добавляет строку "...hope to see you again ! ” к тексту "Goodbye":
t.appendText("...hope to see you again’");
После выполнения предыдущей строки кода переменная t. text будет иметь такое значение:
"Goodbye...hope to see you again!"
Для добавленного текста используется форматирование последнего символа в текстовом поле, а любой существующий текст сохраняет свое первоначальное форматирование. Если в момент вызова функции appendText ( ) текстовое поле не содержит никакого текста, добавляемый текст будет отформатирован в соответствии с текстовым форматом, используемым по умолчанию для данного текстового поля.
Информацию по форматированию текста и текстовому формату, используемому по умолчанию, можно найти в следующем разд. «Форматирование текстовых полей».
Следующий код, как и предыдущий, добавляет новый текст в конец существующего текста в текстовом поле, но делает это не с помощью метода appendText ( ), а с помощью оператора +=:
t.text += " Come again soon.";
В отличие от метода appendText ( ), оператор += сбрасывает форматирование для всего текста в поле, устанавливая формат, используемый по умолчанию. Кроме того, оператор гораздо медленнее метода, поэтому следует избегать его использования.
Чтобы заменить некоторую последовательность символов в текстовом поле новой последовательностью, мы используем метод экземпляра replaceText( ) класса TextField, который имеет следующий обобщенный вид:
o6beKiTextField. герДасеТехЦиндексНачала, индексКонца, новыйТекст)
Метод replaceText ( ) удаляет символы в объекте odbeKiTextField, начиная с индекса индексНачала и заканчивая индексом индексКонца-I, и заменяет их текстом новый - Текст. Новое объединенное значение сохраняется в переменной odbeKiTextFleld. text. Например, следующий код заменяет символы "bed" в тексте "abede” новым текстом "х”:
var t:TextF1eld = new TextF1eld( );
t.text = "abede";
t.replaceTextQ, 4, "x");
trace(t.text); // Выводит: axe
Если значения индексНачала и индексКонца равны, то строка новыйТекст вставляется непосредственно перед указанным индексом индексНачала. Например, следующий код вставляет символ ”s” непосредственно перед символом ”t": var t:TextField = new TextF1eld( );
t.text = "mat";
t.replaceText(2, 2, "s");
trace(t.text); // Выводит: mast
В оставшейся части этого раздела рассматриваются вопросы форматирования, относящие- # ся к методу replaceText(), и для чтения последующего материала необходимо понимание £ методик форматирования текста, рассматриваемых в следующем разделе.
Форматирование текста, вставляемого через метод replaceText ( ), зависит от указываемых значений для параметров индексНачала и индексКонца. Если значения отличаются, то вставляемый текст использует форматирование символа, следующего за вставляемым текстом (то есть символа в позиции индексКонца). Любой существующий текст сохраняет свое первоначальное форматирование. Например, рассмотрим следующий код, который создает текстовое поле, отображающее слово ’’lunchtime*”, при этом символы ’’time” отформатированы с использованием полужирного шрифта:
var boldFormat:TextFormat = new TextFormatC ); boldFormat.bold = true;
var t:TextF1eld = new TextF1eld( );
t.text = "lunchtime";
t.setTextFormat(boldFormat. 5, 9); // Выделяем слово "time"
// полужирным шрифтом
Результатом выполнения этого кода является строка: lunchtime
Теперь мы воспользуемся методом replaceText ( ), чтобы заменить слово ’’lunch” словом ’’dinner”, как показано ниже:
t.replaceTextCO. 5. "dinner"); ' // Заменяем слово "lunch" словом "dinner"
В итоге слово ’’dinner” будет отформатировано с использованием полужирного шрифта, что соответствует форматированию символа в позиции индексКонца ( ” t ”). Результат выглядит следующим образом:
dinnertime
Чтобы вместо существующего формата текстового поля использовать новый формат для вставляемого текста, мы присваиваем новый текст с помощью метода replaceText ( ), а затем сразу же присваиваем желаемый формат этому тексту. Например, следующий код снова заменяет слово ’’lunch” словом ’’dinner”, но на этот раз к новому добавленному тексту также применяется форматирование: t.replaceText(0, 5, "dinner"); // Заменяем слово "lunch" словом "dinner" var regularFormat;TextFormat = new TextFormat( );
regularFormat.bold = false;
t.setTextFormat(regularFormat, 0, 6); // Отменяем форматирование полужирным
// шрифтом слова dinner
Результат выполнения предыдущего кода выглядит следующим образом: dinnertime
Когда оба аргумента индексНачала и индексКонца метода replaceText ( ) равны О, текст вставляется в начало текстового поля, а для форматирования вставляемого текста применяется используемый по умолчанию формат данного поля. Первоначальное форматирование любого существующего текста сохраняется.
Когда аргументы индексНачала и индексКонца равны, и при этом их значения больше 0, для форматирования вставляемого текста используется формат символа, непосредственно предшествующего вставляемому тексту (то есть символа в позиции индексКонца-I). Первоначальное форматирование любого существующего текста сохраняется. Например, следующий код снова создает текстовое поле, которое отображает слово "lunchtime", применяя полужирный шрифт для слова "time”:
var boldFormat:TextFormat = new TextFormat( ): boldFormat.bold = true:
var t:TextF1eld = new TextField( ): t.text = "lunchtime":
t.setTextFormat(boldFormat, 5. 9): // Выделяем слово "time"
// полужирным шрифтом
На этот раз мы вставляем текст "break” сразу после символа ”t”:
t.replaceText(5, 5, "break"); // Вставляем слово "break" после символа "t"
Поскольку символ в позиции индексКонца-I (”h”) не отформатирован с использованием полужирного шрифта, для слова "break” полужирный шрифт применяться не будет, а результат выполнения предыдущего кода будет выглядеть следующим образом:
lunchbreaktime
Теперь ближе познакомимся с методиками форматирования текста.
Форматирование текстовых полей
Язык ActionScript предоставляет три различных инструмента для форматирования текста: класс flash. text. TextFormat, разметку HTML и класс flash. text. StyleSheet. Все три инструмента позволяют управлять следующими вариантами форматирования абзацев и символов, но используют различный синтаксис.
Форматирование на уровне абзацев — выравнивание, отступы, маркеры, высота строки (интервал между строками), шаг табуляции.
Форматирование на уровне символов — гарнитура, размер, вес шрифта (полужирный или обычный), цвет, стиль шрифта (курсив или обычный), кернинг, расстояние между буквами (трекинг), подчеркивание текста, гипертекстовые ссылки.
Форматирование на уровне абзацев применяется ко всему абзацу, при этом абзац определяется как часть текста, ограниченная разрывами строки (\n, <BR> или <Р>). В отличие от этого, форматирование на уровне символов применяется
к произвольным последовательностям отдельных символов, ограниченным индексами в тексте или тегами HTML или XML.
Класс TextFormat предоставляет точное программное управление над форматированием текста и обычно используется для динамической генерации текстового вывода. Класс StyleSheet помогает отделить инструкции форматирования от содержимого, к которому применяется данное форматирование, и обычно применяется при форматировании больших блоков содержимого HTML или XML. Инструкции форматирования языка HTML предлагают простой, интуитивно понятный способ форматирования текста, но загрязняют текстовое содержимое разметкой. Разметка HTML обычно используется в тех случаях, когда удобство важнее гибкости, как, возможно, при форматировании текста в прототипе приложения или форматировании небольших фрагментов текста, которые гарантированно не будут изменяться в течение проекта.
Класс TextFormat является полностью совместимым и взаимозаменяемым с инструкциями форматирования языка HTML. Однако класс StyleSheet не совместим ни с классом TextFormat, ни с инструкциями форматирования языка HTML. Текстовые поля, использующие таблицы стилей, могут быть отформатированы только с помощью экземпляров класса StyleSheet.
В следующих разделах рассматриваются вопросы общего использования объектов TextFormat и StyleSheet, а также разметки HTML. Каждый раздел содержит примеры распространенных операций форматирования. Подробное описание каждого отдельного параметра форматирования можно найти в следующих разделах справочника по языку ActionScript корпорации Adobe:
класс TextFormat;
переменная экземпляра htmlText класса TextField;
класс StyleSheet.
Присваивание значения переменной text объекта TextField приводит к удалению любого пользовательского форматирования, связанного с этим полем. Чтобы добавить текст в поле, сохранив его текущее форматирование, используйте метод экземпляра replaceText() класса TextField.
Форматирование текста с помощью класса TextFormat
Общий процесс форматирования текста с использованием класса TextFormat заключается в следующем.
Создать объект TextFormat.
Установить переменные объекта TextFormat, отражающие желаемое форматирование.
Применить форматирование к одному символу или более, используя метод экземпляра setTextFormat ( ) класса TextField.
Применим перечисленные шаги на примере. Наша цель — отформатировать весь текст в поле, используя шрифт Arial размером 20 пунктов с полужирным начертанием.
В языке Actionscript все размеры шрифтов указываются в пикселах. Если шрифт имеет размер 20 пунктов, это интерпретируется приложением Flash Player как 20 пикселов.
Мы начнем работу над нашим кодом форматирования с создания текстового поля, размеры которого будут изменяться автоматически, чтобы соответствовать размерам форматируемого текста:
var t:TextField = new TextF1eld( ); t.text = "ActlonScrlpt 1s fun!": t.autoSize = TextF1eldAutoS1ze.LEFT:
Далее создадим объект TextFormat:
var format:TextFormat = new TextFormat( );
Затем присвоим переменным font, size и bold созданного объекта TextFormat желаемые значения: "Arial", 20 и true, как показано в следующем коде:
format.font = "Arial":
format.size = 20: format.bold = true:
Вместе переменные объекта TextFormat описывают стиль форматирования, который может быть применен к некоторому символу или последовательности символов. Доступные переменные перечислены в следующем подразд. «Доступные переменные класса TextFormat».
После создания объекта TextFormat и присваивания значений его переменным мы можем применять его для форматирования некоторого символа или последовательности символов с помощью метода setTextFormat ( ), который имеет следующий вид:
oObeKiTextField. setTextFormat (ofoeKrTextFor^, индексНачала, индексКонца)
В приведенном обобщенном коде oObeKiTextField — это текстовое поле, текст которого будет отформатирован, a oObeKiTextFormat — объект TextFormat, содержащий инструкции форматирования. Параметр индексНачала — это необязательное целое число, обозначающее индекс первого символа, который будет отформатирован с помощью объекта oObeKTTextFormat. Параметр индексКонца — это необязательное целое число, обозначающее индекс символа, следующего за последним символом, который будет отформатирован с помощью объекта обь- eKTTextFormat.
Когда указаны оба аргумента индексНачала и индексКонца, метод setTextFormat ( ) форматирует последовательность символов, начиная с индекса индексНачала и заканчивая индексом индексКонца-I, в соответствии со значениями переменных объекта oObeKTTextFormat. Когда аргумент индексНачала указан, а аргумент индексКонца — нет, метод setTextFormat ( ) форматирует один символ с индексом индексНачала в соответствии со значениями переменных объекта oObeKiTextFormat. Когда не указан ни аргумент индексНачала, ни аргумент индексКонца, метод setTextFormat ( ) форматирует все символы в объекте o6beKTTextFieldв соответствии со значениями переменных объекта oObeKTTextFormat. Любая переменная объекта odbeKiTextFormat, которой присвоено значение null, не влияет на форматирование целевой последовательности
символов (существующее форматирование, определяемое данной переменной, сохраняется).
Попробуем использовать метод setTextFormat ( ), чтобы отформатировать символы в нашем тестовом текстовом поле t. Вот этот код:
t.setTextFormat(format);
Для обзора в листинге 27.5 приведен весь код, необходимый для форматирования всех символов в текстовом поле с использованием шрифта Arial размером 20 пунктов полужирного начертания.
Листинг 27.5. Форматирование текстового поля
// Создаем текстовое поле
var t:TextF1eld = new TextF1eld( ):
t.text = "ActlonScript 1s fun!": t.autoSize = TextF1eldAutoS1ze.LEFT;
// Создаем объект TextFormat и устанавливаем значения его переменных var format:TextFormat = new TextFormatt ): format.font = "Arial": format.size = 20: format.bold = true:
// Применяем форматирование t.setTextFormattformat);
Результат выполнения кода из листинга 27.5 проиллюстрирован на рис. 27.10.
ActionScript is fun!
Рис. 27.10. Текст, отформатированный с помощью объекта TextFormat
Теперь предположим, что мы хотим отформатировать весь текст в поле с помощью шрифта Arial размером 20 пунктов, но при этом хотим, чтобы полужирным шрифтом было выделено только слово fun. Нам потребуется два объекта TextFormat: один для общих настроек шрифта и один для шрифта полужирного начертания. Этот код показан в листинге 27.6 (обратите внимание на использование аргументов индексНачала и индексКонца во втором вызове метода setTextFormat ( )):
Листинг 27.6. Два формата
// Создаем текстовое поле
var t:TextF1eld = new TextF1eld( ):
t.text = "ActlonScript 1s fun!":
t.autoSize = TextF1eldAutoS1ze.LEFT:
// Создаем объект TextFormat для общих настроек шрифта var fontFormat:TextFormat = new TextFormatt ): fontFormat.font = "Arial": fontFormat.size = 20;
// Создаем объект TextFormat для настроек шрифта полужирного начертания var boldFormat:TextFormat = new TextFormatt ):
boldFormat.bold = true;
// Применяем общие настройки шрифта ко всему текстовому полю t.setTextFormat(fontFormat);
// Применяем настройки шрифта полужирного начертания только к слову fun t.setTextFormat(bol dFormat. 16, 19):
Стоит отметить, что последовательное форматирование не является деструктивным; изменения в форматировании касаются только установленных переменных, поэтому во втором вызове метода setTextFormat ( ) слово fun сохраняет свою гарнитуру шрифта (Arial) и размер (20) и приобретает полужирное начертание.
Теперь, когда известно, как применять форматирование, бегло рассмотрим полный список параметров форматирования, доступных через класс TextFormat.
Доступные переменные класса TextFormat
В табл. 27.3 и 27.4 перечислены переменные класса TextFormat, применяемые для форматирования на уровне символов и абзацев. Подробные сведения о каждой переменной можно найти в описании класса TextFormat в справочнике по языку ActionScript корпорации Adobe.
В табл. 27.3 перечислены переменные класса TextFormat, используемые для установки параметров форматирования на уровне символов.
Таблица 27.3. Переменные класса TextFormat для форматирования на уровне символов
Переменная
Описание
bold
Тип Boolean. Задает отображение символа с использованием полужирного начертания
color
Указывает цвет символа в виде 24-битного целого числа (например, OxFFOOOO)
font
Задает шрифт
italic
Тип Boolean. Определяет отображение символа с использованием курсива
kerning
Тип Boolean. Задает, нужно ли использовать автоматический кернинг для пар символов
letterspacing
Указывает расстояние между буквами (трекинг), в пикселах
size
Задает размер шрифта, в пунктах (1/72 дюйма)
target
Определяет окно или фрейм для гипертекстовой ссылки
underline
Тип Boolean. Задает отображение символа с использованием подчеркивания
url
Определяет гипертекстовую ссылку
В табл. 27.4 перечислены переменные класса TextFormat, используемые для установки параметров форматирования на уровне абзацев.
Таблица 27.4. Переменные класса TextFormat для форматирования на уровне абзацев
Переменная
Описание
align
Задает выравнивание абзаца по горизонтали (по левому или правому краю, по центру или по ширине) с помощью одной из констант класса TextFormatAlign
blockindent
Определяет расстояние в пикселах, представляющее смещение абзаца от левой границы текстового поля
Продолжение ^
Таблица 27.4 (продолжение)
Переменная
Описание
bullet
Указывает, нужно ли добавлять маркеры к абзацам
indent
Задает расстояние в пикселах, представляющее отступ первой строки абзаца от левой границы текстового поля
leading
Указывает величину вертикального промежутка в пикселах между строками текста
leftMargin
Определяет расстояние по горизонтали в пикселах между левой границей текстового поля и левым краем абзаца
rightMargin
Задает расстояние по горизонтали в пикселах между правой границей текстового поля и правым краем абзаца
tabStops
Задает шаги табуляции по горизонтали в пикселах
Из всех переменных, перечисленных в двух предыдущих таблицах, особого внимания заслуживает переменная экземпляра font класса TextFormat. Ее значение определяет название шрифта в виде строки. Как мы узнаем далее, в разд. «Шрифты и отображение текста», у разработчиков есть возможность заставить приложение Flash Player отображать текст с помощью шрифтов, установленных в локальной системе конечного пользователя (называемых шрифтами устройства), или шрифтов, включенных в SWF-файл (называемых встраиваемыми). Таким образом, переменная font должна определять либо название шрифта в локальной системе, либо название шрифта, встраиваемого в SWF-файл.
Специально для шрифтов устройств язык ActionScript также предлагает три особых названия — ”_sans”, "_serif" и "—typewriter", которые могут применяться в тех случаях, когда текст должен отображаться шрифтом без засечек, с засечками или моноширинным, используемым по умолчанию в локальной системе. Например, если при использовании шрифтов устройства в качестве названия шрифта указать значение "_sans ", в США на компьютере с установленной операционной системой Windows ХР текст будет отображен шрифтом Arial, а на компьютере с установленной операционной системой Mac OS X — шрифтом Helvetica.
Мы узнаем больше об особенностях выбора названий шрифтов далее в этой главе. В дальнейшем будем полагать, что текст отображается с помощью шрифтов, установленных в локальной системе конечного пользователя (шрифтов устройства), и будем использовать названия шрифтов, поставляемых с операционной системой Windows ХР.
Предупреждение насчет встраиваемых шрифтов
Стоит отметить, что, когда текст, для форматирования которого применяется полужирное начертание или курсив, отображается с помощью встраиваемых шрифтов, вариации соответствующего шрифта (-ов) полужирного начертания и курсива должны быть доступны для Flash Player в виде встраиваемых шрифтов. Например, рассмотрим следующий код, который создает текстовое поле, содержащее слова «hello» и «world», при этом слово «hello» отформатировано с использованием шрифта Courier New, а слово «world» — с использованием шрифта Courier New полужирного начертания:
// Создаем текстовое поле
var t:TextField = new TextField( );
t.text = "hello world";
// Создаем объекты TextFormat
var fontFormat-.TextFormat = new TextFormat( );
fontFormat.font = "Courier New";
var boldFormat:TextFormat = new TextFormat( ); boldFormat.bold = true;
// Применяем форматирование
t.setTextFormat(fontFormat, 0, 11);
t.setTextFormat(boldFormat, 6, 11);
Чтобы отобразить предыдущее текстовое поле с помощью встраиваемых шрифтов, приложение Flash Player должно иметь доступ к встраиваемым версиям шрифтов Courier New и Courier New Bold. Дополнительную информацию можно найти далее, в подразд. «Форматирование текста с помощью встраиваемого шрифта» разд. «Шрифты и отображение текста».
Вызов метода setTextFormaK) не оказывает влияния на текст, присваиваемый в дальнейшем
Метод s е t Т е х t F о г ma t ( ) может быть использован для форматирования текста в текстовом поле только после того, как этот текст будет добавлен в текстовое поле. Например, в следующем коде мы по ошибке вызываем метод setText Format ( ) до того, как будет присвоен текст, который мы хотим отформатировать;
// Создаем текстовое поле
var t;TextF1eld = new TextF1eld( );
t.autoSize = TextF1eldAutoS1ze.LEFT;
// Создаем объект TextFormat и устанавливаем значения его переменных var format;TextFormat = new TextFormat( );
format.font = "Arial";
format.size = 20; format.bold = true;
// Применяем форматирование t.setTextFormat(format);
// Присваиваем текст
t.text = "Act1onScr1pt 1s fun!";
Когда в предыдущем коде происходит вызов метода setTextFormat ( ), объект t еще не содержит никакого текста, поэтому попытка применить форматирование оказывается безрезультатной. Вот правильный код;
// Создаем текстовое поле
var t;TextF1eld = new TextF1eld( );
t.autoSize = TextF1eldAutoS1ze.LEFT;
// Создаем объект TextFormat и устанавливаем
// значения его переменных
var format.-TextFormat = new TextFormat( );
format.font = "Arial";
format.size = 20;
format.bold = true;
// Присваиваем текст t.text = "Act1onScr1pt 1s fun!";
// Применяем форматирование t.setTextFormat(format);
Выполняя форматирование текста с помощью метода setTextFormat(), всегда присваивайте текст перед вызовом этого метода.
Информацию о применении форматирования к текстовому полю до того, как будет присвоен текст, можно найти далее, в подразд. «Форматирование по умолчанию для текстовых полей».
Применение форматирования на уровне абзацев
Чтобы применить любой из вариантов форматирования на уровне абзацев, перечисленных ранее в табл. 27.4, мы должны применить желаемый формат к первому символу в абзаце (напомним, что в языке ActionScript абзац определяется как часть текста, ограниченная разрывами строки).
Например, рассмотрим следующий код, который сначала создает текстовое поле с двумя абзацами, а затем — объект TextFormat, задающий вариант форматирования на уровне абзацев — выравнивание по центру;
// Создаем текстовое поле
var t;TextF1eld = new TextF1eld( );
t.width = 300;
t.border = true;
// Абзацы разделяются одним разрывом строки (представляемым служебной
// последовательностью "\п")
t.text = "This 1s paragraph one.\nTh1s 1s paragraph two.";
// Создаем объект TextFormat
var al1gnFormat;TextFormat = new TextFormat( );
allgnFormat.align = TextFormatAUgn.CENTER;
Чтобы установить выравнивание только для первого абзаца в текстовом поле, мы применяем форматирование к первому символу первого абзаца, который находится в позиции с индексом 0:
t.setTextFormat(al1gnFormat. 0);
Для установки выравнивания только второму абзацу мы применяем форматирование к первому символу второго абзаца, который находится в позиции с индексом 23:
t.setTextFormat(al1gnFormat. 23);
Чтобы установить выравнивание сразу для нескольких абзацев, мы применяем форматирование с помощью аргументов индексНачала и индексКонца, диапазон значений которых включает позиции символов желаемых абзацев:
t.setTextFormat(al1gnFormat. 0, 24);
Если включена возможность переноса строк и какой-нибудь абзац переносится на следующую строку, указанный диапазон форматирования должен включать позицию первого символа следующей строки. В противном случае форматирование не будет применено к перенесенной строке. Таким образом, чтобы добиться наилучших результатов, применяя форматирование на уровне абзацев к абзацу в текстовом поле с включенной возможностью переноса, всегда применяйте форматирование ко всей последовательности символов в абзаце.
Для динамического определения начального и конечного индексов символов в абзаце используйте методы экземпляра getFirstCharInParagraph ( ) и getParagraphLength( ) класса TextField. Например, следующий код применяет метод getParagraphLength ( ), чтобы динамически определить начальные и конечные индексы двух абзацев в текстовом поле из предыдущего примера. После этого данный код использует полученные индексы для применения форматирования — выравнивания текста — ко всей последовательности символов во втором абзаце.
// Создаем текстовое поле
var t:TextF1eld = new TextF1eld( );
t.width = 100;
t.border = true;
t.wordwrap = true;
t.text = "This is paragraph oneAnThis is paragraph two.";
// Создаем объект TextFormat
var alignFormat;TextFormat = new TextFormat( ); alignFormat.align = TextFormatAlign.CENTER;
// Определяем начальные и конечные индексы абзацев
var TirstParagraphStartAnt = 0;
var firstParagraphEnd;int = t.getParagraphLength(firstParagraphStart)-l;
var secondParagraphStart;int = firstParagraphEnd+1;
var secondParagraphEnd;int = secondParagraphStart
+ t.getParagraphLength(secondParagraphStart)-!;
// Применяем форматирование t.setTextFormat(alignFormat. secondParagraphStart. secondParagraphEnd);
Получение информации о форматировании для последовательности символов
Чтобы получить информацию о существующем форматировании для одного или более символов, находящихся в текстовом поле, мы используем метод экземпляра getTextFormat ( ) класса TextField. Этот метод возвращает объект TextFormat, переменные которого описывают форматирование указанных символов. В общем виде метод getTextFormat ( ) записывается следующим образом:
odbeKiTextField .деНех^огтаИиндексНачал^ ^ндексКонца)
Если при вызове этого метода указывается один целочисленный аргумент или значение аргумента индексКонца равно значению выражения индексНачала+1, то возвращаемый объект TextFormat будет отражать форматирование для одного символа,
находящегося в позиции индексНачала. Например, в следующем коде мы применяем форматирование к первым четырем символам текстового поля, а затем проверяем название шрифта для первого символа:
// Создаем текстовое поле
var t:TextF1eld = new TextF1eld( ):
t.width = 100:
t.border = true:
t.wordwrap = true:
t.text = "What time 1s 1t?";
// Создаем объект TextFormat, переменной font которого присваивается
// значение "Arial"
var ar1alFormat:TextFormat = new TextFormat( );
ar1al Format.font = "Arial":
// Применяем форматирование к слову 'What', индексы символов -
// от 0 до 3 (включительно)
t.setTextFormat(ar1alFormat, 0. 4):
// Получаем объект TextFormat для первого символа var f1rstCharFormat:TextFormat = t.getTextFormat(O);
// Проверяем значение переменной font
trace(f1rstCharFormat.font): // Выводит: Arial
Если при вызове метода getTextFormat ( ) указываются два целочисленных аргумента, то возвращаемый объект TextFormat представляет форматирование для последовательности символов, начиная с позиции индексНачала и заканчивая позицией индексКонца-L Если же метод getTextFormat ( ) вызывается без аргументов, то возвращаемый объект TextFormat представляет форматирование для всех символов в этом поле.
Если определенный параметр форматирования (например, шрифт, полужирное начертание или курсив) не является одинаковым для всех символов в указанной последовательности, то значение соответствующей переменной объекта TextFormat для этой последовательности будет равно null. Возвращаясь к нашему примеру, если получить объект TextFormat для всего текста объекта t, то мы обнаружим, что переменные, которые обозначают варианты форматирования, используемые всеми символами, содержат ненулевые значения:
// Получаем объект TextFormat для всех символов в объекте t var alICharsFormat:TextFormat = t.getTextFormat( );
// Теперь проверим, имеют ли все символы полужирное начертание trace(allCharsFormat.bold): // Выводит: false
Однако переменные, обозначающие варианты форматирования, которые отличаются от символа к символу, содержат значение null:
// Проверяем шрифт для всех символов
trace(alICharsFormat.font): // Выводит: null (шрифт не единообразен)
Шрифт первых четырех символов в объекте t отличается от шрифта остальных символов, стало быть, не существует такого значения переменной font, которое
могло бы точно описать всю последовательность целиком. В связи с этим переменной font присваивается значение null.
Отметим, что любые изменения в объекте TextFormat, возвращаемом методом get Text Format ( ), не оказывают никакого влияния на текст в объекте объ- exTTextField, кроме тех случаев, когда измененный объект TextFormat повторно применяется к тексту через вызов метода setTextFormat ( ). Например, само по себе следующее выражение присваивания значения переменной font не оказывает никакого влияния на объект t:
al 1CharsFormat.font = "Courier New";
Однако, если мы добавим вызов метода setTextFormat ( ), изменение будет применено:
// Применяет шрифт "Courier New" ко всему текстовому полю t.setTextFormat(allCharsFormat);
Форматирование no умолчанию для текстовых полей
Всякий раз, когда новый текст добавляется в текстовое поле (либо программным путем, либо через пользовательский ввод), среда выполнения Flash форматирует этот текст с использованием формата текста по умолчанию для данного поля. Формат текста по умолчанию для поля представляется внутренним объектом TextFormat, который определяет, как должен быть отформатирован новый текст, если форматирование не указано явно.
Тем не менее формат текста по умолчанию для текстового поля не является постоянным; он динамически изменяет свои настройки, чтобы соответствовать форматированию текста в точке вставки (также называемой позицией курсора?). Таким образом, когда пользователь вводит новый текст после некоторого символа в текстовом поле, формат нового текста будет обусловлен форматом данного символа.
Как мы уже знаем, когда для добавления нового текста в текстовое поле используется метод replaceText ( ), новый текст принимает форматирование либо символа, следующего за новым текстом (если существующий текст был удален), либо символа, предшествующего новому тексту (если существующий текст не был удален).
Вообще говоря, формат текста по умолчанию следует рассматривать не как инструмент разработчика для форматирования нового текста, добавляемого в текстовое поле, а как внутреннее средство среды Flash для определения форматирования нового текста, добавляемого в текстовое поле. Чтобы отформатировать новый текст с помощью некоторого формата, используйте метод setTextFormat ( ). Например, рассмотрим следующий код, создающий текстовое поле, весь текст которого отформатирован с использованием полужирного начертания:
var t:TextF1eld = new TextF1eld( ): t.width = 400;
t.text = "This 1s bold text.";
var boldFormat:TextFormat = new TextFormat( );
boldFormat.bold = true:
t.setTextFormat(bol dFormat);
В обычной ситуации любой новый текст, добавляемый в объект t, также будет автоматически отформатирован с использованием полужирного начертания:
t.appendTextC This 1s bold too."):
Чтобы добавить новый текст без полужирного начертания в объект t, мы должны применить нужное форматирование после добавления этого текста в поле, как показано в следующем коде:
// Добавляем текст
t.appendTextC This isn't bold."):
// Сразу же форматируем новый текст без использования полужирного
// начертания. Обратите внимание, что индексы первого и последнего символов
// нового текста определяются динамически с помощью метода String.indexOf( )
// и переменной TextField.length.
var regularFormat:TextFormat = new TextFormat( ); regularFormat.bold = false;
t.setTextFormat(regularFormat,
t.text.indexOf("This isn't bold."), t.length);
Подобный подход, применяемый для форматирования добавляемого пользователем текста, продемонстрирован далее, в разд. «Ввод через текстовые поля».
Хотя формат текста по умолчанию в основном является внутренним инструментом среды Flash, разработчики могут использовать его для решения одной важной задачи: устанавливать форматирование пустого текстового поля. Формат для пустого объекта TextField указывается путем присваивания объекта TextFormat переменной def aultTextFormat объекта TextField, как показано в следующем коде:
// Создаем текстовое поле
var t:TextF1eld = new TextField( ); t.width = 300;
// Создаем объект TextFormat
var defaultFormat:TextFormat = new TextFormat( );
defaultFormat.size = 20;
defaultFormat.color = OxFFOOOO; defaultFormat.font = "Verdana";
// Присваиваем объект TextFormat переменной defaultTextFormat объекта t t.defaultTextFormat = defaultFormat;
Как только переменной defaultTextFormat пустого объекта TextField будет присвоено значение, весь текст, добавляемый в данное поле (либо программным путем, либо через пользовательский ввод), будет отформатирован в соответствии с указанным значением переменной def aultTextFormat до тех пор, пока к символам в текстовом поле не будет применено новое пользовательское форматирование. Например, следующий код добавляет новый текст в объект t; текст автоматически форматируется с использованием шрифта Verdana размером 20 пунктов красного цвета (в соответствии со значением переменной t. defaultTextFormat):
t.text = "This is 20 pt red Verdana";
Когда к символам в текстовом поле будет применено пользовательское форматирование, новый текст, добавляемый в поле, будет отформатирован в соответствии с форматом текста в месте вставки.
Теперь, когда мы познакомились с основами форматирования текста с помощью класса TextFormat, перейдем к форматированию текста с помощью разметки HTML.
HTML-форматирование текста
Чтобы применить форматирование к текстовому полю с помощью разметки HTML, используется следующая базовая последовательность действий.
Создать объект TextField.
Создать строку текста, представляющую разметку HTML, с использованием ограниченного набора HTML-тегов форматирования, поддерживаемых языком ActionScript.
Присвоить текст, отформатированный с помощью разметки HTML, переменной htmlText объекта TextField. Любой текст, отформатированный с помощью разметки HTML и присвоенный переменной htmlText, выводится на экран в виде отформатированного текста.
Применим перечисленные шаги на примере. Наша цель — отформатировать весь текст в поле, используя шрифт Arial размером 20 пунктов с полужирным начертанием (как мы делали это ранее с помощью объекта TextFormat).
Начнем с создания текстового поля, которое будет автоматически изменять свои размеры, чтобы соответствовать нашему отформатированному тексту:
var t.TextField = new TextF1eld( );
t.autoSize = TextF1eldAutoS1ze.LEFT;
Затем мы создадим нашу отформатированную текстовую строку, используя теги
<В> и <FONT>:
var message:String = "<FONT FACE='Ar1aT SIZE='20'>"
+ "<B>Act1onScr1pt 1s fun!</B></FONT>";
Наконец, присваиваем строку, содержащую разметку HTML, переменной htmlText объекта t:
t.htmlText = message:
Результат показан на рис. 27.11.
ActionScript is fun!
Рис. 27.11. Текст, отформатированный с помощью разметки HTML
Зачастую текст, содержащий разметку HTML, присваивается непосредственно переменной htmlText, как показано в следующем коде:
t.htmlText = "<FONT ЕАСЕ='Аг1аГ SIZE='20'>"
+ "<B>Act1onScr1pt 1s fun!</B></FONT>";
С помощью HTML-разметки мы можем применять любые параметры форматирования, доступные в классе TextFormat. В табл. 27.5 перечислены поддерживаемые
языком ActionScript теги и атрибуты HTML, дополненные перекрестными ссылками на эквивалентные переменные класса TextFormat. Дополнительную информацию по поддержке HTML в языке ActionScript можно найти в разделе, посвященном описанию переменной экземпляра htmlText класса TextField, справочника по языку ActionScript корпорации Adobe.
В отличие от автономной версии приложения Flash Player и версии, реализованной в виде * модуля расширения браузера, приложение Adobe AIR включает полнофункциональные Л' синтаксический анализатор и подсистему визуализации разметки HTML, которые способны обрабатывать весь диапазон инструкций языка HTML, таблиц стилей CSS и языка JavaScript, обычно применяемых в браузерах.
Обратите внимание, что, когда таблицы стилей не используются, приложение Flash Player автоматически добавляет разметку HTML к строковому значению переменной htmlText, если HTML-код, присвоенный переменной htmlText, не полностью описывает форматирование текстового поля. Например, следующий код присваивает переменной htmlText текст, не содержащий теги <Р> или <FONT>: var t:TextF1eld = new TextF1eld( );
t.htmlText = "This field contains <B>HTML!</B>";
Прочитав значение переменной t. htmlText, мы обнаружим, что были добавлены теги <Р> и <FONT>:
traced.htmlText) ;
// Выводит:
<Р ALIGN="LEFT"><FONT FACE="T1mes New Roman" SIZE="12" COLOR="#000000" LETTERSPACING="O" KERNING="0">Th1s field contains <B>HTML'</B></FONT></P>
Теперь рассмотрим набор тегов и атрибутов языка HTML, поддерживаемых языком ActionScript, которые представлены в табл. 27.5.
Таблица 27.5. Теги языка HTML, поддерживаемые языком ActionScript
Тег
Описание
Атрибуты
Описание
Эквивалентная переменная экземпляра класса TextFormat
1
2
3
4
5
<А>
Определяет гипертекстовую ссылку
HREF
Задает цель гипертекстовой ссылки
url
TARGET
Определяет окно или фрейм гипертекстовой ссылки
target
<В>
Задает отображение символа с использованием полужирного начертания
Отсутствует
bold
<BR>
Вызывает разрыв строки в теле текста; функционально эквивалентен служебной последовательности \п
Отсутствует
Отсутствует
1
2
3
4
5
<FONT>
Определяет информацию о шрифте
FACE
Определяет название шрифта
font
SIZE
Задает размер шрифта, в пунктах
size
COLOR
Определяет цвет шрифта в виде 24-битного целого шестнадцатеричного числа, которому предшествует знак фунта (#). Например, красный цвет записывается как #FFOOOO
color
KERNING
Указывает, нужно ли использовать кернинг для пар символов (1 означает «использовать», 0 — «не использовать»)
kerning
LETTERSPACING
Определяет расстояние между буквами (то есть трекинг), в пикселах
letterspacing
<1>
Задает отображение символа с использованием курсива
Отсутствует
italic
<IMAGE>
Определяет отображаемый элемент, вставляемый в текстовое поле
SRC
Местоположение элемента (изображение, SWF-файл или символ клипа), вставляемого в текстовое поле
Отсутствует
WIDTH
Необязательная ширина вставляемого элемента
Отсутствует
HEIGHT
Необязательная высота вставляемого элемента
Отсутствует
ALIGN
Необязательное выравнивание вставляемого элемента по горизонтали
Отсутствует
HSPACE ’
Необязательное пространство по горизонтали, окружающее вставляемый элемент
Отсутствует
VSPACE
Необязательное пространство по вертикали, окружающее вставляемый элемент
Отсутствует
Продолжение ^
Таблица 27.5 (продолжение)
1
2
3
4
5
ID
Определяет необязательный идентификатор, по которому можно обращаться к вставляемому элементу через метод экземпляра getlmage- Reference() класса TextField
Отсутствует
CHECKPOLICYFILE
Указывает, требуется ли проверка файла политики безопасности перед обращением к элементу в виде данных (см. гл. 19)
Отсутствует
<LI>
Определяет абзац, перед которым отображается маркер. Стоит отметить, что изменить форму маркера невозможно, а теги <UL> или <OL> не требуются
Отсутствует
bullet
<Р>
Определяет абзац
ALIGN
Определяет выравнивание абзаца по горизонтали (по левому, правому краю, по центру или по ширине)
align
CLASS
Определяет класс CSS, применяется вместе с таблицами стилей
Отсутствует
<SPAN>
Помечает произвольный фрагмент текста, который может быть отформатирован с помощью таблицы стилей
CLASS
Определяет класс CSS, применяется вместе с таблицами стилей
Отсутствует
< TEXTFORM АТ >
Определяет форматирующую информацию для фрагмента текста
LEFTMARGIN
Определяет расстояние по горизонтали в пикселах между левой границей текстового поля и левым краем абзаца
leftMargin
RIGHTMARGIN
Задает расстояние по горизонтали в пикселах между правой границей текстового поля и правым краем абзаца
rightMargin
1
2
3
4
5
BLOCKINDENT
Определяет расстояние в пикселах, на которое смещается абзац относительно левой границы текстового поля
blockindent
INDENT
Определяет расстояние в пикселах, на которое смещается первая строка относительно левой границы текстового поля
. indent
LEADING
Определяет величину промежутка по вертикали в пикселах между строками текста
leading
TABSTOPS
Определяет шаги табуляции по горизонтали, в пикселах
tabStops
<и>
Задает отображение символа с использованием подчеркивания
Отсутствует
underline
Вообще говоря, использование тегов языка HTML, перечисленных в табл. 27.5, в ActionScript аналогично их использованию в распространенных браузерах. С другой стороны, между использованием HTML в ActionScript и использованием HTML в браузерах существует несколько существенных отличий.
Тег <TABLE> не поддерживается; используйте шаги табуляции для имитации таблиц языка HTML.
В языке ActionScript разметка HTML в основном используется для форматирования, и содержимое HTML не организуется в виде метафоры документа браузера. Следовательно, теги <HTML> и <BODY> не являются обязательными (однако тег <BODY> по желанию может использоваться для форматирования содержимого HTML с помощью таблиц стилей).
Неподдерживаемые теги игнорируются, хотя их текстовое содержимое сохраняется.
В языке ActionScript значения, присваиваемые атрибутам тегов, должны заключаться в кавычки. Дополнительная информация представлена в подразд. «Заключение в кавычки значений атрибутов».
В среде выполнения Flash гипертекстовые ссылки автоматически не подчеркиваются — подчеркивание должно выполняться вручную либо с помощью тега <U>, либо с помощью переменной text-decoration таблицы стилей CSS.
Тег <Ы> не поддерживает вложенные маркеры и тег <OL> (нумерованный список).
U В приложении Flash Player незакрытые теги <Р> не вызывают разрывы строк, как это происходит в обычном языке HTML. Для добавления разрывов строк Flash Player требует, чтобы были указаны закрывающие теги </Р>.
В приложении Flash Player тег <Р> вызывает один разрыв строки, как и тег <BR>, хотя в браузерах тег <Р> обычно вызывает двойной разрыв строки.
Теги <Р> и <BR> не вызывают разрывы строк в текстовых полях, переменной multiline которых присвоено значение false. Более того, переменной multiline по умолчанию присваивается значение false. Таким образом, при использовании тегов <Р> и <BR> присваивайте переменной multiline значение true.
Гипертекстовые ссылки могут быть использованы для выполнения кода на языке ActionScript. Дополнительную информацию можно найти далее, в подразд. «Гипертекстовые ссылки» разд. «Ввод через текстовые поля».
Атрибут NAME тега <А> не поддерживается приложением Flash Player, поэтому внутренние ссылки внутри тела текста невозможны.
В среде выполнения Flash якорные теги не добавляются в последовательность перехода, и поэтому на них нельзя перейти с помощью клавиатуры.
Поддержка сущностей
Сущности специальных символов, поддерживаемые языком ActionScript, перечислены в табл. 27.6. Если сущность встречается в значении переменной htmlText текстового поля, то приложение Flash Player отображает на экране соответствующий символ. Поддерживаются также и числовые сущности, например ™ (символ торгового знака).
Таблица 27.6. Поддерживаемые сущности
Сущность
Представляемый символ
<
<
>
>
&
&
"
' '
•
Неразрывный пробел
Заключение в кавычки значений атрибутов
За пределами приложения Flash Player значения атрибутов языка HTML могут быть заключены в одинарные или двойные кавычки либо вообще быть без кавычек. Следующие теги допустимо использовать в большинстве браузеров:
<Р ALIGN=RIGHT>
<Р ALIGN='RIGHT'>
<Р ALIGN="RIGHT">
Однако в приложении Flash Player значения атрибутов, не заключенные в кавычки, недопустимы. Например, в языке ActionScript синтаксис <Р ALIGN=RIGHT> недопустим. Тем не менее для отделения значений атрибутов можно использовать как одинарные, так и двойные кавычки. При создании значений текстовых полей, содержащих атрибуты языка HTML, используйте один тип кавычек для обозначения самой строки, а другой тип кавычек — для отделения значений атрибутов. Например, оба следующих примера допустимы:
t.htmlText = "<Р ALIGN='RIGHT'>h1 there</P>";
t.htmlText = '<P ALIGN="RIGHT">h1 there</P>';
Однако следующий пример приведет к ошибке, поскольку двойные кавычки используются и для обозначения строки, и для отделения значения атрибута:
// НЕПРАВИЛЬНО! Не делайте так!
t.htmlText = "<Р ALIGN="RIGHT">h1 there</P>":
Взаимосвязь переменных text и htmIText
Поскольку присваивать текстовое содержимое текстовому полю можно и с помощью переменной text, и с помощью переменной htmIText класса TextField, проявляйте осторожность при одновременном их использовании.
Когда разметка с тегами HTML присваивается переменной htmIText, значением переменной text будет являться значение переменной htmIText, но с опущенными HTML-тегами. Например, в следующей строке кода мы присваиваем фрагмент HTML переменной htmIText текстового поля:
var t:TextF1eld = new TextF1eld( ): t.htmlText = '<P ALIGN="LEFT">' +
+ '<FONT FACE="T1mes New Roman" SIZE="12" COLOR="#000000" '
+ 'LETTERSPACING="O" KERNING="0">Th1s field contains <B>HTML!</B>'
+ ,</FONT></P>':
После присваивания переменная htmIText будет иметь следующее значение:
<Р ALIGN="LEFT"><FONT FACE="T1mes New Roman" SIZE="12" COLOR="#000000" LETTERSPACING="O" KERNING="0">Th1s field contains <B>HTML!</B></FONT></P>
Однако переменная text будет иметь следующее значение:
This field contains HTML!
Обратите внимание, что последовательные присваивания значений переменным htmIText и text перезаписывают предыдущие результаты. Иначе говоря, присваивание нового значения переменной text перезаписывает существующее значение переменной htmIText, и наоборот. В отличие от этого, последовательные операции конкатенации (не повторного присваивания) не перезаписывают существующие значения. Например, следующий код присваивает некоторое содержимое HTML переменной htmIText, после чего выполняет конкатенацию данного содержимого со строкой через переменную text:
var t:TextF1eld = new TextF1eld( );
t.htmlText = "<B>hello</B>";
t.text += " world";
После конкатенации значение переменной htmIText будет выглядеть следующим образом:
<Р ALIGN="LEFT"><FONT FACE="T1mes New Roman" SIZE="12" COLOR="#000000" LETTERSPACING="O" KERNING="O">hello world</FONT></P>
Как показано в предыдущем коде, конкатенация значения переменной text со значением переменной htmIText приводит к сбрасыванию форматирования текстового поля. Когда мы присваиваем строку "world" переменной text, среда выполнения
Flash удаляет тег <В>, который изначально был присвоен переменной htmlText! Таким образом, одновременное использование операций присваивания значений переменным text и htmlText в большинстве случаев не рекомендуется.
Теги HTML, присваиваемые непосредственно переменной экземпляра text класса TextField, никогда не интерпретируются в виде разметки HTML; они всегда отображаются в первоначальном виде. Например, следующий код присваивает строку, содержащую теги HTML, переменной text, а затем выполняет конкатенацию данного содержимого с обычной строкой через переменную htmlText: var t:TextF1eld = new TextF1eld( ): t.text = "<B>world</B>"; t.htmlText += "hello";
После конкатенации значение переменной htmlText будет выглядеть следующим образом:
<Р ALIGN="LEFT"><FONT FACE="T1mes New Roman" SIZE="12" COLQR="#000000" LETTERSPACING="O" KERNING="0">&1t:B>:wor1d<:/B>:hel1o</FONT></P>
Обратите внимание, что символы < и > в теге <В> были преобразованы в сущности языка HTML & It; n>.
Нераспознанные теги и атрибуты
Как и браузеры, приложение Flash Player игнорирует теги и атрибуты, которые не может распознать. Например, мы присвоим следующее значение переменной htmlText:
<P>Please fill 1n and print this form</P>
<FORM><INPUT TYPE="TEXT"></FORM>
<P>Thank you!</P>
В результате на экране появится следующий текст:
Please fill 1n and print this form Thank you!
Элементы <FORM> и <INPUT> не поддерживаются приложением Flash Player, поэтому оба тега игнорируются (фактически неизвестные теги удаляются из значения переменной htmlText!).
Подобным образом, если мы используем контейнерные элементы, например <TD>, содержимое сохраняется, однако разметка игнорируется. Например, выполнение следующего кода: oObeKTTextField.htmAIext = "<TABLE><TR><TD>table cell text</TD></TR></TABLE>": приведет к выводу на экран такой строки без табличного форматирования: table cell text.
Однако если не закрыть тег, весь последующий текст будет считаться частью этого тега и не отобразится на экране. Например, в результате следующей операции присваивания:
odbeKTTextField.htmnext = "We all know that 5 < 20. That's obvious.":
приложение Flash Player выведет:
We all know that 5
Чтобы включить символ < в разметку HTML текстового поля, используйте сущность <, как показано в следующей строке кода:
06beKTTextField.№nVVext = "We all know that 5 < 20. That's obvious.":
Приложение Flash Player выведет текст:
We all know that 5 < 20. That's obvious.
Дополнительную информацию по включению исходного HTML-кода в текстовое поле можно найти по адресу http://moock.org/asdg/technotes/sourceInHtmlField/.
Мы узнали, каким образом можно отформатировать текстовое поле с помощью класса TextFormat и разметки HTML. Теперь рассмотрим последний инструмент, предназначенный для форматирования текста, — класс Stylesheet.
Форматирование текста с помощью класса StyleSheet
Класс StyleSheet языка ActionScript применяется для форматирования текстовых полей с помощью таблиц стилей. Функциональность этого класса базируется на очень ограниченном подмножестве каскадных таблиц, описанных в рекомендации уровня 1 (CSS1) консорциума W3C.
Для чтения этого раздела требуется понимание основных концепций языка CSS. Если вы незнакомы с этим языком, перед продолжением прочитайте следующий вводный материал в язык CSS: http://www.w3.orgAR/CSS21/intro.html и http://www.w3.org/Markllp/ Guide/Style.
Однако имейте в виду, что язык ActionScript не поддерживает полный набор возможностей, рекомендованных консорциумом W3C.
Как описано в рекомендации по языку CSS консорциума W3C, таблица стилей — это набор правил, которые определяют представление документа. Каждое правило описывает стиль для определенного элемента в документе HTML или XML. Следующий код демонстрирует пример правила, которое задает шрифт красного цвета для элементов <Н1>:
hl { color: #FFOOOO }
Внутри данного правила селектор (hl) обозначает элемент, к которому применяется стиль. Блок объявления ({ color: #FFO000 }) содержит одно или более объявлений, описывающих стиль, который должен применяться к выбранному элементу. Каждое объявление (color: #FFOOOO) включает свойство стиля (color) и значение (#FFOOOO).
Названия селекторов не зависят от регистра символов, в отличие от имен свойств стиля.
Вот простая таблица стилей, которая содержит два правила — одно для элементов
<р> и одно для элементов <li>:
Р {
font-family: sans-serif
font-size: 12рх;
}
11 {
font-family: serif
font-size: 10px:
margin-left: 10px;
}
В языке ActionScript 3.0 таблица стилей, подобная той, которая продемонстрирована в предыдущем коде, представляется экземпляром класса Styles he et. С помощью методов класса StyleSheet мы можем создать новую таблицу стилей программным путем или провести синтаксический разбор существующей внешней таблицы стилей. Чтобы связать объект StyleSheet с определенным объектом TextField, мы присваиваем объект StyleSheet переменной StyleSheet (которая будет рассмотрена далее) данного объекта TextField. С каждым текстовым полем может быть связан всего лишь один объект StyleSheet, что резко контрастирует с языком CSS1, позволяющим связывать с одним документом HTML или XML несколько таблиц стилей.
Конкретные свойства, доступные для использования в таблицах стилей ActionScript, перечислены в табл. 27.7. Язык ActionScript поддерживает только те свойства стилей из рекомендации консорциума W3C, которые соответствуют параметрам форматирования класса TextForma t. В сравнении с полным набором свойств, определяемых консорциумом W3C, набор свойств, поддерживаемых ActionScript, чрезвычайно ограничен.
Таблица 27.7. Поддерживаемые свойства стиля языка CSS
Название свойства стиля
Описание
color
Задает цвет шрифта в виде 24-битного шестнадцатеричного числа, перед которым указывается знак фунта (#). Например, красный цвет записывается как #FFOOOO
display
Определяет, должен ли элемент быть скрыт (попе), должен ли после него добавляться автоматический разрыв строки (block) или же автоматический разрыв строки добавляться не должен (inline)
font-family
Задает название шрифта устройства или встроенного шрифта
font-size
Указывает размер шрифта в пикселах
font-style
Задает отображение символа с использованием курсива (italic) или обычное отображение символа (normal по умолчанию)
font-weight
Задает отображение символа с использованием полужирного начертания (bold) или обычное отображение символа (normal по умолчанию)
kerning
Определяет, должен ли быть использован автоматический кернинг для пар символов (true) или нет (false). Эго свойство является неофициальным расширением набора поддерживаемых свойств стилей, описанных в рекомендации консорциума W3C
leading
Задает расстояние по вертикали между строками текста, в пикселах. Это свойство является неофициальным расширением набора поддерживаемых свойств стилей, описанных в рекомендации консорциума W3C. Сравните его со свойством lineheight, описанным в рекомендации консорциума W3C
Название свойства стиля
Описание
letter-spacing
Задает расстояние между буквами (то есть трекинг) в пикселах
margin-left
Определяет расстояние по горизонтали между левой границей текстового поля и левым краем абзаца в пикселах
margin-right
Задает расстояние по горизонтали между правой границей текстового поля и правым краем абзаца в пикселах
text-align
Задает выравнивание абзаца по горизонтали (left (по умолчанию), right, center или justify)
textdecoration
Определяет графические элементы украшения, добавляемые к тексту. В ActionScript поддерживаемыми значениями являются underline и попе (по умолчанию)
text-indent
Задает расстояние, которое обозначает смещение первой строки абзаца относительно левой границы текстового поля (аналогично переменной экземпляра indent класса TextFormat), в пикселах
Таблицы стилей могут применяться для форматирования как XML-, так и HTML- элементов. Однако среди HTML-элементов, используемых приложением Flash Player для форматирования (см. табл. 27.7), с помощью таблиц стилей могут быть отформатированы только теги <Р>, <Ы> и <А>. Другие встроенные теги (например, <В> и <1>) всегда выполняют свою предопределенную задачу форматирования HTML, и его нельзя изменить с помощью таблиц стилей. Более того, теги <Р> и <Ы> всегда отображаются в виде блочных элементов, даже если в соответствии с таблицей стилей они должны отображаться в виде встроенных элементов.
Чтобы добавить форматирование для различных интерактивных состояний гипертекстовой ссылки, используйте следующие селекторы псевдоклассов: a: link, a: hover и a: active. Например, следующее правило определяет, что гипертекстовые ссылки при наведении на них указателя мыши должны подчеркиваться:
a:hover {
text-decoration: underline:
}
Благодаря таблицам стилей у разработчиков появляется чрезвычайно важная возможность отделять информацию о стилях от содержимого и применять одинаковое определение стиля к нескольким блокам содержимого. Тем не менее в языке ActionScript таблицы стилей имеют много ограничений, снижающих их потенциальную полезность. Перед тем как рассмотреть вопросы форматирования текста с помощью таблиц стилей, внимательно познакомимся с этими ограничениями.
Существенные ограничения таблиц стилей в языке ActionScript
Приложение Flash Player намеренно предоставляет только минимальную реализацию таблиц стилей, играющую роль интерфейса для установки параметров форматирования текстового поля. В результате поддерживаемым приложением Flash Player таблицам стилей не хватает нескольких важных возможностей, описанных в рекомендации по языку CSS консорциума W3C. Читатели, привыкшие работать
с CSS и HTML, должны помнить о следующих ограничениях приложения Flash Player.
Все длины выражаются в пикселах. Относительная единица еш не поддерживается, а пункты трактуются как пикселы.
В любой момент времени с каждым текстовым полем можно связать всего одну таблицу стилей. Таблицы стилей приложения Flash Player не каскадируются.
Повторное присваивание таблицы стилей текстовому полю не приводит к отображению этого поля с использованием новой таблицы стилей (в качестве обходного решения можно применять подход, описание которого приводится сразу за данным списком).
Свойства margin-top и margin-bottom не поддерживаются.
Элементы не могут произвольным образом отображаться в виде элементов списка. Значение list-item свойства display не поддерживается. Более того, форму маркеров элемента списка (то есть метки) нельзя изменять, даже для собственного элемента <Ы> языка HTML.
Приложение Flash Player поддерживает только базовые селекторы типов и селекторы классов. Все остальные множества селекторов не поддерживаются. Более того, селекторы типов и селекторы классов нельзя объединять (например, следующий селектор в приложении Flash Player недопустим: р. someCustomClass). Если таблица стилей содержит селектор потомка, вся таблица стилей будет проигнорирована и никакое форматирование применено не будет.
Если таблица стилей присваивается текстовому полю, то текстовое содержимое этого поля не может быть изменено с помощью методов replaceText ( ), appendText ( ), replaceSelText ( ) или через пользовательский ввод.
Чтобы изменить таблицу стилей текстового поля, сначала присвойте желаемый объект StyleSheet переменной styleSheet, а затем присвойте переменную htmlText самой себе, как показано в следующем коде:
t. styleSheet = HeKMHoBbw06beKTStyl eSheet;
t.htmlText = t.htmlText:
Стоит отметить, что новая таблица стилей должна устанавливать все свойства стиля, которые были установлены прежней таблицей стилей. В противном случае любые неустановленные прежние значения свойств стиля будут сохранены.
Теперь, когда мы познакомились с основными возможностями и ограничениями таблиц стилей, поддерживаемых приложением Flash Player, посмотрим на них в действии. Следующие два раздела описывают, как применять таблицу стилей к текстовому полю, сначала с использованием таблицы стилей, создаваемой программным путем, а затем с помощью таблицы стилей, загружаемой из внешнего CSS-файла.
Форматирование текста с помощью таблицы стилей, создаваемой программным путем
Чтобы отформатировать текст с помощью таблицы стилей, создаваемой программным путем, используйте следующую обобщенную последовательность действий.
Создайте один или несколько базовых блоков, представляющих блоки объявления правил.
Создайте объект StyleSheet.
Используйте метод экземпляра setstyle ( ) класса StyleSheet, чтобы создать одно или несколько правил на основании блоков объявления, созданных на шаге 1.
Используйте переменную экземпляра StyleSheet класса TextField, чтобы ' зарегистрировать объект StyleSheet в желаемом объекте TextField.
Присвойте желаемое содержимое HTML или XML переменной htmlText объекта TextField.
Всегда регистрируйте объект StyleSheet (шаг 4) до того, как будет присвоено содержимое HTML или XML (шаг 5). В противном случае таблица стилей не будет применена к этому содержимому.
Применим перечисленные шаги на практике. Наша цель — отформатировать весь текст в текстовом поле, используя шрифт Arial размером 20 пунктов полужирного начертания (как мы делали это ранее с помощью класса Te'xtFormat и разметки HTML). Как и раньше, форматируемым текстом является следующий простой фрагмент на языке HTML:
<p>Act1onScrlpt Is fun!</p>
В нашей таблице стилей мы определяем правило, которое говорит приложению Flash Player отображать содержимое всех тегов <Р> с помощью шрифта Arial размером 20 пунктов полужирного начертания. Блок объявления для нашего правила является простым базовым объектом с динамическими переменными экземпляра, имена которых соответствуют свойствам стиля CSS, а значения переменных задаются соответствующими значениями стиля CSS. Вот этот код:
// Создаем объект, который будет служить блоком объявления var pDeclarationBlock:Object = new Object( ):
// Присваиваем значения свойствам стиля
pDeclarationBlock.fontFamlly = "Arial"
pDeclarationBlock.fontSize = "20":
pDeclarationBlock.fontweight = "bold";
В приведенном коде обратите внимание на то, что при создании таблиц стилей программным путем формат имен свойств CSS слегка изменяется: дефисы удаляются, а символы, которые следуют за дефисами, записываются в верхнем регистре. Например, свойство font-family превращается в свойство fontFamily.
Теперь, когда наш блок объявления готов, мы создаем объект StyleSheet. Вот этот код:
var StyleSheet:StyleSheet = new StyleSheet( ):
Чтобы создать правило для тега <Р>, мы используем метод экземпляра set S tyle ( ) класса StyleSheet. Метод setstyle ( ) создает новое правило стиля на основе
двух параметров: имени селектора (тип String) и блока объявления (тип Ob j ect), как показано в следующем обобщенном коде:
oObeKiStyleSheet.setStyleCселектор", блокОбъявления):
Соответственно, вот код, создающий правило для тега <Р>:
styl eSheet. setStyleCp", pDeclarationBlock):
Наша таблица стилей готова. Теперь мы создадим текстовое поле, к которому будет применено форматирование. Следующий код создает текстовое поле и присваивает наш объект StyleSheet переменной styleSheet этого поля:
var t:TextF1eld = new TextF1eld( );
t.width = 200
t.styleSheet = styleSheet:
Наконец, мы присваиваем текст, который должен быть отформатирован, переменной htmlText:
t.htmlText = "<p>Act1onScrlpt 1s fun!</p>":
В листинге 27.7 представлен весь код целиком для нашего текстового поля, к которому применяется форматирование.
Листинг21.1. Форматирование текста с помощью таблицы стилей, создаваемой программным путем
// Создаем блок объявления
var pDeclarationBlock:Object = new Object( ):
pDeclarationBlock.fontFamlly = "Arial"
pDeclarationBlock.fontsize = "20":
pDeclarationBlock.fontweight = "bold":
// Создаем таблицу стилей
var styleSheet:StyleSheet = new StyleSheet( ):
// Создаем правило
styl eSheet. setStyleCp", pDeclarationBlock):
// Создаем текстовое поле
var t:TextF1eld = new TextF1eld( ):
t.width = 200
// Присваиваем таблицу стилей
t.styleSheet = styleSheet:
// Присваиваем HTML-код, который должен быть отформатирован t.htmlText = "<p>Act1onScr1pt 1s fun!</p>";
Результат выполнения кода из листинга 27.7 идентичен результату, который был проиллюстрирован ранее на рис. 27.10 и 27.11.
Селекторы класса
Чтобы применить стиль не ко всем абзацам сразу, а к одному определенному подмножеству абзацев, мы используем селектор класса CSS. Предположим, что мы
хотим акцентировать внимание пользователя на важных примечаниях в документе. Мы помещаем примечания в теги <Р> и присваиваем атрибуту class этих тегов собственное значение specialnote, как показано в следующем коде:
<р class='sped al note*>Set styleSheet before htmlText!</p>
Затем мы создаем правило для этого класса specialnote, используя селектор класса, как показано в следующем коде:
styleSheet.setStylе(".special note", sped al noteDecl arationBlock):
Как и в языке CSS, селектор класса в языке ActionScript состоит из точки, за которой указывается желаемое значение атрибута class (в нашем случае specialnote).
В листинге 27.8 представлен переработанный пример нашей предыдущей таблицы стилей, чтобы продемонстрировать использование селекторов класса CSS в языке ActionScript.
Листинг 27.8. Форматирование, применяемое к определенному классу абзаца
var sped alnoteDeclarationBlock:Object = new Object( );
sped al noteDecl arationBlock.fontFamlly = "Arial"
sped alnoteDecl arationBlock.fontsize= "20":
spedalnoteDeclaratlonBlock.fontWelght = "bold":
var styleSheet:StyleSheet = new StyleSheet( ):
styleSheet.setStyle(".special note", specialnoteDeclarationBlock);
// Создаем текстовое поле
var t:TextF1eld = new TextF1eld( );
t.width = 300:
t.wordwrap = true: t.multiline = true; t.styleSheet = styleSheet: t.htmlText = "<p>Always remember...</p>"
+ "<p class='specialnote'>Set styleSheet before htmlText!</p>"
+ "<p>0therw1se. the stylesheet will not be appl1ed.</p>":
Результат выполнения кода из листинга 27.8 продемонстрирован на рис. 27.12.
Always remember...
Set styleSheet before html Text!
Otherwise, the stylesheet will not be applied.
Рис. 27.12. Форматирование, примененное к определенному классу абзаца
Форматирование тегов XML с помощью стилей CSS
Чтобы применить стиль к определенному фрагменту содержимого, мы можем создать для этого фрагмента собственный XML-тег. Например, вместо того, чтобы описывать особое примечание в виде класса абзаца (как это было сделано в предыдущем разделе), мы могли бы создать совершенно новый XML-тег, как показано в следующем коде:
<spedalnote>Set styleSheet before html Text !</sped al note>
Чтобы применить правило стиля к тегу <specialnote>, мы используем обычный селектор типа (без точки в начале), как показано в следующем коде:
styleSheet .setstyle ("sped al note", sped al noteDedarationBlock);
Кроме того, чтобы указать, что поведение нашего тега <specialnote> должно быть аналогичным поведению абзаца, мы присваиваем переменной display в правиле <specialnote> значение block. В листинге 27.9 представлен весь код целиком, предназначенный для форматирования пользовательского XML-тега, при этом заслуживающие внимания отличия от нашего предыдущего кода с применением селектора класса выделены полужирным шрифтом.
Листинг 27.9. Форматирование содержимого XML с помощью таблицы стилей
var sped al noteDedarationBlock: Object = new Object ( ):
sped alnoteDeclarationBlock.fontFamily = "Arial"
specialnoteDeclarat1onBlock.fontS1ze = "20":
sped al noteDedarationBlock. fontweight = "bold";
sped al noteDecl arat i onBl ock. di spl ay= " bl ock";
var styleSheet:StyleSheet = new Sty1 eSheet( ):
sty1 eSheet.setStyle("sped al note", specialnoteDeclarat1onBlock):
var t:TextF1eld = new TextF1eld( ):
t.width = 300:
t.wordwrap = true:
t.multiline = true:
t.styleSheet = styleSheet:
t.htmlText = "<p>Always remember...</p>"
+ "<specialnote>Set styleSheet before htmlText!</specialnote>"
+ "<p>0therw1se, the stylesheet will not be app!1ed.</p>":
Результат выполнения кода из листинга 27.9 идентичен результату, который был проиллюстрирован на рис. 27.12.
Форматирование текста с помощью загружаемой извне таблицы стилей
Чтобы отформатировать текст с помощью загружаемой извне таблицы стилей, используйте следующую обобщенную последовательность действий.
Создайте таблицу стилей во внешнем CSS-файле.
Используйте класс URLLoader, чтобы загрузить этот CSS-файл.
После завершения загрузки CSS-файла создайте объект StyleSheet.
Используйте метод экземпляра parseCSS ( ) класса StyleSheet, чтобы импортировать правила из CSS-файла в объект StyleSheet.
Используйте переменную экземпляра styleSheet класса TextField, чтобы зарегистрировать объект StyleSheet в желаемом объекте TextField.
Присвойте требуемое содержимое HTML или XML переменной htmlText объекта TextField.
Применим перечисленные шаги на примере. Наша цель, как и раньше, — создать приложение, которое форматирует весь текст в поле, используя шрифт Arial разме-
ром 20 пунктов полужирного начертания. Как и раньше, форматируемым текстом является следующий простой фрагмент на языке HTML:
<p>Act1onScrlpt 1s fun!</p>
Сначала мы добавляем следующее CSS-правило в текстовый файл с именем styles. css:
р {
font-family: Arial;
font-size: 20px;
font-weight: bold:
}
Далее мы создаем основной класс нашего приложения StyleSheetLoadingDemo. Он использует объект URLLoader для загрузки файла styles . css, как показано в следующем коде:
package {
Import flash.display.*:
Import fl ash.text.*;
Import flash.events.*:
Import flash.net.*;
public class StyleSheetLoadingDemo extends Sprite {
public function StyleSheetLoadingDemo ( ) {
// Загружаем файл styles.css
var urlLoader:URLLoader = new URLLoader( );
urlLoader.addEventListener(Event.COMPLETE, completeLlstener);
urlLoader.1oad(new URLRequest("styles.css")):
}
private function completeLlstener (e:Event):void {
// Код этого метода выполняется после завершения загрузки
// файла styles.css
}
}
}
Когда загрузка файла styles. css будет завершена, произойдет вызов метода completeLlstener ( ). Внутри этого метода мы создаем новый объект StyleSheet и импортируем в него правила из файла styles .css, как показано в следующем коде:
private function completeLlstener (e:Event):void { var styleSheet:StyleSheet = new StyleSheet( );
styleSheet.parseCSS(e.target.data);
}
Как только правила будут импортированы в объект StyleSheet, мы создаем наш объект TextField, регистрируем таблицу стилей и затем присваиваем форматируемый текст, как показано в следующем коде:
var t:TextF1eld = new TextF1eld( );
t.width = 200;
t.styleSheet = sty1 eSheet;
t.htmlText = "<p>Act1onScr1pt 1s fun!</p>";
В листинге 27.10 показан весь код целиком для класса StyleSheetLoadingDemo.
Листинг 27.10. Форматирование текста с помощью внешней таблицы стилей package {
Import flash.display.*;
Import flash.text.*;
Import flash.events.*;
Import flash.net.*;
public class StyleSheetLoadingDemo extends Sprite {
public function StyleSheetLoadingDemo ( ) { var urlLoader:URLLoader = new URLLoader( );
urlLoader.addEventLIstener(Event.COMPLETE. completeL1stener);
url Loader.1oad(new URLRequest("styles.css"));
}
private function completeListener (e:Event):void {var styleSheet:StyleSheet = new StyleSheet! ):
styleSheet.parseCSS(e.target.data):
var t.TextField = new TextField! );
t.width = 200;
t.styleSheet = styleSheet:
t.htmlText = "<p>ActionScript is fun!</p>";•
addChild(t):
}
}
}
Результат выполнения кода из листинга 27.10 идентичен результату, который был проиллюстрирован ранее на рис. 27.10 и 27.11.
Мы рассмотрели методики форматирования текста в языке ActionScript. В следующем разделе будут освещены несколько вопросов, касающихся визуализации и использования шрифтов в SWF-файле.
Шрифты и отображение текста
По умолчанию приложение Flash Player отображает текст с помощью шрифтов устройства. Это шрифты, установленные в системе конечного пользователя. Когда приложение Flash Player отображает текст с помощью шрифта устройства, оно полностью делегирует процесс визуализации текста локальной среде (то есть операционной системе). Например, рассмотрим следующее простое приложение HelloWorld, создающее текстовое поле, для форматирования которого применяется шрифт Arial: package {
Import fl ash.display.*;
Import fl ash.text.*;
public class HelloWorld extends Sprite {
public function HelloWorld ( ) {
var fontFormat;TextFormat = new TextFormat( );
fontFormat.font = "Arial";
var t:TextField = new TextField( );
t.text = "Hello world";
t.setTextFormat(fontFormat);
addChild(t);
}
}
}
При выполнении этого кода приложение Flash Player добавляет объект t в список отображения и готовится к обновлению экрана. Чтобы отобразить символы «Hello world», приложение Flash Player передает строку "Hello world” визуализатору текста операционной системы и просит его отобразить эти символы с помощью системного шрифта Arial. Операционная система визуализирует эти символы непосредственно в буфере кадра приложения Flash Player. Например, в операционной системе Windows ХР строка "Hello world” будет отображена с использованием визуализатора ClearType корпорации Microsoft.
Если бы предыдущее приложение HelloWorld выполнялось на двух различных компьютерах под управлением двух различных операционных систем, эти компьютеры могли бы иметь два различных встроенных визуализатора текста и, возможно, даже две различные версии шрифта Arial. Таким образом, даже если требуемый шрифт будет доступен, символ, отображаемый на экране, на разных компьютерах может выглядеть по-разному. Кроме того, незначительное влияние на поведение визуализатора текста могут оказать переменная cacheAsBitmap или фильтры. Например, если объект TextField помещается в объект Sprite, переменной cacheAsBitmap которого присвоено значение true, операционная система Windows ХР будет использовать обычное сглаживание вместо визуализатора ClearType.
Если шрифт, указанный для некоторого символа, не установлен в операционной системе конечного пользователя, то приложение Flash Player автоматически попросит операционную систему отобразить данный символ с помощью подходящего замещающего шрифта. Например, если для некоторого символа указан шрифт Verdana и этот символ отображается в стандартной версии операционной системы Mac OS X (не включающей шрифт Verdana), он будет визуализирован с помощью рубленого шрифта Helvetica, используемого по умолчанию. Таким образом, в зависимости от доступности шрифтов в операционной системе конечного пользователя, текст, визуализируемый с помощью шрифтов устройства на двух различных компьютерах под управлением двух различных операционных систем, может выглядеть совершенно по-разному.
При использовании шрифтов устройства отображение текста зависит от операционной системы и — для версии приложения Flash Player, реализованной в виде модуля расширения, — от браузера.
Если для некоторого символа шрифт не указан вообще, то локальный визуализа- тор отображает этот символ с использованием произвольного шрифта по умолчанию, выбираемого приложением Flash Player. Например, в операционной системе Windows ХР шрифтом по умолчанию является Times New Roman.
Чтобы исключить различия в отображении текста на разных компьютерах и устройствах, приложение Flash Player позволяет разработчикам встраивать начертания шрифтов в SWF-файл. Текст, отображаемый с помощью встроенных начертаний шрифтов, гарантированно будет иметь очень похожий внешний вид на различных компьютерах, операционных системах и устройствах. Однако за такую согласованность необходимо платить; встраивание начертания для шрифта Roman целиком обычно увеличивает размер SWF-файла на 20-30 Кбайт (шрифты для азиатских языков могут занимать гораздо больше места). В отличие от этого, шрифты устройств совершенно не увеличивают размер SWF-файл. Таким образом, шрифты устройств обычно используются в тех случаях, когда небольшой размер файла гораздо важнее визуальной целостности, а встраиваемые начертания шрифтов обычно применяются, когда визуальная целостность гораздо важнее небольшого размера файла.
Чтобы использовать встроенный шрифт, мы должны сначала встроить начертания этого шрифта, а затем на этапе выполнения связать встроенные шрифты с желаемым текстовым полем (-ями). Когда встроенные шрифты связываются с текстовым полем, оно отображается либо с помощью стандартного визуализатора векторной графики приложения Flash Player, либо с помощью специализированного визуализатора FlashType, но не с помощью визуализатора текста локальной среды. Обратите внимание, что каждая вариация стиля шрифта должна быть встроена по отдельности. Если текстовое поле использует встраиваемые версии шрифта Courier New полужирного начертания, курсива и полужирного курсива, мы должны встроить все три вариации шрифта, иначе текст будет отображаться неправильно. Подчеркивание не считается ни вариацией шрифта, ни его размером или цветом.
Методика встраивания начертаний шрифтов на этапе компиляции зависит от различных инструментов разработки. В двух следующих разделах рассматривается, как встраивать шрифты в среде разработки Flash и в приложении Flex Builder или консольном компиляторе mxmlc. Для примера в каждом разделе описывается процедура встраивания шрифта Verdana. Как только начертания шрифта будут встроены в SWF-файл, они могут быть использованы для форматирования текста, как описывается в подразд. «Форматирование текста с помощью встраиваемого шрифта» этого раздела.
Встраивание начертаний шрифта в среде разработки Flash
Чтобы встроить начертания шрифта Verdana в среде разработки Flash, выполняйте следующие шаги.
Выберите команду меню Window ► Library (Окно ► Библиотека).
В меню Options (Параметры), значок которого расположен в правом верхнем углу панели Library (Библиотека), выберите команду New Font (Новый шрифт). На экране появится окно Font Symbol Properties (Свойства символа шрифта).
В раскрывающемся списке Font (Шрифт) выберите значение Verdana.
В поле Name (Имя) введите значение Verdana (это имя выполняет косметическую функцию и используется только на палитре Library (Библиотека)).
Нажмите кнопку ОК.
На палитре Library (Библиотека) выберите символ шрифта Verdana.
В меню Options (Параметры) выберите команду Linkage (Связывание).
В области Linkage (Связывание) окна Linkage Properties (Свойства связывания) установите флажок Export For ActionScript (Экспорт для ActionScript).
В поле Class (Класс) должно автоматически появиться значение Verdana. Если этого не произошло, введите значение Verdana в поле ввода Class (Класс). Указанное имя класса используется при загрузке шрифтов на этапе выполнения (этот процесс рассматривается далее, в подразд. «Загрузка шрифтов на этапе выполнения»).
Нажмите кнопку ОК.
Среда разработки Flash позволяет встраивать начертания для любого шрифта, который отображается в раскрывающемся списке Font (Шрифт) окна Font Symbol Properties (Свойства символа шрифта).
Чтобы экспортировать шрифт без сглаживания, добавьте следующий шаг между шагами 2 и 3 описанной процедуры: в окне Font Symbol Properties (Свойства символа шрифта) (шаг 2) установите флажок Bitmap text (Растровый текст) и затем укажите размер шрифта.
Когда установлен флажок Bitmap text (Растровый текст), при вычислении начертаний символов компилятор связывает фигуры с целыми пикселами. В результате для каждого символа указанного размера образуется четкая векторная фигура без сглаживания. Чтобы добиться наилучших результатов при использовании параметра Bitmap text (Растровый текст), размер шрифта, устанавливаемый для текста, который форматируется с помощью встраиваемого шрифта, должен всегда равняться размеру шрифта, указываемому в окне Font Symbols Properties (Свойства символа шрифта). Кроме того, избегайте масштабирования текста, к которому применяется форматирование с использованием встраиваемого шрифта.
В приложении Flex Builder 2 и компиляторе mxmlc параметр Bitmap text (Растровый текст) отсутствует.
Встраивание начертаний шрифта в приложении Flex Builder 2 и компиляторе mxmlc
Для встраивания начертаний шрифта в проект ActionScript приложения Flex Builder 2 или с помощью консольного компилятора mxmlc мы используем тег метаданных [Embed]. Чтобы использовать его, мы должны предоставить компилятору доступ к библиотеке flex. s wc, поддерживающей компилятор Flex. По умолчанию все проекты приложения Flex Builder 2 автоматически включают местоположение файла flex. swc в список путей к библиотекам языка ActionScript, поэтому
в приложении Flex Builder 2 все методики, описываемые в данном разделе, будут работать без специальной настройки компилятора.
Элементы, встраиваемые с помощью тега метаданных [Embed], включая шрифты, могут быть встроены как на уровне переменной, так и на уровне класса. Тем не менее встраивание шрифта на уровне переменной более удобно, чем встраивание шрифта на уровне класса, поэтому шрифты редко встраиваются на уровне класса.
Дополнительную информацию о теге метаданных [Embed] можно найти в гл. 28.Дополнительную информацию о теге метаданных [Embed] можно найти в гл. 28.
Дополнительную информацию о теге метаданных [Embed] можно найти в гл. 28.
Дополнительную информацию о теге метаданных [Embed] можно найти в гл. 28.
Обобщенный код, необходимый для встраивания шрифта на уровне переменной в проекте ActionScript приложения Flex Builder 2 или с помощью компилятора mxmlc, выглядит следующим образом:
[ Embed (source" путь КШрифту",
fontFami1у="имяШрифта")]
private var имяКласса:САа55;
В приведенном коде, который должен размещаться в теле класса, путьКШрифту обозначает путь к файлу шрифта в локальной файловой системе, имяШрифта — произвольное имя, по которому можно будет обращаться к шрифту из приложения, а имяКласса — имя переменной, которая будет ссылаться на класс, представляющий встроенный шрифт. Этот класс применяется только при загрузке шрифтов на этапе выполнения, как станет известно далее из подразд. «Загрузка шрифтов на этапе выполнения».
Например, следующий код демонстрирует, как встроить начертания шрифта Verdana в операционную систему Windows ХР. Обратите внимание, что в значении путьКШрифту должны использоваться прямые слэши, но при этом оно не чувствительно к регистру символов.
[Embed(source="c:/windows/fonts/verdana.ttf",
fontFamily="Verdana")]
private var verdana:Cl ass:
При выполнении предыдущего кода среда Flash автоматически генерирует класс, представляющий элемент встроенного шрифта, и присваивает этот класс переменной verdana.
Тег метаданных [Embed] может применяться только для шрифтов TrueType.
В простых случаях код, который встраивает шрифт, находится в том же классе, который использует этот шрифт для форматирования текста. Это демонстрирует листинг 27.11, в котором представлен простой класс HelloWorldVerdana, отображающий текст «Hello world», отформатированный с помощью встроенного шрифта (более подробно о форматировании текста с помощью встраиваемых шрифтов мы узнаем в следующем разделе).
Листинг 27.11. Отображение Hello World с использованием шрифта Verdana
package {
Import flash.display.*;
import fl ash.text.*;
public class HelloWorldVerdana extends Sprite {
// Встраиваем шрифт Verdana
[Embed(source="c:/windows/fonts/verdana.ttf",
fontFami1y^"Verdana")]
private var verdana:Class;
public function HelloWorldVerdana ( ) {
var t:TextF1eld = new TextF1eld( );
t.embedFonts = true;
// Форматируем текст с помощью шрифта Verdana
t.htmlText = "<FONT FACE=*Verdana*>Hel1 о world</F0NT>";
addChild(t);
}
}
}
В более сложных приложениях, использующих множество встраиваемых шрифтов, за встраивание всех шрифтов обычно отвечает один центральный класс — благодаря этому происходит отделение кода, отвечающего за встраивание шрифта, от кода, осуществляющего форматирование текста. Это демонстрирует листинг 27.12, в котором представлено два класса: FontEmbedder, отвечающий за встраивание шрифта, и HelloWord — основной класс, форматирующий текст с помощью шрифта, встроенного через класс FontEmbedder. Обратите внимание, что класс HelloWorldno необходимости создает ссылку на класс FontEmbedder, заставляя класс FontEmbedder и все его шрифты скомпилироваться в SWF-файл.
Листинг 27.12. Централизованное встраивание шрифтов
// Класс FontEmbedder package {
// Встраивает шрифты для данного приложения
public class FontEmbedder {
[Embed(source="c:/w1ndows/fonts/verdana.ttf",
fontFamily="Verdana")]
private var verdana;Cl ass;
}
}
// Класс Hell eWorld
package {
Import flash.display.*:
import fl ash.text.*;
public class Hell eWorld extends Sprite {
// Создаем ссылку на класс, который встраивает шрифты для данного
// приложения. Эта ссылка заставляет скомпилировать класс
// и. соответственно, его шрифты в SWF-файл.
FontEmbedder;
public function HelloWorld ( ) {
van t:TextF1eld = new TextF1eld( );
t.embedFonts = true;
t.htmlText = "<FONT FACE='Verdana'>Hel1 о world</F0NT>";
addChlld(t);
}
}
}
Для сравнения в листинге 27.13 представлен код, демонстрирующий методику встраивания шрифта на уровне класса. Обратите внимание, что класс, использующий встроенный шрифт, должен ссылаться на класс, который встраивает этот шрифт.
Листинг 27.13. Встраивание шрифта на уровне класса
// Класс, встраивающий шрифт
package {
Import flash.display.*;
Import mx.core.FontAsset;
[Embed(source="c:/w1ndows/fonts/verdana.ttf", fontFamlly="Verdana")]
public class Verdana extends FontAsset {
}
// Класс, использующий встроенные шрифты
package {'
Import flash.display.*;
Import fl ash.text.*;
public class HelloWorld extends Sprite {
// Создаем ссылку на класс, который встраивает шрифты для данного
// приложения. Эта ссылка заставляет скомпилировать класс
// и, соответственно, его шрифты в SWF-файл.
Verdana;
// Конструктор
public function HelloWorld ( ) {
var t;TextF1eld = new TextF1eld( );
t.embedFonts = true;
t.htmlText = "<FONT FACE='Verdana'>Hellо world</F0NT>"; addChlld(t);
Стоит отметить, что из-за ошибки в приложении Flex Builder 2 и компиляторе mxmlc для шрифтов, встраиваемых с помощью синтаксиса тега [Embed], нельзя использовать кернинг. Тем не менее он может быть использован для шрифтов, встраиваемых с помощью среды разработки Flash. Если кернинг необходимо применять в приложении, скомпилированном с помощью приложения Flex Builder 2 или компилятора mxmlc, встройте желаемый шрифт в SWF-файл с помощью среды разработки Flash, а затем загрузите этот шрифт динамически (дополнительные сведения можно получить в подразд. «Загрузка шрифтов на этапе выполнения»).
Теперь, когда мы узнали, как встраивать шрифты с помощью среды разработки Flash и тега метаданных [Embed], рассмотрим вопросы форматирования текста с использованием встраиваемых шрифтов.
Форматирование текста с помощью встраиваемого шрифта
Чтобы отформатировать некоторый объект TextField с помощью встраиваемых шрифтов, мы должны сначала присвоить переменной embedFont s данного объекта значение true. Когда это сделано, приложение Flash Player знает, что при отображении содержимого данного текстового поля необходимо использовать встраиваемые шрифты. Это демонстрирует следующий код:
// Создаем объект TextField
var t:TextF1eld = new TextF1eld( ):
// Говорим приложению Flash Player использовать встраиваемые шрифты // при отображении содержимого объекта t
t.embedFonts = true;
Само по себе присваивание переменной embedFonts значения true не вызывает добавления никаких шрифтов в SWF-файл. Эта операция просто означает, что текстовое поле должно отображаться с помощью встраиваемых шрифтов, если они доступны.
Переменная embedFonts должна устанавливаться по отдельности для каждого текстового поля, использующего конкретный шрифт, даже если один и тот же шрифт применяется для нескольких полей. Тем не менее, когда несколько полей используют один и тот же встраиваемый шрифт, размер файла не увеличивается — вместе с SWF-файлом загружается всего одна копия шрифта.
Присвоив переменной embedFonts объекта TextField значение true, мы устанавливаем шрифт для текстового поля, используя переменную экземпляра font класса TextFormat, атрибут face тега <font> или свойство f ontFamily языка CSS, как было рассмотрено ранее в разд. «Форматирование текстовых полей». Например:
// Устанавливаем шрифт с помощью объекта TextFormat
var format:TextFormat = new TextFormatt ):
format.font = "названиеШрифта":
var t:TextF1eld = new TextF1eld( );
t.embedFonts = true;
t.defaultTextFormat = format;
t.text = "hello world";
// Устанавливаем шрифт с помощью разметки HTML var t:TextF1eld = new TextF1eld( );
t.embedFonts = true;
t.htmlText = "<FONT FACE='названиеШрифта ’>Hello world</FONT>";
// Устанавливаем шрифт с помощью языка CSS
var styleSheet:StyleSheet = new StyleSheett );
var pStyle;Object = new Objectt );
pStyle.fontFamily = "названиеШрифта";
styleSheet.setStyleCp", pStyle);
var t:TextF1eld = new TextF1eld( );
t.embedFonts = true;
t.styleSheet = styleSheet; // Присваиваем значение переменной styleSheet
// до того, как будет присвоено значение
// переменной htmlText!
t.htmlText = "<p>hello world</p>";
В приведенном коде названиеШрифта обозначает название встраиваемого шрифта, которое определяется инструментом, использованным для компиляции SWF- файла, содержащего этот шрифт.
Для шрифтов, встраиваемых с помощью тега метаданных [Embed], названиеШрифта должно соответствовать строковому значению, указываемому для параметра font Family тега [Embed], который применяется для встраивания шрифта.
Для шрифтов, встраиваемых с помощью среды разработки Flash, названиеШрифта должно соответствовать названию, выбранному в списке Font (Шрифт) окна Font Symbol Properties (Свойства символа шрифта), которое используется для встраивания шрифта (см. описание шага 3 в подразд. «Встраивание начертаний шрифта в среде разработки Flash»). Для шрифтов, которые встраиваются при установленном флажке Bitmap text (Растровый текст), названиеШрифта должно соответствовать следующему шаблону:
названиеВСпискеШрифт _размерШрифтар1_кодВариации
В этом шаблоне названиеВСпискеШрифт — название, выбранное в списке Font (Шрифт) окна Font Symbol Properties (Свойства символа шрифта), размерШрифта — размер шрифта, установленный в окне Font Symbol Properties (Свойства символа шрифта), а код- Вариации — одно из значений st (обычный), b (полужирный), i (курсив) или bi (полужирный курсив), соответствующее выбранной вариации шрифта в окне Font Symbol Properties (Свойства символа шрифта).
Описанный шаблон применяется в приложениях Flash CS3 и Flash Player 9, но в будущем он может измениться. С другой стороны, чтобы обеспечить обратную совместимость, гипотетические будущие версии приложения Flash Player будут продолжать поддерживать этот шаблон.
В табл. 27.8 приведено несколько примеров предыдущего шаблона названиеШрифта, который должен применяться при установленном флажке Bitmap text (Растровый текст).
Таблица 27.8. Примеры шаблона, применяемого при установленном флажке Bitmap text (Растровый текст)
Название в списке Font (Шрифт)
Вариация шрифта
Размер шрифта
Пример значения названиеШрифта
Verdana
Обычный
12
Verdana_12pt_st
Verdana
Полужирный
12
Verdana_12pt_b
Verdana
Курсив
12
Verdana_12pt_i
Verdana
Полужирный курсив
12
Verdana_12pt_bi
Стоит отметить, что общая методика выбора шрифта символа не зависит от того, какой шрифт используется для отображения текста — шрифт устройства или встроенный шрифт. В случае со шрифтами устройства указываемое название должно соответствовать названию шрифта, установленного в системе конечного пользователя. В случае со встраиваемыми шрифтами указываемое название должно соответствовать названию встроенного шрифта.
Использование полужирного начертания и курсива со встраиваемыми шрифтами. Чтобы использовать вариации шрифта полужирного начертания, курсива или полужирного курсива в объекте TextField, переменной embedFonts которого присвоено значение true, мы должны встроить эти вариации по отдельности. Например, если мы используем вариации шрифта Arial полужирного начертания, курсива и полужирного курсива в объекте TextField, переменной embedFonts которого присвоено значение true, мы должны встроить все три вариации шрифта Arial.
Каждой вариации шрифта, встраиваемой с помощью среды разработки Flash, должно быть присвоено уникальное имя класса в окне Font Symbol Properties (Свойства символа шрифта). Подобным образом, название каждой вариации шрифта, встраиваемой с помощью тега метаданных [Embed], должно соответствовать имени ее собственной переменной (для шрифтов, встраиваемых на уровне переменной) или класса (для шрифтов, встраиваемых на уровне класса). Более того, каждая вариация некоторого шрифта должна указывать одно и то же значение для параметра fontFamily тега [Embed] и использовать соответствующий параметр вариации шрифта (либо fontweight, либо fontstyle), чтобы определить встраиваемую вариацию.
Например, следующий код встраивает вариации шрифта Verdana полужирного начертания и курсива. Для вариации шрифта полужирного начертания переменной fontFamily присваивается значение "Verdana", а переменной font Style — значение " italic". Обратите внимание, что параметр источник для каждой инструкции встраивания обозначает местоположение файла шрифта, содержащего подходящую вариацию шрифта (verdanab. ttf и verdanai . tt f соответственно).
[Embed(source="c:/windows/fonts/verdanab.ttf",
fontFamily="Verdana",
fontWeight="bold")]
private var verdanaBold:Class;
[Embed(source="c:/windows/fonts/verdanai.ttf",
fontFamily="Verdana", fontStyle="italic")]
private var verdanaItalic:Class;
Для справки в листинге 27.14 представлен код, необходимый для встраивания и использования вариаций шрифта Verdana обычного и полужирного начертания.
Листинг 27.14. Встраивание нескольких вариаций шрифта
// Класс, встраивающий шрифт
package {
public class FontEmbedder {
// Встраиваем вариацию обычного начертания
[Embed(source="c:/w1ndows/fonts/verdana.ttf",
fontFam1ly="Verdana")]
private var verdana:Class;
// Встраиваем вариацию полужирного начертания
[Embed(source="c:/w1ndows/fonts/verdanab.ttf",
fontFam1ly="Verdana",
fontWe1ght="bold")]
private var verdanabold;Class;
}
}
// Класс, использующий встроенные шрифты
package {
Import flash.display.*;
Import flash.text.*;
public class Hell eWorld extends Sprite {
// Заставляет скомпилировать класс FontEmbedder и, соответственно,
// его шрифты в SWF-файл.
FontEmbedder;
public function Hell eWorld ( ) {
var t;TextF1eld = new TextF1eld( ); t.embedFonts = true;
// Используем две вариации шрифта Verdana (обычного и полужирного
// начертания)
t.htmlText = "<FONT FACE='Verdana'>Hel1 о <b>world</b></FONT>";
addChlld(t);
}
}
}
Загрузка шрифтов на этапе выполнения
Представим, что мы создаем приложение для приобретения туристических услуг, которое позволяет пользователю приобрести авиабилет, оплатить комнату в отеле и услуги по трансферу из аэропорта в отель и обратно. Каждый раздел приложения имеет собственный дизайн, использующий свои шрифты. В некоторых случаях пользователи приобретают только авиабилет и полностью пропускают разделы приложения, относящиеся к оплате комнаты в отеле и услуг по доставке.
Чтобы ускорить процесс начальной загрузки приложения для приобретения туристических услуг, мы можем отложить загрузку шрифтов до тех пор, пока они на самом деле не потребуются приложению. Непосредственно перед обращением пользователя к конкретному разделу приложения мы загружаем шрифты, необходимые для данного раздела. Таким образом, пользователи, которые обращаются только к одному разделу, загружают шрифты, необходимые только для него,
и перед началом использования приложения им не придется ждать, пока будут загружены шрифты для остальных разделов.
Чтобы загрузить шрифты на этапе выполнения, повторите следующие обобщенные шаги.
Встройте шрифт (-ы) в SWF-файл (с помощью методик, описанных ранее в подразд. «Встраивание начертаний шрифта в среде разработки Flash» и «Встраивание начертаний шрифта в приложении Flex Builder 2 и компиляторе mxmlc»).
В SWF-файле, содержащем встроенный шрифт, используйте статический метод registerFont ( ) класса Font, чтобы добавить шрифт в глобальный список шрифтов.
Загрузите SWF-файл со встроенным шрифтом.
Применим перечисленные шаги на примере. Мы начнем с создания SWF-файла Fonts, swf, который встраивает шрифт Verdana (обычного и полужирного начертания) с помощью тега метаданных [Embed]. Рассмотрим код для основного класса приложения Fonts .swf:
package {
import flash.display.*;
import flash.text.*;
// Встраивает шрифты для использования в любом SWF-файле,
// загрузившем этот файл
public class Fonts extends Sprite {
[Embed(source="c;/windows/fonts/verdana.ttf",
fontFamily="Verdana")]
private var verdana;Cl ass;
[Embed(source="c;/windows/fonts/verdanab.ttf",
fontFamily="Verdana", fontWeight="bold")]
private var verdanaBold:Class;
} }
Теперь мы должны добавить наши встраиваемые шрифты в глобальный список шрифтов. Для этого мы используем статический метод registerFont ( ) класса Font, который принимает единственный параметр font. В качестве параметра font передается ссылка на класс Font, который представляет шрифт, добавляемый в глобальный список шрифтов. Как только шрифт будет добавлен, он может быть использован любым* SWF-файлом, выполняющимся в приложении Flash Player.
В предыдущем коде классы, представляющие две вариации шрифта Verdana, присваиваются переменным verdana и verdanaBold. Таким образом, чтобы добавить эти шрифты в глобальный список шрифтов, мы передаем значения этих переменных в метод registerFont ( ), как показано в следующем коде:
Font.registerFont(verdana);
Font.registerFont(verdanaBold);
Чтобы гарантировать, что шрифты будут добавлены в глобальный список шрифтов сразу после их загрузки, мы вызываем метод regi s ter Font ( ) внутри конструктора класса Fonts, как показано в следующем коде: package {
Import flash.display.*;
Import fl ash.text.*;
// Встраивает шрифты для дальнейшего использования любым SWF-файлом,
// загрузившим этот файл
public class Fonts extends Sprite {
[Embed(source-'c;/windows/fonts/verdana.ttf",
fontFam1ly="Verdana")]
private var verdana:Class;
[Embed(source="c:/w1ndows/fonts/verdanab.ttf",
fontFam1ly="\/erdana",
fontWe1ght="bold")]
private var verdanaBold;Class;
// Конструктор
public function Fonts ( ) {
// Регистрируем встроенные шрифты этого класса
// в глобальном списке шрифтов
Font.registerFont(verdana);
Font.registerFont(verdanaBold);
Если бы мы встраивали наши шрифты с помощью символов Font среды разработки Flash, нам бы пришлось добавить предыдущие вызовы метода regis terFont ( ) в первый кадр основной временной шкалы, а в метод registerFont ( ) мы бы передавали имя класса шрифта, указываемое в поле Class (Класс) окна Linkage Properties (Свойства связывания) для каждого встраиваемого символа Font (обратитесь к описанию шага 8 в подразд. «Встраивание начертаний шрифта в среде разработки Flash»).
После этого мы компилируем файл Fonts. swf и загружаем его на этапе выполнения с помощью класса Loader. Сразу после завершения загрузки файла Fonts. swf его шрифты могут быть использованы любым другим SWF-файлом, выполняющимся в приложении Flash Player. В листинге 27.15 представлен пример класса, который загружает и затем использует шрифты, встроенные в файл Fonts. swf.
Исчерпывающую информацию о загрузке SWF-файлов можно найти в гл. 28.
Листинг 27.15. Использование загруженных шрифтов
package {
Import flash.display.*;
Import fl ash.text.*;
import fl ash.events.*;
Import flash.net.*;
// Этот класс демонстрирует, как форматировать текст с помощью загруженных // шрифтов. Сами шрифты встроены в файл Fonts.swf, представленный ранее.
public class HeiloWorld extends Sprite {
public function Hell eWorld ( ) {
// Загружаем SWF-файл, содержащий встроенные шрифты
var loader;Loader = new Loader( );
loader.contentLoaderlnfo.addEventL1stener(Event.INIT, 1nitL1stener);
1oader.1oad(new URLRequest("Fonts.swf"));
}
// Выполняется после завершения инициализации файла Fonts.swf, когда
// его шрифты будут доступны для использования
private function 1n1tL1stener (e;Event):void {
// Для отладочных целей отображаем все доступные встроенные шрифты showEmbeddedFonts( );
// Шрифт был загружен, поэтому теперь отображаем
// отформатированный текст
outputMsg( );
}
// Отображаем текст, отформатированный с использованием
// встроенных шрифтов
private function outputMsg ( ):vo1d {
.// Создаем текстовое поле
var t:TextF1eld = new TextF1eld( );
t.embedFonts = true; // Говорим среде выполнения Flash отображать это // текстовое поле с помощью встроенных шрифтов
// Используем две вариации шрифта Verdana (обычного и полужирного
// начертания)
t.htmlText = "<FONT FACE='Verdana'>Hel1 о <b>world</b></FONT>";
// Добавляем текстовое поле в список отображения addChlld(t);
}
// Выводит список доступных на настоящий момент встроенных шрифтов
public function showEmbeddedFonts ( ):vo1d {
trace("========Embedded Fonts========");
var fonts-.Array = Font .enumerateFonts( );
fonts.sortOn("fontName", Array.CASEINSENSITIVE);
for (var 1:1nt = 0; 1 < fonts.length; 1++) {
trace(fonts[1].fontName + ", " + fonts[1].fontstyle);
}
}
Многие браузеры кэшируют SWF-файлы, поэтому для приложений, состоящих из нескольких SWF-файлов, можно добиться снижения общего времени загрузки, загружая шрифты из одного SWF-файла на этапе выполнения.
Отсутствующие шрифты и глифы
Как мы узнали ранее, если при отображении текстового поля с помощью шрифтов устройства шрифт для некоторого символа не установлен в операционной системе конечного пользователя, приложение Flash Player автоматически попросит ее отобразить символ с помощью подходящего замещающего шрифта.
В отличие от этого, если текстовое поле отображается с помощью встраиваемых шрифтов и шрифт для некоторого символа недоступен в списке встроенных шрифтов, приложение Flash Player сначала попытается отобразить этот символ с использованием любой доступной вариации указанного шрифта. Например, рассмотрим следующий код, который использует две вариации шрифта Verdana:
var t:TextField = new TextF1eld( );
t.embedFonts = true;
t.htmlText = "<FONT FACE='Verdana'>Hellо <b>world</b></FONT>"; .
Обратите внимание, что для слова «Hello» указана вариация шрифта Verdana обычного начертания, а для слова «world» указана вариация шрифта Verdana полужирного начертания. Если на этапе выполнения вариация встроенного шрифта Verdana полужирного начертания окажется недоступной, но при этом доступной окажется вариация встроенного шрифта Verdana обычного начертания, текст «Hello world» будет полностью отображен с использованием вариации шрифта Verdana обычного начертания. Однако если не будут доступны ни вариация обычного начертания, ни вариация полужирного начертания шрифта Verdana, символы не будут отображены вообще и никакой текст на экране не появится!
1^;1^;Если при использовании встраиваемых шрифтов текст в вашем приложении таинственным образом исчезает или отображается с помощью неправильной вариации шрифта, то, скорее всего, оказались недоступны необходимые шрифты. Чтобы определить, какие шрифты доступны на этапе выполнения, используйте статический метод enumerateFonts() класса Font, рассматриваемый в разд. «Определение доступности шрифта».
1^;
1^;
Если при использовании встраиваемых шрифтов текстовое поле содержит символ, глиф которого отсутствует в указанном шрифте, этот символ отображен не будет. В отличие от этого, если при использовании шрифтов устройства текстовое поле содержит символ, глиф которого отсутствует в указанном шрифте, приложение Flash Player автоматически выполнит поиск замещающего шрифта, содержащего отсутствующий глиф. Если такой шрифт будет найден, то символ будет отображен с помощью замещающего шрифта. Если замещающий шрифт найден не будет, то символ не будет отображен на экране.
Если переменной embedFonts объекта TextField присвоено значение true, но программа не предоставляет никакой информации по форматированию этого объ-
екта, Flash Player попытается отобразить его содержимое с помощью встроенного шрифта, имя которого совпадает с именем шрифта, используемого по умолчанию в текущей среде (в операционной системе Microsoft Windows таким шрифтом является Times New Roman). Если такого встроенного шрифта не существует, то текст не будет выведен на экран.
Определение доступности шрифта
Чтобы на этапе выполнения определить список доступных шрифтов устройства и встроенных шрифтов, используйте статический метод enumerateFonts ( ) класса Font. Метод enumerateFonts ( ) возвращает массив объектов Font, каждый из которых представляет доступный шрифт устройства или встроенный шрифт. Метод enumerateFonts ( ) определяет единственный параметр типа Boolean enumerateDeviceFonts, который указывает, должен ли возвращаемый массив включать шрифты устройства. По умолчанию параметру enumerateDeviceFonts присвоено значение false, поэтому массив, возвращаемый методом enumerateFonts ( ), не включает шрифты устройства. Каждый объект Font в возвращаемом массиве определяет следующие переменные, описывающие представляемый шрифт.
f ontName — имя шрифта. Для шрифтов устройства переменная f ontName содержит имя, которое отображается в списке системных шрифтов. Для шрифтов, встраиваемых через среду разработки Flash, переменная font Name содержит имя, которое отображается в списке Font (Шрифт) окна Font Symbol Properties (Свойства символа шрифта), применяемого для встраивания шрифта. Для шрифтов, встраиваемых с помощью тега метаданных [Embed], переменная fontName содержит строковое значение, которое указывается для параметра f ontFamily тега [Embed], применяемого для встраивания шрифта.
fontstyle — вариация шрифта (обычное начертание, полужирное начертание, курсив или полужирный курсив) в виде одной из четырех следующих констант языка ActionScript: Fontstyle . REGULAR, Fontstyle . BOLD, Fontstyle.ITALIC, Fontstyle.BOLD_ITALIC.
fontType — тип шрифта: встроенный или шрифт устройства. Эта переменная ссылается на одну из двух следующих констант языка ActionScript: FontType.EMBEDDED или FontType.DEVICE.
В листинге 27.16 представлен код, генерирующий список всех доступных встроенных шрифтов, отсортированных в алфавитном порядке.
Листинг 27.16. Перечисление всех встроенных шрифтов
var fonts:Array = Font.enumerateFonts( ):
fonts.sortOn("fontName". Array.CASE INSENSITIVE):
for (var 1:1nt = 0; 1 < fonts.length: 1++) {
trace(fonts[1].fontName + ". " + fonts[1].fontstyle): }
В листинге 27.17 продемонстрирован код, генерирующий список всех доступных шрифтов устройства, которые отсортированы в алфавитном порядке.
Листинг 27.17. Перечисление всех шрифтов устройства
var fonts:Array = Font.enumerateFonts(true):
fonts.sortOn("fontName", Array.CASEINSENSITIVE);
for (var 1:1nt = 0; 1 < fonts.length; 1++) {
1f (fonts[1].fontType == FontType.DEVICE) {
trace(fonts[1].fontName + ", " + fonts[1].fontstyle);
} }
В листинге 27.18 представлен код, генерирующий список всех доступных встроенных шрифтов и шрифтов устройства, отсортированных в алфавитном порядке.
Листинг 27.18. Перечисление всех встроенных шрифтов и шрифтов устройства
var fonts:Array = Font.enumerateFonts(true);
fonts.sortOn("fontName", Array.CASEINSENSITIVE);
for (var 1:1 nt = 0: 1 < fonts.length; 1++) {
trace(fonts[1].fontType + ": "
+ fonts[1].fontName + ", " + fonts[1].fontstyle): }
Функция enumerateFonts ( ) может быть использована, чтобы дать возможность пользователю выбирать шрифты приложения или автоматически выбирать резервный шрифт, как показано в листинге 27.19.
Листинг 27.19. Автоматический выбор резервного шрифта
package {
Import flash.display.*:
Import flash.text.*;
public class FontFallbackDemo extends Sprite { public function FontFallbackDemo ( ) {
var format-.TextFormat = new TextFormat( );
// Присваивает первый доступный шрифт
format.font = getFont(["ZapfChancery", "Verdana". "Arial", "_sans"]);
var t:TextF1eld = new TextF1eld( ):
t.text = "Act1onScr1pt 1s fun!";
t.autoSize = TextF1eldAutoS1ze.LEFT; t.setTextFormat(format)
addChlld(t);
}
// Из передаваемого списка шрифтов возвращает имя первого шрита
// в списке, который доступен либо в качестве встроенного шрифта, либо
// в качестве шрифта устройства
public function getFont (fontLIst: Array)-.String {
var ava1lableFonts:Array = Font.enumerateFonts(true);
for (var 1:1nt = 0; 1 < fontLIst.length; 1++) {
for (var j:1nt = 0; j < avallableFonts.length; j++) {
1f (fontListEiJ == Font(aval 1 ableFontsEj]).fontName) { return fontLIstEIJ:
}
}
}
return nul1;
Определение доступности глифа
Чтобы определить, имеет ли некий встроенный шрифт глиф для указанного символа или набора символов, мы используем метод экземпляра hasGlyphs ( ) класса Font. Принимая строковый аргумент, этот метод возвращает значение типа Boolean, которое указывает, имеет ли шрифт все глифы, необходимые для отображения данной строки.
Метод экземпляра hasGlyphs() класса Font работает только со встраиваемыми шрифтами. Не существует способа, позволяющего определить, имеет ли некий шрифт устройства глиф для указанного символа.
Чтобы воспользоваться методом hasGlyphs ( ), мы должны сначала получить ссылку на объект Font для интересующего нас шрифта. Для этого мы применяем цикл for, чтобы осуществить поиск в массиве, возвращаемом методом enumerateFonts ( ). Например, следующий код получает ссылку на объект Font для шрифта Verdana и присваивает ее переменной font:
var fontName:String = "Verdana": var font:Font:
var fonts:Array = Font.enumerateFonts(true):
for (var 1:1nt = 0; 1 < fonts.length; 1++) {
1f (fonts[1].fontName == fontName) {
font = fonts[1]: break:
}
}
Как только будет получена ссылка на желаемый объект Font, мы можем использовать метод hasGlyphs ( ), чтобы проверить, имеет ли соответствующий шрифт все глифы, необходимые для отображения некоторой строки. Например, следующий код проверяет, можно ли с помощью шрифта Verdana отобразить строку «Hello world» на английском языке:
trace(font.hasGlyphs("Hei 1 о world")): // Выводит: true
Следующий код проверяет, можно ли с помощью шрифта Verdana отобразить строку «А-ХийсЕАл CXulC^li» на японском языке:
trace(font.hasGlyphs(<^Xu&S Аа CA/ICSli)): // Выводит: false
Отображение текста с помощью встраиваемых шрифтов
Как бы удивительно это ни звучало, для объектов TextField, переменной embedFonts которых присвоено значение true, приложение Flash Player предоставляет два различных режима отображения текста. Названия этих режимов звучат достаточно размыто: обычный и расширенный.
В обычном режиме приложение Flash Player отображает текст с помощью стандартного визуализатора векторной графики, который применяется для отображения всех векторных фигур в SWF-файле. Стандартный визуализатор векторной графики рисует текст с использованием алгоритма сглаживания, который характеризуется высокой скоростью и создает гладкие линии. Текст, отображаемый с помощью стандартного визуализатора векторной графики, обычно получается четким и разборчивым при средних и больших размерах шрифта (приблизительно 16 пунктов и выше), однако при малых размерах шрифта (12 пунктов и меньше) текст оказывается размытым и неразборчивым.
В расширенном режиме приложение Flash Player выводит текст с помощью специализированного визуализатора текста, называемого визуализатором FlashType. Визуализатор FlashType — это лицензированная реализация системы Saffron Type System, созданной лабораторией Mitsubishi Electric Research Laboratories (MERE). Визуализатор FlashType специально разработан для того, чтобы обеспечивать четкую визуализацию типов фигур, которые часто встречаются в шрифтах небольших размеров.
В настоящее время наилучшие результаты при использовании визуализатора FlashType достигаются для западных шрифтов, нежели для азиатских. Тем не менее азиатский текст, отображаемый с помощью визуализатора FlashType, все равно оказывается более разборчивым, чем текст, отображаемый с помощью стандартного визуализатора векторной графики приложения Flash Player.
Текст, выводимый с помощью визуализатора FlashType, обычно получается более разборчивым, чем текст, выводимый с помощью стандартного визуализатора векторной графики приложения Flash Player. Кроме того, при небольших размерах шрифта визуализатор FlashType отображает текст быстрее, чем стандартный визуализатор векторной графики приложения Flash Player. Тем не менее при больших размерах шрифта отображение текста с помощью визуализатора FlashType занимает значительно больше времени, чем отображение текста с помощью стандартного визуализатора векторной графики приложения Flash Player.
Дополнительную информацию о системе Saffron Type System можно получить в официальном обзоре проекта Saffron компании Mitsubishi, доступном по адресу http://www. merl.com/projects/ADF-Saffron, а также в технической презентации проекта Saffron Рональда Перри (Ronald Perry), доступной по адресу http://www.merl.com/people/perry/ SaffronOverview.ppt.
Разработчики могут выбирать любой из двух режимов визуализации текста приложения Flash Player динамически на этапе выполнения для каждого текстового
поля по отдельности. Чтобы приложение Flash Player отображало некоторый объект Text Field с помощью стандартного визуализатора векторной графики, присвойте переменной antiAliasType данного объекта значение Ant iAliasType. NORMAL. Например, следующий код создает объект Text Field, азатем говорит приложению Flash Player отобразить этот объект с помощью встроенных шрифтов, используя стандартный визуализатор векторной графики. Обратите внимание, что помимо присваивания значения переменной antiAliasType этот код присваивает переменной embedFonts объекта TextField значение true. Режимы визуализации текста приложения Flash Player применяются только к тексту, отображаемому с помощью встраиваемых шрифтов.
// Создаем объект TextField var t;TextF1eld = new TextF1eld( );
// Говорим приложению Flash Player отобразить это текстовое поле
// с помощью встроенных шрифтов t.embedFonts = true;
// Говорим приложению Flash Player использовать стандартный визуализатор // векторной графики для отображения этого текстового поля
t.antiAliasType = AntiAliasType.NORMAL:
В отличие от этого, следующий код создает объект TextField, а затем говорит приложению Flash Player отобразить этот объект с помощью встроенных шрифтов, используя визуализатор FlashType:
// Создаем объект TextField
var t:TextF1eld = new TextF1eld( );
// Говорим приложению Flash Player отобразить это текстовое поле
// с помощью встроенных шрифтов t.embedFonts = true;
// Говорим приложению Flash Player использовать визуализатор FlashType
// для отображения этого текстового поля
t.antiAliasType = AntiAliasType.ADVANCED;
По умолчанию переменной antiAliasType присвоено такое значение, как AntiAliasType. NORMAL (стандартный визуализатор векторной графики).
По умолчанию приложение Flash Player отображает объекты TextField, переменной embedFonts которых присвоено значение true, с помощью стандартного визуализатора векторной графики.
На рис. 27.13 показан английский алфавит, для отображения которого с помощью шрифта Verdana размером 10 пунктов использовались оба визуализатора: визуализатор FlashType (слева) и стандартный визуализатор векторной графики (справа). На экране алфавит, отображенный с помощью визуализатора FlashType, в значительной степени более разборчив, чем алфавит, отображенный с помощью стандартного визуализатора векторной графики приложения Flash Player.
Для справки в листинге 27.20 показан код, который применялся для создания демонстрационных алфавитов, изображенных на рис. 27.13.
FlashType
Стандартный визуализатор векторной графики
a bed efg h ij kl m nopq rstuvwxyz
abcdefghijklmnopqrstuvwxyz
Рис. 27.13. Визуализатор FlashType в сравнении со стандартным визуализатором векторной графики приложения Flash Player
Листинг 27.20. Визуализатор FlashType в сравнении со стандартным визуализатором векторной графики приложения Flash Player
package {
Import flash.display.*;
Import flash.text.*;
public class FlashTypeDemo extends Sprite {
// Прямые слэши необходимы, однако регистр символов роли не играет.
[Embed(source="c:/w1ndows/fonts/verdana.ttf".
fontFamlly="Verdana")]
private var verdana:Class;
public function FlashTypeDemo ( ) {
// Визуализатор FlashType
var t:TextF1eld = new TextF1eld( );
t.width = 200;
t.embedFonts = true;
t.htmlText = "<FONT FACE='Verdana' SIZE='10,>"
+ "abcdefghljklmnopqrstuvwxyz</FONT>";
t.antiAliasType = AntiAliasType.ADVANCED;
addChild(t);
// Стандартный визуализатор векторной графики
var t2;TextF1eld = new TextF1eld( );
t2.width = 200;
t2.embedFonts = true;
t2.htmlText = "<FONT FACE='Verdana' SIZE='10'>"
+ "abcdefghljklmnopqrstuvwxyz</F0NT>";
t2.antiAliasType = AntiAliasType.NORMAL;
addChi1d(t2);
t2.x = 180;
}
Чтобы достичь наилучшего качества анимационного текста, используйте стандартный визуализатор векторной графики (присвойте переменной antiAliasType значение AntiAliasType. NORMAL). Чтобы добиться наилучшей разборчивости текста, используйте визуализатор FlashType (присвойте переменной antiAliasType значение AntiAliasType.ADVANCED).
Обратите внимание, что, если текст наклонен или перевернут, его отображение с помощью визуализатора FlashType автоматически отменяется.
Настройка визуализатора FlashType. Привлекательность и разборчивость текста — это весьма субъективные понятия. Язык ActionScript предлагает ряд расширенных инструментов для точной настройки конкретного поведения визуализатора FlashType.
Хотя детальное рассмотрение возможных настроек визуализатора FlashType выходит за рамки данной книги, для ознакомления в табл. 27.9 перечислены доступные инструменты и их основное назначение. Для дальнейшего изучения обратитесь к описанию каждого инструмента в справочнике по языку ActionScript корпорации Adobe.
Таблица 27.9. Переменные и методы, используемые для настройки параметров визуализатора FlashType
Переменная или метод
Описание
Переменная экземпляра sharpness класса TextField
Определяет резкость текста в текстовом поле. Может принимать целочисленные значения в диапазоне от -400 (размытый) до 400 (резкий)
Переменная экземпляра thickness класса TextField
Указывает толщину линий текста в текстовом поле. Может принимать целочисленные значения в диапазоне от -200 (тонкий) до 200 (толстый). Если переменной thickness поля присвоить большое значение, текст этого поля примет полужирное начертание
Переменная экземпляра gridFitType класса TextField
Определяет параметры хинтования на уровне пикселов, влияющие на разборчивость текста при различном выравнивании (по левому краю, по центру или по правому краю). Хинтование — это методика, с помощью которой ножки отображаемого глифа размещаются на целых пикселах, улучшая его читабельность
Статическая переменная displayMode класса TextRenderer
Настраивает алгоритм сглаживания визуализатора FlashType, улучшая результаты либо для ЖК-, либо для ЭЛТ-мониторов. Этот параметр применяется глобально ко всему тексту, отображаемому с помощью визуализатора FlashType
Статическая переменная maxlevel класса TextRenderer
Определяет уровень качества адаптивно выбираемых интервалов полей (Adaptively Sampled Distance Fields — ADFs) (часть внутренней структуры визуализатора FlashType для описания контуров глифов). Этот параметр применяется глобально ко всему тексту, отображаемому с помощью визуализатора FlashType (однако Flash Player автоматически увеличивает значение этого параметра для любого отдельного глифа, размер шрифта которого превышает 64 пиксела). Большие значения снижают производительность
Статический метод setAdv ancedAntiAliasingTable()
Присваивает значения, которые точно определяют вес и резкость конкретного шрифта при использовании указанного размера, стиля и типа цвета (светлый или темный)
Теперь перейдем от вопросов, связанных с форматированием и шрифтами, к вопросам получения данных через текстовые поля.
Ввод через текстовые поля
Текстовые поля могут получать разнообразные виды пользовательского ввода, включая ввод и выделение текста, активизацию гипертекстовой ссылки, фокус ввода с клавиатуры, прокрутку и взаимодействие с мышью. В этом разделе мы познакомимся
с вводом, выделением текста и гипертекстовыми ссылками. Информацию о фокусе ввода с клавиатуры, прокрутке и взаимодействию с мышью можно найти в гл. 22.
Ввод текста
Способность каждого текстового поля получать пользовательский ввод определяется значением переменной type этого поля. По умолчанию для текстовых полей, создаваемых с помощью кода на языке ActionScript, переменной экземпляра type присваивается значение TextFieldType. DYNAMIC — это значит, что текст может изменяться с помощью кода на языке ActionScript, при этом пользователь не может вносить изменения в текст. Чтобы текстовое поле могло получать пользовательский ввод, мы должны присвоить переменной type значение TextFieldType. INPUT, как показано в следующем коде:
var t:TextF1eld = new TextFieldC );
t.type = TextFieldType.INPUT;
Когда переменной type объекта TextField присвоено значение TextFieldType. INPUT, пользователь может добавлять или удалять текст из этого текстового поля. Любые изменения, вносимые пользователем, автоматически отражаются переменными text и htmlText.
Чтобы получать уведомления о внесении пользователем изменений в текстовое поле, мы можем зарегистрировать в этом текстовом поле приемники для событий TextEvent. TEXT_INPUT и Event. CHANGE. Диспетчеризация события TextEvent. TEXT_INPUT происходит в том случае, когда пользователь пытается изменить текст в текстовом поле, перед тем как будут обновлены значения переменных text и htmlText. Диспетчеризация события Event. CHANGE происходит после того, как в ответ на пользовательский ввод будут обновлены значения переменных text и htmlText. Подробную информацию по событиям TextEvent. TEXT_INPUT и Event. CHANGE можно найти в гл. 22.
По умолчанию пользователям не разрешается вводить разрывы строк в текстовые поля. Чтобы разрешить это (например, в результате нажатия клавиши Enter), присвойте переменной multiline значение true, как показано в следующем коде:
var t:TextF1eld = new TextF1eld( );
t.type = TextFieldType.INPUT; t.multiline = true;
Чтобы ограничить набор символов, которые пользователь может вводить в текстовое поле, используйте переменную экземпляра restrict класса TextField. Например, следующее текстовое поле позволяет вводить только цифры, что может потребоваться для поля ввода номера кредитной карты:
var t:TextField = new TextFieldC );
t.width = 200;
t.height = 20:
t.border= true;
t.background = true;
t.type = TextFieldType.INPUT;
t.restrict = "0-9";
Чтобы ограничить количество символов, которое пользователь может ввести в текстовое поле, используйте переменную экземпляра maxChars класса TextField. Например, следующее текстовое поле позволяет ввести только восемь символов, что может потребоваться для поля ввода имени на форме регистрации:
var t:TextF1eld = new TextF1eld( ): t.width = 100: t.height = 20: t.border = true: t.background = true:
t.type = TextFleldType.INPUT: t.maxChars = 8;
Для сокрытия всех вводимых символов с целью защиты экрана используйте переменную экземпляра displayAsPassword класса TextField. Когда переменной displayAsPas sword присвоено значение true, все символы отображаются в виде звездочек (*). Например, слова «hi there» отображаются в виде «********» Это позволяет пользователю вводить текст, не беспокоясь о том, что посторонний человек сможет его увидеть. Следующий код демонстрирует текстовое поле, которое скрывает символы, что может потребоваться для поля ввода пароля на форме регистрации: var t:TextF1eld = new TextF1eld( ): t.width = 100; t. height = 20; t.border = true: t. background = true:
t.type = TextFleldType.INPUT: t.displayAsPassword = true;
Форматирование пользовательского ввода. По умолчанию новый текст, вводимый пользователем, автоматически принимает форматирование символа, находящегося перед точкой вставки, или символа, находящегося в позиции 0, если новый текст добавляется перед этой позицией. Если поле было пустым, новый текст форматируется в соответствии с используемым по умолчанию форматом данного поля (который задается через переменную defaultTextFormat, как было рассмотрено ранее в разд. «Форматирование по умолчанию для текстовых полей» разд. «Форматирование текстовых полей»).
Чтобы переопределить автоматическое форматирование, применяемое к новому текстовому вводу, выполните такую последовательность действий.
Перехватите ввод с помощью события TextEvent. TEXT_INPUT.
Вручную добавьте эквивалентный текст.
Примените форматирование к тексту, вставленному вручную.
Эта методика продемонстрирована в листинге 27.21, представляющем пример класса FormattedlприtDemo. Понять код вам помогут комментарии.
Листинг 27.21. Форматирование пользовательского ввода package {
Import flash.display.*:
Import fl ash.text.*:
Import flash.events.*:
public class FormattedInputDemo extends Sprite {
public function FormattedlnputDemo ( ) {
// Создаем объекты TextFormat
var boldFormat:TextFormat = new TextFormatt ):
boldFormat.bold = true:
var 1tal1cFormat:TextFormat = new TextFormatt ): HaHcFormat. Italic = true:
// Создаем текстовое поле
var t:TextF1eld = new TextF1eld( ): t.text = "lunchtime":
// Форматируем слово "lunch" с использованием курсива t.setTextFormatdtallcFormat, 0, 5);
// Форматируем слово "time", используя полужирное начертание t.setTextFormat(boldFormat, 5. 9):
t.type = TextFIeldType.INPUT:
// Регистрируем приемник для событий TextEvent.TEXT_INPUT // в объекте t
t.addEventLIstener(TextEvent.TEXT_INPUT, textInputLIstener);
// Добавляем текстовое поле в список отображения addChlld(t):
// Вызывается всякий раз, когда пользователь пытается добавить
// новый текст в объект t
private function textlnputLIstener (e:TextEvent):void {
// Получаем ссылку на текстовое поле, получившее ввод var t:TextF1eld = TextF1eld(e.target):
// Предотвращаем добавление текста, введенного пользователем // в текстовое поле
е.preventDefault( ):
// Добавляем текст, введенный пользователем вручную. В этом случае // происходит немедленное обновление переменной text объекта // TextFi’eld, позволяя нам отформатировать новый текст внутри // данной функции.
t.replaceTextCt.caretlndex, t.caretindex, e.text):
// Устанавливаем форматирование для нового текста
var regularFormat-.TextFormat = new TextFormatC ):
regularFormat.bold = false:
regularFormat.ltallc = false: t.setTextFormat(regularFormat, t.caretindex, t.ca retIndex+e.text.1ength)
// Устанавливаем точку вставки в конец нового текста, чтобы // пользователь считал, что это он ввел текст
var newCaretIndex:1nt = t.caretindex + e.text.length; t.setSelect1on(newCaretIndex, newCaretlndex);
}
Выделение текста
По умолчанию текст во всех текстовых полях, создаваемых программным путем, может быть выделен пользователем. Чтобы отключить возможность выделения для некоторого поля, присвойте переменной selectable значение false. Обычно выделение текстового поля показывается только в том случае, когда данное поле имеет фокус. Чтобы выделение текстового поля отображалось даже в тех случаях, когда текстовое поле нс имеет фокуса, присвойте переменной alwaysShowSelection значение true. В приложении Flash Player 9 установить цвет выделения невозможно; поддержка настраиваемого цвета выделения может быть реализована в будущих версиях приложения Flash Player.
Чтобы определить индекс первого выделенного символа в текстовом поле, используйте переменную экземпляра selectionBeginlndex класса TextField. Для определения индекса последнего выделенного символа в текстовом поле применяйте переменную экземпляра selectionEndlndex класса TextField. Чтобы определить позицию точки вставки (курсора), используйте переменную экземпляра caret Index класса TextField. Чтобы программным путем выделить символы в текстовом поле или установить точку вставки, применяйте метод экземпляра setselection ( ) класса TextField.
Стоит отметить, что в приложении Flash Player отсутствуют события, обозначающие изменение выделения текстового поля. Чтобы выявить изменения в выделении поля, периодически проверяйте значения переменных selectionBeginlndex иselectionEndlndex.
Чтобы заменить текущее выделение новым текстом, что может потребоваться в приложении с возможностью редактирования слов в стиле текстового процессора, используйте метод экземпляра replaceSelectedText ( ) класса TextField. Стоит отметить, однако, что метод replaceSelectedText ( ) работает только в тех случаях, когда текстовое поле имеет фокус или когда переменной always ShowSelec t ion присвоено значение true. Метод replaceSelectedText ( ) представляет собой удобную версию метода replaceText ( ), который был рассмотрен ранее в разд. «Изменение содержимого текстового поля». Метод replaceSelectedText ( ) работает точно так же, как и метод replaceText ( ), за исключением того, что он автоматически устанавливает значения параметров индексНачала и индексКонца в соответствии с текущим выделением.
Гипертекстовые ссылки
Чтобы добавить гипертекстовую ссылку в поле, мы используем переменную экземпляра url класса TextFormat или тег <А> языка HTML. Обычно гипертекстовые ссылки используются для открытия конкретных ресурсов, находящихся
по указываемым URL-адресам. Например, следующий код создает текстовое поле, содержащее гипертекстовую ссылку, при активизации которой приложение Flash Player открывает сайт издательства O’Reilly в браузере, используемом в операционной системе по умолчанию.
var t:TextF1eld = new TextF1eld( );
t.htmlText = "To visit O'Reilly's web site. "
+ "<a href='http://www.oreilly.com'>click here</a>";
t.autoSize = TextFieldAutoSize.LEFT;
Кроме того, гипертекстовые ссылки могут использоваться для выполнения кода на языке ActionScript. Подробную информацию можно найти в подразд. «Событие TextEvent.LINK» разд. «События текстового ввода» гл. 22.
Мы почти рассмотрели вопросы, касающиеся текстовых полей. Однако перед тем, как перейти к следующей главе, кратко познакомимся с представлением текстовых полей, создаваемых вручную в среде разработки Flash, в языке ActionScript.
Текстовые поля и среда разработки Flash
В среде разработки Flash текстовые поля могут создаваться вручную с помощью инструмента Text (Текст). На этапе разработки каждое создаваемое вручную поле может иметь один из трех видов: статический, динамический или вводимый текст. На этапе выполнения каждое создаваемое вручную текстовое поле в коде на языке ActionScript представляется объектом, который соответствует типу поля, указываемому на этапе разработки.
Текстовые поля вида «статический текст» представляются экземплярами класса StaticText. Поля вида «динамический текст» представляются экземплярами класса TextField, переменной type которых присвоено значение TextFieldType . DYNAMIC. Текстовые поля вида «вводимый текст» представляются экземплярами класса TextField, переменной type которых присвоено значение TextFieldType. INPUT.
Текстовое содержимое текстовых полей вида «статический текст» может быть прочитано на этапе выполнения из кода на языке ActionScript, однако оно не может быть изменено. В отличие от этого, текстовое содержимое текстовых полей вида «динамический текст» или «вводимый текст» может быть не только прочитано, но и изменено. Таким образом, авторы, применяющие среду разработки Flash, должны применять поля вида «статический текст» в том случае, когда содержимое текстового поля не должно изменяться на этапе выполнения. Для создания текстовых полей, содержимое которых может быть изменено на этапе выполнения, авторы, использующие среду разработки Flash, должны применять виды «динамический текст» или «вводимый текст».
Чтобы получить доступ ко всему тексту во всех статических текстовых полях некоторого экземпляра класса DisplayObjectContainer, используйте класс Text Snapshot (основное назначение которого заключается в предоставлении возможности выделения текста в нескольких отдельных объектах StaticText).
Текстовые поля вида «статический текст» не могут создаваться с помощью кода на языке ActionScript; классы StaticText и TextSnapshot существуют исключительно для предоставления программного доступа к этим полям, создаваемым в среде разработки Flash.
Точно так же, как программисты на языке ActionScript могут устанавливать параметры отображения текста на этапе выполнения, авторы, использующие среду разработки Flash, могут использовать палитру Properties (Свойства) для выбора режима отображения текстовых полей на этапе компиляции. Параметры отображения, предоставляемые средой разработки Flash (и их эквиваленты в языке ActionScript), перечислены в табл. 27.10.
Таблица 27.10. Параметры отображения текста, предоставляемые средой разработки Flash
Значение на палитре Properties (Свойства)
Описание
Эквивалент в языке ActionScript
Use device fonts (Использовать шрифты устройства)
Полагаемся на локальную среду воспроизведения для отображения текста с помощью шрифтов, установленных в системе конечного • пользователя
Присвоить переменной embedFonts значение false
Bitmap text (no anti-alias) (Растровый текст (без сглаживания))
Когда выбран вид Bitmap text (Растровый текст), компилятор выравнивает фигуры по целым пикселам при вычислении контуров глифов (поэтому шрифт не выглядит сглаженным). На этапе выполнения эти контуры глифов отображаются с помощью встроенного визуализатора векторной графики приложения Flash Player, а не визуализатора FlashType
Встроить шрифт, установив флажок Bitmap text (Растровый текст) в среде разработки Flash, а затем присвоить переменной embedFonts значение false. Недоступно, если компиляция выполняется с помощью приложения Flex Builder 2 или компилятора mxmlc
Anti-alias for animation (Сглаживание для анимации)
Отображает текст с помощью стандартного визуализатора векторной графики приложения Flash Player
Присвоить переменной antiAliasType значение AntiAliasType. NORMAL
Anti-alias for readability (Сглаживание для читабельности)
Выводит текст с помощью визуализатора FlashType, используя параметры по умолчанию
Присвоить переменной antiAliasType значение AntiAliasType.ADVANCED
Custom anti-alias (Настраиваемое сглаживание)
Отображает текст с помощью визуализатора FlashType, используя настраиваемые параметры
Присвоить переменной antiAliasType значение AntiAliasType.ADVANCED и определить настраиваемые параметры, используя методики, которые были рассмотрены ранее в разд. «Отображение текста с помощью встраиваемых шрифтов»
Загрузка... Пожалуйста, подождите...
На протяжении последних восьми глав мы рассмотрели множество вопросов, касающихся создания и управления визуальным содержимым с помощью API отображения. В следующей главе мы завершим изучение экранного программирования, познакомившись с инструментами языка ActionScript для загрузки внешних отображаемых элементов.
Загрузка внешних отображаемых элементов
В ActionScript существует три способа добавления внешнего отображаемого элемента в приложение программным путем:
использование класса flash .display. Loader для загрузки элемента на этапе выполнения;
применение класса flash . net. Socket совместно с методом экземпляра loadBytes ( ) класса Loader для загрузки элемента на этапе выполнения через открытый сокет TCP/IP;
использование тега метаданных [Embed] для встраивания элемента, находящегося в локальной файловой системе, на этапе компиляции.
Классы Loader и Socket являются собственными классами API среды выполнения Flash, в то время как для использования тега метаданных [Embed] требуется платформа разработки Flex. Все три подхода поддерживают следующие форматы отображаемых элементов:
SWF (скомпилированные приложения Flash);
JPEG, GIF или PNG (растровые изображения).
Кроме того, тег метаданных [Embed] поддерживает отображаемые элементы в формате SVG.
Й
Класс Loader заменяет следующие инструменты языка ActionScript 2.0, предназначенные для загрузки элементов: класс MovieClipLoader; глобальные функции loadMovie() и loadMovieNum(); методы экземпляра loadMovie() и loadMovieNum() класса MovieClip.
В этой главе будет рассказано, как использовать классы Loader и Socket, а также тег метаданных [ Embed ] для загрузки внешних отображаемых элементов. Подробную информацию о загрузке шрифтов вы сможете найти в гл. 27. Сведения о загрузке содержимого XML можно найти в гл. 18. Кроме того, информацию о загрузке других неотображаемых элементов, например переменных, бинарных данных или звуковых файлов, можно найти в описании классов URLLoader, URLStream и Sound в справочнике по языку ActionScript корпорации Adobe.
Использование класса Loader для загрузки отображаемых элементов на этапе выполнении
Класс Loader применяется для загрузки внешних отображаемых элементов на этапе выполнения. Элемент может быть получен либо по протоколу HTTP, либо из локальной файловой системы. Чтобы воспользоваться классом Loader, необходимо выполнить три основных шага.
Создать экземпляр класса flash. display. Loader.
Создать экземпляр класса flash. net. URLRequest, определяющий местоположение элемента.
Передать экземпляр класса URLRequest в метод load ( ) класса Loader.
В следующих разделах мы создадим пример класса Sunsetviewer, в котором подробно рассматриваются описанные шаги. Класс из нашего примера будет загружать единственное растровое изображение sunset. j pg. Освоив базовые положения загрузки элементов, вы узнаете, как отслеживать ход выполнения операции загрузки с помощью класса flash. display. Loader Inf о. Наконец, мы рассмотрим код, необходимый для обращения к загруженному элементу и его добавления в список отображения.
Операции загрузки подчиняются ограничениям безопасности приложения Flash Player. Полную информацию можно получить в гл. 19.
В классе Sunsetviewer нашего примера мы предполагаем, что SWF-файл приложения Sunsetviewer. swf будет размещен на сайте в той же директории, где находится загружаемое изображение sunset. j pg.
Создание экземпляра класса Loader
Как мы уже знаем, первым шагом в загрузке любого отображаемого элемента на этапе выполнения с помощью класса Loader является создание экземпляра класса Loader. Этот экземпляр управляет операцией загрузки и предоставляет доступ к загруженному элементу. Мы создадим наш экземпляр класса Loader в методе-конструкторе класса Sunsetviewer и присвоим его переменной экземпляра loader, как показано в листинге 28.1.
Листинг 28.1. Создание экземпляра класса Loader
Package {
Import flash.display.*;
public class Sunsetviewer extends Sprite {
private van loader:Loader;
public function Sunsetviewer ( ) {
loader = new Loader( ); // Создаем экземпляр класса Loader }
Определение местоположения элемента
Чтобы загрузить внешний отображаемый элемент с помощью экземпляра класса Loader, мы должны указать местоположение этого элемента с помощью объекта flash. net. URLRequest. Каждый отдельный объект URLRequest описывает местоположение одного внешнего ресурса, находящегося либо в сети, либо в локальной файловой системе. Чтобы создать объект URLRequest, который определяет местоположение элемента, используйте следующий обобщенный код, присваивающий местоположение элемента переменной экземпляра url:
var urlRequest:URLRequest = new URLRequest( ): urlRequest.url = "адресиРкЭлемента":
Кроме того, местоположение элемента может быть передано в качестве параметра конструктору класса URLRequest, как показано в следующем коде:
var url:URLRequest = new URLRequest("адресиРкЭлемента"):
В обоих случаях адресиРкЭлемента — это строка, содержащая стандартный адрес URL. Например:
new URLRequest("http://www.examp1e.com/1 mage.jpg");
Набор сетевых протоколов, которые допускается использовать в строке адресиРкЭлемента, зависит от операционной системы. Например, протоколы http: / /, https: / / и f tp: / / поддерживаются всеми операционными системами Windows, Macintosh и UNIX, однако обращение к содержимому справки Windows (ms-its:) может поддерживаться только в операционной системе Windows. Из соображений безопасности приложение Flash Player может также блокировать некоторые протоколы. Тем не менее в настоящее время корпорация Adobe не публикует список блокируемых протоколов. Более того, среда выполнения Flash не генерирует никаких сообщений об ошибках безопасности, относящихся конкретно к блокированию протокола. По этой причине при работе с редко используемыми протоколами не забывайте, что операции загрузки с применением таких протоколов могут потерпеть неудачу, не вызвав никаких ошибок.
Помимо определения адреса URL, каждый объект URLRequest может также предоставлять дополнительную информацию для запрашиваемого по НТТР-протоко- лу ресурса. Чтобы указать заголовок HTTP-запроса, используемый метод, данные для метода POST, строку запроса и тип содержимого MIME, просто установите соответствующие переменные объекта URLRequest, как описано в справочнике по языку ActionScript корпорации Adobe. Например, чтобы определить заголовки HTTP-запроса, установите переменную экземпляра requestHeaders класса URLRequest.
Местоположение элемента может быть указано в виде абсолютного или относительного URL-адреса. Однако стоит отметить, что система приложения Flash Player, отвечающая за разрешение относительных адресов URL, зависит от способа запуска приложения Flash Player.
Если приложение Flash Player запускается с целью отображения SWF-файла, встроенного в веб-страницу с помощью тега <0В JECT> или <EMBED>, все от-
носительные адреса URL разрешаются относительно этой веб-страницы, а не относительно какого-либо SWF-файла. Более того, если веб-страница была открыта локально* относительные адреса URL разрешаются локально. Если веб-страница была открыта с сайта, относительные адреса URL разрешаются с использованием адреса этого сайта.
Когда приложение Flash Player запускается как автономное приложение или в результате непосредственного открытия SWF-файла в браузере, поддерживающем формат Flash, все относительные адреса URL разрешаются относительно первого SWF-файла, открытого в приложении Flash Player, — этот файл называется владельцем сцены. Более того, если владелец сцены был открыт локально, относительные адреса URL разрешаются локально; если владелец сцены был открыт с сайта, относительные адреса URL разрешаются с использованием адреса этого сайта.
Даже если первый SWF-файл, открытый в приложении Flash Player, будет удален со сцены, он останется владельцем сцены и по-прежнему будет оказывать влияние на разрешение относительных URL-адресов.
Рассмотрим пример с использованием относительных адресов URL, который демонстрирует две описанные системы разрешения. Предположим, что мы встроили приложение Sunsetviewer. swf в веб-страницу Sunsetviewer. html и сохранили эти два файла в следующих отдельных директориях:
Zviewer/SunsetViewer.html
Zv1ewer/assets/SunsetV1ewer.swf
Предположим также, что из приложения Sunsetviewer.swf мы хотим загрузить изображение sunset .jpg, которое тоже находится в директории /assets/:
Zviewer/assets/sunset.jpg
Если мы считаем, что пользователь будет запускать приложение Sunsetviewer.swf, открывая веб-страницу SunsetViewer.html, мы должны сформировать наш относительный URL-адрес относительно данной веб-страницы, как показано в следующей строке кода:
new URLRequestC'assetsZsunset.jpg");
Тем не менее, если мы считаем, что пользователь будет запускать приложение, непосредственно открывая файл Sunsetviewer. swf, мы должны сформировать наш относительный URL-адрес относительно SWF-файла, а не веб-страницы, как показано в следующей строке кода:
new URLRequest("sunset.jpg");
При распространении содержимого, воспроизводимого в приложении Flash Player, формируйте все относительные адреса URL в соответствии с тем, как ваши пользователи будут запускать приложение Flash Player.
Даже если один SWF-файл загружает другой SWF-файл, который, в свою очередь, загружает внешние элементы, относительные адреса URL все равно разрешаются
либо относительно владельца сцены (в случае непосредственного запуска), либо относительно веб-страницы, содержащей встроенное приложение Flash Player (в случае открытия страницы).
Предположим, что мы открываем гипотетическое приложение SlideShow. swf непосредственно в приложении Flash Player. Кроме того, предположим, что приложение SlideShow. swf загружает приложение Sunsetviewer. swf из предыдущего примера. В данном случае все относительные URL-адреса в приложении Sunsetviewer. swf должны быть сформированы относительно файла SlideShow. swf (обратитевнимание: не относительно приложения Sunsetviewer. swf!). Подобным образом, если бы приложение SlideShow. swf открывалось через веб-страницу, все относительные адреса URL в приложении Sunsetviewer. swf должны были быть сформированы относительно данной страницы.
Вы можете полностью избежать проблем, связанных с различными вариантами разрешения относительных адресов URL, сохранив все HTML-, SWF-файлы и файлы внешних отображаемых элементов в одной директории.
Вернемся к нашему примеру класса Sunsetviewer. Ранее в листинге 28.1 мы создали экземпляр класса Loader. В листинге 28.2 представлен обновленный класс Sunsetviewer, в который был добавлен код, создающий запрос для относительного URL-адреса "sunset .jpg". Как было отмечено ранее, для упрощения нашего примера мы предполагаем, что файлы sunset. jpg и Sunsetviewer. swf находятся в одной директории — это позволяет избежать любых сложностей, связанных с разрешением относительных адресов URL.
Листинг 28.2. Определение местоположения элемента
package {
Import flash.display.*:'
import fl ash.net.URLRequest: // Импортируем класс URLRequest
public class Sunsetviewer extends Sprite {
private var loader:Loader:
public function Sunsetviewer ( ) {
loader = new Loader( ):
// Определяем местоположение элемента в виде "sunset.jpg" var urlRequest:URLRequest = new URLRequest("sunset.jpg"):
}
}
}
Теперь, когда мы определили местоположение файла sunset .jpg, загрузим его.
Начало загрузки
До настоящего момента мы уже создали объекты Loader и URLRequest. Теперь соединим их, чтобы загрузить элемент. Чтобы начать загрузку, мы передаем наш экземпляр класса URLRequest в метод load ( ) экземпляра класса Loader, как показано в листинге 28.3.
Листинг 28.3. Начало загрузки
package {
Import flash.display.*;
Import fl ash.net.URLRequest;
public class Sunsetviewer extends Sprite { private var loader:Loader;
public function Sunsetviewer ( ) {
loader = new Loader( ):
var url:URLRequest = new URLRequest("sunset.jpg");
// Начинаем загрузку loader.load(url);
}'
}
}
Итак, вот основной код, необходимый для загрузки внешнего отображаемого элемента на этапе выполнения:
var loader-.Loader = new Loader( );*
var url:URLRequest = new URUtequesUnaflpeck^U^ ;
loader.load(url);
Здесь адресиРкЭлемента — это местоположение загружаемого элемента. Кроме того, допустимо и достаточно распространено объединять вторую и третью строки из предыдущего кода в одну, как показано в следующем коде:
var loader:Loader = new Loader( );
1oader.1oad(new URLRequest("адресОРкэлемента" У;
Чтобы отменить выполняемую операцию загрузки, используйте метод экземпляра close() класса Loader.
После начала загрузки элемента мы в конечном итоге захотим обратиться к этому элементу и отобразить его на экране. Эти вопросы рассматриваются в двух следующих разделах.
Обращение к загруженному элементу
Благополучно обратиться к загруженному элементу можно только после того, как среда выполнения Flash проведет его инициализацию. На этапе инициализации среда выполнения Flash создает экземпляр элемента, добавляет его в объект Loader, загрузивший этот элемент, и выполняет любые задачи, необходимые для подготовки элемента к использованию.
Этап процесса инициализации, на котором создается экземпляр, отличается для разных типов элементов.
Для растровых изображений экземпляр создается в тот момент, когда загрузка внешнего файла полностью завершена. Тогда загруженные пиксельные данные автоматически помещаются в объект BitmapData, который связывается
с новым объектом Bitmap. Загруженное изображение представляется объектом Bitmap.
Для SWF-файлов экземпляр создается в тот момент, когда получены все элементы и классы для кадра 1 (включая основной класс SWF-файла). Тогда среда выполнения Flash создает экземпляр основного класса SWF-файла и выполняет его конструктор. Загруженный SWF-файл представляется экземпляром основного класса.
Для простоты в дальнейшем материале мы будем называть созданный экземпляр (либо объект Bitmap, либо экземпляр основного класса SWF-файла) объектом элемента.
После создания экземпляра загруженного элемента объект элемента автоматически добавляется в объект Loader. Объект элемента является первым и единственным возможным ребенком объекта Loader. Если элементом оказывается SWF-файл, то любой код, находящийся в первом кадре этого файла, выполняется сразу после добавления экземпляра его основного класса в объект Loader.
После того как объект элемента будет добавлен в объект Loader и процесс инициализации будет завершен, среда Flash выполнит диспетчеризацию события Event. INIT. Когда возникает событие Event. INIT, загруженный элемент считается готовым к использованию. Любой код, которому необходим доступ к загруженному элементу, должен выполняться только после возникновения события Event. INIT.
Не пытайтесь обращаться к загружаемому элементу до возникновения события Event. INIT.
Приемники, которые желают получать уведомления о возникновении события Event. INIT, должны быть зарегистрированы в объекте Loaderlnf о объекта элемента, а не в объекте Loader, над которым изначально был вызван метод load ( ). Объект Loaderinfo — это отдельный объект, который представляет информацию о загруженном элементе. Любой экземпляр класса Loader предоставляет ссылку на объект Loaderinfo своего загружаемого элемента через переменную экземпляра contentLoaderlnfo. Таким образом, чтобы зарегистрировать приемник события для события Event. INIT некоторого элемента, мы используем следующий обобщенный код:
o6beKiLoader.contentLoaderlnfo.addEventLIstenerCEvent. INIT. приемникСобытия^1Т);
Здесь odbeKTLoader — это объект Loader, загружающий элемент, а приемникСобы- tmINIT — ссылка на функцию, которая будет обрабатывать событие Event. INIT. После возникновения события Event. INIT благополучно обратиться к загруженному элементу можно через переменную content или метод getChildAt ( ) класса Loader, как показано ниже:
объектЬоабег.content
o6beKiLoader.getChi1dAt(0)
Обратите внимание на значение 0 в выражении getChildAt (0). Элемент является единственным ребенком объекта Loader, поэтому он находится на глубине с индексом 0.
Следующий код демонстрирует приемник события Event. INIT, который устанавливает позицию загруженного и проинициализированного элемента. Для демонстрации двух различных способов обращения к загруженному элементу этот код устанавливает горизонтальную позицию с помощью переменной content, а вертикальную позицию — с использованием выражения getChildAt (0).
private function 1n1tL1stener (e:Event):void {
o6beKTloader.content.x = 50;
обьектСоас/ег. getCMl dAt (0) .y = 75;
}
В качестве альтернативы обратиться к загруженному элементу можно через объект Event, передаваемый в функцию-приемник события Event. INIT. Этот объект определяет переменную target, которая ссылается на объект Loaderinfo элемента. Каждый объект Loader Inf о ссылается на свой соответствующий элемент через переменную экземпляра content. Таким образом, внутри функции-приемника события Event. INIT ссылка на загруженный элемент может быть получена с помощью выражения oObeKTEvent. target. content. Например, следующий код устанавливает горизонтальной позиции загруженного элемента значение 100:
private function 1n1tL1stener (e;Event):void {
e.target.content.x = 100;
}
При обращении к загруженным элементам следует помнить, что, поскольку элемент не добавляется в свой объект Loader до тех пор, пока процесс загрузки данного элемента не будет успешно завершен, вызов метода oObeKiLoader. get Ch 11 dAt (0) до начала операции загрузки приведет к ошибке.
а
Напомним, что элемент растрового изображения не добавляется в свой объект Loader до тех пор, пока не будет полностью загружен внешний файл. Элемент SWF-файла не добавляется в свой объект Loader до тех пор, пока не будут получены все элементы и классы для первого кадра, включая основной класс SWF-файла.
Более того, перед началом загрузки переменная content содержит значение null. Это демонстрирует следующий код:
// Начинаем загрузку
var loader:Loader = new Loader( );
1oader.1oad(new URLRequest("sunset.jpg"));
// Сразу же пытаемся обратиться к загружаемому элементу.
// не дожидаясь завершения загрузки
trace(1oader.getChl1dAt(0)); // RangeError; Ошибка #2006:
// The supplied Index 1s out of bounds.
// (Указанный индекс выходит за пределы.) trace(loader.content);// Выводит: null
Даже если операция загрузки началась, но элемент не был успешно загружен, обращение к переменной content или вызов метода getChildAt (0) приведет к следующей ошибке:
Error: Error #2099: The loading object 1s not sufficiently loaded
to provide this Information.
На русском языке она будет выглядеть так: Загружаемый объект не был успешно загружен для предоставления данной информации.
Снова повторим: не пытайтесь обращаться к загружаемому элементу до момента возникновения события Event. INI Т. На самом деле обратное также верно: перед тем как обратиться к родительскому объекту Loader, код в основном классе загруженного SWF-файла должен дождаться возникновения события Event. INIT. В частности, код в конструкторе основного класса загруженного SWF-файла не имеет доступа к родительскому объекту Loader. С другой стороны, код, помещенный в первый кадр временной шкалы загруженного SWF-файла (в среде разработки Flash), может обращаться к родительскому объекту Loader (до возникновения события Event. INIT).
Воспользуемся новыми знаниями по обращению к элементам на примере класса Sunsetviewer. В листинге 28.4 показано, как обращаться к загруженному файлу sunset. jpg из функции-приемника события Event. INIT. Эта функция отображает высоту, ширину и угол поворота загруженного изображения с помощью методик обращения к элементу, рассмотренных в данном разделе.
Листинг 28.4. Обращение к загруженному элементу
package {
import flash.display.*;
import flash.net.URLRequest;
import flash.events.*;
public class Sunsetviewer extends Sprite { private var loader:Loader;
public function Sunsetviewer ( ) {
loader = new Loader( );
// Регистрируем приемник для события Event.INIT
1oader.contentLoaderlnfo.addEventListener(Event.INIT, 1nitListener);
var urlRequest:URLRequest = new URLRequestC"sunset,jpg");
loader.load(urlRequest);
// Приемник вызывается при возникновении события Event.INIT private function initListener (e:Event):void {
// Обращаемся к элементу тремя различными способами
trace(1oader.content.width);
trace(1 odder.getChi1 dAt (0). height);
trace(e.target.content.rotation);
Чтобы для загруженного элемента использовать методы и переменные класса Bitmap, MovieClip или основного класса SWF-файла, следуйте методикам, описанным далее в разд. «Проверка типов на этапе компиляции для динамически загружаемых элементов».
Отображение загруженного элемента на экране
Как только элемент будет готов к использованию, он также будет готов к добавлению в список отображения для дальнейшего вывода на экран. Чтобы добавить загруженный элемент в список отображения, мы используем метод экземпляра addChild( ) класса DisplayObj ectContainer, как и при добавлении любого другого отображаемого объекта в список отображения. В листинге 28.5 представлен код, который добавляет объект Bitmap, представляющий файл sunset. j pg, в основной класс приложения Sunsetviewer.
Листинг 28.5. Добавление элемента в список отображения
package {
import flash.display
Import flash.net.URLRequest:
Import flash.events.*;
public class Sunsetviewer extends Sprite {
private var loader:Loader:
public function Sunsetviewer ( ) {
loader = new Loader( );
loader.contentLoaderlnfo.addEventL1stener(Event.INIT. initListener);
var urlRequest:URLRequest = new URLRequest("sunset.jpg"); loader.1oad(urlRequest);
}
private function InitListener (e:Event):void {
addChild(loader,content); // Добавляем объект Bitmap // в объект Sunsetviewer
}
}
}
Как показано в листинге 28.5, добавление объекта загруженного элемента в новый объект DisplayObjectContainer автоматически приводит к удалению этого элемента из его исходного родительского объекта Loader. В качестве примера добавим новый код в метод initListener ( ) из листинга 28.5. Этот код проверяет, сколько дочерних объектов имеет объект loader до и после добавления загруженного элемента (sunset, jpg) в объект Sunsetviewer. Обратите внимание, что после перемещения элемента объект loader не имеет дочерних отображаемых объектов.
private function InitListener (e:Event):void {
trace(loader.numChlldren): // Выводит: 1 (единственным ребенком •// является элемент)
addCh11d(1oader.content);
trace(loader.numChildren): // Выводит: 0 (поскольку элемент был // перемещен)
}
Альтернативная методика вывода загруженного элемента на экран заключается в добавлении в список отображения объекта Loader этого элемента, а не объекта элемента.
Класс Loader сам по себе является потомком класса Displayobject, поэтому он непосредственно может быть добавлен в любой объект DisplayObj ectContainer. Снова модифицируем метод initListener ( ) из листинга 28.5. На этот раз мы добавим объект loader непосредственно в объект Sunsetviewer. В результате этой операции мы неявно делаем объект Bitmap, представляющий файл sunset. jpg, правнуком объекта Sunsetviewer.
private function InitListener (e:Event):void {
addChl1d(1oader); // Добавляем объект loader и его дочерний элемент // в список отображения
}
Объект Loader фактически может быть добавлен в список отображения до начала операции загрузки. Когда операция загрузки отображаемого элемента будет завершена, этот элемент автоматически добавится в объект Loader и, как следствие, в список отображения. Данная методика продемонстрирована в листинге 28.6. Код из этого листинга добавляет объект loader в список отображения до начала операции загрузки файла sunset.jpg. После того как экземпляр файла sunset.jpg будет создан и проинициализирован, он будет добавлен в объект loader и, поскольку объект loader уже находится в списке отображения, появится на экране. Таким образом, нет надобности в приемнике события Event. INIT.
Листинг 28.6. Добавление объекта Loader в список отображения
package {
Import flash.display.*;
Import flash.net.URLRequest;
public class Sunsetviewer extends Sprite { private var loader:Loader;
public function Sunsetviewer ( ) {
loader = new Loader( );
addChild(loader);
var urlRequest:URLRequest = new URLRequestt"sunset,jpg");
loader.loadturlRequest):
}
}
}
Следовательно, самый простой из возможных способов загрузить отображаемый элемент и отобразить его на экране можно представить следующим кодом:
var loader:Loader = new Loader( );
addChl1d(1oader):
1oader.1oad(new URLRequest(адресиРкЭлемента));
Три предыдущие строки кода подходят для многих простых ситуаций, однако в тех случаях, когда управление загруженным элементом должно осуществляться независимо от его объекта Loader или когда длительность паузы перед отображением загруженного элемента должна определяться вручную, более подходящим является код, который был представлен ранее в листинге 28.5.
Мы уже знаем, как загружать и отображать внешний элемент, но зачастую в процессе загрузки элемента между этими двумя операциями существует заметная задержка. Далее мы рассмотрим, как использовать класс Loaderinfo для отображения хода выполнения операции загрузки.
Отображение хода загрузки
Чтобы отобразить ход загрузки элемента, мы должны выполнить четыре следующих обобщенных шага.
Перед загрузкой элемента создать графический индикатор хода загрузки (например, текстовое поле или «индикатор загрузки»).
После начала загрузки добавить индикатор хода выполнения в список отображения.
По мере загрузки элемента обновлять состояние индикатора хода выполнения (по большому счету, это делается для удобства пользователя).
Когда загрузка будет завершена, удалить индикатор хода выполнения с экрана. Посмотрим, как применить описанные шаги на практике, добавив простой индикатор хода выполнения, который реализован на базе текстового поля, в наш класс Sunsetviewer.
Начнем с создания в классе Sunsetviewer новой переменной экземпляра progressoutput, которая ссылается на обычный объект TextField. Текстовое поле progressoutput будет отображать информацию о ходе загрузки.
private var progressoutput:TextFIeld;
Далее мы создадим в классе Sunsetviewer два новых метода: createPro gresslndicator ( ) и load ( ). Первый метод создает объект TextField progressoutput. Мы будем вызывать метод createProgressIndicator ( ) из конструктора класса Sunsetviewer. Рассмотрим этот код:
private function createProgressIndicator ( ):void {
progressoutput = new TextFieldC );
progressOutput.autoSize = TextFieldAutoSize.LEFT;
progressOutput.border = true:
progressOutput.background = true;
progressOutput.selectable = false;
progressOutput.text = "LOADING...";
Второй метод добавляет объект progressoutput в список отображения и начинает загрузку элемента. Всякий раз, когда с помощью метода load ( ) инициируется загрузка, объект progressoutput помещается на экран; всякий раз, когда загрузка завершается, объект progressoutput удаляется с экрана. Данная архитектура позволяет классу Sunsetviewer повторно использовать один и тот же объект TextField для отображения информации о ходе загрузки. Рассмотрим код для метода load ( ):
private function load (urlRequest:URLRequest):void {
// Начинаем загрузку
loader.load(urlRequest);
// Если объект progressoutput еще не является потомком данного объекта...
1f (Icontains(progressOutput)) {
// ...добавляем его
addChi1d(progressoutput);
В процессе загрузки мы ожидаем возникновения события ProgressEvent. PROGRESS, которое свидетельствует о появлении новой порции данных файла sunset. jpg и предоставляет самую последнюю информацию о ходе загрузки. Всякий раз, когда возникает событие ProgressEvent. PROGRESS, мы обновляем объект progressoutput. Получателем данного события является объект Loader Inf о нашего загружаемого элемента. Как мы уже знаем, обратиться к объекту Loaderinfo элемента можно через переменную экземпляра contentLoader Inf о класса Loader. Таким образом, чтобы зарегистрировать приемник для получения уведомлений о возникновении события ProgressEvent. PROGRESS, мы используем следующий код:
odder.contentLoaderInfo.addEventLi stener(ProgressEvent.PROGRESS, progressListener);
В приведенном коде progressListener — это ссылка на функцию, которую мы хотим выполнять при возникновении события ProgressEvent. PROGRESS. В функцию progressListener передается объект ProgressEvent, переменные которого содержат следующую информацию:
размер файла загружаемого элемента (bytesTotal);
количество байтов, полученных до настоящего момента (bytesLoaded).
Следующий код демонстрирует функцию progressListener для нашего класса Sunsetviewer. Обратите внимание, как эта функция получает информацию о ходе выполнения загрузки из объекта ProgressEvent е:
private function progressListener (e:ProgressEvent):void {
// Обновляем индикатор хода выполнения. 1 Кбайт равен 1024 байт,
// поэтому делим результат на 1024, чтобы преобразовать его в килобайты. progressOutput.text = "LOADING: "
+ Math.floorCe.bytesLoaded / 1024)
+ "/" + Math.floor(e.bytesTotal / 1024) + " KB";
}
Когда элемент будет загружен полностью, среда Flash выполнит диспетчеризацию события Event. COMPLETE, получателем которого является объект Loaderlnfо элемента. При возникновении события Event. COMPLETE мы можем удалить индикатор хода выполнения (progressoutput) из списка отображения.
Чтобы зарегистрировать приемник для событий Event. COMPLETE в объекте Loaderinfo нашего загружаемого элемента, мы используем следующий код:
1oader.contentLodderlnfo.dddEventL1stener(Event.COMPLETE,
completeLIstener);
Здесь completeListener — это ссылка на функцию, которую мы хотим выполнять при возникновении события Event. COMPLETE. Следующий код демонстрирует функцию completeListener. Ее роль заключается в простом удалении объекта progressoutput из списка отображения.
private function completeLIstener (e:Event):void { •
// Удаляем индикатор хода выполнения
removeChl1d(progressOutput);
}
Наконец, чтобы облегчить повторное использование кода и упростить его чтение, мы переместим наш код для создания объекта Loader и код, регистрирующий приемники событий, в новый метод createLoader ( ), представленный ниже. Обратите внимание, что код в этом методе регистрирует приемники не только для событий ProgressEvent. PROGRESS и Event. COMPLETE, но и для события Event. INIT, которое было рассмотрено ранее в подразд. «Обращение к загруженному элементу». Как и раньше, мы помещаем наш загруженный элемент в список отображения при возникновении события Event. INIT. Рассмотрим код для метода createLoader ( ):
private function createLoader ( ):vo1d {
// Создаем объект Loader loader = new Loader( );
// Регистрируем приемники для событий
1oader.contentLoaderInfo.addEventLI stener(ProgressEvent.PROGRESS, progressLIstener);
1oader.contentLoaderlnfo.addEventLIstener(Event.COMPLETE, completeL1stener);
1oader.contentLoaderlnfo.addEventLIstener(Event.INIT, 1n1tL1stener);
}
Код, который удаляет индикатор хода выполнения из списка отображения (в нашем примере он представлен методом completeListener ( ) ), должен всегда использовать событие Event. COMPLETE вместо Event. INIT. Не путайте эти два события. Событие Event. INIT выражает качественное состояние «готовности элемента», а событие Event. COMPLETE — количественное состояние завершения загрузки. Событие Event. INIT обозначает, что элемент готов к использованию, даже если — в случае SWF-файла — загрузка еще продолжается. В отличие от этого, событие Event. COMPLETE свидетельствует о получении всех байтов файла, содержащего элемент.
Используйте событие Event.INIT, чтобы определить момент, когда можно благополучно обращаться к элементу. Применяйте событие Event.COM PLETE, чтобы определить момент завершения операции загрузки.
Поскольку некоторые типы элементов могут быть проинициализированы до того, как будут полностью загружены, событие Event .INIT всегда возникает перед событием Event. COMPLETE. Предположим, что мы загружаем SWF-файл, представляющий анимацию из 2000 кадров. Когда первый кадр будет загружен и проинициализирован, возникнет событие Event. INIT. В этот момент мы добавляем анимацию в список отображения и разрешаем начать ее воспроизведение, хотя загрузка SWF-файла все еще продолжается. По мере загрузки SWF-файла индикатор будет представлять ход выполнения данной операции. Когда загрузка SWF-файла будет завершена, возникнет событие Event. COMPLETE и мы удалим индикатор загрузки с экрана.
В листинге 28.7 снова представлен наш класс Sunsetviewer, но на этот раз он включает код для отображения индикатора хода загрузки, рассмотренный в текущем разделе.
Листинг 28.7. Отображение хода загрузки
package {
Import flash.display.*;
Import fldsh.net.URLRequest;
Import flash.events.*
import flash.text.*;
public class SunsetViewer extends Sprite {
private var loader:Loader;// Загрузчик элемента
private var progressOutput;TextField; // Поле, в котором будет
// отображаться ход загрузки
// Конструктор
public function SunsetViewer ( ) {
// Создаем объект Loader и регистрируем приемники событий createLoadert );
// Создаем индикатор хода выполнения createProgressIndicator( );
// Начинаем загрузку
1oad(new URLRequestC"sunset,jpg"));
}
private function createLoader ( );void {
// Создаем объект Loader loader = new Loader( );
// Регистрируем приемники для событий
odder.contentLodderInfo.dddEventLi stener(ProgressEvent.PROGRESS, progressListener);
oader.contentLodderInfo.dddEventListener(Event.COMPLETE, completeListener);
odder.contentLodderInfo.dddEventListener(Event.IN IT, initLi stener);
}
privdte function credteProgressIndicdtor ( );void { progressoutput = new TextFieldC );
progressoutput.dUtoSize=TextFi eldAutoSi ze.LEFT;
progressOutput.border=true;
progressOutput.bdckground=true;
progressOutput.selectdble=false;
progressOutput.text="LOADING...";
}
privdte function lodd (urlRequest:URLRequest);void {
1 odder.lodd(urlRequest);
if (lcontdins(progressOutput)) {
addChl1d(progressoutput);
}
// Приемник вызывается, когда появляются данные
private function progressListener (e:ProgressEvent):vo1d {
// Обновляем индикатор хода выполнения.
progressOutput.text = "LOADING: "
+ Math.floor(e.bytesLoaded / 1024)
+ "/" + Math.floor(e.bytesTotal / 1024) + " KB";
}
private function 1n1tL1stener (e:Event):void {
addChlld(loader,content); // Добавляем загруженный элемент в список// отображения
}
// Приемник вызывается, когда загрузка элемента полностью завершена
private function completeLlstener (e:Event):vo1d {
// Удаляем индикатор хода выполнения.
removeChl1d(progressOutput);
}
} }
Почему бы не использовать событие Event.OPEN? Если вы просматривали документацию по API среды выполнения Flash, то, возможно, обратили внимание на кажущееся удобным событие Event. OPEN, которое возникает в момент начала загрузки. Теоретически событие Event.OPEN предоставляет хорошее место, где можно размещать код для добавления индикатора хода выполнения в список отображения. Как мы уже знаем, код, отображающий ход выполнения, выполняет четыре основные задачи.
Создание индикатора хода выполнения.
Добавление индикатора хода выполнения в список отображения.
Обновление индикатора хода выполнения.
Удаление индикатора хода выполнения из списка отображения.
Первая операция обычно выполняется на этапе подготовки. Три оставшиеся операции соответствуют трем событиям загрузки: Event .OPEN, Event. PROGRESS и Event. COMPLETE. Вы можете поинтересоваться, почему же класс Sunsetviewer из листинга 28.7 добавляет объект progressoutput в список отображения в методе load ( ), а не в приемнике события Event. OPEN.
private function load (urlRequest:URLRequest):void {
loader.loadturlRequest);
1f (!conta1ns(progressOutput)) {
// Почему мы делаем это здесь...
addChlId(progressOutput);
private function openLlstener (e:Event):void {
1f (!conta1ns(progress0utput)) {
// .. .а не здесь?
addChiId(progressOutput);
}
}
На самом деле приемник события Event.OPEN теоретически мог бы быть прекрасным местом для добавления объекта progressoutput в список отображения. К сожалению, на практике специфическое поведение браузеров затрудняет использование события Event. OPEN, и поэтому в данной книге мы избегаем его применения. Исчерпывающую информацию по этому вопросу можно найти далее, в подразд. «Аспекты поведения при ошибках загрузки, зависящие от среды».
Мы уже знаем, как загружать внешний элемент, отображать его на экране и показывать ход выполнения его загрузки пользователю. Теперь рассмотрим код, необходимый для восстановления работоспособности программы после ошибок загрузки.
Обработка ошибок загрузки
Как мы уже знаем из гл. 19, всякий раз, когда попытка загрузить элемент терпит неудачу из-за ограничений безопасности, приложение Flash Player либо генерирует исключение SecurityError, либо выполняет диспетчеризацию события SecurityErrorEvent. SECURITY_ERROR. Всякий раз, когда такая попытка терпит неудачу по любой другой причине, среда выполнения Flash осуществляет диспетчеризацию события TOErrorEvent. IO_ERROR, получателем которого является объект Loader Inf о элемента. Обрабатывая это событие, мы можем попытаться восстановить работоспособность программы после любой ошибки загрузки, не связанной с ограничениями безопасности. Например, в приемнике события TOErrorEvent. IO_ERROR мы могли бы написать код, который просит пользователя проверить подключение к Интернету.
Добавим код, обрабатывающий ошибки загрузки, в наш класс Sunsetviewer. Чтобы зарегистрировать приемник для получения уведомлений о возникновении событий TOErrorEvent. IO_ERROR, мы используем уже знакомый код:
1 odder.contentLoaderInfo.addEventLIstener(TOErrorEvent.IO_ERROR,
IoErrorListener):
Здесь ioErrorListener — ссылка на функцию, которая будет обрабатывать данное событие. В следующем коде представлена функция ioErrorListener. В нашем приложении Sunsetviewer функция ioErrorListener ( ) просто отображает сообщение об ошибке пользователю в текстовом поле progressoutput.
// Приемник вызывается при возникновении ошибки загрузки private function IoErrorListener (е:TOErrorEvent):void { progressOutput.text = "LOAD ERROR":
}
В отличие от других событий загрузки, если при диспетчеризации приложением Flash Player события TOErrorEvent. IO ERROR, получателем которого является
объект Loaderinfo, никакая функция-приемник не зарегистрирована для его обработки, среда выполнения Flash генерирует ошибку на этапе выполнения. Например:
Error #2044: Unhandled lOErrorEvent:. text=Error #2035: URL Not Found.
Безусловно, сообщение об ошибке Unhandled lOErrorEvent (Необработанное событие lOErrorEvent), как и обо всех ошибках на этапе выполнения, отображается только в отладочной версии приложения Flash Player. В рабочей версии приложения Flash Player среда Flash не выдаст пользователю никаких сообщений об ошибках загрузки. Вместо этого она полагает, что реагировать на ошибки соответствующим образом должен код приложения.
В листинге 28.8 представлена окончательная версия класса Sunsetviewer, дополненная кодом для обработки ошибок загрузки. Новый код выделен полужирным шрифтом.
Листинг 28.8. Окончательная версия класса Sunsetviewer, с обработкой ошибок загрузки
package {
Import flash.display.*;
Import flash.net.URLRequest:
Import fl ash.events.*
import flash.text.*;
public class Sunsetviewer extends Sprite {
private var loader:Loader;
private var progressOutput:TextF1eld;
public function Sunsetviewer ( ) {
createLoader( );
createProgress!nd1cator( );
load(new URLRequest("sunset.jpg")):
}
private function createLoader ( ):vo1d { loader = new LoaderC );
1oader.contentLoaderlnfo.addEventLI stener(ProgressEvent.PROGRESS, progressLIstener);
1oader.contentLoaderlnfo.addEventLIstener(Event.COMPLETE, completeLIstener);
1oader.contentLoaderlnfo.addEventLIstener(Event.INIT,
1n1tL1stener);
1oader.contentLoaderlnfo.addEventLIstener(lOErrorEvent.IOERROR, ioErrorListener);
}
private function createProgressIndlcator ( ):void {
progressoutput = new TextF1eld( ):
progressOutput.autoSIze =TextFI eldAutoSIze.LEFT;
progressOutput.border =true;
progressOutput.background =true;
progressOutput.selectable =false;
progressOutput.text = "LOADING...";
}
private function load (urlRequest:URLRequest):void { loader.load(urlRequest);
if (!conta1ns(progress0utput)) {
addChl1d(progressOutput);
}
}
private function progressListener (e:ProgressEvent):void { progressOutput.text = "LOADING: "
+ Math.floorCe.bytesLoaded / 1024)
+ "/" + Math.floorCe.bytesTotal / 1024) + " KB":
}
private function 1n1tL1stener (e:Event):void {
addCh11d(1oader.content);
}
private function completeLlstener (e:Event):void { removeChlld(progressOutput);
}
// Приемник вызывается при возникновении ошибки загрузки private function ioErrorListener. (e:IOErrorEvent):void { progressOutput.text = "LOAD ERROR";
}
}
}
Аспекты поведения при ошибках загрузки, зависящие от среды
При осуществлении операций загрузки среда выполнения Flash полагается на свою локальную среду (то есть на операционную систему или приложение, в котором запускается среда выполнения Flash, — зачастую таким приложением является браузер). Как результат, некоторые аспекты поведения Flash, связанного с загрузкой данных, зависят от среды. Среда выполнения по мере возможности пытается оградить программиста от подобных аспектов поведения. Тем не менее в приложении Flash Player 9 существуют два аспекта поведения, которые представлены в табл. 28.1, — они являются уникальными для приложения Internet Explorer в операционной системе Windows и требуют особого внимания программиста.
Таблица 28.1. Аспекты связанного с загрузкой поведения приложения Internet Explorer
Особенность
Поведение Internet Explorer
Поведение автономного проигрывателя, приложений firefox и Adobe AIR
Event.OPEN
Все операции загрузки генерируют событие Event.OPEN, даже если в дальнейшем они завершатся неудачей по причине «файл не найден»
Событие Event.OPEN не генерируется для операций загрузки, которые завершаются неудачей по причине «файл не найден»
Особенность
Поведение Internet Explorer
Поведение автономного проигрывателя, приложений firefox и Adobe AIR
Переменная экземпляра text класса lOErrorEvent
Когда загрузка завершается неудачей по причине «файл не найден», переменной text присваивается значение «Error #2036: Load Never Completed» (Загрузка не будет завершена)
Когда загрузка завершается неудачей по причине «файл не найден», переменной text присваивается значение Error #2035: URL Not Found (Адрес URL не найден)
Ни одно из описанных в табл. 28.1 поведений не является «правильным». Каждое поведение просто зависит от среды, под управлением которой запущена среда Flash. Тем не менее, поскольку согласованность между поведениями всех сред отсутствует, необходимо проявлять осторожность при написании кода, который использует событие Event. OPEN или переменную экземпляра text класса lOErrorEvent. Чтобы добиться платформенной независимости, выполняйте две следующие рекомендации.
Не используйте значение переменной экземпляра text класса lOErrorEvent для принятия решений в логике ветвления. Используйте эту переменную только для отладочных целей.
Избегайте применения события Event. OPEN для любых целей, кроме отладки. Рассмотрим один пример, который объясняет, почему использование события Event. OPEN может вызвать проблемы в приложении. Предположим, что приложение использует пользовательский класс LoadBar для отображения хода выполнения операции загрузки. Приложение добавляет экземпляр класса LoadBar в список отображения всякий раз, когда начинается операция загрузки, внутри приемника события Event. OPEN:
private function openLlstener (e:Event):void {
addChl1d(1oadBar);
}
Теперь предположим, что приложение пытается загрузить файл, который не может быть найден. Если приложение будет запущено в браузере Internet Explorer, метод openLlstener ( ) выполнится и экземпляр класса LoadBar появится на экране. Однако если приложение будет запущено в любом другом браузере, метод openLlstener ( ) не выполнится и экземпляр класса LoadBar не появится на экране. В лучшем случае разработчик заметит данное несоответствие и напишет код для браузера Internet Explorer, удаляющий экземпляр класса LoadBar с экрана в случае ошибки загрузки. Подобный код усложняет приложение и увеличивает вероятность появления ошибок. В худшем случае разработчик не заметит данное несоответствие и в Internet Explorer экземпляр класса LoadBar будет находиться на экране в течение всего жизненного цикла приложения.
Чтобы полностью избежать подобной проблемы, безопаснее всего вообще не использовать событие Event. OPEN. Вместо этого просто применяйте методику, которая была рассмотрена в коде из листинга 28.7: добавляйте на экран любые индикаторы хода загрузки вручную перед началом загрузки.
В будущих версиях языка ActionScript аспекты поведения, зависящие от среды, которые были перечислены в табл. 28.1, возможно, будут стандартизованы, и вам больше не придется избегать использования события Event. OPEN.
Отладка с использованием класса HTTPStatusEvent
Когда HTTP-клиент запрашивает некий элемент по протоколу HTTP, HTTP-сервер возвращает код статуса, который сообщает о том, как был обработан данный запрос. Например, если HTTP-запрос был обработан успешно, HTTP-сервер вернет код статуса 200. Если обработка HTTP-запроса завершилась неудачно, сервер отправит статус ошибки, описывающий возникшую проблему. Коды статуса HTTP для ошибок загрузки зачастую представляют более подробную информацию, чем общее событие lOErrorEvent. IO_ERROR языка ActionScript, поэтому эти коды полезно использовать при отладке. Однако поддержка кодов статуса HTTP реализована не во всех средах.
г~п
Версии приложения Flash Player, реализованные в виде модулей расширения браузеров Netscape, Mozilla (Firefox), Safari, Opera и Internet Explorer (версия для операционной системы Macintosh), не поддерживают коды статуса HTTP.
При получении кода статуса HTTP от сервера приложение Flash Player осуществляет диспетчеризацию события HTTPStatusEvent.HTTP_STATUS, получателем которого является объект Loader Inf о загружаемого элемента. Чтобы зарегистрировать приемник для получения уведомлений о возникновении события HTTPStatusEvent. HTTP_STATUS, мы используем следующий код:
o6beKTloader.contentLoaderInfo.addEventLi stener(HTTPStatusEvent.HTTP_STATUS, httpStatusLi stener);
Здесь объект1_оас!ег — объект Loader, загружающий элемент, a httpStatusL 7stener — ссылка на функцию, которая будет обрабатывать данное событие. В функцию httpStatusListener передается объект HTTPStatusEvent, переменная status которого содержит код статуса HTTP. Следующий код демонстрирует типовую функцию httpStatusL i stener. Обратите внимание на способ получения кода статуса HTTP из объекта HTTPStatusEvent е:
private function httpStatusListener (e:HTTPStatusEvent):void { traceChttp status: " + e.status);
}
Как бы удивительно это ни звучало, фактически приложение Flash Player осуществляет диспетчеризацию события HTTPStatusEvent. HTTP_STATUS для каждой отдельной операции загрузки, даже если не получает код статуса HTTP от сервера. В тех случаях, когда никакой код статуса HTTP не получен, переменной экземпляра status класса HTTPStatusEvent присваивается значение 0. Например, во всех следующих ситуациях переменной status присваивается значение 0:
файл загружается локально или из некоторого источника не по протоколу HTTP;
сервер HTTP недоступен;
запрашиваемый URL-адрес указан неправильно;
коды статуса HTTP не поддерживаются средой (например, приложение Flash Player выполняется в браузере Mozilla Firefox).
Мы рассмотрели все общие вопросы, относящиеся к загрузке отображаемых элементов на этапе выполнения с помощью объекта Loader. В следующих разделах рассматриваются вопросы, касающиеся использования загруженных SWF-файлов.
Проверка типов на этапе компиляции для дииамически загружаемых элементов
Ранее из подразд. «Обращение к загруженному элементу» разд. «Использование класса Loader для загрузки отображаемых элементов на этапе выполнения» мы узнали, что переменная экземпляра content класса Loader ссылается на объект, представляющий загруженный элемент. Мы также узнали, что в зависимости от типа загруженного элемента переменная content может ссылаться либо на экземпляр класса Bitmap, либо на экземпляр основного класса SWF-файла. Экземпляры этих несопоставимых классов допускается присваивать переменной content, поскольку ее типом данных является DisplayOb j ect, а класс Bitmap и все основные классы SWF-файлов наследуются от класса Displayobject. Как результат, любым объектом, присвоенным переменной content, можно управлять с помощью переменных и методов класса DisplayOb j ect, но над ним нельзя вызывать более специфические переменные и методы класса Bitmap или основного класса SWF-файла.
Например, с помощью следующего кода допустимо обратиться к переменной экземпляра width класса Displayobject объекта, на который ссылается переменная content:
// Класс Displayobject определяет переменную width, // поэтому ошибки не будет loader.content.width
Следующий код подобным образом пытается обратиться к переменной экземпляра bitmapData класса Bi tmap объекта, на который ссылается переменная content. Однако на этот раз данный код вызывает ошибку компиляции, поскольку в классе DisplayOb j ect не определена переменная bitmapData.
ОШИБКА: "Access of possibly undefined property bitmapData through a reference with static type flash.display:Displayobject." (Обращение к возможно неопределенному свойству bitmapData через ссылку на статический класс flash.display:Displayobject)
loader.content.bitmapData.getPIxel(0, 0)
Чтобы избежать ошибок на этапе компиляции при обращении к методам и переменным класса Bitmap через переменную content, мы приводим ее значение к типу Bitmap, как показано в следующем коде:
B1tmap(loader.content).bitmapData.getPIxel(1, 1):
Операция приведения типов сообщает компилятору, что загруженный элемент является экземпляром класса Bitmap, в котором определена переменная bitmapData.
Подобным образом при использовании методов и переменных классаMovieClip над загруженным SWF-файлом мы приводим значение переменной content к типу MovieClip. Например, следующий код начинает воспроизведение гипотетической анимации путем вызова метода экземпляра play ( ) imaccaMovieClip над загруженным элементом. Операция приведения типов (обязательная) сообщает компилятору, что загруженный элемент является потомком класса MovieClip и, следовательно, поддерживает метод play ( ).
MovieCIip(loader.content).play( ):
Точно так же, когда используются пользовательские методы и переменные основного класса загруженного SWF-файла, вполне естественно ожидать, что значение переменной content приводится к этому основному классу. Предположим, что приложение Main . swf загружает другое приложение Module . swf, основным классом которого является класс Module. Предположим также, что класс Module определяет собственный метод start ( ). Когда приложение Main. swf загружает приложение Module .swf, среда выполнения Flash автоматически создает экземпляр класса Module и присваивает его переменной content. Таким образом, чтобы вызвать метод start ( ) над загруженным экземпляром класса Module, можно предположить, что необходимо использовать следующую операцию приведения типов:
ModuleCloader,content).start( );
Хотя, по существу, предыдущий код корректен, фактически он будет вызывать ошибку на этапе компиляции до тех пор, пока не будут приняты особые меры при компиляции файла Main. swf. Рассмотрим почему.
Предположим, что приложения Ma in. swf и Module . swf созданы в виде отдельных проектов в приложении Flex Builder 2. Эти два проекта созданы с учетом того, что приложения должны быть автономными и независимыми, поэтому в них используется совершенно разный код и они никак не ссылаются друг на друга. В проекте приложения Module . swf определяется класс Module, однако приложение Main . swf ничего не знает про этот класс. При построении файла Main, swf компилятор встречает следующий код:
Modulе(1oader.content).start( )
и не может разрешить ссылку на класс Module, используя пути, указанные для свойства ActionScript Build Path (Путь компиляции ActionScript) приложения Main . swf. Не найдя класс Module, компилятор предполагает, что выражение Module (loader. content) является вызовом метода. Однако метода с именем Module не существует, поэтому компилятор генерирует следующую ошибку типа:
1180: Call to a possibly undefined method Module.
По-русски она будет звучать так: Вызов, возможно, неопределенного метода Module.
Существует два способа решения данной проблемы: мы можем отключить проверку типов на этапе компиляции или предоставить компилятору доступ к классу Module при компиляции файла Main. swf. Эти способы рассматриваются в двух следующих разделах.
Отключение проверки типов на этапе компиляции
Чтобы отключить проверку типов на этапе компиляции при применении пользовательских методов и переменных основного класса загруженного SWF-файла, мы можем привести значение переменной loader. content к типу данных Ob j ect, как показано в следующем коде:
Object(1oader.content).start( ); // Ошибки компиляции не будет
Кроме того, можно присвоить то значение, на которое ссылается переменная loader. content, нетипизированной переменной:
van module:* = 1oader.content:
module.start( ): // Ошибки компиляции не будет
В качестве альтернативы мы можем обратиться к загруженному объекту с помощью выражения событиеТпП.target .content из функции-приемника события Event. INIT. Проверки типа значения переменной экземпляра target класса Event на этапе компиляции не происходит, поскольку типом данных объекта target является Object.
private function 1n1tL1stener (e:Event):void {
e.target.content.start( ): // Ошибки компиляции не будет }
В каждом из перечисленных случаев компилятор не генерирует ошибку при обращении к методу start ( ). Вместо этого проверка типа нашего значения переменной loader. content откладывается до этапа выполнения. Тем не менее, как мы уже знаем из гл. 8, отключение проверки типов на этапе компиляции приводит к потере производительности. В тех случаях, когда проверка типов откладывается до этапа выполнения, сообщения об ошибках не появятся, пока не будет выполнен потенциальный проблемный код, поэтому время отладки увеличивается.
Чтобы избежать увеличения времени отладки, мы можем предоставить компилятору доступ к классу Module при компиляции приложения Main. swf. Этот процесс подробно описан в следующем разделе.
Предоставление компилятору доступа к загружаемому классу
Чтобы избежать ошибок компиляции при приведении значения переменной loader. content к основному классу загружаемого SWF-файла, мы можем предоставить компилятору языка ActionScript доступ к этому классу на этапе компиляции. Для этого существуют три различные методики: путей исходных файлов, путей библиотек и путей внешних библиотек. Каждая из перечисленных методик рассматривается в трех следующих разделах на примере класса Module из предыдущего раздела. В каждом случае компилятору предоставляется доступ к классу Module при компиляции приложения Main . swf.
Три методики, рассматриваемые в следующих разделах, подходят для различных ситуаций. Используйте методику путей исходных файлов в том случае, когда верны оба следующих утверждения:
допускается увеличение общего размера файлов приложения;
вы хотите сделать так, чтобы исходный код загружаемого SWF-файла (в нашем примере Module. swf) был непосредственно доступен автору приложения, из которого происходит обращение к этому SWF-файлу (Main. swf в нашем примере).
Используйте методику путей библиотек, когда допускается увеличение общего размера файлов приложения и когда верно одно из следующих утверждений:
вы не хотите, чтобы исходный код загружаемого SWF-файла был непосредственно доступен автору приложения, из которого происходит обращение к этому SWF-файлу;
время, необходимое для компиляции SWF-файла, к которому происходит обращение, должно быть минимизировано.
Используйте методику путей внешних библиотек, когда увеличение размера файла всего приложения не допускается.
Стоит отметить, что во всех трех последующих примерах использования методик, если приложение Main.swf уже содержит класс с именем Module, вместо класса из приложения Module.swf применяется версия данного класса из приложения Main.swf. Чтобы избежать подобного поведения, всегда уточняйте имена ваших классов, используя уникальное имя пакета (как было рассмотрено в гл. 1).
Включение файла класса Module в пути исходных файлов приложения Main.swf
Первая методика для предоставления компилятору доступа к классу Module при компиляции приложения Main. swf заключается во включении файла класса Module в пути исходных файлов приложения Main.swf.
Следующие шаги описывают данный процесс для приложения Flex Builder 2.
В палитре Navigator (Навигатор) выберите папку проекта приложения Main. swf.
В меню Project (Проект) выберите команду Properties (Свойства).
В появившемся окне Properties (Свойства) установите флажок ActionScript Build Path (Путь компиляции ActionScript).
На вкладке Source path (Пути исходных файлов) нажмите кнопку Add Folder (Добавить путь).
В открывшемся окне Add Folder (Добавление папки) укажите путь к папке, содержащей файл класса Module.
В окне Add Folder (Добавление папки) нажмите кнопку ОК.
В окне Properties (Свойства) нажмите кнопку ОК.
Следующие шаги описывают эквивалентный процесс включения файла класса Module в пути исходных файлов приложения Main.swf для приложения Flash CS3.
Откройте соответствующий FLA-файл приложения Main.swf — Main. fla.
Отметим, что шаги, описывающие процесс создания файла Main. fla, не рассматриваются в этом разделе. Предполагается, что файл Main. fla является FLA-файлом, в качестве класса документа которого выбран класс Main.
Выберите команду меню File ► Publish Settings (Файл ► Настройки публикации).
На вкладке Flash окна Publish Settings (Настройки публикации) нажмите кнопку Settings (Параметры), расположенную возле раскрывающегося списка ActionScript version (Версия ActionScript) с установленным значением ActionScript 3.0.
В появившемся окне ActionScript 3.0 Settings (Параметры ActionScript 3.0) нажмите кнопку со знаком «плюс» и укажите путь к папке, содержащей файл класса Module.
Как только файл класса Module будет включен в пути исходных файлов приложения Main. swf, компилятор сможет проверять типы для любого обращения к классу Module, происходящего в приложении Main. swf. Кроме того, компилятор добавит байт-код для класса Module (и для всех зависимых определений) непосредственно в файл Main. swf, гарантируя доступность класса Module из приложения Main. swf на этапе выполнения. Таким образом, методика путей исходных файлов увеличивает общий размер файлов приложения, поскольку класс Module и его зависимые определения включаются в файлы Main. swf и Module . swf. Более того, при использовании методики путей исходных файлов компиляция класса Module осуществляется с нуля всякий раз, когда компилируется приложение Main. swf, что может приводить к временным затратам.
Включение файла класса Module в пути библиотек приложения Main.swf
Вторая методика для предоставления компилятору доступа к классу Module при компиляции приложения Main. swf заключается в создании SWC-файла, содержащего класс Module, и включении этого SWC-файла в пути библиотек приложения Main. swf.
Чтобы создать SWC-файл, содержащий класс Module, в приложении Flex Builder 2, мы используем консольный компилятор компонентов сотрс (компилятор сотрс находится во вложенной папке Flex SDK 2\bin внутри папки, в которую было установлено приложение Flex Builder 2). Ниже представлен общий вид команды, используемой для компиляции SWC-файла с помощью компилятора сотрс:
сотрс -source-path путь_к_определениям -output путь_к_8МС_файлу -1nclude-classes именаОпределений
Здесь путь_к_определениям — список местоположений, в которых компилятор должен искать классы и другие определения при создании SWС-файла, путь_к_8МС_фай- лу — путь к создаваемому SWC-файлу, а именаОпределений — список определений, которые будут включены в SWC-файл (компилятор автоматически включает все зависимые определения). Предположим, мы работаем в операционной системе Windows ХР и хотим создать SWC-файл с именем module. swc в папке с: \ apps\module\bin\. Мы хотим, чтобы файл module. swc включал класс Module, файл которого находится в папке с: \apps\module\src. Чтобы создать файл module. swc, мы используем следующую команду:
compc -source-path c:\apps\module\src -output c:\apps\module\b1n\module.swc - Included asses
Module
Стоит отметить, что, несмотря на свое название, параметр -include-classes компилятора compc может использоваться для включения любых типов определений, а не только классов. Возможно, в будущих версиях компилятора появится параметр с более подходящим названием —include-definitions.
Теперь рассмотрим эквивалентный процесс создания SWC-файла, содержащего класс Module, в приложении Flash CS3.
Создайте новый документ Flash (FLA-файл) с именем Module. На.
В поле Document class (Класс документа) палитры Properties (Свойства) введите значение Module.
Выберите команду меню File ► Publish Settings (Файл ► Настройки публикации).
На вкладке Formats (Форматы) в области Туре (Тип) снимите флажок HTML.
На вкладке Flash в области Options (Параметры) установите флажок Export SWC (Экспорт SWC).
Нажмите кнопку Publish (Опубликовать), а затем кнопку ОК.
Создав файл module . swc, мы включаем его в пути библиотек при компиляции приложения Main. swf. Для этого в приложении Flex Builder 2 нужно выполнить следующие шаги.
На палитре Navigator (Навигатор) выберите директорию проекта приложения Main. swf.
В меню Project (Проект) выберите команду Properties (Свойства).
В появившемся окне Properties (Свойства) установите флажок ActionScript Build Path (Путь компиляции ActionScript).
На вкладке Library path (Пути библиотек) нажмите кнопку Add SWC (Добавить SWC).
В окне Add SWC (Добавление SWC) укажите путь к файлу module. swc.
В окне Add SWC (Добавление SWC) нажмите кнопку ОК.
Теперь в окне Properties (Свойства) нажмите кнопку ОК.
Чтобы включить файл module . swc в пути библиотек при компиляции приложения Main. swf в приложении Flash CS3, выполните следующие шаги.
Во вложенной папке Configuration\Components внутри папки, в которую была установлена среда разработки Flash, создайте новую папку с именем Module. В Windows ХР по умолчанию используется следующий путь к вложенной папке Configuration\Components: С:\Program Files\Adobe\Adobe Flash CS3\en\ Configuration\Components. В операционной системе Mac OS X по умолчанию используется такой путь к вложенной папке Configuration\Components: Macintosh HD: Applications-.Adobe Flash CS3 : Configuration: Components.
Скопируйте файл module. swc в папку Module, созданную на шаге 1. В результате копирования файла module. swc во вложенную папку Configuration\Components
этот файл будет добавлен на палитру Components (Компоненты) среды разработки Flash.
В среде разработки Flash откройте палитру Components (Компоненты) (команда меню Window ► Components (Окно ► Компоненты)).
Откройте меню Options (Параметры), щелкнув на значке в правом верхнем углу палитры Components (Компоненты), и выберите команду Reload (Обновить). Папка Module появится на палитре Components (Компоненты).
На палитре Components (Компоненты) откройте папку Module.
Откройте палитру Library (Библиотека) файла Main. fla (команда меню Window ► Library (Окно ► Библиотека)).
Перетащите компонент Module с палитры Components (Компоненты) на палитру Library (Библиотека) файла Main. fla.
Как только файл module. swc будет включен в пути библиотек приложения Main. swf, компилятор сможет проверять типы для любого обращения к классу Module, происходящего в приложении Main. swf. Кроме того, компилятор копи-' рует байт-код класса Module (и всех зависимых классов) непосредственно из файла module . swc в приложение Main. swf, гарантируя доступность класса Module из приложения Main, swf на этапе выполнения. Таким образом, как и в случае с методикой путей исходных файлов, методика путей библиотек увеличивает общий размер файлов приложения, поскольку класс Module и его зависимые определения включаются и в Main. swf, и в Module. swf. Тем не менее, поскольку при использовании методики путей библиотек класс Module не компилируется с нуля всякий раз, когда компилируется приложение Main. swf, компиляция приложения Main. swf с использованием методики путей библиотек обычно быстрее, чем с использованием методики путей исходных файлов.
Копирование заранее скомпилированного байт-кода из SWC- в SWF-файл оказывается быстрее, чем компиляция приложений из исходных файлов определений.
Безусловно, всякий раз, когда изменяется класс Module, сам файл module . swc необходимо создавать заново. Следовательно, если класс Module изменяется гораздо чаще, чем приложение Main. swf, время, сэкономленное при копировании байт-кода непосредственно из файла module . swc в файл Main. swf, будет полностью потрачено на компиляцию файла module . swc. Выражаясь современным
языком, ваши результаты могут отличаться.
Включение файла класса Module в пути внешних библиотек приложения Main.swf
Третья методика для предоставления компилятору доступа к классу Module при компиляции приложения Main.swf заключается в создании SWC-файла, содержащего класс Module, и включении этого SWC-файла в пути внешних библиотек приложения Main.swf.
Применение этой методики начинается с выполнения инструкций из предыдущего раздела по созданию файла module . swc. Создав этот файл, мы включаем его
в пути внешних библиотек приложения Main. swf. Для этого в приложении Flex Builder 2 необходимо выполнить следующие шаги.
На палитре Navigator (Навигатор) выберите директорию проекта приложения Main. swf.
В меню Project (Проект) выберите команду Properties (Свойства).
В появившемся окне Properties (Свойства) установите флажок ActionScript Build Path (Путь компиляции ActionScript).
На вкладке Library path (Пути библиотек) нажмите кнопку Add SWC (Добавить SWC).
В окне Add SWC (Добавление SWC) укажите путь к файлу module. swc.
В окне Add SWC (Добавление SWС) нажмите кнопку ОК.
В дереве списка Build path libraries (Пути библиотек компиляции) раскройте файл module. swc.
Среди раскрывшихся свойств файла module . swc выделите свойство Link Туре (Тип связи) с установленным значением Merged into code (Внедрить в код).
Нажмите кнопку Edit (Изменить).
В появившемся диалоговом окне Library Path Item Options (Параметры элемента путей библиотек) для параметра Link Туре (Тип связи) выберите значение External (Внешний).
И. В окне Library Path Item Options (Параметры элемента путей библиотек) нажмите кнопку ОК.
В окне Properties (Свойства) нажмите кнопку ОК.
В приложении Flash CS3, чтобы включить файл module . swc в пути внешних библиотек, мы просто помещаем его в ту же папку, где находится файл Main. fla (или в любую другую папку из путей к классам файла Main. fla), и удаляем компонент Module с палитры Library (Библиотека) файла Main. fla.
Как только файл module . swc будет включен в пути внешних библиотек приложения Main, swf, компилятор сможет проверять типы для любого обращения к классу Module, происходящего в приложении Main . swf. Однако, в отличие от методик путей библиотек и путей исходных файлов, когда приложение Ma in. swf компилируется с использованием методики путей внешних библиотек, компилятор не копирует байт-код класса Module в приложение Main. swf. Таким образом, общий размер файлов приложения будет минимальным. Тем не менее исключение байт-кода класса Module из приложения Main. swf приводит к новой проблеме: на этапе выполнения любая ссылка на класс Module из приложения Main. swf оказывается неизвестной для среды выполнения Flash. В связи с этим следующий код:
Modulе(1oader.content).start( )
вызовет такую ошибку на этапе выполнения:
ReferenceError: Error #1065: Variable Module 1s not defined.
На русском языке она будет выглядеть так: Ошибка обращения: переменная Module не определена.
Чтобы избежать данной ошибки, мы должны заставить среду выполнения Flash импортировать классы приложения Module, swf в домен приложения файла Main. swf на этапе выполнения.
Домен приложения SWF-файла предоставляет доступ к классам этого файла. Домены приложения определяют, как загруженные SWF-файлы совместно используют классы и другие определения. Дополнительную информацию можно найти в разделе Programming Actionscript 3.0 ► Flash Player APIs ► Client System Environment ► ApplicationDomain class документации корпорации Adobe. Кроме того, обратитесь к гл. 31.
Чтобы импортировать классы приложения Module. swf в домен приложения файла Main. swf, при создании запроса на загрузку приложения Module. swf мы используем объект Loadercontext. Рассмотрим, как выглядит код, добавляемый в основной класс приложения Main.swf:
// Сначала импортируем классы ApplicationDomain и LoaderContext...
Import fl ash.system.*;
// ...затем в классе используем объект LoaderContext, чтобы импортировать
// классы и другие определения файла Module.swf в домен приложения
// файла Main.swf
1oader.1oad(new URLRequest("Module.swf").
new LoaderContext(false, ApplicationDomain.currentDomain));
В результате выполнения предыдущего кода классы (и другие определения) файла Module . swf становятся непосредственно доступными для кода приложения Main. swf — будто они были определены в приложении Main. swf.
Стоит отметить, что, если файлы Main. swf и Module . swf находятся в разных удаленных регионах или если файл Main, swf находится в локальной области действия и его тип безопасности песочницы отличается от типа безопасности песочницы файла Module .swf, попытка импортировать классы файла Module .swf в домен приложения файла Main, swf завершится неудачно без сообщения об ошибке. В данном случае следующий код:
Modulе(loader,content).start( )
вызовет ту же ошибку, которая возникла бы в случае, когда классы приложения Module. swf вообще не импортируются в домен приложения файла Main. swf: ReferenceError: Error #1065: Variable Module 1s not defined.
По-русски ошибка выглядит так: Ошибка обращения: переменная Module не определена.
В определенных ситуациях избежать подобного ограничения безопасности можно с помощью импортирующей загрузки, при которой приложение Ma in. s wf использует объект LoaderContext, чтобы импортировать файл Module. swf в свой домен безопасности. Это демонстрирует следующий код:
var loadercontext:LoaderContext = new LoaderContext( ):
oaderContext.appl1cationDomain = ApplicationDomain.currentDomain;
var loader:Loader = new LoaderC ):
loader.load(new URLRequest("Module.swf"), 1oaderContext);
Полную информацию по импортирующей загрузке можно получить в разд. «Импортирующая загрузка» гл. 19.
Для обзора и для справки в листинге 28.9 представлен код для классов Main и Module, рассмотренных в данном разделе. Предполагается, что файл module. swc был создан и включен в пути внешних библиотек приложения Module. swf.
Листинг 28.9. Классы Main и Module
// Класс Main
package {
Import flash.display.*;
import flash.net.*;
import fl ash.events.*;
import fl ash.system.*;
public class Main extends Sprite {
private var loader;Loader;
public function Main( ) {
loader = new Loader( );
oader.contentLoaderlnfo.addEventListener(Event.INIT, initListener);
1oader.1oad(new URLRequest("Module.swf"), new LoaderContext(false,
ApplicationDomain. currentDomai n));
}
private function initListener (e:Event);void { traceCinit");
ModuleCe.target.content).start( );
}
}
// Класс Module
package {
import flash.display.Sprite;
public class Module extends Sprite {
public function Module( ) {
}
public function start ( );void {•
trace("Module.start( ) was invoked...");
}
}■
}
Мы рассмотрели несколько методик для обращения к основному классу загружаемого элемента, не вызывая ошибки типов. Из следующего раздела мы узнаем, как благополучно обращаться к элементам, созданным во втором и последующих кадрах загруженного SWF-файла.
Обращение к элементам в многокадровых SWF-файлах
Ранее из подразд. «Обращение к загруженному элементу» разд. «Использование класса Loader для загрузки отображаемых элементов на этапе выполнения» мы узнали, что в тех случаях, когда один SWF-файл загружает другой SWF-файл, все отображаемые элементы и объекты, создаваемые программным путем и размещаемые в первом кадре загружаемого SWF-файла, становятся доступными сразу после возникновения события Event. INIT. Таким образом, код в приемнике события Event .INIT может сразу же выполнять действия над этими элементами и объектами. Тем не менее код в приемнике события Event .INIT не может выполнять действия над элементами и объектами, которые размещаются в последующих кадрах загруженного SWF-файла.
Любой код, желающий обратиться к элементам и объектам, которые размещаются во втором или последующих кадрах загруженного SWF-файла, должен сначала убедиться в существовании этих элементов и объектов. Убедиться, что нужные элементы и объекты существуют в загруженном SWF-файле, можно двумя способами. В SWF- файле, из которого происходит обращение, нужно:
периодически проверять существование элемента или объекта с помощью объекта Timer;
зарегистрировать приемник для пользовательского события, генерируемого загруженным SWF-файлом в тот момент, когда элемент или объект становится доступным.
Рассмотрим каждую из перечисленных методик на примере. Мы снова будем использовать сценарий из предыдущего раздела, в котором приложение Main. swf загружает приложение Module. swf. Предположим, что во втором кадре основной временной шкалы приложения Module. swf размещается сценарий, который создает объект TextField t. Приложение Main . swf загружает приложение Module. swf и желает обратиться к объекту t. Рассмотрим сценарий временной шкалы приложения Module . swf:
stop( ):
var t:TextField = new TextFieldC );
t.text = "hello";
addChlld(t):
В листинге 28.10 показано, как приложение Main, swf загружает приложение Module. swf, а затем периодически проверяет существование объекта TextField перед его использованием.
Листинг 28.10. Периодическая проверка существования загруженного объекта
package {
Import flash.display.*:
Import flash.events.*;
Import flash.net.*;
Import flash.utils.*:
public class Main extends Sprite {
private var loader:Loader;
public function Main( ) {
// Загружаем файл Module.swf loader = new Loader( );
1oader.contentLoaderlnfo.addEventListener(Event.INIT,
initListener);
1oader.1oad(new URLRequest("Module.swf"));
}
private function initListener (e:Event):void {
// Загруженный SWF-файл был проинициализирован,
// поэтому начинаем периодическую проверку существования
// объекта TextField.
var timerTimer = new TimerUOO, 0);
timer.addEventListener(TimerEvent.TIMER, timerListener); timer.start( );
}
private function timerListener (eTimerEvent):void {
// Проверяем, был ли создан объект TextField.
// загруженного SWF-файла
if (loader.content.hasOwnPropertyC't")) {
// Объект TextField уже существует, поэтому мы можем благополучно
// обратиться к нему
trace(Objectdoader.content) .t.text);
// Останавливаем таймер е.target.stop( ):
}
}
}
}
Теперь снова предположим, что приложение Main, swf загружает приложение Module. swf и желает обратиться к объекту t. На этот раз, однако, основной класс Module приложения Module, swf рассылает пользовательское событие Module.ASSETS_READY, когда объект t становится доступным. Приложение Main. swf регистрирует приемник для события Module . ASSETS_READY и обращается к объекту t, когда возникает данное событие. Рассмотрим код для класса Module, в котором определена константа события:
package {
import fl ash.di splay.MovieClip;
class Module extends MovieClip {
// Определяем константу события
public static const ASSETS_READY:String = "ASSETS_READY";
}
Теперь рассмотрим сценарий, размещаемый во втором кадре основной временной шкалы приложения Module. swf, который осуществляет диспетчеризацию события, обозначающего доступность объекта t:
stop( );
var t:TextF1eld = new TextF1eld( ); t.text = "hello";
addChlld(t);
d1spatchEvent(new Event(Module.ASSETS_READY)):
Наконец, в листинге 28.11 представлен код для основного класса приложения Main. swf. Предполагается, что на этапе компиляции компилятор языка ActionScript не имеет доступа к определениям классов загружаемого SWF-файла. В итоге этот код ссылается на событие Module.ASSETS_READY по его строковому имени "ASSETS_READY":
1oader.content.addEventLIstener("ASSETS_READY", assetsReadyLlstener);
Подобным образом в данном коде значение переменной loader. content приводится к типу Ob j ect, поэтому проверка типов откладывается до этапа выполнения:
Object(1oader.content). t.text
Полную информацию о проверке типов загружаемых элементов можно найти в разд. «Проверка типов на этапе компиляции для динамически загружаемых элементов».
Листинг 28.11. Обработка события, сообщающего о доступности загруженного объекта package {
import flash.display.*;
Import fl ash.events.*;
Import flash.net.*;
Import flash.utils.*;
public class Main extends Sprite { private var loader:Loader;
public function Ma1n( ) {
// Загружаем файл Module.swf loader = new Loader( ):
1oader.contentLoaderlnfo.addEventLIstener(Event.IN IT, initListener):
1oader.1oad(new URLRequest("Module.swf"));
}
private function 1n1tL1stener (e:Event):void {
// Загруженный SWF-файл был проинициализирован, поэтому регистрируем
// приемник для события Module.ASSETSREADY.
1oader.content.addEventLIstener("ASSETS_READY", assetsReadyLlstener);
private function assetsReadyLlstener (e:Event):void {
// Объект TextFleld уже существует, поэтому мы можем благополучно
// обратиться к нему
trace(0bject(1oader.content).t.text);
}
} }
До сих пор при рассмотрении вопросов, касающихся загрузки элементов, мы ограничивались автоматически создаваемым объектом элемента, на который ссылается переменная loader. content. Теперь рассмотрим, как создавать новые дополнительные экземпляры загруженных элементов вручную.
Создание экземпляра элемента, загружаемого на этапе выполнения
Методика создания нового экземпляра элемента, загружаемого на этапе выполнения, зависит от того, чем является данный элемент: SWF-файлом или растровым изображением. В двух следующих разделах описывается процесс создания экземпляров обоих типов элементов.
Создание экземпляра загруженного SWF-файла
Чтобы создать новый экземпляр загруженного SWF-файла, мы должны сначала получить ссылку на основной класс этого SWF-файла. Как только ссылка на класс будет получена, мы используем оператор new для создания экземпляра. Существуют два основных подхода для получения ссылки на основной класс загруженного SWF-файла:
получить прямую ссылку на класс с помощью методик путей исходных файлов, путей библиотек или путей внешних библиотек, которые были рассмотрены ранее в разд. «Проверка типов на этапе компиляции для динамически загружаемых элементов»;
получить ссылку на класс с помощью метода экземпляра get Definition ( ) класса ApplicationDomain.
Рассмотрим оба подхода на примерах, снова обратившись к сценарию «приложение Main. swf загружает приложение Module. swf» из предыдущих разделов.
Предположим, что мы хотим создать новый экземпляр приложения Module. swf в приложении Main. swf. Сначала мы сделаем так, чтобы класс Module был непосредственно доступен для приложения Main. swf, используя методику путей исходных файлов, методику путей библиотек или методику путей внешних библиотек, которые были рассмотрены ранее. Повторяя изученный материал, напомним, что как только класс Module станет доступен для приложения Main. swf, мы сможем ссылаться на него напрямую, как показано в операции приведения, взятой из кода приемника события Event. INIT, представленного в листинге 28.9:
private function 1n1tL1stener (e:Event):void {
trace("1n1t"):
Module(e.target.content).start( ): // Прямая ссылка на класс Module }
Точно так же, чтобы создать новый экземпляр класса Module, мы просто используем оператор new:
private function 1n1tL1stener (e:Event):void {
var moduleObj:Module = new Module( ): }
Теперь предположим, что на этапе компиляции приложение Main, swf не имеет доступа к классу Module, но мы по-прежнему хотим создать новый экземпляр приложения Module . swf в приложении Main. swf. В подобной ситуации мы должны получить ссылку на класс Module, используя метод экземпляра get Defin i t ion ( ) класса ApplicationDomain. Когда в данный метод передается имя класса, он возвращает ссылку на указанный класс. Возвращенную ссылку можно присвоить переменной типа Class для использования в последующих операциях создания экземпляров. Следующий код демонстрирует общую методику:
var SomeCl ass: Cl ass = некийАрр11 cati onDomai п.де^еТзт^опСИмяНекоегоКласса" У var obj:Object = new SomeClassC );
Здесь некийАрр]7cationDomain — ссылка на объект ApplicationDomain SWF- файла, а имяНекоегоКласса — полностью уточненное строковое имя получаемого класса. Таким образом, чтобы получить ссылку на класс Module из приложения Main. swf, необходимо следующее:
ссылка на объект ApplicationDomain приложения Module . swf;
полностью уточненное имя класса Module.
К объекту ApplicationDomain SWF-файла можно обратиться через его объект Loaderinfo, который доступен через переменную loaderinfo любого экземпляра класса Displayobject данного SWF-файла. Полностью уточненное имя для основного класса SWF-файла можно получить с помощью метода flash. utils . getQualifiedClassName ( ). Как только приложение Module. swf будет загружено, внутри приемника события Event. INIT в приложении Main. swf мы можем использовать следующий код для получения ссылки на основной класс приложения Module. swf:
var ModuleClassName:String = getQual1f1edClassName(e.target.content):
var appDoma1n:App!1cat1onDoma1n =
. e.target.content.1oaderlnfo.appl1cationDomain:
// После выполнения следующей строки кода переменная ModuleClass будет
// ссылаться на основной класс приложения Module.swf
var ModuleClass:Cl ass = appDoma1n.getDef1n1t1on(ModuleClassName):
Получив ссылку на класс Module, мы можем использовать ее для создания новых объектов:
var newModule:Object = new ModuleClassC ):
“Как всегда, обязательно дождитесь завершения процесса инициализации загружаемого SWF
* * файла перед тем, как обратиться к нему. Метод getDefinition() должен применяться только после того, как среда выполнения Flash осуществит диспетчеризацию события Event.INIT.
Обратите внимание, что в предыдущем коде типом данных переменной newModule является Object, а не Module, поскольку в данном примере приложение Main. swf не имеет непосредственного доступа к основному классу приложения Module. swf. Таким образом, для любых последующих обращений к методам и переменным класса Module через переменную newModule типы не будут проверяться вплоть до этапа выполнения. Если проверка типов требуется на этапе компиляции, вместо метода getDefinition ( ) используйте методики путей исходных файлов, путей библиотек или путей внешних библиотек.
Стоит отметить, что методики, рассмотренные в этом разделе, можно применять не только для создания нового экземпляра SWE-файла, но и для создания экземпляра любого символа из этого SWF-файла. Предположим, что мы хотим создать экземпляр символа с именем Ball из приложения Module . swf. Для этого нам придется экспортировать символ Ball для кода на языке ActionScript, а затем выполнить одно из следующих действий:
получить ссылку на экспортированный класс Ball, используя метод экземпляра getDefinition ( ) классаApplicationDomain;
сделать так, чтобы класс Ball был непосредственно доступен для приложения Main. swf, используя методику путей исходных файлов, путей библиотек или путей внешних библиотек.
Создание экземпляра загруженного изображения
В отличие от элементов, представляющих SWF-файлы, новая копия загруженного элемента, представляющего изображение, не может быть создана с помощью оператора new. Вместо этого, чтобы создать новую копию загруженного элемента, представляющего изображение, мы должны создать копию пиксельных данных изображения и связать созданную копию данных с новым объектом Bitmap.
Как мы уже знаем, после завершения загрузки файла изображения загруженные пиксельные данные автоматически помещаются в объект BitmapData. Чтобы создать копию пиксельных данных загруженного изображения, мы вызываем метод BitmapData . clone ( ) над этим объектом BitmapData. Данная методика продемонстрирована в следующем коде. Этот код создает копию данных загруженного изображения и передает созданную копию данных в конструктор нового объекта Bitmap. Новый объект Bitmap будет являться копией загруженного элемента растрового изображения. Обращаться к загруженному элементу, как обычно, можно только после возникновения события Event. INIT.
private function initListener (e:Event):void {
// Переменная e.target.content ссылается на объект элемента.
// представляющего загруженное растровое изображение
var newlmage:Bitmap = new Bitmapte.target.content.bitmapData.clonet )):
// Переменная newlmage теперь содержит копию загруженного
// растрового изображения
Использование сокетов для загрузки отображаемых элементов на этапе выполнения
В начале этой главы мы узнали, что язык ActionScript предоставляет два различных механизма для добавления внешнего отображаемого элемента в приложение на этапе выполнения, а именно классы:
flash. display. Loader;
flash. net. Socket, применяемый совместно с методом loadBytes ( ) класса Loader.
Теперь, когда мы освоили применение класса Loader, рассмотрим, как он может быть использован совместно с классом Socket для получения отображаемых элементов непосредственно через сокет TCP/IP. Методика, описываемая в данном разделе, может применяться для загрузки элементов в приложении, в котором широко используются сокеты, например в многопользовательской игре, или просто для того, чтобы предотвратить появление загруженного элемента в кэше конечного пользователя.
Общий процесс получения отображаемых элементов непосредственно через сокет TCP/IP заключается в следующем.
Подключиться к серверу, который может передавать среде выполнения Flash файлы GIF, PNG, JPEG или SWF в бинарном формате.
Получить байты для желаемого элемента.
Преобразовать загруженные байты в объект элемента, пригодный для отображения на экране.
Для выполнения первых двух шагов мы используем класс flash. net. Socket языка ActionScript. Взаимодействие класса Socket с сервером осуществляется посредством формата бинарных данных (необработанных байтов). Для выполнения последнего шага мы используем метод экземпляра loadBytes ( ) класса Loader. Метод loadBytes ( ) преобразует необработанные байты в отображаемый объект языка ActionScript.
Описанный процесс подробно рассматривается в следующих разделах.
Серверная часть: отправка элемента
С помощью класса Socket мы можем получать байты для отображаемого элемента с любого сервера, который знает, как отправлять файлы GIF, PNG, JPEG или SWF в бинарном формате. Например, класс Socket может быть использован для получения изображений с большинства почтовых, новостных и чат-серверов — они все обычно поддерживают передачу изображений в бинарном формате.
Вместо того чтобы изучать процесс загрузки элемента с сервера существующего типа (например, почтового, новостного или чат-сервера), рассмотрим более законченный
сценарий, в котором мы разработаем не только клиента, функционирующего в среде выполнения Flash и получающего элемент, но и сервер, отправляющий данный элемент. Мы назовем наш собственный сервер именем FileSender и напишем его на языке Java. Поведение сервера FileSender чрезвычайно простое: при подключении нового клиента сервер автоматически отправляет этому клиенту один файл, затем передает ASCII-символ 4 (завершение передачи) и закрывает соединение.
Отметим, что поведение сервера FileSender полностью автоматизировано: клиенту не требуется запрашивать элемент с сервера или отправлять подтверждение о получении элемента в каком-либо виде. Данная архитектура позволяет сконцентрироваться исключительно на процессе передачи элемента.
В листинге 28.12 представлен исходный код на языке Java для сервера FileSender, любезно предоставленный Дереком Клейтоном (Derek Clayton) для этой книги.
Листинг 28.12. Сервер FileSender
Import java.net.ServerSocket:
Import java.net.Socket:
Import java.lo.lOExceptlon;
import java.lo.Inputstream:
Import java.lo.File:
Import java.lo.Fileinputstream:
Import java.lo.BufferedOutputStream;
* FileSender - это простой сервер, который принимает сонетное соединение
* и передает файл, после чего соединение закрывается.
*
* Использование: java FileSender [порт] [имя_файла]
* [порт] = порт, на котором сервер будет ожидать подключения (на всех
локальных IP-адресах)
[имя_файла] = путь к передаваемому файлу
*
*/
public class FileSender Implements Runnable {
private 1nt port:
private File file:
private String filename:
private ServerSocket server:
private Thread thlsThread:
private byte[] bytes:
public FileSenderdnt p, String f) {
port = p:
filename = f:
}
public void start( ) {
Inputstream 1s = null;
try {
// --- читаем файл в наш массив байтов file = new F11е(f11 ename);
is = new FilelnputStream(file);
bytes = new byteE(1 nt)f11e.1ength( )+!];
int offset = 0;
int byteRead = 0;
while (offset < bytes.length
&& (byteRead=is.read(bytes, offset, bytes.length-offset)) >= 0) {
offset += byteRead: }
bytes[bytes.length-1] = 4;
// --- создаем объект ServerSocket server = new ServerSocket(port);
} catch (Exception e) { e.printStackTrace( ): System.exit(1);
} finally { if (is ! = null) { try {
is.close( );
} catch (Exception e) { e.printStackTrace( ); System.exit(1);
}
}
// --- запускаем объект Thread, который будет принимать подключения thisThread = new Thread(this);
thisThread.start( );
public void run( ) {
// --- пока сервер активен...
while (thisThread != null) {
BufferedOutputStream ps = null;.
Socket socket = null ;
try {
// --- ...принимаем сокетные соединения
// (выполнение потока блокируется, пока не будет
// установлено соединение) socket = server.accept( );
// --- создаем выходной поток
ps = new BufferedOutputStream(socket.getOutputStream( ));
// --- записываем байты и закрываем соединение ps.write(bytes);
ps.close( );
ps = null: socket.close( ); socket = null;
} catch(Except1on e) { thlsThread = null; e.pr1ntStackTrace( );
} finally {
1f (ps != null) { try {
ps.close( );
} catch (lOExceptlon e) { e.pr1ntStackTrace( ); System.ex1t(1);
}
}
if (socket != null) { try {
socket.close( );
} catch (lOExceptlon e) { e.printStackTrace( ): System.exit(1):
}
}
// --- освобождаем ресурсы, занимаемые сервером if (server != null) {
try { server.close( );
} catch (lOExceptlon e) { e.pr1ntStackTrace( );
System.ex1t(l);
public final static void ma1n(Str1ng [] args) { // --- проверяем, все ли аргументы указаны 1f (args.length != 2) {
System.out.pr1ntln("usage: java FlleSender [port] [file]"):
System.ex1t(l);
try {
// --- преобразуем аргументы к их соответствующему типу
1nt port = Integer.parseInt(args[O]):
String filename = args[l];
// --- создаем и запускаем объект FlleSender
//(который будет выполняться
//в своем собственном потоке)
Fil eSender fs = new F1leSender(port, filename);
fs.starts );
} catch (Exception e) { e.pr1ntStackTrace( ); System.ex1t(l);
Исходный код для сервера FileSender можно загрузить по адресу http://moock.org/eas3/ # examples.
Чтобы запустить сервер FileSender, мы вводим следующую команду для среды выполнения Java:
java FileSender порт имяФайла
Здесь порт — это порт, на котором сервер будет принимать соединения, а имяФайла — имя файла, передаваемого сервером FileSender любому подключившемуся клиенту. Например, чтобы запустить сервер на порте 3000 и сконфигурировать его на отправку файла с именем photo . jpg, мы вводим следующую команду для среды выполнения Java:
java FileSender 3000 photo.jpg
Информацию об ограничениях безопасности, касающихся сокетных соединений, можно найти в гл. 19.
Клиентская часть: получение элемента
Мы только что рассмотрели код для пользовательского сервера, написанного на языке Java, который автоматически отправляет указанный файл любому подключившемуся клиенту. Теперь создадим соответствующего клиента на языке ActionScript, подключаемого к серверу и получающего файл.
В отличие от многих традиционных языков программирования, система сокетных взаимодействий языка ActionScript построена полностью на событиях.
В ActionScript невозможно приостановить выполнение программы, ожидая появления данных в сокете. Иными словами, сокетные операции языка ActionScript являются асинхронными, а не синхронными.
В языке ActionScript данные могут быть прочитаны из сокета только после того, как возникнет событие Р г ogres sEvent. SOCKET_DATA. Данное событие сообщает о том, что клиенту доступен некий произвольный объем новых данных для чтедия. Однако как только операция чтения новых данных будет завершена, клиент должен снова дожидаться возникновения следующего события Progres sEvent. SOCKET_DATA, чтобы прочитать дополнительные данные из сокета. Рассмотрим общее описание процесса.
Клиент подключается к сокету.
Сокет получает некоторые данные.
Возникает событие ProgressEvent. SOCKET_DATA.
Клиент считывает все доступные данные.
Сокет получает дополнительные данные.
Возникает событие ProgressEvent. SOCKET_DATA.
Клиент считывает все доступные данные.
Повторение шагов 5-7 до тех пор, пока не будет закрыт сокет.
Объем данных, которые появляются в сокете с возникновением каждого события ProgressEvent. SOCKET_DATA, полностью произволен. Зачастую данные, доступные клиенту при возникновении события ProgressEvent. SOCKET_DATA, составляют лишь часть большого целого. Таким образом, вы должны проявлять особую осторожность, выполняя ручную сборку всех необходимых данных перед их обработкой. Клиент может получить данные некоторого изображения, скажем, в трех сегментах, каждый из которых вызывает событие ProgressEvent. SOCKET_DATA. Перед тем как обработать все изображение целиком, клиентский код должен собрать эти три сегмента вместе.
Чтобы собрать небольшие сегменты данных в одно целое, клиент должен вручную добавлять каждый сегмент во временный массив байтов (то есть в «буфер байтов») по мере загрузки этого целого. «Целым» может быть файл, объект, готовая инструкция, почтовое сообщение, сообщение чата или любая другая логическая структура данных, которая должна обрабатываться как единый элемент. Всякий раз, когда появляется новый сегмент, клиент проверяет, не завершена ли загрузка всего целого. Если да, то клиент приступает к его обработке. Если нет, то клиент ожидает появления дополнительных данных.
Стоит отметить, однако, что не существует официального способа проверить, было ли полностью получено некоторое логическое тело данных. Каждый бинарный сокетный протокол предоставляет свои собственные механизмы, позволяющие определить момент завершения текущей передачи данных. Например, сервер может сообщить своему клиенту, сколько данных будет передано до начала следующей передачи, или клиент может проверять загружаемую последовательность байтов на наличие маркеров начала и конца файла. В нашем примере клиент будет приступать к обработке загруженного отображаемого элемента сразу после закрытия сокетного соединения сервером. Закрытие сокетного соединения — это (очень простой) способ сообщить нашему клиенту о завершении отправки данных некоторого элемента.
Посмотрим, как все это будет выглядеть в коде. Наш простой клиент, написанный на ActionScript, состоит из одного класса DisplayAssetLoader. Чтобы получить и отобразить элемент, отправляемый сервером FileSender, класс DisplayAssetLoader должен выполнить такую последовательность действий.
Создать объект Socket.
Зарегистрировать объект DisplayAssetLoader для событий объекта Socket.
Использовать объект Socket для подключения к серверу.
Когда через сокет будут получены новые бинарные данные, поместить эти данные во временный буфер.
Когда сокет отсоединится, использовать метод экземпляра loadBytes ( ) класса Loader, для того чтобы загрузить бинарные данные из временного буфера в объект Loader.
Отобразить объект загруженного элемента на экране.
В листинге 28.13 представлен весь код целиком для класса DisplayAssetLoader. Ключевые возможности класса DisplayAssetLoader обсуждаются после листинга; незначительные детали описываются в виде комментариев к коду.
Листинг 28.13. Класс DisplayAssetLoader
package {
Import flash.display
Import flash.events.*:
Import flash.net.*;
Import fl ash.text.*:
import flash.utils.*:
public class DisplayAssetLoader extends Sprite {
// Константа, представляющая ASCII-символ
// «завершение передачи»
public static const EOT:int = 4:
// Объект TextField, отображаемый на экране,
// в который выводятся
// статусные сообщения
private var statusField:TextField:
// Объект сокета, через который будет устанавливаться соединение
private var socket:Socket:
// Буфер байтов, в который по мере загрузки будут помещаться бинарные
// данные элемента
private var buffer:ByteArray = new ByteArrayC ):
// Объект Loader, используемый для генерации элемента из загруженных
// бинарных данных
private var loader:Loader:
// Конструктор класса
public function DisplayAssetLoader ( ) {
// Создаем объект TextField для отображения статусных сообщений
statusField = new TextF1eld( ):
statusField.border = true;
statusField.background = true;
statusField.width = statusField.height = 350;
addChild(statusField);
// Создаем объект сокета
socket = new Socket( ):
// Регистрируем приемники для событий сокета
socket.addEventListener(Event.CONNECT, connectListener);
socket.addEventListener(Event.CLOSE, closeListener);
socket.addEventListener(ProgressEvent.SOCKET JDATA,
socketDataListener);
socket.addEventListener(lOErrorEvent.IO_ERROR, ioErrorListener);
// Сообщаем пользователю, что сейчас мы попытаемся подключиться // к сокету
out("Attempting connection...");
// Пытаемся подключиться к сокету
try {
socket.connectClocalhost". 3000):
} catch (e;Error) {
out("Connect1on problem!\n");
out(e.message):
}
// Обрабатывает события подключения к сокету private function connectLIstener (e;Event);void {
out("Connected! Walting for data...");
// Обрабатывает вновь полученные данные
private function socketDataLlstener (e;ProgressEvent):void { outCNew socket data arrived.");
// Когда появляются новые байты, помещаем их в буфер для дальнейшей // обработки
socket.readBytes(buffer, buffer.length, socket.bytesAval1abl e);
// Обрабатывает события отключения сокета. Когда происходит отключение, // пытаемся сгенерировать отображаемый элемент из загруженных байтов, private function closeL1stener (e;Event);void {
// Сначала проверяем, был ли получен весь элемент целиком...
// Обращаемся к последнему байту в буфере
buffer.position = buffer.length - 1;
var lastByte;1nt = buffer.readllns1gnedByte( );
// Если байт «завершение передачи» отсутствует,
// значит, бинарные данные элемента загружены не полностью,
// поэтому элемент не создаем
1f (lastByte ! = D1splayAssetLoader.EOT) { return;
}
// Все в порядке, мы можем благополучно сгенерировать элемент из
// загруженных байтов. Последний байт в буфере не является частью
// элемента, поэтому отбрасываем его.
buffer.length = buffer.length - 1;
// Теперь создаем объект Loader, который сгенерирует элемент
// из загруженных байтов
loader = new Loader( );
// Генерируем элемент из загруженных байтов
1oader.1oadBytes(buffer);
// Ожидаем завершения процесса инициализации элемента
1oader.contenttoaderInfo.addEventt1stener(Event.IN IT,
assetlnltLIstener);
}
// Помещает элемент на экран после завершения процесса его инициализации private function assetIn1tL1stener (e:Event):void {
addChl1d(1oader.content);
outCAsset Initialized.");
}
// Обрабатывает ошибки ввода/вывода
private function 1oErrorL1stener (e:IQErrorEvent):void { outCI/O Error: " + e.text);
}
// Выводит статусные сообщения на экран и на отладочную консоль private function out (msg:*):void { trace(msg);
statusF1eld.appendText(msg + "\n");
}
Рассмотрим три основные части класса DisplayAssetLoader: создание и подключение к сокету, помещение байтов в буфер и создание отображаемого элемента из загруженных байтов.
Создание и подключение к сокету
Для установки сокетного соединения и управления им мы используем экземпляр класса Socket, который присваиваем закрытой переменной socket:
socket = new Socket( ):
Чтобы подключиться к сокету, мы используем метод экземпляра connect ( ) класса Socket. Однако поскольку сокетные соединения потенциально могут генерировать ошибки безопасности и ошибки ввода/вывода, мы помещаем вызов метода connect ( ) в блок try/catch:
try {
socket.connectClocalhost", 3000);
} catch (e:Error) {
out("Connection problem!\n");
out(e.message);
}
Помещение байтов в буфер
Как мы уже знаем, при получении новых данных через сокет среда Flash выполняет диспетчеризацию события ProgressEvent. SOCKET_DATA. Получателем данного события является объект Socket, получивший эти данные. Таким образом, чтобы получать уведомления о появлении новых данных, мы регистрируем в объекте socket приемник для события ProgressEvent. SOCKET_DATA, как показано в следующем коде:
socket.addEventL1stener(ProgressEvent.SOCKET_DATA. socketDataLIstener);
Всякий раз, когда возникает событие ProgressEvent. SOCKET_DATA, вызывается метод экземпляра socketDataListener ( ) класса DisplayAssetLoader. Внутри метода socket Da taListener ( ) переменная экземпляра byte sAvail able класса Socket обозначает количество байтов в сокете, доступных для чтения на настоящий момент. Метод socketDataListener ( ) добавляет новые полученные данные в объект ByteArray, на который ссылается переменная buffer. Чтобы прочитать новые данные и сохранить их в объекте buffer, мы используем метод экземпляра readBytes ( ) класса Socket, который принимает следующий общий вид: объект5оске1:. readBytes(байты, смещение, длина)
Здесь объектЗоскеб — это объект Socket, из которого будут прочитаны байты, байты — объект ByteArray, в который будут записаны байты, смещение — позиция внутри объекта байты, с которой начнется запись, а длина — количество байтов, которое будет прочитано из сокета. В нашем случае мы хотим прочитать все байты из сокета и сохранить их в объекте buffer, начиная с конца объекта buffer. Следовательно, мы используем такой код:
socket.readBytes(buffer, buffer.length, socket.bytesAval1able);
Рассмотрим полный листинг кода для метода socketDataListener ( ):
private function socketDataListener (e;ProgressEvent);void {
out("New socket data arrived.");
socket.readBytes(buffer, buffer.length, socket.bytesAval1able);
}
Создание отображаемого элемента из загруженных байтов
Как только все байты для элемента будут получены, мы можем использовать метод экземпляра loadBytes ( ) класса Loader для создания из этих байтов экземпляра класса Displayobject языка ActionScript. Напомним, что сервер FileSender сообщает о завершении передачи данных в полном объеме путем простого закрытия сокетного соединения. Поэтому мы помещаем код, создающий наш экземпляр класса DisplayObj ect («объект элемента»), в приемник события Event. CLOSE. Чтобы зарегистрировать приемник для события Event. CLOSE в объекте socket, мы используем следующий код:
socket.add EventL1stener(Event.CLOSE, closeL1stener);
Вфункции closeListener ( ) перед созданием экземпляра класса Displayobject мы сначала проверяем, был ли получен байт «завершение передачи» (ASCII-код 4) от сервера. Напомним, что сервер отправляет байт «завершение передачи» в качестве последнего байта потока данных. Чтобы получить этот байт, мы используем следующий код:
buffer.position = buffer.length - 1;
var lastByte:1nt = buffer.readllns1gnedByte( );
Если байт «завершение передачи» отсутствует, бинарные данные элемента были получены не полностью, и поэтому функция-приемник завершает свое выполнение: if (lastByte ’= DisplayAssetLoader.EOT) {
return;
Если байт «завершение передачи» был получен, мы создаем объект элемента с помощью метода loadBytes ( ). Тем не менее перед передачей байтов элемента в метод loadBytes ( ) мы должны сначала удалить байт «завершение передачи» из буфера, как показано в следующем коде:
buffer.length = buffer.length - 1:
Теперь, имея на руках байты элемента, мы можем создать объект элемента:
loader = new Loader( ): 1oader.1oadBytes(buffer):
После завершения выполнения предыдущего кода запускается процесс генерации объекта элемента, однако сам объект элемента пока недоступен. Как и в случае с методом экземпляра load ( ) класса Loader, если попытаться обратиться к объекту элемента через переменную loader. content сразу после вызова метода loadBytes ( ), будет возвращено значение null. Таким образом, перед тем как обратиться к объекту элемента, мы должны дождаться возникновения события Event. INIT:
1oader.contentLoaderInfo.addEventL1stener(Event.INIT.
assetlnltLIstener);
Когда элемент станет доступен, мы добавляем его на экран:
private function assetlnltLIstener (e:Event):void {
addCh11d(1oader.content):
outC'Asset 1n1t1alzed."):
Напомним, что при возникновении события Event. INIT становятся доступными элементы и объекты, созданные в конструкторе основного класса SWF-файла или в коде, который размещается в первом кадре временной шкалы SWF-файла, но при этом элементы и объекты, создаваемые во втором и последующих кадрах,, недоступны. Дополнительные сведения об обращении к визуальным элементам и объектам, создаваемым во втором и последующих кадрах, можно найти ранее в разд. «Обращение к элементам в многокадровых SWF-файлах».
Удаление SWF-элементов, загруженных на этапе выполнения
Чтобы удалить из приложения SWF-элемент, загруженный на этапе выполнения, мы должны сначала обнулить все ссылки на него в приложении, а затем либо обнулить все ссылки на объект Loader, загрузивший этот элемент, либо вызвать метод unload ( ) над данным объектом Loader.
Однако перед тем, как удалить элемент из приложения, мы должны деактивировать сам элемент и всех его отображаемых детей, если таковые имеются, чтобы после удаления он не продолжал потреблять системные и сетевые ресурсы.
Обычные задачи, необходимые для деактивации загруженного SWF-файла, распределяются между приложением, загрузившим этот элемент, и самим элементом.
Приложение, загрузившее элемент, перед удалением этого элемента должно выполнить следующее.
Если загрузка элемента еще не завершена, приложение должно прекратить операцию загрузки. Например: try {
theAssetLoader.close( );
catch (e:*) {}
При обнулении всех ссылок на элемент приложение должно удалить элемент из всех родительских экземпляров объекта DisplayObjectContainer. Например:
container.removeChi1d(theAsset);
Сам элемент перед удалением должен выполнить следующие задачи.
Сообщить любым загруженным дочерним SWF-элементам о необходимости деактивации.
Остановить воспроизведение любых звуковых файлов.
Остановить воспроизведение основной временной шкалы, если ее воспроизведение происходит в настоящий момент.
Остановить воспроизведение любых клипов, проигрываемых в настоящий момент.
Закрыть любые подключенные сетевые объекты, например экземпляры классов Loader, URLLoader, Socket, XMLSocket, Localconnection, NetConnections и NetStream.
Обнулить все ссылки на объекты Camera или Microphone.
Отменить регистрацию всех приемников событий (особенно это касается события Event. ENTER_FRAME, а также приемников событий мыши и клавиатуры).
Остановить все интервалы, выполняющиеся в настоящий момент (с помощью метода clearinterval ( )).
Остановить все объекты Timer (с помощью метода экземпляра stop ( ) класса Timer).
Элемент должен выполнять перечисленные задачи в собственном методе, освобождающем потребляемые ресурсы, который вызывается приложением перед удалением данного элемента.
За дополнительной информацией о деактивации элементов перед их удалением обратитесь к разд. «Деактивация объектов» гл. 14. Кроме того, прочитайте серию интернет-статей Гранта Скиннера (Grant Skinner) под названием «ActionScript 3.0: Resource Management», опубликованных по адресу http://www.gskinner.com/blog/ archives/2006/06/as3_resource_ma.html.
Мы познакомились со всеми методиками добавления внешнего элемента в приложение на этапе выполнения. Далее рассмотрим, как добавлять внешний отображаемый элемент в приложение на этапе компиляции.
Встраивание отображаемых элементов на этапе компиляции
Чтобы включить внешний отображаемый элемент в приложение, написанное на языке ActionScript, на этапе компиляции, мы используем тег метаданных [ Embed ]. Этот тег добавляет указанный внешний элемент в SWF-файл и делает этот элемент доступным для программы в виде определенного пользователем или автоматически сгенерированного класса. Экземпляры встроенного элемента создаются из этого класса с помощью стандартного синтаксиса оператора new языка ActionScript.
Тег метаданных [Embed] поддерживается приложением Flex Builder 2 и консольным компилятором mxmlc. Однако тег метаданных [Embed] не поддерживается приложением Adobe Flash CS3. Возможно, поддержка тега [Embed] появится в будущих версиях среды разработки Flash.
Для использования тега [Embed] мы должны предоставить компилятору доступ к библиотеке flex, swc, поддерживающей компилятор Flex. По умолчанию все проекты, создаваемые в приложении Flex Builder 2, автоматически включают библиотеку flex. s wc в пути библиотек языка ActionScript, поэтому в приложении Flex Builder 2 методики, рассматриваемые в данном разделе, будут работать без каких-либо специальных настроек компилятора.
Замечание по размеру файла и потреблению памяти
В отличие от методик загрузки элементов на этапе выполнения, рассмотренных в этой главе, встраивание отображаемого элемента на этапе компиляции с помощью тега метаданных [Embed] увеличивает размер SWF-файла, загружающего этот элемент, а также увеличивает объем используемой средой выполнения Flash памяти. По этой причине встраивать элемент на этапе компиляции необходимо только в том случае, когда вы абсолютно уверены в том, что приложению обязательно понадобится этот элемент. В противном случае загружать данный элемент следует на этапе выполнения по мере необходимости.
Например, представьте приложение, которое является электронным каталогом продукции с изображениями тысячи товаров и одним изображением экрана приветствия. Изображение экрана приветствия выводится при каждом запуске приложения, и, следовательно, его целесообразно встроить с помощью тега метаданных [Embed]. В отличие от этого, изображение товара необходимо только в том случае, когда пользователь просматривает нужный товар, и, следовательно, оно должно загружаться на этапе выполнения и удаляться, когда пользователь завершит просмотр этого товара.
Теперь, когда мы узнали, в каких случаях применяется тег [Embed], посмотрим, как использовать его на практике. В следующем разделе рассматривается обобщенный код, необходимый для использования тега [ Embed ]. В последующих разделах приведены конкретные примеры использования обобщенного кода, рассматриваемого в следующем разделе.
Обобщенный сннтакснс тега [Embed]
Тег метаданных [Embed] может применяться либо на уровне определения переменной экземпляра, либо на уровне определения класса.
Следующий код демонстрирует типовое использование тега [Embed] на уровне определения переменной:
[Embed (source="путьКФайлу") ]
private var ИмяКласса:С\а55;
При компиляции данного кода компилятор языка ActionScript автоматически генерирует новый класс, представляющий внешний элемент, местоположение которого определяется значением путьКФайлу, и присваивает этот класс закрытой переменной с именем ИмяКласса. Суперклассом нового класса является один из классов в пространстве имен mx.core, предназначенных для встраивания элементов. Как мы увидим в последующих разделах, выбор конкретного класса- прослойки зависит от типа встраиваемого элемента. Значение путьКФайлу должно определять местоположение файла элемента с помощью одного из следующих способов:
абсолютной ссылки, предоставляющей компилятору доступ к элементу на локальном компьютере (например, с: /assets/photo. jpg);
относительной ссылки, сформированной по отношению к исходному файлу на языке ActionScript, из которого происходит встраивание элемента (например, . . /images/photo . jpg).
Стоит отметить, что, поскольку переменная ИмяКласса ссылается на класс, ее типом данных является Class. Когда переменная ссылается на объект Class, первая буква в имени этой переменной обычно записывается в верхнем регистре (в соответствии с общепринятым стилем именования классов).
Установив связь между встраиваемым элементом и переменной ИмяКласса, мы используем следующий знакомый нам код для создания нового экземпляра элемента.
new ИмяКласса^ );
Теперь вернемся к обобщенному синтаксису для использования тега метаданных [Embed] на уровне определения класса. Следующий код демонстрирует общий подход:
[Embed (source=" путьКФайлу") ]
public class ИмяКласса extends ТипЭлемента { }
При выполнении предыдущего кода внешний элемент, путь к которому определяется значением путьКФайлу, связывается с классом ИмяКласса. Класс ИмяКласса должен быть определен с использованием модификатора управления доступом public и должен расширять класс ТипЭлемента, который является одним из классов-прослоек пространства имен mx. core платформы разработки Flex, предназначенных для встраивания элементов. В последующих разделах будет рассмотрено, какие конкретные классы-прослойки должны применяться для различных типов элементов, встраиваемых на уровне класса.
Чтобы создать новый экземпляр элемента, встроенного на уровне класса, мы снова используем следующий стандартный код:
new ИмяКласса( );
Поддерживаемые типы элементов
При использовании тега метаданных [ Embed ] либо на уровне переменной, либо на уровне класса, поддерживаются следующие типы отображаемых элементов:
растровые изображения в формате GIF, JPEG или PNG;
файлы в формате SVG;••
символы из SWF-файлов предыдущих версий (то есть в формате приложения Flash Player 8 или более старых версий);
любой файл, представляющий бинарные данные.
Кроме того, встраивание SWF-файлов целиком, независимо от их версии, поддерживается тегом [Embed] только на уровне определения переменной.
Стоит отметить, что с помощью тега метаданных [Embed] нельзя встроить отдельные символы и классы из SWF-файла в формате приложения Flash Player 9 (или более поздних версий). Вместо этого для обращения к отдельным символам и классам следует использовать один из следующих способов.
Встроить SWF-файл символа или класса на уровне переменной (дополнительные сведения можно получить в подразд. «Встраивание SWF-файлов целиком»), а затем использовать метод экземпляра getDefinition ( ) класса ApplicationDomain для обращения к этому символу или классу (дополнительную информацию можно найти в подразд. «Использование метода getDefinition( ) для обращения к классу во встроенном SWF-файле»).
Встроить SWF-файл символа или класса в виде бинарных данных (дополнительную информацию можно найти в подразд. «Встраивание файлов в виде бинарных данных»), а затем использовать метод экземпляра getDefinition ( ) класса ApplicationDomain для обращения к этому символу или классу (дополнительные сведения можно получить в подразд. «Использование метода getDefinition( ) для обращения к классу во встроенном SWF-файле»).
Создать ссылку на SWC-файл, содержащий класс или символ (дополнительную информацию можно найти в подразд. «Предоставление компилятору доступа к загружаемому классу» разд. «Проверка типов на этапе компиляции для динамически загружаемых элементов»).
Помимо отображаемых элементов, рассматриваемых в данном разделе, тег метаданных [Embed] может применяться для встраивания звуковых файлов и шрифтов.
Информацию по встраиванию звуковых файлов можно найти в разделе Flex Programming Topics ► Embedding Assets руководства разработчика на платформе Flex 2 корпорации Adobe.
Информацию о встраивании шрифтов можно найти в разд. «Шрифты и отображение текста» гл. 27. Дополнительную информацию также можно найти в разделе
Customizing the User Interface ► Using Fonts ► Using Embedded fonts ► Embedded font syntax ► Embedding Fonts in ActionScript руководства разработчика на платформе Flex 2 корпорации Adobe.
Теперь, когда мы познакомились с основным кодом, используемым для встраивания внешнего элемента на этапе компиляции, рассмотрим несколько конкретных примеров. .
Встраивание растровых изображений
Следующий код демонстрирует, как встроить изображение с именем photo. jpg на уровне переменной. Код предполагает, что файл класса, из которого происходит встраивание изображения, и файл изображения находятся в одной директории. При выполнении этого кода среда Flash автоматически генерирует класс, представляющий элемент photo. j pg, и присваивает этот класс переменной Photo, позволяя создавать экземпляры данного элемента на этапе выполнения. Этот автоматически сгенерированный класс расширяет класс mx. core. BitmapAsset.
ЕEmbed(source="photo.jpg")] private var Photo:Cl ass;
Следующий код показывает, как встраивать изображение photo. jpg на уровне класса. Снова предполагается, что файл класса и файл элемента находятся в одной директории. Обратите внимание, что по необходимости класс расширяет класс mx.core.BitmapAsset.
package {
Import mx.core.BitmapAsset;
EEmbed(source="photo.jpg")]
public class Photo extends BitmapAsset {
}
}
Чтобы создать новый экземпляр встроенного изображения, мы используем следующий код (независимо от того, было изображение встроено на уровне переменной или на уровне класса):
new Photo( )
Присваивая экземпляр встроенного изображения переменной, в качестве типа данных этой переменной мы выбираем либо класс mx. core. BitmapAsset (для элементов, встраиваемых на уровне переменной), либо класс Photo (для элементов, встраиваемых на уровне класса):
var photo:BitmapAsset = new Photo( ); // Уровень переменной
var photo:Photo = new Photo( ):// Уровень класса
Созданный экземпляр, как и любой другой отображаемый объект, может быть добавлен в список отображения:
addChild(photo);
Обратите внимание, что тег метаданных [ Embed] поддерживает механизм форматирования scale-9 для встраиваемых растровых изображений. Если для встраивае-
мого растрового изображения применяется механизм форматирования scale-9, то автоматически сгенерированный класс расширяет класс mx. core. SpriteAsset, а не класс mx. core.BitmapAsset. Подробную информацию о механизме форматирования scale-9 и встраиваемых растровых изображениях можно найти в разделе Flex Programming Topics ► Embedding Assets ► Embedding asset types ► Using scale-9 formatting with embedded images руководства разработчика на платформе Flex 2 корпорации Adobe.
Встраивание файлов в формате SVG
Следующий код демонстрирует, как встроить изображение в формате SVG с именем line. svg на уровне переменной. Код предполагает, что файл класса, из которого происходит встраивание изображения в формате SVG, и файл изображения в формате SVG находятся в одной директории. При выполнении этого кода среда Flash автоматически генерирует класс, представляющий элемент line. svg, и присваивает этот класс переменной SVGLine, позволяя создавать экземпляры данного элемента на этапе выполнения. Этот автоматически сгенерированный класс расширяет класс mx. core. SpriteAsset.
[Embed(source=" 1i ne.svg")]
private var SVGL1ne:Cl ass:
Следующий код показывает, как встраивать изображение в формате SVG с именем line. svg на уровне класса. Снова предполагается, что файл класса и файл элемента находятся в одной директории. Обратите внимание, что по необходимости класс расширяет класс mx. core. SpriteAsset.
package {
import mx.core.SpriteAsset;
[Embed(source="1i ne.svg")]
public class SVGLine extends SpriteAsset {
}
}
Чтобы создать новый экземпляр встроенного изображения в формате SVG, мы используем следующий код (независимо от того, было изображение в формате SVG встроено на уровне переменной или на уровне класса):
new SVGLinet )*
Присваивая экземпляр встроенного изображения в формате SVG переменной, в качестве типа данных этой переменной мы выбираем либо класс mx.core.SpriteAsset (для элементов, встраиваемых на уровне переменной), либо класс SVGLine (для элементов, встраиваемых на уровне класса):
var line:SpriteAsset = new SVGLineC ): // Уровень переменной
var line: SVGLine = new SVGLineC ):// Уровень класса
Созданный экземпляр, как и любой другой отображаемый объект, может быть добавлен в список отображения:
addChild(line);'
Встраивание SWF-файлов целиком
Следующий код демонстрирует, как целиком встроить SWF-файл с именем Арр. swf на уровне переменной. Код предполагает, что файл класса, из которого происходит встраивание SWF-файла, и сам SWF-файл находятся в одной директории. При выполнении этого кода среда Flash автоматически генерирует класс, представляющий элемент Арр. swf, и присваивает этот класс переменной Арр, позволяя создавать экземпляры данного элемента на этапе выполнения. Этот автоматически сгенерированный класс расширяет класс mx. core. MovieClipLoaderAsset.
[Embed(source="Арр.swf")]
private var App:Class;
Целиком SWF-файлы могут быть встроены только на уровне переменной.
Чтобы создать новый экземпляр встроенного SWF-файла, мы используем следующий код:
new Арр( )
Присваивая экземпляр встроенного SWF-файла переменной, в качестве типа данных этой переменной мы выбираем класс mx. core .MovieClipLoaderAsset: var app:MovieClipLoaderAsset = new App( );
Созданный экземпляр, как и любой другой отображаемый объект, может быть добавлен в список отображения:
addChlld(app);
Встраивание символов из SWF-файлов предыдущих версий
Следующий код демонстрирует, как на уровне переменной встроить отдельный символ с именем Ball из SWF-файла с именем fp8app. swf в формате приложения Flash Player 8 или более ранней версии. Код предполагает, что файл класса, из которого происходит встраивание символа, и SWF-файл, содержащий этот символ, находятся в одной директории. При компиляции этого кода компилятор языка ActionScript автоматически генерирует класс, представляющий символ Ball, и присваивает этот класс переменной FP8Ball, позволяя создавать экземпляры данного символа на этапе выполнения. Автоматически сгенерированный класс расширяет класс элемента из пространства имен mx. core, соответствующий типу символа Ball (то есть классы MovieClipAsset, TextFieldAsset, ButtonAsset или класс Spr i teAs set для клипов, состоящих из одного кадра). В коде обратите внимание на использование дополнительного параметра symbol тега [Embed]:
[Embed(source="fp8app.swf". symbol="Bal 1")] private var FP8Ball:Class;
Следующий код демонстрирует, как на уровне класса встроить отдельный символ с именем Ball из SWF-файла с именем f р8арр. swf в формате приложения Flash Player 8 или более ранней версии. Вновь предполагается, что файл класса и файл
элемента находятся в одной директории. В этом примере мы считаем, что символ Ball является клипом, поэтому класс элемента по необходимости расширяет класс mx.core.MovieClipAsset.
package {
import mx.core.MovieClipAsset;
[Embed(source="fp8app.swf". symbol="Ball")]
public class FP8Ball extends MovieClipAsset {
Чтобы создать новый экземпляр встроенного символа, мы используем следующий код (независимо от того, был символ встроен на уровне переменной или на уровне класса):
new FPSBalK )
Если символ был встроен на уровне переменной, то при присваивании экземпляра этого символа переменной в качестве ее типа данных мы выбираем класс элемента из пространства имен mx. core, соответствующий типу символа (то есть один из классов MovieClipAsset, TextFieldAsset или ButtonAsset). Например, наш символ Ball является клипом, поэтому экземпляры класса FP8Ball должны присваиваться переменным типа MovieClipAsset.
var fpSball:MovieClipAsset = new FPSBalK );
Если символ был встроен на уровне класса, то в качестве типа данных этой переменной мы выбираем класс, который использовался для встраивания символа. Например:
var fp8ball :FP8Ball = new FPSBalK ):
Созданный экземпляр, как и любой другой отображаемый объект, может быть добавлен в список отображения:
addChild(fpSball):
Встраивание файлов в виде бинарных данных ■
Тег метаданных [Embed] может применяться для встраивания в приложение бинарных данных (байтов) из любого файла в виде массива байтов. В дальнейшем приложение может работать с этими байтами. Например, если встраиваемые бинарные данные представляют файл в формате GIF, JPEG, PNG или SWF, то приложение может использовать класс Loader для преобразования этих данных в отображаемый элемент.
В следующем коде мы встраиваем SWF-файл с именем f р 9арр. swf, имеющий формат приложения Flash Player 9, в виде бинарных данных на уровне переменной. Этот код предполагает, что файл класса, из которого происходит встраивание бинарных данных, и файл, содержащий эти данные, находятся в одной директории. При выполнении этого кода среда Flash автоматически генерирует класс, представляющий бинарные данные, и присваивает этот класс переменной FP9BinaryData, позволяя использовать данные на этапе выполнения. Автоматически сгенерированный класс
расширяет класс mx. core. By teArrayAsset. В приведенном коде обратите внимание на использование дополнительного параметра mimeType тега [ Embed]: [Embed(source="fp9app.swf", mimeType="application/octet-stream")] private var FP9BinaryData-.Class;
В следующем коде мы встраиваем SWF-файл с именем fp9app. swf, имеющий формат приложения Flash Player 9, в виде бинарных данных на уровне класса. Снова предполагается, что файл класса и файл элемента находятся в одной директории. Обратите внимание, что по необходимости этот класс расширяет класс mx.core.ByteArrayAsset.
package {
import mx.core.ByteArrayAsset;
[Embed(source="fp9app.swf", mimeType="application/octet-stream")] public class FP9BinaryData extends ByteArrayAsset {
}
}
Чтобы создать новый экземпляр встроенных бинарных данных, мы используем следующий код (независимо от того, были данные встроены на уровне переменной или на уровне класса):
new FP9B1naryData( )
Присваивая экземпляр встроенных бинарных данных переменной, в качестве типа данных этой переменной мы выбираем либо класс mx. core. ByteArrayAsset (для элементов, встраиваемых на уровне переменной), либо класс, который применялся для встраивания символа (для элементов, встраиваемых на уровне класса):
var fp9binarydata:ByteArrayAsset = new FP9BinaryData( ); // Уровень
.// переменной
var fp9binarydata:FP9BinaryData = new FP9BinaryData( );// Уровень класса
Если встроенные бинарные данные представляют файл в формате GIF, JPEG, PNG или SWF, то после создания экземпляра этих данных мы можем использовать класс Loader для генерации отображаемого элемента, как показано в следующем коде:
var loader .-Loader = new Loader ( );
1oader.1oadBytes(fp9binarydata):
addChi1d(1oader);
После инициализации элемент может быть добавлен в список отображения с помощью методик, рассмотренных ранее в подразд. «Отображение загруженного элемента на экране» разд. «Использование класса Loader для загрузки отображаемых элементов на этапе выполнения».
Методика встраивания элемента в виде бинарных данных может использоваться для встраивания в приложение файлов XML на этапе компиляции. Это демонстрирует листинг 28.14.
Листинг 28.14. Встраивание XML-файла на этапе компиляции
package {
import flash.display.*;
Import fl ash.events.*;
Import flash.utlls.ByteArray:
public class EmbedXML extends Sprite {
[Embed(source="embeds/data.xml", m1meType="appl1cat1on/octet-stream")] private var B1naryData:Class;
public function EmbedXML ( ) {
// Создаем новый экземпляр встроенных данных var byteArray:ByteArray = new B1naryData( );
// Преобразуем экземпляр данных в XML-файл
var data:XML = new XML(byteArray.readUTFBytes(byteArray.length));
// Отображаем исходный код для встроенного XML-файла trace(data.toXMLStr1ng( ));
Использование метода getDefinition() для обращения к классу во встроенном SWF-файле
Как мы уже знаем, отдельные символы и классы из SWF-файла в формате приложения Flash Player 9 (или более поздних версий) не могут быть встроены с помощью тега метаданных [Embed]. Вместо этого, чтобы обратиться к классу или классу символа во встроенном SWF-файле, мы можем создать ссылку на SWC-файл, содержащий желаемый класс или класс символа, либо использовать метод экземпляра getDefinition ( ) класса ApplicationDomain для обращения к желаемому классу или классу символа на этапе выполнения.
При использовании метода getDefinition ( ) перед попыткой обращения к символам или классам SWF-файла мы должны убедиться, что его экземпляр был про- инициализирован. Для этого мы регистрируем приемник в объекте Loaderinfo объекта встроенного элемента для событий Event. INIT. В зависимости от того, как происходит встраивание SWF-файла, мы обращаемся к объекту Loader Inf о различными способами. Если SWF-файл был встроен непосредственно на уровне переменной, то мы используем следующий код, чтобы зарегистрировать приемник для событий Event .INIT:
// Создаем экземпляр элемента
var зкземплярВстроенногоЭлемента:Мо\леСАА^оа^ = new ИмяКласса( );
// Регистрируем приемник для события Event.INIT
Loader(зкземплярВстроенногоЭлемента.getCh11dAt(0)).contentLoaderInfо. addEventL1stener(
Event.INIT,
приемникСобытия!М1В;
В приведенном коде ИмяКласса — переменная, которая ссылается на класс, представляющий встроенный SWF-файл, зкземплярВстроенногоЭлемента — экземпляр класса
ИмяКласса, а приемникСобытия!М1Т — ссылка на функцию, которая будет выполняться при инициализации экземпляра.'
С другой стороны, если SWF-файл был встроен в виде бинарных данных, мы используем следующий код, чтобы зарегистрировать приемник для получения уведомлений о возникновении события Event. INIT:
// Создаем экземпляр элемента
van БинарныеДанные:ву^гга^55^ = new БинарныеДанные^ );
// Генерируем отображаемый объект, представляющий SWF-файл
van loader:Loader = new Loader( );
loader. loadBytesC^apwe^a^b/e);
addChl1d(1oader);
// Регистрируем приемник для события Event.INIT
1oader.contentLoaderInfo.addEventLIstener(Event.INIT,
приемникСобытия1М1В;
Здесь БинарныеДанные — переменная, которая ссылается на класс, представляющий бинарные данные встроенного SWF-файла, БинарныеДанные — экземпляр класса БинарныеДанные, а приемникСобытия!М1Т, как и раньше, — ссылка на функцию, которая будет выполняться при инициализации экземпляра данного SWF-файла.
Следующий код демонстрирует пример приемника события Event .INIT, который получает ссылку на класс символа клипа с именем Ball. Этот код также создает экземпляр символа Ball и добавляет его в иерархию отображения класса метода initListeiier ( ).
private function 1n1tL1stener (e;Event);void {
// Получаем ссылку на символ Ball из встроенного SWF-файла
var Ball Symbol:Cl ass =
e.target.content.1oaderInfo.appl1cat1onDomaln.getDef1n111on("Bal 1"):
// Создаем новый экземпляр символа Ball
var ball:Mov1eCl1p = Mov1eCl1p(new BallSymboK ));
// Помещаем экземпляр символа Ball на экран addCh1ld(ball);
}
Пример использования тега [Embed]
Для справки в листинге 28.15 показан класс, который демонстрирует сценарии использования тега [ Embed ] на уровне переменной, рассмотренные в предыдущих разделах.
Листинг 28.15. Класс, демонстрирующий встраивание элементов на уровне переменной package {
Import flash.display.*;
Import flash.events.*;
import mx.core.MovieClipAsset;
1mport mx.core.Mov1eCi 1pLoaderAsset;
import mx.core.SpriteAsset;
import mx.core.BitmapAsset;
import mx.core.ByteArrayAsset;
public class VariableLevelEmbedDemo extends Sprite {
[Embed(source="photo.jpg")] private var Photo:Cl ass;
[Embed(source="1ine.svg")] private var SVGLine:Class;
[Embed(source="fp9app.swf")] private var FP9App:Cl ass;
[Embed(source="fp8app.swf", symbol="Ball")] private var FPSBall-.Class;
[Embed(source="fp9app.swf", mimeType="application/octet-stream")] private var FP9BinaryData;Class;
public function VariableLevelEmbedDemo ( ) {
// Растровое изображение, встраиваемое
// на уровне переменной
var photo:BitmapAsset = new Photo( );
addChi1d(photo):
// Файл в формате SVG, встраиваемый на уровне переменной
var 11 ne:SpriteAsset = new SVGLineC ): addChi1d(11 ne);
// Символ SWF-файла в формате приложения Flash Player 8, встраиваемый // на уровне переменной
var fpSball:MovieCIipAsset = new FPSBall( ); addChi1d(fp8bal1);
// SWF-файл в формате приложения Flash Player 9, встраиваемый
// на уровне переменной
var fp9app:Mov1eCiipLoaderAsset = new FP9App( );
addChild(fp9app);
// Чтобы обратиться к классу символа или к обычному классу
// во встроенном SWF-файле, необходимо дождаться завершения
// инициализации данного SWF-файла
Loader(fp9app.getChi 1 dAt(0)).contentLoaderInfo.addEventListener( Event.INIT, fp9appInitListener);
// Бинарные данные (SWF-файл в формате приложения Flash Player 9), // встраиваемые на уровне переменной
var fp9binarydata:ByteArrayAsset = new FP9BinaryData( );
var loader:Loader = new Loader( );
1 oader. 1 oddBytes (f р9Ы narydata);
addChild(loader);
// Чтобы обратиться к классу символа или к обычному классу
// во встроенном SWF-файле, необходимо дождаться завершения
// инициализации данного SWF-файла
1oader.contentLodderlnfo.addEventLIstener(Event.INIT,
fp9b1narydataInitL1stener);
}
private function fp9appInitListener (e;Event);void {
// Получаем ссылку на символ Ball из встроенного SWF-файла var Ball Symbol .-Class =
e.target.content.1 odderInfo.applicationDomain.getDefinition("Bal 1");
// Создаем новый экземпляр символа Ball
var bal1;MovieCIip = MovieClip(new Ball Symbol( ));
// Устанавливаем положение экземпляра символа Ball и помещаем его
// на экран
bal1.х = 220;
ball.у = 240;
addChild(ball);
}
private function fp9binarydatalnittistener (e;Event):void {
// Получаем ссылку на символ Ball из встроенного SWF-файла var BallSymbol:Class =
e.target.content.1oaderInfo.applicationDomain.getDefi ni tion("Ball");
// Создаем новый экземпляр символа Ball
var ball:MovieClip = MovieCIip(new BallSymboK ));
// Устанавливаем положение экземпляра символа Ball и помещаем его
// на экран
ball.у = 200;
addChild(ball);
}
}
}
Очищайте проект, чтобы увидеть изменения
Мы рассмотрели несколько способов, позволяющих встроить внешний отображаемый элемент в приложение. Обычно, когда файл встраиваемого элемента изменяется, эти изменения автоматически отражаются при следующей компиляции связанного приложения. Однако в приложении Flex Builder 2 при повторной компиляции приложения изменения в элементах иногда могут не отражаться. Чтобы гарантировать, что все изменения в элементе будут отражены на этапе компиляции, очистите проект приложения, как описано ниже.
Выберите команду меню Project ► Clean (Проект ► Очистить).
В окне Clean (Очистка) выберите проект, который вы желаете очистить.
Нажмите кнопку ОК.
К части III
К части III
В предыдущих 28 главах мы рассмотрели огромное количество основополагающих вопросов, связанных с программированием на языке ActionScript, и наше путешествие почти подошло к концу! В последней части этой книги мы рассмотрим три прикладных вопроса программирования на языке ActionScript: программирование в среде разработки Flash, использование платформы разработки Flex «исключительно».через язык MXML и распространение группы классов для применения в родительском приложении.
Практическое применение Actionscript
В части III основное внимание уделяется вопросам применения кода, написанного на языке ActionScript. В этой части освещаются такие темы, как объединение кода на ActionScript с элементами, созданными вручную в среде разработки Flash, использование платформы разработки Flex в приложении Flex Builder 2 и создание библиотеки пользовательского кода.
Завершив изучение части III, вы приобретете практические навыки, необходимые для разработки приложений на языке ActionScript с помощью среды разработки Flash и приложения Flex Builder 2. Кроме того, вы узнаете о способах распространения кода между другими разработчиками или по всему миру.
Глава 29 «Язык ActionScript и среда разработки Flash».
Глава 30 «Минимальное приложение на языке MXML».
Глава 31 «Распространение библиотеки классов».
Язык Actionscript и среда разработки Flash
В гл. 1 было рассказано, что среда разработки Flash может быть использована для связывания кода на языке ActionScript с изображениями, анимацией и мультимедийными элементами. Теперь, когда мы хорошо знакомы с основами языка ActionScript, рассмотрим важные связи между ActionScript и содержимым, создаваемым в среде разработки Flash.
Чтобы помочь программистам, приходящим из других языков и сред, некоторые концепции, представленные в этой главе, рассматриваются с точки зрения новичка в среде разработки Flash. Таким образом, часть представленного материала будет являться своего рода обзором для опытных пользователей среды разработки Flash.
Файлы примеров, рассматриваемых в этой главе, вы можете загрузить по адресу http://www.moock.org/eas3/examples.
Документ Flash
В процессе изучения данной книги мы создали множество SWF-файлов, используя «настоящий код» (то есть один или несколько классов языка ActionScript). В отличие от этого, в среде разработки Flash SWF-файлы создаются с помощью графического интерфейса, предназначенного для создания изображений, анимации и интерактивного мультимедийного содержимого.
Чтобы создать SWF-файл в среде разработки Flash, мы должны сначала сформировать документ Flash, или FLA-файл. Он описывает размещение тела мультимедийного содержимого во времени. Чтобы создать FLA-файл, пригодный для использования с кодом на языке ActionScript 3.0, выполните следующие шаги.
В среде разработки Flash выберите команду меню File ► New (Файл ► Создать).
На вкладке General (Общие) окна New Document (Новый документ) в списке Туре (Тип) выберите значение Flash File (ActionScript 3.0) (Файл Flash (ActionScript 3.0)).
Нажмите кнопку OK.
Из FLA-файламы можем скомпилировать (или экспортировать) соответствующий SWF-файл для дальнейшего воспроизведения в среде выполнения Flash.
Чтобы экспортировать SWF-файл для отладки в среде разработки Flash, мы используем команду меню Control ► Test Movie (Управление ► Проверка фильма). Чтобы
экспортировать SWF-файл для последующего распространения в Интернете, мы используем команду меню File ► Publish (Файл ► Опубликовать). SWF-файл, экспортированный из среды разработки Flash, может также распространяться в виде настольного приложения; дополнительную информацию можно найти в документации по приложению Adobe AIR.
Временные шкалы и кадры
Структурно FLA-файл представлен в виде иерархии анимаций, каждая из которых имеет собственную временную шкалу. Временная шкала — это линейная последовательность кадров, похожая на обычный диафильм. Каждый кадр может содержать аудио, видео, текст, векторную и растровую графику, а также содержимое, создаваемое программным путем.
При экспортировании SWF-файла из FLA-файла компилятор Flash конвертирует временные шкалы FLA-файла в файловый формат Flash (SWF), подходящий для воспроизведения в клиентской среде выполнения Flash. При воспроизведении SWF-файла кадры из временных шкал FLA-файла отображаются на экране, быстро сменяя друг друга, создавая тем самым эффект анимации. Скорость, с которой в среде выполнения Flash происходит смена кадров, обусловлена скоростью кадров, измеряемой в кадрах в секунду (дополнительную информацию по скорости кадров можно найти в гл. 23).
Хотя некоторые FLA-файлы включают всего одну временную шкалу, большинство из них содержит несколько временных шкал, позволяя создавать содержимое отдельными частями и объединять их вместе, формируя более сложную анимацию. Например, сцена, изображающая движение автомобиля вниз по горной дороге, может включать три временные шкалы: одну для медленного перемещения гор, другую для быстрого перемещения дороги и третью для вращения колес автомобиля.
Первая временная шкала, создаваемая в новом FLA-файле, называется основной временной шкалой. Она формирует фундамент для всего содержимого, добавляемого в FLA-файл.
Для создания каждого кадра содержимого на временной шкале мы можем либо импортировать внешние элементы, либо создавать новую графику с помощью встроенных инструментов рисования среды разработки Flash (например, Pencil (Карандаш), Brush (Кисть) и Text (Текст)). Графика каждого кадра помещается в визуальное рабочее пространство, называемое сценой (Stage).
Не путайте сцену среды разработки Flash с классом Stage языка ActionScript: сцена среды разработки Flash является рабочим пространством для создания содержимого, а класс Stage языка ActionScript представляет корневой элемент в списке отображения среды выполнения Flash.
На рис. 29.1 изображен простой FLA-файл hello. На, открытый в среде разработки Flash. В верхней половине рисунка показана основная временная шкала FLA-файла, которая в данном случае содержит два кадра. В нижней части рисунка показана
сцепа, которая отображае т содержимое выбранного кадра. В данном случае выбранный кадр является первым кадром основной временной шкалы, обозначаемым тонкой вертикал иной линией, проходящей через кадр на временной шкале. Эта тонкая линия обозначает выбранный кадр и называется головкой воспроизведения.
Рис. 29.1. Файл hello.fla, показан кадр 1 основной временной шкалы
На рис. 29.2 снова изображен файл hello . fla, но на этот раз на основной временной шкале выбран кадр 2. Обратите внимание, что положение головки воспроизведения, обозначающей выбранный кадр, сместилось вправо. Соответственно, на сцене сейчас отображается содержимое кадра 2.
Ключевые и обычные кадры. В среде разработки Flash определены два типа кадров: ключевые и обычные. Хотя рассмотрение анимации Flash выходит за рамки данной книги, понимание различий между ключевыми и обычными кадрами является неотъемлемым условием для разработки сценариев, рассматриваемых в следующем разделе.
Рис. 29.2. Файл hello.fla, показан кадр 2 основной временной шкалы
Ключевой кадр — это кадр, у которого находящееся на сцене содержимое отличается от содержимого предыдущего кадра. Чтобы добавить новый ключевой кадр на временную шкалу, мы используем команду меню Insert ► Timeline ► Keyframe (Вставка ► Временная шкала ► Ключевой кадр).
В отличие от этого, обычный кадр — это кадр, у которого находящееся на сцене содержимое автоматически образуется (повторяется) из содержимого предыдущего ближайшего ключевого кадра. Чтобы добавить новый обычный кадр на временную шкалу, мы используем команду меню Insert ► Timeline ► Frame (Вставка ► Временная шкала ► Кадр).
Добавляя обычные кадры на временную шкалу, мы увеличиваем время, в течение которого изображение на экране остается неизменным. Добавляя ключевые кадры на временную шкалу, мы можем изменить содержимое, отображаемое на экране (обычно для создания эффекта анимации).
Предположим, что мы создаем анимацию, в которой человечек бежит к дому, на мгновение останавливается перед дверью, а затем убегает прочь. Когда человечек бежит к дому, каждый кадр анимации имеет различное содержимое, поэтому все соответствующие кадры должны быть ключевыми. Когда человечек находится перед дверью, каждый кадр анимации имеет одинаковое содержимое (поскольку человечек не двигается), поэтому все соответствующие кадры могут быть обычными. Когда человечек убегает прочь от дома, каждый кадр анимации снова имеет различное содержимое, поэтому все соответствующие кадры должны быть ключевыми.
На рис. 29.3 показаны кадры нашей анимации с бегущим человечком, которую пришлось сильно сократить, чтобы уместить в данной книге. Кадры 1,2,3,8 и 9 являются ключевыми, каждый из которых имеет свое собственное содержимое. Кадры 4-7 являются обычными, содержимое которых переносится из кадра 3. На рисунке содержимое кадров 4-7 изображено серым цветом — это значит, что оно переносится из кадра 3. На рисунке ключевые кадры отмечены буквой К, а обычные кадры — буквой R.
1 23456789
л
*
KKKRRRRKK
Рис. 29.3. Ключевые кадры в сравнении с обычными
В среде разработки Flash временная шкала для нашей анимации с выбранным кадром 1 выглядела бы так, как показано на рис. 29.4. Обратите внимание, что
Вех]Вех]Рис. 29.4. Временная шкала для анимации с бегущим человечкомРис. 29.4. Временная шкала для анимации с бегущим человечком
Вех]
Вех]
Рис. 29.4. Временная шкала для анимации с бегущим человечком
Рис. 29.4. Временная шкала для анимации с бегущим человечком
ключевые кадры с содержимым обозначаются значком заполненного круга. Ключевые кадры без содержимого, называемые пустыми ключевыми кадрами, обозначаются пустым кругом (наша анимация не имеет пустых ключевых кадров). Для обозначения обычных кадров значок круга не используется вообще. Последний обычный кадр, предшествующий ключевому кадру, обозначается значком прямоугольника.
Чтобы упростить изучение материала в последующих разделах, мы будем полагать, что наша анимация с бегущим человечком сохраняется в файле с именем runningman ,fla.
Теперь рассмотрим процесс создания сценариев на временной шкале.
Создание сценариев на временной шкале
Чтобы выполнить код в определенной точке на временной шкале, мы используем сценарий кадра. Он представляет собой блок кода на языке ActionScript, добавленный к ключевому кадру на временной шкале FLA-файла.
Чтобы добавить сценарий к ключевому кадру на временной шкале, используйте следующую основную последовательность действий.
Щелкните кнопкой мыши на нужном ключевом кадре на временной шкале (выберите его).
Выберите команду меню Window ► Actions (Окно ► Действия), чтобы открыть панель Actions (Действия).
Введите желаемый код на палитре Actions (Действия).
Любой код, введенный на палитре Actions (Действия) при выбранном ключевом кадре, становится частью сценария этого кадра и будет выполняться непосредственно перед его отображением в среде выполнения Flash.
Сценарии обычно используются для управления содержимым кадра, в котором они находятся. Мы узнаем подробнее об управлении содержимым с помощью сценариев кадров далее, в разд. «Обращение к созданным вручную экземплярам символов» этой главы.
Сценарии кадров не могут содержать инструкции class, package или interface либо атрибуты public, internal, private, dynamic или static, но могут включать любой другой код на языке ActionScript.
Программирование с помощью сценариев кадров иногда называют созданием сценариев на временной шкале. Это старейший вид программирования на ActionScript, а до появления версии языка 2.0 и приложения Flash Player 7 это был единственный вид программирования на ActionScript. Возможно, часть наиболее новаторских разработок сообщества Flash появилась в результате соединения содержимого временной шкалы и сценариев кадров.
Чтобы привести пример сценария кадра, добавим блок кода в последний кадр анимации с бегущим человечком. В нашем примере сценария кадра будет открываться URL-адрес http://moock.org в новом окне браузера. Вот этот код:
Import flash.net.*;
var request:URLRequest = new URLRequest("http://moock.org");
navigateToURL(request, "_blank");
На палитре Actions (Действия) среды разработки Flash наш сценарий кадра будет выглядеть так, как показано на рис. 29.5. Обратите внимание, что на временной шкале ключевые кадры со сценариями кадров обозначаются маленьким значком «а» (первая буква названия языка ActionScript).
IS№IS№I nnrnngman.fla II nnrnngman.fla I^1 qj Actions • Frame x |^1 qj Actions • Frame x |iqPiqPimport flash.net.*;var request:URLRequest = new URLRequest( navfgateToURL(request, ,; rlsr.K”);import flash.net.*;var request:URLRequest = new URLRequest( navfgateToURL(request, ,; rlsr.K”);File Edit View Insert Modify Text Commands Control Debug V^ndow HelpFile Edit View Insert Modify Text Commands Control Debug V^ndow Help\ Sort Assist ф ■\ Sort Assist ф ■TTkk
IS№
IS№
I nnrnngman.fla I
I nnrnngman.fla I
^1 qj Actions • Frame x |
^1 qj Actions • Frame x |
iq
P
iq
P
import flash.net.*;
var request:URLRequest = new URLRequest( navfgateToURL(request, ,; rlsr.K”);
import flash.net.*;
var request:URLRequest = new URLRequest( navfgateToURL(request, ,; rlsr.K”);
File Edit View Insert Modify Text Commands Control Debug V^ndow Help
File Edit View Insert Modify Text Commands Control Debug V^ndow Help
\ Sort Assist ф ■
\ Sort Assist ф ■
T
T
k
k
<1 IQ Layer 1:9 : Une 4 of 4, Cd 1
Рис. 29.5. Сценарий кадра
В существующем виде наш сценарий имеет одну проблему. По умолчанию среда выполнения Flash зацикливает анимации (то есть воспроизводит их повторно). Таким образом, наш сценарий будет выполняться всякий раз при завершении очередного цикла воспроизведения анимации с бегущим человечком, приводя к открытию множества окон браузера. Мы должны использовать метод экземпляра stop ( ) класса MovieClip для предотвращения повторного воспроизведения анимации, как показано в следующем коде. С методами классаMovieClip, предназначенными для управления воспроизведением, мы подробно познакомимся далее, в разд. «Программное управление временной шкалой».
Import flash.net.*;
var request:URLRequest = new URLRequest("http://moock.org");
navigateToURLtrequest, "_blank"):
stop( );
В предыдущем коде метод stop ( ) вызывается над объектом языка ActionScript, представляющим основную временную шкалу. В следующем разделе подробно
описывается представление основной временной шкалы в виде объекта в языке ActionScript.
Стоит отметить, что сценарии кадров могут ссылаться на любой пользовательский класс (или другое определение), доступный через путь к исходным классам документа (устанавливаемый для каждого FLA-файла) или через глобальный путь к классам (применяемый ко всем FLA-файлам). Чтобы задать путь к классам документа, выберите команду меню File ► Publish Settings (Файл ► Настройки публикации), нажмите кнопку Settings (Параметры), расположенную возле параметра ActionScript version (Версия ActionScript) с установленным значением ActionScript 3.0 на вкладке Flash, и укажите необходимые значения в списке Classpath (Путь к классам). Чтобы задать глобальный путь к классам, выберите команду меню Edit ► Preferences (Правка ► Предпочтения), затем выберите категорию ActionScript, нажмите кнопку ActionScript 3.0 Settings (Параметры ActionScript 3.0) в области Language (Язык) и укажите необходимые значения в списке Classpath (Путь к классам).
Класс документа
С точки зрения ActionScript основная временная шкала FLA-файла считается экземпляром класса документа, указать который можно следующим образом: выберите команду меню File ► Publish Settings (Файл ► Настройки публикации), нажмите кнопку Settings (Параметры), расположенную возле параметра ActionScript version (Версия ActionScript) на вкладке Flash, и введите необходимое значение в поле ввода Document class (Класс документа).
Этот класс документа должен наследоваться от класса flash .display. MovieClip, если выполняются следующие условия.
Основная временная шкала содержит сценарии кадров.
Класс документа желает управлять основной временной шкалой программным путем с помощью методов класса MovieClip.
Сцена основной временной шкалы содержит компоненты с настраиваемыми параметрами и справедливо любое из следующих утверждений.
Значения настраиваемых параметров не являются одинаковыми во всех кадрах временной шкалы. Например, символ Button (Кнопка) в кадре 1 имеет название "ОК", а в кадре 2 — "Submit".
Компонент присутствует не во всех кадрах временной шкалы. Например, символ List (Список) с настраиваемым поставщиком данных присутствует в кадре 1, но отсутствует в кадре 2.
Сцена основной временной шкалы содержит компоненты с настраиваемыми свойствами доступности или значения с палитры Strings (Строки).
В противном случае класс документа должен наследоваться только от класса flash. display. Sprite.,
При указании класса документа для FLA-файла используйте только полностью уточненное имя класса; не включайте расширение файла (AS).
Если класс, указанный в качестве класса документа, не будет найден, то компилятор Flash автоматически сгенерирует класс документа с указанным именем. Автоматически генерируемый класс расширяет класс MovieClip.
Если для FLA-файла не был указан класс документа, то он устанавливается автоматически. Если выполняются все следующие условия, то автоматически устанавливаемым классом документа становится класс flash. display. MovieClip.
Сцена основной временной шкалы не содержит именованных экземпляров (дополнительную информацию можно найти в разд. «Обращение к созданным вручную экземплярам символов»).
Основная временная шкала не содержит сценариев кадров.
Сцена основной временной шкалы не содержит компонентов с настраиваемыми параметрами, значения которых изменяются от кадра к кадру.
Сцена основной временной шкалы не содержит компонентов с настраиваемыми параметрами доступности или значений с палитры Strings (Строки).
В противном случае автоматически устанавливаемым классом документа будет автоматически генерируемый подкласс класса MovieClip.
Любой сценарий кадра основной временной шкалы можно считать далеким аналогом метода экземпляра класса документа. Код сценария кадра основной временной шкалы выполняется в своей собственной области действия и использует такой же набор правил доступа, который применяется к методам экземпляра класса документа. Иными словами, сценарий кадра основной временной шкалы может обратиться к любому определению (переменная, метод, класс, интерфейс или пространство имен), доступному из любого метода экземпляра класса документа. Подобным образом сценарий кадра основной временной шкалы может использовать ключевое слово this, чтобы обратиться к текущему объекту (то есть к экземпляру класса документа).
Для примера создадим класс документа RunningMan для файла runningman. fla из предыдущего раздела. Поскольку основная временная шкала файла runningman. fla включает сценарий кадра, класс RunningMan должен наследоваться от класса MovieClip. В классе RunningMan мы определим простой метод для открытия URL-адреса в браузере.
package {
Import flash.display.MovieClip;
import flash.net.*:
public class RunningMan extends MovieClip {
public function goToSite (url:String):void {
var request:URLRequest = new URLRequestCurl);
navigateToURKrequest, "_blank");
}
} }
Чтобы присоединить класс RunningMan к нашей анимации с бегущим человечком, мы сохраняем исходный файл этого класса в той же папке, где находится файл runningman. fla, а затем выполняем следующие шаги.
Выбираем команду меню File ► Publish Settings (Файл ► Настройки публикации) и нажимаем кнопку Settings (Параметры), расположенную возле параметра ActionScript version (Версия ActionScript) с установленным значением ActionScript 3.0 на вкладке Flash.
В поле Document class (Класс документа) вводим значение RunningMan (обратите внимание: RunningMan, а не RunningMan . as).
В окне ActionScript 3.0 Settings (Параметры ActionScript 3.0) нажимаем кнопку ОК.
В окне Publish Settings (Настройки публикации) нажимаем кнопку ОК.
Теперь, когда в качестве класса документа для файла runningman. fla установлен класс RunningMan, мы можем обновить сценарий для кадра 9 из предыдущего раздела. Предыдущий код сценария кадра выглядел так:
Import flash.net.*;
var request:URLRequest = new URLRequestChttp://moock.org"):
nav1 gateTolIRL (request, "_bl ank"):
stop( ):
Следующий код демонстрирует новый сценарий для кадра 9. Стоит отметить, что в этом сценарии происходит непосредственное обращение к методу экземпляра goToSite ( ) класса RunningMan.
goToSIte("http://moock.org");
stop( );
В предыдущем коде выражение stop ( ) ссылается на метод экземпляра stop ( ) класса MovieClip, от которого наследуется класс RunningMan. Являясь потомком класса MovieClip, RunningMan также имеет доступ ко всем незакрытым методам и переменным, определенным в классах EventDispatcher, Displayobject, InteractiveObj ect, DisplayOb j ectContainer и Sprite. Например, следующий код использует метод экземпляра addChild ( ) класса DisplayObjectContainer, чтобы добавить новое текстовое поле в иерархию отображения основной временной шкалы:
// Код сценария для кадра 9 файла runningman.fla
Import fl ash.text.*:
// Добавляем новое текстовое поле в иерархию
// отображения основной временной шкалы
var msg:TextF1eld = new TextF1eld( );
msg.text = "I guess no one was home...";
msg.autoSize = TextF1eldAutoS1ze.LEFT;
msg.border = true: msg.background = true: msg.selectable = false; addChl1d(msg);
stop( );
В результате выполнения предыдущего кода объект TextField, на который ссылается переменная msg, добавляется в иерархию отображения основной временной шкалы. При экспортировании файла runningman. swf из файла runningman .fla
и его последующей загрузке в среду выполнения Flash текст «I guess no one was home...» появится на экране, когда головка воспроизведения достигнет кадра 9. Отображение текста на экране происходит благодаря тому, что экземпляр класса документа первого SWF-файла, загруженного в среду выполнения, автоматически добавляется в список отображения. Дополнительную информацию можно найти в гл. 20.
Стоит отметить, что предыдущий код, создающий текстовое поле, в качестве альтернативы (и этот вариант является более предпочтительным) мог быть добавлен в метод экземпляра класса RunningMan. С технической точки зрения любой подход является допустимым, однако лучшая практика заключается в сохранении кода во внешних файлах классов, а не в сценариях кадров.
Определения переменных и функций в сценариях кадров. Если определение переменной размещается в сценарии кадра на основной временной шкале FLA-файла, то в классе документа этого FLA-файла создается соответствующая переменная экземпляра. Подобным образом, если определение функции размещается в сценарии кадра на основной временной шкале FLA-файла, в классе документа этого FLA-файла создается соответствующий метод экземпляра.
Аналогично, если определение переменной размещается в сценарии кадра на временной шкале символа Movie Clip (Клип), в классе, связанном с этим символом, создается соответствующая переменная экземпляра. И если в сценарии кадра на временной шкале символа Movie Clip (Клип) размещается определение функции, то в классе, связанном с этим символом, создается соответствующий метод экземпляра (о символах Movie Clip (Клип) и связываемых классах будет рассказано в двух следующих разделах).
Тем не менее обратите внимание, что переменная экземпляра, созданная в сценарии кадра, будет проинициализирована только в момент выполнения этого сценария (то есть когда головка воспроизведения достигнет кадра, содержащего данный сценарий). Например, рассмотрим следующий код, демонстрирующий два сценария кадра:
// Сценарий кадра 1 trace(n): // Выводит: О
// Сценарий кадра 2
var n:int = 10:
trace(n): // Выводит: 10
Когда выполняется первый из двух предыдущих сценариев кадра, переменная экземпляра п уже определена, но еще не проинициализирована (часть кода = 10 пока не выполнялась). В результате код trace (n) выведет значение 0 (значение по умолчанию для переменных типа int) в окне Output (Вывод). Когда выполняется второй сценарий, переменная экземпляра п уже проинициализирована (присвоено значение 10), поэтому код trace (п) выведет значение 10 в окне Output (Вывод).
В отличие от этого, когда выполнение сценария кадра завершено, любые переменные экземпляра, определенные в этом сценарии, могут использоваться вплоть до
завершения программы. Предположим, что мы добавили третий сценарий кадра на гипотетическую временную шкалу из предыдущего кода:
// Сценарий кадра 3
trace(n); // Выводит: 10
gotoAndStop(l):
Когда выполняется третий сценарий, переменная экземпляра п по-прежнему имеет значение 10, поэтому код trace (п) выводит значение 10 в окне Output (Вывод). Затем код gotoAndStop (1) перемещает головку воспроизведения на кадр 1, приводя к выполнению сценария кадра 1 во второй раз. На этот раз переменная экземпляра п имеет значение 10, поэтому код trace (п) выводит значение 10 (а не 0) в окне Output (Вывод).
Метод экземпляра, созданный в сценарии кадра, может быть использован даже до того, как головка воспроизведения достигнет кадра, содержащего определение этого метода экземпляра.
Символы и экземпляры
Ранее из разд. «Временные шкалы и кадры» мы узнали, что FLA-файл представляет собой иерархию анимаций, каждая из которых имеет собственную временную шкалу. Теперь, когда мы знаем, как создавать основную анимацию в документе Flash, рассмотрим вложенные анимации. Для их создания мы должны разобраться с символами.
В среде разработки Flash символ — это определенная пользователем анимация, кнопка или изображение с возможностью повторного использования. Символы создаются за пределами сцены в специальном режиме редактирования. Каждый FLA-файл сохраняет связанные с ним символы в хранилище элементов, называемом библиотекой (Library). Из одного символа можно создать произвольное количество его копий, или экземпляров.
Например, чтобы создать небо, заполненное анимированными мерцающими звездами, мы могли бы создать один символ звезды и затем добавить множество его экземпляров в сцену. На рис. 29.6 показано, как могли бы выглядеть символ звезды и его экземпляры в FLA-файле. Обратите внимание, что позиция, масштаб и угол поворота каждого экземпляра звезды устанавливаются независимо.
По умолчанию, когда SWF-файл компилируется из FLA-файла, в SWF-файл включаются только те символы, экземпляры которых действительно используются в документе (то есть появляются в сцене) или экспортируются для языка ActionScript (обратитесь к разд. «Создание экземпляров символов среды разработки Flash из кода на языке ActionScript»). Следовательно, содержимое каждого символа включается всего один раз и затем на этапе выполнения он дублируется для каждого экземпляра по мере необходимости. В связи с этим использование символов и экземпляров (вместо обычных изображений) может в значительной степени уменьшить размер SWF-файла.
Экземпляры звезды в сценеЭкземпляры звезды в сценеСимвол звезды в библиотекеСимвол звезды в библиотекеLibraryUnbtied-4LibraryUnbtied-4Рис. 29.6. Символ звезды и его экземплярыРис. 29.6. Символ звезды и его экземпляры
Экземпляры звезды в сцене
Экземпляры звезды в сцене
Символ звезды в библиотеке
Символ звезды в библиотеке
Library
Unbtied-4
Library
Unbtied-4
Рис. 29.6. Символ звезды и его экземпляры
Рис. 29.6. Символ звезды и его экземпляры
Типы символов .
В среде разработки Flash определены три основных типа символов:
Movie Clip (Клип) (для анимаций с содержимым, создаваемым программным путем);
Graphic (Графика) (для анимаций без содержимого, создаваемого программным путем, которые могут просматриваться непосредственно в среде разработки Flash);
Button (Кнопка) (для реализации простой интерактивности).
К символам Graphic (Графика) нельзя обращаться из кода на языке ActionScript, а символы Button (Кнопка) предоставляют простейшие интерактивные возможности, которые также можно реализовать с помощью символа Movie Clip (Клип) или компонента Button. Таким образом, в этой главе мы опустим рассмотрение символов Graphic (Графика) и Button (Кнопка) и сосредоточимся исключительно на символах Movie Clip (Клип).
Символы Movie Clip (Клип)
Символ Movie Clip (Клип) — это самодостаточная анимация с возможностью повторного использования. Любой символ Movie Clip (Клип) имеет свою собственную временную шкалу и сцену, подобно основной временной шкале. Более того, экземпляры символов Movie Clip (Клип) могут быть вложены друг в друга для создания графики или анимаций, имеющих иерархическую структуру. Например, символ Movie Clip (Клип), представляющий нарисованное лицо, может содержать отдельный символ Movie Clip (Клип), представляющий анимированные моргающие глаза.
На рис. 29.7 изображен символ Movie Clip (Клип), созданный в среде разработки Flash. На сцене показано содержимое кадра 2 временной шкалы этого символа
Movie Clip (Клип). Обратите внимание, что временная шкала на рисунке не является основной временной шкалой FLA-файла, а представляет собой отдельную, независимую временную шкалу символа Movie Clip (Клип) звезды.
Связанные классы для символов
Movie Clip (Клип)
С точки зрения языка ActionScript на этапе выполнения каждый экземпляр символа Movie Clip (Клип) в FLA-файле представляется экземпляром класса Sprite или одного из его подклассов. Класс, используемый для представления экземпляров определенного символа Movie Clip (Клип), называется связанным классом этого символа. Связанный класс символа может быть указан вручную или сгенерирован автоматически.
Чтобы указать связанный класс для символа Movie Clip (Клип), мы используем окно Linkage Properties (Свойства связывания). Обратите внимание, что если любое из следующих утверждений верно, то указываемый связанный класс должен наследоваться от класса flash. display. MovieClip.
Временная шкала символа содержит сценарии кадров.
Связанный класс желает управлять экземплярами символа программным путем, используя методы класса MovieClip.
Сцена символа содержит компоненты с настраиваемыми параметрами, и справедливо любое из следующих утверждений.
Значения настраиваемых параметров не являются одинаковыми во всех кадрах временной шкалы. Например, символ Button (Кнопка) в кадре 1 имеет название "ОК", а в кадре 2 — "Submit".
Компонент присутствует не во всех кадрах временной шкалы. Например, символ List (Список) с настраиваемым поставщиком данных присутствует в кадре 1, но отсутствует в кадре 2.
Сцена основной временной шкалы содержит компоненты с настраиваемыми свойствами доступности или значения с палитры Strings (Строки).
В противном случае указываемый связанный класс должен наследоваться только от класса flash. display. Sprite.
Чтобы указать связанный класс для символа Movie Clip (Клип), выполняйте следующие шаги.
Выберите символ в библиотеке FLA-файла.
Откройте меню Options (Свойства) палитры Library (Библиотека), щелкнув кнопкой мыши на значке в правом верхнем углу палитры, и выберите команду Linkage (Связывание).
В области Linkage (Связывание) окна Linkage Properties (Свойства связывания) следует установить флажок Export for ActionScript (Экспорт для ActionScript). Стоит отметить, что при этом выбранный символ включается в скомпилированный SWF-файл независимо от того, используются его экземпляры в документе или нет.
В поле Class (Класс) окна Linkage Properties (Свойства связывания) введите полностью уточненное имя класса (то есть имя класса, объединенное с именем пакета класса, если класс размещается в пакете). Связываемый класс должен быть доступен либо через глобальный путь к классам, либо через путь к классам FLA- файла, содержащего этот символ. Указывая имя связанного класса в окне Linkage Properties (Свойства связывания), никогда не изменяйте значения по умолчанию для параметра Base class (Базовый класс), кроме тех случаев, когда с одним суперклассом связывается более одного символа, — эта ситуация рассматривается в разд. «Связывание нескольких символов с одним суперклассом».
Нажмите кнопку ОК.
Если класс, указанный на шаге 4 описанной процедуры, не будет найден, то компилятор Flash автоматически сгенерирует связанный класс с указанным именем. Автоматически генерируемый класс расширяет указанный базовый класс.
Если для некоторого символа не был указан связанный класс, то компилятор устанавливает его автоматически. Если выполняются все следующие условия, то автоматически устанавливаемым связанным классом является класс MovieClip.
Сцена символа не содержит именованных экземпляров.
Временная шкала символа не содержит сценариев кадров.
Сцена символа не содержит компонентов с настраиваемыми параметрами, значения которых изменяются от кадра к кадру.
Сцена символа не содержит компонентов с настраиваемыми параметрами доступности или значений из палитры Strings (Строки).
В противном случае автоматически устанавливаемым связанным классом будет автоматически генерируемый подкласс класса MovieClip.
После завершения операции связывания символа с классом создаваемые вручную экземпляры этого символа будут перенимать программные поведения, определяемые связанным классом. С другой стороны, экземпляры, создаваемые программным путем, будут перенимать аудиовизуальное содержимое связанного символа. Таким образом, символ и класс являются одним целым: символ определяет графическое содержимое, а класс — программное поведение.
В качестве примера свяжем наш символ Movie Clip (Клип) звезды из предыдущего раздела с подклассом Star класса MovieClip. Класс Star будет случайным образом изменять прозрачность (значение канала Alpha) каждого экземпляра звезды через каждые 100 мс.
package {
import fl ash.di splay.MovieClip:
Import flash.utils.Timer;
Import fl ash.events.TimerEvent;
public class Star extends MovieClip {
private var timer:Timer;
public function Star ( ) {
timer = new TimerdOO, 0);
timer.addEventListener(TimerEvent.TIMER. timerListener); timer.start( );
}
private function timerListener (e:T1merEvent):void { randomFade( );
}
private function randomFade ( ):void {
// Присваиваем переменной alpha случайное значение с плавающей запятой
// в диапазоне от 0 до (но не включая) 1. Переменная экземпляра alpha
// наследуется от класса Displayobject (являющегося предком класса
// MovieClip).
alpha = Math.random( );
}
// Предоставляет способ остановить таймер. Как рассматривалось
// в разд. «Деактивация объектов» гл. 14, внешний код должен
// использовать этот метод перед удалением экземпляра звезды
// из программы.
public function dispose ( ):void {
timer.stop( ):
}
}
Чтобы связать класс Star с символом Movie Clip (Клип) звезды, выполните следующие действия.
Сохраните файл, содержащий символ звезды, под именем sky. fla.
Сохраните класс Star в той же папке, где находится файл sky. fla, в текстовом файле под именем Star. as.
Выберите символ звезды в библиотеке файла sky. fla.
Откройте меню Options (Свойства) палитры Library (Библиотека), щелкнув кнопкой мыши на значке в правом верхнем углу палитры, и выберите команду Linkage (Связывание).
В области Linkage (Связывание) окна Linkage Properties (Свойства связывания) установите флажок Export for ActionScript (Экспорт для ActionScript).
В поле Class (Класс) окна Linkage Properties (Свойства связывания) введите значение Star.*
Нажмите кнопку ОК.
На рис. 29.8 показано окно Linkage Properties (Свойства связывания) в том виде, в котором оно находится после выполнения шага 6 предыдущей процедуры.
Рис. 29.8. Связывание символа Star с классом Star
Чтобы создать экземпляры символа звезды в среде разработки Flash, мы перетаскиваем название символа из библиотеки на сцену основной временной шкалы (или на сцену любого другого символа, но в данном случае у нас нет других символов в документе). Эта процедура проиллюстрирована на рис. 29.9, где изображены пять экземпляров символа звезды, перетаскиваемых на сцену первого кадра основной временной шкалы файла sky.fla.
Поместив экземпляры символа звезды на основную временную шкалу, мы можем экспортировать файл s ky. s wf из файла s ку. fla и понаблюдать за эффектом мерцания (определяемым символом звезды) и эффектом затухания (определяемым классом Star).
Рис. 29.9. Создание экземпляров символа звезды
Теперь, когда мы знаем, как вручную создавать экземпляры символов Movie Clip (Клип), рассмотрим, как обращаться к этим экземплярам и управлять ими.
Обращение к созданным вручную экземплярам символов
На этапе выполнения каждый экземпляр символа, который помещен на любую временную шкалу в FLA-файле, автоматически становится отображаемым ребенком объекта языка ActionScript, представляющего данную временную шкалу.
Например, в предыдущем разделе мы добавили пять экземпляров символа звезды на основную временную шкалу файла sky. fla. В результате на этапе выполнения эти пять экземпляров становятся отображаемыми объектами-детьми экземпляра класса документа файла sky. fla. Чтобы доказать это, создадим класс документа для файла sky. fla и воспользуемся методом getChildAt ( ) для получения списка всех детей основной временной шкалы.
package {
Import flash.display.MovleCUp;
public class Sky extends MovleCUp {
public function Sky ( ) {
for (var 1:1nt=0: 1 < numChlldren; 1++) { traceCTound child: " + getChlldAtd));
Found child;
[object Star]
Found child:
[object Star]
Found child:
[object Star]
Found child:
[object Star]
Found child:
[object Star]
В случае с предыдущим классом документа, когда приложение sky. swf будет экспортировано и воспроизведено в режиме Test Movie (Проверка фильма) среды разработки Flash, в окне Output (Вывод) появятся следующие строки:
Код в методе-конструкторе класса документа SWF-файла может обращаться к любым дочерним элементам, размещенным вручную в первом кадре SWF-файла, но не во втором или последующих кадрах (поскольку элементы, размещенные в последующих кадрах, не добавляются в список отображаемых детей до тех пор, пока головка воспроизведения не достигнет этих кадров).
С точки зрения языка ActionScript пять экземпляров символа звезды на основной временной шкале являются экземплярами класса Star, который наследуется от класса MovieClip, поэтому мы можем управлять звездами с помощью переменных и методов класса Displayobject (или любого другого предка класса MovieClip). Например, следующий код использует переменную экземпляра х класса Displayobject для выравнивания звезд по вертикальной линии, проходящей через координату 100 по оси X:
for (var 1:1nt=0; 1 < numChlldren; 1++) {
getCh1ldAt(1).x = 100;
}
Тем не менее метод ge tChildAt ( ), применяемый в предыдущем коде, имеет одно ограничение. Поскольку в среде разработки Flash глубины отдельных экземпляров символов не совсем очевидны, использование метода getChildAt ( ) для выборочного управления конкретным экземпляром символа оказывается весьма затруднительным. Чтобы без труда идентифицировать конкретный экземпляр и управлять им из кода, мы присваиваем ему имя экземпляра.
Имена экземпляров
Имя экземпляра — это простое строковое имя, присваиваемое экземпляру символа. Чтобы присвоить имя созданному вручную экземпляру символа, мы используем палитру Properties (Свойства). Например, чтобы присвоить имена экземплярам
символа звезды из предыдущего раздела, выполните такую последовательность действий.
Откройте палитру Properties (Свойства) (команда меню Window ► Properties (Окно ► Свойства)).
Выберите экземпляр звезды на сцене.
Вместо значения clnstance Name> (Имя экземпляра) введите значение star 1.
Повторите шаги 2-3, чтобы присвоить имена оставшимся экземплярам звезды, начиная со значения st аг 2 и заканчивая значением st аг 5.
При выполнении шага 3 предыдущей процедуры палитра Properties (Свойства) будет выглядеть так, как показано на рис. 29.10 (в нижней его части).
Рис. 29.10. Присваивание имени экземпляру символа звезды
Обратиться по имени к созданному вручную экземпляру символа из кода на языке ActionScript можно с помощью метода экземпляра getChildByName ( ) класса DisplayObjectContainer. Например, следующий код использует метод getChildByName ( ), чтобы переместить экземпляр "star3й (звезда с именем экземпляра "star3")B точку с координатой (0; 0):
package {
Import fl ash. display .MovleCHp;
public class Sky extends MovleCHp {
public function Sky ( ) {
getCh1ldByName("star3").x = 0;.
getChildByName("star3").у = 0;
}
} }
На этапе выполнения к имени экземпляра можно обратиться через переменную экземпляра name класса DisplayOb j ect. Например, следующий код отображает имена всех экземпляров, размещенных в первом кадре основной временной шкалы файла sky.fla:
for (var 1:1nt=0: 1 < numChildren: 1++) { trace(getChildAt(i).name);
}
Кроме того, на этапе выполнения имя экземпляра объекта можно изменить, присвоив новое значение его переменной name, как показано в следующем коде: некийОбъектО1splayObject.name = "некоеИмя";
Тем не менее изменение имен экземпляров на этапе выполнения обычно усложняет отладку кода, поэтому вы должны избегать использования подобной практики в своих программах.
Соответствие переменных именам экземпляров
Метод getChildByName ( ) из предыдущего раздела позволяет успешно обращаться к конкретному экземпляру символа, однако он не совсем удобен. Чтобы упростить обращение к создаваемым вручную экземплярам символов из кода на языке ActionScript, компилятор Flash предоставляет два автоматических сервиса. Во-первых, когда компилятор встречает именованный экземпляр на временной шкале, он автоматически присваивает его переменной экземпляра класса документа временной шкалы или связанного класса, имеющей такое же имя, как у данного экземпляра. Во- вторых, в некоторых случаях, когда соответствующая переменная экземпляра еще не существует в классе документа временной шкалы или связанном классе, компилятор автоматически создает ее. Рассмотрим эти два автоматических сервиса на примере.
Возвращаясь к примеру с файлом s ky. На из предыдущего раздела, вспомним, что классом документа файла s к у. На является S ку и что основная временная шкала файла s ку. На содержит пять экземпляров символа звезды с именами " star 1" — " star5 ". Когда компилятор Flash осуществляет компиляцию файла sky. swf, он автоматически добавляет в класс Sky код, который присваивает эти пять экземпляров звезды пяти переменным экземпляра с именами star1 — star5. Результат эквивалентен добавлению следующего кода в начало конструктора класса Sky: package {
Import fl ash. di splay .MovieClip;
public class Sky extends MovieClip {
public function Sky ( ) {
starl = getChildByNameC'starl");
star2 = getChildByName("star2");
star3 = getChildByName("starS");
star4 = getChildByNameCstarA"):
star5 = getChildByName(“starS");
}
}'
}
Конечно, в данном случае никаких переменных с именами star 1 — star 5 в классе Sky на самом деле не определено. Следовательно, предыдущее автоматическое присваивание экземпляров переменным потенциально опасно.
Возникнет ли ошибка, зависит от параметра компиляции под названием Automatically declare stage instances (Автоматически объявлять экземпляры сцены), устанавливаемого для каждого FLA-файла. Данный параметр находится в области Stage (Сцена) окна ActionScript Settings (Параметры ActionScript), открыть которое можно, выбрав команду меню File ► Publish Settings (Файл ► Настройки публикации) и нажав кнопку Settings (Параметры), расположенную возле параметра ActionScript version (Версия ActionScript) на вкладке Flash. Когда флажок Automatically declare stage instances (Автоматически объявлять экземпляры сцены) установлен (по умолчанию), компилятор не только присваивает экземпляры сцены соответствующим переменным, но и автоматически объявляет эти переменные. Например, если мы установим флажок Automatically declare stage instances (Автоматически объявлять экземпляры сцены) для файла sky.Па, то компилятор автоматически объявит переменные экземпляра с именами starl— st аг 5 в классе Sky. Результат эквивалентен добавлению следующего кода в класс Sky (обратите внимание, что для автоматически объявляемых переменных используется модификатор управления доступом public):
package {
Import flash.display.MovleCHp;
public class Sky extends MovleCHp {
public var starl-.Star;
public var star2:Star;
public var star3:Star;
public var star4:Star;
public var star5:Star;
public function Sky ( ) {
starl = getChildByName("starl");
star2 = getChildByName("star2");
star3 = getChildByName("star3");
star4 = getChildByName("star4"); star5 = getChildByName("star5");
}
} } .
Благодаря предыдущему автоматически сгенерированному коду внутри класса Sky мы можем ссылаться на экземпляры звезд из основной временной шкалы файла sky. Па непосредственно по имени экземпляра. Например, следующий код перемещает экземпляр ”star3” (звезда с именем экземпляра ”star3”) в точку с координатой (0; 0):
package {
Import flash.display.MovleCUp;
public class Sky extends MovleCUp {
public function Sky ( ) {
star3.x = 0;
starS.у = 0;
}
}
}
Подобным образом обращаться к экземплярам звезд непосредственно по имени экземпляра можно также из любого сценария кадра на основной временной шкале файла sky.Па. Например, если поместить следующий код в сценарий первого кадра файла sky .Па, то экземпляр "star5” будет повернут на 30°:
star5.rotation = 30;
Ловко, да?
Однако с учетом вышеописанного автоматического поведения, если флажок Automatically declare stage instances (Автоматически объявлять экземпляры сцены) установлен, программист должен проявлять осторожность, чтобы не определить переменные экземпляра, имена которых совпадают с именами экземпляров символов. Например, следующий код определяет переменную экземпляра start, имя которой совпадает с именем экземпляра символа с основной временной шкалы файла sку. Па:
package {
Import fl ash. display. MovleCUp;
public class Sky extends MovleCUp {
public var starl:Star;
public function Sky ( ) {
}
}
}
Определение переменной экземпляра в предыдущем коде вызывает следующую ошибку на этапе компиляции:
A conflict exists with definition start in namespace Internal.
На русском языке она будет выглядеть так: Существует конфликт с определением star! в пространстве имен internal.
В отличие от этого, когда флажок Automatically declare stage instances (Автоматически объявлять экземпляры сцены) снят, компилятор не объявляет соответствующие переменные для экземпляров сцены. Например, если мы снимем данный флажок для файла sky .Па, то компилятор не объявит переменные экземпляров с именами start — star5 в классе Sky. Тем не менее он по-прежнему присваивает тем переменным ссылки на пять экземпляров символа звезды, размещенных на основной временной шкале. В итоге мы должны добавить объявления соответствующих
переменных в класс Sky, как показано в следующем коде. Обратите внимание, что по необходимости переменные объявлены с использованием модификатора управления доступом public.
package {
Import fl ash. display .MovieCUp;
public class Sky extends MovieCUp {
public var starl:Star;
public var star2:Star;
public var star3:Star;
public var star4:Star;
public var star5:Star;
public function Sky ( ) {
}
}
Если убрать объявления переменных из предыдущего кода, то возможны два результата в зависимости от того, объявлен класс с атрибутом dynamic или нет (обратитесь к разд. «Динамические переменные экземпляра» гл. 15). Если класс объявлен без использования атрибута dynamic (как в случае с классом Sку), на этапе выполнения возникнет следующая ошибка, поскольку инструкции присваивания, автоматически добавленные компилятором, ссылаются на несуществующие переменные: ReferenceError: Error #1056: Cannot create property star5 on Sky.
По-русски она будет выглядеть следующим образом: Ошибка обращения: невозможно создать свойство stars в классе Sky.
Если, с другой стороны, класс объявлен с использованием атрибута dynamic, то автоматически добавляемые инструкции присваивания на этапе выполнения просто создают новые динамические переменные экземпляра (с именами s t а г 1 — s t а г 5 ) для каждого экземпляра класса.
Несмотря на то что по умолчанию флажок Automatically declare stage instances (Автоматически объявлять экземпляры сцены) установлен, многие программисты предпочитают не устанавливать его. Как мы только что узнали, если он не установлен, то нединамические классы, связанные с временными шкалами, должны объявлять переменные, которые соответствуют всем именованным экземплярам сцены. Подобные ^явные объявления проливают свет на природу появления переменных в использующем их классе и исключают возникновение ошибок компиляции при редактировании данного класса в других средах разработки (например, в приложении Flex Builder 2).
Стоит отметить, что автоматически генерируемые классы документа и автоматически генерируемые связанные классы всегда компилируются с установленным флажком Automatically declare stage instances (Автоматически объявлять экземпляры сцены). Следовательно, обратиться к именованным экземплярам сцены любой временной шкалы, связанной с автоматически генерируемым классом документа или автоматически генерируемым связанным классом, можно через соответствующие переменные экземпляра.
Обращение к созданному вручную тексту
В предыдущих разделах мы познакомились с тремя инструментами, которые позволяют обращаться к созданным вручную экземплярам символов из кода на языке ActionScript, а именно:
метод get Chi IdAt ( );
метод getChildByName ( );
автоматически присваиваемые переменные экземпляра.
Те же три инструмента могут быть использованы и для обращения к созданному вручную тексту.
В среде разработки Flash текстовые поля создаются с помощью инструмента Text (Текст). Созданные вручную текстовые поля типа Dynamic Text (Динамический текст) или Input Text (Вводимый текст) на этапе выполнения представляются экземплярами класса flash. text. TextField. Как и в случае с экземплярами символов, поля типа Dynamic Text (Динамический текст) и Input Text (Вводимый текст) становятся отображаемыми детьми объекта, представляющего временную шкалу, на которой они размещаются. Кроме того, как и в случае с экземплярами символов, текстовым полям описанных типов могут присваиваться имена экземпляров, которые соответствуют именам автоматически присваиваемых переменных экземпляра.
Например, приведенная ниже последовательность действий описывает, как переместить созданное вручную текстовое поле типа Dynamic Text (Динамический текст) в точку с координатой (200; 300), используя код на языке ActionScript.
В среде разработки Flash создайте новый FLA-файл и назовите его message. fla.
На палитре Tools (Инструменты) выберите инструмент Text (Текст).
Щелкните кнопкой мыши на сцене первого кадра основной временной шкалы файла message. fla.
В появившемся поле введите слово hello.
На палитре Properties (Свойства) (команда меню Window ► Properties (Окно ► Свойства)) измените значение Static Text (Статический текст) на Dynamic Text (Динамический текст).
На палитре Properties (Свойства) вместо значения <Instance Name> (Имя экземпляра) введите msg.
Щелкните кнопкой мыши на первом кадре основной временной шкалы файла message.fla (выделите его).
Откройте палитру Actions (Действия) (команда меню Window ► Actions (Окно ► Действия)).
Введите следующий код на палитре Actions (Действия):
msg.x = 200:
msg.у = 300:
Программное управление временной шкалой
Теперь, когда мы знаем, как обращаться к созданным вручную экземплярам символов Movie Clip (Клип), кратко рассмотрим инструменты, предназначенные для управления воспроизведением этих экземпляров. В следующем списке представлены наиболее важные методы и переменные класса MovieClip для управления временной шкалой. Дополнительную информацию о классе MovieClip можно найти в справочнике по языку ActionScript корпорации Adobe.
play( ) — инициирует последовательное отображение кадров временной шкалы клипа. Кадры отображаются со скоростью, установленной через переменную экземпляра f rameRate класса Stage среды выполнения Flash.
stop ( ) — останавливает воспроизведение клипа. Однако обратите внимание, что, несмотря на остановку клипа, среда выполнения Flash продолжает воспроизводить звуки, реагировать на действия пользователя и обрабатывать события, включая события Event. ENTER_FRAME. Таким образом, визуальные изменения, происходящие в обработчиках событий, в результате использования метода setinterval ( ) или события Timer, отображаются даже в том случае, когда головка воспроизведения остановлена. Метод stop ( ) просто предотвращает дальнейшее перемещение головки воспроизведения по временной шкале клипа.
gotoAndPlay ( ) — перемещает головку воспроизведения временной шкалы клипа на кадр с указанным номером или меткой, после чего начинает воспроизведение временной шкалы с этой точки. Состояние других клипов не изменяется. Чтобы начать воспроизведение других клипов, следует вызвать метод play( ) или gotoAndPlay ( ) для каждого клипа по отдельности.
gotoAndStop ( ) — перемещает головку воспроизведения временной шкалы клипа на кадр с указанным номером или меткой, после чего останавливает воспроизведение клипа.
next Frame ( ) — перемещает головку воспроизведения временной шкалы клипа вперед на один кадр и останавливает воспроизведение на этом кадре.
prevFrame ( ) — перемещает головку воспроизведения временной шкалы клипа назад на один кадр и останавливает воспроизведение на этом кадре.
cur rentFrame — возвращает номер кадра, на котором в настоящий момент находится головка воспроизведения клипа. Стоит отметить, что номером первого кадра является 1, а не 0; таким образом, значение переменной currentFrame находится в диапазоне от 1 до значения переменной total Frames.
currentLabel — возвращает строку, представляющую метку текущего кадра, которая задается в среде разработки Flash.
currentLabels — возвращает массив, содержащий все метки текущей временной шкалы.
totalFrames — возвращает количество кадров на временной шкале клипа.
Применим некоторые из перечисленных методов и переменных к нашему документу sky.Па. Все следующие примеры могут быть помещены либо в метод класса Sky, либо на основную временную шкалу файла sky. Па.
Следующий код отображает четвертый кадр экземпляра " star 1":
starl.gotoAndStop(4);
Приведенный ниже код останавливает воспроизведение временной шкалы экземпляра "star3":
star3.stop( ):
Следующий код перемещает головку воспроизведения экземпляра "star5м на два кадра вперед:
star5.gotoAndStop(star5.currentFrame + 2);
Приведенный далее код останавливает воспроизведение временной шкалы всех экземпляров звезды, находящихся на основной временной шкале:
for (var 1:1nt=0: 1 < numChiIdren; i++) {
getChildAtd) .stop( ):
Создание экземпляров символов среды разработки Flash из кода на языке Actionscript
Ранее из разд. «Связанные классы для символов Movie Clip (Клип)» мы узнали, что экземпляры символа могут создаваться вручную в среде разработки Flash путем перетаскивания имени символа из библиотеки в сцену временной шкалы. Экземпляры символов, экспортируемые для языка ActionScript, могут также создаваться непосредственно из кода с помощью стандартного оператора new.
Например, ранее мы связали символ звезды с классом Star. Чтобы создать экземпляр символа звезды из кода, мы используем следующее выражение:
new Star( )
Чтобы добавить экземпляр символа звезды на основную временную шкалу приложения sky. swf на этапе выполнения, мы бы включили следующий код либо в сценарий кадра на основной временной шкале, либо в метод класса S ку:
var star:Star = new Start );
addChl1d(star);
Следующий код создает 50 экземпляров звезды и размещает их на экране в произвольных точках:
var sky .-Array = new Array( ):
for (var 1:1nt = 0; 1 < 50: 1++) {
sky.push(new Start )) ;
sky[i].x = Math.floortMath.randomt )*550);
sky[i].y = Math.floortMath.randomt )*400):
addChild(sky[1J);
}
Стоит отметить, что код на языке ActionScript может быть использован для создания экземпляров любого символа, экспортируемого для языка ActionScript, неза-
висимо от того, имеет этот символ собственный связанный класс или нет. Иными словами, класс, указанный в окне Linkage Properties (Свойства связывания), не обязательно должен быть существующим пользовательским классом (как, например, класс Star). Как мы узнали ранее, если класс, указанный в окне Linkage Properties (Свойства связывания), не может быть найден с использованием пути к классам, то компилятор Flash создает его автоматически. Автоматически генерируемый класс может применяться для создания экземпляров данного символа из кода.
Предположим, что у нас есть символ Movie Clip (Клип) с именем box symbol и мы хотим создать его экземпляры из кода на языке ActionScript. Рассмотрим необходимую последовательность действий.
Выберите символ box_symbol в библиотеке.
Откройте меню Options (Свойства) палитры Library (Библиотека), щелкнув кнопкой мыши на значке в правом верхнем углу палитры, и выберите команду Linkage (Связывание).
В области Linkage (Связывание) окна Linkage Properties (Свойства связывания) установите флажок Export for ActionScript (Экспорт для ActionScript).
В поле Class (Класс) окна Linkage Properties (Свойства связывания) введите значение Box.
Нажмите кнопку ОК.
По умолчанию в результате выполнения предыдущих шагов среда разработки Flash выведет окно с предупреждением следующего содержания: A definition for this class could not be found in the classpath, so one will be automatically generated in the SWF file on export (Определение для данного класса не может быть найдено в пути к классам, поэтому он будет автоматически сгенерирован в SWF-файле при экспорте). Нажмите кнопку ОК, чтобы закрыть это предупреждение.
Чтобы создать экземпляр символа box_symbol после выполнения предыдущих шагов, мы используем выражение new Box ( ) на любой временной шкале или в любом классе SWF-файла, содержащего символ box symbol.
Имена экземпляров для отображаемых объектов, создаваемых программным путем
Между прочим, как и в случае с экземплярами, создаваемыми вручную, отображаемым объектам, которые создаются программным путем, можно тоже присваивать имя экземпляра через переменную name. Например, следующий код создает экземпляр класса TextField и присваивает ему имя экземпляра "price”, добавляет его в контейнер, а затем по имени получает на него ссылку.
var t:TextF1eld = new TextF1eld( ):
t.text = "$99.99":
t.name = "price"
var deta1lsPage:Spr1te = new Spr1te( ):
detai 1sPage.addChl1d(t):
trace(deta1lsPage.getCh1ldByName("price")): // Выводит: Eobject TextField]
Приведенный код может показаться удобным, поскольку он предоставляет способ для обращения к объекту в списке отображения с использованием некоторой определенной программистом метки, а не ссылки на объект или позиции глубины. Тем не менее подобное использование имен экземпляров может служить причиной возникновения ошибок — язык ActionScript не требует, чтобы имена экземпляров были уникальными, и не генерирует исключение при попытке обращения к несуществующим именам экземпляров. Таким образом, следует избегать использования имен экземпляров для отображаемых объектов, создаваемых программным путем.
Имена экземпляров в основном должны использоваться только при обращении к экземплярам текстовых полей или символов библиотеки, созданным вручную в среде разработки Flash.
К отображаемым объектам, создаваемым программным путем, следует всегда обращаться по ссылке. Например, следующий код демонстрирует две версии метода displayprice ( ) (это гипотетический метод, который отображает стоимость товара). В обоих случаях стоимость отображается в объекте TextField. В первой версии (рекомендуемой) объект TextField, который будет отображать стоимость, передается в метод как объектная ссылка. Во второй версии в метод передается объект DisplayObjectContainer, который содержит объект TextField, и метод получает ссылку на объект TextField по имени экземпляра.
// Рекомендуется
public function d1splayPrlсе (pr1ceF1eld;TextF1eld, pr1ce;Number):void { pr1ceF1eld.text = "$" + price;
}
// He рекомендуется
public function dlsplayPrlce (orderForm;Spr1te, pr1ce;Number):void { TextF1eld(orderForm.getCh1ldByName("pr1ce")).text = "$" + price;
}
Всегда, когда это возможно, отображаемые объекты должны быть доступны для зависимых частей программы по ссылке.
В языке MXML имя экземпляра отображаемого объекта может быть установлено через атрибут id, а обращаться к именованным отображаемым объектам можно также с помощью метода getChildByName ( ). Тем не менее, как и в случае с приложениями, разработанными на чистом ActionScript, вместо имен экземпляров предпочтительнее использовать ссылки.
Связывание несквльких символов с одним суперклассом
Ранее из разд. «Связанные классы для символов Movie Clip (Клип)» мы узнали, как связать класс с символом Movie Clip (Клип). Теперь рассмотрим, как обеспечить
одинаковым программным поведением несколько различных символов Movie Clip (Клип), связав их с одним суперклассом.
В качестве примера создадим простую форму регистрации с двумя различными графическими стилями интерфейса. Подобная форма может потребоваться в приложении, которое предоставляет пользователям возможность выбора дизайна интерфейса, или обложки. Наши формы будут выглядеть по-разному, однако их поведение будет одинаковым.
Мы начнем с создания FLA-файла LoginApp. fla в среде разработки Flash. В нем мы создадим два символа — по одному для каждого графического стиля формы регистрации. Назовем первый символ именем LoginForm_Stylel, а второй символ — LoginForm_Style2. В каждый символ формы регистрации добавим два созданных вручную текстовых поля (с именами username и password) и кнопку отправки данных (с именем submi tBtп). Сама по себе кнопка является нарисованным вручную экземпляром символа Movie Clip (Клип). На рис. 29.11 изображены два символа формы регистрации.
Login Form_Style1Login Form_Style1Login Form_Style2Login Form_Style2Username ||
Login Form_Style1
Login Form_Style1
Login Form_Style2
Login Form_Style2
Password |ZJ CW I
Username |~]
Password |”1
Submit
Рис. 29.11. Символы формы регистрации
Далее создадим класс LoginForm, который управляет поведением символов формы регистрации. Он реагирует на нажатия кнопки отправки данных и передает полученную информацию на сервер. В этом примере снимем флажок компиляции Automatically declare stage instances (Автоматически объявлять экземпляры сцены). Соответственно внутри класса LoginForm объявим созданные вручную элементы из символов формы регистрации в качестве переменных экземпляра. Имена переменных экземпляра — user name, password и submi tBtn — соответствуют именам экземпляров в символах формы регистрации.
Рассмотрим код для класса LoginForm:
package {
import flash.display.*;
import flash.text.*;
import flash.events.*;
public class LoginForm extends MovieCIip { public var username:TextField;
public var password:TextF1eld;
public var subm1tBtn:S1mpleButton:
public function LoginForm ( ) {
submltBtn.addEventLIstener(MouseEvent.CLICK, submltL1stener);
}
private function submltL1stener (e:MouseEvent):void { subm1t(username.text. password.text);
}
public function submit (name:Str1ng, pass:Str1ng):void { traceCNow submitting user: " + name + " with password: " + pass):
// Теперь передаем полученную информацию
// на сервер (код не показан).
// Обычно для отправки данных на сервер
// используется класс flash.net.URLLoader.
}
}
}
Наконец, связываем поведение класса LoginForm с символами формы регистрации. Однако поскольку один класс не может быть связан более чем с одним символом, мы не сможем связать класс LoginForm непосредственно с символами формы регистрации. Вместо этого мы должны связать каждый символ формы регистрации с подклассом класса LoginForm. Этот процесс заключается в выполнении следующих шагов.
Выберите символ LoginForm_Stylel в библиотеке файла LoginApp. fla.
Откройте меню Options (Свойства) палитры Library (Библиотека), щелкнув кнопкой мыши на значке в правом верхнем углу палитры, и выберите команду Linkage (Связывание).
В области Linkage (Связывание) окна Linkage Properties (Свойства связывания) установите флажок Export for ActionScript (Экспорт для ActionScript).
В поле Base class (Базовый класс) окна Linkage Properties (Свойства связывания) введите LoginForm.
В поле Class (Класс) окна Linkage Properties (Свойства связывания) введите LoginForm_Stylel.
Нажмите кнопку ОК.
По умолчанию в результате выполнения предыдущих шагов среда разработки Flash выведет окно с предупреждением следующего содержания: A definition for this class could not be found in the classpath, so one will be automatically generated in the SWF file on export (Определение для данного класса не может быть найдено в пути к классам, поэтому он будет автоматически сгенерирован в SWF-файле при экспорте). Нажмите кнопку ОК этого окна.
Выберите символ LoginForm_Style2 в библиотеке файла LoginApp. fla, после чего повторите шаги 2-6, заменив значение LoginForm_Stylel значением LoginForm_Style2 на шаге 6.
В результате выполнения предыдущих шагов компилятор Flash на этапе компиляции автоматически создаст два класса — LoginForm_Stylel и LoginForm_Style2, каждый из которых расширяет класс LoginForm. Затем компилятор свяжет символ LoginForm_Stylel с классом LoginForm_Stylel, а символ LoginForm_Stу 1е2 — с классом LoginForm_Style2. Таким образом, оба символа наследуют поведение класса LoginForm.
Композиционный подход как альтернатива связанным классам
В этом разделе мы научились обеспечивать поведением символы Movie Clip (Клип), связывая их с пользовательскими классами. В качестве альтернативного подхода, чтобы обеспечить символ программным поведением, мы можем просто создать экземпляр любого пользовательского класса на временной шкале символа и затем использовать этот экземпляр для управления данным символом.
Например, в предыдущем разделе мы связали символы формы регистрации с классом LoginForm, чтобы предоставить этим символам возможность отправлять информацию на сервер программным путем. Однако можно утверждать, что класс LoginForm не является подтипом класса MovieClip. Скорее это простая коммуникационная утилита, которая помогает получить введенные данные из пользовательского интерфейса. Как таковая, она может (и, возможно, должна) быть определена в виде отдельного класса для последующего использования любым символом, который соглашается предоставлять соответствующие данные.
Для простоты сравнения, следующий код демонстрирует новую версию класса LoginForm, переработанного для использования в качестве вспомогательного класса на временной шкале символа. Новый класс имеет новое имя LoginManager, отражающее его новую роль — класс коммуникационной утилиты. Обратите внимание, что конструктор нового класса принимает ссылки на объекты пользовательского интерфейса, поддерживающие пользовательский ввод.
package {
import flash.display.*;
import fl ash.text.*:
import flash.events.*:
public class LoginManager {
private var username:TextField:
private var password:TextField:
public function LoginManager (username:TextField.
password:TextField.
submitBtn:SimpleButton) {
this.username = username:
this.password = password:
submitBtn.addEventListenerCMouseEvent.CLICK. submitListener):
}
private function subm1tL1stener (e:MouseEvent):void { submit(username.text, password.text):
}
public function submit (name:Str1ng, pass:Str1ng):void { traceCNow submitting user: " + name + " with password: " + pass):
// Теперь передаем полученную информацию на сервер (код не показан).
// Обычно для отправки данных на сервер используется класс
// flash.net.URLLoader.
}
}
}
Чтобы использовать класс LoginManager, в каждом из символов формы регистрации из предыдущего раздела должен быть определен сценарий кадра со следующим кодом (предположительно, в кадре 1, но в случае с анимированной формой, возможно, далее на временной шкале). В следующем коде аргументы user name, password и submi tBtn являются именами экземпляров текстовых полей и кнопки в символе формы регистрации:
var loglnManager:LoginManager = new Log1nManager(username, password. submltBtn):
Различие между подходом с использованием класса LoginManager и подходом с использованием класса LoginForm из предыдущего раздела, по сути дела, аналогично различию между композицией и наследованием (дополнительные сведения можно найти в'подразд. «Наследование в сравнении с композицией» разд. «Теория наследования» гл. 6). Потенциальными преимуществами подхода с использованием композиции являются следующие.
Класс LoginManager может наследоваться от любого произвольного класса, в отличие от класса LoginForm, который должен наследоваться от класса MovieClip.
Разработчик символа формы регистрации может изменять имена экземпляров текстовых полей и кнопки отправки данных, не оказывая влияния на функциональность класса LoginManager.
Теперь перейдем к рассмотрению нашей последней темы по среде разработки Flash, касающейся предварительной загрузки классов.
Предварительная загрузка классов
При компиляции SWF-файла среда разработки Flash по умолчанию экспортирует все классы из первого кадра SWF-файла. Как результат, загрузка всех классов должна быть завершена до того, как на экране отобразится первый кадр SWF- файла. В зависимости от общего размера классов, включенных в SWF-файл, этот процесс может привести к заметной задержке перед началом воспроизведения SWF-файла.
Чтобы избежать этого, мы можем экспортировать классы SWF-файла после кадра 1 на основной временной шкале, а затем создать простой сценарий временной шкалы, который отображает информацию о ходе загрузки классов.
В качестве примера изменим наш файл sky.Па таким образом, чтобы классы, которые он использует, не загружались до кадра 15. Стоит отметить, однако, что класс документа SWF-файла — и любой класс, на который прямо или косвенно ссылается класс документа, — всегда загружается в кадре 1. Таким образом, чтобы предотвратить загрузку класса Star до кадра 1, мы должны сначала удалить имена всех созданных вручную экземпляров класса Star и определения переменных starl — star5 из кода класса Sky. Чтобы удалить имена экземпляров, мы выбираем каждый экземпляр символа Star на сцене и удаляем его имя на палитре Properties (Свойства).
Далее описывается, как загрузить классы файла sky .fla в кадре 15 и отобразить соответствующее сообщение в процессе загрузки классов.
Сначала выполним следующие шаги, чтобы указать компилятору Flash на необходимость экспортирования классов файла sky.fla в кадре 15.
Откройте файл sky. fla в среде разработки Flash.
Выберите команду меню File ► Publish Settings (Файл ► Настройки публикации).
В окне Publish Settings (Настройки публикации) нажмите кнопку Settings (Параметры), расположенную возле параметра ActionScript version (Версия ActionScript) с установленным значением ActionScript 3.0 на вкладке Flash.
В поле Export Classes in Frame (Экспортировать классы в кадре) окна ActionScript Settings (Параметры ActionScript) введите 15.
Нажмите кнопку ОК, для того чтобы закрыть окно ActionScript Settings (Параметры ActionScript).
Снова нажмите кнопку ОК, чтобы закрыть Publish Settings (Настройки публикации).
Далее на временную шкалу файла sky. fla мы добавляем очень простой предварительный загрузчик, который отображает сообщение Loading (Загрузка) в процессе загрузки классов.
Следующие процедуры подразумевают предварительное знакомство со слоями и метками кадров временной шкалы, но, даже если вы никогда не сталкивались с этими аспектами среды разработки Flash, вы сможете выполнить процедуры в соответствии с приведенным описанием.
Сначала на основной временной шкале файла sky. fla мы дважды щелкаем кнопкой мыши на имени слоя Layer 1 (Слой 1) и изменяем его на sky. Затем мы увеличиваем размер временной шкалы до 15 кадров следующим образом.
На основной временной шкале щелкните на кадре 1 слоя sky, чтобы выделить этот кадр.
Щелкните кнопкой мыши на ключевом кадре 1 и, удерживая кнопку мыши, перетащите его на кадр 15 временной шкалы.
В результате увеличения временной шкалы, описанного в предыдущей процедуре, экземпляры символа звезды, которые до этого отображались в кадре 1, теперь будут отображаться в кадре 15 (где загружается класс Star).
Далее мы добавим новый слой для кода и назовем его scripts.
Выберите команду меню Insert ► Timeline ► Layer (Вставка ► Временная шкала ► Слой).
Дважды щелкните кнопкой мыши на имени нового слоя и измените его на scripts. После этого мы добавим слой labels с двумя метками кадров — loading и main. Они обозначают состояние загрузки и стартовую точку для приложения соответственно.
Выберите команду меню Insert ► Timeline ► Layer (Вставка ► Временная шкала ► Слой).
Дважды щелкните кнопкой мыши на имени нового слоя и измените его на labels.
В кадрах 4 и 15 слоя labels добавьте новые ключевые кадры (используя команду меню Insert ► Timeline ► Keyframe (Вставка ► Временная шкала ► Ключевой кадр)).
Выбрав кадр 4 на слое labels, в поле Frame (Кадр) палитры Properties (Свойства) вместо <Frame Label> (Метка кадра) введите loading.
Выбрав кадр 15 на слое labels, в поле Frame (Кадр) палитры Properties (Свойства) вместо <Frame Label> (Метка кадра) введите main.
Теперь добавим сценарий предварительного загрузчика на слой scripts.
В кадре 5 слоя scripts добавьте новый ключевой кадр (используя команду меню Insert ► Timeline ► Keyframe (Вставка ► Временная шкала ► Ключевой кадр)).
Выбрав кадр 5 слоя scripts, введите следующий код на палитре Actions (Действия): if (framesLoaded == total Frames) {
gotoAndStop("ma1n"):
} else {‘
gotoAndPlay (" 1oad1 ng"):
}
Наконец, добавим сообщение о загрузке, отображаемое в процессе загрузки классов файла star. Па:
Выбрав кадр 1 слоя scripts, введите следующий код на палитре Actions (Действия):
Import flash.text.*:
var loadMsg:TextF1eld = new TextF1eld( ):
loadMsg.text = "Loading...Please wait.";
loadMsg.autoSize = TextF1eldAutoS1ze.LEFT:
loadMsg.border = true:
loadMsg.background = true:
loadMsg.selectable = false:
addChl1d(1oadMsg):
В кадре 15 слоя scripts добавьте новый ключевой кадр (используя команду меню Insert ► Timeline ► Keyframe (Вставка ► Временная шкала ► Ключевой кадр)).
Выбрав кадр 15 слоя scripts, введите следующий код на палитре Actions (Действия):
removeChiId(loadMsg);
Вот и все! Вы можете протестировать приложение sky.swf, выбрав команду меню Control ►Test Movie (Управление ► Проверка фильма). Находясь в режиме Text Movie (Проверка фильма), можно имитировать процесс загрузки SWF-файла, открыв палитру Bandwidth Profiler (Профайлер полосы пропускания) (команда меню View ► Bandwidth Profiler (Вид ► Профайлер полосы пропускания)) и выбрав команду меню View ► Simulate Download (Вид ► Имитировать загрузку). Поскольку наш класс Star имеет совсем небольшой размер, нужно установить очень низкую скорость загрузки (например, 200 байт в секунду), чтобы увидеть сообщение о предварительной загрузке. Чтобы изменить скорость загрузки, выберите команду меню View ► Download Settings (Вид ► Параметры загрузки).
Вы можете загрузить предыдущий пример файла sky.Па по адресу http://www. moock.org/eas3/examples.
При задании значения в поле Exports Classes in Frame (Экспортировать классы в кадре) примите во внимание, что:
класс документа FLA-файла всегда экспортируется в кадре 1, независимо от значения, указанного в поле Exports Classes in Frame (Экспортировать классы в кадре);
все классы, на которые ссылается класс документа или сценарий основной временной шкалы, экспортируются в кадре 1, независимо от значения, указанного в поле Exports Classes in Frame (Экспортировать классы в кадре);
если установлен флажок Automatically declare stage instances (Автоматически объявлять экземпляры сцены) и сцена основной временной шкалы содержит именованные экземпляры символа, связанного с классом, то этот связанный класс будет экспортирован в кадре 1 (поскольку на этот класс ссылаются переменные, объявляемые автоматически для экземпляров на сцене).
Далее в программе: использование платформы разработки Нех
В этой главе были рассмотрены многие прикладные методики работы с кодом на языке ActionScript в среде разработки Flash. В следующей главе будет рассказано, как применять компоненты пользовательского интерфейса платформы разработки Flex в проекте приложения Flex Builder 2 на языке ActionScript. Затем из гл. 31 вы узнаете, как использовать готовый код совместно с другими разработчиками.
Минимальное приложение на языке MXML
В гл. 20 рассказывалось, что платформа разработки Flex включает развитый набор настраиваемых компонентов для создания пользовательских интерфейсов. Компоненты пользовательского интерфейса платформы разработки Flex обычно применяются в приложениях на языке MX ML, но также могут применяться в приложениях, написанных в основном на языке ActionScript. Для тех читателей, которые не желают использовать язык MXML, в этой главе рассматривается абсолютный минимум шагов, необходимый для применения компонентов пользовательского интерфейса платформы разработки Flex в проекте приложения Flex Builder 2 с помощью минимально возможного количества инструкций языка MXML.
Во избежание недоразумений, эта глава не имеет ничего против языка MXML. В целом, язык MXML — это отличный инструмент для создания стандартизованных интерфейсов, развертываемых на платформе Flash. В этой главе просто рассматриваются ситуации, в которых либо макет приложения создается полностью программным путем, либо разработчик не имеет времени или желания изучать язык MXML.
-^Г-^ГПолную информацию о языке MXML и платформе разработки Flex можно найти в документации корпорации Adobe и книге «Programming Flex 2» (Kazoun and Lott, 2007) издательства O’Reilly.
-^Г
-^Г
Пользователи среды разработки Flash должны помнить, что приложение Flash CS3 включает собственный набор компонентов пользовательского интерфейса в пакете fl. Компоненты приложения Flash CS3 могут также быть использованы (как с технической точки зрения, так и с точки зрения допустимости) в программах на языке ActionScript, компилируемых с помощью приложения Flex Builder 2 или компилятора mxmlc.
Общий подход
Рассмотрим минимальный набор шагов, необходимых для создания приложения, которое использует компоненты пользовательского интерфейса платформы разработки Flex, на языке ActionScript.
В приложении Flex Builder 2 создайте проект Flex.
В новом проекте определите класс со статическим методом, который будет служить стартовой точкой для приложения.
В основном MXML-файле добавьте свойство события MXML, получающее уведомления о возникновении события FlexEvent. APPLICATION-COMPLETE
экземпляра класса Application верхнего уровня и в ответ вызывает статический метод, определенный на шаге 2.
В статическом методе, который был определен на шаге 2, создайте желаемые компоненты пользовательского интерфейса и добавьте их в экземпляр класса Application.
Перечисленные шаги подробно рассматриваются в следующих разделах.
Создание проекта Flex
Чтобы создать проект для приложения, выполните следующие шаги.
В приложении Flex Builder 2 выберите команду меню File ► New ► Flex Project (Файл ► Создать ► Проект Flex).
В окне New Flex Project (Новый проект Flex) установите переключатель How will your Flex application access data? (Как ваше приложение Flex будет обращаться к данным?) в положение Basic (Основной) и затем нажмите кнопку Next (Далее).
В поле Project name (Имя проекта) введите желаемое имя проекта и нажмите кнопку Next (Далее).
В поле Main source folder (Основная папка исходных файлов) введите sr с.
В поле Main application file (Основной файл приложения) введите желаемое имя файла с расширением MXML. Например, MinimalMXML .mxml.
Нажмите кнопку Finish (Готово).
В результате выполнения предыдущих шагов приложение Flex Builder 2 создаст новый проект, в пути библиотек которого будет автоматически включен файл framework. swe, содержащий компоненты пользовательского интерфейса.
После создания проекта мы добавим стартовую точку для приложения, как описано в следующем разделе.
Создание стартовой точки для приложения
Стартовая точка для нашего приложения представляет собой статический метод, определенный в пользовательском классе. В нашем примере мы назовем этот статический метод именем name ( ), а пользовательский класс — Ent ryClass. Метод main ( ) создает экземпляры компонентов пользовательского интерфейса и добавляет их в иерархию отображения экземпляра класса Application верхнего уровня. Экземпляр класса Application верхнего уровня создается автоматически, служит основой для всех приложений на языке MXML и предоставляет доступ к списку отображения. Обратиться к экземпляру класса Application верхнего уровня из нашей программы можно через статическую переменную application классаmx. core .Application.
В листинге 30.1 представлен код для класса EntryClass.
Листинг 30.1. Класс на языке ActionStript для минимального приложения MXML package {
import mx.controls.*;
import mx.core.*:
public class EntryClass {
// Стартовая точка для приложения
public static function main ( ):vo1d {
// Создаем компоненты пользовательского интерфейса
// платформы разработки Flex.•
// Например:
van button:Button = new Button( ):
// Добавляем компоненты
// пользовательского интерфейса на экран.
// Например:
van mxml Арр Application = Appl1cat1on(Appl1cat1on.application):
mxmlАрр.a ddCh11d(button):
}
}
}
Создав метод EntryClass .main ( ), мы можем вызывать его в ответ на возникновение события FlexEvent.APPLICATION-COMPLETE экземпляра класса Application верхнего уровня, как описывается в следующем разделе.
Вызов стартовой точки для приложения
Ранее в подразд. «Создание проекта Flex» мы определили, что основным файлом приложения для нашего примера проекта является MinimalMXML .mxml. В итоге приложение Flex Builder 2 автоматически помещает в него следующий код:
<?xml vers1on="l.O" encod1ng="utf-8"?>
<mx:Appl1cat1on xml ns:mx="http://www.adobe.com/2006/mxml" layout="absolute">
</mx:Appl1cat1on>
Придется внести лишь одно незначительное изменение в приведенный код на языке MXML: мы должны добавить свойство события, которое вызывает метод EntryClass .main ( ) при получении экземпляром класса Application верхнего уровня уведомления о возникновении события FlexEvent .APPLICATION—COMPLETE. Этот подход продемонстрирован в следующем коде (соответствующие изменения выделены полужирным шрифтом):
<?xml vers1on="l.O" encod1ng="utf-8"?>
<mx:Appl1ca11 on xml ns:mx="http://www.adobe.com/2006/mxml"
layout="absolute" appl1cat1onComplete="EntryClass.main( )">
</mx:Appl1cat1on>
В результате выполнения предыдущего кода приложение, завершив процесс инициализации, автоматически вызовет метод EntryClass . main ( ), который, в свою очередь, создаст экземпляры желаемых компонентов пользовательского интерфейса (смотрите, никакого MXML!).
Применим общий подход, рассмотренный в предыдущих разделах, на реальном примере.
Реальный пример применения кемпенентпв пользовательского интерфейса
Чтобы увидеть, как применять код на языке ActionScript для создания 11 у 11 равле111ш компонентами пользовательского интерфейса платформы разработки Flex, создадим простое приложение, которое содержит всего два экземпляра компонентов: экземпляр компонента Button и экземпляр компонента DataGrid. Приложение просто считает, сколько раз пользователь щелкнул кнопкой мыши на экземпляре компонента Button. Экземпляр компонента DataGrid отображает общее количество щелчков и интервал времени между ними.
Назовем основной файл MXML нашего приложения MinimalMXML. mxml, а класс, определяющий стартовую точку для нашего приложения, — Clickometer.
Рассмотрим код для файла MinimalMXML .mxml:
<?xml vers1on="l.O" encod1ng="utf-8"?>
<mx:Appl1 call on xml ns:mx="http://www.adobe.com/2006/mxml" layout="vertical" appl1cat1onComplete="Clickometer.ma1n( )">
</mx:Appl1cation>
В коде обратите внимание, что значение свойства события applicationComplete определяет метод (Clickometer .main ( ) ), который будет вызван после того, как приложение завершит процесс инициализации. Стоит также отметить, что приложение использует «вертикальную» схему размещения. Информацию по вариантам размещения можно найти в разделе, посвященном описанию переменной экземпляра layout класса Application, справочника по языку ActionScript корпорации Adobe.
Теперь рассмотрим код для класса Clickometer, в котором создаются компоненты пользовательского интерфейса:
package {
Import mx.controls.*:
Import mx.core.*:
Import flash.events.*:
Import flash.utils.*:
public class Clickometer {
private static var 1astCl1ckT1me:1 nt = 0:
private static var numCHcks:1nt = 0:
private static var gr1d:DataGr1d:
private static var button:Button:
// Точка входа программы
public static function main ( ):vo1d {
// Создаем кнопку
button = new Button( ):
button.label = "Click Quickly!":
button.addEventLIstener(MouseEvent.CLICK, cl 1ckL1stener):
// Создаем таблицу данных
grid = new DataGr1d( );
gr1d.dataProv1der = new Array( );
// Добавляем отображаемые элементы на экран. Переменная
// Application.application ссылается на приложение Flex верхнего // уровня - основной контейнер для компонентов пользовательского // интерфейса и отображаемых элементов.
var mxml Арр Application = Appl1cat1on(Appl1cat1on.application);
mxmlApp.a ddCh11d(button);
mxmlApp.addChlld(grld);
}
// Этот метод вызывается всякий раз, когда пользователь
// нажимает кнопку
private static function c!1ckL1stener (e:MouseEvent):void {
var now:1 nt = getT1mer( );
var elapsed:1nt = now - lastCUckTIme;■
lastCUckTIme = now;
numCHcks++;
gr1d.dataProv1der.addItem({CHcks: numCHcks, "Time (ms)": elapsed});
}
}
}
Приведенный пример приложения можно загрузить по адресу http://www.moock. org/eas3/examples.
Передача кода вашим друзьям
Итак, в этой книге осталась всего одна глава. Что же является последним основополагающим вопросом языка ActionScript? Совместное использование вашего гениального кода с другими программистами. Для совместного использования кода на языке ActionScript можно просто отправить этот особый код в виде одного или нескольких файлов ваших классов. Или, если вы более амбициозны, можете создать целую библиотеку классов (то есть группу классов) для включения в приложение на этапе компиляции или на этапе выполнения. В последней главе этой книги рассматриваются способы создания и распространения кода с использованием библиотек классов.
Распространение библиотеки классов
В этой главе рассматриваются три конкретные методики совместного использования группы классов (библиотеки классов) в нескольких проектах и несколькими разработчиками. Несомненно, самый легкий способ совместного использования классов заключается в простом распространении исходного кода. Мы рассмотрим этот простейший случай перед тем, как перейти к обсуждению методов совместного использования классов без распространения исходного кода, что может потребоваться при продаже профессиональной библиотеки классов.
Термин «библиотека классов» на жаргоне программистов обозначает произвольную группу классов, распространяемую среди команды разработчиков или по всему миру. Не путайте этот термин с библиотекой FLA-файла или палитрой Library (Библиотека) среды разработки Flash. Эти термины относятся исключительно к среде разработки Flash и не являются частью текущего обсуждения.
В ActionScript распространять библиотеку классов между другими разработчиками можно либо просто в виде набора исходных AS-файлов, либо в виде SWF-файла, либо в виде SWC-файла. В этой главе мы рассмотрим все три подхода. Стоит отметить, однако, что ActionScript предоставляет широкий набор возможностей по распространению библиотек классов; в этой главе описаны три конкретные ситуации, однако представленный материал не является исчерпывающим. Дополнительную информацию по распространению библиотек классов можно найти в следующих разделах документации корпорации Adobe:
Programming ActionScript 3.0 ► Flash Player APIs ► Client System Environment ►
ApplicationDomain class (http://livedocs.macromedia.com/flex/201/html/18_Client_ System_Environment_175_4.html);
Building and Deploying Flex 2 Applications ► Building Flex Applications ► Using Runtime Shared Libraries (http://livedocs.macromedia.com/flex/201/html/rsl_124_l.html).
Файлы примеров, которые будут рассматриваться в этой главе, доступны по адресу http://www.moock.org/eas3/examples.
Совместное использование исходных файлов классов
Начнем с простейшего способа распространения библиотеки классов: совместного использования исходных файлов классов.
Представьте, что вы работаете в небольшой компании Beaver Code, занимающейся разработкой веб-приложений и имеющей свой сайт http://www.beavercode.com. Вы создали класс com. beavercode . effects . TextAnimation, который реализует различные текстовые эффекты. Вы хотите использовать класс TextAnimation на двух других сайтах, над которыми работаете в настоящий момент, — Barky Pet Supplies и Mega Bridal Depot. Вместо того чтобы помещать копию файла класса (то есть файл TextAnimation. as) в папку каждого проекта, вы сохраняете этот файл класса в центральном хранилище и просто обращаетесь к нему из каждого проекта. Например, для сохранения файла TextAnimation. as в операционной системе Windows вы используете следующее местоположение: с: \data\ actionscript\com\beavercode\effects\TextAnimation.as .Чтобыкласс TextAnimation был доступен для обоих проектов, вы включаете директорию c:\data\actionscript в путь к классам каждого проекта (дополнительную информацию по пути к классам можно найти в гл. 7).
Следуя той же логике, если бы ваша команда состояла из нескольких разработчиков, вы могли бы предположить, что удобно разместить классы на центральном сервере, при этом каждый разработчик мог бы воспользоваться ими, добавив папку сервера в путь к классам своих проектов. Например, вы могли бы сохранить все совместно используемые классы на сервере с именем codecentral: \\codecentral\com\ beavercode\effects\TextAnimation. as. Однако работать непосредственно с сервером крайне опасно и не рекомендуется.
Если вы сохраняете свои классы на центральном сервере и позволяете разработчикам непосредственно изменять их, то могут возникать ситуации, когда один разработчик перезаписывает изменения другого разработчика. Более того, если часы сервера и часы персонального компьютера программиста не синхронизированы, последняя версия класса может быть не включена в программу на этапе компиляции. Чтобы избежать подобных проблем, вы должны всегда использовать программное обеспечение для контроля версий, позволяющее управлять файлами ваших классов при работе в команде. Двумя популярными (и бесплатными!) вариантами такого программного обеспечения являются CVS (http://www.cvshome.org) и Subversion (http://subversion.tigris.org).
Кроме того, при работе с большими проектами вы также можете захотеть автоматизировать процесс экспорта SWF-файла, используя такой инструмент компиляции, как, например, Apache Ant (http://ant.apache.org).
Информацию об использовании инструмента Ant в приложении Flex Builder 2 можно найти в разделе Using Flex Builder 2 ► Programming Flex Applications ► Building Projects ► Advanced build options ► Customizing builds with Apache Ant (http://livedocs. macromedia.com/flex/201/html/build_044_12.html).
Автоматизация экспорта SWF-файла в среде разработки Flash заключается в выполнении консольного JSFL-сценария, который сообщает компилятору Flash о необходимости создания SWF-файла для каждого FLA-файла в вашем проекте. Исчерпывающее рассмотрение консольной компиляции в среде разработки Flash выходит за рамки этой книги, однако ниже представлен небольшой пример, который дает общее представление о содержимом этого сценария в операционной системе Windows:
// Код в файле exportPetSuppHes. jsfl:
// ===============================
// Открываем FLA-файл.
var doc = fl.openDocument("file.7//c|/data/projects/pet/petsupplies.fla");
// Экспортируем SWF-файл.
doc.exportSWFC"fl 1e:///c|/data/projects/pet/petsuppl1es.swf", true):
// Закрываем среду разработки Flash (не обязательно), fl.quit(false):
// Команда, вызываемая из командной строки в директории /pet/:
// ====================================================
"Епапка_среды_разработkh_F1 ash]\f1 ash.exe" exportPetSuppl 1es.jsfl
Чтобы предыдущий пример команды был выполнен, среда разработки Flash не должна быть запущена. После вызова команды в директории с: \data\projects\ pet появится скомпилированный клип petsupplies . swf.
Распространение библиотеки классов в виде SWC-файла
Когда над проектом работает команда удаленных разработчиков или библиотека классов публикуется для всего мира, подход с предоставлением непосредственного доступа к файлам классов может оказаться обременительным. Для удобства инструменты языка ActionScript корпорации Adobe предоставляют возможность включения библиотеки классов в один файл, имеющий формат SWC.
В следующих разделах сначала описывается, как создать SWC-файл, содержащий библиотеку классов, а затем рассматривается, как использовать классы из этой библиотеки в приложении.
Создание библиотеки классов в формате SWC в приложении Flex Builder 2
Чтобы продемонстрировать процесс создания SWC-файла, содержащего библиотеку классов, в приложении Flex Builder 2, мы вернемся к примеру с компанией Beaver Code из предыдущего раздела. Наша библиотека классов будет называться beavercore и будет помещена в пакет com.beavercore. Название пакета соответствует названию фиктивного сайта http://www.beavercore.com, который был создан разработчиками компании Beaver Code для размещения библиотеки классов beavercore.
Следующие шаги описывают, как создать файл beavercore, swc, содержащий библиотеку классов beavercore. Для простоты библиотека содержит всего один класс — com.beavercore.effects.TextAnimation.
В приложении Flex Builder выберите команду меню File ► New ► Flex Library Project (Файл ► Создать ► Проект библиотеки Flex).
В поле Project name (Название проекта) окна New Flex Library Project (Новый проект библиотеки Flex) введите beavercore, после чего нажмите кнопку Next (Далее).
В поле Main source folder (Основная папка исходных файлов) введите зге и нажмите кнопку Finish (Готово).
Указав в проекте beavercore папку sre, выберите команду меню File ► New ► Folder (Файл ► Создать ► Папка). В поле Folder name (Имя папки) введите сот. Повторите этот процесс, чтобы создать следующую структуру папок: зге/сот/ beavercore/effeets.
Указав в проекте beavercore папку effects, выберите команду меню File ► New ► ActionScript Class (Файл ► Создать ► Класс ActionScript).
В поле Name (Имя) окна New ActionScript Class (Новый класс ActionScript) введите TextAnimation, после чего нажмите кнопку Finish (Готово).
В файле TextAnimation. аз введите следующий код:
package com.beavercore.effects {
public class TextAnimation {
public function TextAnimation ( ) {
trace("Imag1ne a text effect with great majesty.");
public function start ( ):vo1d { traceCEffect now starting.");
}
}
На палитре Navigator (Навигатор) выберите папку проекта beavercore, а затем меню Project ► Build Project (Проект ► Скомпилировать проект).
Обратите внимание, что команда Build Project (Скомпилировать проект) доступна только в том случае, если флажок Project ► Build Automatically (Проект ► Автоматическая компиляция) снят. Если он установлен, пропустите шаг 8.
В результате выполнения предыдущих шагов приложение Flex Builder 2 создаст файл beavercore. swc и поместит его в папку /bin/. Файл содержит классы проекта в скомпилированном виде. В нашем простом примере приложение Flex Builder добавляет все классы из проекта beavercore в файл beaver core. swc. В более сложной ситуации мы могли бы указать явно, какие классы должны быть включены в этот файл или исключены из него, выбрав команду меню Project ► Properties (Проект ► Свойства) и определив список классов на вкладке Classes (Классы) свойства Flex Library Build Path (Путь компиляции библиотеки Flex).
Использование библиотеки классов в формате SWC в приложении Hex Builder 2
Теперь, когда мы создали библиотеку классов в формате SWC (beavercore. swc), посмотрим, как использовать ее в проекте.
Предположим, что мы создаем сайт с применением технологии Flash в приложении Flex Builder 2 для компании Barky’s Pet Supplies. При разработке сайта мы хотим
использовать класс TextAnimation из библиотеки классов beavercore. swc. Рассмотрим, как это сделать.
В приложении Flex Builder выберите команду меню File ► New ► ActionScript Project (Файл ► Создать ► Проект ActionScript).
В поле Project name (Название проекта) окна New ActionScript Project (Новый проект ActionScript) введите beaver_barkys, после чего нажмите кнопку Next (Далее).
В поле Main source folder (Основная папка исходных файлов) введите sr с.
В поле Main application file (Основной файл приложения) введите Barkys.
На вкладке Library path (Пути библиотек) нажмите кнопку Add SWC (Добавить SWC).
Найдите и выберите файл beavercore. swc из предыдущего раздела, после чего нажмите кнопку Finish (Готово).
В файле Barkys . as (который откроется автоматически) введите следующий код: package {
import flash.display.Sprite:
1mport com.beavercore.effects.TextAnlmat1on;
public class Barkys extends Sprite {
public function Barkys ( ) {
var textAnl:TextAn1mat1on = new TextAnlmat1on( ); textAn1.start( ):
}
}
}
На палитре Navigator (Навигатор) выберите папку проекта beaver_barkys, а затем выберите команду меню Run ► Debug Barkys (Выполнить ► Отладка Barkys).
В результате выполнения предыдущих шагов компилятор сгенерирует SWF-файл (Barkys. swf), включающий класс TextAnimation, и выполнит этот файл. В окне Console (Консоль) появятся следующие сообщения:
Imagine a text effect with great majesty.
Effect now starting.
Как вы видите, класс Barkys создает прямую ссылку на класс TextAnimation, будто последний на самом деле является частью проекта beaver_barkys.
Теперь, когда известно, как создать и распространить библиотеку классов в виде SWC-файла с помощью приложения Flex Builder 2, рассмотрим, как проделать то же самое в среде разработки Flash.
Создание библиотеки классов в формате SWC
в среде разработки Hash
Следующие шаги описывают, как использовать среду разработки Flash для создания библиотеки классов с именем beavercore. swc, содержащей единственный класс TextAnimation.
Создайте новую папку с именем beavercore в файловой системе. Папка будет содержать исходные файлы для библиотеки классов.
В ней создайте структуру вложенных папок: com/beavercore/ef fects.
В папке effects создайте новый текстовый файл с именем TextAnimation. as.
В файле TextAnimation. as введите следующий код:
package com.beavercore.effects {
public class TextAnimation {
public function TextAnimation ( ) {
traceC Imagi ne a text effect with great majesty."):
}
public function start ( ):void { trace("Effect now starting.");
В папке beavercore создайте новый текстовый файл с именем BeaverCore. as.
В файле BeaverCore. as введите следующий код. Обратите внимание, что класс BeaverCore содержит ссылки на классы (и другие определения), которые мы хотим включить в библиотеку классов.
package {
Import com.beavercore.effects.*;
Import flash.display.Sprite;
public class BeaverCore extends Sprite { com.beavercore.effects.TextAnlmat1 on;
В среде разработки Flash создайте новый FLA-файл и сохраните его под именем beavercore. fla в папке beavercore.
В поле Document class (Класс документа) палитры Properties (Свойства) (команда меню Window ► Properties (Окно ► Свойства)) введите BeaverCore.
Выберите команду меню File ► Publish Settings (Файл ► Настройки публикации).
На вкладке Formats (Форматы) в области Туре (Тип) снимите флажок HTML
И. На вкладке Flash в области Options (Параметры) установите флажок Export SWC (Экспорт SWC).
Нажмите кнопку Publish (Опубликовать), а затем — кнопку ОК.
В результате выполнения предыдущих шагов среда разработки Flash сгенерирует файл beavercore. swc и поместит его в папку beavercore. Этот файл содержит классы в скомпилированном виде.
Использование библиотеки классов в формате SWC в среде разработки Hash
Следующие шаги описывают процесс, который позволит использовать класс TextAnimation из библиотеки классов beavercore. swc при разработке сайта для компании Barky’s Pet Supplies.
Создайте новую папку с именем barkys в файловой системе. Папка будет содержать исходные файлы для сайта.
В папке создайте новый текстовый файл с именем Barkys .as.
В файле введите следующий код:
package {
Import flash.display.Sprite:
1mport com.beavercore.effects.TextAnlmat1on:
public class Barkys extends Sprite {
public function Barkys ( ) {
var textAnl:TextAn1mation = new TextAnlmat1on( );
textAnl.start( ):
В среде разработки Flash создайте новый FLA-файл и сохраните его в папке barkys под именем barkys . fla.
В поле Document class (Класс документа) палитры Properties (Свойства) (команда меню Window ► Properties (Окно ► Свойства)) введите Barkys.
Во вложенной папке Configuration\Components, находящейся внутри папки с установленной средой разработки Flash, создайте новую папку с именем BeaverCode.
В Windows ХР местоположением вложенной папки Configuration\Components по умолчанию является С :\Program Files\Adobe\Adobe Flash CS3\ en\Configuration\Components. В Mac OS X местоположением вложенной папки Configuration\Components по умолчанию является Macintosh HD: Applications : Adobe Flash CS3 : Configuration: Components.
Скопируйте файл beavercore. swc, описанный в предыдущем разделе, в папку BeaverCode, которая создана на шаге 6. В результате копирования файла beavercore. swc в подпапку Configuration\Components на палитре Components (Компоненты) среды разработки Flash появится соответствующая запись.
В среде разработки Flash откройте палитру Components (Компоненты) (команда меню Window ► Components (Окно ► Компоненты)).
Откройте меню Options (Параметры) палитры Components (Компоненты), щелкнув кнопкой мыши на значке в правом верхнем углу палитры, и выберите команду Reload (Обновить). Папка BeaverCode появится на палитре Components (Компоненты).*
На палитре Components (Компоненты) откройте папку BeaverCode.
И. Откройте библиотеку файла barkys .fla (команда меню Window ► Library (Окно ► Библиотека)).
Перетащите компонент BeaverCore с палитры Components (Компоненты) в библиотеку файла barkys.fla.
Выберите команду меню Control ► Test Movie (Управление ► Проверка фильма).
В результате выполнения предыдущих шагов компилятор сгенерирует SWF-файл (Barkys. swf), включающий класс Text Animat ion, и выполнит этот SWF-файл. В окне Output (Вывод) появятся следующие сообщения:
Imagine a text effect with great majesty.
Effect now starting.
Обратите внимание на то, что класс Barkys создает прямую ссылку на класс TextAnimation — таким же образом класс Barkys может обращаться к любому классу, доступному в пути.
Распространение библиотеки классов в виде SWF-файла
При работе с несколькими SWF-файлами, которые используют один и тот же класс, компиляция этого класса в каждый SWF-файл будет приводить к потере пространства. Когда размер файла имеет существенное значение, мы можем избежать подобного дублирования, создав библиотеку классов в виде отдельного SWF-файла и загружая его на этапе выполнения. Как только библиотека будет загружена в первый раз, она окажется в кэше компьютера конечного пользователя и может быть использована другими SWF-файлами, не вызывая повторной загрузки.
Процесс создания и использования библиотеки классов в формате SWF гораздо сложнее процесса использования библиотеки классов в формате SWC. Следовательно, вы должны использовать такие библиотеки только в тех случаях, когда необходимо максимально уменьшить размер файла вашего приложения.
В следующих разделах сначала описывается, как создать SWF-файл, содержащий библиотеку классов, а затем рассматривается, как использовать классы из этой библиотеки в приложении.
Создание библиотеки классов в формате SWF в приложении Flex Builder 2
Чтобы продемонстрировать процесс создания SWF-файла, содержащего библиотеку классов, в приложении Flex Builder 2, мы снова вернемся к примеру с библиотекой beaver core. Следующие шаги описывают, как создать библиотеку классов с именем beavercore . swf, содержащую единственный класс TextAnimation (предположим, что мы начинаем с нуля, хотя некоторые из перечисленных шагов повторяются из подразд. «Создание библиотеки классов в формате SWC в приложении Flex Builder 2» предыдущего раздела).
В приложении Flex Builder выберите команду меню File ► New ► Flex Library Project (Файл ► Создать ► Проект библиотеки Flex).
В поле Project name (Название проекта) окна New Flex Library Project (Новый проект библиотеки Flex) введите beavercore, после чего нажмите кнопку Next (Далее).
В поле Main source folder (Основная папка исходных файлов) введите src и нажмите кнопку Finish (Готово).
Выбрав в проекте beavercore папку src, выберите команду меню File ► New ► Folder (Файл ► Создать ► Папка). В поле Folder name (Имя папки) введите значение сот. Повторите этот процесс, чтобы создать следующую структуру папок: src/сот/ beavercore/effects.
Выбрав в проекте beavercore папку effects, выберите команду меню File ► New ► ActionScript Class (Файл ► Создать ► Класс ActionScript).
В поле Name (Имя) окна New ActionScript Class (Новый класс ActionScript) введите TextAnimation, после чего нажмите кнопку Finish (Готово).
В файле TextAnimation. as введите следующий код:
package com.beavercore.effects {
public class TextAnimation {
public function TextAnimation ( ) {
tracer Imagi ne a text effect with great majesty."):
}
public function start ( ):vo1d { tracerEffect now starting.");
}
}
}
В приложении Flex Builder 2 отсутствует возможность компиляции SWF-файла непосредственно из проекта библиотеки Flex. Таким образом, мы должны скомпилировать файл beavercore. swf с помощью консольного компилятора mxmlc. Чтобы скомпилировать наши классы в SWF-файл, мы должны создать для него основной класс. В этот основной класс мы поместим ссылки на классы (и другие определения), которые хотим включить в библиотеку классов. Следующие шаги описывают данный процесс для операционной системы Microsoft Windows.
Компиляция SWF-файла с помощью компилятора mxmlc. Указав папку src в проекте beavercore, выберите команду меню File ► New ► ActionScript Class (Файл ► Создать ► Класс ActionScript).
В поле Name (Имя) окна New ActionScript Class (Новый класс ActionScript) введите Main, после чего нажмите кнопку Finish (Готово).
В файле Main. as введите следующий код. В классе Main перечисляются имена всех классов (и определений), которые будут включены в библиотеку классов.
package {
Import com.beavercore.effects.*;
Import flash.display.Sprite;
public class Main extends Sprite {
com.beavercore.effects.TextAnlmat1on;
}
}
Выбрав команду Пуск ► Все программы ► Стандартные ► Командная строка, откройте командную строку операционной системы Windows.
Используя командную строку, перейдите в директорию С: \Program Files\ Adobe\Flex Builder 2\Flex SDK\bin, выполнив следующую команду (стоит отметить, что местоположение компилятора зависит от версии и операционной системы; дополнительные сведения можно найти в документации корпорации Adobe):
cd C:\Program F1les\Adobe\Flex Builder 2\Flex SDK 2\b1n
В командной строке введите следующую команду, после чего нажмите клавишу Enter:
mxmlc nyibjtjipoeKTyXsrcXMaAn.as -output nyibj<jipoeKTy\bAn\bea\/erco^
В результате выполнения предыдущих шагов приложение Flex Builder 2 сгенерирует файл beavercore . swf и поместит его в папку /bin/. Файл содержит нашу библиотеку классов, и теперь он может быть загружен и использован любым приложением на этапе выполнения. Тем не менее любому приложению, загружающему файл beaver core .swf, должен также предоставляться SWC-файл, используемый при проверке типов на этапе компиляции. Чтобы создать его, мы выбираем папку проекта beavercore на палитре Navigator (Навигатор), а затем выбираем команду меню Project ► Build Project (Проект ► Скомпилировать проект). В результате приложение Flex Builder 2 сгенерирует файл beavercore . s wc и поместит его в папку /bin/.
Использование библиотеки классов в формате SWF в приложении Flex Builder 2
Теперь, когда мы создали библиотеку классов в формате SWF (beavercore .swf), посмотрим, как использовать эту библиотеку в проекте.
Предположим, что мы используем приложение Flex Builder 2 для создания сайта компании Mega Bridal Depot (упомянутого ранее в этой главе) и хотим воспользоваться классом TextAnimation из библиотеки классов beavercore. swf. Сначала мы создаем проект ActionScript для сайта Mega Bridal Depot и включаем файл beavercore. swe в пути внешних библиотек. Затем на этапе выполнения мы загружаем библиотеку классов beavercore.swf.
Следующие шаги описывают процесс, который позволит создать проект ActionScript для сайта компании Mega Bridal Depot и включить файл beavercore. swe в пути внешних библиотек.
В приложении Flex Builder выберите команду меню File ► New ► ActionScript Project (Файл ► Создать ► Проект ActionScript).
В поле Project name (Название проекта) окна New ActionScript Project (Новый проект ActionScript) введите beaver_megabridaldepot, после чего нажмите кнопку Next (Далее).
В поле Main source folder (Основная папка исходных файлов) введите sr с.
В поле Main application file (Основной файл приложения) введите название файла MegaBridalDepot.
На вкладке Library path (Пути библиотек) нажмите кнопку Add SWC (Добавить SWC).
Найдите и выберите файл beaver core. s wc из предыдущего раздела, после чего нажмите кнопку Finish (Готово).
В списке Build path libraries (Пути библиотек для компиляции) выделите элемент Link Type: Merged into code (Тип связи: встроить в код), а затем нажмите кнопку Edit (Редактировать).
В списке Link Туре (Тип связи) окна Library Path Item Options (Свойства элемента пути библиотек) выберите значение External (Внешняя) и нажмите кнопку ОК.
В окне New ActionScript Project (Новый проект ActionScript) нажмите кнопку Finish (Готово).
В результате выполнения предыдущих шагов файл beavercore. swc будет добавлен в пути внешних библиотек проекта Mega Bridal Depot. По существу, классы и определения из файла beavercore. swc будут доступны для проверки типов на этапе компиляции, но не будут скомпилированы в приложение MegaBridal Depot. s wf. Вместо этого мы должны загружать эти классы на этапе выполнения.
Чтобы загрузить библиотеку классов beaver core . s wf на этапе выполнения, мы используем метод экземпляра load ( ) класса Loader, рассмотренный в гл. 28. При загрузке файла beavercore. swf мы импортируем его в домен приложения MegaBridalDepot. swf, что позволяет обращаться к классам из файла beavercore. swf напрямую, будто они являются частью приложения. Стоит отметить, что обращаться к классам библиотеки beavercore.swfB приложении MegaBridalDepot. swf мы должны только после завершения операции загрузки (то есть после того, как возникнет событие Event. INIT для операции загрузки файла beavercore. swf).
Следующий код демонстрирует класс MegaBridalDepot, который загружает библиотеку классов beaver core. swf на этапе выполнения. Предполагается, что файл beavercore .swf был скопирован в ту же папку, где находится приложение MegaBridalDepot. swf.
package {
import flash.display.*:
import flash.net.*;
import fl ash.system.*; import fl ash.events.*;
import com.beavercore.effects.TextAnimation;
public class MegaBridalDepot extends Sprite {
public function MegaBridalDepot ( ) { var libLoader:Loader = new Loader( );
1ibLoader.contentLoaderInfo.addEventLi stener(
Event.INIT. initListener);
libLoader.load(
new URLRequest("beavercore.swf"),
new LoaderContext(false. ApplicationDomain.currentDomain));
private function initListener (e:Event);void {
var textAni:TextAnimation = new TextAnimation( );
textAni.start( );
}
}
}
Стоит отметить, что при использовании описанной операции libLoader. load ( ) необходимо проявлять осторожность, чтобы не загрузить классы библиотеки beavercore . swf в собственный домен приложения beavercore . swf, как показано в следующем коде:
// НЕПРАВИЛЬНО! Этот код загружает классы библиотеки beavercore.swf
// в собственный домен приложения beavercore.swf, в качестве ребенка домена
// приложения системы. В результате к классам библиотеки beavercore.swf // нельзя обращаться непосредственно из приложения MegaBridal Depot.swf.
11bLoader.1oad(new URLRequest("beavercore.swf"));
Следующий код подобным образом по ошибке загружает классы библиотеки beavercore. swf в собственный домен приложения, но на этот раз в качестве ребенка домена приложения MegaBridalDepot. swf:
// НЕПРАВИЛЬНО! Классы загружаются в собственный домен приложения
// beavercore.swf. На этот раз, хотя домен приложения beavercore.swf
// и является ребенком родительского домена приложения MegaBridalDepot.swf,
// код в приложении MegaBridal Depot.swf все равно не может обращаться
// к классам в домене приложения beavercore.swf напрямую. Тот факт, что
// домен приложения MegaBridalDepot.swf является родителем для домена
// приложения beavercore.swf, просто указывает на использование приложением
// beavercore.swf версии любых классов приложения MegaBridalDepot.swf, // которые определены в обоих файлах.
11bLoader.1oadtnew URLRequest("beavercore.swf"),
new LoaderContexttfalse,
new Appl1cat1onDomaln(Appl1 cat1onDomaln.currentDomaln))):
Дополнительную информацию по доменам приложений можно найти в разделе Programming ActionScript 3.0 ► Flash Player APIs ► Client System Environment ► Application Domain class документации корпорации Adobe.
Теперь, когда мы узнали, как создать и распространить библиотеку классов в виде SWF-файла в приложении Flex Builder 2, рассмотрим, как проделать то же самое в среде разработки Flash.
Создание библиотеки классов в формате SWF
в среде разработки Hash
К счастью, процесс создания библиотеки классов в формате SWF в среде разработки Flash идентичен процессу создания библиотеки классов в формате SWC, который был рассмотрен ранее, в подразд. «Создание библиотеки классов в формате SWC в среде разработки Flash» предыдущего раздела. На самом деле в результате публикации SWC-файла создается SWC-файл, содержащий библиотеку классов, и SWF-файл, содержащий библиотеку классов. SWF-файл помещается в ту же папку, что и SWC-файл.
Например, при публикации нашей предыдущей библиотеки классов beavercore в виде SWC-файла среда разработки Flash также автоматически создала файл beavercore. swf. Как и SWC-файл, файл beavercore. swf был помещен в папку beavercore. Следующий раздел описывает, как в приложении использовать библиотеку классов beavercore.swf.
Использование библиотеки классов в формате SWF в приложении Hash CS3
Следующие шаги описывают процесс, который позволит использовать класс TextAnimation из библиотеки классов beavercore. swf на сайте компании Mega Bridal Depot.
Создайте новую папку с именем megabridaldepot в файловой системе. Папка будет содержать исходные файлы для сайта.
В папке megabridaldepot создайте новый текстовый файл MegaBridalDepot. as.
В файле введите следующий код (дополнительные сведения о методиках загрузки, применяемых в следующем коде, можно найти в подразд. «Использование библиотеки классов в формате SWF в приложении Flex Builder 2»):
package {
import fl ash.display.*:
import flash.net.*;
import fl ash.system.*;
import fl ash.events.*;
import com.beavercore.effects.TextAnimation;
/
public class MegaBridalDepot extends Sprite {
public function MegaBridalDepot ( ) { var libLoader:Loader = new Loader( ); 1ibLoader.contentLoaderlnfo.addEventListener(
Event.INIT, initListener); libLoader.load(
new URLRequest("beavercore.swf"),
new LoaderContextCfalse, ApplicationDomain.currentDomain));
}
private function initListener (e:Event):void { var textAni:TextAnimation = new TextAnimation( ); textAni.start( ):
В среде разработки Flash создайте новый FLA-файл и сохраните его в папке megabridaldepot под именем megabridaldepot .fla.
В поле Document class (Класс документа) палитры Properties (Свойства) (команда меню Window ► Properties (Окно ► Свойства)) введите MegaBridalDepot.
Скопируйте файл be aver core. swc в папку megabridaldepot.
Теперь скопируйте файл beavercore. swf в папку megabridaldepot.
Выберите команду меню Control ► Test Movie (Управление ► Проверка фильма).
На шаге 6 описанной процедуры файл beavercore. swc включается в путь к классам проекта megabridaldepot .fla, обеспечивая доступность классов и определений из библиотеки beavercore . swc для проверки типов на этапе компиляции. Стоит отметить, однако, что классы и опрёделения из SWC-файла применяются только для проверки типов и не включаются в экспортируемый файл megabridaldepot. swf. Чтобы включить определения из SWC-файла в экспортируемый SWF-файл, добавьте SWC-файл в библиотеку исходного FLA- файла, как было описано ранее, в подразд. «Использование библиотеки классов в формате SWC в среде разработки Flash» предыдущего раздела.
Й
Включение SWC-файла в путь к классам FLA-файла обеспечивает доступность определений из этого SWC-файла для проверки типов на этапе компиляции, но не добавляет эти определения в SWF-файл, экспортируемый из данного FLA-файла. Результат эквивалентен включению SWC-файла в пути внешних библиотек при компиляции проекта с помощью приложения Flex Builder 2 или компилятора mxmlc. Разработчики на языке ActionScript 2.0 должны отметить, что в файле _exclude.xml больше нет необходимости; механизм использования файла _exclude.xml в приложении Flash CS3 не поддерживается.
В результате выполнения предыдущих шагов компилятор сгенерирует SWF-файл MegaBridalDepot. swf и выполнит его в режиме Test Movie (Проверка фильма). Файл не включает класс Text Animat ion. Вместо этого данный класс загружается на этапе выполнения. Как только класс будет загружен, в окне Output (Вывод) появятся следующие сообщения:
Imagine a text effect with great majesty.
Effect now starting.
На этом наша благородная миссия по распространению кода завершена. И, между прочим, подошла к концу и книга...
Неужели на этом все закончится?
На протяжении 31 главы мы рассмотрели множество различных инструментов и методик программирования, и теперь настал ваш черед экспериментировать с ними. Возьмите то, что было изучено, и реализуйте свои собственные идеи и проекты. Не жалейте, если вы потратили большую часть своего времени на изучение языка ActionScript, и не думайте, что эти знания не пригодятся вам в будущем. Большинство концепций, представленных в этой книге, можно найти во многих других языках. Приобретенные знания по ActionScript помогут вам в таких языках, как, например, Java, C++, Perl и Visual Basic.
Программирование — это вид искусства. По существу, оно включает в себя все крушения надежд и энтузиазм, присущие скульптуре, прозе, рисованию или музыке. И оно подчиняется основному закону творчества: нет предела совершенству. Каждый день занимаясь программированием, вы создаете что-то новое и продол-
Неужели на этом все закончится?
жаете обучаться. Этот процесс никогда не прекращается. Хотя эта книга подошла к концу, ваше путешествие в мир программирования будет продолжаться до тех пор, пока вы разрабатываете код.
Если попутно вы увидите или сделаете что-то интересное, отправьте мне сообщение на адрес colin@moock.org.
Благодарю вас за то, что вы разделили со мной часть вашего путешествия в мир программирования. В добрый путь!
Окончательная версия программы «Зоопарк»
В этом приложении представлена окончательная версия кода программы Зоопарк», которая рассматривалась в части I. Для добавления графики и интерактивности в программу применяются методики, рассмотренные в части II.
Код для программы «Зоопарк» можно загрузить по адресу http://www.moock.org/eas3/ examples.
Обратите внимание, что код в этой версии виртуального зоопарка подвергся структурным изменениям, отражающим реальные шаблоны проектирования. В частности, добавлены два новых класса: FoodButton, представляющий простую интерактивную кнопку-текст, и VirtualPetView, обеспечивающий графическое представление экземпляров класса VirtualPet.
Класс VirtualZoo претерпел следующие значительные изменения:
теперь он создает экземпляр класса VirtualPetView, используемый для отображения животного на экране;
он ожидает, пока экземпляр класса VirtualPetView загрузит необходимые изображения, прежде чем приступить к имитации животного.
Класс VirtualPet претерпел следующие значительные изменения:
константы VirtualPet. PETSTATE_FULL, VirtualPet. PETSTATE_HUNGRY, VirtualPet.PETSTATE_STARVING и VirtualPet.PETSTATE_DEAD представляют физическое состояние животного;
переменная экземпляра petstate хранит текущее физическое состояние животного;
приемники событий уведомляются об изменениях в физическом состоянии животного посредством события VirtualPet. STATE CHANGE;
приемники событий уведомляются об изменениях в имени животного посредством события VirtualPet.NAME_CHANGE;
чтобы изменить количество калорий в желудке животного, класс VirtualPet использует метод setCalor ies ( ); при необходимости метод setCalories ( ) изменяет состояние животного с помощью метода setPetState ( );
физическое состояние животного изменяется методом setPetState ( ), который генерирует соответствующее событие VirtualPet. STATE CHANGE;
для вызова метода digest ( ) класс VirtualPet использует объект Timer вместо метода set Interval ( );
жизненный цикл (переваривание пищи) каждого объекта VirtualPet может начинаться и завершаться с помощью методов start ( ) и stop ( );
метод digest ( ) больше не определяет, умрет ли животное, если оно не будет принимать пищу; он делегирует эту ответственность методу setCalories( );
□ формальный метод die ( ) деактивирует объекты VirtualPet.
Внимательно изучите следующие листинги с комментариями. Затем в качестве упражнения попробуйте добавить в зоопарк второе животное.
В листинге ПЛ представлен код для класса VirtualZoo, который является основным классом программы.
Листинг П.1. Класс VirtualZoo
package {
import flash.display.Sprite:
import zoo.*:
import flash.events.*:
// Класс VirtualZoo является основным классом приложения. Он расширяет
// класс Sprite, благодаря чему его экземпляр может быть создан и добавлен
// в список отображения на этапе запуска программы.
public class VirtualZoo extends Sprite {
// Экземпляр класс VirtualPet
private var pet-.Virtual Pet:
// Объект, который будет отображать животное на экране
private var petView:VirtualPetView:
// Конструктор
public function VirtualZoo ( ) {
// Создаем новое животное и пытаемся присвоить ему имя
try {
pet = new Virtual Pet("Bartholomew McGillicuddy"):.
} catch (e:Error) {
// Если попытка создать объект VirtualPet вызывает исключение,
// данный объект не может быть создан. Таким образом, в этом месте
// кода мы сообщаем о проблеме и создаем новый объект с заведомо
// допустимым именем.
traceCAn error occurred: " + е.message):
pet = new VirtualPet("Stan"):
}
// Создаем объект, который будет отображать животное на экране petView = new VirtualPetView(pet):
// Регистрируем данный объект VirtualZoo для получения уведомления
// о завершении процесса инициализации
// отображаемого объекта ("petView")
petView.addEventListener(Event.COMPLETE, petViewCompleteLi stener):
}
// Обработчик события вызывается после завершения процесса
// инициализации объекта VirtualPetView (petView)
public function petViewCompletetistener (e:Event):void {
// Добавляем представление в список отображения addChild(petView);
// Начинаем жизненный цикл животного pet.start( ):
// Кормим животное pet.eat(new Sushi( ));
}
}
}
В листинге П.2 продемонстрирован код для класса Virtual Pet, экземпляры которого представляют животных в зоопарке.
Листинг П.2. Класс VirtualPet
package zoo {
import flash.utils.*;
import fl ash.events.*;
// Класс VirtualPet представляет животное в зоопарке. Он расширяет класс
// EventDispatcher. благодаря чему может являться получателем
// события в процессе диспетчеризации.
public class VirtualPet extends EventDispatcher {
// ==СТАТИЧЕСКИЕ КОНСТАНТЫ==
// Типы событий, относящиеся к классу VirtualPet (обрабатываемые
// объектом VirtualPetView, который отображает животное на экране)
public static const NAME_CHANGE:String = "NAME_CHANGE";
public static const STATE_CHANGE:String = "STATE_CHANGE";
// Состояния, представляющие текущее физическое состояние животного
publicstaticconstPETSTATE_FULL:int=0;
publicstaticconstPETSTATE_HUNGRY:int=1;
publicstaticconstPETSTATE_STARVING:int=2;
publicstaticconstPETSTATE_DEAD:int=3;
// ==СТАТИЧЕСКИЕ ПЕРЕМЕННЫЕ==
// Максимальная длина имени животного
private static var maxNameLength:int = 20;
// Максимальное количество калорий, которое может иметь животное private static var maxCalories:int = 2000;
// Скорость, с которой животное переваривает пищу
private static var caloriesPerSecond:int = 100;
// Имя для животного, используемое по умолчанию private static var defaultName:String = "Unnamed Pet";
// ==ПЕРЕМЕННЫЕ ЭКЗЕМПЛЯРА ==
// Имя животного
private var petName:String;
// Текущее количество калорий в «желудке» животного.
private var currentCalor1es:1 nt:
// Текущее физическое состояние животного
private var petstate:int;
// Таймер для вызова метода d1gest( ) на регулярной основе private var digestTimer:Timer;
// Конструктор
public function VlrtualPet (name:String):void {
// Присваиваем имя этому животному
setName(name):
// Даем этому животному половину от максимально возможного количества
// калорий (полупустой «желудок»).
setCalorles(Virtual Pet.maxCalories/2);
// Начинает жизненный цикл животного
public function start ( ):void {
// Вызываем метод digestT1merL1stener( ) один раз в секунду dlgestTimer = new TimerQOOO, 0);
dlgestTimer.addEventL1stener(TimerEvent.TIMER, digestTimertistener);
dlgestTimer.start( );
// Останавливает жизненный цикл животного public function stop ( ):void {
if (dlgestTimer != null) { dlgestTimer.stop( );
}
// Присваивает имя животному и уведомляет приемники об изменении public function setName (newName-.String):void {
// Генерируем исключение, если новое имя не является допустимым
if (newName.indexOfC ") == 0) {
throw new V1rtualPetNameException( );
} else if (newName == "") {
throw new V1rtualPetInsuff1cientDataException( );
} else if (newName.length > VlrtualPet.maxNameLength) { throw new VirtualPetExcessDataExcept1on( );
}
// Присваиваем новое имя
petName = newName;
// Уведомляем приемники об изменении имени
dispatchEvent(new Event(VirtualPet.NAME_CHANGE)):
}"
// Возвращает имя животного
public function getName ( ):String {
// Если животному не было присвоено допустимое имя...
if (petName == null) {
// ...возвращаем имя, используемое по умолчанию return Virtual Pet.defaultName;
} else {
// ...в противном случае возвращаем имя животного return petName;
}
}
// Добавляет некоторое количество калорий в желудок животного,
// используя объект Food
public function eat (fooditem:Food):void {
// Если животное умерло, ничего не делаем
1f (petState == Virtual Pet.PETSTATE_DEAD) {
trace(getName( ) + " 1s dead. You can't feed it."); return;
}
// Если пищей является яблоко, проверяем его на наличие червей.
// Если яблоко червивое, не будем его есть.
if (fooditem 1s Apple) {
if (Apple(foodltem).hasWorm( )) {
traceCThe " + fooditem.getName( ) + " had a worm. " + getName( ) + " didn't eat it.");
return;
}
}
// Отображаем отладочное сообщение с информацией об употребленной пище trace(getName( ) + " ate the " + fooditem.getName( )
+ " (" + fooditem.getCalor1es( ) + " calories).");
// Добавляем калории из пищи в «желудок» животного setCalor1es(getCalor1es( ) + fooditem.getCalor1es( ));
// Присваивает животному новое количество калорий и при необходимости
// изменяет его состояние
private function setCalorles (newCurrentCalor1es:int):vo1d {
// При необходимости корректирует значение newCurrentCalorles
// в соответствии с допустимым диапазоном
1f (newCurrentCalorles > VlrtualPet.maxCalorles) { currentCalorles = VlrtualPet.maxCalorles;
} else 1f (newCurrentCalorles < 0) { currentCalorles = 0;
} else { currentCalorles = newCurrentCalorles;
}
// Определяем количество калорий в желудке животного, в процентах
// от максимально допустимого количества калорий
var calor1ePercentage:1 nt = Math.floor(getHunger( )*100);
// Отображаем отладочное сообщение, информирующее о текущем количестве // калорий у животного
trace(getName( ) + " has " + currentcalories + " calories"
+ " (" + caloriePercentage + '1 of Its food) remaining."):
// При необходимости устанавливаем состояние животного в зависимости
// от изменения в количестве калорий
1f (calor1 ePercentage == 0) {
// У животного не осталось пищи. Поэтому, если оно еще не умерло...
1f (getPetState( ) != Virtual Pet.PETSTATE_DEAD) {
// ...деактивируем его
d1e( );
}
} else if (cal on ePercentage < 20) {
// Животному срочно требуется пища. Устанавливаем его состояние
// в «ужасно голодный».
1f (getPetState( ) != V1rtualPet.PETSTATE_STARVING) {
setPetState(V1rtualPet.PETSTATE_STARVING);
}"
} else 1f (calorlePercentage < 50) {
// Животному требуется пища. Устанавливаем его состояние .
// в «голодный».
1f (getPetState( ) != Virtual Pet.PETSTATE_HUNGRY) {
setPetState(V1rtualPet.PETSTATE_HUNGRY);
}"
} else {
// Животному не требуется пища. Устанавливаем его состояние
// в «сытый».
1f (getPetState( ) != Virtual Pet.PETSTATE_FULL) { setPetState(V1rtualPet.PETSTATE_FULL);
}""
}
// Возвращает количество калорий в «желудке» животного public function getCalorles ( ):1nt {
return currentcalories;
// Возвращает количество с плавающей запятой, описывающее количество
// пищи, оставшееся в «желудке» животного, в процентах
public function getHunger ( ):Number {
return currentCalorles / Virtual Pet.maxCalories;
// Деактивирует животное
private function die ( ):vo1d {
// Останавливаем жизненный цикл животного stop( );
// Переводим животное в состояние «мертвый»
setPetState(V1rtualPet.PETSTATE_DEAD);
// Отображаем отладочное сообщение, информирующее о смерти животного
■ trace(getName( ) + " has died.");
}
// Уменьшает количество калорий животного в соответствии со скоростью
// переваривания пищи этого животного. Этот метод вызывается
// автоматически объектом digestTimer.
private function digest ( ):void {
trace(getName( ) + " is digesting...");
setCalories(getCalories( ) - VirtualPet.caloriesPerSecond);
}
// Присваивает целое число, представляющее текущее
// физическое состояние животного
private function setPetState (newState:int):void {
// Если состояние животного не изменилось, выходим из метода
if (newState == petstate) { return;
}
// Присваиваем новое состояние petState = newState;
// Умедомляем приемники об изменении состояния животного
dispatchEvent(new Event(VirtualPet.STATE_CHANGE));
}"
// Возвращает целое число, представляющее текущее
// физическое состояние животного
public function getPetState ( ):int { return petState;
}
// Приемник события для объекта Timer, который управляет
// процессом переваривания пищи
private function digestTimerListener (e;TimerEvent);void {
// Перевариваем часть пищи digest( );
}
}
}
В листинге П.З представлен код для класса Food, который является суперклассом для различных видов пищи, поедаемой животным.
Листинг П.З. Класс Food
package zoo {
// Класс Food является суперклассом для различных видов пищи, // поедаемой животными.
public class Food {
// Хранит количество калорий, которым обладает данный кусок пищи private var calories;int;
// Удобочитаемое название данного куска пищи private var name .-String;
// Конструктор
public function Food (init1al Calories:int) {
// Сохраняем указанное первоначальное количество калорий setCalories (i ni ti al Cal ori es);
}
// Возвращает количество калорий, которым обладает данный кусок пищи
public function getCalories ( ):1 nt {
return calories;
}
// Присваивает количество калорий, которым обладает данный кусок пищи
public function setCalories (newCalories;int);void { calories = newCalories;
}.
// Возвращает удобочитаемое название данного куска пищи
public function getName ( );String { return name;
}
// Присваивает удобочитаемое название данному куску пищи
public function setName (newName:String):void {
name = newName;
}
}
}
В листинге П.4 продемонстрирован код для класса Apple, который представляет конкретный вид пищи, принимаемой животным.
Листинг П.4. Класс Apple
package zoo {
// Класс Apple представляет один из видов пищи,
// принимаемой животным
public class Apple extends Food {
// Количество калорий в объекте Apple, если не указано другое
private static var DEFAULT_CALORIES:1 nt = 100;
// Хранит информацию о том, является ли
// данный объект Apple червивым
private var wormlnApple:Boolean;
// Конструктор
public function Apple (initial Calories:!nt = 0) {
// Если не было указано допустимое количество калорий...
if (initialCalories <= 0) {
//...присваиваем данному объекту Apple количество калорий
//по умолчанию
initialCalories = Apple.DEFAULT_CALORIES;
}"
// Вызываем конструктор класса Food
super(i n!t!al Cal or!es);
// Случайным образом определяем, будет ли данный объект Apple червивым
// (50 % вероятность)
wormlnApple = Math.random( ) >= .5;
// Присваиваем название этому куску пищи setName("Apple");
}
// Возвращает значение типа Boolean, которое сообщает о том, является ли
// данный объект Apple червивым
public function hasWorm ( ):Boolean {
return wormlnApple;
}
}
}
Наконец, в листинге П.5 продемонстрирован код для класса Sushi, который представляет конкретный вид пищи, принимаемой животным.
Листинг П.5. Класс Sushi
package zoo {
// Класс Sushi представляет один из видов пищи, принимаемой животным
public class Sushi extends Food {
// Количество калорий в объекте Sushi", если не указано другое
private static var DEFAULT_CALORIES;1nt = 500;
// Конструктор
public function Sushi (1n1t1alCalor1es:1nt = 0) {
// Если ye было указано допустимое количество калорий...
1f (1n1t1alCalor1es <= 0) {
//...присваиваем данному объекту Sushi количество калорий по умолчанию 1n1t1alCalor1es = Sushi' .DEFAULT_CALORIES;
}"
// Вызываем конструктор класса Food
super(1n111al Calor1es);
// Присваиваем название этому куску пищи setNameCSushl");
}
}
}
В листинге П.6 продемонстрирован код для класса VirtualPetNameException, который представляет исключение, генерируемое в тех случаях, когда указывается недопустимое имя животного.
Листинг П.6. Класс VirtualPetNameException
package zoo {
// Класс VirtualPetNameException представляет исключение, генерируемое
// в том случае, когда для животного указывается недопустимое имя
public class VirtualPetNameException extends Error {
// Конструктор
public function VirtualPetNameException (
message:String = "Invalid pet name specified.") {
// Вызываем конструктор класса Error
super(message):
}
}
}
В листинге П.7 показан код для класса VirtualPetExcessDataException, который представляет исключение, генерируемое в тех случаях, когда указывается слишком длинное имя животного.
Листинг П.7. Класс Virtual PetExcessDataException
package zoo {
// Класс VirtualPetExcessDataException представляет исключение.
// генерируемое в том случае, когда для животного указывается слишком
// длинное имя
public class VirtualPetExcessDataException
extends VirtualPetNameException {
// Конструктор
public function VirtualPetExcessDataException ( ) {
// Вызываем конструктор класса VirtualPetNameException
superCPet name too long."):
}
}
}
В листинге П.8 показан код для класса VirtualPetlnsufficientDataException, который представляет исключение, генерируемое в тех случаях, когда указывается слишком короткое имя животного.
Листинг П.8. Класс VirtualPetlnsufficientData Exception
package zoo {
// Класс Virtual PetInsufficientDataException представляет исключение.
// генерируемое в том случае, когда для животного указывается слишком
// короткое имя
public class VirtualPetlnsufficientDataException
extends VirtualPetNameException {
// Конструктор
public function Virtual PetInsufficientDataException ( ) {
// Вызываем конструктор класса VirtualPetNameException
superCPet name too short."):
}
}
}
В листинге П.9 продемонстрирован код для класса Virtual Petview, обеспечивающего графическое представление экземпляра класса VirtualPet.
Листинг П.9. Класс VirtualPetView
package zoo {
import fl ash.di splay.*:
import fl ash.events.*:
import flash.net.*:
Import flash.text.*:
// Класс VirtualPetView обеспечивает графическое представление экземпляра // класса Virtual Pet. Изображения для животного загружаются на этапе // выполнения.
public class VirtualPetView extends Sprite {
// Отображаемое животное
private var pet:Virtual Pet:
// Контейнер для изображений животного
private var graph1csConta1ner:Spr1te:
// Изображения и текст животного
private var petAlive:Loader:
//
Животное в
состоянии «живой»
private var petDead:Loader:
//
Животное в
состоянии «мертвый»
private var foodHungry:Loader:
//
Значок для
состояния «голодный»
private var foodstarving:Loader:
//
Значок для
состояния «ужасно
//
голодный»
private var petName:TextF1eld;
//
Отображает
имя животного
// Пользовательский интерфейс животного
private var appleBtn:FoodButton: // Кнопка для кормления животного // яблоком
private var sushiBtn:FoodButton: // Кнопка для кормления животного суши
// Определение момента завершения загрузки
static private var numGraph1csToLoad:1nt = 4: // Общее количество
// изображений
private var numGraph1csLoaded:1nt = 0: // Количество изображений, // загруженных на настоящий // момент
// Конструктор
public function VirtualPetView (pet-.VirtualPet) {
// Сохраняем ссылку на отображаемое животное
this.pet = pet:
// Регистрируем приемник для получения уведомлений об изменениях
// в имени животного
pet.addEventLIstener(V1rtualPet.NAME_CHANGE, petNameChangeListener):
// Регистрируем приемник для получения уведомлений об изменениях
// в состоянии животного
pet.addEventLIstener(VIrtualPet.STATE_CHANGE, petStateChangeLIstener):
// Создаем и загружаем‘изображения животного
createGraphlcsContalпег( );
createNameTag( ):
createUIC ):
loadGraph1cs( ):
// Создает контейнер, в который будут помещены изображения животного private function createGraphicsContainer ( );void {
graphlcsContalner = new Spr1te( );
addChi1d(g raph1csContalner);
// Создает объект TextFleld, в котором будет отображаться имя животного private function createNameTag ( ):vo1d {
petName = new TextF1eld( );
petName.defaultTextFormat = new TextFormat("_sans",14,0x006666,true);
petName.autoSize = TextFieldAutoSIze.CENTER;
petName.selectable = false;
petName.x = 250;
petName.у = 20;
addChiId(petName);
}
// Создает кнопки для пользователя, предназначенные
// для кормления животного
private function createUI ( );void {
// Кнопка Feed Apple (Дать яблоко)
appleBtn = new FoodButtonCFeed Apple");.
appleBtn.y = 170;
appleBtn.addEventLIstener(MouseEvent.CLICK, appleBtnCl1 ck);
addChi1d(appleBtn);
// Кнопка Feed Sushi (Дать суши)
sushiBtn = new FoodButtonCFeed Sushi'");
sushiBtn.у = 190;
sushiBtn.addEventLIstener(MouseEvent.CLICK, sushiBtnCl1ck);
addChi1d(sush1Btn);
// Блокирует пользовательский интерфейс private function disableUI ( ):vo1d {
appleBtn.d1sable( );
sushiBtn.d1sable( );
// Загружает и размещает на экране внешние изображения для животного private function loadGraphlcs ( );void {
// Изображение, представляющее животное в состоянии «живой»
petAUve = new Loader( );
petAl 1ve.1oad(new URLRequest("pet-al1ve.gif"));
petAl1ve.contentLoaderInfo.addEventLIstener(Event.COMPLETE, completeLIstener);
petAl1ve.contentLoaderInfo.addEventLIstener(lOErrorEvent.IO_ERROR, 1oErrprL1stener);
// Изображение, представляющее животное в состоянии «мертвый»
petDead = new Loader( );
petDead.1oad(new URLRequest("pet-dead.gif"));
petDead.contentLoaderInfo.addEventListener(Event.COMPLETE, completeListener);
petDead.contentLoaderInfo.addEventLIstener(lOErrorEvent.IO_ERROR, ioErrorListener);
// Значок «нужна пища»
foodHungry = new Loader( );
foodHungry.1oad(new URLRequest("food-hungry.gif"));
foodHungry.contentLoaderInfo.addEventLIstener(Event.COMPLETE, completeListener);
foodHungry.contentLoaderInfo.addEventLi stener(lOErrorEvent.IO_ERROR, ioErrorListener);
foodHungry.x = 15;
foodHungry.у = 100;
// Значок «очень нужна пища»
foodstarving = new Loader( );
foodStarving.1oad(new URLRequest("food-starving.gif"));
foodStarving.contentLoaderInfo.addEventListener(Event.COMPLETE, completeListener);
foodStarving.contentLoaderInfo.addEventListener(lOErrorEvent.IO_ERROR, ioErrorListener);
foodstarving.x = 15;
foodStarving.у = 100;
// Вызывается при изменении состояния животного
private function petStateChangeListener (ezEvent):void {
// Если животное умерло...
if (pet.getPetState( ) == Virtual Pet.PETSTATE_DEAD) {
// ...блокируем кнопки для кормления disableUK ):
}
// Обновляем графику, чтобы отразить новое состояние животного renderCurrentPetState( );
// Получает текущее состояние животного и отображает его на экране private function renderCurrentPetState ( );void {
// Удаляем все изображения
for (var i:int = graphicsContainer.numChildren-1; i >= 0; i--) { graphi csContai ner.removeChi1dAt(i);
}
// Получаем текущее состояние животного
var state;!nt = pet.getPetState( );
// Отображаем подходящее изображение
switch (state) {
case Virtual Pet.PETSTATE_FULL:
graphlcsContа1 пег.addChi1d(petAl1ve): break;
case Virtual Pet.PETSTATE_HUNGRY;
graphlcsContalner.addChi1d(petAl1 ve);
graphlcsContalner.addChi1d(foodHungry);
break;
case V1rtualPet.PETSTATE_STARVING;
graphl csContalner.addChi1d(petAl1 ve);
graphlcsContalner.addChi1d(foodStarvIng);
break;
case Virtual Pet.PETSTATE_DEAD:
graphlcsContalner.addChi1d(petDead);
break;
}
}
// Вызывается при изменениях в имени животного
private function petNameChangeLlstener (e:Event):vo1d { // Обновляем имя животного на экране renderCurrentPetName( );
// Получает текущее имя животного и отображает его на экране private function renderCurrentPetName ( ):void { petName.text = pet.getName( );
// Вызывается при нажатии кнопки «Feed Apple» private function appleBtnClick (e;MouseEvent):void {
// Кормим животное яблоком
pet.eat(new Apple( ));
// Вызывается при нажатии кнопки «Feed Sushi» private function sushiBtnCl1ck (e;MouseEvent);vo1d {
// Кормим животное суши
pet.eat(new Sushi( ));
// Вызывается при завершении процесса загрузки изображений
private function completedstener (e:Event);vo1d {
// Увеличиваем (на единицу) общее количество загруженных изображений numGraphlcstoaded++;
// Если все изображения загружены...
1f (numGraphlcstoaded == numGraphlcsTotoad) {
// ...отображаем подходящее изображение, а затем рассылаем событие
// Event.COMPLETE, которое обозначает, что данный объект
// VirtualPetVIew готов к использованию
renderCurrentPetState( );
renderCurrentPetNameC );
dispatchEvent(new Еvent(Event.COMPLETE));
}
}
// Вызывается при невозможности загрузки изображения
private function 1oErrorLIstener (е:lOErrorEvent):void {
// Отображаем отладочное сообщение, описывающее суть проблемы загрузки traceC'Load error: " + е);
}
}
}
В листинге П.10 продемонстрирован код для класса FoodButton, который представляет простую интерактивную кнопку-текст.
Листинг П.1О. Класс FoodButton
package zoo {
Import flash.display.*
Import flash.events.*;
Import fl ash.text.*;
// Класс FoodButton представляет простую интерактивную кнопку-текст
public class FoodButton extends Sprite {
// Отображаемый текст кнопки
private var text:TextF1eld;
// Форматирование текста, когда указатель мыши находится не над
// кнопкой
private var upFormat:TextFormat;
// Форматирование текста, когда указатель мыши находится над кнопкой private var overFormat:TextFormat;
// Конструктор
public function FoodButton (label:Str1ng) {
// Активизирует указатель мыши «рука» для операций с этим объектом
// (переменная buttonMode наследуется от класса Sprite).
buttonMode = true;
// Отключаем события мыши для детей данного объекта
// (переменная mouseChlldren наследуется от класса
// D1splayObjectConta1ner.) mouseChlldren = false;
// Определяем форматирование текста для ситуации, когда указатель мыши
// находится не над данным объектом
upFormat = new TextFormat("_sans".12,0x006666,true);
// Определяем форматирование текста для ситуации, когда указатель мыши
// находится над данным объектом
overFormat = new TextFormat("_sans",12,0x009999,true);
// Создаем текстовое поле-кнопку и добавляем его в иерархию
// отображения данного объекта
text = new TextF1eld( );
text.defaultTextFormat = upFormat;
text.text = label;
text.autoSize = TextFI eldAutoSize.CENTER;
text.selectable = false:
addChlld(text):
// Регистрируем приемник для получения уведомлений о перемещении
// указателя мыши над данным объектом
addEventLIstener(MouseEvent.MOUSE_OVER, mouseOverListener);
// Регистрируем приемник для получения уведомлений о выходе указателя
// мыши за пределы данного объекта
addEventLIstener(MouseEvent.MOUSE-OUT, mouseOutListener);
}
// Отключает уведомления о событиях мыши для данного объекта
public function disable ( ):vo1d {
// (Переменная mouseEnabled наследуется от класса InteractlveObject.) mouseEnabled = false;
// Вызывается, когда указатель мыши перемещается над данным объектом public function mouseOverListener (e:MouseEvent):void {
// Применяем текстовый формат «под указателем мыши»
text.setTextFormat(overFormat);
// Вызывается, когда указатель мыши выходит за пределы данного объекта public function mouseOutListener (e-.MouseEvent) :vo1d {
// Применяем текстовый формат «не под указателем мыши»
text.setTextFormat(upFormat);
Алфавитный указатель
! (оператор логического НЕ) 98
! (противоположное логическое значение) 224
!= (оператор условия неравенства) 226
&& (логическое И) 97
&& (оператор логического И) 227
& (оператор побитового И) 226
&= (оператор побитового И
с присвоением) 228
( ) (оператор круглых скобок) 66, 223
(=) (оператор присвоения значения переменной) 227
.. (оператор «потомок» расширения Е4Х) 435
/* и*/ 47
// (двойной слэш) 47
? (условный оператор) 80
@* (символ атрибутов расширения Е4Х) 422
[ ] (квадратные скобки) 426
А (оператор побитового исключающего ИЛИ) 227
А= (побитовое исключающее ИЛИ с присвоением) 228
{} (фигурные скобки) 43, 45,48
в литералах ХМL 412
проблемы в интерфейсах 207
{х у} (объект с динамическими переменными) 223
| (оператор побитового ИЛИ) 227
|= (оператор побитового И
с присваиванием) 228
|| (логическое ИЛИ) 95
|| (оператор логического ИЛИ) 227
~ (оператор побитового НЕ) 224
+ (оператор конкатенации) 83
+= (оператор сложения
с присваиванием) 68, 227, 777
< (оператор «меньше чем») 82, 225
« (оператор сдвига влево) 225
«= (оператор сдвига влево) 228
<= (оператор «меньше чем
или равно») 225
= (знак равенства) 53
== (оператор равенства) 82
=== (оператор строгого равенства) 86
» (оператор сдвига вправо) 225
»= (оператор сдвига вправо) 228
»> (оператор
беззнакового сдвига вправо) 225
»>= (оператор
беззнакового сдвига вправо) 228
А
АВС (байт-код ActionScript) 38
ActionScript 19
развитие языка программирования 328
управление графическим содержимым в прошлой версии 519
addChildAt( ), метод 532
ADDEDTOSTAGE, событие 555
addedListener( ), метод 707
addedToStageListener( ), метод 673
addEventListener( ), метод 247, 249, 260, 269, 567
параметр use Capture 571
параметр
«использоватьСлабуюСсылку» 265
addObject( ), метод 211
addShape( ), метод 157
Adobe AIR в сравнении с Flash Player 767
Adobe Flash 19, 25
Adobe Flex 2 SDK 26
Adobe Flex Builder 26
allowDomain( ), метод 283,475, 504
allowInsecureDomain( ), метод 506
Anonymous Listener, класс 262
AntiAliasType, класс 769
API (Application Programming
Interface) 70
API отображения 519
базовые классы отображения 519
корневой объект 522
пользовательские классы
отображения 523
потомки и предки, объекты 522
расширение иерархии 523
вспомогательные классы
отображения 520
глубина отображаемого объекта 531
графическое содержимое 519
дети, удаление 538
контейнеры 522
обход объектов в иерархии отображения 541
пользовательские графические классы 561
события контейнеров 549
список отображения 523
удаление элементов из памяти 537
appendText( ), метод. 777
Application Programming Interface (API) 70
applyFilter( ), метод 758
as, оператор 193, 226
attackEnemy( ), метод 307
attribute( ), метод E4X 422
attribute( ), метод XML 413, 426
Automatically declare stage instances, флажок 921,922
autoSize, переменная 773
AVM (ActionScript virtual machine) 38
в
BasicShape, класс 706
подкласс Ellipse 710
подкласс Polygon 711
Bitmap, класс 519,521
BitmapData, класс 718
applyFilter( ), метод 757
clone( ), метод 743
colorTransform( ), метод 757
compare( ), метод 734
copyChannel( ), метод 743
copyPixels( ), метод 742
draw( ), метод 742
fillRect( ), метод 741
floodFill( ), метод 741
getColorBoundsRect( ), метод 734
getPixel32( ), метод 727
getPixel32( ), метод, в сравнении
c getPixel( ) 728
getPixels( ), метод 732
hitTest( ), метод 734
lock( ), метод 735
merge( ), метод 743
noise( ), метод 757
paletteMap( ), метод 758
perlinNoise( ), метод 757
pixelDissolve( ), метод 758
scroll( ), метод 741
setPixel( ), метод 724, 734
setPixel32( ), метод 724, 734
setPixel32( ), метод класса ScribbleAS3 736
setPixels( ), метод 724, 734, 739
threshold( ), метод 758
объекты, связь с объектом Bitmap 724
представление одного и того же объекта
Bitmap 724
создание объекта 723
Butterfly Game, класс 263
Button (Кнопка), символ 912
Byte Array, объект 733
с
copyPixels( ), метод 752
D
DataGrid, класс 395
Display Object, класс 520
подклассы 521
события Event.ADDED
и Event.REMOVED 555
draw( ), метод 743
ScribbleAS3, версия с неотображаемыми векторами 748
параметры 743
растеризация и растворение объекта TextField 746
Е
Е4Х (ECMAScript for XML) 407
выражения расширения и результаты 431
методы обращения классов XML
и XMLList 413
незначащие пробелы 408
оператор «потомок» (..) 435
преобразование в строки объектов XML и XMLList 460
равенства, определение 463
создание ХМL-данных 411
создание нового содержимого XML 442
добавление новых атрибутов и элементов 445
добавление новых детей 446
замена всего элемента 444
изменение значений атрибута 443
изменение содержимого элемента 442
ссылки на части документа, обновление 450
сущности XML для специальных символов 450
удаление элементов и атрибутов 449
типы данных XML и XMLList 409
фильтрация ХМL-данных 438
метод has Own Property ( ) 440
оператор фильтрующего предиката 438
eat( ), метод 67, 70
параметр numberOfCalories 72
подпись 77
F
FIFO-стек 238
6
Graphic (Графика), символ 912
н
hasChanged( ), метод 707
hitListener( ), метод 584
hitTest( ), метод 734
HTML-форматирование текста 791
взаимосвязь переменных text
nhtmlText 797
заключение в кавычки значений
атрибутов 796
нераспознанные теги и атрибуты 798
поддерживаемые сущности 796
теги и атрибуты, поддерживаемые
ActionScript 792
I
in, оператор 226
instanceof, оператор 226
is, оператор 226
J
JIT (динамическая компиляция) 39
I
LIFO-стек 238
Loader, класс 522, 836, 837
М
MorphShape, класс 521
Movie Clip (Клип), символ 912 композиционный подход 931 связанные классы 913
о
Object 144,181
класс 144
тип данных 181
р
push( ), метод 237
Q
QName, класс 465
R
REMOVED_FROM_STAGE,
событие 555
S
Shape, класс 521
рисование с помощью
векторов 698
SlidingText, класс 694
Socket, класс 873
Sprite, класс 519, 522
StaticText, класс 521,768
StyleSheet, класс 799
и
URLLoader, класс 453
URLRequest, класс 453
URLRequest, объект 838
V
Video, класс 521
VirtualPet, класс 45
атрибуты 46
добавление функции 138
код 168
конфликты имен переменных/ параметров 102
параметр конструктора паше 60
переменная экземпляра creationTime 74
переменная экземпляра
currentCalories 66
переменная экземпляра pet 65
переменная экземпляра petName 55
статические переменные 116
VirtualPet, объект
время создания 74
создание 50
«переменная экземпляра» pet 55
VirtualZoo, класс 42
код 168
полностью определенное имя класса 45
типы данных 198
void 181,224
оператор 224
тип данных 181
значение undefined 197
W
with, оператор 86, 352
X
XML 407
данные в виде иерархии 407
загрузка XML-данных 452
класс XML 407
класс XML, ActionScript
версий 1.0 и 2.0 409
класс XMLDocument 409
класс и тип данных XML 409
методы обращения 413
обращение к узлам-родителям 419
родитель ХМLList 410
класс и тип данных ХМLList 409
значения, присваивание объекту
XMLList 452
интерпретация объекта XMLList как экземпляра XML 427
методы обращения 413
класс и тип данных XMLList
(продолжение)
объект с единственным экземпляром класса ХМ L 415
преобразование объекта в строку 460
равенство объектов XMLList 465
корневой узел 407
обработка с помощью циклов for-each-in и for-in 432
обход деревьев XML 441
пространства имен XML 454
уточненные элементы и атрибуты, доступ 454
уточненные элементы и атрибуты, создание 458
равенство объектов Namespace 466
равенство объектов QName 465
равенство объектов XML 463
создание данных XML с помощью
расширения Е4Х 411
типы узлов 409
узлы-потомки, обращение 434
фрагмент XML 407
А
Абстрактные классы 520
отсутствие поддержки в ActionScript 162
Абстрактные методы 162
Автоматический порядок перехода 614
Автоматически объявлять экземпляры
сцены, флажок 921,922
Анимация 677
без циклов 677
вложенные анимации 911
класс Animator 691
класс Animator, подкласс
SlidingText 694
класс UI Component 695
основанная на скорости 695
событие ENTER_FRAME 678
влияние скорости 683
сравнение с классом Timer 690
событие TimerEvent.TIMER 684
влияние скорости 690
сравнение с событием Event.
ENTER_FRAME 690
Анимация, основанная на скорости 695
Асинхронное и синхронное выполнение программы 877
Атрибуты 45
Б
Базовый класс 143
Байт-код ActionScript (АВС) 38
Безопасность 467
домены безопасности 511
локальный тип безопасности песочницы, выбор 483
области действия 468
обработка нарушений 508
примеры сценариев 480
разрешения распространителя 488
разрешения создателя 504
сокеты 479
типы безопасности песочниц 469
локальный с поддержкой сети 469
локальный с поддержкой файловой системы 469
локальный с установленным доверием 469
удаленный 469
Библиотеки классов 941
контроль версий 942
распространение 941
в виде SWC-файлов 943
в виде SWF-файлов 948
совместное использование исходных кодов 941
Бинарные операторы 220
Блок finally 306
Блок пакета 43
Булева логика и операторы 94
Бурет, Рональд (Ronald Bouret) 454
Векторное рисование 698
библиотека объектно-ориентированных фигур 706
класс Graphics 698
кривые 702
линии 699
удаление содержимого 705
фигуры 703
Векторы 526
Веннер, Билл (Bill Venner) 161
Виртуальная машина ActionScript 38
Временные шкалы 901
основная шкала, отображение детей 917
создание сценариев 905
Всплывающие и невсплывающие
события 565
Вызов перекрытого метода
экземпляра 147
Выражение присваивания 64
д
Дерево наследования 143
Дети 522
Детская игра, использование пространства имен 378
Динамические возможности языка
ActionScript 328
динамические классы 329
динамические обращения к переменным и методам 335
динамические переменные
экземпляра 329
добавление нового поведения 333
обработка циклами for-each-in
nforyin 331
присваивание замыкания
функции 333
справочные таблицы, создание 336
объекты-прототипы для дополнения
классов 341
проблемы с динамическими
классами 330
функции, использование для создания
объектов 339
цепочка прототипов 342
Директива use namespace 387
Добавление 239
Допустимые и запрещенные сокетные соединения 479
ж
Жесткие переносы 773
3
Значения 53
и
Инициализатор переменной 53
Инструкции 217
Инструменты разработки на языке
ActionScript 25
Интерфейсы 203
аргумент в пользу 203
в качестве типов данных 182
и классы с несколькими типами
данных 205
методы, определение после компиляции 206
объявления методов 207
подинтерфейсы и суперинтерфейсы 209
синтаксис и использование 206
интерфейсы-маркеры 210
наследование 209
соглашения по именованию 208
составные типы 210
список методов 205
фигурные скобки, возможные
проблемы 207
к
Класс
AnonymousListener 262
AntiAliasType 769
Класс (продолжение)
BasicShape 706
подкласс Ellipse 710
подкласс Polygon 711
Bitmap 519,521
BitmapData 718
ButterflyGame 263
DataGrid 395
Display Object 520
подклассы 521
события Event.ADDED
и Event.REMOVED 555
Loader 522, 836, 837
MorphShape 521
Object 144
QName 465
Shape 521
Shape, рисование с помощью
векторов 698
SlidingText 694
Socket 873
Sprite 519, 522
StaticText 521,768
StyleSheet 799
URLLoader 453
URLRequest 453
Video 521
VirtualPet 45
атрибуты 46
добавление функции 138
код 168
конфликты имен переменных/
параметров 102
параметр конструктора name 60
переменная экземпляра creationTime 74
переменная экземпляра currentCalories 66
переменная экземпляра pet 65
переменная экземпляра petName 55
статические переменные 116
VirtualZoo 42
код 168
полностью определенное имя класса 45
типы данных 198
Класс документа 907
автоматически устанавливаемый 908
указание для FLA-файла 908
Классы 40
API класса 70
Object 144
абстрактного типа 520
атрибуты 45
базовые 143
библиотеки 941
блоки классов 45
динамические 329
игры «Зоопарк» 47
иерархия 143
имена 42
инициализатор 122,347
интерфейсы 70
интерфейсы и классы с несколькими типами данных 205
модификаторы управления
доступом 45
наследование 141
объекты-прототипы для дополнения
классов 341
объекты Class 123
ограничения в расширениях 205
описание 44
подклассы внутренних классов 154
проблемы с динамическими
классами 330
производные 143
собственные классы языка
ActionScript 41
требуемые для компиляции
программы 177
Клип 519
Ключевые слова 43
implements 205
override 145
Ключевые кадры 902
Код класса Apple 170
Компиляция
локальный SWF-файл с поддержкой сети 484
локальный SWF-файл с поддержкой файловой системы 483
программы 172
в приложении Flex Builder 38,173
в среде разработки Flash 172
выявление ошибок обращения 189
динамическая 38
игнорирование ошибок в строгом режиме 186
путь к классам 177
с помощью mxmlc 175
строгий режим в сравнении
со стандартным 177
Композиция 158
в сравнении с наследованием 158
делегирование 159
Константы 118
Контейнеры 522
и глубины 530
удаление объекта 536
удаление элементов 536
управление объектами 543
обращение к экземпляру класса SWF-файла 545
трансформации над вложенными контейнерами 545
трансформация, влияние на дочерние элементы 544
Контроль версий 942
Корневой объект 522
л
Логика ветвлений 95
Локальная область действия 468
Локальное имя 355
Локальные переменные 53
Локальные переменные, параметры конструктора 58
Локальные типы безопасности
песочниц 479
Локальный тип безопасности песочницы, выбор 483
м
Массивы 229
анатомия 229
в других языках программирования 230
добавление элементов 236
concat( ), метод 240
push( ), метод 237
splice( ), метод 239
unshift( ), метод 239
непосредственное 236
переменная length 237
индексация элементов 230
конструктор класса Array 232
методы класса Array 237, 242
многомерные 244
обращение к элементам 232
получение значения 232
присваивание значения
элементу 233
оператор доступа к массиву 232
проверка содержимого с помощью
метода toString( ) 243
размер или длина 230
размер или длина, определение 234
создание 230
с помощью литералов 231
с помощью оператора new 231
с помощью квадратных скобок 231
удаление элементов 241
delete, оператор 241
length, переменная 242
рор( ), метод 242
shift( ), метод 243
удаление элементов (продолжение) splice( ), метод 243
элементы 230
Метод
addChildAt( ) 532
addedListener( ) 707
addedToStageListener( ) 673 addEventListener( ) 247, 249, 260, 269, 567
параметр useCapture 571
параметр
«использоватьСлабуюСсылку» 265
addObject( ) 211
addShape( ) 157
allowDomain( ) 283,475, 504
allow!nsecureDomain( ) 506
appendText( ) 111
apply Filter( ) 758
attackEnemy( ) 307
attribute( ), E4X 422
attribute( ), XML 413, 426
copyPixels( ) 752
draw( ) 743
ScribbleAS3, версия
с неотображаемыми векторами 748
параметры 743
растеризация и растворение объекта Text Field 746
eat( ) 67, 70
параметр numberOfCalories 72
подпись 77
getDefinition( ) класса ApplicationDomain 893
hasChanged( ) 707
hitListener( ) 584
hitTest( ) 734
push() 237
Метод-аксессор 106
Метод-модификатор 106
Метод-мутатор 106
Метод-писатель 106
Метод-получатель 106
Метод-читатель 106
Метод экземпляра attributes( ) 438
Методика путей библиотек 859
Методика путей внешних библиотек 859
Методика путей исходных файлов 859
Методы
beginBitmapFill( ), beginFill( ) beginGradientFill( ) 703
абстрактные 162
аксессоры 106
аргументы 71
возвращаемые значения 73
в сравнении с замыканием функции 126
мутаторы 106
оператор круглых скобок ( ) 66
параметры 71
подписи 76
с неизвестным количеством параметров, обработка 112
состояние объекта 105
статические 120
тело 66
экземпляра 65
ключевое слово this, исключение
из кода 101
методы get и set 110
модификаторы управления доступом 69
обработка неизвестного количества параметров ИЗ
переменная name 112
связанные методы 103
терминология C++и Java 124
Модификаторы управления доступом 46
для методов экземпляра 69
для переменной экземпляра 56
доступность определения,
зависимость 346
пространства имен 387
пространство имен и импортированный пакет 394
Наследование 141
в сравнении с композицией 158
вызов перекрытого метода
экземпляра 147
динамическое связывание 156
иерархическое моделирование 155
интерфейсы 209
исключение перекрытия методов 153
исключение расширения классов 153
отношения «является», «имеет»
и «использует» 160
перекрытие методов экземпляра 145
переопределение 145
повторное использование 145
повторное использование кода 155
подклассы внутренних классов 154
полиморфизм 156
расширение 145
статические методы и переменные
не наследуются 144
теория 155
о
Область видимости 345
вложение 345
возможные области видимости, обзор кода 350
глобальная 346
детали реализации 351
доступность определения 346
и открытые пространства имен 388
класса 347
метода экземпляра 349
расширение цепочки с помощью
оператора with 352
статического метода 348
функции 349
цепочка областей видимости 345
Обновления экрана 653
выполнение блока кода 660
запланированные 653
назначенная скорость кадров
в сравнении с реальной 661
область перерисовки 667
постсобытийные 663
скорость кадров 654
событие Event.RENDER,
оптимизация 667
установка скорости кадров 661
Обработка исключений 288
блок finally 306
вложенные исключения 309
изменение хода выполнения
программы 313
механизм 288
необработанные исключения 305
несколько типов исключений 291
блок try с несколькими блоками
catch 293
один класс для исключительных ситуаций 295
отладочные сообщения для поиска отличий в ошибках 295
пользовательский класс исключения для каждой ситуации 295
степень детализации типов исключений 293
передача исключений вверх по иерархии
объектов 301
Обработка событий 246
Объект
Byte Array 733
Class 123
URLRequest 838
VirtualPet
время создания 74
переменная экземпляра pet 55
создание 50
Объект активации 351
Объектно-ориентированное программирование (ООП) 40
Объекты 40
деактивация 323
доступность 317
значения 53
использование методов для изменения состояния 105
объект активации 351
объекты-прототипы 341
создание 49
создание экземпляра 49
текущий объект 63, 72
функции для создания объектов 339
Обычные кадры 902
Одномерные массивы 244
Оновная временная шкала 901
ООП (объектно-ориентированное программирование) 40
Операнды 61
Оператор
as 193,226
break 85, 93
if 80
без условия else 83
цепочка 83
in 226
instanceof 226
is 226
void 224
with 86, 352
блока 43
присваивания 64
Операторы 61, 219
ассоциативность 221
и типы данных 221
количество операндов 219
обзор 222
приоритет 220
Описатель 355
Открытые пространства имен 355, 387
Отношения 160
«имеет» 160
«использует» 160
«является» 160
п
Пакеты 42
и имя класса 42
присваивание имени 43
структура папок 44
Панель Actions (Действия) 905
Перекрытие методов экземпляра 145
Переменная
autoSize 773
Переменные 53
значения по умолчанию 197
копирование и ссылки 64
локальные 53
объявление за пределами пакета 352
определение в сценариях кадров 910
переменные экземпляра 54
присваивание одной переменной
значения другой 62
статические 115
типизированные и нетипизированные 185
экземпляра 54
и статические переменные с одинаковыми именами 116
модификатор private 105
модификаторы управления доступом 56
терминология C++и Java 124
Перенос слов 772
переменная multiline 773
Пикселы
значения цвета 718
изменение позиции 741
инструменты изменения
изображений 741
класс Pixel 721
присваивание цвета области
пикселов 739
Побитовые операции 720
Полиморфизм 156
Пользователь 467
Пользовательские ошибки 288
Пользовательские события 246
Порядок перехода 614
Постсобытийные обновления 653, 663
автоматические 667
для событий таймера 665
Потомки 143, 522
Похищение информации 480
Предки 143, 522
Предопределенные ошибки 288, 315
Предопределенные события 246
Приведение типов 189
восходящее и нисходящее 192
оператор as для приведения к типам Date и Array 193
Пробельные узлы 408
Программа «Зоопарк»
использование функций 136
окончательная версия 956
применение наследования 162
сборка мусора 318
Пространства имен 354
в ActionScript 355
для модификаторов управления доступом 391
доступность 368
и директива use namespace 387
и область видимости 388
класс Namespace 359
открытые 387
пример использования 365
словарь 354
создание 357
уточненные идентификаторы 363
уточняющие 360
Проталкивание, выталкивание и стеки 238
Пустые ключевые кадры 905
Растровые изображения 717
анализ 727
влияние прозрачности на получение значения цвета 729
внесение изменений 734
внешние, загрузка 725
на этапе выполнения 726
на этапе компиляции 727
добавление эффекта старой фотографии 755
загруженные изображения,
создание 872
изменение размеров 741
инструменты изменения
изображений 741
класс Bitmap 718
класс BitmapData 718
копирование графики 742
определение 519
освобождение памяти 765
палитра выбора цвета на основе изображения 731
получение цвета области пикселов 732
предумноженное значение цвета 729
применение фильтров и эффектов 757
присваивание цвета области
пикселов 739
создание 723
тег метаданных [Embed], встраивание 888
форматы изображений 725
цветовые каналы 719
ширина и высота, параметры 723
Режимы работы программы 400
Родители 522
с
Сборка мусора 317
алгоритм поэтапных пометок и вычищений 320
Сборка мусора (продолжение) деактивация объектов 323 демонстрация 325 достижимый объект, доступный для сборки мусора 320 доступность 317 корневой элемент сборки мусора 317 намеренное освобождение объектов 321
недостижимые объекты 317 повторное использование объектов вместо удаления 321
растровые изображения 765
циклы сборки мусора 320
Связанные методы 103
Скорость кадров 901
влияние на анимации, создаваемые событием Event.ENTERFRAMЕ 683
влияние на таймеры 690
События 246
ADDED TO STAGE 555
ENTER-FRAME 678
Event.ENTER FRAME, анимация 678
Event.RENDER 667
Event.RESIZE 251
lOErrorEvent.IOERROR 251
TimerEvent.TIMER, анимация 684
REMOVED_FROM_STAGE 555 всплывающие и невсплывающие 565 диспетчеризация 246 диспетчеризация события, остановка 581 иерархическая диспетчеризация событий 564
изменение иерархии отображения 587
изменение списка приемников события 589
константа для события 248
названия 249
недостатки в событийной модели 280 обработка событий между границами зон безопасности 282
метод allowDomain( ) 283
метод allowDomain( ), разделяемые события 285
определение 253
получателем является объект 580
получатель 247, 253
получатель, доступ 254
получателями являются потомки 580
пользовательские 267
gameOver 267
toggle 271
отмена стандартного поведения 274
пользовательские события и цепочка
диспетчеризации 590
приемники событий 246, 253
приоритет 259
слабые ссылки на приемники
событий 265
список приемников 261
тип возвращаемого значения 249
управление памятью 261
приемники событий и цепочка диспетчеризации 566
приоритет и цепочка
диспетчеризации 586
разделяемые 285
регистрация приемника события 247
два примера 250
ожидание возникновения события 250
определение имени типа события 248
определение типа данных 249
отмена 252
переменная currentTarget 256
регистрация для события 249
создание приемника события 249
событийный объект 247, 253
события ввода 596
стандартное поведение, отмена 257
текущая фаза, определение 577
фазы диспетчеризации 565
централизация кода, цепочка
диспетчеризации события 574
цепочка диспетчеризации 566
События ввода 596
основные правила 596
события ввода уровня приложения Flash
Player 646
Event.ACTIVATE
и Event.DEACTIVATE 648
Event. М OU SELF AVE 652
Event.RESIZE 650
типы 647
События ввода с клавиатуры 621 глобальная обработка событий клавиатуры 622
клавиши, расположенные в нескольких местах 627
код клавиши 624
обработка событий для конкретного объекта 623
одновременное нажатие нескольких клавиш 627
отличие от событий текстового ввода 621
последняя нажатая или отпущенная клавиша 624
символ, связанный с клавишей, определение 629
События контейнеров 549
ADDEDTOSTAGE и REMOVEDFROMSTAGE 555
Event.ADDED и Event.REMOVED 549
реальный пример использования 554
События мыши 597
внутренние события мыши приложения Flash Player 597
и клавиши-модификаторы 629
и перекрывающиеся отображаемые объекты 605
определение позиции указателя 607
регистрация приемников 602
установка фокуса на объекты 616
События текстового ввода 631
событие Event.SCROLL 636
событие Text Event. LINK 643
события TextEvent.TEXTINPUT
и Event.CHANGE 632
типы 632
События фокуса 614
автоматический порядок перехода 614
порядок перехода 614
типы внутренних событий фокуса Flash
Player 617
установка фокуса на потомков через одного предка 617
установка фокуса с помощью мыши 616
Сокеты
безопасность 479
протокол Secure Sockets Layer (SSL) 468
разрешение, файл политики безопасности 498
установка локального доверия 485
Специализация 143
Специальный символ атрибутов
расширения Е4Х (@*) 422
Спецификация W3C
Document Object Model (DOM) 246,407
пространства имен в XML, рекомендации 357
Список отображения 523
класс Stage 523
Справочная таблица 336
Статические методы 120
Статические переменные 115
Стек 238
Сцена 901
Сценарий кадра 653,905
ключевые и обычные кадры 902
создание сценариев на временной шкале 905
т
Тег метаданных [Embed] 885
Текстовое поле 519
Тернарные операторы 220
Тестирование приложений,
безопасность 487
Тип данных 181
Boolean, преобразование
к другим типам 196
int, преобразование к другим типам 195
Number, преобразование
к другим типам 194
Object 181
String, преобразование
к другим типам 196
uint, преобразование к другим типам 195
void 181
void, значение undefined 197
аннотация, или декларация, типа 183
в программе по созданию виртуального зоопарка 198
и операторы 221
нетипизированные и типизированные переменные и параметры 185
ошибки несоответствия типов 184
предупреждения об отсутствующих аннотациях типов 188
преобразование к примитивным
типам 194
примитивные типы 184
совместимые типы 182
Точка (.) 116
У
Удаленная область действия 468
Удаленные регионы 469
Унарные операторы 220
Управление памятью
намеренное освобождение объекта 321
освобождение памяти, занимаемой
растровыми изображениями 765
сборка мусора 320
Условные операторы 80
if 80
switch 84
Уточненный идентификатор 355, 363
Уточняющее пространство имен 355
ф
Файлы
Virtual Pet.as 47
VirtualZoo.as 42
VirtualZoo.as, структура
папок 44
политики безопасности 488
получение разрешения на доступ к содержимому в виде данных 494
получение разрешения на загрузку
данных 492
размещение 491
разрешения сокетных соединений 498
получение файла по протоколу
HTTP 502
получение файла через сокет 500
создание 490
файлы междоменной политики безопасности 489
с расширением AS 42
Фокус ввода с клавиатуры 614
Функции 126
вложенные 129
глобальные 128
для создания объектов 339
использование в программе
«Зоопарк» 136
как значения 132
класс VirtualPet с функциями 138
рекурсивные 134
синтаксис литералов 132
уровня исходного файла 130
уровня пакета 127
ц
Цепочка прототипов 342
Циклы 86
анимация без циклов 677
итератор, или индекс 88
корректировка 88
обработка списков 89
оператор break, завершение цикла 92
do-while, оператор 93
for, оператор 93
while, оператор 86
ш
Шрифты 808
_sans, serif, typewriter, названия 784
встраиваемые 784
встраивание начертаний 810
в среде разработки Flash 810
с помощью консольного компилятора mxmlc 811
загрузка на этапе выполнения 818
курсивное начертание 784
определение доступности 823
определение доступности глифа 825
отсутствующие шрифты
и глифы 822
полужирное начертание 784
3
Экземпляры 40
Колин Мук
ActionScript 3.0 для Flash. Подробное руководство
Перевел с английского Александр Климович
Заведующий редакцией Руководитель проекта Ведущий редактор Художник Корректоры Верстка
Д. Гурский Ю. Чернушевич Н. Гринчик С. Шутов Е. Павлович, В. Субот О. Махлина
Подписано в печать 30.09.08. Формат 70x100/16. Усл. п. л. 79,98. Тираж 2000. Заказ № 997.
ООО «Питер Пресс», 198206, Санкт-Петербург, Петергофское шоссе, 73, лит. А29.
Налоговая льгота — общероссийский классификатор продукции ОК 005-93, том 2; 95 3005 — литература учебная.
Отпечатано с готовых диапозитивов в ГП ПО «Псковская областная типография».180004, Псков, Ротная ул., 34.
ActionScript 3.0
для Flash
I 1одробное руководство
O’REILLY ^y
С^ПГПЕР «*♦
KMUH MjK
Essential
Actionscript 3.0
Colin Mooch
O’REILLY
Beijing • Cambridge • Farnham • Koln • Paris • Sebastopol • Taipei • Tokyo
Actionscript 3.0
для Flash
Подробное руководство
Колин Мук
м
Adobe
O’REILLT
СОЛИТЕР
Москва ■ Санкт-Петербург ■ Нижний Новгород ■ ВоронежРостов-на-Дону ■ Екатеринбург - Самара ■ НовосибирскКиев ■ Харьков ■ Минск
2009
ББК 32.988.02-018
УДК 004.738.5
М90
Мук К.
М90 ActionScript 3.0 для Flash. Подробное руководство. — СПб.: Питер, 2009. — 992 с.: ил.
ISBN 978-5-91180-808-2
«Это новая книга Колина Мука». Данной фразы будет достаточно, чтобы в книжные магазины выстроились очереди из флэшеров. Не было и нет автора, который бы по авторитету и влиянию мог равняться Муку. Он был первым, кто написал достойную книгу по ActionScript сразу же после появления этого языка в далеком 2001 году. ActionScript стремительно развивался, превращаясь в полноценный объектно-ориентированный язык. И неизменную помощь в освоении очередных революционных нововведений начинающим и опытным флэшерам по всему миру оказывали книги Колина Мука.
Казалось бы, еще совсем недавно всех поразил ActionScript 2.0, в котором появились все особенности объектно-ориентированного языка. Однако по своей сути это оставался старый добрый ActionScript 1.0, что проявлялось в формальности многих возможностей. Эти недостатки исчезли в ActionScript 3.0, который стал мощнее, удобнее, строже, быстрее. Данная книга, будучи лучшим руководством по ActionScript 3.0, объединяет в себе достоинства своих предшественниц — «Essentials ActionScript 2.0» и «ActionScript for Flash MX: The Definition Guide». В ней рассматриваются как фундаментальные основы языка и ключевые идеи объектно-ориентированного программирования, так и конкретные возможности по управлению содержимым Flash-приложений. Уникальный авторский стиль, множество реальных примеров, грамотный перевод — все это позволит освоить ActionScript 3.0 быстро и легко.
ББК 32.988.02-018
УДК 004.738.5
Все права защищены. Никакая часть данной книги не может быть воспроизведена в какой бы то ни было форме без письменного разрешения владельцев авторских прав.
Информация, содержащаяся в данной книге, получена из источников, рассматриваемых издательством как надежные. Тем не менее, имея в виду возможные человеческие или технические ошибки, издательство не может гарантировать абсолютную точность и полноту приводимых сведений и не несет ответственности за возможные ошибки, связанные с использованием книги.
ISBN 978-0-596-52694-8 (англ.)ISBN 978-0-596-52694-8 (англ.)ISBN 978-5-91180-808-2ISBN 978-5-91180-808-2© 2007 O'Reilly Media, Inc
ISBN 978-0-596-52694-8 (англ.)
ISBN 978-0-596-52694-8 (англ.)
ISBN 978-5-91180-808-2
ISBN 978-5-91180-808-2
© Перевод на русский язык ООО «Питер Пресс», 2009
© Издание на русском языке, оформление
ООО «Питер Пресс», 2009
Краткое содержание
Предисловие16
Введение19
Благодарности30
От издательства34
Часть I. ActionScript с нуля