{"id":1222,"date":"2012-02-01T14:59:00","date_gmt":"2012-02-01T12:59:00","guid":{"rendered":"http:\/\/www.tutego.de\/blog\/javainsel\/?p=1222"},"modified":"2012-02-01T14:59:00","modified_gmt":"2012-02-01T12:59:00","slug":"erster-draft-fr-annotations-on-java-types-jsr-308","status":"publish","type":"post","link":"https:\/\/www.tutego.de\/blog\/javainsel\/2012\/02\/erster-draft-fr-annotations-on-java-types-jsr-308\/","title":{"rendered":"Erster Draft für “Annotations on Java Types” (JSR-308)"},"content":{"rendered":"

http:\/\/jcp.org\/aboutJava\/communityprocess\/edr\/jsr308\/index2.html<\/a>. Aus der Spezi:<\/p>\n

\n

JSR 308 extends Java to allow annotations on any use of a type, and on type parameter declarations.<\/p>\n

Beispiele:<\/p>\n

for generic type arguments to parameterized classes:
Map<@NonNull String, @NonEmpty List<@Readonly Document>> files;
for generic type arguments in a generic method or constructor invocation:
o.<@NonNull String>m("…");
for type parameter bounds, including wildcard bounds:
class Folder<F extends @Existing File> { … }
Collection<? super @Existing File>
for class inheritance:
class UnmodifiableList<T> implements @Readonly List<@Readonly T> { … }
for throws clauses:
void monitorTemperature() throws @Critical TemperatureException { … }
for typecasts:
myString = (@NonNull String) myObject;
It is not permitted to omit the Java type, as in myString = (@NonNull) myObject;.
for constructor invocation results (that is, for object creation):
new @Interned MyObject()
new @NonEmpty @Readonly List<String>(myNonEmptyStringSet)
myVar . new @Tainted NestedClass
For generic constructors (JLS \u00a78.8.4), the annotation follows the explicit type arguments (JLS \u00a715.9):
new <String> @Interned MyObject()
for type tests:
boolean isNonNull = myString instanceof @NonNull String;
It is not permitted to omit the Java type, as in myString instanceof @NonNull.<\/p>\n<\/blockquote>\n

Damit einher geht eine krasse \u00c4nderung, das bei Objektmethoden einfach so ein this \u00dcbergeben werden kann.<\/p>\n

\n

It is permitted to explicitly declare the method receiver as the \ufb01rst formal parameter<\/p>\n

As an example, here are the standard de\ufb01nitions for toString and equals:
class MyClass {
…
public String toString() { … }
public boolean equals(Object other) { … }
}
It is equivalent to write instead
class MyClass {
…
public String toString(MyClass this) { … }
public boolean equals(MyClass this, Object other) { … }
}
and then it would be possible to annotate the receiver\u2019s type:
class MyClass {
…
public String toString(@Readonly MyClass this) { … }
public boolean equals(@Readonly MyClass this, @Readonly Object other) { … }
}<\/p>\n<\/blockquote>\n

Interessant finde ich noch:<\/p>\n

\n

To ease the transition from standard Java SE 7 code to code with type annotations, the reference implementation
recognizes the type annotations when surrounded by comment markers:
List<\/*@Readonly*\/ Object> myList;
This permits use of both standard Java SE 7 tools and the new annotations even before Java SE 8 is released<\/p>\n<\/blockquote>\n","protected":false},"excerpt":{"rendered":"

http:\/\/jcp.org\/aboutJava\/communityprocess\/edr\/jsr308\/index2.html. Aus der Spezi: JSR 308 extends Java to allow annotations on any use of a type, and on type parameter declarations. Beispiele: for generic type arguments to parameterized classes: Map<@NonNull String, @NonEmpty List<@Readonly Document>> files; for generic type arguments in a generic method or constructor invocation: o.<@NonNull String>m("…"); for type parameter bounds, including wildcard […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":"","_links_to":"","_links_to_target":""},"categories":[66],"tags":[],"class_list":["post-1222","post","type-post","status-publish","format-standard","hentry","category-java-8"],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/posts\/1222","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/comments?post=1222"}],"version-history":[{"count":1,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/posts\/1222\/revisions"}],"predecessor-version":[{"id":1223,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/posts\/1222\/revisions\/1223"}],"wp:attachment":[{"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/media?parent=1222"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/categories?post=1222"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/tags?post=1222"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}