Мақолаи Ҷонни Ҳакетт 14 июли 2014, 11:09 Агар шумо дар Java барномарезӣ кунед ва ягон чаҳорчӯбаи маъмул ба монанди
Spring ва
Hibernate -ро истифода баред , пас шумо аллакай бо истифодаи эзоҳҳо шинос ҳастед. Ҳангоми кор бо чаҳорчӯбаи мавҷуда, эзоҳҳои дохилӣ кофӣ мебошанд. Аммо агар ба шумо лозим ояд, ки эзоҳҳои шахсии худро эҷод кунед? Чанде пеш ман сабабе доштам, ки шарҳҳои шахсии худро барои лоиҳае эҷод кунам, ки тасдиқи маълумоти умумиро аз якчанд пойгоҳи додаҳо талаб мекард. Сенария Тиҷорат дорои якчанд пойгоҳи додаҳо буд, ки як маълумотро нигоҳ медоштанд ва маълумотро бо роҳҳои гуногун навсозӣ мекарданд. Ба нақша гирифта шуда буд, ки маълумотҳо дар як базаи асосии базавӣ барои бартараф кардани мушкилоти марбут ба гирифтани маълумот аз манбаъҳои гуногун. Аммо пеш аз оғози лоиҳа, фаҳмидан лозим буд, ки маълумот то чӣ андоза ҳамоҳанг нест ва тағироти заруриро ворид кунед. Қадами аввал эҷод кардани гузорише буд, ки як маълумотро дар пойгоҳҳои гуногун нишон диҳад ва арзишҳоро тасдиқ кунад ё он сабтҳоеро, ки мувофиқат намекунанд, дар асоси қоидаҳои муқарраршудаи мувофиқа нишон диҳад. Дар зер иқтибос аз талаботи асосӣ дар замони лоиҳа оварда шудааст: • Муқоиса кардани маълумот дар якчанд пойгоҳи додаҳо барои пайдо кардани як маълумот, ба монанди номи муштарӣ, номи ширкат ё маълумоти директория. • Бо нобаёнӣ, арзиш бояд дар тамоми пойгоҳи додаҳо дар асоси намуди маълумот комилан якхела бошад. • Барои баъзе майдонҳо мо танҳо мехостем нишон диҳем, ки арзиш пайдо шудааст, аммо арзиш муқоиса карда нашудааст. • Барои дигар соҳаҳо, мо танҳо мехостем, ки арзишро бо чизи ёфтшуда муқоиса кунем ва маълумотро бо маълумоти манбаи муайяншуда тасдиқ кунем. • Барои майдонҳои сеюм, мо мехостем, ки муқоисаи мураккаби маълумотро анҷом диҳем, ки ба арзиши дигар соҳаҳои сабт асос ёфта бошад. • Барои навъи чорум, мо мехостем маълумотро формат кунем, масалан дар формати асъор $000,000.00. • Ҳисобот бояд дар формати MS Excel бошад, ҳар як сатр бояд аз манбаи алоҳида арзиш дошта бошад. Ҳар як сатр, ки арзиши он ба шартҳои тасдиқи маълумот мувофиқат намекунад, бояд бо ранги зард қайд карда шавад.
Аннотации После того, How мы прочитали требования и озвучor несколько разных идей воплощения того, что требуется, я решил использовать аннотации, которые запустят конфигурацию сравнения данных и процесс отчета. Нам требовалось просто, но гибкое и расширяемое решение. Эти аннотации будут на уровне поля и мне понравилось то, что конфигурацию не будет скрыта в файле, где-нибудь в пути класса. Вместо этого я смогу видеть аннотации ассоциированные с полем, чтобы точно знать How оно будет обработано. Проще говоря - annotation будет ничем иным How маркером, метаданные которая будет предоставлять информацию, но не будет напрямую воздействовать на работу самого codeа. Если вы уже программировали на Java, то вам должно быть знакомо использования annotation, но возможно вам никогда не требовалось создавать свои собственные. Для этого вам нужно создать новый тип, который использует Java тип
@interface, который будет содержать элементы, которые в свою очередь определяют детали метаданных. Вот пример проекта:
1@Target(ElementType.FIELD) 2@Retention(RetentionPolicy.RUNTIME) 3public @interface ReconField { 4 5 /** 6 * Значение, которое определяет из Howого источника сравниваются данные, or будет использоваться для 7 отображения значения or для ссылки на правило. 8 * 9 * @return Значение, если источники должны быть сравнены, по умолчанию true. 10 */ 11 boolean compareSources() default true; 12 13 /** 14 * Значение показывает формат, который используется для отображения значения в отчете. 15 * 16 * @return Установленный формам, по умолчанию native. 17 */ 18 ReconDisplayFormat displayFormat() default ReconDisplayFormat.NATIVE; 19 20 /** 21 * Значение, показывающее meaning ID используемого поля для одинаковых значений из источника до поля. 22 * 23 * @return ID поля. 24 */ 25 String id(); 26 27 /** 28 * Значение, показывающее ярлык, который будет отображается в отчете для поля. 29 * 30 * @return Значение ярлыка, по умолчанию пустая строка. 31 */ 32 String label() default ""; 33 34 /** 35 * Значение, показывающее источник, который должен быть сравнен на предмет различий. 36 * 37 * @return Список источников для сравнения. 38 */ 39 ReconSource[] sourcesToCompare() default {}; 40 } Это основная annotation, с помощью которой запуститься процесс сравнения данных. Она содержит основные требуемые элементы, в соответствии с требованиями, для сравнения данных из различных источников данных.
@ReconField должна справиться с большинством того, что нам требуется, за исключением более сложных сравнений данных, о которых мы поговорим позже. Большинство из этих элементов объяснены комментариями в codeе. Не смотря на это пара основных аннотаций в нашей
@ReconField должны быть объяснены отдельно. •
@Target – Эта annotation позволит вам указать те java элементы, к которой annotation должна быть применена. Возможные типы для применения такие: ANNOTATION_TYPE, CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER и TYPE. В нашей
@ReconField annotation для уровня FIELD. •
@Retention – Эта annotation позволит вам указать, когда annotation будет доступна. Возможные значения: CLASS, RUNTIME и SOURCE. Так How мы будет обрабатывать аннотации в RUNTIME, мы должны установить эти значения. Процесс подтверждения данных будет идти в один request к каждой базе данных, и затем отобразит результаты в общих данных, которые представляют собой все поля для определенного типа записи. Аннотация для каждого поля в общих данных сообщит процессору How совершать сравнение данных для этого определенного поля, а так же meaning, найденное в каждой базе данных. Давайте посмотрим на несколько примеров того, How эти аннотации могу быть использованы для различных конфигураций сравнения данных. Whatбы подтвердить, что meaning существует и точно соответствует в каждом источнике данных, вам всего лишь надо предоставить ID поля и ярлык, который будет отображаться в поле отчета.
1 @ReconField(id = CUSTOMER_ID, label = "Customer ID") 2 private String customerId; Whatбы отобразить найденные значения из каждого источника данных, но делать сравнения данных, вам нужно указать элемент compareSources и поставить meaning на false.
1 @ReconField(id = NAME, label = "NAME", compareSources = false) 2 private String name; Whatбы подтвердить, что meaning найдено в определенном источник данных, но не во всех, вам нужно использовать элемент
sourcesToCompare. Это отобразить все найденные значения, но сравнение любых данных в источниках данных произойдет в соответствии со списком элементов. Это для случая, если некоторые данные не сохранены во всех источниках данных.
ReconSource - это enum, в котором источники данных доступны для сравнения.
1 @ReconField(id = PRIVATE_PLACEMENT_FLAG, label = "PRIVATE PLACEMENT FLAG", sourcesToCompare ={ 2 ReconSource.LEGACY, ReconSource.PACE }) private String privatePlacementFlag; Теперь, когда мы выполнor основные требования, нам нужно выполнить сравнение более сложных данных, которые специфичный для поля. Whatбы сделать это мы создадим вторую аннотацию, которая запустит обработку правил.
1 @Target(ElementType.FIELD) 2 @Retention(RetentionPolicy.RUNTIME) 3 public @interface ReconCustomRule { 4 5 /** 6 * Значение, указывающее используемые параметры, прописанные обработчику правила, meaning по умолчанию - 7 отсутствие параметров. 8 * 9 * @return The String[] параметры, прописанные обработчику правила 10 */ 11 String[] params() default {}; 12 13 /** 14 * Значение, указывающее класс обработчика правила, которое используется для сравнения значений из 15 каждого источника данных. 16 * 17 * @return Класс обработчика правила 18 */ 19 Class processor() default DefaultReconRule.class; 20 } Очень похоже на предыдущую аннотацию, одна большая разница в том, что в
@ReconCustomRule мы указываем класс, которые запустит сравнение данных, когда запускается процесс recon. Вы можете указать только класс, который будет использован, чтобы ваш обработчик приписал meaning и инициализировал любой класс, который вы укажите. Указанный класс в данной аннотации, будет использовать интерфейс правила, который в свою очередь будет использован обработчиком для исполнения правила. Давайте посмотрим пару примеров данной аннотации. В этом примере мы используем правило, которое проверит обмен валюты не в США и в этом случае пропустит сравнение данных. Whatбы сделать это, нам надо проверить поле страны в той же записи.
1 @ReconField(id = STREET_CUSIP, label = "STREET CUSIP", compareSources = false) 2 @ReconCustomRule(processor = SkipNonUSExchangeComparisonRule.class) 3 private String streetCusip; Вот пример, в котором мы задаем параметры правила, в данном случае meaning допустимого отклонения. Для сравнения наших данных, сравниваемое meaning не может отклоняться более чем на 1,000. Используя параметр для указания значения отклонения позволит нам использовать то же правила для нескольких полей, с разным meaningм допустимого отклонения. Единственная проблема в том, что эти параметры статические и не могут быть динамическими по причине природы аннотации.
1 @ReconField(id = USD_MKT_CAP, label = "MARKET CAP USD", displayFormat = 2 ReconDisplayFormat.NUMERIC_WHOLE, sourcesToCompare = 3 { ReconSource.LEGACY, ReconSource.PACE, ReconSource.BOB_PRCM }) 4 @ReconCustomRule(processor = ToleranceAmountRule.class, params = { "10000" }) 5 private BigDecimal usdMktCap; Тавре ки шумо мебинед, мо ба раванди муқоисаи додаҳо аз пойгоҳи додаҳои гуногун бо истифода аз ду шарҳи хеле содда каме чандирӣ илова кардем. Барои ин ҳолати мушаххас, эзоҳҳо раванди муқоисаи маълумотро пеш мебаранд, то мо аслан эзоҳҳоеро, ки дар маълумоти муштарак ёфтем, арзёбӣ кунем ва онҳоро барои роҳнамоии коркард истифода барем. Хулоса Дар бораи шарҳҳо дар Java мақолаҳои зиёде мавҷуданд, ки онҳо чӣ кор мекунанд ва қоидаҳои истифодаи онҳо чӣ гунаанд. Дар ин мақола ман мехостам тавассути мисолҳо нишон диҳам, ки чаро шумо бояд онҳоро истифода баред ва чӣ гуна шумо аз он манфиат гирифта метавонед. Лутфан қайд кунед, ки ин танҳо ибтидо аст. Пас аз он ки шумо тасмим гирифтед, ки эзоҳҳо эҷод кунед, шумо бояд бифаҳмед, ки чӣ гуна онҳоро ба таври муассир истифода бурдан мумкин аст. Дар қисми 2, ман ба шумо нишон медиҳам, ки чӣ гуна шарҳҳоро бо истифода аз инъикоси Java коркард кунед. — Ҷонни Ҳакетт, asktheteam@keyholesoftware.com
мақолаи аслии http://www.javacodegeeks.com/2014/07/creating-your-own-java-annotations.html
GO TO FULL VERSION