Обновлено: 18.05.2024

Переопределяемые и поставляемые объекты библиотеки

Область применения: управляемое приложение, мобильное приложение, обычное приложение.

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

• Непереопределяемые объекты – «готовые» объекты, которые можно брать и использовать в конфигурации-потребителе «как есть». Их не следует изменять в конфигурации-потребителе, чтобы они были гарантированно одинаковы во всех конфигурациях, основывающихся на данной библиотеке. Более того, такие объекты обязательно должны присутствовать в конфигурациях, использующих библиотеку. Примеры: справочник Пользователи .
• Переопределяемые объекты – «изменяемые» объекты для настройки библиотеки под конкретную конфигурацию. Они могут или должны быть изменены в конфигурации-потребителе. С помощью таких объектов решаются задачи изменения поведения библиотечной функциональности, ее параметризации спецификой конфигурации-потребителя, а также для подключения библиотечной функциональности к объектам конфигурации-потребителя.
• Определители типов – объекты-«классификаторы», которые не имеют базовой реализации. Предназначены для формирования единого пространства имен в конфигурациях, а реализация при этом может как угодно сильно различаться в конфигурациях-потребителях. Например: справочники-классификаторы, в которых определено только «название»; сущность «организация» должна быть везде представлена справочником с именем Организации и т.п.

2. Рекомендуется устанавливать для объектов этих категорий следующие правила поставки :

• Непереопределяемые объекты – «изменения не рекомендуются»;
• Переопределяемые объекты и определители типов – «изменения разрешены».

Эти рекомендации продиктованы следующими соображениями:

• Непереопределяемые объекты – это зона ответственности разработчиков библиотеки, поэтому они не должны разрабатываться «по месту» в конфигурациях-потребителях. Но если необходимость изменений носит срочный характер (например, исправление критичной ошибки) или продиктована какими-то другими особыми соображениями, то допускается вносить изменения в непереопределяемые библиотечные объекты непосредственно в конфигурациях-потребителях. При этом нужно иметь в виду, что эти изменения могут быть потеряны при следующем обновлении версии библиотеки в конфигурации-потребителе, если не принять специальные меры (донести до разработчиков библиотеки необходимость внесения изменений или задокументировать этот отход от общей инструкции по обновлению библиотеки).
• Переопределяемые объекты и определители типы должны или могут быть изменены в конфигурации-потребителе, исходя из их назначения.

3. Для того чтобы упростить настройку библиотеки и снизить трудоемкость последующих обновлений версии библиотеки в конфигурации-потребителе следует минимизировать количество переопределяемых объектов с помощью следующих методик:

• Настройка состава типов переопределяемых реквизитов (свойств) тех или иных объектов библиотеки – для подключения библиотечной функциональности к объектам конфигурации-потребителя.
  Например: можно подключить библиотечную функциональность к конкретным объектам конфигурации с помощью расширения состава типов общей команды, измерения составного типа в регистре сведений и т.п.
  
• Добавление предопределенных элементов – для параметризации библиотечной функциональности спецификой конфигурации-потребителя.
  Например: для библиотечной подсистемы ведения и обработки контактной информации с помощью предопределенных элементов библиотечного справочника ВидыКонтактнойИнформации можно указать, какие виды контактной информации (телефон, адрес, электронный адрес и т.п.) должны быть предусмотрены для объектов конфигурации-потребителя.
  
• Переопределяемые общие модули – для изменения поведения библиотечной функциональности в конкретной конфигурации-потребителе
  • с помощью переопределения тех или иных «обработчиков событий», предоставляемых библиотекой; например:
    ПриПодготовкеМакетаОписанияОбновлений
    ПриЗаписиСпискаБизнесПроцессов
  • а также для того, чтобы сообщить ту или иную информацию из конфигурации-потребителя в библиотеку. Например:
    ПриОпределенииБазовойВерсииКонфигурации
    ПриДобавленииОбработчиковОбновления

  3.1. Переопределяемые общие модули следует называть с постфиксом Переопределяемый .

  3.2. Переопределяемые общие модули должны содержать только экспортные процедуры, которые вызываются из кода самой библиотеки. Другими словами, не следует допускать вызовов процедур переопределяемых модулей непосредственно из кода конфигурации-потребителя.

  Такое ограничение обусловлено соображением повышения устойчивости кода конфигурации, который вызывает библиотечные процедуры и функции, составляющие программный интерфейс библиотеки. К программному интерфейсу библиотеки следует относить только экспортные процедуры и функции непереопределяемых общих модулей.

  Например, в библиотеке имеются модули ПапкиФайлов и ПапкиФайловПереопределяемый . Для использования в конфигурациях-потребителях в модуле ПапкиФайлов реализуется экспортная функция:

  Функция ПапкаФайлов(ВладелецФайловСсылка) Экспорт

  СтандартнаяОбработка = Истина;
  Результат = Неопределено;
  ПапкиФайловПереопределяемый.ПриПолученииПапкиФайлов(ВладелецФайловСсылка, Результат, СтандартнаяОбработка);

  Если СтандартнаяОбработка Тогда
  // реализация по умолчанию
  Результат = .
  КонецЕсли;
  Возврат Результат;

  а в модуле ПапкиФайловПереопределяемый - процедура-обработчик ПриПолученииПапкиФайлов :

  // Вызывается из библиотеки при необходимости получить папку файлов для указанного владельца.
  //
  // Параметры:
  // ВладелецФайловСсылка – ЛюбаяСсылка - владелец файлов, для которого нужно вернуть папку.
  // ПапкаФайлов – СправочникСсылка.ПапкиФайлов - в этот параметр нужно записать результат.
  // СтандартнаяОбработка – Булево - по умолчанию, Истина. В этом случае папка будет получена способом по умолчанию.
  // Если значение параметра установить в Ложь, то в этой процедуре можно реализовать свой способ,
  // которым в конфигурации получают папки файлов.
  //
  Процедура ПриПолученииПапкиФайлов(ВладелецФайловСсылка, ПапкаФайлов, СтандартнаяОбработка) Экспорт

  При этом все вызовы из конфигурации-потребителя должны идти только к библиотечному модулю ПапкиФайлов . Обращение к ПапкиФайловПереопределяемый разрешается только из библиотечного модуля ПапкиФайлов .

  3.3. При этом в переопределяемом модуле следует располагать только экспортные процедуры с пустой реализацией. В нем не должно быть каких-либо других не-экспортных процедур или функций. Базовую реализацию переопределяемых процедур и функций следует располагать в непереопределяемом коде.

  Такое ограничение вызвано необходимостью снизить трудоемкость последующих обновлений переопределяемых модулей в конфигурации-потребителе.
  Например, неправильно поставлять переопределяемый модуль МояБиблиотекаПереопределяемый с какой-либо реализацией:

  Функция НастройкаПараметровРаботы() Экспорт

  ПараметрыРаботы = Новый Структура;
  // если настройки по умолчанию не подходят, то измените их.
  ПараметрыРаботы.Вставить("ПоказыватьЕдинственныйРаздел", Ложь);
  ПараметрыРаботы.Вставить("ЗадаватьДатуДляПрочихРазделов", Ложь);
  ПараметрыРаботы.Вставить("ИспользоватьВнешнихПользователей", Ложь);
  Возврат ПараметрыРаботы;

  // Позволяет настроить работу подсистемы.
  //
  // Параметры:
  // ПараметрыРаботы - Структура - содержит свойства:
  // * ПоказыватьЕдинственныйРаздел - Булево - по умолчанию Ложь.
  // * ЗадаватьДатуДляПрочихРазделов - Булево - по умолчанию Ложь.
  // * ИспользоватьВнешнихПользователей - Булево - по умолчанию Ложь.
  //
  Процедура ПриПолученииНастроекПараметровРаботы(ПараметрыРаботы) Экспорт

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

  ПараметрыРаботы = Новый Структура;
  // настройки по умолчанию
  ПараметрыРаботы.Вставить("ПоказыватьЕдинственныйРаздел", Ложь);
  ПараметрыРаботы.Вставить("ЗадаватьДатуДляПрочихРазделов", Ложь);
  ПараметрыРаботы.Вставить("ИспользоватьВнешнихПользователей", Ложь);

  // а теперь запросим конфигурацию-потребитель на случай,
  // если эти умолчания не устраивают
  МояБиблиотекаПереопределяемый.ПриПолученииНастроекПараметровРаботы(ПараметрыРаботы);
  Возврат ПараметрыРаботы;

  3.4. При обновлении версии библиотеки в конфигурации-потребителе особого внимания требуют модули корневого объекта конфигурации и переопределяемые общие модули, так как автоматическое обновление таких «узких мест» конфигурации-потребителя невозможно. Для настройки в конфигурации переопределяемых общих модулей рекомендуется придерживаться общего подхода:

  У нас на этой неделе практически юбилей — стартует пятая группа "Разработчик Java", а это значит, что мы снова делимся всякими полезностями.

  Если вы хотите убедиться, что вы переопределяете правильным образом, взгляните на это руководство, которое описывает различные средства, имеющиеся в вашем распоряжении, и некоторые подводные камни, которых следует остерегаться.

  Дочерний класс может переопределить методы экземпляра своего родительского класса. Это называется переопределением метода. Сигнатура (тип возврата, тип параметров, количество параметров и порядок параметров) должна быть такой же, какой была определена в родительском классе. Переопределение метода выполняется для достижения полиморфизма во время выполнения программы.

  
  

  
  
  Что такое полиморфизм?

  Полиморфизм позволяет вам определить один интерфейс и иметь для него несколько реализаций. Это один из основных принципов объектно-ориентированного программирования. Слово «полиморфизм» буквально означает «состояние наличия многих форм» или «способность принимать разные формы». При применении к объектно-ориентированным языкам программирования, таким как Java, он описывает способность языка обрабатывать объекты разных типов и классов через единый, однородный интерфейс.

  Что такое полиморфизм времени выполнения (или отправка динамического метода?)

  Переопределенный метод вызывается в соответствии с объектом, которому принадлежит метод, а не по типу ссылки.

  В чём польза полиморфизма времени выполнения?

  Статический или динамический полиморфизм?

  Private, final и static методы используют статические привязки и связаны компилятором, в то время как виртуальные методы связываются во время выполнения на основе обрабатываемого объекта.

  Использование Override

  Используйте аннотацию Override, чтобы компилятор мог проверить, что вы действительно переопределяете метод, когда вы на это рассчитываете. Таким образом, если вы совершаете распространенную ошибку, например, опечатку в имени метода или неправильно задаете параметры, вы будете предупреждены о том, что ваш метод фактически не переопределяет в то время, как вы уверены в обратном. Во-вторых, это улучшает читаемость кода, делая переопределение более очевидным.

  Кроме того, начиная с Java 1.6 вы можете воспользоваться Override с теми же целями, чтобы отметить, когда метод реализует интерфейс.

  Правила динамического полиморфизма

  Изменение сигнатуры метода

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

  
  Тип возврата метода

  Типы возвращаемых данных могут варьироваться в зависимости от методов, которые переопределяют друг друга, если типы возврата являются ссылочными типами. Java поддерживает ковариантные возвращения — специализацию типа возврата к подтипу. Объявление метода d1 с типом возврата R1 заменит возвращаемое значение метода d2 с возвращаемым типом R2 тогда и только тогда, когда выполняются следующие условия:

  • Если R1 void, то R2 является void.
  • Если R1 является примитивным типом, то R2 идентичен R1.
  • Если R1 является ссылочным типом, то: R1 является либо подтипом R2, либо R1 может быть преобразован в подтип R2 путем unchecked преобразования или
  • R1 = | R2 |

  Ковариантный тип возврата

  Возвращение коварианта означает, что при переопределении метода возвращаемый тип переопределяющего метода разрешен как подтип возвращаемого типа переопределенного метода.

  Чтобы прояснить это с помощью примера, общим случаем является Object.clone (), который объявляется для возврата типа объекта. Вы можете переопределить это в своем классе следующим образом:

  Переопределение статического метода (или) Связывание метода

  
  Связывание статических переменных

  
  Final и private методы

  
  Переопределение уровней доступа

  
  Переопределение с super()

  
  Переопределение с абстракцией

  
  Переопределение с исключениями

  
  Переопределение из внутренних приватных классов

  
  Переопределение и перегрузка

  
  Многоуровневое переопределение

  
  Переопределение методов экземпляра против статических методов

  
  Переопределение методов экземпляра против статических переменных

  
  Переопределение конструктора

  
  Конструктор с super()

  
  Переопределение другого и того же пакетов

  
  Правила ребенок-родитель: последствия переопределения

  
  Методы экземпляра предпочтительнее default методов интерфейса.

  
  Программы, содержащие комментарии для иллюстрации использования и последствий при переопределении, могут иметь некоторые CE и RE.

  
  

  В нашем примере мы будем модифицировать модуль входа на сайт (Login Form). Мы уберем чекбокс "Запомнить меня":

  
  

  • Получите доступ к файлам вашего сайта и перейдите в папку /modules/ .
  • Найдите папку /mod_login/ .
  • Внутри папки /mod_login/ вы скорее всего найдете папку /tmpl/ . Если ее нет, то модуль не поддерживает переопределения.
  • Внутри папки /tmpl/ найдите файл шаблона (макета). В простых модулях он чаще всего называется default.php . Сделайте копию этого файла.

  
  

  • Перейдите в папку /templates/ .
  • Откройте папку вашего текущего шаблона. В этом примере наш шаблон /beez_20/ .
  • Откройте папку /html/ . Если ее нет, то создайте.
  • Внутри папки /html/ создайте папку с таким же именем, как имя папки оригинального модуля. В нашем случае, это /mod_login/ .
  • Закачайте скопированный раннее файл шаблона в эту новую папку. Не забудьте в эту же папку и в папку /html/ скопировать пустой файл index.html.

  
  

  • Теперь вы можете отредактировать файл шаблона. В нашем примере мы закомментируем строки с 49 по 52 в default.php .

  
  

  • Сохраните файл и ваши изменения отобразятся на сайте:

  
  

  2) Переопределение компонента

  Давайте посмотрим на почти такую же задачу, но только с компонентом. Мы уберем чекбокс "Запомнить меня" из формы входа на сайт:

  
  

  • Получите доступ к файлам вашего сайта и перейдите в папку /components/ .
  • Найдите папку /com_users/ .
  • Внутри папки /com_users/ вы скорее всего найдете папку /views/ . Если ее нет, то компонент не поддерживает переопределения.
  • Внутри папки /views/ вы найдете несколько подпапок. Обычно каждая из них названа логически, в зависимости от того, какую часть компонента она отображает.
  • Загляните внутрь этих папок и папок /tmpl/ . Найдите файл шаблона, который вы хотите изменить. В нашем примере необходимым нам файлом будет /login/tmpl/default_login.php .

  
  

  • Перейдите в папку /templates/ .
  • Откройте папку вашего текущего шаблона. В этом примере наш шаблон /beez_20/ .
  • Откройте папку /html/ . Если ее нет, то создайте.
  • Внутри папки /html/ создайте папку с таким же именем, как имя папки оригинального компонента. В нашем случае, это /com_users/ .
  • Создайте подпапку внутри папки /com_users/ , имя которой совпадает с именем подпапки оригинального компонента. В нашем случае, это /login/ .
  • Закачайте скопированный раннее файл шаблона в эту новую папку. Не забудьте в эту же папку и в папку /html/ скопировать пустой файл index.html.

  
  

  • Теперь вы можете отредактировать файл шаблона. В нашем примере мы закомментируем строки с 47 по 50 в default_login.php .

  
  

  • Сохраните файл и ваши изменения отобразятся на сайте:

  
  

  3) Переопределения строк в языковых файлах

  В то время как модули и компоненты должны быть переопределены через файлы, языковые строки вы можете переопределить используя панель управления Joomla. В нашем примере, мы переопределим фразу "Ещё нет учетной записи?":

  
  

  Однако основным недостатком является то, что обычно эти изменения не сохраняются – если вы переходите на другую страницу или обновляете ту же страницу, все изменения теряются. Но теперь, с выпуском Chrome 65, все изменилось.

  Постоянные локальные переопределения

  Начиная с Chrome 65, DevTools теперь включает функцию «Local Overrides», которая позволяет вносить изменения, сделанные локально. Теперь вы можете не терять все свои изменения, когда вы обновите или покинете страницу.

  Итак, как использовать эту функцию? Вот основные шаги, чтобы начать.

  Включить локальные переопределения

  • В DevTools откройте панель « Источники» .
  • В разделе « Источники» откройте вкладку « Переопределения

  
  

  Нажмите «Выбрать папку для переопределений». Затем выберите папку на локальном компьютере, где должны храниться локальные переопределения (вы можете создать новую папку специально для этой цели).

  
  

  Теперь вы увидите, что установлен флажок «Включить локальные переопределения». Вы также заметили, что на панели « Сеть» имеется предупреждающий знак, указывающий, что некоторые сетевые запросы могут быть перезаписаны с локальным переопределением.

  
  

  Внесите свои изменения

  • Теперь вы можете вносить изменения в файлы. Если вы находитесь на панели « Элементы» , обратите внимание, что рядом с именем файла стоит маленький кружок, обозначающий, что он был отредактирован и теперь является локальным переопределением.

  Примечание. Если вы обновляете разметку, используйте для этого панель « Источники» (а не панель « Элементы» ).

  
  

  • Обновите страницу или перейдите на другую страницу сайта. Chrome продолжит использовать внесенные вами изменения.

  Отслеживайте свои изменения

  • На вкладке « Переопределения» (в разделе « Источники» ) отобразится список всех файлов, которые вы используете для локальных переопределений. Они будут организованы по доменам. Отсюда вы можете выбрать файлы для редактирования или вообще удалить локальные переопределения.
  • Chrome также предлагает новую функцию под названием « Изменения» , которая предоставит вам обзор всех внесенных вами изменений. Это находится рядом с вкладкой Консоль DevTools.

  
  

  Эта функция позволяет вам вернуться к внесенным вами изменениям и точно увидеть, чем они отличаются от исходных файлов.

  
  

  Инструмент производительности

  Функция переопределения не только позволяет экспериментировать с изменениями дизайна на нелокальном сайте, но также имеет значение для разработки, связанной с производительностью.

  Благодаря настройке локальных переопределений у вас теперь есть возможность вносить изменения в код на нелокальном сайте, а затем посмотреть, какое влияние на эти изменения окажут на производительность. (И Гарри Робертс, и Умар Ганза выпустили недавние скринкасты, показывающие некоторые примеры этого.)

  Например, вы можете перемещаться по местам размещения определенных сценариев на странице или добавлять некоторые стили, влияющие на отображение шрифтов, и быстро видеть влияние, которое они могут оказать. Вы можете обновить некоторые шаблоны JavaScript или обработчики событий и посмотреть, насколько значительными будут изменения.

  Если вы работаете на сайте локально, эти новые функции могут иметь ограниченную ценность. Но в тех случаях, когда вы хотите экспериментировать на сайте, который не является локальным, и делать это быстро, эти новые функции открывают много возможностей.

  Читайте также:

    
  • Управление компьютером сеансы виснет
    
  • Swtor как изменить разрешение экрана не заходя в игру
    
  • Gimp ошибка при открытии файла
    
  • Как скопировать фигуру в экселе
    
  • Как победить акуму в теккен 7 на ps4