{"id":176,"date":"2017-03-06T22:57:05","date_gmt":"2017-03-06T21:57:05","guid":{"rendered":"http:\/\/antek.atthost24.pl\/?p=176"},"modified":"2017-03-06T22:57:05","modified_gmt":"2017-03-06T21:57:05","slug":"adnotacje-w-javie","status":"publish","type":"post","link":"https:\/\/blog.lantkowiak.pl\/index.php\/2017\/03\/06\/adnotacje-w-javie\/","title":{"rendered":"Adnotacje w Javie"},"content":{"rendered":"

W Javie 1.5 zosta\u0142y wprowadzone adnotacje.\u00a0Mo\u017cemy je cz\u0119sto spotka\u0107 przy pisaniu test\u00f3w jednostkowych, ORMach lub r\u00f3\u017cnych frameworkach. Czym s\u0105 w\u0142a\u015bciwie adnotacje i co nam daj\u0105?<\/p>\n

Adnotacje s\u0105 to metadate, kt\u00f3re dostarczaj\u0105 nam informacji na temat programu, ale same nie s\u0105 cz\u0119\u015bci\u0105 kodu, ani bezpo\u015brednio nie wp\u0142ywaj\u0105 na kod.<\/p>\n

Najprostsz\u0105 adnotacje mo\u017cemy stworzy\u0107 w nast\u0119puj\u0105cy spos\u00f3b:<\/p>\n

public @interface MyAnnotation {\r\n}<\/pre>\n
Teraz mo\u017cemy u\u017cy\u0107 jej w naszym kodzie:<\/p>\n
@MyAnnotation\r\npublic class MyClass {\r\n}<\/pre>\n
Pola<\/h3>\n
Do naszych adnotacji mo\u017cemy dodawa\u0107 pola. Aby to zrobi\u0107 musimy je zdefiniowa\u0107 w ciele naszej adnotacji.<\/p>\n
public @interface MyAnnotation {\r\n\tString name();\r\n}<\/pre>\n
I samo u\u017cycie:<\/p>\n
@MyAnnotation(name = \"My name\")\r\npublic class MyClass {\r\n}<\/pre>\n
Je\u017celi nasze pole b\u0119dzie mia\u0142 nazw\u0119 value<\/em>, wtedy mo\u017cemy pomin\u0105\u0107 nazw\u0119 pola\u00a0w u\u017cyciu adnotacji.<\/p>\n
public @interface MyAnnotation {\r\n\tString value();\r\n}<\/pre>\n
@MyAnnotation(\"My name\")\r\npublic class MyClass {\r\n}<\/pre>\n
Domy\u015blne warto\u015bci\u00a0p\u00f3l<\/h4>\n
W przyk\u0142adach powy\u017cej podanie warto\u015bci zdefiniowanych p\u00f3l jest obowi\u0105zkowe. Je\u017celi chcemy, aby podanie pola nie by\u0142o wymagane musimy zdefiniowa\u0107 jego domy\u015bln\u0105 warto\u015b\u0107.<\/p>\n
public @interface MyAnnotation {\r\n\tString name() default \"My default name\";\r\n}<\/pre>\n
Wtedy przy u\u017cyciu adnotacji mo\u017cemy, ale nie musimy, podawa\u0107 warto\u015b\u0107 pola.<\/p>\n
Zakres adnotacji<\/h3>\n
Adnotacje domy\u015blnie mog\u0105 by\u0107 u\u017cywane na:<\/p>\n
    \n
  • innych adnotacjach<\/li>\n
  • konstruktorach<\/li>\n
  • metodach<\/li>\n
  • polach<\/li>\n
  • lokalnych zmiennych<\/li>\n
  • pakietach<\/li>\n
  • parametrach metod<\/li>\n
  • klasach, interfejsach, enumach<\/li>\n
  • typach generycznych (od Java 8)<\/li>\n<\/ul>\n
    Domy\u015blnie nowo stworzona adnotacja mo\u017ce by\u0107 u\u017cywana w ka\u017cdym z \u00a0wymienionych wcze\u015bniej miejsc. Mo\u017cemy jednak ograniczy\u0107 jej zasi\u0119g poprzez u\u017cycie adnotacji @Target<\/em>\u00a0z parametrami definiuj\u0105cymi zasi\u0119g.<\/p>\n
    @Target({ElementType.FIELD})\r\npublic @interface MyAnnotation {\r\n\tString name() default \"My default name\";\r\n}<\/pre>\n
    Wszystkie dost\u0119pne warto\u015bci ElementType<\/em> to:<\/p>\n
      \n
    • ANNOTATION_TYPE<\/li>\n
    • CONSTRUCTOR<\/li>\n
    • METHOD<\/li>\n
    • FIELD<\/li>\n
    • LOCAL_VARIABLE<\/li>\n
    • PACKAGE<\/li>\n
    • PARAMETER<\/li>\n
    • TYPE<\/li>\n
    • TYPE_PARAMETER<\/li>\n<\/ul>\n
      Kolejne wymienione warto\u015bci ElementType<\/em> odpowiadaj\u0105 wcze\u015bniej wymienionym miejscom opisuj\u0105cym gdzie mo\u017cna u\u017cy\u0107 adnotacji.<\/p>\n
      Dodatkowo w Javie 8 wprowadzono ElementType.TYPE_USE<\/em>, kt\u00f3ry mo\u017ce by\u0107 u\u017cyty na wszystkich typach.<\/p>\n
      Retencja adnotacji<\/h3>\n
      Dla ka\u017cdej adnotacji mo\u017cemy ustali\u0107 jej zakres widoczno\u015bci. Definiujemy to przez dodanie adnotacji @Retention<\/em>.<\/p>\n
      @Retention(RetentionPolicy.CLASS)\r\npublic @interface MyAnnotation {\r\n}<\/pre>\n
      Dost\u0119pne s\u0105 trzy warto\u015bci dla adnotacji @Retention<\/em>:<\/p>\n
        \n
      • RetentionPolicy.SOURCE – informacja o adnotacji jest dost\u0119pna jedynie podczas kompilacji; przyk\u0142adami takich adnotacji s\u0105 @Override<\/em> i @SuppressWarnings<\/em><\/li>\n
      • RetentionPolicy.CLASS – adnotacja jest dost\u0119pna podczas \u0142adowania klas; jest to domy\u015blny poziom retencji<\/li>\n
      • RetentionPolicy.RUNTIME – adnotacja jest dost\u0119pna podczas dzia\u0142ania aplikacji, dzi\u0119ki czemu mamy do niej dost\u0119p poprzez refleksje; przyk\u0142adem takiej adnotacji jest @Deprecated<\/em><\/li>\n<\/ul>\n
        Kr\u00f3tkie podsumowanie<\/h3>\n
        W wpisie przedstawi\u0142em najwa\u017cniejsze informacje na temat adnotacji w Javie. Mam nadziej\u0119, \u017ce oka\u017c\u0105 si\u0119 one przydatne i cho\u0107 troch\u0119 u\u0142atwi\u0105 poruszanie si\u0119 po frameworkach, kt\u00f3re pe\u0142ne s\u0105 najr\u00f3\u017cniejszych adnotacji \ud83d\ude42<\/p>\n","protected":false},"excerpt":{"rendered":"
        W Javie 1.5 zosta\u0142y wprowadzone adnotacje.\u00a0Mo\u017cemy je cz\u0119sto spotka\u0107 przy pisaniu test\u00f3w jednostkowych, ORMach lub r\u00f3\u017cnych frameworkach. Czym s\u0105 w\u0142a\u015bciwie adnotacje i co nam daj\u0105? Adnotacje s\u0105 to…<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[12,7],"tags":[15,8],"class_list":["post-176","post","type-post","status-publish","format-standard","hentry","category-dsp2017","category-java","tag-adnotacje","tag-java"],"yoast_head":"\nAdnotacje w Javie - Lukasz Antkowiak's blog<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/blog.lantkowiak.pl\/index.php\/2017\/03\/06\/adnotacje-w-javie\/\" \/>\n<meta property=\"og:locale\" content=\"pl_PL\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Adnotacje w Javie - Lukasz Antkowiak's blog\" \/>\n<meta property=\"og:description\" content=\"W Javie 1.5 zosta\u0142y wprowadzone adnotacje.\u00a0Mo\u017cemy je cz\u0119sto spotka\u0107 przy pisaniu test\u00f3w jednostkowych, ORMach lub r\u00f3\u017cnych frameworkach. Czym s\u0105 w\u0142a\u015bciwie adnotacje i co nam daj\u0105? Adnotacje s\u0105 to...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/blog.lantkowiak.pl\/index.php\/2017\/03\/06\/adnotacje-w-javie\/\" \/>\n<meta property=\"og:site_name\" content=\"Lukasz Antkowiak's blog\" \/>\n<meta property=\"article:published_time\" content=\"2017-03-06T21:57:05+00:00\" \/>\n<meta name=\"author\" content=\"\u0141ukasz Antkowiak\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Napisane przez\" \/>\n\t<meta name=\"twitter:data1\" content=\"\u0141ukasz Antkowiak\" \/>\n\t<meta name=\"twitter:label2\" content=\"Szacowany czas czytania\" \/>\n\t<meta name=\"twitter:data2\" content=\"2 minuty\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/blog.lantkowiak.pl\/index.php\/2017\/03\/06\/adnotacje-w-javie\/\",\"url\":\"https:\/\/blog.lantkowiak.pl\/index.php\/2017\/03\/06\/adnotacje-w-javie\/\",\"name\":\"Adnotacje w Javie - Lukasz Antkowiak's blog\",\"isPartOf\":{\"@id\":\"https:\/\/blog.lantkowiak.pl\/#website\"},\"datePublished\":\"2017-03-06T21:57:05+00:00\",\"dateModified\":\"2017-03-06T21:57:05+00:00\",\"author\":{\"@id\":\"https:\/\/blog.lantkowiak.pl\/#\/schema\/person\/009bfc4db220c225786c59b1748ba1e6\"},\"breadcrumb\":{\"@id\":\"https:\/\/blog.lantkowiak.pl\/index.php\/2017\/03\/06\/adnotacje-w-javie\/#breadcrumb\"},\"inLanguage\":\"pl-PL\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/blog.lantkowiak.pl\/index.php\/2017\/03\/06\/adnotacje-w-javie\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/blog.lantkowiak.pl\/index.php\/2017\/03\/06\/adnotacje-w-javie\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Strona g\u0142\u00f3wna\",\"item\":\"https:\/\/blog.lantkowiak.pl\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Adnotacje w Javie\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/blog.lantkowiak.pl\/#website\",\"url\":\"https:\/\/blog.lantkowiak.pl\/\",\"name\":\"Lukasz Antkowiak's blog\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/blog.lantkowiak.pl\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"pl-PL\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/blog.lantkowiak.pl\/#\/schema\/person\/009bfc4db220c225786c59b1748ba1e6\",\"name\":\"\u0141ukasz Antkowiak\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"pl-PL\",\"@id\":\"https:\/\/blog.lantkowiak.pl\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/e18e2bfe319da9b5757cf7f7ae1bfecf?s=96&d=monsterid&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/e18e2bfe319da9b5757cf7f7ae1bfecf?s=96&d=monsterid&r=g\",\"caption\":\"\u0141ukasz Antkowiak\"},\"description\":\"dd\",\"url\":\"https:\/\/blog.lantkowiak.pl\/index.php\/author\/antek\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Adnotacje w Javie - Lukasz Antkowiak's blog","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/blog.lantkowiak.pl\/index.php\/2017\/03\/06\/adnotacje-w-javie\/","og_locale":"pl_PL","og_type":"article","og_title":"Adnotacje w Javie - Lukasz Antkowiak's blog","og_description":"W Javie 1.5 zosta\u0142y wprowadzone adnotacje.\u00a0Mo\u017cemy je cz\u0119sto spotka\u0107 przy pisaniu test\u00f3w jednostkowych, ORMach lub r\u00f3\u017cnych frameworkach. Czym s\u0105 w\u0142a\u015bciwie adnotacje i co nam daj\u0105? Adnotacje s\u0105 to...","og_url":"https:\/\/blog.lantkowiak.pl\/index.php\/2017\/03\/06\/adnotacje-w-javie\/","og_site_name":"Lukasz Antkowiak's blog","article_published_time":"2017-03-06T21:57:05+00:00","author":"\u0141ukasz Antkowiak","twitter_card":"summary_large_image","twitter_misc":{"Napisane przez":"\u0141ukasz Antkowiak","Szacowany czas czytania":"2 minuty"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/blog.lantkowiak.pl\/index.php\/2017\/03\/06\/adnotacje-w-javie\/","url":"https:\/\/blog.lantkowiak.pl\/index.php\/2017\/03\/06\/adnotacje-w-javie\/","name":"Adnotacje w Javie - Lukasz Antkowiak's blog","isPartOf":{"@id":"https:\/\/blog.lantkowiak.pl\/#website"},"datePublished":"2017-03-06T21:57:05+00:00","dateModified":"2017-03-06T21:57:05+00:00","author":{"@id":"https:\/\/blog.lantkowiak.pl\/#\/schema\/person\/009bfc4db220c225786c59b1748ba1e6"},"breadcrumb":{"@id":"https:\/\/blog.lantkowiak.pl\/index.php\/2017\/03\/06\/adnotacje-w-javie\/#breadcrumb"},"inLanguage":"pl-PL","potentialAction":[{"@type":"ReadAction","target":["https:\/\/blog.lantkowiak.pl\/index.php\/2017\/03\/06\/adnotacje-w-javie\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/blog.lantkowiak.pl\/index.php\/2017\/03\/06\/adnotacje-w-javie\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Strona g\u0142\u00f3wna","item":"https:\/\/blog.lantkowiak.pl\/"},{"@type":"ListItem","position":2,"name":"Adnotacje w Javie"}]},{"@type":"WebSite","@id":"https:\/\/blog.lantkowiak.pl\/#website","url":"https:\/\/blog.lantkowiak.pl\/","name":"Lukasz Antkowiak's blog","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/blog.lantkowiak.pl\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"pl-PL"},{"@type":"Person","@id":"https:\/\/blog.lantkowiak.pl\/#\/schema\/person\/009bfc4db220c225786c59b1748ba1e6","name":"\u0141ukasz Antkowiak","image":{"@type":"ImageObject","inLanguage":"pl-PL","@id":"https:\/\/blog.lantkowiak.pl\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/e18e2bfe319da9b5757cf7f7ae1bfecf?s=96&d=monsterid&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/e18e2bfe319da9b5757cf7f7ae1bfecf?s=96&d=monsterid&r=g","caption":"\u0141ukasz Antkowiak"},"description":"dd","url":"https:\/\/blog.lantkowiak.pl\/index.php\/author\/antek\/"}]}},"_links":{"self":[{"href":"https:\/\/blog.lantkowiak.pl\/index.php\/wp-json\/wp\/v2\/posts\/176","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.lantkowiak.pl\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.lantkowiak.pl\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.lantkowiak.pl\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.lantkowiak.pl\/index.php\/wp-json\/wp\/v2\/comments?post=176"}],"version-history":[{"count":8,"href":"https:\/\/blog.lantkowiak.pl\/index.php\/wp-json\/wp\/v2\/posts\/176\/revisions"}],"predecessor-version":[{"id":193,"href":"https:\/\/blog.lantkowiak.pl\/index.php\/wp-json\/wp\/v2\/posts\/176\/revisions\/193"}],"wp:attachment":[{"href":"https:\/\/blog.lantkowiak.pl\/index.php\/wp-json\/wp\/v2\/media?parent=176"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.lantkowiak.pl\/index.php\/wp-json\/wp\/v2\/categories?post=176"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.lantkowiak.pl\/index.php\/wp-json\/wp\/v2\/tags?post=176"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}