From ebbc41255384e85db03c4eb6aae4e6464803d0a9 Mon Sep 17 00:00:00 2001 From: Alexander Kriegisch Date: Tue, 29 Jun 2021 13:18:25 +0700 Subject: [PATCH] Add initial set of AsciiDoc files, converted from HTML/XML Some originals have been deleted already. Others, especially the user guides, still exist in both formats because they have not been proof-read and probably lots of links do not function as expected. But I want to see what the files look like directly on GitHun. Signed-off-by: Alexander Kriegisch --- docs/adk15ProgGuideDB/adk15notebook.adoc | 41 + docs/adk15ProgGuideDB/annotations.adoc | 839 + docs/adk15ProgGuideDB/ataspectj.adoc | 868 + docs/adk15ProgGuideDB/autoboxing.adoc | 78 + docs/adk15ProgGuideDB/covariance.adoc | 82 + docs/adk15ProgGuideDB/enumeratedtypes.adoc | 50 + docs/adk15ProgGuideDB/generics.adoc | 1041 + docs/adk15ProgGuideDB/grammar.adoc | 186 + .../adk15ProgGuideDB/joinpointsignatures.adoc | 336 + docs/adk15ProgGuideDB/ltw.adoc | 8 + docs/adk15ProgGuideDB/miscellaneous.adoc | 66 + docs/adk15ProgGuideDB/pertypewithin.adoc | 87 + docs/adk15ProgGuideDB/reflection.adoc | 19 + docs/adk15ProgGuideDB/varargs.adoc | 141 + docs/devGuideDB/aj.adoc | 37 + docs/devGuideDB/ajbrowser.adoc | 221 + docs/devGuideDB/ajc.adoc | 492 + docs/devGuideDB/ajdb.adoc | 326 + docs/devGuideDB/ajdee.adoc | 244 + docs/devGuideDB/ajdeforte.adoc | 100 + docs/devGuideDB/ajdejbuilder.adoc | 148 + docs/devGuideDB/ajdoc.adoc | 60 + docs/devGuideDB/antsupport.adoc | 864 + docs/devGuideDB/aspectj-mode.adoc | 179 + docs/devGuideDB/compatibility.adoc | 112 + docs/devGuideDB/devguide.adoc | 33 + docs/devGuideDB/devguide.pdf | 43689 ++++++++++++++++ docs/devGuideDB/ltw.adoc | 472 + docs/devGuideDB/tools-intro.adoc | 127 + docs/developer/ajdt/ajdt.core.workitems.adoc | 248 + docs/developer/ajdt/ajdt.core.workitems.txt | 255 - ...amcDesignNotes.txt => amcDesignNotes.adoc} | 141 +- docs/developer/build/cruisecontrol.html | 6 - docs/developer/compiler-weaver/index.adoc | 1141 + docs/developer/compiler-weaver/index.html | 917 - docs/developer/index.adoc | 24 + docs/developer/index.html | 176 - docs/developer/language.adoc | 81 + docs/developer/language.html | 220 - docs/developer/modules.adoc | 108 + docs/developer/modules.html | 565 - docs/dist/LICENSE-AspectJ.adoc | 83 + docs/dist/README-AspectJ.adoc | 155 + docs/dist/doc/README-11.adoc | 1330 + docs/dist/doc/README-12.adoc | 563 + docs/dist/doc/README-121.adoc | 134 + docs/dist/doc/README-150.adoc | 21 + docs/dist/doc/README-151.adoc | 22 + docs/dist/doc/README-152.adoc | 30 + docs/dist/doc/README-153.adoc | 121 + docs/dist/doc/README-154.adoc | 16 + docs/dist/doc/README-160.adoc | 165 + docs/dist/doc/README-161.adoc | 178 + docs/dist/doc/README-1610.adoc | 47 + docs/dist/doc/README-1611.adoc | 106 + docs/dist/doc/README-1612.adoc | 241 + docs/dist/doc/README-162.adoc | 84 + docs/dist/doc/README-163.adoc | 90 + docs/dist/doc/README-164.adoc | 256 + docs/dist/doc/README-165.adoc | 15 + docs/dist/doc/README-166.adoc | 65 + docs/dist/doc/README-167.adoc | 183 + docs/dist/doc/README-168.adoc | 89 + docs/dist/doc/README-169.adoc | 299 + docs/dist/doc/README-170.adoc | 118 + docs/dist/doc/README-171.adoc | 36 + docs/dist/doc/README-172.adoc | 25 + docs/dist/doc/README-173.adoc | 10 + docs/dist/doc/README-174.adoc | 34 + docs/dist/doc/README-180.adoc | 71 + docs/dist/doc/README-181.adoc | 18 + docs/dist/doc/README-1810.adoc | 39 + docs/dist/doc/README-1811.adoc | 19 + docs/dist/doc/README-182.adoc | 171 + docs/dist/doc/README-183.adoc | 116 + docs/dist/doc/README-184.adoc | 31 + docs/dist/doc/README-185.adoc | 16 + docs/dist/doc/README-186.adoc | 10 + docs/dist/doc/README-187.adoc | 134 + docs/dist/doc/README-188.adoc | 19 + docs/dist/doc/README-189.adoc | 15 + docs/dist/doc/README-190.adoc | 339 + docs/dist/doc/README-191.adoc | 35 + docs/dist/doc/README-192.adoc | 18 + docs/dist/doc/README-193.adoc | 77 + docs/dist/doc/README-194.adoc | 29 + docs/dist/doc/README-195.adoc | 59 + docs/dist/doc/README-196.adoc | 57 + docs/dist/doc/README-197.adoc | 109 + docs/dist/doc/changes.adoc | 1538 + docs/dist/doc/examples/spacewar/README.adoc | 54 + docs/dist/doc/examples/spacewar/README.html | 82 - docs/dist/doc/index.adoc | 231 + docs/dist/doc/porting.adoc | 1868 + docs/faq/faq.adoc | 3455 ++ docs/faq/faq.xml | 6 +- docs/jdk15-packages.txt | 166 - docs/pdGuideDB/ajcore.adoc | 161 + docs/pdGuideDB/ltwdump.adoc | 63 + docs/pdGuideDB/messages.adoc | 199 + docs/pdGuideDB/pointcuts.adoc | 113 + docs/pdGuideDB/trace.adoc | 155 + docs/progGuideDB/examples.adoc | 1876 + docs/progGuideDB/examples.xml | 12 +- docs/progGuideDB/gettingstarted.adoc | 952 + docs/progGuideDB/gettingstarted.xml | 8 +- docs/progGuideDB/idioms.adoc | 63 + docs/progGuideDB/implementation.adoc | 260 + docs/progGuideDB/language.adoc | 910 + docs/progGuideDB/pitfalls.adoc | 86 + docs/progGuideDB/preface.adoc | 35 + docs/progGuideDB/progguide.adoc | 37 + docs/progGuideDB/progguide.html.xsl.adoc | 1 + docs/progGuideDB/quickreference.adoc | 372 + docs/progGuideDB/semantics.adoc | 2618 + docs/readme-docs-module.adoc | 117 + docs/readme-docs-module.html | 148 - docs/sandbox/api-clients/readme.html | 0 docs/sandbox/readme-sandbox.adoc | 163 + docs/sandbox/readme-sandbox.html | 228 - docs/sandbox/trails/debugging.adoc | 40 + docs/sandbox/trails/debugging.html | 67 - docs/sandbox/trails/j2ee.adoc | 58 + docs/sandbox/trails/j2ee.html | 82 - docs/sandbox/trails/links.adoc | 39 + docs/sandbox/trails/links.html | 90 - docs/sandbox/trails/myeclipseide.adoc | 57 + docs/sandbox/trails/myeclipseide.html | 87 - .../docs/{readme.txt => readme.adoc} | 56 +- .../ubc-design-patterns/docs/readme.pdf | Bin 13954 -> 0 bytes .../ubc-design-patterns/patterns-readme.adoc | 23 + .../ubc-design-patterns/patterns-readme.html | 40 - docs/teaching/exercises/plugins/index.adoc | 19 + 133 files changed, 74122 insertions(+), 3239 deletions(-) create mode 100644 docs/adk15ProgGuideDB/adk15notebook.adoc create mode 100644 docs/adk15ProgGuideDB/annotations.adoc create mode 100644 docs/adk15ProgGuideDB/ataspectj.adoc create mode 100644 docs/adk15ProgGuideDB/autoboxing.adoc create mode 100644 docs/adk15ProgGuideDB/covariance.adoc create mode 100644 docs/adk15ProgGuideDB/enumeratedtypes.adoc create mode 100644 docs/adk15ProgGuideDB/generics.adoc create mode 100644 docs/adk15ProgGuideDB/grammar.adoc create mode 100644 docs/adk15ProgGuideDB/joinpointsignatures.adoc create mode 100644 docs/adk15ProgGuideDB/ltw.adoc create mode 100644 docs/adk15ProgGuideDB/miscellaneous.adoc create mode 100644 docs/adk15ProgGuideDB/pertypewithin.adoc create mode 100644 docs/adk15ProgGuideDB/reflection.adoc create mode 100644 docs/adk15ProgGuideDB/varargs.adoc create mode 100644 docs/devGuideDB/aj.adoc create mode 100644 docs/devGuideDB/ajbrowser.adoc create mode 100644 docs/devGuideDB/ajc.adoc create mode 100644 docs/devGuideDB/ajdb.adoc create mode 100644 docs/devGuideDB/ajdee.adoc create mode 100644 docs/devGuideDB/ajdeforte.adoc create mode 100644 docs/devGuideDB/ajdejbuilder.adoc create mode 100644 docs/devGuideDB/ajdoc.adoc create mode 100644 docs/devGuideDB/antsupport.adoc create mode 100644 docs/devGuideDB/aspectj-mode.adoc create mode 100644 docs/devGuideDB/compatibility.adoc create mode 100644 docs/devGuideDB/devguide.adoc create mode 100644 docs/devGuideDB/devguide.pdf create mode 100644 docs/devGuideDB/ltw.adoc create mode 100644 docs/devGuideDB/tools-intro.adoc create mode 100644 docs/developer/ajdt/ajdt.core.workitems.adoc delete mode 100644 docs/developer/ajdt/ajdt.core.workitems.txt rename docs/developer/{amcDesignNotes.txt => amcDesignNotes.adoc} (79%) delete mode 100644 docs/developer/build/cruisecontrol.html create mode 100644 docs/developer/compiler-weaver/index.adoc delete mode 100644 docs/developer/compiler-weaver/index.html create mode 100644 docs/developer/index.adoc delete mode 100644 docs/developer/index.html create mode 100644 docs/developer/language.adoc delete mode 100644 docs/developer/language.html create mode 100644 docs/developer/modules.adoc delete mode 100644 docs/developer/modules.html create mode 100644 docs/dist/LICENSE-AspectJ.adoc create mode 100644 docs/dist/README-AspectJ.adoc create mode 100644 docs/dist/doc/README-11.adoc create mode 100644 docs/dist/doc/README-12.adoc create mode 100644 docs/dist/doc/README-121.adoc create mode 100644 docs/dist/doc/README-150.adoc create mode 100644 docs/dist/doc/README-151.adoc create mode 100644 docs/dist/doc/README-152.adoc create mode 100644 docs/dist/doc/README-153.adoc create mode 100644 docs/dist/doc/README-154.adoc create mode 100644 docs/dist/doc/README-160.adoc create mode 100644 docs/dist/doc/README-161.adoc create mode 100644 docs/dist/doc/README-1610.adoc create mode 100644 docs/dist/doc/README-1611.adoc create mode 100644 docs/dist/doc/README-1612.adoc create mode 100644 docs/dist/doc/README-162.adoc create mode 100644 docs/dist/doc/README-163.adoc create mode 100644 docs/dist/doc/README-164.adoc create mode 100644 docs/dist/doc/README-165.adoc create mode 100644 docs/dist/doc/README-166.adoc create mode 100644 docs/dist/doc/README-167.adoc create mode 100644 docs/dist/doc/README-168.adoc create mode 100644 docs/dist/doc/README-169.adoc create mode 100644 docs/dist/doc/README-170.adoc create mode 100644 docs/dist/doc/README-171.adoc create mode 100644 docs/dist/doc/README-172.adoc create mode 100644 docs/dist/doc/README-173.adoc create mode 100644 docs/dist/doc/README-174.adoc create mode 100644 docs/dist/doc/README-180.adoc create mode 100644 docs/dist/doc/README-181.adoc create mode 100644 docs/dist/doc/README-1810.adoc create mode 100644 docs/dist/doc/README-1811.adoc create mode 100644 docs/dist/doc/README-182.adoc create mode 100644 docs/dist/doc/README-183.adoc create mode 100644 docs/dist/doc/README-184.adoc create mode 100644 docs/dist/doc/README-185.adoc create mode 100644 docs/dist/doc/README-186.adoc create mode 100644 docs/dist/doc/README-187.adoc create mode 100644 docs/dist/doc/README-188.adoc create mode 100644 docs/dist/doc/README-189.adoc create mode 100644 docs/dist/doc/README-190.adoc create mode 100644 docs/dist/doc/README-191.adoc create mode 100644 docs/dist/doc/README-192.adoc create mode 100644 docs/dist/doc/README-193.adoc create mode 100644 docs/dist/doc/README-194.adoc create mode 100644 docs/dist/doc/README-195.adoc create mode 100644 docs/dist/doc/README-196.adoc create mode 100644 docs/dist/doc/README-197.adoc create mode 100644 docs/dist/doc/changes.adoc create mode 100644 docs/dist/doc/examples/spacewar/README.adoc delete mode 100644 docs/dist/doc/examples/spacewar/README.html create mode 100644 docs/dist/doc/index.adoc create mode 100644 docs/dist/doc/porting.adoc create mode 100644 docs/faq/faq.adoc delete mode 100644 docs/jdk15-packages.txt create mode 100644 docs/pdGuideDB/ajcore.adoc create mode 100644 docs/pdGuideDB/ltwdump.adoc create mode 100644 docs/pdGuideDB/messages.adoc create mode 100644 docs/pdGuideDB/pointcuts.adoc create mode 100644 docs/pdGuideDB/trace.adoc create mode 100644 docs/progGuideDB/examples.adoc create mode 100644 docs/progGuideDB/gettingstarted.adoc create mode 100644 docs/progGuideDB/idioms.adoc create mode 100644 docs/progGuideDB/implementation.adoc create mode 100644 docs/progGuideDB/language.adoc create mode 100644 docs/progGuideDB/pitfalls.adoc create mode 100644 docs/progGuideDB/preface.adoc create mode 100644 docs/progGuideDB/progguide.adoc create mode 100644 docs/progGuideDB/progguide.html.xsl.adoc create mode 100644 docs/progGuideDB/quickreference.adoc create mode 100644 docs/progGuideDB/semantics.adoc create mode 100644 docs/readme-docs-module.adoc delete mode 100644 docs/readme-docs-module.html delete mode 100644 docs/sandbox/api-clients/readme.html create mode 100644 docs/sandbox/readme-sandbox.adoc delete mode 100644 docs/sandbox/readme-sandbox.html create mode 100644 docs/sandbox/trails/debugging.adoc delete mode 100644 docs/sandbox/trails/debugging.html create mode 100644 docs/sandbox/trails/j2ee.adoc delete mode 100644 docs/sandbox/trails/j2ee.html create mode 100644 docs/sandbox/trails/links.adoc delete mode 100644 docs/sandbox/trails/links.html create mode 100644 docs/sandbox/trails/myeclipseide.adoc delete mode 100644 docs/sandbox/trails/myeclipseide.html rename docs/sandbox/ubc-design-patterns/docs/{readme.txt => readme.adoc} (56%) delete mode 100644 docs/sandbox/ubc-design-patterns/docs/readme.pdf create mode 100644 docs/sandbox/ubc-design-patterns/patterns-readme.adoc delete mode 100644 docs/sandbox/ubc-design-patterns/patterns-readme.html create mode 100644 docs/teaching/exercises/plugins/index.adoc diff --git a/docs/adk15ProgGuideDB/adk15notebook.adoc b/docs/adk15ProgGuideDB/adk15notebook.adoc new file mode 100644 index 000000000..bd7ed20b2 --- /dev/null +++ b/docs/adk15ProgGuideDB/adk15notebook.adoc @@ -0,0 +1,41 @@ += The AspectJ^TM^ 5 Development Kit Developer's Notebook + +:doctype: book + +_by the AspectJ Team_ + +_Copyright (c) 2004, 2005 Contributors. All rights reserved._ + +This guide describes the changes to the AspectJ language in AspectJ 5. These include support for Java 5 features, +support for an annotation-based development style for aspects and new reflection and tools APIs. If you are new to +AspectJ, we recommend you start by reading the programming guide. + +//// +ATTENTION: Please do not remove blank lines in between 'include::' statements. Otherwise, section numbers in the +table of contents (TOC) can be wrong and the first section of each document missing completely. +//// +include::joinpointsignatures.adoc[] + +include::annotations.adoc[] + +include::generics.adoc[] + +include::autoboxing.adoc[] + +include::covariance.adoc[] + +include::varargs.adoc[] + +include::enumeratedtypes.adoc[] + +include::pertypewithin.adoc[] + +include::ataspectj.adoc[] + +include::reflection.adoc[] + +include::miscellaneous.adoc[] + +include::ltw.adoc[] + +include::grammar.adoc[] diff --git a/docs/adk15ProgGuideDB/annotations.adoc b/docs/adk15ProgGuideDB/annotations.adoc new file mode 100644 index 000000000..795860a42 --- /dev/null +++ b/docs/adk15ProgGuideDB/annotations.adoc @@ -0,0 +1,839 @@ +== Annotations + +[[annotations-inJava5]] +=== Annotations in Java 5 + +This section provides the essential information about annotations in +Java 5 needed to understand how annotations are treated in AspectJ 5. +For a full introduction to annotations in Java, please see the +documentation for the Java 5 SDK. + +==== Using Annotations + +Java 5 introduces _annotation types_ which can be used to express +metadata relating to program members in the form of _annotations_. +Annotations in Java 5 can be applied to package and type declarations +(classes, interfaces, enums, and annotations), constructors, methods, +fields, parameters, and variables. Annotations are specified in the +program source by using the `@` symbol. For example, the following piece +of code uses the `@Deprecated` annotation to indicate that the +`obsoleteMethod()` has been deprecated: + +.... +@Deprecated +public void obsoleteMethod() { ... } + +.... + +Annotations may be _marker annotations_, _single-valued annotations_, or +_multi-valued annotations_. Annotation types with no members or that +provide default values for all members may be used simply as marker +annotations, as in the deprecation example above. Single-value +annotation types have a single member, and the annotation may be written +in one of two equivalent forms: + +.... +@SuppressWarnings({"unchecked"}) +public void someMethod() {...} + +.... + +or + +.... +@SuppressWarnings(value={"unchecked"}) +public void someMethod() {...} + +.... + +Multi-value annotations must use the `member-name=value + ` syntax to specify annotation values. For example: + +.... +@Authenticated(role="supervisor",clearanceLevel=5) +public void someMethod() {...} + +.... + +==== Retention Policies + +Annotations can have one of three retention policies: + +Source-file retention:: + Annotations with source-file retention are read by the compiler during + the compilation process, but are not rendered in the generated + `.class` files. +Class-file retention:: + This is the default retention policy. Annotations with class-file + retention are read by the compiler and also retained in the generated + ` + .class` files. +Runtime retention:: + Annotations with runtime retention are read by the compiler, retained + in the generated ` + .class` files, and also made available at + runtime. + +Local variable annotations are not retained in class files (or at +runtime) regardless of the retention policy set on the annotation type. +See JLS 9.6.1.2. + +==== Accessing Annotations at Runtime + +Java 5 supports a new interface, `java.lang.reflect.AnnotatedElement`, +that is implemented by the reflection classes in Java (`Class`, +`Constructor`, `Field`, `Method`, and `Package`). This interface gives +you access to annotations _that have runtime retention_ via the +`getAnnotation`, `getAnnotations`, and `isAnnotationPresent`. Because +annotation types are just regular Java classes, the annotations returned +by these methods can be queried just like any regular Java object. + +==== Annotation Inheritance + +It is important to understand the rules relating to inheritance of +annotations, as these have a bearing on join point matching based on the +presence or absence of annotations. + +By default annotations are _not_ inherited. Given the following program + +.... +@MyAnnotation +class Super { + @Oneway public void foo() {} +} + +class Sub extends Super { + public void foo() {} +} + +.... + +Then `Sub` _does not_ have the `MyAnnotation` annotation, and +`Sub.foo()` is not an `@Oneway` method, despite the fact that it +overrides `Super.foo()` which is. + +If an annotation type has the meta-annotation `@Inherited` then an +annotation of that type on a _class_ will cause the annotation to be +inherited by sub-classes. So, in the example above, if the +`MyAnnotation` type had the `@Inherited` attribute, then `Sub` would +have the `MyAnnotation` annotation. + +`@Inherited` annotations are not inherited when used to annotate +anything other than a type. A type that implements one or more +interfaces never inherits any annotations from the interfaces it +implements. + +[[annotations-aspectmembers]] +=== Annotating Aspects + +AspectJ 5 supports annotations on aspects, and on method, field, +constructor, advice, and inter-type declarations within aspects. Method +and advice parameters may also be annotated. Annotations are not +permitted on pointcut declarations or on `declare` statements. + +The following example illustrates the use of annotations in aspects: + +.... +@AspectAnnotation +public abstract aspect ObserverProtocol { + + @InterfaceAnnotation + interface Observer {} + + @InterfaceAnnotation + interface Subject {} + + @ITDFieldAnnotation + private List Subject.observers; + + @ITDMethodAnnotation + public void Subject.addObserver(Observer o) { + observers.add(o); + } + + @ITDMethodAnnotation + public void Subject.removeObserver(Observer o) { + observers.remove(o); + } + + @MethodAnnotation + private void notifyObservers(Subject subject) { + for(Observer o : subject.observers) + notifyObserver(o,subject); + } + + /** + * Delegate to concrete sub-aspect the actual form of + * notification for a given type of Observer. + */ + @MethodAnnotation + protected abstract void notifyObserver(Observer o, Subject s); + + /* no annotations on pointcuts */ + protected abstract pointcut observedEvent(Subject subject); + + @AdviceAnnotation + after(Subject subject) returning : observedEvent(subject) { + notifyObservers(subject); + } +} +.... + +An annotation on an aspect will be inherited by sub-aspects, iff it has +the `@Inherited` meta-annotation. + +AspectJ 5 supports a new XLint warning, "the pointcut associated with +this advice does not match any join points". The warning is enabled by +default and will be emitted by the compiler if the pointcut expression +associated with an advice statement can be statically determined to not +match any join points. The warning can be suppressed for an individual +advice statement by using the +`@SuppressAjWarnings({"adviceDidNotMatch"})` annotation. This works in +the same way as the Java 5 SuppressWarnings annotation (See JLS +9.6.1.5), but has class file retention. + +.... +import org.aspectj.lang.annotation.SuppressAjWarnings; + +public aspect AnAspect { + + pointcut anInterfaceOperation() : execution(* AnInterface.*(..)); + + + @SuppressAjWarnings // may not match if there are no implementers of the interface... + before() : anInterfaceOperation() { + // do something... + } + + @SuppressAjWarnings("adviceDidNotMatch") // alternate form + after() returning : anInterfaceOperation() { + // do something... + } +} +.... + +[[annotations-pointcuts-and-advice]] +=== Join Point Matching based on Annotations + +This section discusses changes to type pattern and signature pattern +matching in AspectJ 5 that support matching join points based on the +presence or absence of annotations. We then discuss means of exposing +annotation values within the body of advice. + +==== Annotation Patterns + +For any kind of annotated element (type, method, constructor, package, +etc.), an annotation pattern can be used to match against the set of +annotations on the annotated element.An annotation pattern element has +one of two basic forms: + +* @, for example, @Foo, or @org.xyz.Foo. +* @(), for example, @(org.xyz..*), or @(Foo || Boo) + +These simple elements may be negated using `!`, and combined by simple +concatentation. The pattern `@Foo @Boo` matches an annotated element +that has both an annotation of type `Foo` and an annotation of type +`Boo`. + +Some examples of annotation patterns follow: + +@Immutable:: + Matches any annotated element which has an annotation of type + `Immutable`. +!@Persistent:: + Matches any annotated element which does not have an annotation of + type `Persistent`. +@Foo @Goo:: + Matches any annotated element which has both an annotation of type + `Foo` and an annotation of type `Goo`. +@(Foo || Goo):: + Matches any annotated element which has either an annotation of a type + matching the type pattern `(Foo || Goo)`. In other words, an annotated + element with either an annotation of type `Foo` or an annotation of + type `Goo` (or both). (The parenthesis are required in this example). +@(org.xyz..*):: + Matches any annotated element which has either an annotation of a type + matching the type pattern `(org.xyz..*)`. In other words, an annotated + element with an annotation that is declared in the org.xyz package or + a sub-package. (The parenthesis are required in this example). + +==== Type Patterns + +AspectJ 1.5 extends type patterns to allow an optional +`AnnotationPattern` prefix. + +.... +TypePattern := SimpleTypePattern | + '!' TypePattern | + '(' AnnotationPattern? TypePattern ')' + TypePattern '&&' TypePattern | + TypePattern '||' TypePattern + +SimpleTypePattern := DottedNamePattern '+'? '[]'* + +DottedNamePattern := FullyQualifiedName RestOfNamePattern? | + '*' NotStarNamePattern? + +RestOfNamePattern := '..' DottedNamePattern | + '*' NotStarNamePattern? + +NotStarNamePattern := FullyQualifiedName RestOfNamePattern? | + '..' DottedNamePattern + +FullyQualifiedName := JavaIdentifierCharacter+ ('.' JavaIdentifierCharacter+)* +.... + +Note that in most cases when annotations are used as part of a type +pattern, the parenthesis are required (as in `(@Foo Hello+)`). In some +cases (such as a type pattern used within a `within` or `handler` +pointcut expression), the parenthesis are optional: + +.... +OptionalParensTypePattern := AnnotationPattern? TypePattern + +.... + +The following examples illustrate the use of annotations in type +patterns: + +(@Immutable *):: + Matches any type with an `@Immutable` annotation. +(!@Immutable *):: + Matches any type which does not have an `@Immutable` annotation. +(@Immutable (org.xyz.* || org.abc.*)):: + Matches any type in the `org.xyz` or `org.abc` packages with the + `@Immutable` annotation. +((@Immutable Foo+) || Goo):: + Matches a type `Foo` or any of its subtypes, which have the + `@Immutable` annotation, or a type `Goo`. +((@(Immutable || NonPersistent) org.xyz..*):: + Matches any type in a package beginning with the prefix `org.xyz`, + which has either the `@Immutable` annotation or the `@NonPersistent` + annotation. +(@Immutable @NonPersistent org.xyz..*):: + Matches any type in a package beginning with the prefix `org.xyz`, + which has both an `@Immutable` annotation and an `@NonPersistent` + annotation. +(@(@Inherited *) org.xyz..*):: + Matches any type in a package beginning with the prefix `org.xyz`, + which has an inheritable annotation. The annotation pattern + `@(@Inherited *)` matches any annotation of a type matching the type + pattern `@Inherited *`, which in turn matches any type with the + `@Inherited` annotation. + +[[signaturePatterns]] +==== Signature Patterns + +[[fieldPatterns]] +===== Field Patterns + +A `FieldPattern` can optionally specify an annotation-matching pattern +as the first element: + +.... +FieldPattern := + AnnotationPattern? FieldModifiersPattern? + TypePattern (TypePattern DotOrDotDot)? SimpleNamePattern + +FieldModifiersPattern := '!'? FieldModifier FieldModifiersPattern* + +FieldModifier := 'public' | 'private' | 'protected' | 'static' | + 'transient' | 'final' + +DotOrDotDot := '.' | '..' + +SimpleNamePattern := JavaIdentifierChar+ ('*' SimpleNamePattern)? +.... + +If present, the `AnnotationPattern` restricts matches to fields with +annotations that match the pattern. For example: + +@SensitiveData * *:: + Matches a field of any type and any name, that has an annotation of + type `@SensitiveData` +@SensitiveData List org.xyz..*.*:: + Matches a member field of a type in a package with prefix `org.xzy`, + where the field is of type `List`, and has an annotation of type + `@SensitiveData` +(@SensitiveData *) org.xyz..*.*:: + Matches a member field of a type in a package with prefix `org.xzy`, + where the field is of a type which has a `@SensitiveData` annotation. +@Foo (@Goo *) (@Hoo *).*:: + Matches a field with an annotation `@Foo`, of a type with an + annotation `@Goo`, declared in a type with annotation `@Hoo`. +@Persisted @Classified * *:: + Matches a field with an annotation `@Persisted` and an annotation + `@Classified`. + +[[methodPatterns]] +===== Method and Constructor Patterns + +A `MethodPattern` can optionally specify an annotation-matching pattern +as the first element. + +.... +MethodPattern := + AnnotationPattern? MethodModifiersPattern? TypePattern + (TypePattern DotOrDotDot)? SimpleNamePattern + '(' FormalsPattern ')'ThrowsPattern? + +MethodModifiersPattern := '!'? MethodModifier MethodModifiersPattern* + +MethodModifier := 'public' | 'private' | 'protected' | 'static' | + 'synchronized' | 'final' + +FormalsPattern := '..' (',' FormalsPatternAfterDotDot)* | + OptionalParensTypePattern (',' FormalsPattern)* | + TypePattern '...' + +FormalsPatternAfterDotDot := + OptionalParensTypePattern (',' FormalsPatternAfterDotDot)* | + TypePattern '...' + +ThrowsPattern := 'throws' TypePatternList + +TypePatternList := TypePattern (',' TypePattern)* +.... + +A `ConstructorPattern` has the form + +.... +ConstructorPattern := + AnnotationPattern? ConstructorModifiersPattern? + (TypePattern DotOrDotDot)? 'new' '(' FormalsPattern ')' + ThrowsPattern? + +ConstructorModifiersPattern := '!'? ConstructorModifier ConstructorModifiersPattern* + +ConstructorModifier := 'public' | 'private' | 'protected' +.... + +The optional `AnnotationPattern` at the beginning of a method or +constructor pattern restricts matches to methods/constructors with +annotations that match the pattern. For example: + +@Oneway * *(..):: + Matches a method with any return type and any name, that has an + annotation of type `@Oneway`. +@Transaction * (@Persistent org.xyz..*).*(..):: + Matches a method with the `@Transaction` annotation, declared in a + type with the `@Persistent` annotation, and in a package beginning + with the `org.xyz` prefix. +* *.*(@Immutable *,..):: + Matches any method taking at least one parameter, where the parameter + type has an annotation `@Immutable`. + +==== Example Pointcuts + +within(@Secure *):: + Matches any join point where the code executing is declared in a type + with an `@Secure` annotation. The format of the `within` pointcut + designator in AspectJ 5 is + `'within' '(' OptionalParensTypePattern ')'`. +staticinitialization(@Persistent *):: + Matches the staticinitialization join point of any type with the + `@Persistent` annotation. The format of the `staticinitialization` + pointcut designator in AspectJ 5 is + `'staticinitialization' '(' OptionalParensTypePattern ')'`. +call(@Oneway * *(..)):: + Matches a call to a method with a `@Oneway` annotation. +execution(public (@Immutable *) org.xyz..*.*(..)):: + The execution of any public method in a package with prefix `org.xyz`, + where the method returns an immutable result. +set(@Cachable * *):: + Matches the set of any cachable field. +handler(!@Catastrophic *):: + Matches the handler join point for the handling of any exception that + is not `Catastrophic`. The format of the `handler` pointcut designator + in AspectJ 5 is `'handler' '(' OptionalParensTypePattern ')'`. + +==== Runtime type matching and context exposure + +AspectJ 5 supports a set of "@" pointcut designators which can be used +both to match based on the presence of an annotation at runtime, and to +expose the annotation value as context in a pointcut or advice +definition. These designators are `@args, @this, @target, + @within, @withincode`, and `@annotation` + +It is a compilation error to attempt to match on an annotation type that +does not have runtime retention using `@this, @target` or `@args`. It is +a compilation error to attempt to use any of these designators to expose +an annotation value that does not have runtime retention. + +The `this()`, `target()`, and `args()` pointcut designators allow +matching based on the runtime type of an object, as opposed to the +statically declared type. In AspectJ 5, these designators are +supplemented with three new designators : `@this()` (read, "this +annotation"), `@target()`, and `@args()`. + +Like their counterparts, these pointcut designators can be used both for +join point matching, and to expose context. The format of these new +designators is: + +.... +AtThis := '@this' '(' AnnotationOrIdentifer ')' + +AtTarget := '@target' '(' AnnotationOrIdentifier ')' + +AnnotationOrIdentifier := FullyQualifiedName | Identifier + +AtArgs := '@args' '(' AnnotationsOrIdentifiersPattern ')' + +AnnotationsOrIdentifiersPattern := + '..' (',' AnnotationsOrIdentifiersPatternAfterDotDot)? | + AnnotationOrIdentifier (',' AnnotationsOrIdentifiersPattern)* | + '*' (',' AnnotationsOrIdentifiersPattern)* + +AnnotationsOrIdentifiersPatternAfterDotDot := + AnnotationOrIdentifier (',' AnnotationsOrIdentifiersPatternAfterDotDot)* | + '*' (',' AnnotationsOrIdentifiersPatternAfterDotDot)* +.... + +The forms of `@this()` and `@target()` that take a single annotation +name are analogous to their counterparts that take a single type name. +They match at join points where the object bound to `this` (or `target`, +respectively) has an annotation of the specified type. For example: + +@this(Foo):: + Matches any join point where the object currently bound to 'this' has + an annotation of type `Foo`. +call(* *(..)) && @target(Classified):: + Matches a call to any object where the target of the call has a + `@Classified` annotation. + +Annotations can be exposed as context in the body of advice by using the +forms of `@this(), @target()` and `@args()` that use bound variables in +the place of annotation names. For example: + +.... +pointcut callToClassifiedObject(Classified classificationInfo) : + call(* *(..)) && @target(classificationInfo); + +pointcut txRequiredMethod(Tx transactionAnnotation) : + execution(* *(..)) && @this(transactionAnnotation) + && if(transactionAnnotation.policy() == TxPolicy.REQUIRED); +.... + +The `@args` pointcut designator behaves as its `args` counterpart, +matching join points based on number and position of arguments, and +supporting the `*` wildcard and at most one `..` wildcard. An annotation +at a given position in an `@args` expression indicates that the runtime +type of the argument in that position at a join point must have an +annotation of the indicated type. For example: + +.... +/** + * matches any join point with at least one argument, and where the + * type of the first argument has the @Classified annotation + */ +pointcut classifiedArgument() : @args(Classified,..); + +/** + * matches any join point with three arguments, where the third + * argument has an annotation of type @Untrusted. + */ +pointcut untrustedData(Untrusted untrustedDataSource) : + @args(*,*,untrustedDataSource); +.... + +In addition to accessing annotation information at runtime through +context binding, access to `AnnotatedElement` information is also +available reflectively with the body of advice through the +`thisJoinPoint`, `thisJoinPointStaticPart`, and +`thisEnclosingJoinPointStaticPart` variables. To access annotations on +the arguments, or object bound to this or target at a join point you can +use the following code fragments: + +.... +Annotation[] thisAnnotations = thisJoinPoint.getThis().getClass().getAnnotations(); +Annotation[] targetAnnotations = thisJoinPoint.getTarget().getClass().getAnnotations(); +Annotation[] firstParamAnnotations = thisJoinPoint.getArgs()[0].getClass().getAnnotations(); +.... + +The `@within` and `@withincode` pointcut designators match any join +point where the executing code is defined within a type (`@within`), or +a method/constructor (`@withincode`) that has an annotation of the +specified type. The form of these designators is: + +.... +AtWithin := '@within' '(' AnnotationOrIdentifier ')' +AtWithinCode := '@withincode' '(' AnnotationOrIdentifier ')' +.... + +Some examples of using these designators follow: + +@within(Foo):: + Matches any join point where the executing code is defined within a + type which has an annotation of type `Foo`. +pointcut insideCriticalMethod(Critical c) : @withincode(c);:: + Matches any join point where the executing code is defined in a method + or constructor which has an annotation of type `@Critical`, and + exposes the value of the annotation in the parameter `c`. + +The `@annotation` pointcut designator matches any join point where the +_subject_ of the join point has an annotation of the given type. Like +the other @pcds, it can also be used for context exposure. + +.... +AtAnnotation := '@annotation' '(' AnnotationOrIdentifier ')' +.... + +The subject of a join point is defined in the table in chapter one of +this guide. + +Access to annotation information on members at a matched join point is +also available through the `getSignature` method of the `JoinPoint` and +`JoinPoint.StaticPart` interfaces. The `Signature` interfaces are +extended with additional operations that provide access to the +`java.lang.reflect` `Method, Field` and `Constructor` objects on which +annnotations can be queried. The following fragment illustrates an +example use of this interface to access annotation information. + +.... +Signature sig = thisJoinPointStaticPart.getSignature(); +AnnotatedElement declaringTypeAnnotationInfo = sig.getDeclaringType(); +if (sig instanceof MethodSignature) { + // this must be a call or execution join point + Method method = ((MethodSignature)sig).getMethod(); +} +.... + +_Note again that it would be nicer to add the method getAnnotationInfo +directly to MemberSignature, but this would once more couple the runtime +library to Java 5._ + +The `@this,@target` and `@args` pointcut designators can only be used to +match against annotations that have runtime retention. The +`@within, @withincode` and `@annotation` pointcut designators can only +be used to match against annotations that have at least class-file +retention, and if used in the binding form the annotation must have +runtime retention. + +==== Package and Parameter Annotations + +_Matching on package annotations is not supported in AspectJ. Support +for this capability may be considered in a future release._ + +Parameter annotation matching is being added in AspectJ1.6. Initially +only matching is supported but binding will be implemented at some +point. Whether the annotation specified in a pointcut should be +considered to be an annotation on the parameter type or an annotation on +the parameter itself is determined through the use of parentheses around +the parameter type. Consider the following: + +.... +@SomeAnnotation +class AnnotatedType {} + +class C { + public void foo(AnnotatedType a) {} + public void goo(@SomeAnnotation String s) {} +} +.... + +The method foo has a parameter of an annotated type, and can be matched +by this pointcut: + +.... +pointcut p(): execution(* *(@SomeAnnotation *)); +.... + +When there is a single annotation specified like this, it is considered +to be part of the type pattern in the match against the parameter: 'a +parameter of any type that has the annotation @SomeAnnotation'. + +To match the parameter annotation case, the method goo, this is the +pointcut: + +.... +pointcut p(): execution(* *(@SomeAnnotation (*))); +.... + +The use of parentheses around the wildcard is effectively indicating +that the annotation should be considered separately to the type pattern +for the parameter type: 'a parameter of any type that has a parameter +annotation of @SomeAnnotation'. + +To match when there is a parameter annotation and an annotation on the +type as well: + +.... +pointcut p(): execution(* *(@SomeAnnotation (@SomeOtherAnnotation *))); +.... + +The parentheses are grouping @SomeOtherAnnotation with the * to form the +type pattern for the parameter, then the type @SomeAnnotation will be +treated as a parameter annotation pattern. + +==== Annotation Inheritance and pointcut matching + +According to the Java 5 specification, non-type annotations are not +inherited, and annotations on types are only inherited if they have the +`@Inherited` meta-annotation. Given the following program: + +.... +class C1 { + @SomeAnnotation + public void aMethod() {...} +} + +class C2 extends C1 { + public void aMethod() {...} +} + +class Main { + public static void main(String[] args) { + C1 c1 = new C1(); + C2 c2 = new C2(); + c1.aMethod(); + c2.aMethod(); + } +} + +aspect X { + pointcut annotatedC2MethodCall() : + call(@SomeAnnotation * C2.aMethod()); + + pointcut annotatedMethodCall() : + call(@SomeAnnotation * aMethod()); +} +.... + +The pointcut `annotatedC2MethodCall` will not match anything since the +definition of `aMethod` in `C2` does not have the annotation. + +The pointcut `annotatedMethodCall` matches `c1.aMethod()` but not +`c2.aMethod()`. The call to `c2.aMethod` is not matched because join +point matching for modifiers (the visibility modifiers, annotations, and +throws clause) is based on the subject of the join point (the method +actually being called). + +[[matchingOnAnnotationValues]] +==== Matching based on annotation values + +The `if` pointcut designator can be used to write pointcuts that match +based on the values annotation members. For example: + +.... +pointcut txRequiredMethod(Tx transactionAnnotation) : + execution(* *(..)) && @this(transactionAnnotation) + && if(transactionAnnotation.policy() == TxPolicy.REQUIRED); +.... + +[[annotations-decp]] +=== Using Annotations with declare statements + +==== Declare error and declare warning + +Since pointcut expressions in AspectJ 5 support join point matching +based on annotations, this facility can be exploited when writing +`declare warning` and `declare error` statements. For example: + +.... +declare warning : withincode(@PerformanceCritical * *(..)) && + call(@ExpensiveOperation * *(..)) + : "Expensive operation called from within performance critical section"; +.... + +.... +declare error : call(* org.xyz.model.*.*(..)) && + !@within(Trusted) + : "Untrusted code should not call the model classes directly"; +.... + +==== declare parents + +The general form of a `declare parents` statement is: + +.... +declare parents : TypePattern extends Type; +declare parents : TypePattern implements TypeList; +.... + +Since AspectJ 5 supports annotations as part of a type pattern +specification, it is now possible to match types based on the presence +of annotations _with either class-file or runtime retention_. For +example: + +declare parents : (@Secured *) implements SecuredObject;:: + All types with the `@Secured` annotation implement the `SecuredObject` + inteface. +declare parents : (@Secured BankAccount+) implements SecuredObject;:: + The subset of types drawn from the `BankAccount` type and any subtype + of `BankAccount`, where the `@Secured` annotation is present, + implement the `SecuredObject` interface. + +An annotation type may not be used as the target of a declare parents +statement. If an annotation type is named explicitly as the target of a +declare parents statement, a compilation error will result. If an +annotation type is matched by a non-explicit type pattern used in a +declare parents statement it will be ignored (and an XLint warning +issued). + +==== declare precedence + +The general form of a declare precedence statement is: + +.... +declare precedence : TypePatList; +.... + +AspectJ 5 allows the type patterns in the list to include annotation +information as part of the pattern specification. For example: + +declare precedence : (@Security *),*;:: + All aspects with the `@Security` annotation take precedence over any + other aspects in the system. (Or, more informally, all + security-related aspects take precedence). + +[[annotations-declare]] +=== Declare Annotation + +AspectJ 5 supports a new kind of declare statement, +`declare annotation`. This takes different forms according to the +recipient of the annotation: `declare @type` for types, +`declare @method` for methods, `declare @constructor` for constructors, +and `declare @field` for fields. `declare @package` may be supported in +a future release. + +The general form is: + +.... +declare @ : ElementPattern : Annotation ; +.... + +Where annotation is a regular annotation expression as defined in the +Java 5 language. If the annotation has the `@Target` meta-annotation, +then the elements matched by `ElementPattern` must be of the kind +specified by the `@Target` annotation. + +`ElementPattern` is defined as follows: + +.... +ElementPattern := TypePattern | + MethodPattern | + ConstructorPattern | + FieldPattern +.... + +The following examples illustrate the use of `declare annotation`. + +declare @type : org.xyz.model..* : @BusinessDomain ;:: + All types defined in a package with the prefix `org.xyz.model` have + the `@BusinessDomain` annotation. +declare @method : public * BankAccount+.*(..) : +@Secured(role="supervisor"):: + All public methods in `BankAccount` and its subtypes have the + annotation `@Secured(role="supervisor")`. +declare @constructor : BankAccount+.new(..) : +@Secured(role="supervisor"):: + All constructors in `BankAccount` and its subtypes have the annotation + `@Secured(role="supervisor")`. +declare @field : * DAO+.* : @Persisted;:: + All fields defined in `DAO` or its subtypes have the `@Persisted` + annotation. + +[[annotations-itds]] +=== Inter-type Declarations + +An annotation type may not be the target of an inter-type declaration. diff --git a/docs/adk15ProgGuideDB/ataspectj.adoc b/docs/adk15ProgGuideDB/ataspectj.adoc new file mode 100644 index 000000000..e69fb205a --- /dev/null +++ b/docs/adk15ProgGuideDB/ataspectj.adoc @@ -0,0 +1,868 @@ +[[ataspectj]] +== An Annotation Based Development Style + +[[ataspectj-intro]] +=== Introduction + +In addition to the familiar AspectJ code-based style of aspect +declaration, AspectJ 5 also supports an annotation-based style of aspect +declaration. We informally call the set of annotations that support this +development style the "@AspectJ" annotations. + +AspectJ 5 allows aspects and their members to be specified using either +the code style or the annotation style. Whichever style you use, the +AspectJ weaver ensures that your program has exactly the same semantics. +It is, to quote a famous advertising campaign, "a choice, not a +compromise". The two styles can be mixed within a single application, +and even within a single source file, though we doubt this latter mix +will be recommended in practice. + +The use of the @AspectJ annotations means that there are large classes +of AspectJ applications that can be compiled by a regular Java 5 +compiler, and subsequently woven by the AspectJ weaver (for example, as +an additional build stage, or as late as class load-time). In this +chapter we introduce the @AspectJ annotations and show how they can be +used to declare aspects and aspect members. + +[[ataspectj-aspects]] +=== Aspect Declarations + +Aspect declarations are supported by the +`org.aspectj.lang.annotation.Aspect` annotation. The declaration: + +.... +@Aspect +public class Foo {} +.... + +Is equivalent to: + +.... +public aspect Foo {} +.... + +To specify an aspect an aspect instantiation model (the default is +singleton), provide the perclause as the `@Aspect` value. For example: + +.... +@Aspect("perthis(execution(* abc..*(..)))") +public class Foo {} +.... + +is equivalent to... + +.... +public aspect Foo perthis(execution(* abc..*(..))) {} +.... + +==== Limitations + +Privileged aspects are not supported by the annotation style. + +[[ataspectj-pcadvice]] +=== Pointcuts and Advice + +Pointcut and advice declarations can be made using the +`Pointcut, Before, After, AfterReturning, AfterThrowing,` and `Around` +annotations. + +==== Pointcuts + +Pointcuts are specified using the `org.aspectj.lang.annotation.Pointcut` +annotation on a method declaration. The method should have a `void` +return type. The parameters of the method correspond to the parameters +of the pointcut. The modifiers of the method correspond to the modifiers +of the pointcut. + +As a general rule, the `@Pointcut` annotated method must have an empty +method body and must not have any `throws` clause. If formal are bound +(using +`args(), target(), this(), @args(), @target(), @this(), @annotation())` +in the pointcut, then they must appear in the method signature. + +The `if()` pointcut is treated specially and is discussed in a later +section. + +Here is a simple example of a pointcut declaration in both code and +@AspectJ styles: + +.... +@Pointcut("call(* *.*(..))") +void anyCall() {} +.... + +is equivalent to... + +.... +pointcut anyCall() : call(* *.*(..)); +.... + +When binding arguments, simply declare the arguments as normal in the +annotated method: + +.... +@Pointcut("call(* *.*(int)) && args(i) && target(callee)") +void anyCall(int i, Foo callee) {} +.... + +is equivalent to... + +.... +pointcut anyCall(int i, Foo callee) : call(* *.*(int)) && args(i) && target(callee); +.... + +An example with modifiers (Remember that Java 5 annotations are not +inherited, so the `@Pointcut` annotation must be present on the +extending aspect's pointcut declaration too): + +.... +@Pointcut("") +protected abstract void anyCall(); +.... + +is equivalent to... + +.... +protected abstract pointcut anyCall(); +.... + +===== Type references inside @AspectJ annotations + +Using the code style, types referenced in pointcut expressions are +resolved with respect to the imported types in the compilation unit. +When using the annotation style, types referenced in pointcut +expressions are resolved in the absence of any imports and so have to be +fully qualified if they are not by default visible to the declaring type +(outside of the declaring package and `java.lang` ). This does not apply +to type patterns with wildcards, which are always resolved in a global +scope. + +Consider the following compilation unit: + +.... +package org.aspectprogrammer.examples; + +import java.util.List; + +public aspect Foo { + pointcut listOperation() : call(* List.*(..)); + pointcut anyUtilityCall() : call(* java.util..*(..)); +} +.... + +Using the annotation style this would be written as: + +.... +package org.aspectprogrammer.examples; + +import java.util.List; // redundant but harmless + +@Aspect +public class Foo { + @Pointcut("call(* java.util.List.*(..))") // must qualify + void listOperation() {} + + @Pointcut("call(* java.util..*(..))") + void anyUtilityCall() {} +} +.... + +===== if() pointcut expressions + +In code style, it is possible to use the `if(...)` poincut to define a +conditional pointcut expression which will be evaluated at runtime for +each candidate join point. The `if(...)` body can be any valid Java +boolean expression, and can use any exposed formal, as well as the join +point forms +`thisJoinPoint, thisJoinPointStaticPart and thisJoinPointEnclosingStaticPart` +. + +When using the annotation style, it is not possible to write a full Java +expression within the annotation value so the syntax differs slightly, +whilst providing the very same semantics and runtime behaviour. An +`if()` pointcut expression can be declared in an `@Pointcut` , but must +have either an empty body (`if()`, or be one of the expression forms +`if(true)` or `if(false)` . The annotated method must be public, static, +and return a boolean. The body of the method contains the condition to +be evaluated. For example: + +.... +@Pointcut("call(* *.*(int)) && args(i) && if()") +public static boolean someCallWithIfTest(int i) { + return i > 0; +} +.... + +is equivalent to... + +.... +pointcut someCallWithIfTest(int i) : call(* *.*(int)) && args(i) && if(i > 0); +.... + +and the following is also a valid form: + +.... +static int COUNT = 0; + +@Pointcut("call(* *.*(int)) && args(i) && if()") +public static boolean someCallWithIfTest(int i, JoinPoint jp, JoinPoint.EnclosingStaticPart esjp) { + // any legal Java expression... + return i > 0 + && jp.getSignature().getName.startsWith("doo") + && esjp.getSignature().getName().startsWith("test") + && COUNT++ < 10; +} + +@Before("someCallWithIfTest(anInt, jp, enc)") +public void beforeAdviceWithRuntimeTest(int anInt, JoinPoint jp, JoinPoint.EnclosingStaticPart enc) { + //... +} + +// Note that the following is NOT valid +/* +@Before("call(* *.*(int)) && args(i) && if()") +public void advice(int i) { + // so you were writing an advice or an if body ? +} +*/ +.... + +It is thus possible with the annotation style to use the `if()` pointcut +only within an `@Pointcut` expression. The `if()` must not contain any +body. The annotated `@Pointcut` method must then be of the form +`public static boolean` and can use formal bindings as usual. Extra +_implicit_ arguments of type JoinPoint, JoinPoint.StaticPart and +JoinPoint.EnclosingStaticPart can also be used (this is not permitted +for regular annotated pointcuts not using the `if()` form). + +The special forms `if(true)` and `if(false)` can be used in a more +general way and don't imply that the pointcut method must have a body. +You can thus write `@Before("somePoincut() && if(false)")` . + +==== Advice + +In this section we first discuss the use of annotations for simple +advice declarations. Then we show how `thisJoinPoint` and its siblings +are handled in the body of advice and discuss the treatment of `proceed` +in around advice. + +Using the annotation style, an advice declaration is written as a +regular Java method with one of the `Before, After, AfterReturning, + AfterThrowing,` or `Around` annotations. Except in +the case of around advice, the method should return void. The method +should be declared public. + +A method that has an advice annotation is treated exactly as an advice +declaration by AspectJ's weaver. This includes the join points that +arise when the advice is executed (an adviceexecution join point, not a +method execution join point). + +The following example shows a simple before advice declaration in both +styles: + +.... +@Before("call(* org.aspectprogrammer..*(..)) && this(Foo)") +public void callFromFoo() { + System.out.println("Call from Foo"); +} +.... + +is equivalent to... + +.... +before() : call(* org.aspectprogrammer..*(..)) && this(Foo) { + System.out.println("Call from Foo"); +} +.... + +If the advice body needs to know which particular `Foo` instance is +making the call, just add a parameter to the advice declaration. + +.... +before(Foo foo) : call(* org.aspectprogrammer..*(..)) && this(foo) { + System.out.println("Call from Foo: " + foo); +} +.... + +can be written as: + +.... +@Before("call(* org.aspectprogrammer..*(..)) && this(foo)") +public void callFromFoo(Foo foo) { + System.out.println("Call from Foo: " + foo); +} +.... + +If the advice body needs access to `thisJoinPoint` , +`thisJoinPointStaticPart` , `thisEnclosingJoinPointStaticPart` then +these need to be declared as additional method parameters when using the +annotation style. + +.... +@Before("call(* org.aspectprogrammer..*(..)) && this(foo)") +public void callFromFoo(JoinPoint thisJoinPoint, Foo foo) { + System.out.println("Call from Foo: " + foo + " at " + + thisJoinPoint); +} +.... + +is equivalent to... + +.... +before(Foo foo) : call(* org.aspectprogrammer..*(..)) && this(foo) { + System.out.println("Call from Foo: " + foo + " at " + + thisJoinPoint); +} +.... + +Advice that needs all three variables would be declared: + +.... +@Before("call(* org.aspectprogrammer..*(..)) && this(Foo)") +public void callFromFoo(JoinPoint thisJoinPoint, + JoinPoint.StaticPart thisJoinPointStaticPart, + JoinPoint.EnclosingStaticPart thisEnclosingJoinPointStaticPart) { + // ... +} +.... + +`JoinPoint.EnclosingStaticPart` is a new (empty) sub-interface of +`JoinPoint.StaticPart` which allows the AspectJ weaver to distinguish +based on type which of `thisJoinPointStaticPart` and +`thisEnclosingJoinPointStaticPart` should be passed in a given parameter +position. + +`After` advice declarations take exactly the same form as `Before` , as +do the forms of `AfterReturning` and `AfterThrowing` that do not expose +the return type or thrown exception respectively. + +To expose a return value with after returning advice simply declare the +returning parameter as a parameter in the method body and bind it with +the "returning" attribute: + +.... +@AfterReturning("criticalOperation()") +public void phew() { + System.out.println("phew"); +} + +@AfterReturning(pointcut="call(Foo+.new(..))",returning="f") +public void itsAFoo(Foo f) { + System.out.println("It's a Foo: " + f); +} +.... + +is equivalent to... + +.... +after() returning : criticalOperation() { + System.out.println("phew"); +} + +after() returning(Foo f) : call(Foo+.new(..)) { + System.out.println("It's a Foo: " + f); +} +.... + +(Note the use of the "pointcut=" prefix in front of the pointcut +expression in the returning case). + +After throwing advice works in a similar fashion, using the `throwing` +attribute when needing to expose a thrown exception. + +For around advice, we have to tackle the problem of `proceed` . One of +the design goals for the annotation style is that a large class of +AspectJ applications should be compilable with a standard Java 5 +compiler. A straight call to `proceed` inside a method body: + +.... +@Around("call(* org.aspectprogrammer..*(..))") +public Object doNothing() { + return proceed(); // CE on this line +} +.... + +will result in a "No such method" compilation error. For this reason +AspectJ 5 defines a new sub-interface of `JoinPoint` , +`ProceedingJoinPoint` . + +.... +public interface ProceedingJoinPoint extends JoinPoint { + public Object proceed(Object[] args); +} +.... + +The around advice given above can now be written as: + +.... +@Around("call(* org.aspectprogrammer..*(..))") +public Object doNothing(ProceedingJoinPoint thisJoinPoint) { + return thisJoinPoint.proceed(); +} +.... + +Here's an example that uses parameters for the proceed call: + +.... +@Aspect +public class ProceedAspect { + + @Pointcut("call(* setAge(..)) && args(i)") + void setAge(int i) {} + + @Around("setAge(i)") + public Object twiceAsOld(ProceedingJoinPoint thisJoinPoint, int i) { + return thisJoinPoint.proceed(new Object[]{i*2}); //using Java 5 autoboxing + } + +} +.... + +is equivalent to: + +.... +public aspect ProceedAspect { + pointcut setAge(int i): call(* setAge(..)) && args(i); + + Object around(int i): setAge(i) { + return proceed(i*2); + } +} +.... + +Note that the ProceedingJoinPoint does not need to be passed to the +proceed(..) arguments. + +In code style, the proceed method has the same signature as the advice, +any reordering of actual arguments to the joinpoint that is done in the +advice signature must be respected. Annotation style is different. The +proceed(..) call takes, in this order: + +* If 'this()' was used in the pointcut ++ +for binding ++ +, it must be passed first in proceed(..). +* If 'target()' was used in the pointcut ++ +for binding ++ +, it must be passed next in proceed(..) - it will be the first argument +to proceed(..) if this() was not used for binding. +* Finally come ++ +all ++ +the arguments expected at the join point, in the order they are supplied +at the join point. Effectively the advice signature is ignored - it +doesn't matter if a subset of arguments were bound or the ordering was +changed in the advice signature, the proceed(..) calls takes all of them +in the right order for the join point. + +Since proceed(..) in this case takes an Object array, AspectJ cannot do +as much compile time checking as it can for code style. If the rules +above aren't obeyed then it will unfortunately manifest as a runtime +error. + +[[ataspectj-itds]] +=== Inter-type Declarations + +Inter-type declarations are challenging to support using an annotation +style. For code style aspects compiled with the ajc compiler, the entire +type system can be made aware of inter-type declarations (new +supertypes, new methods, new fields) and the completeness and +correctness of it can be guaranteed. Achieving this with an annotation +style is hard because the source code may simply be compiled with javac +where the type system cannot be influenced and what is compiled must be +'pure java'. + +AspectJ 1.5.0 introduced @DeclareParents, an attempt to offer something +like that which is achievable with code style declare parents and the +other intertype declarations (fields, methods, constructors). However, +it has proved too challenging to get close to the expressiveness and +capabilities of code style in this area and effectively @DeclareParents +is offering just a mixin strategy. The definition of mixin I am using +here is that when some interface I is mixed into some target type T then +this means that all the methods from I are created in T and their +implementations are simple forwarding methods that call a delegate which +that provides an implementation of I. + +The next section covers @DeclareParents but AspectJ 1.6.4 introduces +@DeclareMixin - an improved approach to defining a mixin and the choice +of a different name for the annotation will hopefully alleviate some of +the confusion about why @DeclareParents just doesn't offer the same +semantics as the code style variant. Offering @DeclareMixin also gives +code style developers a new tool for a simple mixin whereas previously +they would have avoided @DeclareParents thinking what it could only do +was already achievable with code style syntax. + +The defaultImpl attribute of @DeclareParents may become deprecated if +@DeclareMixin proves popular, leaving @DeclareParents purely as a way to +introduce a marker interface. + +[[atDeclareParents]] +==== @DeclareParents + +Consider the following aspect: + +.... +public aspect MoodIndicator { + + public interface Moody {}; + + private Mood Moody.mood = Mood.HAPPY; + + public Mood Moody.getMood() { + return mood; + } + + declare parents : org.xyz..* implements Moody; + + before(Moody m) : execution(* *.*(..)) && this(m) { + System.out.println("I'm feeling " + m.getMood()); + } +} +.... + +This declares an interface `Moody` , and then makes two inter-type +declarations on the interface - a field that is private to the aspect, +and a method that returns the mood. Within the body of the inter-type +declared method `getMoody` , the type of `this` is `Moody` (the target +type of the inter-type declaration). + +Using the annotation style this aspect can be written: + +.... +@Aspect +public class MoodIndicator { + + // this interface can be outside of the aspect + public interface Moody { + Mood getMood(); + }; + + // this implementation can be outside of the aspect + public static class MoodyImpl implements Moody { + private Mood mood = Mood.HAPPY; + + public Mood getMood() { + return mood; + } + } + + // the field type must be the introduced interface. It can't be a class. + @DeclareParents(value="org.xzy..*",defaultImpl=MoodyImpl.class) + private Moody implementedInterface; + + @Before("execution(* *.*(..)) && this(m)") + void feelingMoody(Moody m) { + System.out.println("I'm feeling " + m.getMood()); + } +} +.... + +This is very similar to the mixin mechanism supported by AspectWerkz. +The effect of the `@DeclareParents` annotation is equivalent to a +declare parents statement that all types matching the type pattern +implement the given interface (in this case Moody). Each method declared +in the interface is treated as an inter-type declaration. Note how this +scheme operates within the constraints of Java type checking and ensures +that `this` has access to the exact same set of members as in the code +style example. + +Note that it is illegal to use the @DeclareParents annotation on an +aspect' field of a non-interface type. The interface type is the +inter-type declaration contract that dictates which methods are declared +on the target type. + +.... +// this type will be affected by the inter-type declaration as the type pattern matches +package org.xyz; +public class MoodTest { + + public void test() { + // see here the cast to the introduced interface (required) + Mood mood = ((Moody)this).getMood(); + ... + } +} +.... + +The `@DeclareParents` annotation can also be used without specifying a +`defaultImpl` value (for example, `@DeclareParents("org.xyz..*")`). This +is equivalent to a `declare parents ... implements` clause, and does +_not_ make any inter-type declarations for default implementation of the +interface methods. + +Consider the following aspect: + +.... +public aspect SerializableMarker { + declare parents : org.xyz..* implements Serializable; +} +.... + +Using the annotation style this aspect can be written: + +.... +@Aspect +public class SerializableMarker { + @DeclareParents("org.xyz..*") + Serializable implementedInterface; +} +.... + +If the interface defines one or more operations, and these are not +implemented by the target type, an error will be issued during weaving. + +[[atDeclareMixin]] +==== @DeclareMixin + +Consider the following aspect: + +.... +public aspect MoodIndicator { + + public interface Moody {}; + + private Mood Moody.mood = Mood.HAPPY; + + public Mood Moody.getMood() { + return mood; + } + + declare parents : org.xyz..* implements Moody; + + before(Moody m) : execution(* *.*(..)) && this(m) { + System.out.println("I'm feeling " + m.getMood()); + } +} +.... + +This declares an interface `Moody`, and then makes two inter-type +declarations on the interface - a field that is private to the aspect, +and a method that returns the mood. Within the body of the inter-type +declared method `getMoody`, the type of `this` is `Moody` (the target +type of the inter-type declaration). + +Using the annotation style this aspect can be written: + +.... +@Aspect +public class MoodIndicator { + + // this interface can be outside of the aspect + public interface Moody { + Mood getMood(); + }; + + // this implementation can be outside of the aspect + public static class MoodyImpl implements Moody { + private Mood mood = Mood.HAPPY; + + public Mood getMood() { + return mood; + } + } + + // The DeclareMixin annotation is attached to a factory method that can return instances of the delegate + // which offers an implementation of the mixin interface. The interface that is mixed in is the + // return type of the method. + @DeclareMixin("org.xyz..*") + public static Moody createMoodyImplementation() { + return new MoodyImpl(); + } + + @Before("execution(* *.*(..)) && this(m)") + void feelingMoody(Moody m) { + System.out.println("I'm feeling " + m.getMood()); + } +} +.... + +Basically, the `@DeclareMixin` annotation is attached to a factory +method. The factory method specifies the interface to mixin as its +return type, and calling the method should create an instance of a +delegate that implements the interface. This is the interface which will +be delegated to from any target matching the specified type pattern. + +Exploiting this syntax requires the user to obey the rules of pure Java. +So references to any targeted type as if it were affected by the Mixin +must be made through a cast, like this: + +.... +// this type will be affected by the inter-type declaration as the type pattern matches +package org.xyz; +public class MoodTest { + + public void test() { + // see here the cast to the introduced interface (required) + Mood mood = ((Moody)this).getMood(); + ... + } +} +.... + +Sometimes the delegate instance may want to perform differently +depending upon the type/instance for which it is behaving as a delegate. +To support this it is possible for the factory method to specify a +parameter. If it does, then when the factory method is called the +parameter will be the object instance for which a delegate should be +created: + +.... +@Aspect +public class Foo { + + @DeclareMixin("org.xyz..*") + public static SomeInterface createDelegate(Object instance) { + return new SomeImplementation(instance); + } +} +.... + +It is also possible to make the factory method non-static - and in this +case it can then exploit the local state in the surrounding aspect +instance, but this is only supported for singleton aspects: + +.... +@Aspect +public class Foo { + public int maxLimit=35; + + @DeclareMixin("org.xyz..*") + public SomeInterface createDelegate(Object instance) { + return new SomeImplementation(instance,maxLimit); + } +} +.... + +Although the interface type is usually determined purely from the return +type of the factory method, it can be specified in the annotation if +necessary. In this example the return type of the method extends +multiple other interfaces and only a couple of them (I and J) should be +mixed into any matching targets: + +.... +// interfaces is an array of interface classes that should be mixed in +@DeclareMixin(value="org.xyz..*",interfaces={I.class,J.class}) +public static InterfaceExtendingLotsOfInterfaces createMoodyImplementation() { + return new MoodyImpl(); +} +.... + +There are clearly similarities between `@DeclareMixin` and +`@DeclareParents` but `@DeclareMixin` is not pretending to offer more +than a simple mixin strategy. The flexibility in being able to provide +the factory method instead of requiring a no-arg constructor for the +implementation also enables delegate instances to make decisions based +upon the type for which they are the delegate. + +Any annotations defined on the interface methods are also put upon the +delegate forwarding methods created in the matched target type. + +[[ataspectj-declare]] +=== Declare statements + +The previous section on inter-type declarations covered the case of +declare parents ... implements. The 1.5.0 release of AspectJ 5 does not +support annotation style declarations for declare parents ... extends +and declare soft (programs with these declarations would not in general +be compilable by a regular Java 5 compiler, reducing the priority of +their implementation). These may be supported in a future release. + +Declare annotation is also not supported in the 1.5.0 release of AspectJ +5. + +Declare precedence _is_ supported. For declare precedence, use the +`@DeclarePrecedence` annotation as in the following example: + +.... +public aspect SystemArchitecture { + declare precedence : Security*, TransactionSupport, Persistence; + + // ... +} +.... + +can be written as: + +.... +@Aspect +@DeclarePrecedence("Security*,org.xyz.TransactionSupport,org.xyz.Persistence") +public class SystemArchitecture { + // ... +} +.... + +We also support annotation style declarations for declare warning and +declare error - any corresponding warnings and errors will be emitted at +weave time, not when the aspects containing the declarations are +compiled. (This is the same behaviour as when using declare warning or +error with the code style). Declare warning and error declarations are +made by annotating a string constant whose value is the message to be +issued. + +Note that the String must be a literal and not the result of the +invocation of a static method for example. + +.... +declare warning : call(* javax.sql..*(..)) && !within(org.xyz.daos..*) + : "Only DAOs should be calling JDBC."; + +declare error : execution(* IFoo+.*(..)) && !within(org.foo..*) + : "Only foo types can implement IFoo"; +.... + +can be written as... + +.... +@DeclareWarning("call(* javax.sql..*(..)) && !within(org.xyz.daos..*)") +static final String aMessage = "Only DAOs should be calling JDBC."; + +@DeclareError("execution(* IFoo+.*(..)) && !within(org.foo..*)") +static final String badIFooImplementors = "Only foo types can implement IFoo"; + +// the following is not valid since the message is not a String literal +@DeclareError("execution(* IFoo+.*(..)) && !within(org.foo..*)") +static final String badIFooImplementorsCorrupted = getMessage(); +static String getMessage() { + return "Only foo types can implement IFoo " + System.currentTimeMillis(); +} +.... + +[[ataspectj-aspectof]] +=== aspectOf() and hasAspect() methods + +A central part of AspectJ's programming model is that aspects written +using the code style and compiled using ajc support `aspectOf` and +`hasAspect` static methods. When developing an aspect using the +annotation style and compiling using a regular Java 5 compiler, these +methods will not be visible to the compiler and will result in a +compilation error if another part of the program tries to call them. + +To provide equivalent support for AspectJ applications compiled with a +standard Java 5 compiler, AspectJ 5 defines the `Aspects` utility class: + +.... +public class Aspects { + + /* variation used for singleton, percflow, percflowbelow */ + static public static T aspectOf(T aspectType) {...} + + /* variation used for perthis, pertarget */ + static public static T aspectOf(T aspectType, Object forObject) {...} + + /* variation used for pertypewithin */ + static public static T aspectOf(T aspectType, Class forType) {...} + + /* variation used for singleton, percflow, percflowbelow */ + public static boolean hasAspect(Object anAspect) {...} + + /* variation used for perthis, pertarget */ + public static boolean hasAspect(Object anAspect, Object forObject) {...} + + /* variation used for pertypewithin */ + public static boolean hasAspect(Object anAspect, Class forType) {...} +} +.... diff --git a/docs/adk15ProgGuideDB/autoboxing.adoc b/docs/adk15ProgGuideDB/autoboxing.adoc new file mode 100644 index 000000000..ced4f49fe --- /dev/null +++ b/docs/adk15ProgGuideDB/autoboxing.adoc @@ -0,0 +1,78 @@ +[[autoboxing]] +== Autoboxing and Unboxing + +[[boxing-inJava5]] +=== Autoboxing and Unboxing in Java 5 + +Java 5 (and hence AspectJ 1.5) supports automatic conversion of +primitive types (int, float, double etc.) to their object equivalents +(Integer, Float, Double,...) in assignments and method and constructor +invocations. This conversion is know as autoboxing. + +Java 5 also supports automatic unboxing, where wrapper types are +automatically converted into their primitive equivalents if needed for +assignments or method or constructor invocations. + +For example: + +.... +int i = 0; +i = new Integer(5); // auto-unboxing + +Integer i2 = 5; // autoboxing +.... + +[[autoboxing-in-aspectj5]] +=== Autoboxing and Join Point matching in AspectJ 5 + +Most of the pointcut designators match based on signatures, and hence +are unaffected by autoboxing. For example, a call to a method + +.... +public void foo(Integer i); +.... + +is _not_ matched by a pointcut `call(void foo(int))` since the signature +declares a single `Integer` parameter, not an `int`. + +The `args` pointcut designator is affected by autoboxing since it +matches based on the runtime type of the arguments. AspectJ 5 applies +autoboxing and unboxing in determining argument matching. In other +words, `args(Integer)` will match any join point at which there is a +single argument of type `Integer` or of type `int`. + +* args(Integer) and args(int) are equivalent +* args(Float) and args(float) are equivalent +* args(Double) and args(double) are equivalent +* args(Short) and args(short) are equivalent +* args(Byte) and args(byte) are equivalent +* args(Long) and args(long) are equivalent +* args(Boolean) and args(boolean) are equivalent + +Autoboxing and unboxing are also applied when binding pointcut or advice +parameters, for example: + +.... +pointcut foo(int i) : args(i); + +before(Integer i) : foo(i) { + ... +} +.... + +[[autoboxing-and-method-dispatch]] +=== Inter-type method declarations and method dispatch + +Autoboxing, unboxing, and also varargs all affect the method dispatch +algorithm used in Java 5. In AspectJ 5, the target method of a call is +selected according to the following algorithm: + +[arabic] +. Attempt to locate a matching method or inter-type declared method +without considering autoboxing, unboxing, or vararg invocations. +. If no match is found, try again considering autoboxing and unboxing. +. Finally try again considering both autoboxing, unboxing, and varargs. + +One consequence is that a directly matching inter-type declared method +will take precedence over a method declared locally in the target class +but that only matches via autoboxing. diff --git a/docs/adk15ProgGuideDB/covariance.adoc b/docs/adk15ProgGuideDB/covariance.adoc new file mode 100644 index 000000000..121f1b8bb --- /dev/null +++ b/docs/adk15ProgGuideDB/covariance.adoc @@ -0,0 +1,82 @@ +== Covariance + +[[covariance-inJava5]] +=== Covariance in Java 5 + +Java 5 (and hence AspectJ 5) allows you to narrow the return type in an +overriding method. For example: + +.... +class A { + public A whoAreYou() {...} +} + +class B extends A { + // override A.whoAreYou *and* narrow the return type. + public B whoAreYou() {...} +} +.... + +[[covariance-and-join-point-matching]] +=== Covariant methods and Join Point matching + +The join point matching rules for `call` and `execution` pointcut +designators are extended to match against covariant methods. + +Given the classes `A` and `B` as defined in the previous section, and +the program fragment + +.... +A a = new A(); +B b = new B(); +a.whoAreYou(); +b.whoAreYou(); +.... + +The signatures for the call join point `a.whoAreYou()` are simply: + +.... +A A.whoAreYou() +.... + +The signatures for the call join point `b.whoAreYou()` are: + +.... +A A.whoAreYou() +B B.whoAreYou() +.... + +Following the join point matching rules given in xref:#jpsigs[???], + +call(* whoAreYou()):: + Matches both calls, (since each call join point has at least one + matching signature). +call(* A.whoAreYou()):: + Matches both calls, (since each call join point has at least one + matching signature). +call(A whoAreYou()):: + Matches both calls, (since each call join point has at least one + matching signature). +call(A B.whoAreYou()):: + Does not match anything - neither of the call join points has a + signature matched by this pattern. A lint warning is given for the + call `a.whoAreYou()` ("does not match because declaring type is A, if + match required use target(B)"). +call(A+ B.whoAreYou()):: + Matches the call to `b.whoAreYou()` since the signature pattern + matches the signature `B B.whoAreYou()`. A lint warning is given for + the call `a.whoAreYou()` ("does not match because declaring type is A, + if match required use target(B)"). +call(B A.whoAreYou()):: + Does not match anything since neither join point has a signature + matched by this pattern. +call(B whoAreYou()):: + Matches the call to `b.whoAreYou()` only. +call(B B.whoAreYou()):: + Matches the call to `b.whoAreYou()` only. + +The rule for signature matching at call and execution join points is +unchanged from AspectJ 1.2: a call or execution pointcut matches if the +signature pattern matches at least one of the signatures of the join +point, and if the modifiers of the method or constructor are matched by +any modifier pattern or annotation pattern that may be present. diff --git a/docs/adk15ProgGuideDB/enumeratedtypes.adoc b/docs/adk15ProgGuideDB/enumeratedtypes.adoc new file mode 100644 index 000000000..6124a5e55 --- /dev/null +++ b/docs/adk15ProgGuideDB/enumeratedtypes.adoc @@ -0,0 +1,50 @@ +[[enumeratedtypes]] +== Enumerated Types + +[[enums-in-java5]] +=== Enumerated Types in Java 5 + +Java 5 (and hence AspectJ 5) provides explicit support for enumerated +types. In the simplest case, you can declare an enumerated type as +follows: + +.... +public enum ProgrammingLanguages { + COBOL, C, JAVA, ASPECTJ +} +.... + +Enumerated types are just classes, and they can contain method and field +declarations, and may implement interfaces. Enums may only have private +constructors, and may not be extended. + +Enumerated types in Java 5 all implicitly extend the type +`java.lang.Enum`. It is illegal to explicitly declare a subtype of this +class. + +[[enums-in-aspectj5]] +=== Enumerated Types in AspectJ 5 + +AspectJ 5 supports the declaration of enumerated types just as Java 5 +does. Because of the special restrictions Java 5 places around +enumerated types, AspectJ makes the following additional restrictions: + +* You cannot use declare parents to change the super type of an enum. +* You cannot use declare parents to declare java.lang.Enum as the parent +of any type. +* You cannot make inter-type constructor declarations on an enum. +* You cannot extend the set of values in an enum via any ITD-like +construct. +* You cannot make inter-type method or field declarations on an enum. +* You cannot use declare parents to make an enum type implement an +interface. + +In theory, the last of these two items _could_ be supported. However, +AspectJ 5 follows the simple rule that _an enum type cannot be the +target of an inter-type declaration or declare parents statement_. This +position may be relaxed in a future version of AspectJ. + +If an enum is named explicitly as the target of a declare parents +statement, a compilation error will result. If an enumerated type is +matched by a non-explicit type pattern used in a declare parents +statement it will be ignored (and an XLint warning issued). diff --git a/docs/adk15ProgGuideDB/generics.adoc b/docs/adk15ProgGuideDB/generics.adoc new file mode 100644 index 000000000..3a00cfc52 --- /dev/null +++ b/docs/adk15ProgGuideDB/generics.adoc @@ -0,0 +1,1041 @@ +== Generics + +[[generics-inJava5]] +=== Generics in Java 5 + +This section provides the essential information about generics in Java 5 +needed to understand how generics are treated in AspectJ 5. For a full +introduction to generics in Java, please see the documentation for the +Java 5 SDK. + +==== Declaring Generic Types + +A generic type is declared with one or more type parameters following +the type name. By convention formal type parameters are named using a +single letter, though this is not required. A simple generic list type +(that can contain elements of any type `E`) could be declared: + +.... +interface List { + Iterator iterator(); + void add(E anItem); + E remove(E anItem); +} +.... + +It is important to understand that unlike template mechanisms there will +only be one type, and one class file, corresponding to the `List` +interface, regardless of how many different instantiations of the `List` +interface a program has (each potentially providing a different value +for the type parameter `E`). A consequence of this is that you cannot +refer to the type parameters of a type declaration in a static method or +initializer, or in the declaration or initializer of a static variable. + +A _parameterized type_ is an invocation of a generic type with concrete +values supplied for all of its type parameters (for example, +`List` or `List`). + +A generic type may be declared with multiple type parameters. In +addition to simple type parameter names, type parameter declarations can +also constrain the set of types allowed by using the `extends` keyword. +Some examples follow: + +class Foo \{...}:: + A class `Foo` with one type parameter, `T`. +class Foo \{...}:: + A class `Foo` with two type parameters, `T` and `S`. +class Foo \{...}:: + A class `Foo` with one type parameter `T`, where `T` must be + instantiated as the type `Number` or a subtype of `Number`. +class Foo \{...}:: + A class `Foo` with two type parameters, `T` and `S`. `Foo` must be + instantiated with a type `S` that is a subtype of the type specified + for parameter `T`. +class Foo \{...}:: + A class `Foo` with one type parameter, `T`. `Foo` must be instantiated + with a type that is a subtype of `Number` and that implements + `Comparable`. + +==== Using Generic and Parameterized Types + +You declare a variable (or a method/constructor argument) of a +parameterized type by specifying a concrete type specfication for each +type parameter in the generic type. The following example declares a +list of strings and a list of numbers: + +.... +List strings; +List numbers; +.... + +It is also possible to declare a variable of a generic type without +specifying any values for the type parameters (a _raw_ type). For +example, `List strings`. In this case, unchecked warnings may be issued +by the compiler when the referenced object is passed as a parameter to a +method expecting a parameterized type such as a `List`. New code +written in the Java 5 language would not be expected to use raw types. + +Parameterized types are instantiated by specifying type parameter values +in the constructor call expression as in the following examples: + +.... +List strings = new MyListImpl(); +List numbers = new MyListImpl(); +.... + +When declaring parameterized types, the `?` wildcard may be used, which +stands for "some type". The `extends` and `super` keywords may be used +in conjunction with the wildcard to provide upper and lower bounds on +the types that may satisfy the type constraints. For example: + +List:: + A list containing elements of some type, the type of the elements in + the list is unknown. +List:: + A list containing elements of some type that extends Number, the exact + type of the elements in the list is unknown. +List:: + A list containing elements of some type that is a super-type of + Double, the exact type of the elements in the list is unknown. + +A generic type may be extended as any other type. Given a generic type +`Foo` then a subtype `Goo` may be declared in one of the following +ways: + +class Goo extends Foo:: + Here `Foo` is used as a raw type, and the appropriate warning messages + will be issued by the compiler on attempting to invoke methods in + `Foo`. +class Goo extends Foo:: + `Goo` is a generic type, but the super-type `Foo` is used as a raw + type and the appropriate warning messages will be issued by the + compiler on attempting to invoke methods defined by `Foo`. +class Goo extends Foo:: + This is the most usual form. `Goo` is a generic type with one + parameter that extends the generic type `Foo` with that same + parameter. So `Goo`. +class Goo extends Foo:: + `Goo` is a generic type with two parameters that extends the generic + type `Foo` with the first type parameter of `Goo` being used to + parameterize `Foo`. So `Goo`. +class Goo extends Foo:: + `Goo` is a type that extends the parameterized type `Foo`. + +A generic type may implement one or more generic interfaces, following +the type binding rules given above. A type may also implement one or +more parameterized interfaces (for example, +`class X implements List`, however a type may not at the same +time be a subtype of two interface types which are different +parameterizations of the same interface. + +==== Subtypes, Supertypes, and Assignability + +The supertype of a generic type `C` is the type given in the extends +clause of `C`, or `Object` if no extends clause is present. Given the +type declaration + +.... +public interface List extends Collection {... } +.... + +then the supertype of `List` is `Collection`. + +The supertype of a parameterized type `P` is the type given in the +extends clause of `P`, or `Object` if no extends clause is present. Any +type parameters in the supertype are substituted in accordance with the +parameterization of `P`. An example will make this much clearer: Given +the type `List` and the definition of the `List` given above, +the direct supertype is `Collection`. `List` is _not_ +considered to be a subtype of `List`. + +An instance of a parameterized type `P`may be assigned to a +variable of the same type or a supertype without casting. In addition it +may be assigned to a variable `R` where `R` is a supertype +of `P` (the supertype relationship is reflexive), `m <= n`, and for all +type parameters `S1..m`, `Tm` equals `Sm` _or_ `Sm` is a wildcard type +specification and `Tm` falls within the bounds of the wildcard. For +example, `List` can be assigned to a variable of type +`Collection`, and `List` can be assigned to a variable of +type `List`. + +==== Generic Methods and Constructors + +A static method may be declared with one or more type parameters as in +the following declaration: + +.... +static T first(List ts) { ... } +.... + +Such a definition can appear in any type, the type parameter `T` does +not need to be declared as a type parameter of the enclosing type. + +Non-static methods may also be declared with one or more type parameters +in a similar fashion: + +.... + T max(T t1, T t2) { ... } +.... + +The same technique can be used to declare a generic constructor. + +==== Erasure + +Generics in Java are implemented using a technique called _erasure_. All +type parameter information is erased from the run-time type system. +Asking an object of a parameterized type for its class will return the +class object for the raw type (eg. `List` for an object declared to be +of type `List`. A consequence of this is that you cannot at +runtime ask if an object is an `instanceof` a parameterized type. + +[[generics-inAspectJ5]] +=== Generics in AspectJ 5 + +AspectJ 5 provides full support for all of the Java 5 language features, +including generics. Any legal Java 5 program is a legal AspectJ 5 +progam. In addition, AspectJ 5 provides support for generic and +parameterized types in pointcuts, inter-type declarations, and declare +statements. Parameterized types may freely be used within aspect +members, and support is also provided for generic _abstract_ aspects. + +==== Matching generic and parameterized types in pointcut expressions + +The simplest way to work with generic and parameterized types in +pointcut expressions and type patterns is simply to use the raw type +name. For example, the type pattern `List` will match the generic type +`List` and any parameterization of that type +(`List, List, List` and so on. This ensures +that pointcuts written in existing code that is not generics-aware will +continue to work as expected in AspectJ 5. It is also the recommended +way to match against generic and parameterized types in AspectJ 5 unless +you explicitly wish to narrow matches to certain parameterizations of a +generic type. + +Generic methods and constructors, and members defined in generic types, +may use type variables as part of their signature. For example: + +.... +public class Utils { + + /** static generic method */ + static T first(List ts) { ... } + + /** instance generic method */ + T max(T t1, T t2) { ... } + +} + +public class G { + + // field with parameterized type + T myData; + + // method with parameterized return type + public List getAllDataItems() {...} + +} +.... + +AspectJ 5 does not allow the use of type variables in pointcut +expressions and type patterns. Instead, members that use type parameters +as part of their signature are matched by their _erasure_. Java 5 +defines the rules for determing the erasure of a type as follows. + +Let `|T|` represent the erasure of some type `T`. Then: + +The erasure of a parameterized type + +T + +is + +|T| + +. For example, the erasure of + +List + +is + +List + +. + +The erasure of a nested type + +T.C + +is + +|T|.C + +. For example, the erasure of the nested type + +Foo.Bar + +is + +Foo.Bar + +. + +The erasure of an array type + +T[] + +is + +|T|[] + +. For example, the erasure of + +List[] + +is + +List[] + +. + +The erasure of a type variable is its leftmost bound. For example, the +erasure of a type variable + +P + +is + +Object + +, and the erasure of a type variable + +N extends Number + +is + +Number + +. + +The erasure of every other type is the type itself + +Applying these rules to the earlier examples, we find that the methods +defined in `Utils` can be matched by a signature pattern matching +`static Object Utils.first(List)` and `Number Utils.max(Number, Number)` +respectively. The members of the generic type `G` can be matched by a +signature pattern matching `Object G.myData` and +`public List G.getAllDataItems()` respectively. + +===== Restricting matching using parameterized types + +Pointcut matching can be further restricted to match only given +parameterizations of parameter types (methods and constructors), return +types (methods) and field types (fields). This is achieved by specifying +a parameterized type pattern at the appropriate point in the signature +pattern. For example, given the class `Foo`: + +.... +public class Foo { + + List myStrings; + List myFloats; + + public List getStrings() { return myStrings; } + public List getFloats() { return myFloats; } + + public void addStrings(List evenMoreStrings) { + myStrings.addAll(evenMoreStrings); + } + +} +.... + +Then a `get` join point for the field `myStrings` can be matched by the +pointcut `get(List Foo.myStrings)` and by the pointcut +`get(List Foo.myStrings)`, but _not_ by the pointcut +`get(List *)`. + +A `get` join point for the field `myFloats` can be matched by the +pointcut `get(List Foo.myFloats)`, the pointcut `get(List *)`, +and the pointcut `get(List *)`. This last example shows how +AspectJ type patterns can be used to match type parameters types just +like any other type. The pointcut `get(List *)` does _not_ +match. + +The execution of the methods `getStrings` and `getFloats` can be matched +by the pointcut expression `execution(List get*(..))`, and the pointcut +expression `execution(List<*> get*(..))`, but only `getStrings` is +matched by `execution(List get*(..))` and only `getFloats` is +matched by `execution(List get*(..))` + +A call to the method `addStrings` can be matched by the pointcut +expression `call(* addStrings(List))` and by the expression +`call(* addStrings(List))`, but _not_ by the expression +`call(* addStrings(List))`. + +Remember that any type variable reference in a generic member is +_always_ matched by its erasure. Thus given the following example: + +.... +class G { + List foo(List ls) { return null; } +} +.... + +The execution of `foo` can be matched by `execution(List foo(List))`, +`execution(List foo(List>))`, and +`execution(* foo(List foo(List>)` since the erasure of +`List` is `List` and not `List`. + +===== Generic wildcards and signature matching + +When it comes to signature matching, a type parameterized using a +generic wildcard is a distinct type. For example, `List` is a very +different type to `List`, even though a variable of type +`List` can be assigned to a variable of type `List`. Given +the methods: + +.... +class C { + public void foo(List listOfSomeNumberType) {} + + public void bar(List listOfSomeType) {} + + public void goo(List listOfDoubles) {} +} +.... + +execution(* C.*(List)):: + Matches an execution join point for any of the three methods. +execution(* C.*(List)):: + matches only the execution of `foo`, and _not_ the execution of `goo` + since `List` and `List` are distinct types. +execution(* C.*(List)):: + matches only the execution of `bar`. +execution(* C.*(List)):: + matches both the execution of `foo` and the execution of `bar` since + the upper bound of `List` is implicitly `Object`. + +===== Treatment of bridge methods + +Under certain circumstances a Java 5 compiler is required to create +_bridge methods_ that support the compilation of programs using raw +types. Consider the types + +.... +class Generic { + public T foo(T someObject) { + return someObject; + } +} + +class SubGeneric extends Generic { + public N foo(N someNumber) { + return someNumber; + } +} +.... + +The class `SubGeneric` extends `Generic` and overrides the method `foo`. +Since the upper bound of the type variable `N` in `SubGeneric` is +different to the upper bound of the type variable `T` in `Generic`, the +method `foo` in `SubGeneric` has a different erasure to the method `foo` +in `Generic`. This is an example of a case where a Java 5 compiler will +create a _bridge method_ in `SubGeneric`. Although you never see it, the +bridge method will look something like this: + +.... +public Object foo(Object arg) { + Number n = (Number) arg; // "bridge" to the signature defined in this type +return foo(n); +} +.... + +Bridge methods are synthetic artefacts generated as a result of a +particular compilation strategy and have no execution join points in +AspectJ 5. So the pointcut `execution(Object SubGeneric.foo(Object))` +does not match anything. (The pointcut +`execution(Object Generic.foo(Object))` matches the execution of `foo` +in both `Generic` and `SubGeneric` since both are implementations of +`Generic.foo`). + +It _is_ possible to _call_ a bridge method as the following short code +snippet demonstrates. Such a call _does_ result in a call join point for +the call to the method. + +.... +SubGeneric rawType = new SubGeneric(); +rawType.foo("hi"); // call to bridge method (will result in a runtime failure in this case) +Object n = new Integer(5); +rawType.foo(n); // call to bridge method that would succeed at runtime +.... + +===== Runtime type matching with this(), target() and args() + +The `this()`, `target()`, and `args()` pointcut expressions all match +based on the runtime type of their arguments. Because Java 5 implements +generics using erasure, it is not possible to ask at runtime whether an +object is an instance of a given parameterization of a type (only +whether or not it is an instance of the erasure of that parameterized +type). Therefore AspectJ 5 does not support the use of parameterized +types with the `this()` and `target()` pointcuts. Parameterized types +may however be used in conjunction with `args()`. Consider the following +class + +.... +public class C { + public void foo(List listOfStrings) {} + + public void bar(List listOfDoubles) {} + + public void goo(List listOfSomeNumberType) {} +} +.... + +args(List):: + will match an execution or call join point for any of these methods +args(List):: + will match an execution or call join point for `foo`. +args(List):: + matches an execution or call join point for `bar`, and _may_ match at + an execution or call join point for `goo` since it is legitimate to + pass an object of type `List` to a method expecting a + `List`. + + + In this situation a runtime test would normally be applied to + ascertain whether or not the argument was indeed an instance of the + required type. However, in the case of parameterized types such a test + is not possible and therefore AspectJ 5 considers this a match, but + issues an _unchecked_ warning. For example, compiling the aspect `A` + below with the class `C` produces the compilation warning: "unchecked + match of List with List when argument is an + instance of List at join point method-execution(void C.goo(List)) [Xlint:uncheckedArgument]"; + +.... +public aspect A { + before(List listOfDoubles) : execution(* C.*(..)) && args(listOfDoubles) { + for (Double d : listOfDoubles) { + // do something + } + } +} +.... + +Like all Lint messages, the `uncheckedArgument` warning can be +configured in severity from the default warning level to error or even +ignore if preferred. In addition, AspectJ 5 offers the annotation +`@SuppressAjWarnings` which is the AspectJ equivalent of Java's +`@SuppressWarnings` annotation. If the advice is annotated with +`@SuppressWarnings` then _all_ lint warnings issued during matching of +pointcut associated with the advice will be suppressed. To suppress just +an `uncheckedArgument` warning, use the annotation +`@SuppressWarnings("uncheckedArgument")` as in the following examples: + +.... +import org.aspectj.lang.annotation.SuppressAjWarnings +public aspect A { + @SuppressAjWarnings // will not see *any* lint warnings for this advice + before(List listOfDoubles) : execution(* C.*(..)) && args(listOfDoubles) { + for (Double d : listOfDoubles) { + // do something + } + } + + @SuppressAjWarnings("uncheckedArgument") // will not see *any* lint warnings for this advice + before(List listOfDoubles) : execution(* C.*(..)) && args(listOfDoubles) { + for (Double d : listOfDoubles) { + // do something + } + } +} +.... + +The safest way to deal with `uncheckedArgument` warnings however is to +restrict the pointcut to match only at those join points where the +argument is guaranteed to match. This is achieved by combining `args` +with a `call` or `execution` signature matching pointcut. In the +following example the advice will match the execution of `bar` but not +of `goo` since the signature of `goo` is not matched by the execution +pointcut expression. + +.... +public aspect A { + before(List listOfDoubles) : execution(* C.*(List)) && args(listOfDoubles) { + for (Double d : listOfDoubles) { + // do something + } + } +} +.... + +Generic wildcards can be used in args type patterns, and matching +follows regular Java 5 assignability rules. For example, `args(List)` +will match a list argument of any type, and +`args(List)` will match an argument of type +`List, List, List` and so on. Where a match +cannot be fully statically determined, the compiler will once more issue +an `uncheckedArgument` warning. + +Consider the following program: + +.... +public class C { + public static void main(String[] args) { + C c = new C(); + List ls = new ArrayList(); + List ld = new ArrayList(); + c.foo("hi"); + c.foo(ls); + c.foo(ld); + } + + public void foo(Object anObject) {} +} + +aspect A { + before(List aListOfSomeNumberType) + : call(* foo(..)) && args(aListOfSomeNumberType) { + // process list... + } +} +.... + +From the signature of `foo` all we know is that the runtime argument +will be an instance of `Object`.Compiling this program gives the +unchecked argument warning: "unchecked match of List +with List when argument is an instance of List at join point +method-execution(void C.foo(Object)) [Xlint:uncheckedArgument]". The +advice will not execute at the call join point for `c.foo("hi")` since +`String` is not an instance of `List`. The advice _will_ execute at the +call join points for `c.foo(ls)` and `c.foo(ld)` since in both cases the +argument is an instance of `List`. + +Combine a wildcard argument type with a signature pattern to avoid +unchecked argument matches. In the example below we use the signature +pattern `List` to match a call to any method taking a +`List, List, List` and so on. In addition the +signature pattern `List` can be used to match a call +to a method declared to take a `List`, +`List` and so on. Taken together, these restrict +matching to only those join points at which the argument is guaranteed +to be an instance of `List`. + +.... +aspect A { + before(List aListOfSomeNumberType) + : (call(* foo(List)) || call(* foo(List))) + && args(aListOfSomeNumberType) { + // process list... + } +} +.... + +===== Binding return values in after returning advice + +After returning advice can be used to bind the return value from a +matched join point. AspectJ 5 supports the use of a parameterized type +in the returning clause, with matching following the same rules as +described for args. For example, the following aspect matches the +execution of any method returning a `List`, and makes the returned list +available to the body of the advice. + +.... +public aspect A { + pointcut executionOfAnyMethodReturningAList() : execution(List *(..)); + + after() returning(List listOfSomeType) : executionOfAnyMethodReturningAList() { + for (Object element : listOfSomeType) { + // process element... + } + } +} +.... + +The pointcut uses the raw type pattern `List`, and hence it matches +methods returning any kind of list (`List, List`, and so +on). We've chosen to bind the returned list as the parameterized type +`List` in the advice since Java's type checking will now ensure that +we only perform safe operations on the list. + +Given the class + +.... +public class C { + public List foo(List listOfStrings) {...} + + public List bar(List listOfDoubles) {...} + + public List goo(List listOfSomeNumberType) {...} +} +.... + +The advice in the aspect below will run after the execution of `bar` and +bind the return value. It will also run after the execution of `goo` and +bind the return value, but gives an `uncheckedArgument` warning during +compilation. It does _not_ run after the execution of `foo`. + +.... +public aspect Returning { + after() returning(List listOfDoubles) : execution(* C.*(..)) { + for(Double d : listOfDoubles) { + // process double... + } + } +} +.... + +As with `args` you can guarantee that after returning advice only +executes on lists _statically determinable_ to be of the right type by +specifying a return type pattern in the associated pointcut. The +`@SuppressAjWarnings` annotation can also be used if desired. + +===== Declaring pointcuts inside generic types + +Pointcuts can be declared in both classes and aspects. A pointcut +declared in a generic type may use the type variables of the type in +which it is declared. All references to a pointcut declared in a generic +type from outside of that type must be via a parameterized type +reference, and not a raw type reference. + +Consider the generic type `Generic` with a pointcut `foo`: + +.... +public class Generic { + /** + * matches the execution of any implementation of a method defined for T + */ + public pointcut foo() : execution(* T.*(..)); +} +.... + +Such a pointcut must be refered to using a parameterized reference as +shown below. + +.... +public aspect A { + // runs before the execution of any implementation of a method defined for MyClass + before() : Generic.foo() { + // ... + } + + // runs before the execution of any implementation of a method defined for YourClass + before() : Generic.foo() { + // ... + } + + // results in a compilation error - raw type reference + before() : Generic.foo() { } +} +.... + +==== Inter-type Declarations + +AspectJ 5 supports the inter-type declaration of generic methods, and of +members on generic types. For generic methods, the syntax is exactly as +for a regular method declaration, with the addition of the target type +specification: + + T Utils.max(T first, T second) \{...}:: + Declares a generic instance method `max` on the class `Util`. The + `max` method takes two arguments, `first` and `second` which must both + be of the same type (and that type must be Number or a subtype of + Number) and returns an instance of that type. +static E Utils.first(List elements) \{...}:: + Declares a static generic method `first` on the class `Util`. The + `first` method takes a list of elements of some type, and returns an + instance of that type. + Sorter.new(List elements,Comparator comparator) +\{...}:: + Declares a constructor on the class `Sorter`. The constructor takes a + list of elements of some type, and a comparator that can compare + instances of the element type. + +A generic type may be the target of an inter-type declaration, used +either in its raw form or with type parameters specified. If type +parameters are specified, then the number of type parameters given must +match the number of type parameters in the generic type declaration. +Type parameter _names_ do not have to match. For example, given the +generic type `Foo` then: + +String Foo.getName() \{...}:: + Declares a `getName` method on behalf of the type `Foo`. It is not + possible to refer to the type parameters of Foo in such a declaration. +public R Foo.getMagnitude() \{...}:: + Declares a method `getMagnitude` on the generic class `Foo`. The + method returns an instance of the type substituted for the second type + parameter in an invocation of `Foo` If `Foo` is declared as + `Foo {...}` then this inter-type declaration is + equivalent to the declaration of a method `public N getMagnitude()` + within the body of `Foo`. +R Foo.getMagnitude() \{...}:: + Results in a compilation error since a bounds specification is not + allowed in this form of an inter-type declaration (the bounds are + determined from the declaration of the target type). + +A parameterized type may not be the target of an inter-type declaration. +This is because there is only one type (the generic type) regardless of +how many different invocations (parameterizations) of that generic type +are made in a program. Therefore it does not make sense to try and +declare a member on behalf of (say) `Bar`, you can only declare +members on the generic type `Bar`. + +[[declare-parents-java5]] +==== Declare Parents + +Both generic and parameterized types can be used as the parent type in a +`declare parents` statement (as long as the resulting type hierarchy +would be well-formed in accordance with Java's sub-typing rules). +Generic types may also be used as the target type of a `declare parents` +statement. + +declare parents: Foo implements List:: + The `Foo` type implements the `List` interface. If `Foo` + already implements some other parameterization of the `List` interface + (for example, `List` then a compilation error will result + since a type cannot implement multiple parameterizations of the same + generic interface type. + +==== Declare Soft + +It is an error to use a generic or parameterized type as the softened +exception type in a declare soft statement. Java 5 does not permit a +generic class to be a direct or indirect subtype of `Throwable` (JLS +8.1.2). + +==== Generic Aspects + +AspectJ 5 allows an _abstract_ aspect to be declared as a generic type. +Any concrete aspect extending a generic abstract aspect must extend a +parameterized version of the abstract aspect. Wildcards are not +permitted in this parameterization. + +Given the aspect declaration: + +.... +public abstract aspect ParentChildRelationship { + ... +} +.... + +then + +public aspect FilesInFolders extends +ParentChildRelationship \{...:: + declares a concrete sub-aspect, `FilesInFolders` which extends the + parameterized abstract aspect `ParentChildRelationship`. +public aspect FilesInFolders extends ParentChildRelationship \{...:: + results in a compilation error since the `ParentChildRelationship` + aspect must be fully parameterized. +public aspect ThingsInFolders extends +ParentChildRelationship:: + results in a compilation error since concrete aspects may not have + type parameters. +public abstract aspect ThingsInFolders extends +ParentChildRelationship:: + declares a sub-aspect of `ParentChildRelationship` in which `Folder` + plays the role of parent (is bound to the type variable `P`). + +The type parameter variables from a generic aspect declaration may be +used in place of a type within any member of the aspect, _except for +within inter-type declarations_. For example, we can declare a +`ParentChildRelationship` aspect to manage the bi-directional +relationship between parent and child nodes as follows: + +.... +/** + * a generic aspect, we've used descriptive role names for the type variables + * (Parent and Child) but you could use anything of course + */ +public abstract aspect ParentChildRelationship { + + /** generic interface implemented by parents */ + interface ParentHasChildren{ + List getChildren(); + void addChild(C child); + void removeChild(C child); + } + + /** generic interface implemented by children */ + interface ChildHasParent

{ + P getParent(); + void setParent(P parent); + } + + /** ensure the parent type implements ParentHasChildren */ + declare parents: Parent implements ParentHasChildren; + + /** ensure the child type implements ChildHasParent */ + declare parents: Child implements ChildHasParent; + + // Inter-type declarations made on the *generic* interface types to provide + // default implementations. + + /** list of children maintained by parent */ + private List ParentHasChildren.children = new ArrayList(); + + /** reference to parent maintained by child */ + private P ChildHasParent

.parent; + + /** Default implementation of getChildren for the generic type ParentHasChildren */ + public List ParentHasChildren.getChildren() { + return Collections.unmodifiableList(children); + } + + /** Default implementation of getParent for the generic type ChildHasParent */ + public P ChildHasParent

.getParent() { + return parent; + } + + /** + * Default implementation of addChild, ensures that parent of child is + * also updated. + */ + public void ParentHasChildren.addChild(C child) { + if (child.parent != null) { + child.parent.removeChild(child); + } + children.add(child); + child.parent = this; + } + + /** + * Default implementation of removeChild, ensures that parent of + * child is also updated. + */ + public void ParentHasChildren.removeChild(C child) { + if (children.remove(child)) { + child.parent = null; + } + } + + /** + * Default implementation of setParent for the generic type ChildHasParent. + * Ensures that this child is added to the children of the parent too. + */ + public void ChildHasParent

.setParent(P parent) { + parent.addChild(this); + } + + /** + * Matches at an addChild join point for the parent type P and child type C + */ + public pointcut addingChild(Parent p, Child c) : + execution(* ParentHasChildren.addChild(ChildHasParent)) && this(p) && args(c); + + /** + * Matches at a removeChild join point for the parent type P and child type C + */ + public pointcut removingChild(Parent p, Child c) : + execution(* ParentHasChildren.removeChild(ChildHasParent)) && this(p) && args(c); + +} +.... + +The example aspect captures the protocol for managing a bi-directional +parent-child relationship between any two types playing the role of +parent and child. In a compiler implementation managing an abstract +syntax tree (AST) in which AST nodes may contain other AST nodes we +could declare the concrete aspect: + +.... +public aspect ASTNodeContainment extends ParentChildRelationship { + before(ASTNode parent, ASTNode child) : addingChild(parent, child) { + ... + } +} +.... + +As a result of this declaration, `ASTNode` gains members: + +List children + +ASTNode parent + +ListgetChildren() + +ASTNode getParent() + +void addChild(ASTNode child) + +void removeChild(ASTNode child) + +void setParent(ASTNode parent) + +In a system managing orders, we could declare the concrete aspect: + +.... +public aspect OrderItemsInOrders extends ParentChildRelationship { +} +.... + +As a result of this declaration, `Order` gains members: + +List children + +List getChildren() + +void addChild(OrderItem child) + +void removeChild(OrderItem child) + +and `OrderItem` gains members: + +Order parent + +Order getParent() + +void setParent(Order parent) + +A second example of an abstract aspect, this time for handling +exceptions in a uniform manner, is shown below: + +.... +abstract aspect ExceptionHandling { + + /** + * method to be implemented by sub-aspects to handle thrown exceptions + */ + protected abstract void onException(T anException); + + /** + * to be defined by sub-aspects to specify the scope of exception handling + */ + protected abstract pointcut inExceptionHandlingScope(); + + /** + * soften T within the scope of the aspect + */ + declare soft: T : inExceptionHandlingScope(); + + /** + * bind an exception thrown in scope and pass it to the handler + */ + after() throwing (T anException) : inExceptionHandlingScope() { + onException(anException); + } + +} +.... + +Notice how the type variable `T extends Throwable` allows the components +of the aspect to be designed to work together in a type-safe manner. The +following concrete sub-aspect shows how the abstract aspect might be +extended to handle `IOExceptions`. + +.... +public aspect IOExceptionHandling extends ExceptionHandling{ + + protected pointcut inExceptionHandlingScope() : + call(* doIO*(..)) && within(org.xyz..*); + + /** + * called whenever an IOException is thrown in scope. + */ + protected void onException(IOException ex) { + System.err.println("handled exception: " + ex.getMessage()); + throw new MyDomainException(ex); + } +} +.... diff --git a/docs/adk15ProgGuideDB/grammar.adoc b/docs/adk15ProgGuideDB/grammar.adoc new file mode 100644 index 000000000..df4b33af8 --- /dev/null +++ b/docs/adk15ProgGuideDB/grammar.adoc @@ -0,0 +1,186 @@ +[[grammar]] +== A Grammar for the AspectJ 5 Language + +.... +=== type patterns === + +TypePattern := SimpleTypePattern | + '!' TypePattern | + '(' AnnotationPattern? TypePattern ')' + TypePattern '&&' TypePattern | + TypePattern '||' TypePattern + +SimpleTypePattern := DottedNamePattern '+'? '[]'* + +DottedNamePattern := FullyQualifiedName RestOfNamePattern? | + '*' NotStarNamePattern? + +RestOfNamePattern := '..' DottedNamePattern | + '*' NotStarNamePattern? + +NotStarNamePattern := FullyQualifiedName RestOfNamePattern? | + '..' DottedNamePattern + +FullyQualifiedName := JavaIdentifierCharacter+ ('.' JavaIdentifierCharacter+)* + +=== annotation patterns === + +AnnotationPattern := '!'? '@' AnnotationTypePattern AnnotationPattern* + + +AnnotationTypePattern := FullyQualifiedName | + '(' TypePattern ')' + +=== signature patterns === + +-- field -- + +FieldPattern := + AnnotationPattern? FieldModifiersPattern? + TypePattern (TypePattern DotOrDotDot)? SimpleNamePattern + +FieldModifiersPattern := '!'? FieldModifier FieldModifiersPattern* + +FieldModifier := 'public' | 'private' | 'protected' | 'static' | + 'transient' | 'final' + +DotOrDotDot := '.' | '..' + +SimpleNamePattern := JavaIdentifierChar+ ('*' SimpleNamePattern)? + +-- method -- + +MethodPattern := + AnnotationPattern? MethodModifiersPattern? TypePattern + (TypePattern DotOrDotDot)? SimpleNamePattern + '(' FormalsPattern ')' ThrowsPattern? + +MethodModifiersPattern := '!'? MethodModifier MethodModifiersPattern* + +MethodModifier := 'public' | 'private' | 'protected' | 'static' | + 'synchronized' | 'final' + +FormalsPattern := '..' (',' FormalsPatternAfterDotDot)? | + OptionalParensTypePattern (',' FormalsPattern)* | + TypePattern '...' + +FormalsPatternAfterDotDot := + OptionalParensTypePattern (',' FormalsPatternAfterDotDot)* | + TypePattern '...' + +ThrowsPattern := 'throws' TypePatternList + +TypePatternList := TypePattern (',' TypePattern)* + +-- constructor -- + +ConstructorPattern := + AnnotationPattern? ConstructorModifiersPattern? + (TypePattern DotOrDotDot)? 'new' '(' FormalsPattern ')' + ThrowsPattern? + +ConstructorModifiersPattern := '!'? ConstructorModifier ConstructorModifiersPattern* + +ConstructorModifier := 'public' | 'private' | 'protected' + +=== Pointcuts === + +PointcutPrimitive := + Call | Execution | Get | Set | Handler | + Initialization | PreInitialization | + StaticInitialization | AdviceExecution | + This | Target | Args | CFlow | CFlowBelow | + Within | WithinCode | If | + AnnotationPointcut + +AnnotationPointcut := AtAnnotation | AtThis | AtTarget | + AtWithin | AtWithinCode | AtArgs + + +Call := 'call' '(' MethodOrConstructorPattern ')' + +MethodOrConstructorPattern := MethodPattern | ConstructorPattern + +Execution := 'execution' '(' MethodOrConstructorPattern ')' + +Get := 'get' '(' FieldPattern ')' +Set := 'set' '(' FieldPattern ')' +Handler := 'handler' '(' OptionalParensTypePattern ')' +Initialization := 'initialization' '(' ConstructorPattern ')' +PreInitialization := 'preinitialization' '(' ConstructorPattern ')' +StaticInitialization := 'staticinitialization' '(' OptionalParensTypePattern ')' +AdviceExecution := 'adviceexecution' '(' ')' +This := 'this' '(' TypeOrIdentifier ')' +Target := 'target' '(' TypeOrIdentifier ')' +Args := 'args' '(' FormalsOrIdentifiersPattern ')' +CFlow := 'cflow' '(' Pointcut ')' +CFlowBelow := 'cflowbelow' '(' Pointcut ')' +Within := 'within' '(' OptionalParensTypePattern ')' +WithinCode := 'withincode' '(' OptionalParensTypePattern ')' +If := 'if' '(' BooleanJavaExpression ')' + +TypeOrIdentifier := FullyQualifiedName ('[' ']')* | Identifier +Identifier := JavaIdentifierChar+ + +FormalsOrIdentifiersPattern := + '..' (',' FormalsOrIdentifiersPatternAfterDotDot)? | + TypeOrIdentifier (',' FormalsOrIdentifiersPattern)* | + '*' (',' FormalsOrIdentifiersPattern)* + +FormalsOrIdentifiersPatternAfterDotDot := + TypeOrIdentifier (',' FormalsOrIdentifiersPatternAfterDotDot)* | + '*' (',' FormalsOrIdentifiersPatternAfterDotDot)* + +AtAnnotation := '@annotation' '(' AnnotationOrIdentifier ')' +AtThis := '@this' '(' AnnotationOrIdentifer ')' +AtTarget := '@target' '(' AnnotationOrIdentifier ')' +AtWithin := '@within' '(' AnnotationOrIdentifier ')' +AtWithinCode := '@withincode' '(' AnnotationOrIdentifier ')' + +AnnotationOrIdentifier := FullyQualifiedName | Identifier + +AtArgs := '@args' '(' AnnotationsOrIdentifiersPattern ')' + +AnnotationsOrIdentifiersPattern := + '..' (',' AnnotationsOrIdentifiersPatternAfterDotDot)? | + AnnotationOrIdentifier (',' AnnotationsOrIdentifiersPattern)* | + '*' (',' AnnotationsOrIdentifiersPattern)* + +AnnotationsOrIdentifiersPatternAfterDotDot := + AnnotationOrIdentifier (',' AnnotationsOrIdentifiersPatternAfterDotDot)* | + '*' (',' AnnotationsOrIdentifiersPatternAfterDotDot)* + +PointcutDeclaration := PointcutModifiers? 'pointcut' Identifier Formals + ':' PointcutExpression + +PointcutModifiers := PointcutModifier* + +PointcutModifier := 'public' | 'private' | 'protected' | 'abstract' + +Formals := '(' ParamList? ')' +ParamList := FullyQualifiedName Identifier (',' ParamList)* + +ReferencePointcut := (FullyQualifiedName '.')? Identifier Formals + +PointcutExpression := (PointcutPrimitive | ReferencePointcut) | + '!' PointcutExpression | + '(' PointcutExpression ')' | + PointcutExpression '&&' PointcutExpression | + PointcutExpression '||' PointcutExpression + +=== Advice === + +to be written... + +=== Inter-type Declarations === + +to be written... + +=== Declare Statements === + +to be written... + +=== Aspects === + +to be written... +.... diff --git a/docs/adk15ProgGuideDB/joinpointsignatures.adoc b/docs/adk15ProgGuideDB/joinpointsignatures.adoc new file mode 100644 index 000000000..d8bf63c4d --- /dev/null +++ b/docs/adk15ProgGuideDB/joinpointsignatures.adoc @@ -0,0 +1,336 @@ +[[jpsigs]] +== Join Point Signatures + +Many of the extensions to the AspectJ language to address the new +features of Java 5 are derived from a simple set of principles for join +point matching. In this section, we outline these principles as a +foundation for understanding the matching rules in the presence of +annotations, generics, covariance, varargs, and autoboxing. + +=== Join Point Matching + +AspectJ supports 11 different kinds of join points. These are the +`method call, method execution, constructor call, + constructor execution, field get, field set, pre-initialization, + initialization, static initialization, handler,` and +`advice execution` join points. + +The _kinded_ pointcut designators match based on the kind of a join +point. These are the `call, + execution, get, set, preinitialization, initialization, + staticinitialization, handler,` and `adviceexecution` +designators. + +A kinded pointcut is written using patterns, some of which match based +on _signature_, and some of which match based on _modifiers_. For +example, in the `call` pointcut designator: + +.... +call(ModifierPattern TypePattern TypePattern.IdPattern(TypePatternList) ThrowsPattern) +.... + +the modifiers matching patterns are `ModifierPattern` and +`ThrowsPattern`, and the signature matching patterns are +`TypePattern TypePattern.IdPattern(TypePatternList)`. + +A join point has potentially multiple signatures, but only one set of +modifiers. _A kinded primitive pointcut matches a particular join point +if and only if_: + +[arabic] +. They are of the same kind +. The signature pattern (exactly) matches at least one signature of the +join point +. The modifiers pattern matches the modifiers of the subject of the join +point + +These rules make it very easily to quickly determine whether a given +pointcut matches a given join point. In the next two sections, we +describe what the signature(s) of a join point are, and what the +subjects of join points are. + +[[join-point-signatures]] +=== Join Point Signatures + +Call, execution, get, and set join points may potentially have multiple +signatures. All other join points have exactly one signature. The +following table summarizes the constituent parts of a join point +signature for the different kinds of join point. + +[cols=",,,,,,",options="header",] +|=== +|Join Point Kind |Return Type |Declaring Type |Id |Parameter Types +|Field Type |Exception Type +|Method call |+ |+ |+ |+ | | +|Method execution |+ |+ |+ |+ | | +|Constructor call | |+ | |+ | | +|Constructor execution | |+ | |+ | | +|Field get | |+ |+ | |+ | +|Field set | |+ |+ | |+ | +|Pre-initialization | |+ | |+ | | +|Initialization | |+ | |+ | | +|Static initialization | |+ | | | | +|Handler | | | | | |+ +|Advice execution | |+ | |+ | | +|=== + +Note that whilst an advice execution join point has a signature +comprising the declaring type of the advice and the advice parameter +types, the `adviceexecution` pointcut designator does not support +matching based on this signature. + +The signatures for most of the join point kinds should be +self-explanatory, except for field get and set, and method call and +execution join points, which can have multiple signatures. Each +signature of a method call or execution join point has the same id and +parameter types, but the declaring type and return type (with +covariance) may vary. Each signature of a field get or set join point +has the same id and field type, but the declaring type may vary. + +The following sections examine signatures for these join points in more +detail. + +==== Method call join point signatures + +For a call join point where a call is made to a method +`m(parameter_types)` on a target type `T` (where `T` is the static type +of the target): + +.... +T t = new T(); +t.m("hello"); <= call join point occurs when this line is executed +.... + +Then the signature `R(T) T.m(parameter_types)` is a signature of the +call join point, where `R(T)` is the return type of `m` in `T`, and +`parameter_types` are the parameter types of `m`. If `T` itself does not +declare a definition of `m(parameter_types)`, then `R(T)` is the return +type in the definition of `m` that `T` inherits. Given the call above, +and the definition of `T.m`: + +.... +interface Q { + R m(String s); +} + +class P implements Q { + R m(String s) {...} +} + +class S extends P { + R' m(String s) {...} +} + +class T extends S {} +.... + +Then `R' T.m(String)` is a signature of the call join point for +`t.m("hello")`. + +For each ancestor (super-type) `A` of `T`, if `m(parameter_types)` is +defined for that super-type, then `R(A) A.m(parameter_types)` is a +signature of the call join point, where `R(A)` is the return type of ` + m(parameter_types)` as defined in `A`, or as inherited by +`A` if `A` itself does not provide a definition of `m(parameter_types)`. + +Continuing the example from above,we can deduce that + +.... +R' S.m(String) +R P.m(String) +R Q.m(String) +.... + +are all additional signatures for the call join point arising from the +call `t.m("hello")`. Thus this call join point has four signatures in +total. Every signature has the same id and parameter types, and a +different declaring type. + +==== Method execution join point signatures + +Join point signatures for execution join points are defined in a similar +manner to signatures for call join points. Given the hierarchy: + +.... +interface Q { + R m(String s); +} + +class P implements Q { + R m(String s) {...} +} + +class S extends P { + R' m(String s) {...} +} + +class T extends S { } + +class U extends T { + R' m(String s) {...} +} +.... + +Then the execution join point signatures arising as a result of the call +to `u.m("hello")` are: + +.... +R' U.m(String) +R' S.m(String) +R P.m(String) +R Q.m(String) +.... + +Each signature has the same id and parameter types, and a different +declaring type. There is one signature for each type that provides its +own declaration of the method. Hence in this example there is no +signature `R' T.m(String)` as `T` does not provide its own declaration +of the method. + +==== Field get and set join point signatures + +For a field get join point where an access is made to a field `f` of +type `F` on a object with declared type `T`, then `F T.f` is a signature +of the get join point. + +If `T` does not directly declare a member `f`, then for each super type +`S` of `T`, up to and including the most specific super type of `T` that +does declare the member `f`, `F S.f` is a signature of the join point. +For example, given the hierarchy: + +.... +class P { + F f; +} + +class S extends P { + F f; +} + +class T extends S { } +.... + +Then the join point signatures for a field get join point of the field +`f` on an object with declared type `T` are: + +.... +F S.f +F T.f +.... + +The signatures for a field set join point are derived in an identical +manner. + +=== Join Point Modifiers + +Every join point has a single set of modifiers - these include the +standard Java modifiers such as `public, private, + static, abstract` etc., any annotations, and the throws +clauses of methods and constructors. These modifiers are the modifiers +of the _subject_ of the join point. + +The following table defines the join point subject for each kind of join +point. + +[cols=",",options="header",] +|=== +|Join Point Kind |Subject +|Method call |The method picked out by Java as the static target of the +method call. + +|Method execution |The method that is executing. + +|Constructor call |The constructor being called. + +|Constructor execution |The constructor executing. + +|Field get |The field being accessed. + +|Field set |The field being set. + +|Pre-initialization |The first constructor executing in this constructor +chain. + +|Initialization |The first constructor executing in this constructor +chain. + +|Static initialization |The type being initialized. + +|Handler |The declared type of the exception being handled. + +|Advice execution |The advice being executed. +|=== + +For example, given the following types + +.... +public class X { + @Foo + protected void doIt() {...} +} + +public class Y extends X { + public void doIt() {...} +} +.... + +Then the modifiers for a call to `(Y y) y.doIt()` are simply `{public}`. +The modifiers for a call to `(X x) x.doIt()` are `{@Foo,protected}`. + +[[join-point-matching-summary]] +=== Summary of Join Point Matching + +A join point has potentially multiple signatures, but only one set of +modifiers. _A kinded primitive pointcut matches a particular join point +if and only if_: + +[arabic] +. They are of the same kind +. The signature pattern (exactly) matches at least one signature of the +join point +. The modifiers pattern matches the modifiers of the subject of the join +point + +Given the hierarchy + +.... +interface Q { + R m(String s); +} + +class P implements Q { + @Foo + public R m(String s) {...} +} + +class S extends P { + @Bar + public R' m(String s) {...} +} + +class T extends S {} +.... + +and the program fragment: + +.... +P p = new P(); +S s = new S(); +T t = new T(); +... +p.m("hello"); +s.m("hello"); +t.m("hello"); +.... + +The the pointcut `call(@Foo R P.m(String))` matches the call +`p.m("hello")` since both the signature and the modifiers match. It does +not match the call `s.m("hello")` because even though the signature +pattern matches one of the signatures of the join point, the modifiers +pattern does not match the modifiers of the method m in S which is the +static target of the call. + +The pointcut `call(R' m(String))` matches the calls `t.m("hello")` and +`s.m("hello")`. It does not match the call `p.m("hello")` since the +signature pattern does not match any signature for the call join point +of m in P. diff --git a/docs/adk15ProgGuideDB/ltw.adoc b/docs/adk15ProgGuideDB/ltw.adoc new file mode 100644 index 000000000..18fe224dd --- /dev/null +++ b/docs/adk15ProgGuideDB/ltw.adoc @@ -0,0 +1,8 @@ +[[ltw]] +== Load-Time Weaving + +[[ltw-introduction]] +=== Introduction + +See Developer's Guide for information on load-time weaving support in +AspectJ 5. diff --git a/docs/adk15ProgGuideDB/miscellaneous.adoc b/docs/adk15ProgGuideDB/miscellaneous.adoc new file mode 100644 index 000000000..68c99d2ad --- /dev/null +++ b/docs/adk15ProgGuideDB/miscellaneous.adoc @@ -0,0 +1,66 @@ +[[miscellaneous]] +== Other Changes in AspectJ 5 + +[[pointcuts-change]] +=== Pointcuts + +AspectJ 5 is more liberal than AspectJ 1.2.1 in accepting pointcut +expressions that bind context variables in more than one location. For +example, AspectJ 1.2.1 does not allow: + +.... +pointcut foo(Foo foo) : (execution(* *(..)) && this(foo) ) || + (set(* *) && target(foo)); +.... + +whereas this expression is permitted in AspectJ 5. Each context variable +must be bound exactly once in each branch of a disjunction, and the +disjunctive branches must be mutually exclusive. In the above example +for instance, no join point can be both an execution join point and a +set join point so the two branches are mutually exclusive. + +[[declare-soft-change]] +=== Declare Soft + +The semantics of the `declare soft` statement have been refined in +AspectJ 5 to only soften exceptions that are not already runtime +exceptions. If the exception type specified in a declare soft statement +is `RuntimeException` or a subtype of `RuntimeException` then a new +XLint warning will be issued: + +.... +declare soft : SomeRuntimeException : execution(* *(..)); + +>> "SomeRuntimeException will not be softened as it is already a RuntimeException" [XLint:runtimeExceptionNotSoftened] +.... + +This XLint message can be controlled by setting the +`runtimeExceptionNotSoftened` XLint parameter. + +If the exception type specified in a declare soft statement is a super +type of `RuntimeException` (such as `Exception` for example) then any +_checked_ exception thrown at a matched join point, where the exception +is an instance of the softened exception, will be softened to an +`org.aspectj.lang.SoftException`. + +.... +public aspect SoftenExample { + declare soft : Exception : execution(* Foo.*(..)); +} + +class Foo { + public static void main(String[] args) { + Foo foo = new Foo(); + foo.foo(); + foo.bar(); + } + + void foo() throws Exception { + throw new Exception(); // this will be converted to a SoftException + } + + void bar() throws Exception { + throw new RuntimeException(); // this will remain a RuntimeException + } +} +.... diff --git a/docs/adk15ProgGuideDB/pertypewithin.adoc b/docs/adk15ProgGuideDB/pertypewithin.adoc new file mode 100644 index 000000000..db2df9252 --- /dev/null +++ b/docs/adk15ProgGuideDB/pertypewithin.adoc @@ -0,0 +1,87 @@ +[[pertypewithin]] +== The pertypewithin Aspect Instantiation Model + +AspectJ 5 defines a new per-clause type for aspect instantiation: +`pertypewithin`. Unlike the other per-clauses, `pertypewithin` takes a +type pattern: + +.... +PerTypeWithin := 'pertypewithin' '(' OptionalParensTypePattern ')' +.... + +When an aspect is declared using the `pertypewithin` instantiation +model, one new aspect instance will be created for each type matched by +the associated type pattern. + +Pertypewithin aspects have `aspectOf` and `hasAspect` methods with the +following signatures: + +.... +/** + * return true if this aspect has an instance associated with + * the given type. + */ +public static boolean hasAspect(Class clazz) + +/** + * return the instance associated with the given type. + * Throws NoAspectBoundException if there is no such + * aspect. + */ +public static P aspectOf(Class clazz) +.... + +Where `P` is the type of the `pertypewithin` aspect. + +In addition, `pertypewithin` aspects have a `getWithinTypeName` method +that can be called to return the package qualified name of the type for +which the aspect instance has been created. + +.... +/** + * return the package qualified name (eg. com.foo.MyClass) of the type + * for which the aspect instance has been instantiated. + */ +public String getWithinTypeName() +.... + +In common with the other per-clause instantiation models, the execution +of any advice declared within a `pertypewithin` aspect is conditional +upon an implicit pointcut condition. In this case, that any join point +be `within` the type that the executing aspect is an `aspectOf`. For +example, given the aspect definition + +.... +import java.util.*; + +public aspect InstanceTracking pertypewithin(org.xyz..*) { + + // use WeakHashMap for auto-garbage collection of keys + private Map instances = new WeakHashMap(); + + after(Object o) returning() : execution(new(..)) && this(o) { + instances.put(o,true); + } + + public Set getInstances() { + return instances.keySet(); + } + +} +.... + +Then one aspect instance will be created for each type within +`org.xyz..*`. For each aspect instance, the after returning advice will +match only the execution of constructors within the matched +per-type-within type. The net result is that the aspect tracks all known +instances of each type within `org.xyz..*`. To get access to the +instances, a programmer can simply write +`InstanceTracking.aspectOf(org.xyz.SomeType.class).getInstances()`. + +The `pertypewithin` aspect instantiation model should be used when the +implementation of a crosscutting concern requires that some state be +maintained for each type in a set of types. To maintain state for a +single type, it is easier to use a static inter-type declared field. +Examples of usage include instance tracking, profiling, and the +implementation of a common tracing idiom that uses one Logger per traced +class. diff --git a/docs/adk15ProgGuideDB/reflection.adoc b/docs/adk15ProgGuideDB/reflection.adoc new file mode 100644 index 000000000..acb8c0b75 --- /dev/null +++ b/docs/adk15ProgGuideDB/reflection.adoc @@ -0,0 +1,19 @@ +[[reflection]] +== New Reflection Interfaces + +AspectJ 5 provides a full set of reflection APIs analogous to the +`java.lang.reflect` package, but fully aware of the AspectJ type system. +See the javadoc for the runtime and tools APIs for the full details. The +reflection APIs are only supported when running under Java 5 and for +code compiled by the AspectJ 5 compiler at target level 1.5. + +[[reflection_api]] +=== Using AjTypeSystem + +The starting point for using the reflection apis is +`org.aspectj.lang.reflect.AjTypeSystem` which provides the method +`getAjType(Class)` which will return the `AjType` corresponding to a +given Java class. The `AjType` interface corresponds to +`java.lang.Class` and gives you access to all of the method, field, +constructor, and also pointcut, advice, declare statement and inter-type +declaration members in the type. diff --git a/docs/adk15ProgGuideDB/varargs.adoc b/docs/adk15ProgGuideDB/varargs.adoc new file mode 100644 index 000000000..dce7b8030 --- /dev/null +++ b/docs/adk15ProgGuideDB/varargs.adoc @@ -0,0 +1,141 @@ +== Varargs + +[[varargs-inJava5]] +=== Variable-length Argument Lists in Java 5 + +Java 5 (and hence AspectJ 5) allows you to specify methods that take a +variable number of arguments of a specified type. This is achieved using +an ellipsis (...) in the method signature as shown: + +.... +public void foo(int i, String... strings) { +} +.... + +A method or constructor may take at most one variable length argument, +and this must always be the last declared argument in the signature. + +==== Calling Methods and Constructors with variable-length arguments + +A _varargs_ method may be called with zero or more arguments in the +variable argument position. For example, given the definition of `foo` +above, the following calls are all legal: + +.... +foo(5); +foo(5,"One String"); +foo(7,"One String","Two Strings"); +foo(3,"One String","Two Strings","Three Strings"); +.... + +A _varargs_ parameter is treated as an array within the defining member. +So in the body of `foo` we could write for example: + +.... +public void foo(int i, String... strings) { + String[] someStrings = strings; + // rest of method body +} +.... + +One consequence of this treatment of a varargs parameter as an array is +that you can also call a varargs method with an array: + +.... +foo(7,new String[] {"One String","Two Strings"}); +.... + +[[varargs-in-pcds]] +=== Using Variable-length arguments in advice and pointcut expressions + +AspectJ 5 allows variable-length arguments to be used for methods +declared within aspects, and for inter-type declared methods and +constructors, in accordance with the rules outlined in the previous +section. + +AspectJ 5 also allows variable length arguments to be matched by +pointcut expressions and bound as formals in advice. + +==== Matching signatures based on variable length argument types + +Recall from the definition of signature patterns given in the chapter on +annotations (xref:#signaturePatterns[???]), that `MethodPattern` and +`ConstructorPattern` are extended to allow a `varargs` pattern in the +last argument position of a method or constructor signature. + +.... +FormalsPattern := '..' (',' FormalsPatternAfterDotDot)? | + OptionalParensTypePattern (',' FormalsPattern)* | + TypePattern '...' + +FormalsPatternAfterDotDot := + OptionalParensTypePattern (',' FormalsPatternAfterDotDot)* | + TypePattern '...' +.... + +Method and constructor patterns are used in the `call`, `execution`, +`initialization`, `preinitialization`, and `withincode` pointcut +designators. Some examples of usage follow: + +call(* org.xyz.*.*(int, String...)):: + Matches a call join point for a call to a method defined in the + `org.xyz` package, taking an `int` and a `String vararg`. +execution(* org.xyz.*.*(Integer...)):: + Matches an execution join point for the execution of a method defined + in the `org.xyz` package, taking an `Integer vararg`. +initialization(org.xyz.*.new((Foo || Goo)...)):: + Matches the initialization join point for the construction of an + object in the `org.xyz` package via a constructor taking either a + variable number of `Foo` parameters or a variable number of `Goo` + parameters. (This example illustrating the use of a type pattern with + ...). + +A variable argument parameter and an array parameter are treated as +distinct signature elements, so given the method definitions: + +.... +void foo(String...); +void bar(String[]); +.... + +The pointcut `execution(* *.*(String...))` matches the execution join +point for `foo`, but not `bar`. The pointcut +`execution(* *.*(String[]))` matches the execution join point for `bar` +but not `foo`. + +==== Exposing variable-length arguments as context in pointcuts and advice + +When a varargs parameter is used within the body of a method, it has an +array type, as discussed in the introduction to this section. We follow +the same convention when binding a varargs parameter via the `args` +pointcut designator. Given a method + +.... +public void foo(int i, String... strings) { +} +.... + +The call or execution join points for `foo` will be matched by the +pointcut `args(int,String[])`. It is not permitted to use the varargs +syntax within an args pointcut designator - so you _cannot_ write +`args(int,String...)`. + +Binding of a varargs parameter in an advice statement is +straightforward: + +.... +before(int i, String[] ss) : call(* foo(int,String...)) && args(i,ss) { + // varargs String... argument is accessible in advice body through ss + // ... +} +.... + +Since you cannot use the varargs syntax in the `args` pointcut +designator, you also cannot use the varargs syntax to declare advice +parameters. + +Note: the proposal in this section does not allow you to distinguish +between a join point with a signature (int, String...) and a join point +with a signature (int, String[]) based _solely_ on the use of the `args` +pointcut designator. If this distinction is required, `args` can always +be coupled with `call` or `execution`. diff --git a/docs/devGuideDB/aj.adoc b/docs/devGuideDB/aj.adoc new file mode 100644 index 000000000..6eb84b8cc --- /dev/null +++ b/docs/devGuideDB/aj.adoc @@ -0,0 +1,37 @@ +== `aj`, the AspectJ load-time weaving launcher + +=== Name + +`aj` - command-line launcher for basic load-time weaving + +=== Synopsis + +[subs=+quotes] +aj [_Options_] [_arg_...] + +[[aj]] +=== Description + +The `aj` command runs Java programs in Java 1.4 or later by setting up +`WeavingURLClassLoader` as the system class loader, to do load-time +bytecode weaving. + +The arguments are the same as those used to launch the Java program. +Users should define the environment variables `CLASSPATH` and +`ASPECTPATH`. + +For more information and alternatives for load-time weaving, see +xref:#ltw[???]. + +=== Examples + +Use ajc to build a library, then weave at load time + +.... +REM compile library +${ASPECTJ_HOME}\bin\ajc.bat -outjar lib\aspects.jar @aspects.lst + +REM run, weaving into application at load-time set +ASPECTPATH=lib\aspects.jar set CLASSPATH=app\app.jar +${ASPECTJ_HOME}\bin\aj.bat com.company.app.Main "Hello, World!" +.... diff --git a/docs/devGuideDB/ajbrowser.adoc b/docs/devGuideDB/ajbrowser.adoc new file mode 100644 index 000000000..d0124bd01 --- /dev/null +++ b/docs/devGuideDB/ajbrowser.adoc @@ -0,0 +1,221 @@ +[[ajbrowser]] +== AspectJ Browser + +[[ajbrowser-intro]] +=== Introduction + +AJBrowser presents a GUI for compiling programs with ajc and navigating +crosscutting structure. + +The AspectJ Browser can edit program source files, compile using the +AspectJ compiler `ajc` run a program, and graphically navigate the +program's crosscutting structure. For more information on `ajc`, see +xref:#ajc-ref[???]. + +Launch the browser from the command line either by typing "ajbrowser" to +invoke the script in `{aspectj}/bin` (if AspectJ is installed correctly) +or by using the `aspectjtools.jar` directly, and specifying no arguments +or some number of build configuration files (suffix `.lst`): + +.... +java -jar aspectj1.1/lib/aspectjtools.jar aspectj1.1/doc/examples/spacewar/debug.lst + +.... + +[[ajbrowser-building]] +=== Building Programs + +==== Build Configurations + +A build configuration is a set of files to compile for a program (and +optionally some additional compile arguments). Because `ajc` requires +all sources to be specified (at least using the `-sourceroots` option), +most users create `.lst` files that list the files to compile (one +argument per line, globbing permitted - for more details, see +xref:#ajc-ref[???]). + +To work with a particular program, select the corresponding ".lst" build +configuration file from the GUI using the File menu, "open" item, or by +using the "Open Build Configuration" button +(image:openConfig.gif[image]). You can populate the build list from the +command line by passing any number of ".lst" paths. (However, if you +pass in any non-".lst" arguments, it will run the command-line compiler +directly.) + +To switch between build configurations, select, add, or remove them +using the corresponding toolbar buttons. + +Global build options are stored in an `.ajbrowser` file in your HOME +directory. Edit these from the GUI by clicking the "Options" button or +selecting the Tools menu item "Options...". This is how to set +classpath, aspectpath, etc. + +The following sections walk through a build. + +==== Compiling a Program Build Configuration + +To compile click the "Build" button (image:build.gif[image]), or or use +the tools menu. + +You may select from different build configurations in the GUI (see label +1 in the graphic below). (If you get classpath or other errors, set up +the global build options as described above.) + +image:ajbrowser-building.gif[image] + +[[ajbrowser-navigating]] +=== Navigating Program Structure + +Select nodes in the program structure by clicking them (see label 2). If +one node is related to one or more other nodes by an association the +name of the association will appear below that node and will be +displayed in italics. Links to other structure nodes appear in blue +below the association. If there is no corresponding source for the link +it will appear light-blue. + +image:ajbrowser-building.gif[image] + +[[example]] +==== Example: Exploring the "Spacewar" sample code + +* Launch `ajbrowser` +* Choose "File -> Open" or click the "Open Build Configuration" button +(image:openConfig.gif[image]) and select the configuration file for +debugging the spacewar example, in `examples/spacewar/debug.lst`. +* Click the "Build" button (image:build.gif[image]) to compile. The left +pane should fill with a spacewar declaration tree. If there is a +compiler error, the clickable error message shows up as in label 4. ++ +Note: If you did not set up your classpath, the compile will fail with a +message that you need to install aspectjrt.jar on your compile +classpath. To do that, select "Tools -> Options" or click the "Options" +button (image:browseroptions.gif[image]). Click the `Build Options` tab +to view the Build Paths pane. Edit the classpath entry to use your +install location. For example, if you ran from the base Aspectj +directory, the classpath need only include `lib/aspectjrt.jar` (though +the browser may populate the classpath with the bootclasspath and +classpath initially.) Be sure to use the `lib/aspectjrt.jar` that came +with the browser. ++ +image:ajbrowser-options.gif[image] +* Different structure views: The structure tree at the left can display +different orderings and granularity for structure: +** The package hierarchy view shows the traditional hierarchy of +package, class, and members. +** The inheritance view shows the hierarchy from topmost parent classes +through subclasses to members. +** The crosscutting view shows the aspect members and the code they +affect. +** Additional buttons in the pane can be used to change the granularity +and filter out items. ++ +Whenever you select an item in the tree view, the source pane scrolls to +that item. If you select a leaf item representing another program +element, then the tree selection will go to the corresponding node. (See +below for how to use two panes to maintain your place.) +* When working with aspects, it helps to be able to navigate between +different program elements: +** When looking at a method, find the advice that affects it. +** When looking at a pointcut, find the advice that uses it. +** When looking at advice, find what it advises - e.g., method calls or +executions, initializers, etc. +** When looking at a type, find any aspects that declare members or +supertypes of the type, or vice-versa. ++ +You can view the advice on a particular method using the default, +hierarchical view. Navigate to the tree item for +`spacewar.Registry.register(SpaceObject)` in the `debug.lst` config +file. Now, in the lower, file view, you can see and navigate to the +advice using the subtree whose parent is the `method + affected by` relation. ++ +You can also use crosscutting view to see the advice using a pointcut or +the methods affected by advice. For example, to see what advice uses a +particular pointcut, navigate to the tree item for the pointcut +`spacewar.Debug.allConstructorsCut()` in the `debug.lst` config file. +You can see and navigate to the advice that uses the pointcut using the +`pointcut used by` relation. ++ +As an example of seeing the methods affected by advice, while still in +the same view, select the first `before` advice in `spacewar.Debug`. It +has relation sub-trees for both `uses pointcut` and +`affects constructions`. The `affects` relations will list different +kinds of join points - constructor or method calls, etc. ++ +Note that the AspectJ browser can only display static structure (whether +hierarchical or crosscutting). That means that dynamicly-determined +pointcuts (like `cflow(pointcut)`) will not be shown as picking out +static points in source code. Displayable pointcuts roughly correspond +to those that can be used in a `declare error` statement. + +[[ajbrowser-running]] +=== Running Programs + +The browser supports a limited form of running compiled programs. To run +programs that have been built, click the run button or select one of the +run menu items in the project menu. You can run in the same VM or spawn +a new process; the latter is generally better for GUI programs. + +Both require that any classpath you set be specified using +platform-specific paths and path separators (the compiler might be more +tolerant). Output and error streams will be merged into the streams of +the browser (using separate threads, so it may take a few seconds for +the pipe threads to gain control.) Errors should be detected and +displayed in a dialog. + +The GUI does not support killing a running program, so if your program +might hang, be sure to save your files since you may need to kill the +browser itself to kill its child processes. + +[[ajbrowser-problems]] +=== Isolating problems running the AspectJ browser + +If you have problems with the browser not solved by the documentation, +please try to see if you have the same problems when running ajc +directly on the command line. + +* If the problem occurs on the command line also, then the problem is +not in the browser. (It may be in the compiler; please send bug +reports.) +* If the problem does not occur on the command line, then it may lie in +the parameters you are supplying in the build options. +* If the build options look correct and the problem only occurs when +building from the browser, then please submit a bug report. + +[[ajbrowser-knownProblems]] +==== Known issues with the AspectJ browser + +For the most up-to-date information on known problems, see the +http://bugs.eclipse.org/bugs[bug database] for unresolved +http://bugs.eclipse.org/bugs/buglist.cgi?&product=AspectJ&component=Compiler&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED[compiler +bugs] or +http://bugs.eclipse.org/bugs/buglist.cgi?&product=AspectJ&component=IDE&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED[IDE +bugs] . + +* Memory and forking: Users email most about the browser task running +out of memory. This is not a problem with the browser; some compiles +take a lot of memory, often more than similar compiles using javac. The +browser does not support forking, so the only solution is to edit the +java command line or script that launches the browser to add memory. +* Editing build configuration files: this is not currently supported. +* The structure model is incomplete after incremental compiles. To get a +complete structure model requires a full build. +* If you change the output directory, you must do a full build. + +[[ajbrowser-limitations]] +==== Limitations + +* The AJBrowser expects the package and directory structure to match. If +they do not it will be unable to browse to the corresponding file. +* The "Run" feature launches applications in the same VM. As a result, +if a Swing application is disposed the AJBrowser will be disposed as +well. + +[[ajbrowser-feedback]] +==== AspectJ Browser questions and bugs + +You can send email to aspectj-users@dev.eclipse.org. (Do join the list +to participate!) We also welcome any bug reports, patches, and feature +requests; you can submit them to the bug database at +http://bugs.eclipse.org/bugs using the AspectJ product and IDE +component. diff --git a/docs/devGuideDB/ajc.adoc b/docs/devGuideDB/ajc.adoc new file mode 100644 index 000000000..026eeb79a --- /dev/null +++ b/docs/devGuideDB/ajc.adoc @@ -0,0 +1,492 @@ +== `ajc`, the AspectJ compiler/weaver + +=== Name + +`ajc` - compiler and bytecode weaver for the AspectJ and Java languages + +=== Synopsis + +[subs=+quotes] + ajc [_option_...] [_file_... | @_file_... | -argfile _file_...] + +[[ajc]] +=== Description + +The `ajc` command compiles and weaves AspectJ and Java source and .class +files, producing .class files compliant with any Java VM (1.1 or later). +It combines compilation and bytecode weaving and supports incremental +builds; you can also weave bytecode at run-time using xref:#ltw[???]. + +The arguments after the options specify the source file(s) to compile. +To specify source classes, use `-inpath` (below). Files may be listed +directly on the command line or in a file. The `-argfile file` and +`@file` forms are equivalent, and are interpreted as meaning all the +arguments listed in the specified file. + +`Note:` You must explicitly pass `ajc` all necessary sources. Be sure to +include the source not only for the aspects or pointcuts but also for +any affected types. Specifying all sources is necessary because, unlike +javac, ajc does not search the sourcepath for classes. (For a discussion +of what affected types might be required, see +xref:../progguide/implementation.html[The AspectJ Programming Guide, +Implementation Appendix].) + +To specify sources, you can list source files as arguments or use the +options `-sourceroots` or `-inpath`. If there are multiple sources for +any type, the result is undefined since ajc has no way to determine +which source is correct. (This happens most often when users include the +destination directory on the inpath and rebuild.) + +[[ajc_options]] +==== Options + +-injars :: + deprecated: since 1.2, use -inpath, which also takes directories. +-inpath :: + Accept as source bytecode any .class files in the .jar files or + directories on Path. The output will include these classes, possibly + as woven with any applicable aspects. Path is a single argument + containing a list of paths to zip files or directories, delimited by + the platform-specific path delimiter. +-aspectpath :: + Weave binary aspects from jar files and directories on path into all + sources. The aspects should have been output by the same version of + the compiler. When running the output classes, the run classpath + should contain all aspectpath entries. Path, like classpath, is a + single argument containing a list of paths to jar files, delimited by + the platform- specific classpath delimiter. +-argfile :: + The file contains a line-delimited list of arguments. Each line in the + file should contain one option, filename, or argument string (e.g., a + classpath or inpath). Arguments read from the file are inserted into + the argument list for the command. Relative paths in the file are + calculated from the directory containing the file (not the current + working directory). Comments, as in Java, start with `//` and extend + to the end of the line. Options specified in argument files may + override rather than extending existing option values, so avoid + specifying options like <-classpath> in argument files unlike the + argument file is the only build specification. The form <@file> is the + same as specifying <-argfile file>. +-outjar :: + Put output classes in zip file output.jar. +-outxml:: + Generate aop.xml file for load-time weaving with default name. +-outxmlfile :: + Generate aop.xml file for load-time weaving with custom name. +-incremental:: + Run the compiler continuously. After the initial compilation, the + compiler will wait to recompile until it reads a newline from the + standard input, and will quit when it reads a 'q'. It will only + recompile necessary components, so a recompile should be much faster + than doing a second compile. This requires -sourceroots. +-sourceroots :: + Find and build all .java or .aj source files under any directory + listed in DirPaths. DirPaths, like classpath, is a single argument + containing a list of paths to directories, delimited by the platform- + specific classpath delimiter. Required by -incremental. +-crossrefs:: + Generate a build .ajsym file into the output directory. Used for + viewing crosscutting references by tools like the AspectJ Browser. +-emacssym:: + Generate .ajesym symbol files for emacs support (deprecated). +-Xlint:: + Same as -Xlint:warning (enabled by default) +-Xlint:\{level}:: + Set default level for messages about potential programming mistakes in + crosscutting code. \{level} may be ignore, warning, or error. This + overrides entries in org/aspectj/weaver/XlintDefault.properties from + aspectjtools.jar, but does not override levels set using the + -Xlintfile option. +-Xlintfile :: + Specify properties file to set levels for specific crosscutting + messages. PropertyFile is a path to a Java .properties file that takes + the same property names and values as + org/aspectj/weaver/XlintDefault.properties from aspectjtools.jar, + which it also overrides. +-help:: + Emit information on compiler options and usage +-version:: + Emit the version of the AspectJ compiler +-classpath :: + Specify where to find user class files. Path is a single argument + containing a list of paths to zip files or directories, delimited by + the platform-specific path delimiter. +-bootclasspath :: + Override location of VM's bootclasspath for purposes of evaluating + types when compiling. Path is a single argument containing a list of + paths to zip files or directories, delimited by the platform-specific + path delimiter. +-extdirs :: + Override location of VM's extension directories for purposes of + evaluating types when compiling. Path is a single argument containing + a list of paths to directories, delimited by the platform-specific + path delimiter. +-d :: + Specify where to place generated .class files. If not specified, + defaults to the current working dir. +-target <[1.1 to 1.5]>:: + Specify classfile target setting (1.1 to 1.5, default is 1.2) +-1.3:: + Set compliance level to 1.3 This implies -source 1.3 and -target 1.1. +-1.4:: + Set compliance level to 1.4 (default) This implies -source 1.4 and + -target 1.2. +-1.5:: + Set compliance level to 1.5. This implies -source 1.5 and -target 1.5. +-source <[1.3|1.4|1.5]>:: + Toggle assertions (1.3, 1.4, or 1.5 - default is 1.4). When using + -source 1.3, an assert() statement valid under Java 1.4 will result in + a compiler error. When using -source 1.4, treat `assert` as a keyword + and implement assertions according to the 1.4 language spec. When + using -source 1.5, Java 5 language features are permitted. +-nowarn:: + Emit no warnings (equivalent to '-warn:none') This does not suppress + messages generated by `declare warning` or `Xlint`. +-warn: :: + Emit warnings for any instances of the comma-delimited list of + questionable code (eg '-warn:unusedLocals,deprecation'): ++ +.... +constructorName method with constructor name +packageDefaultMethod attempt to override package-default method +deprecation usage of deprecated type or member +maskedCatchBlocks hidden catch block +unusedLocals local variable never read +unusedArguments method argument never read +unusedImports import statement not used by code in file +none suppress all compiler warnings +.... ++ +`-warn:none` does not suppress messages generated by `declare warning` + or `Xlint`. +-deprecation:: + Same as -warn:deprecation +-noImportError:: + Emit no errors for unresolved imports +-proceedOnError:: + Keep compiling after error, dumping class files with problem methods +-g<:[lines,vars,source]>:: + debug attributes level, that may take three forms: ++ +.... +-g all debug info ('-g:lines,vars,source') +-g:none no debug info +-g:{items} debug info for any/all of [lines, vars, source], e.g., + -g:lines,source +.... +-preserveAllLocals:: + Preserve all local variables during code generation (to facilitate + debugging). +-referenceInfo:: + Compute reference information. +-encoding :: + Specify default source encoding format. Specify custom encoding on a + per file basis by suffixing each input source file/folder name with + '[encoding]'. +-verbose:: + Emit messages about accessed/processed compilation units +-showWeaveInfo:: + Emit messages about weaving +-log :: + Specify a log file for compiler messages. +-progress:: + Show progress (requires -log mode). +-time:: + Display speed information. +-noExit:: + Do not call System.exit(n) at end of compilation (n=0 if no error) +-repeat :: + Repeat compilation process N times (typically to do performance + analysis). +-XterminateAfterCompilation:: + Causes compiler to terminate before weaving +-XaddSerialVersionUID:: + Causes the compiler to calculate and add the SerialVersionUID field to + any type implementing Serializable that is affected by an aspect. The + field is calculated based on the class before weaving has taken place. +-Xreweavable[:compress]:: + (Experimental - deprecated as now default) Runs weaver in reweavable + mode which causes it to create woven classes that can be rewoven, + subject to the restriction that on attempting a reweave all the types + that advised the woven type must be accessible. +-XnoInline:: + (Experimental) do not inline around advice +-XincrementalFile :: + (Experimental) This works like incremental mode, but using a file + rather than standard input to control the compiler. It will recompile + each time file is changed and and halt when file is deleted. +-XserializableAspects:: + (Experimental) Normally it is an error to declare aspects + Serializable. This option removes that restriction. +-XnotReweavable:: + (Experimental) Create class files that can't be subsequently rewoven + by AspectJ. +-Xajruntimelevel:1.2, ajruntimelevel:1.5:: + (Experimental) Allows code to be generated that targets a 1.2 or a 1.5 + level AspectJ runtime (default 1.5) + +==== File names + +ajc accepts source files with either the `.java` extension or the `.aj` +extension. We normally use `.java` for all of our files in an AspectJ +system -- files that contain aspects as well as files that contain +classes. However, if you have a need to mechanically distinguish files +that use AspectJ's additional functionality from those that are pure +Java we recommend using the `.aj` extension for those files. + +We'd like to discourage other means of mechanical distinction such as +naming conventions or sub-packages in favor of the `.aj` extension. + +* Filename conventions are hard to enforce and lead to awkward names for +your aspects. Instead of `TracingAspect.java` we recommend using +`Tracing.aj` (or just `Tracing.java`) instead. +* Sub-packages move aspects out of their natural place in a system and +can create an artificial need for privileged aspects. Instead of adding +a sub-package like `aspects` we recommend using the `.aj` extension and +including these files in your existing packages instead. + +==== Compatibility + +AspectJ is a compatible extension to the Java programming language. The +AspectJ compiler adheres to the +http://java.sun.com/docs/books/jls/index.html[The Java Language +Specification, Second Edition] and to the +http://java.sun.com/docs/books/vmspec/index.html[The Java Virtual +Machine Specification, Second Edition] and runs on any Java 2 compatible +platform. The code it generates runs on any Java 1.1 or later compatible +platform. For more information on compatibility with Java and with +previous releases of AspectJ, see xref:#versionCompatibility[???]. + +==== Examples + +Compile two files: + +.... +ajc HelloWorld.java Trace.java +.... + +To avoid specifying file names on the command line, list source files in +a line-delimited text argfile. Source file paths may be absolute or +relative to the argfile, and may include other argfiles by @-reference. +The following file `sources.lst` contains absolute and relative files +and @-references: + +.... +Gui.java +/home/user/src/Library.java +data/Repository.java +data/Access.java +@../../common/common.lst +@/home/user/src/lib.lst +view/body/ArrayView.java +.... + +Compile the files using either the -argfile or @ form: + +.... +ajc -argfile sources.lst +ajc @sources.lst +.... + +Argfiles are also supported by jikes and javac, so you can use the files +in hybrid builds. However, the support varies: + +* Only ajc accepts command-line options +* Jikes and Javac do not accept internal @argfile references. +* Jikes and Javac only accept the @file form on the command line. + +Bytecode weaving using -inpath: AspectJ 1.2 supports weaving .class +files in input zip/jar files and directories. Using input jars is like +compiling the corresponding source files, and all binaries are emitted +to output. Although Java-compliant compilers may differ in their output, +ajc should take as input any class files produced by javac, jikes, +eclipse, and, of course, ajc. Aspects included in -inpath will be woven +into like other .class files, and they will affect other types as usual. + +Aspect libraries using -aspectpath: AspectJ 1.1 supports weaving from +read-only libraries containing aspects. Like input jars, they affect all +input; unlike input jars, they themselves are not affected or emitted as +output. Sources compiled with aspect libraries must be run with the same +aspect libraries on their classpath. + +The following example builds the tracing example in a command-line +environment; it creates a read-only aspect library, compiles some +classes for use as input bytecode, and compiles the classes and other +sources with the aspect library. + +The tracing example is in the AspectJ distribution +(\{aspectj}/doc/examples/tracing). This uses the following files: + +.... +aspectj1.1/ + bin/ + ajc + lib/ + aspectjrt.jar + examples/ + tracing/ + Circle.java + ExampleMain.java + lib/ + AbstractTrace.java + TraceMyClasses.java + notrace.lst + Square.java + tracelib.lst + tracev3.lst + TwoDShape.java + version3/ + Trace.java + TraceMyClasses.java +.... + +Below, the path separator is taken as ";", but file separators are "/". +All commands are on one line. Adjust paths and commands to your +environment as needed. + +Setup the path, classpath, and current directory: + +.... +cd examples +export ajrt=../lib/aspectjrt.jar +export CLASSPATH="$ajrt" +export PATH="../bin:$PATH" +.... + +Build a read-only tracing library: + +.... +ajc -argfile tracing/tracelib.lst -outjar tracelib.jar +.... + +Build the application with tracing in one step: + +.... +ajc -aspectpath tracelib.jar -argfile tracing/notrace.lst -outjar tracedapp.jar +.... + +Run the application with tracing: + +.... +java -classpath "$ajrt;tracedapp.jar;tracelib.jar" tracing.ExampleMain +.... + +Build the application with tracing from binaries in two steps: + +* (a) Build the application classes (using javac for +demonstration's sake): ++ +.... +mkdir classes +javac -d classes tracing/*.java +jar cfM app.jar -C classes . +.... +* (b) Build the application with tracing: ++ +.... +ajc -inpath app.jar -aspectpath tracelib.jar -outjar tracedapp.jar +.... + +Run the application with tracing (same as above): + +.... +java -classpath "$ajrt;tracedapp.jar;tracelib.jar" tracing.ExampleMain +.... + +Run the application without tracing: + +.... +java -classpath "app.jar" tracing.ExampleMain +.... + +==== The AspectJ compiler API + +The AspectJ compiler is implemented completely in Java and can be called +as a Java class. The only interface that should be considered public are +the public methods in `org.aspectj.tools.ajc.Main`. E.g., +`main(String[] args)` takes the the standard `ajc` command line +arguments. This means that an alternative way to run the compiler is + +[subs=+quotes] + java org.aspectj.tools.ajc.Main [_option_...] [_file_...] + +To access compiler messages programmatically, use the methods +`setHolder(IMessageHolder holder)` and/or +`run(String[] args, IMessageHolder holder)`. `ajc` reports each message +to the holder using `IMessageHolder.handleMessage(..)`. If you just want +to collect the messages, use `MessageHandler` as your `IMessageHolder`. +For example, compile and run the following with `aspectjtools.jar` on +the classpath: + +.... +import org.aspectj.bridge.*; +import org.aspectj.tools.ajc.Main; +import java.util.Arrays; + +public class WrapAjc { + public static void main(String[] args) { + Main compiler = new Main(); + MessageHandler m = new MessageHandler(); + compiler.run(args, m); + IMessage[] ms = m.getMessages(null, true); + System.out.println("messages: " + Arrays.asList(ms)); + } +} +.... + +==== Stack Traces and the SourceFile attribute + +Unlike traditional java compilers, the AspectJ compiler may in certain +cases generate classfiles from multiple source files. Unfortunately, the +original Java class file format does not support multiple SourceFile +attributes. In order to make sure all source file information is +available, the AspectJ compiler may in some cases encode multiple +filenames in the SourceFile attribute. When the Java VM generates stack +traces, it uses this attribute to specify the source file. + +(The AspectJ 1.0 compiler also supports the .class file extensions of +JSR-45. These permit compliant debuggers (such as jdb in Java 1.4.1) to +identify the right file and line even given many source files for a +single class. JSR-45 support is planned for ajc in AspectJ 1.1, but is +not in the initial release. To get fully debuggable .class files, use +the -XnoInline option.) + +Probably the only time you may see this format is when you view stack +traces, where you may encounter traces of the format + +.... +java.lang.NullPointerException + at Main.new$constructor_call37(Main.java;SynchAspect.java[1k]:1030) +.... + +where instead of the usual + +.... +File:LineNumber +.... + +format, you see + +.... +File0;File1[Number1];File2[Number2] ... :LineNumber +.... + +In this case, LineNumber is the usual offset in lines plus the "start +line" of the actual source file. That means you use LineNumber both to +identify the source file and to find the line at issue. The number in +[brackets] after each file tells you the virtual "start line" for that +file (the first file has a start of 0). + +In our example from the null pointer exception trace, the virtual start +line is 1030. Since the file SynchAspect.java "starts" at line 1000 +[1k], the LineNumber points to line 30 of SynchAspect.java. + +So, when faced with such stack traces, the way to find the actual source +location is to look through the list of "start line" numbers to find the +one just under the shown line number. That is the file where the source +location can actually be found. Then, subtract that "start line" from +the shown line number to find the actual line number within that file. + +In a class file that comes from only a single source file, the AspectJ +compiler generates SourceFile attributes consistent with traditional +Java compilers. diff --git a/docs/devGuideDB/ajdb.adoc b/docs/devGuideDB/ajdb.adoc new file mode 100644 index 000000000..f1b02d910 --- /dev/null +++ b/docs/devGuideDB/ajdb.adoc @@ -0,0 +1,326 @@ +ajdb + +debugger for .class files produced by ajc (early-access) + +ajdb + +-classpath + +path + +-D + +name + += + +value + +-help + +-gui + +-read + +file + +-sourcepath + +dir + +-v + +-verbose + +:class + +:gc + +:jni + +workingdir + +dir + +-X + +option + +class + +arguments + +== Description + +The command `ajdb` is used to debug AspectJ and Java programs. In +addition to its command line interface, `adjb` also has a standalone, +Swing-based GUI interface. + +Note: As of the 1.0.3 release, AspectJ supports JSR-45, which provides +source-level debugging from many source files per class and non-Java +source files. JSR-45 is implemented in the J2SE 1.4 debugger support, so +you may be able to use your existing debugger to step through AspectJ +source code if both the source and target VM's are running under Java +1.4 or later. However, existing debuggers will display synthetic methods +in the stack frame. + +-classpath + +path + +Specify where to find user class files. + +-D + +name + += + +value + +Define the property + +name + +to have the value + +value + +. + +-help + +Print out + +ajdb + +'s usage summary. + +-read + +file + +Read this file for initializatoin commands. + +-sourcepath + +path + +Search this directory for source files. + +-gui + +-v | -verbose [:class | :gc | :jni] + +Print out class loading, garbage collection or dynamic library loading +information. Defaults to class loading. + +-workingdir + +directory + +Set + +ajdb + +'s working directory. + +-X + +option + +Pass a non-standard option to the VM + +=== Capabilities + +The AspectJ debugger implements all of `jdb`'s commands. In addition, +the command `workingdir` allow you to set the AspectJ working directory, +and the breakpoint command, `stop on`, has been extended to allow the +setting of breakpoint on a source file line. + +=== Examples + +Suppose you want to debug the file spacewar/Ship.java found in the +examples directory. At the command line start up the debugger: ` + ajdb + ` + +The debugger will first look for initialization files in your home or +current directory called either `ajdb.ini` or `.ajdbrc` and execute the +commands contained in them. A useful command to have in this file is the +`source-path` command which tells the debugger where to find source +files. + +For this example, we need to set the source path by: ` + use C:\src + ` + +To view the file to debug, type `list + spacewar/Ship.java` which generates the following output: + +.... +209 void fire() { +210 // firing a shot takes energy +211 if (!expendEnergy(BULLET_ENERGY)) +212 return; +213 +214 //create a bullet object so it doesn't hit the ship that's firing it +215 double xV = getXVel() + BULLET_SPEED * (Math.cos(orientation)); +216 double yV = getYVel() + BULLET_SPEED * (Math.sin(orientation)); +217 +218 // create the actual bullet +219 new Bullet( +220 getGame(), +221 (getXPos() + ((getSize()/2 + 2) * (Math.cos(orientation))) + xV), +222 (getYPos() + ((getSize()/2 + 2) * (Math.sin(orientation))) + yV), +223 xV, +224 yV); +225 } + +.... + +This is different from `jdb` because it allows one to view files before +the debugger has started. The `list` command has the following syntax: + +list + +list the source containing the location at which we are currently +stopped (can only be used with a running VM) + +list + +source + +list the entire file source + +list + +source line + +list source line line of file source + +list + +source start-line end-line + +list the lines from + +start-line + +to + +end-line + +of file + +source + +To set a breakpoint in the method `Ship.fire`, we would could type +`stop in spacewar.Ship.fire`. + +The following message appears notifying the user that the breakpoint has +been noted but will not be set until the class has been loaded by the +VM: + +.... +Deferring breakpoint spacewar.Ship.fire() +It will be set after the class is loaded. + +.... + +To start Spacewar we type `run spacewar.Game`. + +When the breakpoint is set, the following message appears: + +.... +Set deferred breakpoint spacewar.Ship.fire() + +.... + +We are notified that we've hit the breakpoint: + +.... +Breakpoint hit: thread="Thread-2", spacewar.Ship.fire(), line=174, bci=0 209 void fire() { + +.... + +The prompt changes to present the thread that has broken, and we can +view the current stack with the `where` command, as follows: + +.... +Thread-2[1] where +[1] fire (spacewar\Ship.java:209) +[2] run (spacewar\Robot.java:100) +[3] run [class java.lang.Thread] + +.... + +Next, to stop on line 216 we type `stop on spacewar/Ship.java:216` + +The following message tells us the breakpoint was set: + +.... +Set breakpoint Ship.java:216 + +.... + +To continue execution, we type `cont` and the breakpoint at line 216 is +hit + +.... +Breakpoint hit: thread="Thread-2", spacewar.Ship.fire(), line=216, bci=28 +216 double yV = getYVel() + BULLET_SPEED * (Math.sin(orientation)); + +.... + +To view the visible local variables, we type `locals` and ajdb responds +with: + +.... +Local variables +xV = 12.242462584304468 + +.... + +To change the value of the local variable i to 15, we type +`set xV = 16.1` + +.... +Changed 'xV' from '12.242462584304468' to '16.1' + +.... + +To see our changes we can print the value of `i` by the following: + +.... +print xV +Value for printing 'xV' = 12.242462584304468 + +.... + +We can now type exit or quit to leave the debugger, and we receive the +following message: + +.... +The application has exited. + +.... + +=== The AspectJ debugger API + +The AspectJ debugger is implemented completely in Java and can be called +as a Java class. The only interface that should be considered public is +the method `org.aspectj.tools.debugger.Main.main(String[] + args)` where `args` are the standard `ajc` command line arguments. +This means that an alternative way to run the compiler is + +java org.aspectj.tools.debugger.Main + +option + +class + +arguments + +You must additionally include `tools.jar` from your Java developer's kit +in your classpath. diff --git a/docs/devGuideDB/ajdee.adoc b/docs/devGuideDB/ajdee.adoc new file mode 100644 index 000000000..9d8963179 --- /dev/null +++ b/docs/devGuideDB/ajdee.adoc @@ -0,0 +1,244 @@ +AJDEE + +JDEE support for XEmacs and GNU Emacs + +== AJDE for Emacs User's Guide + +This guide describes AspectJ-mode extensions of JDEE for GNU Emacs and +XEmacs, which provides enhanced editing and management of AspectJ code +via a minor mode extension of JDE mode. AJDEE's AspectJ support builds +on xref:#aspectj-mode[aspectj-mode's] extension of java-mode, also +provided with the release. Included in this document are guidance for +AJDEE's xref:#ajdee-featuresandusage[use], including an +xref:#exploringspacewar[exploration of spacewar], and +xref:#ajdee-installationetc[installation and compatibility]. See the +README file in AJDEE's distribution directory for release-specific +details. + +In addition to the java-mode extensions provided by +xref:#aspectj-mode[aspectj-mode], AJDEE provides (see graphic): + +* Viewing and navigation of aspect structures via the the speedbar and +Classes menu. +* Basic support for completion. +* Integrated Javadoc support. + +image:ajdee.gif[image] + +[[ajdee-featuresandusage]] +== AJDEE Features and Usage + +The AJDEE extensions of JDE require no special effort to use. The +speedbar and Classes menus provide additional sublists showing +crosscutting structure. Selecting items in those lists navigates to the +referenced item. + +=== Aspect Structure and Navigation + +==== Enhancements to Speedbar in JDE Mode + +As a minor mode of JDE mode, AJDEE enhances the speedbar to show the +location of aspect, advice, and inter-type declarations. The +affects/affected-by relationships are shown in the speedbar rather than +embedding tags in the text (available as an option), and selecting the +items in the speedbar will perform the expected navigation. The speedbar +symbols have been extended for AspectJ as follows (see right side of +xref:#ajdeemacsscreenshot[figure)]: + +.Enhancements to Speedbar in JDE Mode +[cols=",",options="header",] +|=== +|Indication |Meaning +|`(+) ` _`name`_ |A class, interface, or aspect; double mouse-1 will +display its declarations +|`+ ` _`methodSignature`_ |Method has an advice that applies to it; +double mouse-1 will display the relevant advice. +|`+ ` _`adviceSignature`_ |Advice declared by the containing aspect; +double mouse-1 will display affected methods. +|`+ ` _`introductionSig`_ |Inter-type declaration declared by the +containing class; double mouse-1 will display affected methods or +classes. +|`| | ` _`methodOrFieldSig`_ |Method or field has been declared by an +aspect; double mouse-1 on text will navigate to the declaration; a + +within the bars means that it has an advice that applies to it. +|=== + +A minus (`-`) is displayed on the item when the crosscutting items are +displayed. AspectJ structure information is derived from the last +compile of your AspectJ program. + +=== Compilation and JavaDoc + +The option `AspectJ Compile File Specification` can be customized from +the Customize options under the AspectJ menu, changing the default +compile specification given to `ajc`. See +xref:#ajdee-installationetc[installation instructions] for examples and +other customizations. + +AspectJ JavaDoc support is enabled by setting `Jde Javadoc Command Path` +to invoke `ajdoc`. These are the default settings provided in the +installation instructions. + +[[exploringspacewar]] +== Exploring the Spacewar Source Code + +To begin exploring Spacewar within emacs using JDE and AspectJ mode: + +* Compile spacewar. +* Change into the `spacewar` directory. +* Type `emacs Ship.java`. +* Pull down the JDE menu and select the Speedbar entry to show the +AspectJ files in the directory. Note that `Ship.java` is shown in red to +denote that it is currently shown in the main buffer. +* Double-click with the left mouse button on the `+` in front of the +`Ship.java` entry. It should display an entry for the class `Ship`. +* Double-clicking on Ship will navigate to its declaration in the +buffer. Note that declarations of advice are annotated to note the types +of objects that they advise, declarations of methods that are advised +are annotated with the aspects that advise them, and so forth. +* Double-clicking on the `+` in front of either will show the declared +fields, methods, inter-type declarations, and advice. A `+` in front of +any field or method means that it is introduced or advised; +double-clicking will list entries for the introducers/advisers; +double-clicking on them will navigate to their declarations. A `+` in +front of any inter-type declarations or advice will will display its +targets. + +[[ajdee-installationetc]] +== Installation and Compatibility + +AJDEE requires the installation of http://sunsite.auc.dk/jde[JDE +2.2.9beta4] or higher and small edits to your `.emacs` file to configure +AJDEE and enable autoloading AJDEE when a `.java` file is loaded. + +=== Installation for enhancement of JDE mode + +The first and last steps, with enhancements, can be found in the example +Emacs initialization file `sample.emacs` and the sample JDE project file +`sample.prj` in the distribution. The latter also demonstrates a way to +enable AspectJ mode on a per-project basis. + +[arabic] +. Make sure AJDEE, aspectj-mode, JDE, and supporting packages are on +your `load-path` and are ``required''. This is an example for the 1.0 +release: ++ +.... + ;; I keep my emacs packages in C:/Emacs + (setq load-path + (append +'( + "C:/Emacs/aspectj-emacsMode-1.0" ; for AJDEE + "C:/Emacs/aspectj-emacsAJDEE-1.0" + "C:/Emacs/jde-2.2.9beta6/lisp" + "C:/Emacs/elib-1.0" ; for JDEE + "C:/Emacs/speedbar-0.14beta2" ; for JDEE + "C:/Emacs/semantic-1.4beta12" ; for JDEE/speedbar + "C:/Emacs/eieio-0.17beta3" ; for JDEE + ) +load-path)) + + (require 'jde) + (require 'ajdee) ; can also appear in prj.el + +.... +. _[Optional]_ add `-emacssym` switch to the `ajc` and `ajc.bat` files +in your AspectJ tools installations (in the `/bin` directory). If you +invoke the compiler outside Emacs, this will ensure that your compiles +always generate information for annotations and the jump menu in the +form of `.ajesym` files. +. Customize AJDEE's compile options by putting a version of the +following in your `.emacs` file or in a JDE project file `prj.el` in +your project's hierarchy (see the `JDE Project File Name` option for the +latter). Here is a simple example: ++ +.... +;; A default version for simple projects, maybe good for +;;; .emacs file. +(custom-set-variables +'(jde-compiler '("ajc" "ajc")) +'(jde-javadoc-command-path "ajdoc") + +;; ajc requires all files to be named for a compile +'(aspectj-compile-file-specification "*.java")) + +.... ++ +Here is an example for spacewar, in `examples/spacewar`. ++ +.... +;;; These options are for the spacewar, in examples/spacewar. +(custom-set-variables +'(jde-compiler '("ajc" "ajc")) +'(jde-javadoc-command-path "ajdoc") + +;; ajc provides an ``argfile'' mechanism for specifying all files. +'(aspectj-compile-file-specification "-argfile demo.lst") + +;; *if* compiling packages, name root dir for package hierarchy +;; to tell ajc where .class files should go. +'(jde-compile-option-directory "..") +'(jde-run-working-directory "..")) +'(jde-run-application-class "spacewar.Game") + +.... +. _[XEmacs only]_ If you're installing JDE yourself, be sure to closely +follow the JDE installation directions for XEmacs, otherwise you may get +out of date JDE `.jar` files. + +=== Customizing Options + +Selecting Customize options from the AspectJ menu displays a number of +options that customize AspectJ mode. These control whether annotations +are shown by default, and whether the bovinator set up by JDE runs. +`AspectJ Compile File Specification`, specifies a compilation argument +as an alternative to the current buffer's file or the run class's file. +Example customizations are shown above and in the sample files discussed +above. + +== Usage and Upgrade Problems + +Please see the documentation for + +aspectj-mode + +for problems not specific to AJDEE's features. + +* _Symptom_: Get standard speedbar menus in JDE; no annotations display. +Message: ++ +.... +AspectJ Mode Warning: Can't find declarations file for... +.... ++ +AspectJ file has not been compiled with ajc and the `-emacssym` flag, or +was compiled with an obsolete version of ajc. After compilation, there +should be a .ajesym for every .java in the build. If .ajsym +files are present but error persists, recompile. Note that aspectj-mode +for JDE has a fallback view for uncompiled files. +* _Symptom_: Navigations via the speedbar and the jump menu are off, +annotations are misplaced in the code. ++ +AspectJ mode operates by querying data derived from the most recent +compile that includes the `-emacssym` flag. Recompile the entire program +with ajc including the switch. Consider permanently installing the +switch by editing the ajc and ajc.bat files in the /bin file in your +distribution. +* _Symptom_: Java files that are part of a Java project not written in +AspectJ come up in aspectj-mode. ++ +Emacs uses the file suffix (.java) to determine which mode to invoke. +You can either globally toggle the AspectJ features from the AspectJ +menu, or you can prevent AJDEE from coming up by moving the (require +'ajdee) expression from your .emacs file to a prj.el file in each +AspectJ project's directory (see sample.prj in the distribution). +* _Symptom_: Reported bug fixes and new features to AJDEE are not seen, +or ajdee.el cannot be found or loaded, with message: ++ +.... +Error in init file: File error: "Cannot open load file", "ajdee" +.... ++ +Your load-path variable (set in your .emacs) is referring to an old +release. Change your load-path to point at the directory for the current +release. See the sample.emacs files in the distribution, for example. diff --git a/docs/devGuideDB/ajdeforte.adoc b/docs/devGuideDB/ajdeforte.adoc new file mode 100644 index 000000000..a03946aae --- /dev/null +++ b/docs/devGuideDB/ajdeforte.adoc @@ -0,0 +1,100 @@ +AspectJ Development Environment (AJDE) support for Forte + +Module extension to Sun's + +Forte for Java + +and + +NetBeans + +IDEs. + +== Overview + +For release-specific documentation refer to the +http://aspectj.org/doc/dist/changes.html[changes file]. + +AJDE for Forte will allow you to: + +* compile AspectJ and Java files within the IDE +* browse the structure of your AspectJ program +* set up a compile configuration that determine which files will be +passed to the compiler + +== Installation + +* use the installer to place the "ajdeForForte.jar" and "aspectjrt.jar" +into the modules directory. This will also install the two html files +"LICENCE-AJDEFORTE.html" and "README-AJDEFORTE.html". +* start up, and in the "Tools" menu select "Global Options" +* right-click the "Modules" item and select "New Module from File..." +* find the ajdeForForte.jar in the directory that you installed into +(e.g. c:/forte4j/modules) and select it + +To uninstall follow Forte's documentation on un-installing modules, or +simply remove the file modules/aspectjForForte.jar from Forte's install +directory. + +== Running AJDE for Forte + +*3.1 Setting up the AspectJ Examples (in NetBeans 3.3.1)* + +* in the "Project" menu select "Project Manager" +* Click "New..." and enter "AspectJ Examples" as the projects' name and +click "OK". +* In the "Filesystems" Explorer tab right click "Filesystems", then +select "Mount -> Local Directory". +* browse into the AspectJ install directory (e.g. "C:/apps/aspectj1.0") +* select "examples" and click "Finish" +* In the "Tools" menu select "AspectJ -> Start AJDE" or just click on +the "AJDE" (image:startAjde.gif[image]) button (shown as label 1 of the +screenshot). + +*3.2 Compiling the Spacewar Example* + +* After AJDE is started, a new "AspectJ" tab is added to the explorer +window. Click it. The next thing to do is to choose a particular build, +since there are many in the examples distribution. To the right of the +"Build" button (image:build.gif[image]) there is a downward arrow. Click +it, and select "spacewar/demo.lst" (as in label 2 of the screenshot). +This will start a build of the demo configuration of spacewar. Clicking +the "Build" button will rebuild. +* When the compile is finished and the "AspectJ Explorer" structure is +present navigate the structure by clicking nodes (as shown in label 3 of +the screenshot). Note that associations between nodes appear with +UML-style arrow icons and italicized names and reperesent how a +particular node in the structure relates to others. In order to navigate +these associations expand the notes and click the corresponding links +(in blue). These links represent structure nodes elsewhere in the tree. +* If there are compilation errors, clickable messages will appear (as in +label 4 of the screenshot). + +*3.3 Running the Spacewar Example* + +* In the "Filesystems" Explorer tab open the "spacewar" directory, right +click "spacewar/Game.java", and the select "Execute". +* When finished executing switch back to the "Editing" mode. +* Select and build the "debug.lst" configuration as described in 3.2 and +execute again--you will notice that the debug configuration adds a debug +window used for tracing by including the "Debug.java" aspect in the +compile. + +3.4 Debugging the Spacewar Example + +* You must first add the filesystem to the project so that the debugger +can see the main class. Do this in the "Project AspectJ Examples" tab in +the explorer by right clicking the root node and selecting "Add +Existing...". +* You may now need to add the AspectJ Runtime to the project so that the +debugger can see it. In the same way as described in 3.1 select "Mount +-> Archive (JAR, Zip)". +* Browse to the your lib/ext/aspectjrt.jar file within your NetBeans +install directory and click "Finish". +* Select "Project -> Set Project Main Class..." in the menu bar, browse +to "spacewar/Game.java" in the examples directory that you created and +click "OK". +* In the "Filesystems" Explorer tab open the "spacewar" directory, click +"Game.java", and the select "Debug -> Strat" from the menu bar. + +AspectJ-related options can be modified in the AJDE settings window. diff --git a/docs/devGuideDB/ajdejbuilder.adoc b/docs/devGuideDB/ajdejbuilder.adoc new file mode 100644 index 000000000..0bf794693 --- /dev/null +++ b/docs/devGuideDB/ajdejbuilder.adoc @@ -0,0 +1,148 @@ +r + +AspectJ Development Environment (AJDE) support for JBuilder + +OpenTool extension Borland's + +JBuilder IDE + +. + +== Overview + +For release-specific documentation refer to the +http://aspectj.org/doc/dist/changes.html[changes file]. + +AJDE for JBuilder will allow you to: + +* compile AspectJ and Java files within the IDE +* browse the structure of your AspectJ program +* set up a compile configuration that determine which files will be +passed to the compiler + +== Installation and Project Setup + +`Install procedure:` use the installer to place the +"ajdeForJBuilder.jar" and "aspectjrt.jar" into JBuilder's lib/ext +directory. This will also install the two html files +"LICENCE-AJDEJBUILDER.html" and "README-AJDEJBUILDER.html". + +`Uninstall procedure:` remove "ajdeForJBuilder.jar" and "aspectjrt.jar" +(and the two html files, if you like) from the "lib/ext" directory. + +`Project setup:` follow the normal procedure for JBuilder project setup +(for an example of this please refer to the example below). However, +note that all of the source files to be passed to the compiler must be +added to your project either as files or within a package that is added +to the project. This is necessary because -- unlike a pure Java compiler +-- ajc does not search the SOURCEPATH for classes. + +`Starting and stopping AJDE:` select "Start AJDE" in the "AspectJ" +section of the "Tools" menu, or just click on the "AJDE" +(image:startAjde.gif[image]) button (label 1 in the first screenshot). +This will enable AJDE commands and will replace JBuilder's structure +view with the AspectJ Browser. To disable AJDE select "Stop AJDE" in the +same menu, or click the "AJDE" button again. + +== Compiling and Running the Project + +To compile the project select "Build project with ajc" from the AspectJ +toolbar, or click F11 while the editor pane is active. All of the +files contained in your project and within any packages and subpackages +that have been added to your project will be compiled. You may also +select a different configuration (as with label 2 in the first +screenshot). Then, structure of the currently visited file is shown (see +label 3 in the first scrrenshot). If there is a compile error, the +clickable error message is available (as with label 4 in the first +screenshot). + +To run the project select "Run Project" from the AspectJ toolbar, or +click F12 while the editor pane is active. Note that the "AspectJ +Runtime" library must be added to your project in order to run. If the +library is not added you will see a "java.lang.NoClassDefFoundError: +org/aspectj/lang/Signature" error. The library is created automatically +for you from the runtime in "jbuilderdir/lib/ext". You can also create a +new library to use the runtime from a different location. If you have +not added the library to the "Required Libraries" of your project it +will be added automatically when you restart JBuilder. + +JBuilder7 users please note: when you set up a run/debug configuration +you must select the "Build Target" (at the bottom of the "Runtime +Properties" dialog) to be "". This will ensure that the Java +compiler is not invoked on your AspectJ sources before running or +debugging the project. + +== Navigating the Program Structure + +Navigation of program structure is provided by the xref:#ajbrowser[???], +so apart from a JBuilder look and feel, the extra navigation AspectJ +allows work as described there. In particular, you can use views with +labels 1, 2 and 4 of the second screenshot to navigate structure using +the blue links, and you can set filtering and navigate history using the +toolbar shown by label 3 of the second screenshot. + +== Manipulating Build Configurations + +Build configurations can be manipulated adding, removing, and editing +build configuration files. The xref:#ajbrowser[???] is used to select +the current build configuration. Configurations are represented by +".lst" files which are described in the xref:#ajc[???] documentation. + +=== Adding and Removing Build Configurations + +By default all of the files contained in your project and within any +packages and subpackages that have been added to your project will be +compiled. In order to compile a different configuration first add it to +the project (by selecting "Add Files / Packages..." in the "Project" +menu, and selecting the desired build configuration file (see label 1 in +the third screenshot). + +=== Editing Build Configurations + +Double click a build configuration file in JBuilder's "Project Pane" in +order to edit it. Configurations can be edited as either text or in the +graphical designer (see labels 2 and 3 in the third screenshot) + +== Example: Setting up the "Spacewar" Sample Project + +To set up the Spacewar example first download it the +http://aspectj.org/dl[examples distribution]. Then + +[arabic] +. launch JBuilder +. in the "File" menu select "New project" +. Select the location of the "aspectj/examples" directory for the +project. This is because the Spacewar example uses both the "spacewar" +and "coordination" packages, so we set up the project where it can get +at both packages. +. Choose a "jpr" project, either by typing in "Spacewar.jpr" as the +project name, or by typing "Spacewar" as the project name and "jpr" as +the type. Make sure "aspectj/examples" is still the directory for the +project. +. click "Finish" +. in the "Project" menu select "Project properties..." +. set the "Output path" entry to be the directory where you want your +classes to go +. set the "Output path" entry to be the directory where you want your +classes to go +. add "aspectjrt.jar" as a required library for the project. This +library is located in "/lib/ext". +. in the "Source" tab select the entry and click "Edit" (by default +JBuilder will set this directory to be "examples/src" which does not +exist) +. Select the "examples" directory for the Souce. +. click "OK" to close the "Project Properties"dialog +. in the leftmost pane you will notice "Spacewar.jpr", right click this +and select "Add to project" in the popup, then "Add class/package..." in +thenext popup. Or directly choose "Add files/packages". +. select the "spacewar" and "coordination" packages and then +click "OK"; this will add the two packages to your project +. click the "Build Project" button (image:jbuilder-build.gif[image]) to +compile the project +. open the Structure View to browse the structure of the program +. click the "Run Project" button to play Spacewar (make sure that you +have set up the runtime library as described above) +. if you have not selected a class to run, you will be prompted to do +so: select the class "spacewar.Game". +. AspectJ related build options can be manipulated in the "AJDE +settings" window diff --git a/docs/devGuideDB/ajdoc.adoc b/docs/devGuideDB/ajdoc.adoc new file mode 100644 index 000000000..0ea3b7032 --- /dev/null +++ b/docs/devGuideDB/ajdoc.adoc @@ -0,0 +1,60 @@ +== `ajdoc`, the AspectJ API documentation generator + +=== Name + +`ajdoc` - generate HTML API documentation, including crosscutting structure + +=== Synopsis + +[subs=+quotes] + ajdoc [ -bootclasspath _classpathlist_ ] [ -classpath _classpathlist_ ] [-d _path_] [-help] [-package] [-protected] [-private] [-public] [-overview _overviewFile_] [ -sourcepath _sourcepathlist_ ] [-verbose] [-version] [_sourcefiles_... | _packages_... | @_file_... | -argfile _file_...] [ _ajc options_ ] + +=== Description + +`ajdoc` renders HTML documentation for AspectJ constructs as well as the +Java constructs that `javadoc` renders. In addition `ajdoc` displays the +crosscutting nature in the form of links. That means, for example, that +you can see everything affecting a method when reading the documentation +for the method. + +To run `ajdoc`, use one of the scripts in the AspectJ `bin` directory. +The `ajdoc` implementation builds on Sun's `javadoc` command line tool, +and you use it in the same way with many of the same options (`javadoc` +options are not documented here; for more information on `javadoc` +usage, see the http://java.sun.com/j2se/javadoc/[Javadoc homepage].) + +As with `ajc` (but unlike `javadoc`), you pass `ajdoc` all your aspect +source files and any files containing types affected by the aspects; +it's often easiest to just pass all the `.java` and `.aj` files in your +system. Unlike `ajc`, `ajdoc` will try to find package sources using the +specified sourcepath if you list packages on the command line. + +To provide an argfile listing the source files, you can use use the same +argfile (`@filename`) conventions as with `ajc`. For example, the +following documents all the source files listed in `argfile.lst`, +sending the output to the `docDir` output directory. + +.... +ajdoc -d docDir @argfile.lst +.... + +See the xref:#ajc[ajc documentation] for details on the text file +format. + +`ajdoc` honours `ajc` options. See the xref:#ajc_options[ajc +documentation] for details on these options. + +`ajdoc` currently requires the `tools.jar` from J2SE 1.3 to be on the +classpath. Normally the scripts set this up, assuming that your +`JAVA_HOME` variable points to an appropriate installation of Java. You +may need to provide this jar when using a different version of Java or a +JRE. + +=== Examples + +* Change into the `examples` directory. +* Type `mkdir doc` to create the destination directory for the documentation. +* Type `ajdoc -private -d doc spacewar coordination` to generate the documentation. (Use `-private` to get all members, + since many of the interesting ones in spacewar are not public.) +* Type `ajdoc -private -d doc @spacewar/demo.lst` to use the argfile associated with Spacewar. +* To view the documentation, open the file `index.html` in the `doc` directory using a web browser. diff --git a/docs/devGuideDB/antsupport.adoc b/docs/devGuideDB/antsupport.adoc new file mode 100644 index 000000000..f98b6e5be --- /dev/null +++ b/docs/devGuideDB/antsupport.adoc @@ -0,0 +1,864 @@ +[[antTasks]] +== AspectJ Ant Tasks + +[[antTasks-intro]] +=== Introduction + +AspectJ contains a compiler, `ajc`, that can be run from Ant. Included +in the `aspectjtools.jar` are Ant binaries to support three ways of +running the compiler: + +[arabic] +. xref:#antTasks-iajc[AjcTask (iajc)], a task to run the AspectJ +post-1.1 compiler, which supports all the eclipse and ajc options, +including incremental mode. +. xref:#antTasks-adapter[Ajc11CompilerAdapter (javac)], an adapter class +to run the new compiler using Javac tasks by setting the build.compiler +property +. xref:#antTasks-ajc[Ajc10 (ajc)], a task to run build scripts +compatible with the AspectJ 1.0 tasks + +This describes how to install and use the tasks and the adapter. For an +example Ant script, see xref:../examples/build.xml[examples/build.xml]. + +[[antTasks-install]] +=== Installing Ant Tasks + +Install Jakarta Ant 1.5.1: Please see the official Jakarta Ant website +for more information and the 1.5.1 distribution. This release is +source-compatible with Ant 1.3 and Ant 1.4, but the task sources must be +compiled with those versions of the Ant libraries to be used under those +versions of Ant. Sources are available under the Eclipse Public License +v 2.0 at http://eclipse.org/aspectj. + +In Ant 1.5, third-party tasks can be declared using a taskdef entry in +the build script, to identify the name and classes. When declaring a +task, include the `aspectjtools.jar` either in the taskdef classpath or +in `${ANT_HOME}/lib` where it will be added to the system class path by +the ant script. You may specify the task script names directly, or use +the "resource" attribute to specify the default names: + +.... + +.... + +The current resource file retains the name "ajc" for the Ajc10 task, and +uses "iajc" for the AspectJ post-1.1 task. + +In Ant 1.6, third-party tasks are declared in their own namespace using +`antlib.xml`. For example, the following script would build and run the +spacewar example, if you put the script in the examples directory and +`aspectjtools.jar` in the `${ANT_HOME}/lib` directory. + +.... + + + + + + +.... + +For more information on using Ant, please refer to Jakarta's +documentation on integrating user-defined Ant tasks into builds. + +[[antTasks-iajc]] +=== AjcTask (iajc) + +This task uses the AspectJ post-1.1 compiler ajc. The AspectJ compiler +can be used like Javac to compile Java sources, but it can also compile +AspectJ sources or weave binary aspects with Java bytecode. It can run +in normal "batch" mode or in an "incremental" mode, where it only +recompiles files it has to revisit. For more information on ajc, see +xref:#ajc-ref[???]. Unlike Javac or the Javac Ant task, this task always +compiles the specified files since aspects can apply to other (updated) +files. For a workaround, see xref:#antTasks-iajc-uptodate[Avoiding clean +compiles]. + +Beyond the normal ajc compiler options, this task also supports an +experimental option for an incremental "tag" file, and it can copy +resources from source directories or input jars to the output jar or +directory. + +This task is named iajc to avoid conflict with the 1.0 task ajc. + +[[antTasks-iajc-options]] +==== AjcTask (iajc) Options + +The following tables list the supported parameters. For any parameter +specified as a Path, a single path can be specified directly as an +attribute, multiple paths can be specified using a nested element of the +same name, and a common path can be reused by defining it as a global +and passing the id to the corresponding \{name}ref attribute. See +xref:#antTasks-iajc-paths[Path] below for more details. + +Most attributes and nested elements are optional. The compiler requires +that the same version of `aspectjrt.jar` be specified on the classpath, +and that some sources be be specified (using one or more of +`sourceroots`, `injars`, `inpath`, `argfiles`, and/or `srcdir` (with +patterns)). When in incremental mode, only `sourceroots` may be +specified. + +Boolean parameters default to `false` unless otherwise stated. + +*AjcTask (iajc) options for specifying sources* + +[cols=",",options="header",] +|=== +|Attribute |Description +|argfiles, argfilesRef (xref:#antTasks-iajc-paths[Path]) |An argument +file contains a list of arguments read by the compiler. Each line is +read into one element of the argument array and may include another +argfile by reference. + +|sourceRoots, sourceRootsRef (xref:#antTasks-iajc-paths[Path]) +|Directories containing source files (ending with .java or .aj) to +compile. + +|srcdir (xref:#antTasks-iajc-paths[Path]) |Base directory of sources to +compile, assuming there are xref:#antTasks-nested-includes[nested +matches]. This approach uses the Ant process for matching .java files +and is not compatible with incremental mode. Unless using filters to +limit the sources included, use sourceroots instead. + +|injars, injarsRef (xref:#antTasks-iajc-paths[Path]) |Deprecated - use +inpath instead. Read .class files for bytecode weaving from zip files +(only). + +|inpath, inpathRef (xref:#antTasks-iajc-paths[Path]) |Read .class files +for bytecode weaving from directories or zip files (like classpath). + +|classpath, classpathRef (xref:#antTasks-iajc-paths[Path]) |The +classpath used by the sources being compiled. When compiling aspects, +include the same version of the `aspectjrt.jar`. + +|bootclasspath, bootclasspathRef (xref:#antTasks-iajc-paths[Path]) |The +bootclasspath specifies types to use instead of the invoking VM's when +seeking types during compilation. + +|extDirs, extDirsRef (xref:#antTasks-iajc-paths[Path]) |The extension +directories to use instead of those in the invoking VM when seeking +types during compilation. + +|aspectPath, aspectPathRef (xref:#antTasks-iajc-paths[Path]) |Similar to +classpath, aspectpath contains read-only, binary aspect libraries that +are woven into sources but not included in the output. `aspectpath` +accepts jar/zip files (but, unlike classpath, not directories). +|=== + +*AjcTask (iajc) options for specifying output* + +[cols=",",options="header",] +|=== +|Attribute |Description +|destDir |The directory in which to place the generated class files. +Only one of `destDir` and `outJar` may be set. + +|outJar |The zip file in which to place the generated output class +files. Only one of `destDir` and `outJar` may be set. + +|copyInjars |(Deprecated/ignored; ajc does this.) If true, copy all +non-.class files from input jar(s) to the output jar or destination +directory after the compile (or incremental compile) completes. In +forked mode, this copies only after the process completes, not after +incremental compiles. + +|sourceRootCopyFilter |When set, copy all files from the sourceroot +directories to the output jar or destination directory except those +specified in the filter pattern. The pattern should be compatible with +an Ant fileset excludes filter; when using this, most developers pass +`**/CVS/*,**/*.java` to exclude any CVS directories or source files. See +`inpathDirCopyFilter`. Requires `destDir` or `outJar`. + +|inpathDirCopyFilter |When set, copy all files from the inpath +directories to the output jar or destination directory except those +specified in the filter pattern. The pattern should be compatible with +an Ant fileset excludes filter; when using this, most developers pass +`**/CVS/*,**/*.java,**/*.class` to exclude any CVS directories, source +files, or unwoven .class files. (If `**/*.class` is not specified, it +will be prepended to the filter.) See `sourceRootCopyFilter`. (Note that +ajc itself copies all resources from input jar/zip files on the inpath.) +Requires `destDir` or `outJar`. +|=== + +*AjcTask (iajc) options for specifying compiler behavior* + +[cols=",",options="header",] +|=== +|Attribute |Description +|fork |Run process in another VM. This gets the forking classpath either +explicitly from a `forkclasspath` entry or by searching the task or +system/Ant classpath for the first readable file with a name of the form +`aspectj{-}tools{.*}.jar`. When forking you can specify the amount of +memory used with `maxmem`. Fork cannot be used in incremental mode, +unless using a tag file. + +|forkclasspath, forkclasspathRef (xref:#antTasks-iajc-paths[Path]) +|Specify the classpath to use for the compiler when forking. + +|maxmem |The maximum memory to use for the new VM when fork is true. +Values should have the same form as accepted by the VM, e.g., "128m". + +|incremental |incremental mode: Build once, then recompile only required +source files when user provides input. Requires that source files be +specified only using `sourceroots`. Incompatible with forking. + +|tagfile |incremental mode: Build once, then recompile only required +source files when the tag file is updated, finally exiting when tag file +is deleted. Requires that source files be specified only using +`sourceroots`. + +|X |Set experimental option(s), using comma-separated list of accepted +options Options should not contain the leading X. Some commonly-used +experimental options have their own entries. The other permitted ones +(currently) are serializableAspects, incrementalFile, lazyTjp, +reweavable, notReweavable, noInline, terminateAfterCompilation, +ajruntimelevel:1.2, and ajruntimelevel:1.5. Of these, some were +deprecated in AspectJ 5 (reweavable, terminateAfterCompilation, etc.). + +|XterminateAfterCompilation |Terminates before the weaving process, +dumping out unfinished class files. +|=== + +*AjcTask (iajc) options for specifying compiler side-effects and +messages* + +[cols=",",options="header",] +|=== +|Attribute |Description +|emacssym |If true, emit `.ajesym` symbol files for Emacs support. + +|crossref |If true, emit `.ajsym` file into the output directory. + +|verbose |If true, log compiler verbose messages as Project.INFO during +the compile. + +|logCommand |If true, log compiler command elements as Project.INFO +(rather than the usual Project.VERBOSE level). + +|Xlistfileargs |If true, emit list of file arguments during the compile +(but behaves now like verbose). + +|version |If true, do not compile - just print AspectJ version. + +|help |If true, just print help for the command-line compiler. + +|Xlintwarnings |Same as `xlint:warning`: if true, set default level of +all language usage messages to warning. + +|Xlint |Specify default level of all language usage messages to one of +[`error warning ignore`]. + +|XlintFile |Specify property file containing `name:level` associations +setting level for language messages emitted during compilation. Any +levels set override the default associations in +`org/aspectj/weaver/XLintDefault.properties`. + +|failonerror |If true, throw BuildException to halt build if there are +any compiler errors. If false, continue notwithstanding compile errors. +Defaults to `true`. + +|messageHolderClass |Specify a class to use as the message holder for +the compile process. The entry must be a fully-qualified name of a class +resolveable from the task classpath complying with the +`org.aspectj.bridge.IMessageHolder` interface and having a public +no-argument constructor. + +|showWeaveInfo |If true, emit weaver messages. Defaults to `false`. +|=== + +*AjcTask (iajc) options for specifying Eclipse compiler options* + +[cols=",",options="header",] +|=== +|Attribute |Description +|nowarn |If true, same as `warn:none`. + +|deprecation |If true, same as `warn:deprecation` + +|warn |One or more comma-separated warning specifications from +[`constructorName packageDefaultMethod deprecation, + maskedCatchBlocks unusedLocals unusedArguments, + unusedImports syntheticAccess assertIdentifier`]. + +|debug |If true, same as `debug:lines,vars,source` + +|debugLevel |One or more comma-separated debug specifications from +[`lines vars source`]. + +|PreserveAllLocals |If true, code gen preserves all local variables (for +debug purposes). + +|noimporterror |If true, emit no errors for unresolved imports. + +|referenceinfo |If true, compute reference info. + +|log |File to log compiler messages to. + +|encoding |Default source encoding format (per-file encoding not +supported in Ant tasks). + +|proceedOnError |If true, keep compiling after errors encountered, +dumping class files with problem methods. + +|progress |If true, emit progress (requires log). + +|time |If true, display speed information. + +|target |Specify target class file format as one of [`1.1 1.2`]. +Defaults to 1.1 class file. + +|source |Set source compliance level to one of [`1.3 1.4 1.5`] (default +is 1.4). 1.3 implies -source 1.3 and -target 1.1. 1.4 implies -source +1.4 and -target 1.2. 1.5 implies -source 1.5 and -target 1.5. + +|source |Set source assertion mode to one of [`1.3 1.4`]. Default +depends on compliance mode. +|=== + +[[antTasks-nested-includes]] +==== AjcTask matching parameters specified as nested elements + +This task forms an implicit FileSet and supports all attributes of +`` (dir becomes srcdir) as well as the nested ``, +``, and `` elements. These can be used to specify +source files. However, it is better to use `sourceroots` to specify +source directories unless using filters to exclude some files from +compilation. + +[[antTasks-iajc-paths]] +==== AjcTask Path-like Structures + +Some parameters are path-like structures containing one or more +elements; these are `sourceroots`, `argfiles`, `injars`, `inpath`, +`classpath`, `bootclasspath`, `forkclasspath`, and `aspectpath`. In all +cases, these may be specified as nested elements, something like this: + +.... + + <{name}> + + + ... + <{name}> + ... + +.... + +As with other Path-like structures, they may be defined elsewhere and +specified using the refid attribute: + +.... + + + + +... + + + ... + +.... + +The task also supports an attribute `{name}ref` for each such parameter. +E.g., for `aspectpath`: + +.... + +.... + +[[antTasks-iajc-sample]] +==== Sample of iajc task + +A minimal build script defines the task and runs it, specifying the +sources: + +.... + + + + + + + + + + + +.... + +Below is script with most everything in it. The compile process... + +[arabic] +. Runs in incremental mode, recompiling when the user hits return; +. Reads all the source files from two directories; +. Reads binary .class files from input jar and directory; +. Uses a binary aspect library for persistence; +. Outputs to an application jar; and +. Copies resources from the source directories and binary input jar and +directories to the application jar. + +When this target is built, the compiler will build once and then wait +for input from the user. Messages are printed as usual. When the user +has quit, then this runs the application. + +.... + + + + + + + + + + + + + + + + + + + + + + + + + + +.... + +For an example of a build script, see ../examples/build.xml. + +[[antTasks-iajc-uptodate]] +==== Avoiding clean compiles + +Unlike javac, the ajc compiler always processes all input because new +aspects can apply to updated classes and vice-versa. However, in the +case where no files have been updated, there is no reason to recompile +sources. One way to implement that is with an explicit dependency check +using the uptodate task: + +.... + + + + + + + + + +.... + +To pass ajc-specific arguments, use a compilerarg entry. + +.... +-- command + + Ant -Dbuild.compiler=org.aspectj.tools.ant.taskdefs.Ajc11CompilerAdapter + +-- build script + + + + + + +.... + +The Javac task does special handling of source files that can interfere +with ajc. It removes any files that are not out-of-date with respect to +the corresponding .class files. But ajc requires all source files, since +an aspect may affect a source file that is not out of date. (For a +solution to this, see the `build.compiler.clean` property described +below.) Conversely, developers sometimes specify a source directory to +javac, and let it search for files for types it cannot find. AspectJ +will not do this kind of searching under the source directory (since the +programmer needs to control which sources are affected). (Don't confuse +the source directory used by Javac with the source root used by ajc; if +you specify a source root to ajc, it will compile any source file under +that source root (without exception or filtering).) To replace source +dir searching in Javac, use an Ant filter to specify the source files. + +[[antTasks-adapter-options]] +==== Compiler adapter compilerarg options + +The adapter supports any ajc command-line option passed using +compilerarg, as well as the following options available only in AjcTask. +Find more details on the following options in +xref:#antTasks-iajc[AjcTask (iajc)]. + +* `-Xmaxmem`: set maximum memory for forking (also settable in javac). +* `-Xlistfileargs`: list file arguments (also settable in javac). +* `-Xfailonerror`: throw BuildException on compiler error (also settable +in javac). +* `-Xmessageholderclass`: specify fully-qualified name of class to use +as the message holder. +* `-Xcopyinjars`: copy resources from any input jars to output (default +behavior since 1.1.1) +* `-Xsourcerootcopyfilter {filter}`: copy resources from source +directories to output (minus files specified in filter) +* `-Xtagfile {file}`: use file to control incremental compilation +* `-Xsrcdir {dir}`: add to list of ajc source roots (all source files +will be included). + +Special considerations when using Javac and compilerarg: + +* The names above may differ slightly from what you might expect from +AjcTask; use these forms when specifying compilerarg. + +* By default the adapter will mimic the Javac task's copying of resource +files by specifying `"**/CVS/*,**/*.java,**/*.aj"` for the sourceroot +copy filter. To change this behavior, supply your own value (e.g., +`"**/*"` to copy nothing). + +* Warning - define the system property `build.compiler.clean` to compile +all files, when available. Javac prunes the source file list of +"up-to-date" source files based on the timestamps of corresponding +.class files, and will not compile if no sources are out of date. This +is wrong for ajc which requires all the files for each compile and which +may refer indirectly to sources using argument files. ++ +To work around this, set the global property `build.compiler.clean`. +This tells the compiler adapter to delete all .class files in the +destination directory and re-execute the javac task so javac can +recalculate the list of source files. e.g., ++ +.... +Ant -Dbuild.compiler=org.aspectj.tools.ant.taskdefs.Ajc11CompilerAdapter + -Dbuild.compiler.clean=anything ... +.... ++ +Caveats to consider when using this global `build.compiler.clean` +property: +[arabic] +. If javac believes there are no out-of-date source files, then the +adapter is never called and cannot clean up, and the "compile" will +appear to complete successfully though it did nothing. +. Cleaning will makes stepwise build processes fail if they depend on +the results of the prior compilation being in the same directory, since +cleaning deletes all .class files. +. This clean process only permits one compile process at a time for each +destination directory because it tracks recursion by writing a tag file +to the destination directory. +. When running incrementally, the clean happens only before the initial +compile. + +[[antTasks-ajc]] +=== Ajc10 (ajc) + +This task handles the same arguments as those used by the AspectJ 1.0 +task. This should permit those with existing build scripts using the Ajc +Ant task to continue using the same scripts when compiling with 1.1. +This will list any use of options no longer supported in 1.1 (e.g., +`lenient, strict, workingdir, preprocess, usejavac`,...), and does not +provide access to the new features of AspectJ 1.1. (Developers using +AspectJ 1.1 only should upgrade their scripts to use AjcTask instead. +This will not work for AspectJ 1.2 or later.) + +[[antTasks-ajc-options]] +==== Ajc10 (ajc) Options + +Most attributes and nested elements are optional. The compiler requires +that the same version of `aspectjrt.jar` be specified on the classpath, +and that some sources be be specified (using one or more of `argfiles` +and `srcdir` (with patterns)). + +Boolean parameters default to `false` unless otherwise stated. + +.AjcTask (ajc) options for specifying sources +[cols=",",options="header",] +|=== +|Attribute |Description +|srcdir |The base directory of the java files. See + +|destdir |The target directory for the output .class files + +|includes |Comma-separated list of patterns of files that must be +included. No files are included when omitted. + +|includesfile |The path to a file containing include patterns. + +|excludes |Comma-separated list of patterns of files that must be +excluded. No files (except default excludes) are excluded when omitted. + +|excludesfile |The path to a file containing exclude patterns. + +|defaultexcludes |If true, then default excludes are used. Default +excludes are used when omitted (i.e., defaults to `true`). + +|classpath, classpathref |The classpath to use, optionally given as a +reference to a classpath Path element defined elsewhere. + +|bootclasspath, bootclasspathref |The bootclasspath to use, optionally +given as a reference to a bootclasspath Path element defined elsewhere. + +|extdirs |Paths to directories containting installed extensions. + +|debug |If true, emit debug info in the .class files. + +|deprecation |If true, emit messages about use of deprecated API. + +|verbose |Emit compiler status messages during the compile. + +|version |Emit version information and quit. + +|failonerror |If true, throw BuildException to halt build if there are +any compiler errors. If false, continue notwithstanding compile errors. +Defaults to `true`. + +|source |Value of -source option - ignored unless `1.4`. +|=== + +.Parameters ignored by the old ajc taskdef, but now supported or buggy +[cols=",,",options="header",] +|=== +|Attribute |Description |Supported? +|encoding |Default encoding of source files. |yes + +|optimize |Whether source should be compiled with optimization. |yes? + +|target |Generate class files for specific VM version, one of +[`1.1 1.2`]. |yes + +|depend |Enables dependency-tracking. |no + +|includeAntRuntime |Whether to include the Ant run-time libraries. |no + +|includeJavaRuntime |Whether to include the run-time libraries from the +executing VM. |no + +|threads |Multi-threaded compilation |no +|=== + +The following table shows that many of the unique parameters in AspectJ +1.0 are no longer supported. + +.Parameters unique to ajc +[cols=",",options="header",] +|=== +|Attribute |Description +|X |deprecated X options include reweavable (on by default) +reweavable:compress (compressed by default) + +|emacssym |Generate symbols for Emacs IDE support. + +|argfiles |A comma-delimited list of argfiles that contain a +line-delimited list of source file paths (absolute or relative to the +argfile). +|=== + +===== argfiles - argument list files + +An argument file is a file (usually `{file}.lst`) containing a list of +source file paths (absolute or relative to the argfile). You can use it +to specify all source files to be compiled, which ajc requires to avoid +searching every possible source file in the source path when building +aspects. If you specify an argfile to the ajc task, it will not include +all files in any specified source directory (which is the default +behavior for the Javac task when no includes are specified). Conversely, +if you specify excludes, they will be removed from the list of files +compiled even if they were specified in an argument file. + +The compiler also accepts arguments that are not source files, but the +IDE support for such files varies, and Javac does not support them. Be +sure to include exactly one argument on each line. + +[[antTasks-ajc-nested]] +==== Ajc10 parameters specified as nested elements + +This task forms an implicit FileSet and supports all attributes of +`` (dir becomes srcdir) as well as the nested ``, +``, and `` elements. These can be used to specify +source files. + +`ajc`'s `srcdir`, `classpath`, `bootclasspath`, `extdirs`, and `jvmarg` +attributes are path-like structures and can also be set via nested +``, ``, ``, ``, and `` +elements, respectively. + +[[antTasks-ajc-sample]] +==== Sample of ajc task + +Following is a declaration for the ajc task and a sample invocation that +uses the ajc compiler to compile the files listed in `default.lst` into +the dest dir: + +.... + + + + + + + + + + + + + + + + + + +.... + +This build script snippet + +.... + +.... + +compiles all .java files specified in the demo.lst and stores the .class +files in the $\{build} directory. Unlike the Javac task, the includes +attribute is empty by default, so only those files specified in demo.lst +are included. + +This next example + +.... + +.... + +compiles .java files under the `${src}` directory in the spacewar and +coordination packages, and stores the .class files in the `${build}` +directory. All source files under spacewar/ and coordination/ are used, +except Debug.java. + +See ../examples/build.xml for an example build script. + +[[antTasks-problems]] +=== Isolating problems running the Ant tasks + +If you have problems with the tasks not solved by the documentation, +please try to see if you have the same problems when running ajc +directly on the command line. + +* If the problem occurs on the command line also, then the problem is +not in the task. (It may be in the tools; please send bug reports.) +* If the problem does not occur on the command line, then it may lie in +the parameters you are supplying in Ant or in the task's handling of +them. +* If the build script looks correct and the problem only occurs when +building from Ant, then please send a report (including your build file, +if possible). + +[[antTasks-knownProblems]] +==== Known issues with the Ant tasks + +For the most up-to-date information on known problems, see the +http://bugs.eclipse.org/bugs[bug database] for unresolved +http://bugs.eclipse.org/bugs/buglist.cgi?&product=AspectJ&component=Compiler&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED[compiler +bugs] or +http://bugs.eclipse.org/bugs/buglist.cgi?&product=AspectJ&component=Ant&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED[taskdef +bugs] . + +When running Ant build scripts under Eclipse 2.x variants, you will get +a VerifyError because the Eclipse Ant support fails to isolate the Ant +runtime properly. To run in this context, set up iajc to fork (and use +forkclasspath). Eclipse 3.0 will fork Ant processes to avoid problems +like this. + +Memory and forking: Users email most often about the ajc task running +out of memory. This is not a problem with the task; some compiles take a +lot of memory, often more than similar compiles using javac. + +Forking is now supported in both the +xref:#antTasks-adapter[Ajc11CompilerAdapter (javac)] and +xref:#antTasks-iajc[AjcTask (iajc)], and you can set the maximum memory +available. You can also not fork and increase the memory available to +Ant (see the Ant documentation, searching for ANT_OPTS, the variable +they use in their scripts to pass VM options, e.g., ANT_OPTS=-Xmx128m). + +[[antTasks-feedback]] +==== Ant task questions and bugs + +For questions, you can send email to aspectj-users@dev.eclipse.org. (Do +join the list to participate!) We also welcome any bug reports, patches, +and features; you can submit them to the bug database at +http://bugs.eclipse.org/bugs using the AspectJ product and Ant +component. diff --git a/docs/devGuideDB/aspectj-mode.adoc b/docs/devGuideDB/aspectj-mode.adoc new file mode 100644 index 000000000..e4d09acdd --- /dev/null +++ b/docs/devGuideDB/aspectj-mode.adoc @@ -0,0 +1,179 @@ +AspectJ-mode + +support for XEmacs and GNU Emacs + +== AspectJ-mode User's Guide + +This guide describes aspectj-mode for GNU Emacs and XEmacs, which +provides enhanced editing and management of AspectJ code via a minor +mode extension of java-mode. Included in this document are guidance for +aspectj-mode's xref:#ajmode-featuresandusage[use], and +xref:#ajmode-installationetc[installation and compatibility]. See the +README file in the aspectj-mode's distribution directory for +release-specific details. + +AspectJ minor mode provides (see graphic): + +* Viewing and navigation of aspect structures, permitting navigation +between aspect code and the code that it affects, via a `jump' menu (and +in the speedbar and Classes menu for JDE users). +* Source code annotation of inter-type and advice declarations, as well +as the code they affect. +* AspectJ-style compilation, using .lst files to generate a compilation +submenu. +* Highlighting of AspectJ keywords and declaration names. + +The first two are derived from ajc's last build of the AspectJ program. +An example usage is given below. + +image:aspectj-mode.gif[image] + +[[ajmode-featuresandusage]] +== Features and Usage + +All commands governing AspectJ mode are available from the AspectJ menu +on the toolbar. Besides those described below, there is a menu item +Customize options for viewing and customizing the options of the mode +and AJ Mode user guide to view this file. Keyword and declaration +highlighting is enabled above the minimal level of highlighting. + +By default, AspectJ mode is automatically turned on when a buffer named +with a `.java` suffix is entered. The command +`M-x aspectj-mode-in-force-toggle` globally toggles the features of the +mode, easing quickly moving between AspectJ and Java projects (also +available as AspectJ mode extensions in the AspectJ menu). + +=== Aspect Structure and Navigation + +AspectJ minor mode highlights aspect relationships in the text with +textual annotations on the program source (optionally can be turned +off), such as the `[Player, Robot, Ship]` marking after the advice in +EnsureShipIsAlive at the bottom of the +xref:#aspectjmodescreenshot[figure], which indicates that the advice +refers to join points within Ship objects. The following commands (also +available from the menu) manage annotations and navigation: + +.AspectJ Minor Mode Commands for Annotations and Navigation +[cols=",",options="header",] +|=== +|Command (keyboard shortcut) |Description +|M-x aspectj-jump-menu (C-x C-j) |Display popup menu of advisers, +advisees, and inter-type declarations. Navigate to item by selecting +with mouse (see xref:#aspectjmodescreenshot2[figure] below). + +|M-x aspectj-show-annotations |Add crosscut annotations on the text on +current buffer. + +|M-x aspectj-dont-show-annotations |Remove crosscut annotations from +text on current buffer. +|=== + +The default for whether annotations are shown or not can be customized +by selecting Customize options from the AspectJ menu. + +image:aspectj-mode2.gif[image] + +=== Compilation + +The Compile submenu accessible from the AspectJ menu presents the +known` .lst` files for the project. Selecting one compiles the project +with that `.lst` file and remembers that for future compiles. The +Compile... command accessible from the Emacs Tools menu is customized +through the project customization option `Aspectj Tools Compile + Command`, customizable from the AspectJ menu. + +[[ajmode-installationetc]] +== Installation and Compatibility + +AspectJ mode requires the installation of +http://www.gnu.org/software/emacs/[GNU Emacs 20.3.1] or +http://www.xemacs.org/[XEmacs 21.1.14 (Unix/Linux)], or +http://www.xemacs.org/[XEmacs 21.4 (Windows)], or higher. In general, +the most recent non-alpha/beta versions of these are recommended. A web +browser is required to view this documentation via Emacs. Small +modifications to the `.emacs` file configures AspectJ mode and enables +autoloading AspectJ mode when a `.java` file is loaded. + +=== Installation + +Step 1, with enhancements, can be found in the example Emacs +initialization file `sample.emacs` in the distribution. + +[arabic] +. The files in this package need to be in the load-path and +``required''. For example, for the 1.0 release: ++ +.... +;; I keep my emacs packages in C:/Emacs +(setq load-path (cons "C:/Emacs/aspectj-emacsMode-1.0" load-path)) +(require 'aspectj-mode) + +.... +. _[Optional]_ add `-emacssym` switch to the `ajc` and `ajc.bat` files +in your AspectJ tools installations (in the `/bin` directory). If you +invoke the compiler outside Emacs, this will ensure that your compiles +always generate information for annotations and the jump menu in the +form of `.ajesym` files. +. _[XEmacs only]_ Go to the `xemacs-packages/lisp` directory of your +XEmacs distribution and move the `jde` directory to someplace harmless. +Otherwise, Java files will come up in JDE mode. + +=== Customizing Options + +Selecting Customize options from the AspectJ menu displays a number of +options that customize AspectJ mode. These control whether annotations +are shown by default, as well as a number of options controlling +compilation and beanshell for java-mode. Example customizations are +given in the file `sample.emacs` in the distribution. + +== Usage and Upgrade Problems + +* _Symptom_: No annotations show. Message: ++ +.... +AspectJ Mode Warning: Can't find declarations file for... +.... ++ +AspectJ file has not been compiled with ajc and the `-emacssym` flag, or +was compiled with an obsolete version of ajc. After compilation, there +should be a .ajesym for every .java in the build. If .ajsym +files are present but error persists, recompile. Note that aspectj-mode +for JDE has a fallback view for uncompiled files. +* _Symptom_: Annotations are misplaced in the code. ++ +AspectJ mode operates by querying data derived from the most recent +compile that includes the `-emacssym` flag. Recompile the entire program +with ajc including the switch. Consider permanently installing the +switch by editing the ajc and ajc.bat files in the /bin file in your +distribution. +* _Symptom_: New customization option settings were saved for future +sessions, but do not show up when Emacs is restarted. ++ +You may have two sets of saved settings in your .emacs file, and Emacs +updated the first one, which may be shadowed by the second. +* _Symptom_: Java files that are part of a Java project not written in +AspectJ come up in aspectj-mode. ++ +Emacs uses the file suffix (.java) to determine which mode to invoke. +You can either globally toggle the AspectJ features from the AspectJ +menu. +* _Symptom_: Reported bug fixes and new features to aspectj-mode are not +seen, or aspectj-mode.el cannot be found or loaded, with message: ++ +.... +Error in init file: File error: "Cannot open load file", "aspectj-mode" +.... ++ +Your load-path variable (set in your .emacs) is referring to an old +release. Change your load-path to point at the directory for the current +release. See the sample.emacs files in the distribution, for example. +* _Symptom_: When trying to get a jump menu, I get the message "No +crosscut elements at point" even though there is a [list] on the same +line. ++ +The caret (point) is probably on or after the list. To see the crosscut +elements you need to hit the jump menu on the same line that the +annotated elements appear as a list of items surrounded by '[' and ']' +on the same line as the affected declaration. If the caret is on the +same line as the elements and before the list (i.e. not at the end of +the list of elements) the jump menu should work. diff --git a/docs/devGuideDB/compatibility.adoc b/docs/devGuideDB/compatibility.adoc new file mode 100644 index 000000000..63822e003 --- /dev/null +++ b/docs/devGuideDB/compatibility.adoc @@ -0,0 +1,112 @@ +[[compatibility]] +== AspectJ version compatibility + +[[versionCompatibility]] +=== Version Compatibility + +Systems, code, and build tools change over time, often not in step. +Generally, later versions of the build tools understand earlier versions +of the code, but systems should include versions of the runtime used to +build the AspectJ program. + +[[javaCompatibility]] +==== Java compatibility + +AspectJ programs can run on any Java VM of the required version. The +AspectJ tools produce Java bytecode .class files that run on Java +compatible VM's. If a Java class is changed by an aspect, the resulting +class is binary compatible (as defined in the Java Language +Specification). Further, the AspectJ compiler and weaving do all the +exception checking required of Java compilers by the Java +specifications. + +Like other Java compilers, the AspectJ compiler can target particular +Java versions. Obviously, code targeted at one version cannot be run in +a VM of a lesser version. The `aspectjrt.jar` is designed to take +advantage of features available in Java 2 or Java 5, but will run in a +JDK 1.1.x environment, so you can use AspectJ to target older or +restricted versions of Java. However, there may be restricted variants +of JDK 1.1.x that do not have API's used by the AspectJ runtime. If you +deploy to one of those, you can email aspectj-dev@eclipse.org or +download the runtime code to modify it for your environment. + +Aside from the runtime, running the AspectJ tools themselves will +require a more recent version of Java. You might use Java 5 to run the +AspectJ compiler to produce code for Java 1.1.8. + +[[runtimeCompatibility]] +==== Runtime library compatibility + +When deploying AspectJ programs, include on the classpath the classes, +aspects, and the AspectJ runtime library (`aspectjrt.jar`). Use the +version of the runtime that came with the tools used to build the +program. If the runtime is earlier than the build tools used, it's very +likely to fail. If the runtime is later than the build tools used, it's +possible (but not guaranteed) that it will work. + +Given that, three scenarios cause problems. First, you deploy new +aspects into an an existing system that already has aspects that were +built with a different version. Second, the runtime is already deployed +in your system and cannot be changed (e.g., some application servers put +`aspectjrt.jar` on the bootclasspath). Third, you (unintentionally) +deploy two versions of the runtime, and the one loaded by a parent +loader is used). + +In earlier versions of AspectJ, these problems present in obscure ways +(e.g., unable to resolve a class). In later versions, a stack trace +might even specify that the runtime version is out of sync with an +aspect. To find out if the runtime you deployed is the one actually +being used, log the defining class loader for the aspects and runtime. + +[[binaryCompatibility]] +==== Aspect binary compatibility + +Generally, binary aspects can be read by later versions of the weaver if +the aspects were built by version 1.2.1 or later. (Some future weavers +might have documented limitations in how far back they go.) If a +post-1.2.1 weaver reads an aspect built by a later version, it will emit +a message. If the weaver reads in a binary aspect and writes it out +again, the result will be in the form produced by that weaver, not the +original form of the aspect (just like other weaver output). + +With unreleased or development versions of the tools, there are no +guarantees for binary compatibility, unless they are stated in the +release notes. If you use aspects built with development versions of the +weaver, be careful to rebuild and redeploy with the next released +version. + +[[sourceCompatibility]] +==== Aspect source compatibility + +Generally, AspectJ source files can be read by later versions of the +compiler. Language features do not change in dot releases (e.g., from +1.2.1 to 1.2.2). In some very rare cases, a language feature will no +longer be supported or may change its meaning; these cases are +documented in the release notes for that version. Some changes like this +were necessary when moving to binary weaving in the 1.1 release, but at +this time we don't anticipate more in the future. You might also find +that the program behaves differently if you relied on behavior specific +to that compiler/weaver, but which is not specified in the +xref:../progguide/semantics.html[Semantics appendix to the Programming +Guide]. + +[[upgrading]] +==== Problems when upgrading to new AspectJ versions + +Let's say your program behaves differently after being built with a new +version of the AspectJ tools. It could be a bug that was introduced by +the tools, but often it results from relying on behavior that was not +guaranteed by the compiler. For example, the order of advice across two +aspects is not guaranteed unless there is a precedence relationship +between the aspects. If the program implicitly relies on a certain order +that obtains in one compiler, it can fail when built with a different +compiler. + +Another trap is deploying into the same system, when the `aspectjrt.jar` +has not been changed accordingly. + +Finally, when updating to a version that has new language features, +there is a temptation to change both the code and the tools at the same +time. It's best to validate the old code with the new tools before +updating the code to use new features. That distinguishes problems of +new engineering from those of new semantics. diff --git a/docs/devGuideDB/devguide.adoc b/docs/devGuideDB/devguide.adoc new file mode 100644 index 000000000..f7d32246b --- /dev/null +++ b/docs/devGuideDB/devguide.adoc @@ -0,0 +1,33 @@ += The AspectJ^TM^ Development Environment Guide + +:doctype: book + +_by the AspectJ Team_ + +_Copyright (c) 1998-2001 Xerox Corporation, 2002 Palo Alto Research Center, Incorporated, 2003-2005 Contributors. +All rights reserved._ + +This guide describes how to build and deploy AspectJ programs using the AspectJ tools and facilities. See also the +xref:../progGuideDB/progguide.adoc[AspectJ Programming Guide], the documentation available with the AspectJ support +available for various integrated development environments (e.g. https://www.eclipse.org/ajdt/[Eclipse AJDT]), and the +most-recent documentation available from the https://eclipse.org/aspectj[AspectJ project page]. + +//// +ATTENTION: Please do not remove blank lines in between 'include::' statements. Otherwise, section numbers in the +table of contents (TOC) can be wrong and the first section of each document missing completely. +//// +include::tools-intro.adoc[] + +include::ajc.adoc[] + +include::ajdoc.adoc[] + +include::aj.adoc[] + +include::ajbrowser.adoc[] + +include::antsupport.adoc[] + +include::ltw.adoc[] + +include::compatibility.adoc[] diff --git a/docs/devGuideDB/devguide.pdf b/docs/devGuideDB/devguide.pdf new file mode 100644 index 000000000..6bc12d82c --- /dev/null +++ b/docs/devGuideDB/devguide.pdf @@ -0,0 +1,43689 @@ +%PDF-1.4 +%ÿÿÿÿ +1 0 obj +<< /Title (The AspectJTM Development Environment Guide) +/Creator (Asciidoctor PDF 1.6.0, based on Prawn 2.4.0) +/Producer (Asciidoctor PDF 1.6.0, based on Prawn 2.4.0) +/ModDate (D:20210628164344+07'00') +/CreationDate (D:20210628165337+07'00') +>> +endobj +2 0 obj +<< /Type /Catalog +/Pages 3 0 R +/Names 14 0 R +/Outlines 322 0 R +/PageLabels 359 0 R +/PageMode /UseOutlines +/OpenAction [7 0 R /FitH 841.89] +/ViewerPreferences << /DisplayDocTitle true +>> +>> +endobj +3 0 obj +<< /Type /Pages +/Count 48 +/Kids [7 0 R 10 0 R 12 0 R 20 0 R 31 0 R 38 0 R 46 0 R 49 0 R 51 0 R 53 0 R 55 0 R 64 0 R 66 0 R 68 0 R 72 0 R 77 0 R 84 0 R 89 0 R 100 0 R 104 0 R 108 0 R 118 0 R 129 0 R 136 0 R 148 0 R 152 0 R 154 0 R 156 0 R 160 0 R 163 0 R 166 0 R 172 0 R 177 0 R 180 0 R 184 0 R 188 0 R 191 0 R 203 0 R 209 0 R 217 0 R 219 0 R 223 0 R 226 0 R 229 0 R 232 0 R 238 0 R 242 0 R 250 0 R] +>> +endobj +4 0 obj +<< /Length 2 +>> +stream +q + +endstream +endobj +5 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 4 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +>> +>> +endobj +6 0 obj +<< /Length 562 +>> +stream +q +/DeviceRGB cs +0.6 0.6 0.6 scn +/DeviceRGB CS +0.6 0.6 0.6 SCN + +BT +194.4722 361.6965 Td +/F1.0 27 Tf +<546865204173706563744a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6 0.6 0.6 scn +0.6 0.6 0.6 SCN + +BT +344.1602 375.9862 Td +/F1.0 15.741 Tf +<544d> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6 0.6 0.6 scn +0.6 0.6 0.6 SCN + +BT +368.543 361.6965 Td +/F1.0 27 Tf +<20446576656c6f706d656e74> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6 0.6 0.6 scn +0.6 0.6 0.6 SCN + +BT +293.024 327.6765 Td +/F1.0 27 Tf +<456e7669726f6e6d656e74204775696465> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q + +endstream +endobj +7 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 6 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F1.0 8 0 R +>> +>> +>> +endobj +8 0 obj +<< /Type /Font +/BaseFont /18afab+NotoSerif +/Subtype /TrueType +/FontDescriptor 363 0 R +/FirstChar 32 +/LastChar 255 +/Widths 365 0 R +/ToUnicode 364 0 R +>> +endobj +9 0 obj +<< /Length 24774 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +48.24 782.394 Td +/F2.0 22 Tf +[<54> 29.7852 <61626c65206f6620436f6e74656e7473>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 751.856 Td +/F1.0 10.5 Tf +<312e20496e74726f64756374696f6e20746f20746865204173706563744a20746f6f6c73> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +225.1651 751.856 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +540.4906 751.856 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +541.1705 751.856 Td +/F1.0 10.5 Tf +<32> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 733.376 Td +/F1.0 10.5 Tf +<312e312e205468652045636c69707365204173706563744a20696d706c656d656e746174696f6e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +262.5766 733.376 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +540.4906 733.376 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +541.1705 733.376 Td +/F1.0 10.5 Tf +<32> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 714.896 Td +/F1.0 10.5 Tf +[<312e322e2042> 20.0195 <797465636f64652077656176696e672c20696e6372656d656e74616c20636f6d70696c6174696f6e2c20616e64206d656d6f7279207573616765>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +401.5336 714.896 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +540.4906 714.896 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +541.1705 714.896 Td +/F1.0 10.5 Tf +<32> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 696.416 Td +/F1.0 10.5 Tf +<312e332e204e616d65> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +112.9306 696.416 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +540.4906 696.416 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +541.1705 696.416 Td +/F1.0 10.5 Tf +<34> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 677.936 Td +/F1.0 10.5 Tf +[<312e342e2053> 20.0195 <796e6f70736973>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +123.6196 677.936 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +540.4906 677.936 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +541.1705 677.936 Td +/F1.0 10.5 Tf +<34> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 659.456 Td +/F1.0 10.5 Tf +<312e352e204465736372697074696f6e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +139.6531 659.456 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +540.4906 659.456 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +541.1705 659.456 Td +/F1.0 10.5 Tf +<34> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 640.976 Td +/F1.0 10.5 Tf +<312e362e204e616d65> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +112.4056 640.976 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 640.976 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 640.976 Td +/F1.0 10.5 Tf +<3133> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 622.496 Td +/F1.0 10.5 Tf +[<312e372e2053> 20.0195 <796e6f70736973>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +128.4391 622.496 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 622.496 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 622.496 Td +/F1.0 10.5 Tf +<3133> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 604.016 Td +/F1.0 10.5 Tf +<312e382e204465736372697074696f6e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +139.1281 604.016 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 604.016 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 604.016 Td +/F1.0 10.5 Tf +<3133> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 585.536 Td +/F1.0 10.5 Tf +<312e392e204578616d706c6573> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +128.4391 585.536 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 585.536 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 585.536 Td +/F1.0 10.5 Tf +<3134> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 567.056 Td +/F1.0 10.5 Tf +<322e204465736372697074696f6e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +117.7501 567.056 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 567.056 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 567.056 Td +/F1.0 10.5 Tf +<3135> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 548.576 Td +/F1.0 10.5 Tf +<322e312e204578616d706c6573> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +128.4391 548.576 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 548.576 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 548.576 Td +/F1.0 10.5 Tf +<3135> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 530.096 Td +/F1.0 10.5 Tf +<332e204173706563744a2042726f77736572> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +144.4726 530.096 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 530.096 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 530.096 Td +/F1.0 10.5 Tf +<3136> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 511.616 Td +/F1.0 10.5 Tf +<332e312e20496e74726f64756374696f6e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +144.4726 511.616 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 511.616 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 511.616 Td +/F1.0 10.5 Tf +<3136> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 493.136 Td +/F1.0 10.5 Tf +[<332e322e204275696c64696e672050726f6772> 20.0195 <616d73>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +176.5396 493.136 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 493.136 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 493.136 Td +/F1.0 10.5 Tf +<3136> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 474.656 Td +/F1.0 10.5 Tf +[<332e332e204e617669676174696e672050726f6772> 20.0195 <616d20537472756374757265>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +235.3291 474.656 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 474.656 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 474.656 Td +/F1.0 10.5 Tf +<3137> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 456.176 Td +/F1.0 10.5 Tf +[<332e342e2052756e6e696e672050726f6772> 20.0195 <616d73>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +176.5396 456.176 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 456.176 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 456.176 Td +/F1.0 10.5 Tf +<3138> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 437.696 Td +/F1.0 10.5 Tf +<332e352e2049736f6c6174696e672070726f626c656d732072756e6e696e6720746865204173706563744a2062726f77736572> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +320.8411 437.696 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 437.696 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 437.696 Td +/F1.0 10.5 Tf +<3138> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 419.216 Td +/F1.0 10.5 Tf +[<342e204173706563744a20416e742054> 29.7852 <61736b73>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +149.8171 419.216 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 419.216 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 419.216 Td +/F1.0 10.5 Tf +<3230> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 400.736 Td +/F1.0 10.5 Tf +<342e312e20496e74726f64756374696f6e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +144.4726 400.736 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 400.736 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 400.736 Td +/F1.0 10.5 Tf +<3230> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 382.256 Td +/F1.0 10.5 Tf +[<342e322e20496e7374616c6c696e6720416e742054> 29.7852 <61736b73>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +181.8841 382.256 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 382.256 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 382.256 Td +/F1.0 10.5 Tf +<3230> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 363.776 Td +/F1.0 10.5 Tf +[<342e332e20416a6354> 29.7852 <61736b202869616a6329>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +149.8171 363.776 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 363.776 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 363.776 Td +/F1.0 10.5 Tf +<3231> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 345.296 Td +/F1.0 10.5 Tf +[<342e342e20416a633131436f6d70696c657241> 20.0195 <64617074657220286a6176616329>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +229.9846 345.296 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 345.296 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 345.296 Td +/F1.0 10.5 Tf +<3239> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 326.816 Td +/F1.0 10.5 Tf +<342e352e20416a6331302028616a6329> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +133.7836 326.816 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 326.816 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 326.816 Td +/F1.0 10.5 Tf +<3331> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 308.336 Td +/F1.0 10.5 Tf +<342e362e2049736f6c6174696e672070726f626c656d732072756e6e696e672074686520416e74207461736b73> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +288.7741 308.336 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 308.336 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 308.336 Td +/F1.0 10.5 Tf +<3335> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 289.856 Td +/F1.0 10.5 Tf +[<352e204c6f61642d54696d652057> 60.0586 <656176696e67>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +160.5061 289.856 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 289.856 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 289.856 Td +/F1.0 10.5 Tf +<3336> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 271.376 Td +/F1.0 10.5 Tf +<352e312e20496e74726f64756374696f6e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +144.4726 271.376 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 271.376 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 271.376 Td +/F1.0 10.5 Tf +<3336> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 252.896 Td +/F1.0 10.5 Tf +[<352e322e204c6f61642d74696d652057> 60.0586 <656176696e6720526571756972656d656e7473>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +251.3626 252.896 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 252.896 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 252.896 Td +/F1.0 10.5 Tf +<3336> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 234.416 Td +/F1.0 10.5 Tf +[<352e332e20436f6e6669677572> 20.0195 <6174696f6e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +149.8171 234.416 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 234.416 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 234.416 Td +/F1.0 10.5 Tf +<3337> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 215.936 Td +/F1.0 10.5 Tf +<352e342e205370656369616c206361736573> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +144.4726 215.936 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 215.936 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 215.936 Td +/F1.0 10.5 Tf +<3433> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 197.456 Td +/F1.0 10.5 Tf +[<352e352e2052756e74696d6520526571756972656d656e747320666f72204c6f61642d74696d652057> 60.0586 <656176696e67>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +315.4966 197.456 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 197.456 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 197.456 Td +/F1.0 10.5 Tf +<3433> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 178.976 Td +/F1.0 10.5 Tf +[<352e362e20537570706f727465642041> 20.0195 <67656e7473>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +171.1951 178.976 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 178.976 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 178.976 Td +/F1.0 10.5 Tf +<3433> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 160.496 Td +/F1.0 10.5 Tf +<362e204173706563744a2076657273696f6e20636f6d7061746962696c697479> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +208.6066 160.496 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 160.496 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 160.496 Td +/F1.0 10.5 Tf +<3435> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +60.24 142.016 Td +/F1.0 10.5 Tf +[<362e312e2056> 60.0586 <657273696f6e20436f6d7061746962696c697479>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6627 0.6627 0.6627 scn +0.6627 0.6627 0.6627 SCN + +BT +192.5731 142.016 Td +/F1.0 10.5 Tf +<2e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e202e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +BT +534.6211 142.016 Td +/F1.0 2.625 Tf + Tj +ET + +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.301 142.016 Td +/F1.0 10.5 Tf +<3435> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q + +endstream +endobj +10 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 9 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F2.0 22 0 R +/F1.0 8 0 R +>> +>> +/Annots [254 0 R 255 0 R 256 0 R 257 0 R 258 0 R 259 0 R 260 0 R 261 0 R 262 0 R 263 0 R 264 0 R 265 0 R 266 0 R 267 0 R 268 0 R 269 0 R 270 0 R 271 0 R 272 0 R 273 0 R 274 0 R 275 0 R 276 0 R 277 0 R 278 0 R 279 0 R 280 0 R 281 0 R 282 0 R 283 0 R 284 0 R 285 0 R 286 0 R 287 0 R 288 0 R 289 0 R 290 0 R 291 0 R 292 0 R 293 0 R 294 0 R 295 0 R 296 0 R 297 0 R 298 0 R 299 0 R 300 0 R 301 0 R 302 0 R 303 0 R 304 0 R 305 0 R 306 0 R 307 0 R 308 0 R 309 0 R 310 0 R 311 0 R 312 0 R 313 0 R 314 0 R 315 0 R 316 0 R 317 0 R 318 0 R 319 0 R 320 0 R 321 0 R] +>> +endobj +11 0 obj +<< /Length 4064 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +48.24 791.0774 Td +/F1.0 13 Tf +[<62> 20.0195 <7920746865204173706563744a2054> 29.7852 <65616d>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +6.5931 Tw + +BT +48.24 771.5403 Td +/F1.0 13 Tf +[<436f70> 20.0195 <79726967687420313939382d32303031205865726f7820436f72706f72> 20.0195 <6174696f6e2c20323030322050616c6f20416c746f2052657365617263682043656e7465722c>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 752.0031 Td +/F1.0 13 Tf +[<496e636f72706f72> 20.0195 <617465642c20323030332d3230303520436f6e7472696275746f72732e20416c6c207269676874732072657365727665642e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.4761 Tw + +BT +48.24 723.3146 Td +/F1.0 10.5 Tf +<546869732067756964652064657363726962657320746865206368616e67657320746f20746865204173706563744a206c616e677561676520696e204173706563744a20352e20546865736520696e636c75646520737570706f727420666f72> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.7405 Tw + +BT +48.24 707.5346 Td +/F1.0 10.5 Tf +<4a61766120352066656174757265732c20737570706f727420666f7220616e20616e6e6f746174696f6e2d626173656420646576656c6f706d656e74207374796c6520666f72206173706563747320616e64206e6577207265666c656374696f6e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.3229 Tw + +BT +48.24 691.7546 Td +/F1.0 10.5 Tf +[<616e6420746f6f6c7320415049732e20496620796f7520617265206e657720746f204173706563744a2c207765207265636f6d6d656e6420796f752073746172742062> 20.0195 <792072656164696e67207468652070726f6772> 20.0195 <616d6d696e67>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 675.9746 Td +/F1.0 10.5 Tf +<67756964652e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.3239 Tw + +BT +48.24 648.1946 Td +/F1.0 10.5 Tf +[<546869732067756964652064657363726962657320686f7720746f206275696c6420616e64206465706c6f> 20.0195 <79204173706563744a2070726f6772> 20.0195 <616d73207573696e6720746865204173706563744a20746f6f6c7320616e64>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1837 Tw + +BT +48.24 632.4146 Td +/F1.0 10.5 Tf +<666163696c69746965732e2053656520616c736f20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +1.1837 Tw + +BT +141.7551 632.4146 Td +/F1.0 10.5 Tf +[<546865204173706563744a2050726f6772> 20.0195 <616d6d696e67204775696465>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1837 Tw + +BT +307.7304 632.4146 Td +/F1.0 10.5 Tf +<2c2074686520646f63756d656e746174696f6e20617661696c61626c65207769746820746865204173706563744a> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.0674 Tw + +BT +48.24 616.6346 Td +/F1.0 10.5 Tf +[<737570706f727420617661696c61626c6520666f7220766172696f757320696e74656772> 20.0195 <6174656420646576656c6f706d656e7420656e7669726f6e6d656e74732028652e672e20>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +2.0674 Tw + +BT +431.2496 616.6346 Td +/F1.0 10.5 Tf +[<45636c6970736520414a44> 20.0195 <54>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.0674 Tw + +BT +496.1278 616.6346 Td +/F1.0 10.5 Tf +<292c20616e6420746865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 600.8546 Td +/F1.0 10.5 Tf +<6d6f73742d726563656e7420646f63756d656e746174696f6e20617661696c61626c652066726f6d2074686520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +283.86 600.8546 Td +/F1.0 10.5 Tf +<4173706563744a2070726f6a6563742070616765> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +384.7545 600.8546 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp1 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +541.009 14.263 Td +/F1.0 9 Tf +<31> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +12 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 11 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F1.0 8 0 R +>> +/XObject << /Stamp1 360 0 R +>> +>> +/Annots [16 0 R 17 0 R 18 0 R] +>> +endobj +13 0 obj +[12 0 R /XYZ 0 841.89 null] +endobj +14 0 obj +<< /Type /Names +/Dests 15 0 R +>> +endobj +15 0 obj +<< /Kids [91 0 R 92 0 R 120 0 R 170 0 R 234 0 R] +>> +endobj +16 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (../progGuideDB/progguide.adoc) +>> +/Subtype /Link +/Rect [141.7551 629.3486 307.7304 643.6286] +/Type /Annot +>> +endobj +17 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (https://www.eclipse.org/ajdt/) +>> +/Subtype /Link +/Rect [431.2496 613.5686 496.1278 627.8486] +/Type /Annot +>> +endobj +18 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (https://eclipse.org/aspectj) +>> +/Subtype /Link +/Rect [283.86 597.7886 384.7545 612.0686] +/Type /Annot +>> +endobj +19 0 obj +<< /Length 13683 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +48.24 782.394 Td +/F2.0 22 Tf +<4368617074657220312e20496e74726f64756374696f6e20746f20746865204173706563744a20746f6f6c73> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 741.146 Td +/F2.0 18 Tf +<312e312e205468652045636c69707365204173706563744a20696d706c656d656e746174696f6e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2826 Tw + +BT +48.24 713.126 Td +/F1.0 10.5 Tf +<54686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +1.2826 Tw + +BT +70.9426 713.126 Td +/F1.0 10.5 Tf +[<4173706563744a2050726f6772> 20.0195 <616d6d696e67204775696465>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2826 Tw + +BT +214.512 713.126 Td +/F1.0 10.5 Tf +<2064657363726962657320746865204173706563744a206c616e67756167652e20546869732067756964652064657363726962657320746865204173706563744a> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.7401 Tw + +BT +48.24 697.346 Td +/F1.0 10.5 Tf +[<746f6f6c732070726f64756365642062> 20.0195 <7920746865204173706563744a207465616d206f6e20>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +0.7401 Tw + +BT +246.8829 697.346 Td +/F1.0 10.5 Tf +<687474703a2f2f65636c697073652e6f72672f6173706563746a> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.7401 Tw + +BT +367.5909 697.346 Td +/F1.0 10.5 Tf +<2e20546865204173706563744a20746f6f6c7320696e636c756465202d20616a632c20746865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.8894 Tw + +BT +48.24 681.566 Td +/F1.0 10.5 Tf +<636f6d70696c65722f7765617665723b20616a646f632c206120646f63756d656e746174696f6e20746f6f6c3b20616a62726f777365722c20612063726f737363757474696e6720636f6465207669657765723b20416e7420737570706f7274> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1508 Tw + +BT +48.24 665.786 Td +/F1.0 10.5 Tf +[<666f7220616a633b20616e64206c6f61642d74696d652077656176696e6720737570706f72742e20546865736520746f6f6c73206172652064656c69766572656420696e20746865206c696272> 20.0195 <61727920666f6c646572206f6620746865204173706563744a>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.4077 Tw + +BT +48.24 650.006 Td +/F1.0 10.5 Tf +<746f6f6c7320696e7374616c6c6174696f6e2c206d61696e6c7920696e20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.4077 Tw + +BT +193.1534 650.006 Td +/F3.0 10.5 Tf +<6173706563746a746f6f6c732e6a6172> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.4077 Tw + +BT +277.1534 650.006 Td +/F1.0 10.5 Tf +<2028746f6f6c732920616e6420> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.4077 Tw + +BT +339.7146 650.006 Td +/F3.0 10.5 Tf +<6173706563746a72742e6a6172> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.4077 Tw + +BT +407.9646 650.006 Td +/F1.0 10.5 Tf +<202872756e74696d65292e205468697320677569646520646f6573> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.8558 Tw + +BT +48.24 634.226 Td +/F1.0 10.5 Tf +[<6e6f74206465736372696265207468652045636c69707365204173706563744a20646576656c6f706d656e7420746f6f6c732028414a44> 20.0195 <54292e20546861742069732070726f64756365642062> 20.0195 <7920616e6f74686572207465616d>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +5.0799 Tw + +BT +48.24 618.446 Td +/F1.0 10.5 Tf +<2873686172696e6720736f6d65206d656d6265727329206f6e20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +5.0799 Tw + +BT +211.0445 618.446 Td +/F1.0 10.5 Tf +<687474703a2f2f65636c697073652e6f72672f616a6474> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +5.0799 Tw + +BT +316.2335 618.446 Td +/F1.0 10.5 Tf +[<2e20414a44> 20.0195 <542069732064656c69766572656420617320616e2045636c6970736520706c7567696e2c>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.8397 Tw + +BT +48.24 602.666 Td +/F1.0 10.5 Tf +[<696e636f72706f72> 20.0195 <6174696e672074686520636c617373657320696e20746865204173706563744a20746f6f6c73206c696272> 20.0195 <617269657320616c6f6e672077697468207468652045636c6970736520706c7567696e20696e74657266616365>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 586.886 Td +/F1.0 10.5 Tf +<636c61737365732e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4949 Tw + +BT +48.24 559.106 Td +/F1.0 10.5 Tf +[<53696e6365204173706563744a20312e312c2074686520746f6f6c73206861766520696d706c656d656e74656420746865204173706563744a206c616e6775616765207573696e672062> 20.0195 <797465636f64652077656176696e672c207768696368>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5879 Tw + +BT +48.24 543.326 Td +/F1.0 10.5 Tf +[<636f6d62696e6573206173706563747320616e6420636c617373657320746f2070726f64756365202e636c6173732066696c657320746861742072756e20696e2061204a61766120564d2e20546865726520617265206f74686572207761> 20.0195 <797320746f>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.8452 Tw + +BT +48.24 527.546 Td +/F1.0 10.5 Tf +[<696d706c656d656e7420746865206c616e67756167652028652e672e2c20636f6d70696c65722070726570726f636573736f722c20564d20737570706f7274293b20746865204173706563744a207465616d2068617320616c7761> 20.0195 <7973>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2824 Tw + +BT +48.24 511.766 Td +/F1.0 10.5 Tf +<747269656420746f2064697374696e677569736820746865206c616e677561676520616e642074686520696d706c656d656e746174696f6e20736f206f746865722067726f75707320636f756c64206275696c6420616c7465726e6174697665> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.3655 Tw + +BT +48.24 495.986 Td +/F1.0 10.5 Tf +[<696d706c656d656e746174696f6e73206f66204173706563744a2e2054> 29.7852 <6f207468617420656e642c20>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +1.3655 Tw + +BT +260.755 495.986 Td +/F1.0 10.5 Tf +[<546865204173706563744a2050726f6772> 20.0195 <616d6d696e672047756964652c20496d706c656d656e746174696f6e204e6f746573>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.3655 Tw + +BT +547.04 495.986 Td +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +5.9504 Tw + +BT +48.24 480.206 Td +/F1.0 10.5 Tf +[<64657363726962657320686f7720746865204a6176612062> 20.0195 <797465636f646520666f726d2061666665637473206c616e67756167652073656d616e746963732e20564d2d206f7220736f757263652d6261736564>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.053 Tw + +BT +48.24 464.426 Td +/F1.0 10.5 Tf +[<696d706c656d656e746174696f6e73206d61> 20.0195 <792062652066726565206f66207468657365206c696d697473206f7220696d706f7365206c696d697473206f66207468656972206f776e2c20627574206d6f73742073686f756c6420626520666169726c79>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 448.646 Td +/F1.0 10.5 Tf +[<636c6f736520746f2077686174d57320706f737369626c6520696e204a6176612062> 20.0195 <797465636f64652e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.0924 Tw + +BT +48.24 420.866 Td +/F1.0 10.5 Tf +[<506c65617365206265206361726566756c206e6f7420746f20636f6e6675736520616e> 20.0195 <79206465736372697074696f6e206f662077656176696e67206f72206f66207468697320696d706c656d656e746174696f6e206f6620746865204173706563744a>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5514 Tw + +BT +48.24 405.086 Td +/F1.0 10.5 Tf +<6c616e6775616765207769746820746865204173706563744a206c616e67756167652073656d616e746963732e20496620796f7520646f2c20796f75206d696768742066696e6420796f757273656c662077726974696e6720636f64652074686174> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2 Tw + +BT +48.24 389.306 Td +/F1.0 10.5 Tf +[<646f65736ed57420776f726b206173206578706563746564207768656e20796f7520636f6d70696c65206f722072756e206974206f6e206f746865722073797374656d732e204d6f726520696d706f7274616e746c79> 89.8438 <2c20696620796f75>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2828 Tw + +BT +48.24 373.526 Td +/F1.0 10.5 Tf +[<7468696e6b2061626f7574206173706563747320696e207465726d73206f662077656176696e67206f72206f6620696e73657274696e67206f72206d657267696e6720636f64652c207468656e20796f752063616e206c6f7365206d616e> 20.0195 <79206f66>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.1271 Tw + +BT +48.24 357.746 Td +/F1.0 10.5 Tf +<7468652064657369676e2062656e6566697473206f66207468696e6b696e672061626f757420616e2061737065637420617320612073696e676c652063726f737363757474696e67206d6f64756c652e205768656e207468652074657874> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2991 Tw + +BT +48.24 341.966 Td +/F1.0 10.5 Tf +[<62656c6f7720696e74726f647563657320616e20696d706c656d656e746174696f6e2064657461696c2c2069742077696c6c207761726e206966207573657273206d616b> 20.0195 <65206d697374616b> 20.0195 <65732062> 20.0195 <79206170706c79696e6720697420696e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 326.186 Td +/F1.0 10.5 Tf +<6c696575206f6620746865206c616e67756167652073656d616e746963732e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 286.346 Td +/F2.0 18 Tf +[<312e322e2042> 20.0195 <797465636f64652077656176696e672c20696e6372656d656e74616c20636f6d70696c6174696f6e2c20616e64>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 261.866 Td +/F2.0 18 Tf +<6d656d6f7279207573616765> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.5299 Tw + +BT +48.24 233.846 Td +/F1.0 10.5 Tf +[<42> 20.0195 <797465636f64652077656176696e672074616b> 20.0195 <657320636c617373657320616e64206173706563747320696e202e636c61737320666f726d20616e6420776561766573207468656d20746f67657468657220746f2070726f64756365>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1128 Tw + +BT +48.24 218.066 Td +/F1.0 10.5 Tf +[<62696e6172792d636f6d70617469626c65202e636c6173732066696c657320746861742072756e20696e20616e> 20.0195 <79204a61766120564d20616e6420696d706c656d656e7420746865204173706563744a2073656d616e746963732e2054686973>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.0884 Tw + +BT +48.24 202.286 Td +/F1.0 10.5 Tf +<70726f6365737320737570706f727473206e6f74206f6e6c792074686520636f6d70696c65722062757420616c736f20494445d5732e2054686520636f6d70696c65722c20676976656e20616e2061737065637420696e20736f7572636520666f726d2c> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5871 Tw + +BT +48.24 186.506 Td +/F1.0 10.5 Tf +<70726f647563657320612062696e6172792061737065637420616e642072756e7320746865207765617665722e20494445d5732063616e2067657420696e666f726d6174696f6e2061626f75742063726f737363757474696e6720696e20746865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 170.726 Td +/F1.0 10.5 Tf +[<70726f6772> 20.0195 <616d2062> 20.0195 <79207375627363726962696e6720746f20696e666f726d6174696f6e2070726f64756365642062> 20.0195 <7920776561766572206173206120736964652d656666656374206f662077656176696e672e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.3696 Tw + +BT +48.24 142.946 Td +/F1.0 10.5 Tf +<496e6372656d656e74616c20636f6d70696c6174696f6e20696e766f6c766573207265636f6d70696c696e67206f6e6c792077686174206973206e656365737361727920746f206272696e67207468652062696e61727920666f726d206f662061> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.2382 Tw + +BT +48.24 127.166 Td +/F1.0 10.5 Tf +[<70726f6772> 20.0195 <616d2075702d746f2d6461746520776974682074686520736f7572636520666f726d20696e207468652073686f72746573742074696d6520706f737369626c652e20496e6372656d656e74616c2077656176696e67>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.0269 Tw + +BT +48.24 111.386 Td +/F1.0 10.5 Tf +[<737570706f72747320746869732062> 20.0195 <792077656176696e67206f6e2061207065722d636c6173732062617369732e2028536f6d6520696d706c656d656e746174696f6e73206f662041> 20.0195 <4f502028696e636c7564696e67204173706563744a20312e3029>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2946 Tw + +BT +48.24 95.606 Td +/F1.0 10.5 Tf +[<6d616b> 20.0195 <6520757365206f662077686f6c652d70726f6772> 20.0195 <616d20616e616c7973697320746861742063616ed57420626520646f6e6520696e20696e6372656d656e74616c206d6f64652e292057> 60.0586 <656176696e67207065722d636c617373>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.7627 Tw + +BT +48.24 79.826 Td +/F1.0 10.5 Tf +<6d65616e7320746861742069662074686520736f7572636520666f7220612070757265204a61766120636c61737320697320757064617465642c206f6e6c79207468617420636c617373206e6565647320746f2062652070726f64756365642e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.8164 Tw + +BT +48.24 64.046 Td +/F1.0 10.5 Tf +[<486f77657665722c20696620736f6d652063726f737363757474696e672073706563696669636174696f6e206d61> 20.0195 <792068617665206265656e20757064617465642c207468656e20616c6c20636f646520706f74656e7469616c6c79>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp2 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +49.24 14.263 Td +/F1.0 9 Tf +<32> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +20 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 19 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F2.0 22 0 R +/F1.0 8 0 R +/F3.0 26 0 R +>> +/XObject << /Stamp2 361 0 R +>> +>> +/Annots [24 0 R 25 0 R 27 0 R 28 0 R] +>> +endobj +21 0 obj +[20 0 R /XYZ 0 841.89 null] +endobj +22 0 obj +<< /Type /Font +/BaseFont /b37b0f+NotoSerif-Bold +/Subtype /TrueType +/FontDescriptor 367 0 R +/FirstChar 32 +/LastChar 255 +/Widths 369 0 R +/ToUnicode 368 0 R +>> +endobj +23 0 obj +[20 0 R /XYZ 0 765.17 null] +endobj +24 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (../progguide/index.html) +>> +/Subtype /Link +/Rect [70.9426 710.06 214.512 724.34] +/Type /Annot +>> +endobj +25 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (http://eclipse.org/aspectj) +>> +/Subtype /Link +/Rect [246.8829 694.28 367.5909 708.56] +/Type /Annot +>> +endobj +26 0 obj +<< /Type /Font +/BaseFont /61e12f+mplus1mn-regular +/Subtype /TrueType +/FontDescriptor 371 0 R +/FirstChar 32 +/LastChar 255 +/Widths 373 0 R +/ToUnicode 372 0 R +>> +endobj +27 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (http://eclipse.org/aspectj) +>> +/Subtype /Link +/Rect [211.0445 615.38 316.2335 629.66] +/Type /Annot +>> +endobj +28 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (../progguide/implementation.html) +>> +/Subtype /Link +/Rect [260.755 492.92 547.04 507.2] +/Type /Annot +>> +endobj +29 0 obj +[20 0 R /XYZ 0 310.37 null] +endobj +30 0 obj +<< /Length 15549 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +0.7491 Tw + +BT +48.24 794.676 Td +/F1.0 10.5 Tf +[<61666665637465642062> 20.0195 <79206974206d61> 20.0195 <79206e65656420746f20626520776f76656e2e20546865204173706563744a20746f6f6c73206172652067657474696e6720626574746572206174206d696e696d697a696e672074686973206566666563742c>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 778.896 Td +/F1.0 10.5 Tf +<62757420697420697320746f20736f6d652064656772656520756e61766f696461626c652064756520746f207468652063726f737363757474696e672073656d616e746963732e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.3078 Tw + +BT +48.24 751.116 Td +/F1.0 10.5 Tf +<4d656d6f72792075736167652063616e207365656d206869676865722077697468204173706563744a20746f6f6c732e20536f6d65206173706563747320617265207772697474656e20746f20706f74656e7469616c6c7920616666656374> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.2184 Tw + +BT +48.24 735.336 Td +/F1.0 10.5 Tf +[<6d616e> 20.0195 <7920636c61737365732c20736f206561636820636c617373206d75737420626520636865636b> 20.0195 <656420647572696e67207468652070726f63657373206f662077656176696e672e2050726f6772> 20.0195 <616d6d6572732063616e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6884 Tw + +BT +48.24 719.556 Td +/F1.0 10.5 Tf +[<6d696e696d697a6520746869732062> 20.0195 <792077726974696e67207468652063726f737363757474696e672073706563696669636174696f6e73206173206e6172726f776c7920617320706f737369626c65207768696c65206d61696e7461696e696e67>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4702 Tw + +BT +48.24 703.776 Td +/F1.0 10.5 Tf +[<636f72726563746e6573732e20285768696c65206974206d61> 20.0195 <79207365656d206c696b> 20.0195 <65206d6f7265206d656d6f7279> 89.8438 <2c207468652070726f70657220636f6d70617269736f6e20776f756c64207769746820776974682061204a617661>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.8943 Tw + +BT +48.24 687.996 Td +/F1.0 10.5 Tf +[<70726f6772> 20.0195 <616d207468617420686164207468652073616d652063726f737363757474696e672c2077697468206368616e676573206d61646520746f206561636820636f6465207365676d656e742e205468617420776f756c64>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 672.216 Td +/F1.0 10.5 Tf +[<6c696b> 20.0195 <656c792072657175697265206d6f7265206d656d6f727920616e64206d6f72652074696d6520746f207265636f6d70696c65207468616e2074686520636f72726573706f6e64696e67204173706563744a2070726f6772> 20.0195 <616d2e29>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 637.716 Td +/F2.0 13 Tf +<312e322e312e20436c617373706174682c20696e706174682c20616e642061737065637470617468> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.8286 Tw + +BT +48.24 611.156 Td +/F1.0 10.5 Tf +<4173706563744a20696e74726f64756365732074776f206e657720706174687320666f72207468652062696e61727920696e70757420746f207468652077656176657220776869636820796f75d56c6c2066696e64207265666572656e636564> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 595.376 Td +/F1.0 10.5 Tf +<696e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +61.0815 595.376 Td +/F1.0 10.5 Tf +<3f3f3f> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +76.8315 595.376 Td +/F1.0 10.5 Tf +<2c20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +82.176 595.376 Td +/F1.0 10.5 Tf +<3f3f3f> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +97.926 595.376 Td +/F1.0 10.5 Tf +<2c20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +103.2705 595.376 Td +/F1.0 10.5 Tf +<3f3f3f> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +119.0205 595.376 Td +/F1.0 10.5 Tf +<2c20616e6420> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +146.1945 595.376 Td +/F1.0 10.5 Tf +<3f3f3f> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +161.9445 595.376 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2093 Tw + +BT +48.24 567.596 Td +/F1.0 10.5 Tf +<417320696e204a6176612c2074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.2093 Tw + +BT +126.4303 567.596 Td +/F3.0 10.5 Tf +<636c61737370617468> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2093 Tw + +BT +173.6803 567.596 Td +/F1.0 10.5 Tf +[<20697320776865726520746865204173706563744a20746f6f6c73207265736f6c76652074797065732073706563696669656420696e207468652070726f6772> 20.0195 <616d2e205768656e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.3033 Tw + +BT +48.24 551.816 Td +/F1.0 10.5 Tf +[<72756e6e696e6720616e204173706563744a2070726f6772> 20.0195 <616d2c2074686520636c617373706174682073686f756c6420636f6e7461696e2074686520636c617373657320616e64206173706563747320616c6f6e67207769746820746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 536.036 Td +/F1.0 10.5 Tf +[<4173706563744a2072756e74696d65206c696272> 20.0195 <617279> 89.8438 <2c20>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +170.3669 536.036 Td +/F3.0 10.5 Tf +<6173706563746a72742e6a6172> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +238.6169 536.036 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.3708 Tw + +BT +48.24 508.256 Td +/F1.0 10.5 Tf +<496e204173706563744a20746f6f6c732c2074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.3708 Tw + +BT +154.4181 508.256 Td +/F3.0 10.5 Tf +<61737065637470617468> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.3708 Tw + +BT +206.9181 508.256 Td +/F1.0 10.5 Tf +[<20697320776865726520746f2066696e642062696e61727920617370656374732e204c696b> 20.0195 <652074686520636c617373706174682c2069742063616e20696e636c756465>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6326 Tw + +BT +48.24 492.476 Td +/F1.0 10.5 Tf +[<617263686976657320282e6a617220616e64202e7a69702066696c65732920616e64206469726563746f7269657320636f6e7461696e696e67202e636c6173732066696c657320696e2061207061636b616765206c61> 20.0195 <796f7574202873696e63652062696e617279>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.305 Tw + +BT +48.24 476.696 Td +/F1.0 10.5 Tf +[<617370656374732061726520696e202e636c6173732066696c6573292e205468657365206173706563747320616666656374206f7468657220636c617373657320696e2065786163746c79207468652073616d65207761> 20.0195 <7920617320736f757263652d6c6576656c>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.3164 Tw + +BT +48.24 460.916 Td +/F1.0 10.5 Tf +[<617370656374732c2062757420617265207468656d73656c766573206e6f742061666665637465642e205768656e206465706c6f> 20.0195 <79696e672070726f6772> 20.0195 <616d732c20746865206f726967696e616c2061737065637473206d757374206265>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 445.136 Td +/F1.0 10.5 Tf +<696e636c75646564206f6e207468652072756e74696d6520636c617373706174682e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6946 Tw + +BT +48.24 417.356 Td +/F1.0 10.5 Tf +<496e204173706563744a20746f6f6c732c2074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.6946 Tw + +BT +151.7135 417.356 Td +/F3.0 10.5 Tf +<696e70617468> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6946 Tw + +BT +183.2135 417.356 Td +/F1.0 10.5 Tf +[<20697320776865726520746f2066696e642062696e61727920696e707574202d206173706563747320616e6420636c6173736573207468617420776561766520616e64206d61> 20.0195 <79>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1934 Tw + +BT +48.24 401.576 Td +/F1.0 10.5 Tf +[<626520776f76656e2e204c696b> 20.0195 <652074686520636c617373706174682c2069742063616e20696e636c75646520617263686976657320616e6420636c617373206469726563746f726965732e204c696b> 20.0195 <652074686520617370656374706174682c206974>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.3703 Tw + +BT +48.24 385.796 Td +/F1.0 10.5 Tf +[<63616e20696e636c7564652061737065637473207468617420616666656374206f7468657220636c617373657320616e6420617370656374732e20486f77657665722c20756e6c696b> 20.0195 <652074686520617370656374706174682c20616e20617370656374>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.9492 Tw + +BT +48.24 370.016 Td +/F1.0 10.5 Tf +[<6f6e2074686520696e70617468206d61> 20.0195 <7920697473656c662062652061666665637465642062> 20.0195 <7920617370656374732c2061732069662074686520736f75726365207765726520616c6c20636f6d70696c656420746f6765746865722e205768656e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.4475 Tw + +BT +48.24 354.236 Td +/F1.0 10.5 Tf +[<6465706c6f> 20.0195 <79696e6720617370656374732074686174207765726520707574206f6e2074686520696e706174682c206f6e6c792074686520776f76656e206f75747075742073686f756c64206265206f6e207468652072756e74696d65>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 338.456 Td +/F1.0 10.5 Tf +<636c617373706174682e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.2278 Tw + +BT +48.24 310.676 Td +/F1.0 10.5 Tf +[<416c74686f75676820747970657320696e2074686520696e7061746820616e64207468652061737065637470617468206e65656420746f206265207265736f6c7665642062> 20.0195 <7920746865204173706563744a20746f6f6c732c20796f75>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.4884 Tw + +BT +48.24 294.896 Td +/F1.0 10.5 Tf +[<757375616c6c7920646f206e6f74206e65656420746f20706c616365207468656d206f6e2074686520636c617373706174682062656361757365207468697320697320646f6e65206175746f6d61746963616c6c792062> 20.0195 <7920746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.4787 Tw + +BT +48.24 279.116 Td +/F1.0 10.5 Tf +<636f6d70696c65722f7765617665722e20427574207768656e207573696e672074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +2.4787 Tw + +BT +250.2531 279.116 Td +/F3.0 10.5 Tf +<57656176696e6755524c436c6173734c6f61646572> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.4787 Tw + +BT +360.5031 279.116 Td +/F1.0 10.5 Tf +<2c20796f757220636f6465206d757374206578706c696369746c792061646420746865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.4559 Tw + +BT +48.24 263.336 Td +/F1.0 10.5 Tf +<6173706563747320746f2074686520636c6173737061746820736f20746865792063616e206265207265736f6c7665642028617320796f75d56c6c2073656520696e207468652073616d706c6520636f646520616e642074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.4559 Tw + +BT +515.54 263.336 Td +/F3.0 10.5 Tf +<616a2e626174> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.4559 Tw + +BT +547.04 263.336 Td +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 247.556 Td +/F1.0 10.5 Tf +<736372697074292e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1818 Tw + +BT +48.24 219.776 Td +/F1.0 10.5 Tf +[<546865206d6f737420636f6d6d6f6e206d697374616b> 20.0195 <65206973206661696c696e6720746f2061646420>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.1818 Tw + +BT +266.3306 219.776 Td +/F3.0 10.5 Tf +<6173706563746a72742e6a6172> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1818 Tw + +BT +334.5806 219.776 Td +/F1.0 10.5 Tf +<20746f2074686520636c617373706174682e20416c736f2c207768656e2077656176696e672077697468> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.3983 Tw + +BT +48.24 203.996 Td +/F1.0 10.5 Tf +[<62696e61727920617370656374732c20757365727320666f7267657420746f206465706c6f> 20.0195 <79207468652061737065637420697473656c6620616c6f6e67207769746820616e> 20.0195 <7920636c61737365732069742072657175697265732e2041206d6f7265>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.8955 Tw + +BT +48.24 188.216 Td +/F1.0 10.5 Tf +[<737562746c65206d697374616b> 20.0195 <652069732070757474696e6720612062696e61727920617370656374202842> 20.0195 <4129206f6e2074686520696e7061746820696e7374656164206f662074686520617370656374706174682e20496e20746869732063617365>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.3497 Tw + +BT +48.24 172.436 Td +/F1.0 10.5 Tf +[<746865206173706563742042> 20.0195 <41206d696768742062652061666665637465642062> 20.0195 <7920616e206173706563742c206576656e20697473656c663b20746869732063616e206361757365207468652070726f6772> 20.0195 <616d20746f206661696c2c20652e672e2c>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 156.656 Td +/F1.0 10.5 Tf +[<7768656e20616e206173706563742075736573206578636c7573696f6e20746f2061766f696420696e66696e69746520726563757273696f6e20627574206661696c7320746f206578636c7564652061647669636520696e206173706563742042> 20.0195 <412e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.242 Tw + +BT +48.24 128.876 Td +/F1.0 10.5 Tf +[<546865206c6174746572206973206f6e65206f66206d616e> 20.0195 <79207761> 20.0195 <79732074686174206d697374616b> 20.0195 <657320696e20746865206275696c642070726f636573732063616e206166666563742061737065637473207468617420617265207772697474656e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.7109 Tw + +BT +48.24 113.096 Td +/F1.0 10.5 Tf +[<706f6f726c79> 89.8438 <2e20417370656374732073686f756c64206e657665722072656c79206f6e2074686520626f756e646172696573206f6620746865206275696c642073706563696669636174696f6e20746f206e6172726f77207468652073636f7065>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2833 Tw + +BT +48.24 97.316 Td +/F1.0 10.5 Tf +<6f662074686569722063726f737363757474696e672c2073696e636520746865206275696c642063616e206265206368616e67656420776974686f7574206e6f7469636520746f207468652061737065637420646576656c6f7065722e204361726566756c> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6088 Tw + +BT +48.24 81.536 Td +/F1.0 10.5 Tf +<7573657273206d69676874206576656e2061766f69642072656c79696e67206f6e2074686520696d706c656d656e746174696f6e2073636f70652c20746f20656e73757265207468656972204173706563744a20636f64652077696c6c2072756e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 65.756 Td +/F1.0 10.5 Tf +<6f6e206f7468657220696d706c656d656e746174696f6e732e203d3d20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +198.369 65.756 Td +/F3.0 10.5 Tf +<616a63> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +214.119 65.756 Td +/F1.0 10.5 Tf +<2c20746865204173706563744a20636f6d70696c65722f776561766572> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp1 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +541.009 14.263 Td +/F1.0 9 Tf +<33> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +31 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 30 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F1.0 8 0 R +/F2.0 22 0 R +/F3.0 26 0 R +>> +/XObject << /Stamp1 360 0 R +>> +>> +/Annots [33 0 R 34 0 R 35 0 R 36 0 R] +>> +endobj +32 0 obj +[31 0 R /XYZ 0 656.4 null] +endobj +33 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#ajc-ref) +>> +/Subtype /Link +/Rect [61.0815 592.31 76.8315 606.59] +/Type /Annot +>> +endobj +34 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#ajbrowser) +>> +/Subtype /Link +/Rect [82.176 592.31 97.926 606.59] +/Type /Annot +>> +endobj +35 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#antTasks) +>> +/Subtype /Link +/Rect [103.2705 592.31 119.0205 606.59] +/Type /Annot +>> +endobj +36 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#ltw) +>> +/Subtype /Link +/Rect [146.1945 592.31 161.9445 606.59] +/Type /Annot +>> +endobj +37 0 obj +<< /Length 11955 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +48.24 786.666 Td +/F2.0 18 Tf +<312e332e204e616d65> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +48.24 758.646 Td +/F3.0 10.5 Tf +<616a63> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.99 758.646 Td +/F1.0 10.5 Tf +[<202d20636f6d70696c657220616e642062> 20.0195 <797465636f64652077656176657220666f7220746865204173706563744a20616e64204a617661206c616e677561676573>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 718.806 Td +/F2.0 18 Tf +[<312e342e2053> 20.0195 <796e6f70736973>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 702.75 m +543.04 702.75 l +545.2491 702.75 547.04 700.9591 547.04 698.75 c +547.04 670.01 l +547.04 667.8009 545.2491 666.01 543.04 666.01 c +52.24 666.01 l +50.0309 666.01 48.24 667.8009 48.24 670.01 c +48.24 698.75 l +48.24 700.9591 50.0309 702.75 52.24 702.75 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 702.75 m +543.04 702.75 l +545.2491 702.75 547.04 700.9591 547.04 698.75 c +547.04 670.01 l +547.04 667.8009 545.2491 666.01 543.04 666.01 c +52.24 666.01 l +50.0309 666.01 48.24 667.8009 48.24 670.01 c +48.24 698.75 l +48.24 700.9591 50.0309 702.75 52.24 702.75 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 679.925 Td +/F3.0 11 Tf +<616a63205b4f7074696f6e735d205b66696c652e2e2e207c204066696c652e2e2e207c202d61726766696c652066696c652e2e2e5d> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 629.986 Td +/F2.0 18 Tf +<312e352e204465736372697074696f6e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2793 Tw + +BT +48.24 601.966 Td +/F1.0 10.5 Tf +<54686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.2793 Tw + +BT +70.9393 601.966 Td +/F3.0 10.5 Tf +<616a63> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2793 Tw + +BT +86.6893 601.966 Td +/F1.0 10.5 Tf +<20636f6d6d616e6420636f6d70696c657320616e6420776561766573204173706563744a20616e64204a61766120736f7572636520616e64202e636c6173732066696c65732c2070726f647563696e67202e636c617373> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4913 Tw + +BT +48.24 586.186 Td +/F1.0 10.5 Tf +[<66696c657320636f6d706c69616e74207769746820616e> 20.0195 <79204a61766120564d2028312e31206f72206c61746572292e20497420636f6d62696e657320636f6d70696c6174696f6e20616e642062> 20.0195 <797465636f64652077656176696e6720616e64>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 570.406 Td +/F1.0 10.5 Tf +[<737570706f72747320696e6372656d656e74616c206275696c64733b20796f752063616e20616c736f2077656176652062> 20.0195 <797465636f64652061742072756e2d74696d65207573696e6720>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +431.1223 570.406 Td +/F1.0 10.5 Tf +<3f3f3f> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +446.8723 570.406 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6367 Tw + +BT +48.24 542.626 Td +/F1.0 10.5 Tf +[<54686520617267756d656e747320616674657220746865206f7074696f6e7320737065636966792074686520736f757263652066696c6528732920746f20636f6d70696c652e2054> 29.7852 <6f207370656369667920736f7572636520636c61737365732c20757365>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.1976 Tw + +BT +48.24 526.846 Td +/F3.0 10.5 Tf +<2d696e70617468> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1976 Tw + +BT +84.99 526.846 Td +/F1.0 10.5 Tf +[<202862656c6f77292e2046696c6573206d61> 20.0195 <79206265206c6973746564206469726563746c79206f6e2074686520636f6d6d616e64206c696e65206f7220696e20612066696c652e2054686520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.1976 Tw + +BT +456.5653 526.846 Td +/F3.0 10.5 Tf +<2d61726766696c652066696c65> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1976 Tw + +BT +525.0129 526.846 Td +/F1.0 10.5 Tf +<20616e64> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.1608 Tw + +BT +48.24 511.066 Td +/F3.0 10.5 Tf +<4066696c65> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1608 Tw + +BT +74.49 511.066 Td +/F1.0 10.5 Tf +<20666f726d7320617265206571756976616c656e742c20616e642061726520696e746572707265746564206173206d65616e696e6720616c6c2074686520617267756d656e7473206c697374656420696e2074686520737065636966696564> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 495.286 Td +/F1.0 10.5 Tf +<66696c652e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.749 Tw + +BT +48.24 467.506 Td +/F3.0 10.5 Tf +<4e6f74653a> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.749 Tw + +BT +74.49 467.506 Td +/F1.0 10.5 Tf +[<2059> 69.8242 <6f75206d757374206578706c696369746c79207061737320>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.749 Tw + +BT +203.3021 467.506 Td +/F3.0 10.5 Tf +<616a63> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.749 Tw + +BT +219.0521 467.506 Td +/F1.0 10.5 Tf +<20616c6c206e656365737361727920736f75726365732e204265207375726520746f20696e636c7564652074686520736f75726365206e6f74206f6e6c7920666f72> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4359 Tw + +BT +48.24 451.726 Td +/F1.0 10.5 Tf +[<7468652061737065637473206f7220706f696e74637574732062757420616c736f20666f7220616e> 20.0195 <792061666665637465642074797065732e2053706563696679696e6720616c6c20736f7572636573206973206e656365737361727920626563617573652c>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2932 Tw + +BT +48.24 435.946 Td +/F1.0 10.5 Tf +[<756e6c696b> 20.0195 <65206a617661632c20616a6320646f6573206e6f74207365617263682074686520736f757263657061746820666f7220636c61737365732e202846> 40.0391 <6f7220612064697363757373696f6e206f662077686174206166666563746564207479706573>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 420.166 Td +/F1.0 10.5 Tf +<6d696768742062652072657175697265642c2073656520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +163.0365 420.166 Td +/F1.0 10.5 Tf +[<546865204173706563744a2050726f6772> 20.0195 <616d6d696e672047756964652c20496d706c656d656e746174696f6e20417070656e646978>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +462.8953 420.166 Td +/F1.0 10.5 Tf +<2e29> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1848 Tw + +BT +48.24 392.386 Td +/F1.0 10.5 Tf +[<54> 29.7852 <6f207370656369667920736f75726365732c20796f752063616e206c69737420736f757263652066696c657320617320617267756d656e7473206f722075736520746865206f7074696f6e7320>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.1848 Tw + +BT +427.8525 392.386 Td +/F3.0 10.5 Tf +<2d736f75726365726f6f7473> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1848 Tw + +BT +490.8525 392.386 Td +/F1.0 10.5 Tf +<206f7220> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.1848 Tw + +BT +507.665 392.386 Td +/F3.0 10.5 Tf +<2d696e70617468> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1848 Tw + +BT +544.415 392.386 Td +/F1.0 10.5 Tf +<2e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2571 Tw + +BT +48.24 376.606 Td +/F1.0 10.5 Tf +[<496620746865726520617265206d756c7469706c6520736f757263657320666f7220616e> 20.0195 <7920747970652c2074686520726573756c7420697320756e646566696e65642073696e636520616a6320686173206e6f207761> 20.0195 <7920746f2064657465726d696e65>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6598 Tw + +BT +48.24 360.826 Td +/F1.0 10.5 Tf +<776869636820736f7572636520697320636f72726563742e2028546869732068617070656e73206d6f7374206f6674656e207768656e20757365727320696e636c756465207468652064657374696e6174696f6e206469726563746f7279206f6e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 345.046 Td +/F1.0 10.5 Tf +<74686520696e7061746820616e642072656275696c642e29> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 310.546 Td +/F2.0 13 Tf +<312e352e312e204f7074696f6e73> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 283.986 Td +/F2.0 10.5 Tf +<2d696e6a617273203c4a61724c6973743e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 265.206 Td +/F1.0 10.5 Tf +[<646570726563617465643a2073696e636520312e322c20757365202d696e706174682c20776869636820616c736f2074616b> 20.0195 <6573206469726563746f726965732e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 237.426 Td +/F2.0 10.5 Tf +<2d696e70617468203c506174683e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.7524 Tw + +BT +63.24 218.646 Td +/F1.0 10.5 Tf +[<41> 20.0195 <636365707420617320736f757263652062> 20.0195 <797465636f646520616e> 20.0195 <79202e636c6173732066696c657320696e20746865202e6a61722066696c6573206f72206469726563746f72696573206f6e20506174682e20546865206f75747075742077696c6c>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.9527 Tw + +BT +63.24 202.866 Td +/F1.0 10.5 Tf +[<696e636c75646520746865736520636c61737365732c20706f737369626c7920617320776f76656e207769746820616e> 20.0195 <79206170706c696361626c6520617370656374732e205061746820697320612073696e676c6520617267756d656e74>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.6537 Tw + +BT +63.24 187.086 Td +/F1.0 10.5 Tf +[<636f6e7461696e696e672061206c697374206f6620706174687320746f207a69702066696c6573206f72206469726563746f726965732c2064656c696d697465642062> 20.0195 <792074686520706c6174666f726d2d73706563696669632070617468>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 171.306 Td +/F1.0 10.5 Tf +<64656c696d697465722e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 143.526 Td +/F2.0 10.5 Tf +<2d61737065637470617468203c506174683e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6701 Tw + +BT +63.24 124.746 Td +/F1.0 10.5 Tf +[<57> 60.0586 <656176652062696e61727920617370656374732066726f6d206a61722066696c657320616e64206469726563746f72696573206f6e207061746820696e746f20616c6c20736f75726365732e2054686520617370656374732073686f756c64>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1275 Tw + +BT +63.24 108.966 Td +/F1.0 10.5 Tf +[<68617665206265656e206f75747075742062> 20.0195 <79207468652073616d652076657273696f6e206f662074686520636f6d70696c65722e205768656e2072756e6e696e6720746865206f757470757420636c61737365732c207468652072756e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.6804 Tw + +BT +63.24 93.186 Td +/F1.0 10.5 Tf +[<636c617373706174682073686f756c6420636f6e7461696e20616c6c206173706563747061746820656e74726965732e20506174682c206c696b> 20.0195 <6520636c617373706174682c20697320612073696e676c6520617267756d656e74>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 77.406 Td +/F1.0 10.5 Tf +[<636f6e7461696e696e672061206c697374206f6620706174687320746f206a61722066696c65732c2064656c696d697465642062> 20.0195 <792074686520706c6174666f726d2d20737065636966696320636c617373706174682064656c696d697465722e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp2 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +49.24 14.263 Td +/F1.0 9 Tf +<34> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +38 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 37 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F2.0 22 0 R +/F3.0 26 0 R +/F1.0 8 0 R +>> +/XObject << /Stamp2 361 0 R +>> +>> +/Annots [42 0 R 43 0 R] +>> +endobj +39 0 obj +[38 0 R /XYZ 0 841.89 null] +endobj +40 0 obj +[38 0 R /XYZ 0 742.83 null] +endobj +41 0 obj +[38 0 R /XYZ 0 654.01 null] +endobj +42 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#ltw) +>> +/Subtype /Link +/Rect [431.1223 567.34 446.8723 581.62] +/Type /Annot +>> +endobj +43 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (../progguide/implementation.html) +>> +/Subtype /Link +/Rect [163.0365 417.1 462.8953 431.38] +/Type /Annot +>> +endobj +44 0 obj +[38 0 R /XYZ 0 329.23 null] +endobj +45 0 obj +<< /Length 9726 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +48.24 793.926 Td +/F2.0 10.5 Tf +<2d61726766696c65203c46696c653e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.203 Tw + +BT +63.24 775.146 Td +/F1.0 10.5 Tf +<5468652066696c6520636f6e7461696e732061206c696e652d64656c696d69746564206c697374206f6620617267756d656e74732e2045616368206c696e6520696e207468652066696c652073686f756c6420636f6e7461696e206f6e65> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0089 Tw + +BT +63.24 759.366 Td +/F1.0 10.5 Tf +<6f7074696f6e2c2066696c656e616d652c206f7220617267756d656e7420737472696e672028652e672e2c206120636c61737370617468206f7220696e70617468292e20417267756d656e747320726561642066726f6d207468652066696c65> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6122 Tw + +BT +63.24 743.586 Td +/F1.0 10.5 Tf +<61726520696e73657274656420696e746f2074686520617267756d656e74206c69737420666f722074686520636f6d6d616e642e2052656c617469766520706174687320696e207468652066696c65206172652063616c63756c61746564> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.3024 Tw + +BT +63.24 727.806 Td +/F1.0 10.5 Tf +<66726f6d20746865206469726563746f727920636f6e7461696e696e67207468652066696c6520286e6f74207468652063757272656e7420776f726b696e67206469726563746f7279292e20436f6d6d656e74732c20617320696e204a6176612c> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4621 Tw + +BT +63.24 712.026 Td +/F1.0 10.5 Tf +<7374617274207769746820> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.4621 Tw + +BT +115.3203 712.026 Td +/F3.0 10.5 Tf +<2f2f> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4621 Tw + +BT +125.8203 712.026 Td +/F1.0 10.5 Tf +[<20616e6420657874656e6420746f2074686520656e64206f6620746865206c696e652e204f7074696f6e732073706563696669656420696e20617267756d656e742066696c6573206d61> 20.0195 <79206f76657272696465>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.8675 Tw + +BT +63.24 696.246 Td +/F1.0 10.5 Tf +[<72> 20.0195 <6174686572207468616e20657874656e64696e67206578697374696e67206f7074696f6e2076616c7565732c20736f2061766f69642073706563696679696e67206f7074696f6e73206c696b> 20.0195 <6520>] TJ +/F1.1 10.5 Tf +<21> Tj +/F1.0 10.5 Tf +<636c617373706174683e20696e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1264 Tw + +BT +63.24 680.466 Td +/F1.0 10.5 Tf +[<617267756d656e742066696c657320756e6c696b> 20.0195 <652074686520617267756d656e742066696c6520697320746865206f6e6c79206275696c642073706563696669636174696f6e2e2054686520666f726d203c4066696c653e20697320746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 664.686 Td +/F1.0 10.5 Tf +<73616d652061732073706563696679696e6720> Tj +/F1.1 10.5 Tf +<21> Tj +/F1.0 10.5 Tf +<61726766696c652066696c653e2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 636.906 Td +/F2.0 10.5 Tf +<2d6f75746a6172203c6f75747075742e6a61723e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 618.126 Td +/F1.0 10.5 Tf +<507574206f757470757420636c617373657320696e207a69702066696c65206f75747075742e6a61722e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 590.346 Td +/F2.0 10.5 Tf +<2d6f7574786d6c> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 571.566 Td +/F1.0 10.5 Tf +[<47656e6572> 20.0195 <61746520616f702e786d6c2066696c6520666f72206c6f61642d74696d652077656176696e6720776974682064656661756c74206e616d652e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 543.786 Td +/F2.0 10.5 Tf +<2d6f7574786d6c66696c65203c637573746f6d2f616f702e786d6c3e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 525.006 Td +/F1.0 10.5 Tf +[<47656e6572> 20.0195 <61746520616f702e786d6c2066696c6520666f72206c6f61642d74696d652077656176696e67207769746820637573746f6d206e616d652e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 497.226 Td +/F2.0 10.5 Tf +<2d696e6372656d656e74616c> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.3982 Tw + +BT +63.24 478.446 Td +/F1.0 10.5 Tf +[<52756e2074686520636f6d70696c657220636f6e74696e756f75736c79> 89.8438 <2e2041667465722074686520696e697469616c20636f6d70696c6174696f6e2c2074686520636f6d70696c65722077696c6c207761697420746f207265636f6d70696c65>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2269 Tw + +BT +63.24 462.666 Td +/F1.0 10.5 Tf +<756e74696c2069742072656164732061206e65776c696e652066726f6d20746865207374616e6461726420696e7075742c20616e642077696c6c2071756974207768656e2069742072656164732061202771272e2049742077696c6c206f6e6c79> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.752 Tw + +BT +63.24 446.886 Td +/F1.0 10.5 Tf +<7265636f6d70696c65206e656365737361727920636f6d706f6e656e74732c20736f2061207265636f6d70696c652073686f756c64206265206d75636820666173746572207468616e20646f696e672061207365636f6e64> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 431.106 Td +/F1.0 10.5 Tf +<636f6d70696c652e2054686973207265717569726573202d736f75726365726f6f74732e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 403.326 Td +/F2.0 10.5 Tf +<2d736f75726365726f6f7473203c44697250617468733e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0928 Tw + +BT +63.24 384.546 Td +/F1.0 10.5 Tf +[<46696e6420616e64206275696c6420616c6c202e6a617661206f72202e616a20736f757263652066696c657320756e64657220616e> 20.0195 <79206469726563746f7279206c697374656420696e2044697250617468732e2044697250617468732c206c696b> 20.0195 <65>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.012 Tw + +BT +63.24 368.766 Td +/F1.0 10.5 Tf +[<636c617373706174682c20697320612073696e676c6520617267756d656e7420636f6e7461696e696e672061206c697374206f6620706174687320746f206469726563746f726965732c2064656c696d697465642062> 20.0195 <792074686520706c6174666f726d2d>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 352.986 Td +/F1.0 10.5 Tf +[<737065636966696320636c617373706174682064656c696d697465722e2052657175697265642062> 20.0195 <79202d696e6372656d656e74616c2e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 325.206 Td +/F2.0 10.5 Tf +<2d63726f737372656673> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0145 Tw + +BT +63.24 306.426 Td +/F1.0 10.5 Tf +[<47656e6572> 20.0195 <6174652061206275696c64202e616a73796d2066696c6520696e746f20746865206f7574707574206469726563746f7279> 89.8438 <2e205573656420666f722076696577696e672063726f737363757474696e67207265666572656e636573>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 290.646 Td +/F1.0 10.5 Tf +[<62> 20.0195 <7920746f6f6c73206c696b> 20.0195 <6520746865204173706563744a2042726f777365722e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 262.866 Td +/F2.0 10.5 Tf +<2d656d61637373796d> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 244.086 Td +/F1.0 10.5 Tf +[<47656e6572> 20.0195 <617465202e616a6573796d2073796d626f6c2066696c657320666f7220656d61637320737570706f7274202864657072656361746564292e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 216.306 Td +/F2.0 10.5 Tf +<2d586c696e74> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 197.526 Td +/F1.0 10.5 Tf +[<53616d65206173202d586c696e743a7761726e696e672028656e61626c65642062> 20.0195 <792064656661756c7429>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 169.746 Td +/F2.0 10.5 Tf +<2d586c696e743a7b6c6576656c7d> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.1321 Tw + +BT +63.24 150.966 Td +/F1.0 10.5 Tf +[<5365742064656661756c74206c6576656c20666f72206d657373616765732061626f757420706f74656e7469616c2070726f6772> 20.0195 <616d6d696e67206d697374616b> 20.0195 <657320696e2063726f737363757474696e6720636f64652e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +15.619 Tw + +BT +63.24 135.186 Td +/F1.0 10.5 Tf +[<7b6c6576656c7d206d61> 20.0195 <792062652069676e6f72652c207761726e696e672c206f72206572726f722e2054686973206f766572726964657320656e747269657320696e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6224 Tw + +BT +63.24 119.406 Td +/F1.0 10.5 Tf +<6f72672f6173706563746a2f7765617665722f586c696e7444656661756c742e70726f706572746965732066726f6d206173706563746a746f6f6c732e6a61722c2062757420646f6573206e6f74206f76657272696465206c6576656c7320736574> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 103.626 Td +/F1.0 10.5 Tf +<7573696e6720746865202d586c696e7466696c65206f7074696f6e2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 75.846 Td +/F2.0 10.5 Tf +<2d586c696e7466696c65203c50726f706572747946696c653e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.614 Tw + +BT +63.24 57.066 Td +/F1.0 10.5 Tf +<537065636966792070726f706572746965732066696c6520746f20736574206c6576656c7320666f722073706563696669632063726f737363757474696e67206d657373616765732e2050726f706572747946696c652069732061207061746820746f2061> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp1 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +541.009 14.263 Td +/F1.0 9 Tf +<35> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +46 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 45 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F2.0 22 0 R +/F1.0 8 0 R +/F3.0 26 0 R +/F1.1 47 0 R +>> +/XObject << /Stamp1 360 0 R +>> +>> +>> +endobj +47 0 obj +<< /Type /Font +/BaseFont /8fe72e+NotoSerif +/Subtype /TrueType +/FontDescriptor 375 0 R +/FirstChar 32 +/LastChar 255 +/Widths 377 0 R +/ToUnicode 376 0 R +>> +endobj +48 0 obj +<< /Length 8748 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +12.2508 Tw + +BT +63.24 794.676 Td +/F1.0 10.5 Tf +[<4a617661202e70726f706572746965732066696c6520746861742074616b> 20.0195 <6573207468652073616d652070726f7065727479206e616d657320616e642076616c756573206173>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 778.896 Td +/F1.0 10.5 Tf +<6f72672f6173706563746a2f7765617665722f586c696e7444656661756c742e70726f706572746965732066726f6d206173706563746a746f6f6c732e6a61722c20776869636820697420616c736f206f76657272696465732e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 751.116 Td +/F2.0 10.5 Tf +<2d68656c70> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 732.336 Td +/F1.0 10.5 Tf +<456d697420696e666f726d6174696f6e206f6e20636f6d70696c6572206f7074696f6e7320616e64207573616765> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 704.556 Td +/F2.0 10.5 Tf +<2d76657273696f6e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 685.776 Td +/F1.0 10.5 Tf +<456d6974207468652076657273696f6e206f6620746865204173706563744a20636f6d70696c6572> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 657.996 Td +/F2.0 10.5 Tf +<2d636c61737370617468203c506174683e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.8728 Tw + +BT +63.24 639.216 Td +/F1.0 10.5 Tf +<5370656369667920776865726520746f2066696e64207573657220636c6173732066696c65732e205061746820697320612073696e676c6520617267756d656e7420636f6e7461696e696e672061206c697374206f6620706174687320746f207a6970> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 623.436 Td +/F1.0 10.5 Tf +[<66696c6573206f72206469726563746f726965732c2064656c696d697465642062> 20.0195 <792074686520706c6174666f726d2d737065636966696320706174682064656c696d697465722e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 595.656 Td +/F2.0 10.5 Tf +<2d626f6f74636c61737370617468203c506174683e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.8507 Tw + +BT +63.24 576.876 Td +/F1.0 10.5 Tf +<4f76657272696465206c6f636174696f6e206f6620564dd57320626f6f74636c6173737061746820666f7220707572706f736573206f66206576616c756174696e67207479706573207768656e20636f6d70696c696e672e2050617468> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.9323 Tw + +BT +63.24 561.096 Td +/F1.0 10.5 Tf +[<697320612073696e676c6520617267756d656e7420636f6e7461696e696e672061206c697374206f6620706174687320746f207a69702066696c6573206f72206469726563746f726965732c2064656c696d697465642062> 20.0195 <7920746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 545.316 Td +/F1.0 10.5 Tf +<706c6174666f726d2d737065636966696320706174682064656c696d697465722e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 517.536 Td +/F2.0 10.5 Tf +<2d65787464697273203c506174683e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +4.9295 Tw + +BT +63.24 498.756 Td +/F1.0 10.5 Tf +<4f76657272696465206c6f636174696f6e206f6620564dd57320657874656e73696f6e206469726563746f7269657320666f7220707572706f736573206f66206576616c756174696e67207479706573207768656e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.4302 Tw + +BT +63.24 482.976 Td +/F1.0 10.5 Tf +[<636f6d70696c696e672e205061746820697320612073696e676c6520617267756d656e7420636f6e7461696e696e672061206c697374206f6620706174687320746f206469726563746f726965732c2064656c696d697465642062> 20.0195 <7920746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 467.196 Td +/F1.0 10.5 Tf +<706c6174666f726d2d737065636966696320706174682064656c696d697465722e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 439.416 Td +/F2.0 10.5 Tf +<2d64203c4469726563746f72793e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5357 Tw + +BT +63.24 420.636 Td +/F1.0 10.5 Tf +[<5370656369667920776865726520746f20706c6163652067656e6572> 20.0195 <61746564202e636c6173732066696c65732e204966206e6f74207370656369666965642c203c4469726563746f72793e2064656661756c747320746f207468652063757272656e74>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 404.856 Td +/F1.0 10.5 Tf +<776f726b696e67206469722e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 377.076 Td +/F2.0 10.5 Tf +<2d746172676574203c5b312e3120746f20312e355d3e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 358.296 Td +/F1.0 10.5 Tf +<5370656369667920636c61737366696c65207461726765742073657474696e672028312e3120746f20312e352c2064656661756c7420697320312e3229> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 330.516 Td +/F2.0 10.5 Tf +<2d312e33> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 311.736 Td +/F1.0 10.5 Tf +<53657420636f6d706c69616e6365206c6576656c20746f20312e33205468697320696d706c696573202d736f7572636520312e3320616e64202d74617267657420312e312e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 283.956 Td +/F2.0 10.5 Tf +<2d312e34> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 265.176 Td +/F1.0 10.5 Tf +<53657420636f6d706c69616e6365206c6576656c20746f20312e34202864656661756c7429205468697320696d706c696573202d736f7572636520312e3420616e64202d74617267657420312e322e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 237.396 Td +/F2.0 10.5 Tf +<2d312e35> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 218.616 Td +/F1.0 10.5 Tf +<53657420636f6d706c69616e6365206c6576656c20746f20312e352e205468697320696d706c696573202d736f7572636520312e3520616e64202d74617267657420312e352e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 190.836 Td +/F2.0 10.5 Tf +<2d736f75726365203c5b312e337c312e347c312e355d3e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0743 Tw + +BT +63.24 172.056 Td +/F1.0 10.5 Tf +[<54> 29.7852 <6f67676c6520617373657274696f6e732028312e332c20312e342c206f7220312e35202d2064656661756c7420697320312e34292e205768656e207573696e67202d736f7572636520312e332c20616e2061737365727428292073746174656d656e74>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.5245 Tw + +BT +63.24 156.276 Td +/F1.0 10.5 Tf +<76616c696420756e646572204a61766120312e342077696c6c20726573756c7420696e206120636f6d70696c6572206572726f722e205768656e207573696e67202d736f7572636520312e342c20747265617420> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.5245 Tw + +BT +490.5146 156.276 Td +/F3.0 10.5 Tf +<617373657274> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.5245 Tw + +BT +522.0146 156.276 Td +/F1.0 10.5 Tf +<2061732061> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.7804 Tw + +BT +63.24 140.496 Td +/F1.0 10.5 Tf +[<6b> 20.0195 <6579776f726420616e6420696d706c656d656e7420617373657274696f6e73206163636f7264696e6720746f2074686520312e34206c616e677561676520737065632e205768656e207573696e67202d736f7572636520312e352c>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 124.716 Td +/F1.0 10.5 Tf +<4a6176612035206c616e677561676520666561747572657320617265207065726d69747465642e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 96.936 Td +/F2.0 10.5 Tf +<2d6e6f7761726e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.7143 Tw + +BT +63.24 78.156 Td +/F1.0 10.5 Tf +[<456d6974206e6f207761726e696e677320286571756976616c656e7420746f20272d7761726e3a6e6f6e652729205468697320646f6573206e6f74207375707072657373206d657373616765732067656e6572> 20.0195 <617465642062> 20.0195 <79>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +63.24 62.376 Td +/F3.0 10.5 Tf +<6465636c617265207761726e696e67> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +141.99 62.376 Td +/F1.0 10.5 Tf +<206f7220> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +158.433 62.376 Td +/F3.0 10.5 Tf +<586c696e74> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +184.683 62.376 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp2 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +49.24 14.263 Td +/F1.0 9 Tf +<36> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +49 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 48 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F1.0 8 0 R +/F2.0 22 0 R +/F3.0 26 0 R +>> +/XObject << /Stamp2 361 0 R +>> +>> +>> +endobj +50 0 obj +<< /Length 9144 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +48.24 793.926 Td +/F2.0 10.5 Tf +<2d7761726e3a203c6974656d733e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.9037 Tw + +BT +63.24 775.146 Td +/F1.0 10.5 Tf +[<456d6974207761726e696e677320666f7220616e> 20.0195 <7920696e7374616e636573206f662074686520636f6d6d612d64656c696d69746564206c697374206f66207175657374696f6e61626c6520636f64652028656720272d>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 759.366 Td +/F1.0 10.5 Tf +[<7761726e3a756e757365644c6f63616c732c6465707265636174696f6e> 40.0391 <27293a202b>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 743.55 m +543.04 743.55 l +545.2491 743.55 547.04 741.7591 547.04 739.55 c +547.04 607.63 l +547.04 605.4209 545.2491 603.63 543.04 603.63 c +52.24 603.63 l +50.0309 603.63 48.24 605.4209 48.24 607.63 c +48.24 739.55 l +48.24 741.7591 50.0309 743.55 52.24 743.55 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 743.55 m +543.04 743.55 l +545.2491 743.55 547.04 741.7591 547.04 739.55 c +547.04 607.63 l +547.04 605.4209 545.2491 603.63 543.04 603.63 c +52.24 603.63 l +50.0309 603.63 48.24 605.4209 48.24 607.63 c +48.24 739.55 l +48.24 741.7591 50.0309 743.55 52.24 743.55 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 720.725 Td +/F3.0 11 Tf +<636f6e7374727563746f724e616d6520202020202020206d6574686f64207769746820636f6e7374727563746f72206e616d65> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 705.985 Td +/F3.0 11 Tf +<7061636b61676544656661756c744d6574686f64202020617474656d707420746f206f76657272696465207061636b6167652d64656661756c74206d6574686f64> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 691.245 Td +/F3.0 11 Tf +<6465707265636174696f6e2020202020202020202020207573616765206f6620646570726563617465642074797065206f72206d656d626572> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 676.505 Td +/F3.0 11 Tf +<6d61736b65644361746368426c6f636b7320202020202068696464656e20636174636820626c6f636b> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 661.765 Td +/F3.0 11 Tf +<756e757365644c6f63616c7320202020202020202020206c6f63616c207661726961626c65206e657665722072656164> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 647.025 Td +/F3.0 11 Tf +<756e75736564417267756d656e747320202020202020206d6574686f6420617267756d656e74206e657665722072656164> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 632.285 Td +/F3.0 11 Tf +<756e75736564496d706f72747320202020202020202020696d706f72742073746174656d656e74206e6f74207573656420627920636f646520696e2066696c65> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 617.545 Td +/F3.0 11 Tf +<6e6f6e6520202020202020202020202020202020202020737570707265737320616c6c20636f6d70696c6572207761726e696e6773> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 591.63 m +543.04 591.63 l +545.2491 591.63 547.04 589.8391 547.04 587.63 c +547.04 396.75 l +547.04 394.5409 545.2491 392.75 543.04 392.75 c +52.24 392.75 l +50.0309 392.75 48.24 394.5409 48.24 396.75 c +48.24 587.63 l +48.24 589.8391 50.0309 591.63 52.24 591.63 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 591.63 m +543.04 591.63 l +545.2491 591.63 547.04 589.8391 547.04 587.63 c +547.04 396.75 l +547.04 394.5409 545.2491 392.75 543.04 392.75 c +52.24 392.75 l +50.0309 392.75 48.24 394.5409 48.24 396.75 c +48.24 587.63 l +48.24 589.8391 50.0309 591.63 52.24 591.63 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 568.805 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 554.065 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 539.325 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 524.585 Td +/F3.0 11 Tf +<2d6465707265636174696f6e3a3a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 509.845 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 495.105 Td +/F3.0 11 Tf +<2d6e6f496d706f72744572726f723a3a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 480.365 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 465.625 Td +/F3.0 11 Tf +<2d70726f636565644f6e4572726f723a3a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 450.885 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 436.145 Td +/F3.0 11 Tf +<2d673c3a5b6c696e65732c766172732c736f757263655d3e3a3a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 421.405 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 406.665 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 380.75 m +543.04 380.75 l +545.2491 380.75 547.04 378.9591 547.04 376.75 c +547.04 303.79 l +547.04 301.5809 545.2491 299.79 543.04 299.79 c +52.24 299.79 l +50.0309 299.79 48.24 301.5809 48.24 303.79 c +48.24 376.75 l +48.24 378.9591 50.0309 380.75 52.24 380.75 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 380.75 m +543.04 380.75 l +545.2491 380.75 547.04 378.9591 547.04 376.75 c +547.04 303.79 l +547.04 301.5809 545.2491 299.79 543.04 299.79 c +52.24 299.79 l +50.0309 299.79 48.24 301.5809 48.24 303.79 c +48.24 376.75 l +48.24 378.9591 50.0309 380.75 52.24 380.75 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 357.925 Td +/F3.0 11 Tf +<2d67202020202020202020616c6c20646562756720696e666f2028272d673a6c696e65732c766172732c736f757263652729> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 343.185 Td +/F3.0 11 Tf +<2d673a6e6f6e65202020206e6f20646562756720696e666f> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 328.445 Td +/F3.0 11 Tf +<2d673a7b6974656d737d20646562756720696e666f20666f7220616e792f616c6c206f66205b6c696e65732c20766172732c20736f757263655d2c20652e672e2c> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 313.705 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 275.826 Td +/F2.0 10.5 Tf +<2d7072657365727665416c6c4c6f63616c73> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 257.046 Td +/F1.0 10.5 Tf +[<507265736572766520616c6c206c6f63616c207661726961626c657320647572696e6720636f64652067656e6572> 20.0195 <6174696f6e2028746f20666163696c697461746520646562756767696e67292e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 229.266 Td +/F2.0 10.5 Tf +<2d7265666572656e6365496e666f> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 210.486 Td +/F1.0 10.5 Tf +<436f6d70757465207265666572656e636520696e666f726d6174696f6e2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 182.706 Td +/F2.0 10.5 Tf +<2d656e636f64696e67203c666f726d61743e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4734 Tw + +BT +63.24 163.926 Td +/F1.0 10.5 Tf +[<537065636966792064656661756c7420736f7572636520656e636f64696e6720666f726d61742e205370656369667920637573746f6d20656e636f64696e67206f6e2061207065722066696c652062617369732062> 20.0195 <7920737566666978696e67>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 148.146 Td +/F1.0 10.5 Tf +<6561636820696e70757420736f757263652066696c652f666f6c646572206e616d65207769746820275b656e636f64696e675d272e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 120.366 Td +/F2.0 10.5 Tf +<2d766572626f7365> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 101.586 Td +/F1.0 10.5 Tf +<456d6974206d657373616765732061626f75742061636365737365642f70726f63657373656420636f6d70696c6174696f6e20756e697473> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 73.806 Td +/F2.0 10.5 Tf +[<2d73686f7757> 60.0586 <65617665496e666f>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 55.026 Td +/F1.0 10.5 Tf +<456d6974206d657373616765732061626f75742077656176696e67> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp1 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +541.009 14.263 Td +/F1.0 9 Tf +<37> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +51 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 50 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F2.0 22 0 R +/F1.0 8 0 R +/F3.0 26 0 R +>> +/XObject << /Stamp1 360 0 R +>> +>> +>> +endobj +52 0 obj +<< /Length 7195 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +48.24 793.926 Td +/F2.0 10.5 Tf +<2d6c6f67203c66696c653e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 775.146 Td +/F1.0 10.5 Tf +<537065636966792061206c6f672066696c6520666f7220636f6d70696c6572206d657373616765732e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 747.366 Td +/F2.0 10.5 Tf +<2d70726f6772657373> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 728.586 Td +/F1.0 10.5 Tf +<53686f772070726f677265737320287265717569726573202d6c6f67206d6f6465292e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 700.806 Td +/F2.0 10.5 Tf +<2d74696d65> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 682.026 Td +/F1.0 10.5 Tf +[<446973706c61> 20.0195 <7920737065656420696e666f726d6174696f6e2e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 654.246 Td +/F2.0 10.5 Tf +<2d6e6f45786974> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 635.466 Td +/F1.0 10.5 Tf +[<446f206e6f742063616c6c2053> 20.0195 <797374656d2e65786974286e2920617420656e64206f6620636f6d70696c6174696f6e20286e3d30206966206e6f206572726f7229>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 607.686 Td +/F2.0 10.5 Tf +<2d726570656174203c4e3e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 588.906 Td +/F1.0 10.5 Tf +<52657065617420636f6d70696c6174696f6e2070726f63657373204e2074696d657320287479706963616c6c7920746f20646f20706572666f726d616e636520616e616c79736973292e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 561.126 Td +/F2.0 10.5 Tf +<2d587465726d696e6174654166746572436f6d70696c6174696f6e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 542.346 Td +/F1.0 10.5 Tf +<43617573657320636f6d70696c657220746f207465726d696e617465206265666f72652077656176696e67> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 514.566 Td +/F2.0 10.5 Tf +[<2d5861646453657269616c56> 60.0586 <657273696f6e554944>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.3111 Tw + +BT +63.24 495.786 Td +/F1.0 10.5 Tf +[<4361757365732074686520636f6d70696c657220746f2063616c63756c61746520616e6420616464207468652053657269616c56> 60.0586 <657273696f6e554944206669656c6420746f20616e> 20.0195 <79207479706520696d706c656d656e74696e67>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.8302 Tw + +BT +63.24 480.006 Td +/F1.0 10.5 Tf +[<53657269616c697a61626c6520746861742069732061666665637465642062> 20.0195 <7920616e206173706563742e20546865206669656c642069732063616c63756c61746564206261736564206f6e2074686520636c617373206265666f7265>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 464.226 Td +/F1.0 10.5 Tf +[<77656176696e67206861732074616b> 20.0195 <656e20706c6163652e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 436.446 Td +/F2.0 10.5 Tf +<2d5872657765617661626c655b3a636f6d70726573735d> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2851 Tw + +BT +63.24 417.666 Td +/F1.0 10.5 Tf +<284578706572696d656e74616c202d2064657072656361746564206173206e6f772064656661756c74292052756e732077656176657220696e2072657765617661626c65206d6f64652077686963682063617573657320697420746f> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.1111 Tw + +BT +63.24 401.886 Td +/F1.0 10.5 Tf +<63726561746520776f76656e20636c617373657320746861742063616e206265207265776f76656e2c207375626a65637420746f20746865207265737472696374696f6e2074686174206f6e20617474656d7074696e672061> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 386.106 Td +/F1.0 10.5 Tf +<7265776561766520616c6c20746865207479706573207468617420616476697365642074686520776f76656e2074797065206d7573742062652061636365737369626c652e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 358.326 Td +/F2.0 10.5 Tf +<2d586e6f496e6c696e65> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 339.546 Td +/F1.0 10.5 Tf +<284578706572696d656e74616c2920646f206e6f7420696e6c696e652061726f756e6420616476696365> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 311.766 Td +/F2.0 10.5 Tf +<2d58696e6372656d656e74616c46696c65203c66696c653e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4607 Tw + +BT +63.24 292.986 Td +/F1.0 10.5 Tf +[<284578706572696d656e74616c29205468697320776f726b73206c696b> 20.0195 <6520696e6372656d656e74616c206d6f64652c20627574207573696e6720612066696c652072> 20.0195 <6174686572207468616e207374616e6461726420696e70757420746f>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.6186 Tw + +BT +63.24 277.206 Td +/F1.0 10.5 Tf +<636f6e74726f6c2074686520636f6d70696c65722e2049742077696c6c207265636f6d70696c6520656163682074696d652066696c65206973206368616e67656420616e6420616e642068616c74207768656e2066696c65206973> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 261.426 Td +/F1.0 10.5 Tf +<64656c657465642e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 233.646 Td +/F2.0 10.5 Tf +<2d5873657269616c697a61626c6541737065637473> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.8256 Tw + +BT +63.24 214.866 Td +/F1.0 10.5 Tf +<284578706572696d656e74616c29204e6f726d616c6c7920697420697320616e206572726f7220746f206465636c61726520617370656374732053657269616c697a61626c652e2054686973206f7074696f6e2072656d6f7665732074686174> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 199.086 Td +/F1.0 10.5 Tf +<7265737472696374696f6e2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 171.306 Td +/F2.0 10.5 Tf +<2d586e6f7452657765617661626c65> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 152.526 Td +/F1.0 10.5 Tf +[<284578706572696d656e74616c292043726561746520636c6173732066696c657320746861742063616ed5742062652073756273657175656e746c79207265776f76656e2062> 20.0195 <79204173706563744a2e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 124.746 Td +/F2.0 10.5 Tf +<2d58616a72756e74696d656c6576656c3a312e322c20616a72756e74696d656c6576656c3a312e35> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.0973 Tw + +BT +63.24 105.966 Td +/F1.0 10.5 Tf +[<284578706572696d656e74616c2920416c6c6f777320636f646520746f2062652067656e6572> 20.0195 <6174656420746861742074617267657473206120312e32206f72206120312e35206c6576656c204173706563744a2072756e74696d65>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 90.186 Td +/F1.0 10.5 Tf +<2864656661756c7420312e3529> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp2 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +49.24 14.263 Td +/F1.0 9 Tf +<38> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +53 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 52 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F2.0 22 0 R +/F1.0 8 0 R +>> +/XObject << /Stamp2 361 0 R +>> +>> +>> +endobj +54 0 obj +<< /Length 14081 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +48.24 792.006 Td +/F2.0 13 Tf +<312e352e322e2046696c65206e616d6573> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4704 Tw + +BT +48.24 765.446 Td +/F1.0 10.5 Tf +<616a63206163636570747320736f757263652066696c65732077697468206569746865722074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.4704 Tw + +BT +244.1029 765.446 Td +/F3.0 10.5 Tf +<2e6a617661> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4704 Tw + +BT +270.3529 765.446 Td +/F1.0 10.5 Tf +<20657874656e73696f6e206f722074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.4704 Tw + +BT +358.7755 765.446 Td +/F3.0 10.5 Tf +<2e616a> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4704 Tw + +BT +374.5255 765.446 Td +/F1.0 10.5 Tf +[<20657874656e73696f6e2e2057> 60.0586 <65206e6f726d616c6c792075736520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.4704 Tw + +BT +520.79 765.446 Td +/F3.0 10.5 Tf +<2e6a617661> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4704 Tw + +BT +547.04 765.446 Td +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.8954 Tw + +BT +48.24 749.666 Td +/F1.0 10.5 Tf +<666f7220616c6c206f66206f75722066696c657320696e20616e204173706563744a2073797374656d> Tj +/F1.1 10.5 Tf +<22> Tj +/F1.0 10.5 Tf + Tj +/F1.1 10.5 Tf +<22> Tj +/F1.0 10.5 Tf +<66696c6573207468617420636f6e7461696e20617370656374732061732077656c6c2061732066696c6573207468617420636f6e7461696e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.7198 Tw + +BT +48.24 733.886 Td +/F1.0 10.5 Tf +<636c61737365732e20486f77657665722c20696620796f7520686176652061206e65656420746f206d656368616e6963616c6c792064697374696e67756973682066696c6573207468617420757365204173706563744ad573206164646974696f6e616c> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 718.106 Td +/F1.0 10.5 Tf +<66756e6374696f6e616c6974792066726f6d2074686f73652074686174206172652070757265204a617661207765207265636f6d6d656e64207573696e672074686520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +394.0995 718.106 Td +/F3.0 10.5 Tf +<2e616a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +409.8495 718.106 Td +/F1.0 10.5 Tf +<20657874656e73696f6e20666f722074686f73652066696c65732e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5136 Tw + +BT +48.24 690.326 Td +/F1.0 10.5 Tf +[<57> 60.0586 <65d564206c696b> 20.0195 <6520746f20646973636f7572> 20.0195 <616765206f74686572206d65616e73206f66206d656368616e6963616c2064697374696e6374696f6e2073756368206173206e616d696e6720636f6e76656e74696f6e73206f72207375622d>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 674.546 Td +/F1.0 10.5 Tf +<7061636b6167657320696e206661766f72206f662074686520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +170.2605 674.546 Td +/F3.0 10.5 Tf +<2e616a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +186.0105 674.546 Td +/F1.0 10.5 Tf +<20657874656e73696f6e2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 646.766 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1451 Tw + +BT +66.24 646.766 Td +/F1.0 10.5 Tf +<46696c656e616d6520636f6e76656e74696f6e7320617265206861726420746f20656e666f72636520616e64206c65616420746f2061776b77617264206e616d657320666f7220796f757220617370656374732e20496e7374656164> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 630.986 Td +/F1.0 10.5 Tf +<6f6620> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +78.8925 630.986 Td +/F3.0 10.5 Tf +<54726163696e674173706563742e6a617661> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +173.3925 630.986 Td +/F1.0 10.5 Tf +<207765207265636f6d6d656e64207573696e6720> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +286.53 630.986 Td +/F3.0 10.5 Tf +<54726163696e672e616a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +339.03 630.986 Td +/F1.0 10.5 Tf +<20286f72206a75737420> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +380.0535 630.986 Td +/F3.0 10.5 Tf +<54726163696e672e6a617661> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +443.0535 630.986 Td +/F1.0 10.5 Tf +<2920696e73746561642e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 609.206 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.3709 Tw + +BT +66.24 609.206 Td +/F1.0 10.5 Tf +[<5375622d7061636b61676573206d6f76652061737065637473206f7574206f66207468656972206e61747572> 20.0195 <616c20706c61636520696e20612073797374656d20616e642063616e2063726561746520616e206172746966696369616c>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.7726 Tw + +BT +66.24 593.426 Td +/F1.0 10.5 Tf +[<6e65656420666f722070726976696c6567656420617370656374732e20496e7374656164206f6620616464696e672061207375622d7061636b616765206c696b> 20.0195 <6520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.7726 Tw + +BT +397.5543 593.426 Td +/F3.0 10.5 Tf +<61737065637473> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.7726 Tw + +BT +434.3043 593.426 Td +/F1.0 10.5 Tf +<207765207265636f6d6d656e64207573696e67> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 577.646 Td +/F1.0 10.5 Tf +<74686520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +84.93 577.646 Td +/F3.0 10.5 Tf +<2e616a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +100.68 577.646 Td +/F1.0 10.5 Tf +<20657874656e73696f6e20616e6420696e636c7564696e672074686573652066696c657320696e20796f7572206578697374696e67207061636b6167657320696e73746561642e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 543.146 Td +/F2.0 13 Tf +<312e352e332e20436f6d7061746962696c697479> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2551 Tw + +BT +48.24 516.586 Td +/F1.0 10.5 Tf +[<4173706563744a206973206120636f6d70617469626c6520657874656e73696f6e20746f20746865204a6176612070726f6772> 20.0195 <616d6d696e67206c616e67756167652e20546865204173706563744a20636f6d70696c65722061646865726573>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.1168 Tw + +BT +48.24 500.806 Td +/F1.0 10.5 Tf +<746f2074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +3.1168 Tw + +BT +85.6376 500.806 Td +/F1.0 10.5 Tf +<546865204a617661204c616e67756167652053706563696669636174696f6e2c205365636f6e642045646974696f6e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.1168 Tw + +BT +342.8477 500.806 Td +/F1.0 10.5 Tf +<20616e6420746f2074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +3.1168 Tw + +BT +411.028 500.806 Td +/F1.0 10.5 Tf +<546865204a617661205669727475616c204d616368696e65> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +1.4916 Tw + +BT +48.24 485.026 Td +/F1.0 10.5 Tf +<53706563696669636174696f6e2c205365636f6e642045646974696f6e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.4916 Tw + +BT +195.6822 485.026 Td +/F1.0 10.5 Tf +[<20616e642072756e73206f6e20616e> 20.0195 <79204a617661203220636f6d70617469626c6520706c6174666f726d2e2054686520636f64652069742067656e6572> 20.0195 <61746573>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2022 Tw + +BT +48.24 469.246 Td +/F1.0 10.5 Tf +[<72756e73206f6e20616e> 20.0195 <79204a61766120312e31206f72206c6174657220636f6d70617469626c6520706c6174666f726d2e2046> 40.0391 <6f72206d6f726520696e666f726d6174696f6e206f6e20636f6d7061746962696c6974792077697468204a617661>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 453.466 Td +/F1.0 10.5 Tf +<616e6420776974682070726576696f75732072656c6561736573206f66204173706563744a2c2073656520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +258.7545 453.466 Td +/F1.0 10.5 Tf +<3f3f3f> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +274.5045 453.466 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 418.966 Td +/F2.0 13 Tf +<312e352e342e204578616d706c6573> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 392.406 Td +/F1.0 10.5 Tf +<436f6d70696c652074776f2066696c65733a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 376.59 m +543.04 376.59 l +545.2491 376.59 547.04 374.7991 547.04 372.59 c +547.04 343.85 l +547.04 341.6409 545.2491 339.85 543.04 339.85 c +52.24 339.85 l +50.0309 339.85 48.24 341.6409 48.24 343.85 c +48.24 372.59 l +48.24 374.7991 50.0309 376.59 52.24 376.59 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 376.59 m +543.04 376.59 l +545.2491 376.59 547.04 374.7991 547.04 372.59 c +547.04 343.85 l +547.04 341.6409 545.2491 339.85 543.04 339.85 c +52.24 339.85 l +50.0309 339.85 48.24 341.6409 48.24 343.85 c +48.24 372.59 l +48.24 374.7991 50.0309 376.59 52.24 376.59 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 353.765 Td +/F3.0 11 Tf +<616a632048656c6c6f576f726c642e6a6176612054726163652e6a617661> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.3449 Tw + +BT +48.24 315.886 Td +/F1.0 10.5 Tf +[<54> 29.7852 <6f2061766f69642073706563696679696e672066696c65206e616d6573206f6e2074686520636f6d6d616e64206c696e652c206c69737420736f757263652066696c657320696e2061206c696e652d64656c696d6974656420746578742061726766696c652e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2531 Tw + +BT +48.24 300.106 Td +/F1.0 10.5 Tf +[<536f757263652066696c65207061746873206d61> 20.0195 <79206265206162736f6c757465206f722072656c617469766520746f207468652061726766696c652c20616e64206d61> 20.0195 <7920696e636c756465206f746865722061726766696c65732062> 20.0195 <7920402d>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 284.326 Td +/F1.0 10.5 Tf +<7265666572656e63652e2054686520666f6c6c6f77696e672066696c6520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +192.027 284.326 Td +/F3.0 10.5 Tf +<736f75726365732e6c7374> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +249.777 284.326 Td +/F1.0 10.5 Tf +<20636f6e7461696e73206162736f6c75746520616e642072656c61746976652066696c657320616e6420402d7265666572656e6365733a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 268.51 m +543.04 268.51 l +545.2491 268.51 547.04 266.7191 547.04 264.51 c +547.04 147.33 l +547.04 145.1209 545.2491 143.33 543.04 143.33 c +52.24 143.33 l +50.0309 143.33 48.24 145.1209 48.24 147.33 c +48.24 264.51 l +48.24 266.7191 50.0309 268.51 52.24 268.51 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 268.51 m +543.04 268.51 l +545.2491 268.51 547.04 266.7191 547.04 264.51 c +547.04 147.33 l +547.04 145.1209 545.2491 143.33 543.04 143.33 c +52.24 143.33 l +50.0309 143.33 48.24 145.1209 48.24 147.33 c +48.24 264.51 l +48.24 266.7191 50.0309 268.51 52.24 268.51 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 245.685 Td +/F3.0 11 Tf +<4775692e6a617661> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 230.945 Td +/F3.0 11 Tf +<2f686f6d652f757365722f7372632f4c6962726172792e6a617661> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 216.205 Td +/F3.0 11 Tf +<646174612f5265706f7369746f72792e6a617661> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 201.465 Td +/F3.0 11 Tf +<646174612f4163636573732e6a617661> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 186.725 Td +/F3.0 11 Tf +<402e2e2f2e2e2f636f6d6d6f6e2f636f6d6d6f6e2e6c7374> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 171.985 Td +/F3.0 11 Tf +<402f686f6d652f757365722f7372632f6c69622e6c7374> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 157.245 Td +/F3.0 11 Tf +<766965772f626f64792f4172726179566965772e6a617661> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 119.366 Td +/F1.0 10.5 Tf +<436f6d70696c65207468652066696c6573207573696e672065697468657220746865202d61726766696c65206f72204020666f726d3a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 103.55 m +543.04 103.55 l +545.2491 103.55 547.04 101.7591 547.04 99.55 c +547.04 56.07 l +547.04 53.8609 545.2491 52.07 543.04 52.07 c +52.24 52.07 l +50.0309 52.07 48.24 53.8609 48.24 56.07 c +48.24 99.55 l +48.24 101.7591 50.0309 103.55 52.24 103.55 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 103.55 m +543.04 103.55 l +545.2491 103.55 547.04 101.7591 547.04 99.55 c +547.04 56.07 l +547.04 53.8609 545.2491 52.07 543.04 52.07 c +52.24 52.07 l +50.0309 52.07 48.24 53.8609 48.24 56.07 c +48.24 99.55 l +48.24 101.7591 50.0309 103.55 52.24 103.55 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 80.725 Td +/F3.0 11 Tf +<616a63202d61726766696c6520736f75726365732e6c7374> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 65.985 Td +/F3.0 11 Tf +<616a632040736f75726365732e6c7374> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp1 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +541.009 14.263 Td +/F1.0 9 Tf +<39> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +55 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 54 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F2.0 22 0 R +/F1.0 8 0 R +/F3.0 26 0 R +/F1.1 47 0 R +>> +/XObject << /Stamp1 360 0 R +>> +>> +/Annots [58 0 R 59 0 R 60 0 R 61 0 R] +>> +endobj +56 0 obj +[55 0 R /XYZ 0 841.89 null] +endobj +57 0 obj +[55 0 R /XYZ 0 561.83 null] +endobj +58 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (http://java.sun.com/docs/books/jls/index.html) +>> +/Subtype /Link +/Rect [85.6376 497.74 342.8477 512.02] +/Type /Annot +>> +endobj +59 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (http://java.sun.com/docs/books/vmspec/index.html) +>> +/Subtype /Link +/Rect [411.028 497.74 547.04 512.02] +/Type /Annot +>> +endobj +60 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (http://java.sun.com/docs/books/vmspec/index.html) +>> +/Subtype /Link +/Rect [48.24 481.96 195.6822 496.24] +/Type /Annot +>> +endobj +61 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#versionCompatibility) +>> +/Subtype /Link +/Rect [258.7545 450.4 274.5045 464.68] +/Type /Annot +>> +endobj +62 0 obj +[55 0 R /XYZ 0 437.65 null] +endobj +63 0 obj +<< /Length 10104 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +0.9962 Tw + +BT +48.24 793.926 Td +/F1.0 10.5 Tf +[<41726766696c65732061726520616c736f20737570706f727465642062> 20.0195 <79206a696b> 20.0195 <657320616e64206a617661632c20736f20796f752063616e20757365207468652066696c657320696e2068> 20.0195 <7962726964206275696c64732e20486f77657665722c>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 778.146 Td +/F1.0 10.5 Tf +<74686520737570706f7274207661726965733a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 750.366 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 750.366 Td +/F1.0 10.5 Tf +<4f6e6c7920616a63206163636570747320636f6d6d616e642d6c696e65206f7074696f6e73> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 728.586 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 728.586 Td +/F1.0 10.5 Tf +[<4a696b> 20.0195 <657320616e64204a6176616320646f206e6f742061636365707420696e7465726e616c204061726766696c65207265666572656e6365732e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 706.806 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 706.806 Td +/F1.0 10.5 Tf +[<4a696b> 20.0195 <657320616e64204a61766163206f6e6c792061636365707420746865204066696c6520666f726d206f6e2074686520636f6d6d616e64206c696e652e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.9478 Tw + +BT +48.24 679.026 Td +/F1.0 10.5 Tf +[<42> 20.0195 <797465636f64652077656176696e67207573696e67202d696e706174683a204173706563744a20312e3220737570706f7274732077656176696e67202e636c6173732066696c657320696e20696e707574207a69702f6a61722066696c657320616e64>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.4076 Tw + +BT +48.24 663.246 Td +/F1.0 10.5 Tf +[<6469726563746f726965732e205573696e6720696e707574206a617273206973206c696b> 20.0195 <6520636f6d70696c696e672074686520636f72726573706f6e64696e6720736f757263652066696c65732c20616e6420616c6c2062696e617269657320617265>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4484 Tw + +BT +48.24 647.466 Td +/F1.0 10.5 Tf +[<656d697474656420746f206f75747075742e20416c74686f756768204a6176612d636f6d706c69616e7420636f6d70696c657273206d61> 20.0195 <792064696666657220696e207468656972206f75747075742c20616a632073686f756c642074616b> 20.0195 <65206173>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1554 Tw + +BT +48.24 631.686 Td +/F1.0 10.5 Tf +[<696e70757420616e> 20.0195 <7920636c6173732066696c65732070726f64756365642062> 20.0195 <79206a617661632c206a696b> 20.0195 <65732c2065636c697073652c20616e642c206f6620636f757273652c20616a632e204173706563747320696e636c7564656420696e202d696e70617468>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 615.906 Td +/F1.0 10.5 Tf +[<77696c6c20626520776f76656e20696e746f206c696b> 20.0195 <65206f74686572202e636c6173732066696c65732c20616e6420746865792077696c6c20616666656374206f7468657220747970657320617320757375616c2e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +5.6015 Tw + +BT +48.24 588.126 Td +/F1.0 10.5 Tf +[<417370656374206c696272> 20.0195 <6172696573207573696e67202d617370656374706174683a204173706563744a20312e3120737570706f7274732077656176696e672066726f6d20726561642d6f6e6c79206c696272> 20.0195 <6172696573>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.8623 Tw + +BT +48.24 572.346 Td +/F1.0 10.5 Tf +[<636f6e7461696e696e6720617370656374732e204c696b> 20.0195 <6520696e707574206a6172732c20746865792061666665637420616c6c20696e7075743b20756e6c696b> 20.0195 <6520696e707574206a6172732c2074686579207468656d73656c76657320617265206e6f74>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.3326 Tw + +BT +48.24 556.566 Td +/F1.0 10.5 Tf +[<6166666563746564206f7220656d6974746564206173206f75747075742e20536f757263657320636f6d70696c6564207769746820617370656374206c696272> 20.0195 <6172696573206d7573742062652072756e2077697468207468652073616d65>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 540.786 Td +/F1.0 10.5 Tf +[<617370656374206c696272> 20.0195 <6172696573206f6e20746865697220636c617373706174682e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.8502 Tw + +BT +48.24 513.006 Td +/F1.0 10.5 Tf +[<54686520666f6c6c6f77696e67206578616d706c65206275696c647320746865207472> 20.0195 <6163696e67206578616d706c6520696e206120636f6d6d616e642d6c696e6520656e7669726f6e6d656e743b20697420637265617465732061>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.659 Tw + +BT +48.24 497.226 Td +/F1.0 10.5 Tf +[<726561642d6f6e6c7920617370656374206c696272> 20.0195 <617279> 89.8438 <2c20636f6d70696c657320736f6d6520636c617373657320666f722075736520617320696e7075742062> 20.0195 <797465636f64652c20616e6420636f6d70696c65732074686520636c6173736573>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 481.446 Td +/F1.0 10.5 Tf +[<616e64206f7468657220736f757263657320776974682074686520617370656374206c696272> 20.0195 <617279> 89.8438 <2e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.7867 Tw + +BT +48.24 453.666 Td +/F1.0 10.5 Tf +[<546865207472> 20.0195 <6163696e67206578616d706c6520697320696e20746865204173706563744a20646973747269627574696f6e20287b6173706563746a7d2f646f632f6578616d706c65732f7472> 20.0195 <6163696e67292e2054686973207573657320746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 437.886 Td +/F1.0 10.5 Tf +<666f6c6c6f77696e672066696c65733a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 422.07 m +543.04 422.07 l +545.2491 422.07 547.04 420.2791 547.04 418.07 c +547.04 109.27 l +547.04 107.0609 545.2491 105.27 543.04 105.27 c +52.24 105.27 l +50.0309 105.27 48.24 107.0609 48.24 109.27 c +48.24 418.07 l +48.24 420.2791 50.0309 422.07 52.24 422.07 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 422.07 m +543.04 422.07 l +545.2491 422.07 547.04 420.2791 547.04 418.07 c +547.04 109.27 l +547.04 107.0609 545.2491 105.27 543.04 105.27 c +52.24 105.27 l +50.0309 105.27 48.24 107.0609 48.24 109.27 c +48.24 418.07 l +48.24 420.2791 50.0309 422.07 52.24 422.07 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 399.245 Td +/F3.0 11 Tf +<6173706563746a312e312f> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 384.505 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 369.765 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 355.025 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 340.285 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 325.545 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 310.805 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 296.065 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 281.325 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 266.585 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 251.845 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 237.105 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 222.365 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 207.625 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 192.885 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 178.145 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 163.405 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 148.665 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 133.925 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 119.185 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.8398 Tw + +BT +48.24 81.306 Td +/F1.0 10.5 Tf +[<42656c6f77> 69.8242 <2c207468652070617468207365706172> 20.0195 <61746f722069732074616b> 20.0195 <656e20617320223b222c206275742066696c65207365706172> 20.0195 <61746f72732061726520222f222e20416c6c20636f6d6d616e647320617265206f6e206f6e65206c696e652e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 65.526 Td +/F1.0 10.5 Tf +[<41> 20.0195 <646a75737420706174687320616e6420636f6d6d616e647320746f20796f757220656e7669726f6e6d656e74206173206e65656465642e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp2 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +49.24 14.263 Td +/F1.0 9 Tf +<3130> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +64 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 63 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F1.0 8 0 R +/F3.0 26 0 R +>> +/XObject << /Stamp2 361 0 R +>> +>> +>> +endobj +65 0 obj +<< /Length 9593 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +48.24 794.676 Td +/F1.0 10.5 Tf +<53657475702074686520706174682c20636c617373706174682c20616e642063757272656e74206469726563746f72793a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 778.86 m +543.04 778.86 l +545.2491 778.86 547.04 777.0691 547.04 774.86 c +547.04 701.9 l +547.04 699.6909 545.2491 697.9 543.04 697.9 c +52.24 697.9 l +50.0309 697.9 48.24 699.6909 48.24 701.9 c +48.24 774.86 l +48.24 777.0691 50.0309 778.86 52.24 778.86 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 778.86 m +543.04 778.86 l +545.2491 778.86 547.04 777.0691 547.04 774.86 c +547.04 701.9 l +547.04 699.6909 545.2491 697.9 543.04 697.9 c +52.24 697.9 l +50.0309 697.9 48.24 699.6909 48.24 701.9 c +48.24 774.86 l +48.24 777.0691 50.0309 778.86 52.24 778.86 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 756.035 Td +/F3.0 11 Tf +<6364206578616d706c6573> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 741.295 Td +/F3.0 11 Tf +<6578706f727420616a72743d2e2e2f6c69622f6173706563746a72742e6a6172> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 726.555 Td +/F3.0 11 Tf +<6578706f727420434c415353504154483d2224616a727422> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 711.815 Td +/F3.0 11 Tf +<6578706f727420504154483d222e2e2f62696e3a245041544822> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 673.936 Td +/F1.0 10.5 Tf +[<4275696c64206120726561642d6f6e6c79207472> 20.0195 <6163696e67206c696272> 20.0195 <6172793a>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 658.12 m +543.04 658.12 l +545.2491 658.12 547.04 656.3291 547.04 654.12 c +547.04 625.38 l +547.04 623.1709 545.2491 621.38 543.04 621.38 c +52.24 621.38 l +50.0309 621.38 48.24 623.1709 48.24 625.38 c +48.24 654.12 l +48.24 656.3291 50.0309 658.12 52.24 658.12 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 658.12 m +543.04 658.12 l +545.2491 658.12 547.04 656.3291 547.04 654.12 c +547.04 625.38 l +547.04 623.1709 545.2491 621.38 543.04 621.38 c +52.24 621.38 l +50.0309 621.38 48.24 623.1709 48.24 625.38 c +48.24 654.12 l +48.24 656.3291 50.0309 658.12 52.24 658.12 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 635.295 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 597.416 Td +/F1.0 10.5 Tf +[<4275696c6420746865206170706c69636174696f6e2077697468207472> 20.0195 <6163696e6720696e206f6e6520737465703a>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 581.6 m +543.04 581.6 l +545.2491 581.6 547.04 579.8091 547.04 577.6 c +547.04 548.86 l +547.04 546.6509 545.2491 544.86 543.04 544.86 c +52.24 544.86 l +50.0309 544.86 48.24 546.6509 48.24 548.86 c +48.24 577.6 l +48.24 579.8091 50.0309 581.6 52.24 581.6 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 581.6 m +543.04 581.6 l +545.2491 581.6 547.04 579.8091 547.04 577.6 c +547.04 548.86 l +547.04 546.6509 545.2491 544.86 543.04 544.86 c +52.24 544.86 l +50.0309 544.86 48.24 546.6509 48.24 548.86 c +48.24 577.6 l +48.24 579.8091 50.0309 581.6 52.24 581.6 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 558.775 Td +/F3.0 11 Tf +<616a63202d617370656374706174682074726163656c69622e6a6172202d61726766696c652074726163696e672f6e6f74726163652e6c7374202d6f75746a6172207472616365646170702e6a6172> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 520.896 Td +/F1.0 10.5 Tf +[<52756e20746865206170706c69636174696f6e2077697468207472> 20.0195 <6163696e673a>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 505.08 m +543.04 505.08 l +545.2491 505.08 547.04 503.2891 547.04 501.08 c +547.04 472.34 l +547.04 470.1309 545.2491 468.34 543.04 468.34 c +52.24 468.34 l +50.0309 468.34 48.24 470.1309 48.24 472.34 c +48.24 501.08 l +48.24 503.2891 50.0309 505.08 52.24 505.08 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 505.08 m +543.04 505.08 l +545.2491 505.08 547.04 503.2891 547.04 501.08 c +547.04 472.34 l +547.04 470.1309 545.2491 468.34 543.04 468.34 c +52.24 468.34 l +50.0309 468.34 48.24 470.1309 48.24 472.34 c +48.24 501.08 l +48.24 503.2891 50.0309 505.08 52.24 505.08 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 482.255 Td +/F3.0 11 Tf +<6a617661202d636c61737370617468202224616a72743b7472616365646170702e6a61723b74726163656c69622e6a6172222074726163696e672e4578616d706c654d61696e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 444.376 Td +/F1.0 10.5 Tf +[<4275696c6420746865206170706c69636174696f6e2077697468207472> 20.0195 <6163696e672066726f6d2062696e617269657320696e2074776f2073746570733a>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 416.596 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 416.596 Td +/F1.0 10.5 Tf +[<286129204275696c6420746865206170706c69636174696f6e20636c617373657320287573696e67206a6176616320666f722064656d6f6e737472> 20.0195 <6174696f6ed5732073616b> 20.0195 <65293a>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +70.24 400.78 m +543.04 400.78 l +545.2491 400.78 547.04 398.9891 547.04 396.78 c +547.04 338.56 l +547.04 336.3509 545.2491 334.56 543.04 334.56 c +70.24 334.56 l +68.0309 334.56 66.24 336.3509 66.24 338.56 c +66.24 396.78 l +66.24 398.9891 68.0309 400.78 70.24 400.78 c +h +f +0.8 0.8 0.8 SCN +0.75 w +70.24 400.78 m +543.04 400.78 l +545.2491 400.78 547.04 398.9891 547.04 396.78 c +547.04 338.56 l +547.04 336.3509 545.2491 334.56 543.04 334.56 c +70.24 334.56 l +68.0309 334.56 66.24 336.3509 66.24 338.56 c +66.24 396.78 l +66.24 398.9891 68.0309 400.78 70.24 400.78 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +77.24 377.955 Td +/F3.0 11 Tf +<6d6b64697220636c6173736573> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +77.24 363.215 Td +/F3.0 11 Tf +<6a61766163202d6420636c61737365732074726163696e672f2a2e6a617661> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +77.24 348.475 Td +/F3.0 11 Tf +<6a61722063664d206170702e6a6172202d4320636c6173736573202e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 310.596 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 310.596 Td +/F1.0 10.5 Tf +[<286229204275696c6420746865206170706c69636174696f6e2077697468207472> 20.0195 <6163696e673a>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +70.24 294.78 m +543.04 294.78 l +545.2491 294.78 547.04 292.9891 547.04 290.78 c +547.04 262.04 l +547.04 259.8309 545.2491 258.04 543.04 258.04 c +70.24 258.04 l +68.0309 258.04 66.24 259.8309 66.24 262.04 c +66.24 290.78 l +66.24 292.9891 68.0309 294.78 70.24 294.78 c +h +f +0.8 0.8 0.8 SCN +0.75 w +70.24 294.78 m +543.04 294.78 l +545.2491 294.78 547.04 292.9891 547.04 290.78 c +547.04 262.04 l +547.04 259.8309 545.2491 258.04 543.04 258.04 c +70.24 258.04 l +68.0309 258.04 66.24 259.8309 66.24 262.04 c +66.24 290.78 l +66.24 292.9891 68.0309 294.78 70.24 294.78 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +77.24 271.955 Td +/F3.0 11 Tf +<616a63202d696e70617468206170702e6a6172202d617370656374706174682074726163656c69622e6a6172202d6f75746a6172207472616365646170702e6a6172> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 228.076 Td +/F1.0 10.5 Tf +[<52756e20746865206170706c69636174696f6e2077697468207472> 20.0195 <6163696e67202873616d652061732061626f7665293a>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 212.26 m +543.04 212.26 l +545.2491 212.26 547.04 210.4691 547.04 208.26 c +547.04 179.52 l +547.04 177.3109 545.2491 175.52 543.04 175.52 c +52.24 175.52 l +50.0309 175.52 48.24 177.3109 48.24 179.52 c +48.24 208.26 l +48.24 210.4691 50.0309 212.26 52.24 212.26 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 212.26 m +543.04 212.26 l +545.2491 212.26 547.04 210.4691 547.04 208.26 c +547.04 179.52 l +547.04 177.3109 545.2491 175.52 543.04 175.52 c +52.24 175.52 l +50.0309 175.52 48.24 177.3109 48.24 179.52 c +48.24 208.26 l +48.24 210.4691 50.0309 212.26 52.24 212.26 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 189.435 Td +/F3.0 11 Tf +<6a617661202d636c61737370617468202224616a72743b7472616365646170702e6a61723b74726163656c69622e6a6172222074726163696e672e4578616d706c654d61696e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 151.556 Td +/F1.0 10.5 Tf +[<52756e20746865206170706c69636174696f6e20776974686f7574207472> 20.0195 <6163696e673a>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 135.74 m +543.04 135.74 l +545.2491 135.74 547.04 133.9491 547.04 131.74 c +547.04 103.0 l +547.04 100.7909 545.2491 99.0 543.04 99.0 c +52.24 99.0 l +50.0309 99.0 48.24 100.7909 48.24 103.0 c +48.24 131.74 l +48.24 133.9491 50.0309 135.74 52.24 135.74 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 135.74 m +543.04 135.74 l +545.2491 135.74 547.04 133.9491 547.04 131.74 c +547.04 103.0 l +547.04 100.7909 545.2491 99.0 543.04 99.0 c +52.24 99.0 l +50.0309 99.0 48.24 100.7909 48.24 103.0 c +48.24 131.74 l +48.24 133.9491 50.0309 135.74 52.24 135.74 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 112.915 Td +/F3.0 11 Tf +<6a617661202d636c6173737061746820226170702e6a6172222074726163696e672e4578616d706c654d61696e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp1 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.978 14.263 Td +/F1.0 9 Tf +<3131> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +66 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 65 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F1.0 8 0 R +/F3.0 26 0 R +>> +/XObject << /Stamp1 360 0 R +>> +>> +>> +endobj +67 0 obj +<< /Length 12300 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +48.24 792.006 Td +/F2.0 13 Tf +<312e352e352e20546865204173706563744a20636f6d70696c657220415049> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4137 Tw + +BT +48.24 765.446 Td +/F1.0 10.5 Tf +<546865204173706563744a20636f6d70696c657220697320696d706c656d656e74656420636f6d706c6574656c7920696e204a61766120616e642063616e2062652063616c6c65642061732061204a61766120636c6173732e20546865206f6e6c79> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.4192 Tw + +BT +48.24 749.666 Td +/F1.0 10.5 Tf +<696e7465726661636520746861742073686f756c6420626520636f6e73696465726564207075626c69632061726520746865207075626c6963206d6574686f647320696e20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.4192 Tw + +BT +407.915 749.666 Td +/F3.0 10.5 Tf +<6f72672e6173706563746a2e746f6f6c732e616a632e4d61696e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.4192 Tw + +BT +544.415 749.666 Td +/F1.0 10.5 Tf +<2e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.9178 Tw + +BT +48.24 733.886 Td +/F1.0 10.5 Tf +<452e672e2c20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.9178 Tw + +BT +71.9428 733.886 Td +/F3.0 10.5 Tf +<6d61696e28537472696e675b5d206172677329> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.9178 Tw + +BT +172.6107 733.886 Td +/F1.0 10.5 Tf +[<2074616b> 20.0195 <65732074686520746865207374616e6461726420>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.9178 Tw + +BT +293.4346 733.886 Td +/F3.0 10.5 Tf +<616a63> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.9178 Tw + +BT +309.1846 733.886 Td +/F1.0 10.5 Tf +<20636f6d6d616e64206c696e6520617267756d656e74732e2054686973206d65616e73207468617420616e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 718.106 Td +/F1.0 10.5 Tf +[<616c7465726e6174697665207761> 20.0195 <7920746f2072756e2074686520636f6d70696c6572206973>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 690.326 Td +/F1.0 10.5 Tf +<6a617661206f72672e6173706563746a2e746f6f6c732e616a632e4d61696e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 662.546 Td +/F1.0 10.5 Tf +<6f7074696f6ec9> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 634.766 Td +/F1.0 10.5 Tf +<66696c65c9> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6818 Tw + +BT +48.24 606.986 Td +/F1.0 10.5 Tf +[<54> 29.7852 <6f2061636365737320636f6d70696c6572206d657373616765732070726f6772> 20.0195 <616d6d61746963616c6c79> 89.8438 <2c2075736520746865206d6574686f647320>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.6818 Tw + +BT +378.3582 606.986 Td +/F3.0 10.5 Tf +<736574486f6c64657228494d657373616765486f6c64657220686f6c64657229> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6818 Tw + +BT +547.04 606.986 Td +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6465 Tw + +BT +48.24 591.206 Td +/F1.0 10.5 Tf +<616e642f6f7220> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.6465 Tw + +BT +85.744 591.206 Td +/F3.0 10.5 Tf +<72756e28537472696e675b5d20617267732c20494d657373616765486f6c64657220686f6c64657229> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6465 Tw + +BT +305.9337 591.206 Td +/F1.0 10.5 Tf +<2e20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.6465 Tw + +BT +312.9247 591.206 Td +/F3.0 10.5 Tf +<616a63> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6465 Tw + +BT +328.6747 591.206 Td +/F1.0 10.5 Tf +<207265706f7274732065616368206d65737361676520746f2074686520686f6c646572207573696e67> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.7857 Tw + +BT +48.24 575.426 Td +/F3.0 10.5 Tf +<494d657373616765486f6c6465722e68616e646c654d657373616765282e2e29> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.7857 Tw + +BT +216.24 575.426 Td +/F1.0 10.5 Tf +<2e20496620796f75206a7573742077616e7420746f20636f6c6c65637420746865206d657373616765732c2075736520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.7857 Tw + +BT +458.3983 575.426 Td +/F3.0 10.5 Tf +<4d65737361676548616e646c6572> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.7857 Tw + +BT +531.8983 575.426 Td +/F1.0 10.5 Tf +<206173> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.3457 Tw + +BT +48.24 559.646 Td +/F1.0 10.5 Tf +<796f757220> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +2.3457 Tw + +BT +76.8882 559.646 Td +/F3.0 10.5 Tf +<494d657373616765486f6c646572> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.3457 Tw + +BT +150.3882 559.646 Td +/F1.0 10.5 Tf +[<2e2046> 40.0391 <6f72206578616d706c652c20636f6d70696c6520616e642072756e2074686520666f6c6c6f77696e67207769746820>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +2.3457 Tw + +BT +424.1081 559.646 Td +/F3.0 10.5 Tf +<6173706563746a746f6f6c732e6a6172> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.3457 Tw + +BT +508.1081 559.646 Td +/F1.0 10.5 Tf +<206f6e20746865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 543.866 Td +/F1.0 10.5 Tf +<636c617373706174683a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 528.05 m +543.04 528.05 l +545.2491 528.05 547.04 526.2591 547.04 524.05 c +547.04 318.43 l +547.04 316.2209 545.2491 314.43 543.04 314.43 c +52.24 314.43 l +50.0309 314.43 48.24 316.2209 48.24 318.43 c +48.24 524.05 l +48.24 526.2591 50.0309 528.05 52.24 528.05 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 528.05 m +543.04 528.05 l +545.2491 528.05 547.04 526.2591 547.04 524.05 c +547.04 318.43 l +547.04 316.2209 545.2491 314.43 543.04 314.43 c +52.24 314.43 l +50.0309 314.43 48.24 316.2209 48.24 318.43 c +48.24 524.05 l +48.24 526.2591 50.0309 528.05 52.24 528.05 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 505.225 Td +/F3.0 11 Tf +<696d706f7274206f72672e6173706563746a2e6272696467652e2a3b> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 490.485 Td +/F3.0 11 Tf +<696d706f7274206f72672e6173706563746a2e746f6f6c732e616a632e4d61696e3b> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 475.745 Td +/F3.0 11 Tf +<696d706f7274206a6176612e7574696c2e4172726179733b> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 446.265 Td +/F3.0 11 Tf +<7075626c696320636c6173732057726170416a63207b> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 431.525 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 416.785 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 402.045 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 387.305 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 372.565 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 357.825 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 343.085 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 328.345 Td +/F3.0 11 Tf +<7d> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 283.746 Td +/F2.0 13 Tf +[<312e352e362e20537461636b205472> 20.0195 <6163657320616e642074686520536f7572636546696c6520617474726962757465>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.0742 Tw + +BT +48.24 257.186 Td +/F1.0 10.5 Tf +[<556e6c696b> 20.0195 <65207472> 20.0195 <61646974696f6e616c206a61766120636f6d70696c6572732c20746865204173706563744a20636f6d70696c6572206d61> 20.0195 <7920696e206365727461696e2063617365732067656e6572> 20.0195 <61746520636c61737366696c65732066726f6d>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.5844 Tw + +BT +48.24 241.406 Td +/F1.0 10.5 Tf +[<6d756c7469706c6520736f757263652066696c65732e20556e666f7274756e6174656c79> 89.8438 <2c20746865206f726967696e616c204a61766120636c6173732066696c6520666f726d617420646f6573206e6f7420737570706f7274206d756c7469706c65>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.9701 Tw + +BT +48.24 225.626 Td +/F1.0 10.5 Tf +[<536f7572636546696c6520617474726962757465732e20496e206f7264657220746f206d616b> 20.0195 <65207375726520616c6c20736f757263652066696c6520696e666f726d6174696f6e20697320617661696c61626c652c20746865204173706563744a>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.8638 Tw + +BT +48.24 209.846 Td +/F1.0 10.5 Tf +[<636f6d70696c6572206d61> 20.0195 <7920696e20736f6d6520636173657320656e636f6465206d756c7469706c652066696c656e616d657320696e2074686520536f7572636546696c65206174747269627574652e205768656e20746865204a617661>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 194.066 Td +/F1.0 10.5 Tf +[<564d2067656e6572> 20.0195 <6174657320737461636b207472> 20.0195 <616365732c206974207573657320746869732061747472696275746520746f20737065636966792074686520736f757263652066696c652e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6793 Tw + +BT +48.24 166.286 Td +/F1.0 10.5 Tf +<28546865204173706563744a20312e3020636f6d70696c657220616c736f20737570706f72747320746865202e636c6173732066696c6520657874656e73696f6e73206f66204a53522d34352e205468657365207065726d697420636f6d706c69616e74> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.515 Tw + +BT +48.24 150.506 Td +/F1.0 10.5 Tf +[<646562756767657273202873756368206173206a646220696e204a61766120312e342e312920746f206964656e74696679207468652072696768742066696c6520616e64206c696e65206576656e20676976656e206d616e> 20.0195 <7920736f757263652066696c6573>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.382 Tw + +BT +48.24 134.726 Td +/F1.0 10.5 Tf +[<666f7220612073696e676c6520636c6173732e204a53522d343520737570706f727420697320706c616e6e656420666f7220616a6320696e204173706563744a20312e312c20627574206973206e6f7420696e2074686520696e697469616c2072656c656173652e2054> 29.7852 <6f>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 118.946 Td +/F1.0 10.5 Tf +<6765742066756c6c792064656275676761626c65202e636c6173732066696c65732c2075736520746865202d586e6f496e6c696e65206f7074696f6e2e29> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6892 Tw + +BT +48.24 91.166 Td +/F1.0 10.5 Tf +[<50726f6261626c7920746865206f6e6c792074696d6520796f75206d61> 20.0195 <7920736565207468697320666f726d6174206973207768656e20796f75207669657720737461636b207472> 20.0195 <616365732c20776865726520796f75206d61> 20.0195 <79>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 75.386 Td +/F1.0 10.5 Tf +[<656e636f756e746572207472> 20.0195 <61636573206f662074686520666f726d6174>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp2 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +49.24 14.263 Td +/F1.0 9 Tf +<3132> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +68 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 67 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F2.0 22 0 R +/F1.0 8 0 R +/F3.0 26 0 R +>> +/XObject << /Stamp2 361 0 R +>> +>> +>> +endobj +69 0 obj +[68 0 R /XYZ 0 841.89 null] +endobj +70 0 obj +[68 0 R /XYZ 0 302.43 null] +endobj +71 0 obj +<< /Length 11123 +>> +stream +q +q +/DeviceRGB cs +0.9608 0.9608 0.9608 scn +52.24 805.89 m +543.04 805.89 l +545.2491 805.89 547.04 804.0991 547.04 801.89 c +547.04 758.41 l +547.04 756.2009 545.2491 754.41 543.04 754.41 c +52.24 754.41 l +50.0309 754.41 48.24 756.2009 48.24 758.41 c +48.24 801.89 l +48.24 804.0991 50.0309 805.89 52.24 805.89 c +h +f +/DeviceRGB CS +0.8 0.8 0.8 SCN +0.75 w +52.24 805.89 m +543.04 805.89 l +545.2491 805.89 547.04 804.0991 547.04 801.89 c +547.04 758.41 l +547.04 756.2009 545.2491 754.41 543.04 754.41 c +52.24 754.41 l +50.0309 754.41 48.24 756.2009 48.24 758.41 c +48.24 801.89 l +48.24 804.0991 50.0309 805.89 52.24 805.89 c +h +S +Q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +59.24 783.065 Td +/F3.0 11 Tf +<6a6176612e6c616e672e4e756c6c506f696e746572457863657074696f6e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 768.325 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 730.446 Td +/F1.0 10.5 Tf +<776865726520696e7374656164206f662074686520757375616c> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 714.63 m +543.04 714.63 l +545.2491 714.63 547.04 712.8391 547.04 710.63 c +547.04 681.89 l +547.04 679.6809 545.2491 677.89 543.04 677.89 c +52.24 677.89 l +50.0309 677.89 48.24 679.6809 48.24 681.89 c +48.24 710.63 l +48.24 712.8391 50.0309 714.63 52.24 714.63 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 714.63 m +543.04 714.63 l +545.2491 714.63 547.04 712.8391 547.04 710.63 c +547.04 681.89 l +547.04 679.6809 545.2491 677.89 543.04 677.89 c +52.24 677.89 l +50.0309 677.89 48.24 679.6809 48.24 681.89 c +48.24 710.63 l +48.24 712.8391 50.0309 714.63 52.24 714.63 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 691.805 Td +/F3.0 11 Tf +<46696c653a4c696e654e756d626572> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 653.926 Td +/F1.0 10.5 Tf +<666f726d61742c20796f7520736565> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 638.11 m +543.04 638.11 l +545.2491 638.11 547.04 636.3191 547.04 634.11 c +547.04 605.37 l +547.04 603.1609 545.2491 601.37 543.04 601.37 c +52.24 601.37 l +50.0309 601.37 48.24 603.1609 48.24 605.37 c +48.24 634.11 l +48.24 636.3191 50.0309 638.11 52.24 638.11 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 638.11 m +543.04 638.11 l +545.2491 638.11 547.04 636.3191 547.04 634.11 c +547.04 605.37 l +547.04 603.1609 545.2491 601.37 543.04 601.37 c +52.24 601.37 l +50.0309 601.37 48.24 603.1609 48.24 605.37 c +48.24 634.11 l +48.24 636.3191 50.0309 638.11 52.24 638.11 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 615.285 Td +/F3.0 11 Tf +<46696c65303b46696c65315b4e756d626572315d3b46696c65325b4e756d626572325d202e2e2e203a4c696e654e756d626572> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.3299 Tw + +BT +48.24 577.406 Td +/F1.0 10.5 Tf +<496e207468697320636173652c204c696e654e756d6265722069732074686520757375616c206f666673657420696e206c696e657320706c75732074686520227374617274206c696e6522206f66207468652061637475616c20736f757263652066696c652e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.9764 Tw + +BT +48.24 561.626 Td +/F1.0 10.5 Tf +<54686174206d65616e7320796f7520757365204c696e654e756d62657220626f746820746f206964656e746966792074686520736f757263652066696c6520616e6420746f2066696e6420746865206c696e652061742069737375652e20546865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.7073 Tw + +BT +48.24 545.846 Td +/F1.0 10.5 Tf +[<6e756d62657220696e205b6272> 20.0195 <61636b> 20.0195 <6574735d20616674657220656163682066696c652074656c6c7320796f7520746865207669727475616c20227374617274206c696e652220666f7220746861742066696c6520287468652066697273742066696c65206861732061>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 530.066 Td +/F1.0 10.5 Tf +<7374617274206f662030292e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.3346 Tw + +BT +48.24 502.286 Td +/F1.0 10.5 Tf +[<496e206f7572206578616d706c652066726f6d20746865206e756c6c20706f696e74657220657863657074696f6e207472> 20.0195 <6163652c20746865207669727475616c207374617274206c696e6520697320313033302e2053696e6365207468652066696c65>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 486.506 Td +/F1.0 10.5 Tf +[<53> 20.0195 <796e63684173706563742e6a617661202273746172747322206174206c696e652031303030205b316b5d2c20746865204c696e654e756d62657220706f696e747320746f206c696e65203330206f662053> 20.0195 <796e63684173706563742e6a6176612e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5476 Tw + +BT +48.24 458.726 Td +/F1.0 10.5 Tf +[<536f2c207768656e2066616365642077697468207375636820737461636b207472> 20.0195 <616365732c20746865207761> 20.0195 <7920746f2066696e64207468652061637475616c20736f75726365206c6f636174696f6e20697320746f206c6f6f6b207468726f756768>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2256 Tw + +BT +48.24 442.946 Td +/F1.0 10.5 Tf +<746865206c697374206f6620227374617274206c696e6522206e756d6265727320746f2066696e6420746865206f6e65206a75737420756e646572207468652073686f776e206c696e65206e756d6265722e2054686174206973207468652066696c65> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.4012 Tw + +BT +48.24 427.166 Td +/F1.0 10.5 Tf +[<77686572652074686520736f75726365206c6f636174696f6e2063616e2061637475616c6c7920626520666f756e642e205468656e2c207375627472> 20.0195 <616374207468617420227374617274206c696e65222066726f6d207468652073686f776e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 411.386 Td +/F1.0 10.5 Tf +<6c696e65206e756d62657220746f2066696e64207468652061637475616c206c696e65206e756d6265722077697468696e20746861742066696c652e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.9409 Tw + +BT +48.24 383.606 Td +/F1.0 10.5 Tf +[<496e206120636c6173732066696c65207468617420636f6d65732066726f6d206f6e6c7920612073696e676c6520736f757263652066696c652c20746865204173706563744a20636f6d70696c65722067656e6572> 20.0195 <6174657320536f7572636546696c65>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.9885 Tw + +BT +48.24 367.826 Td +/F1.0 10.5 Tf +[<6174747269627574657320636f6e73697374656e742077697468207472> 20.0195 <61646974696f6e616c204a61766120636f6d70696c6572732e203d3d20>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +2.9885 Tw + +BT +348.8791 367.826 Td +/F3.0 10.5 Tf +<616a646f63> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.9885 Tw + +BT +375.1291 367.826 Td +/F1.0 10.5 Tf +<2c20746865204173706563744a2041504920646f63756d656e746174696f6e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 352.046 Td +/F1.0 10.5 Tf +[<67656e6572> 20.0195 <61746f72>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 312.206 Td +/F2.0 18 Tf +<312e362e204e616d65> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +48.24 284.186 Td +/F3.0 10.5 Tf +<616a646f63> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +74.49 284.186 Td +/F1.0 10.5 Tf +[<202d2067656e6572> 20.0195 <6174652048544d4c2041504920646f63756d656e746174696f6e2c20696e636c7564696e672063726f737363757474696e6720737472756374757265>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 244.346 Td +/F2.0 18 Tf +[<312e372e2053> 20.0195 <796e6f70736973>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 228.29 m +543.04 228.29 l +545.2491 228.29 547.04 226.4991 547.04 224.29 c +547.04 151.33 l +547.04 149.1209 545.2491 147.33 543.04 147.33 c +52.24 147.33 l +50.0309 147.33 48.24 149.1209 48.24 151.33 c +48.24 224.29 l +48.24 226.4991 50.0309 228.29 52.24 228.29 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 228.29 m +543.04 228.29 l +545.2491 228.29 547.04 226.4991 547.04 224.29 c +547.04 151.33 l +547.04 149.1209 545.2491 147.33 543.04 147.33 c +52.24 147.33 l +50.0309 147.33 48.24 149.1209 48.24 151.33 c +48.24 224.29 l +48.24 226.4991 50.0309 228.29 52.24 228.29 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 205.465 Td +/F3.0 11 Tf +<616a646f63205b202d626f6f74636c6173737061746820636c617373706174686c697374205d205b202d636c6173737061746820636c617373706174686c697374205d205b2d6420706174685d205b2d68656c705d> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 190.725 Td +/F3.0 11 Tf +<5b2d7061636b6167655d205b2d70726f7465637465645d205b2d707269766174655d205b2d7075626c69635d205b2d6f76657276696577206f7665727669657746696c655d205b202d736f7572636570617468> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 175.985 Td +/F3.0 11 Tf +<736f75726365706174686c697374205d205b2d766572626f73655d205b2d76657273696f6e5d205b736f7572636566696c65732e2e2e207c207061636b616765732e2e2e207c204066696c652e2e2e207c> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 161.245 Td +/F3.0 11 Tf +<2d61726766696c652066696c652e2e2e5d205b20616a63206f7074696f6e73205d> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 111.306 Td +/F2.0 18 Tf +<312e382e204465736372697074696f6e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +2.7694 Tw + +BT +48.24 83.286 Td +/F3.0 10.5 Tf +<616a646f63> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.7694 Tw + +BT +74.49 83.286 Td +/F1.0 10.5 Tf +<2072656e646572732048544d4c20646f63756d656e746174696f6e20666f72204173706563744a20636f6e737472756374732061732077656c6c20617320746865204a61766120636f6e737472756374732074686174> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.2672 Tw + +BT +48.24 67.506 Td +/F3.0 10.5 Tf +<6a617661646f63> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2672 Tw + +BT +84.99 67.506 Td +/F1.0 10.5 Tf +<2072656e646572732e20496e206164646974696f6e20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.2672 Tw + +BT +191.2585 67.506 Td +/F3.0 10.5 Tf +<616a646f63> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2672 Tw + +BT +217.5085 67.506 Td +/F1.0 10.5 Tf +[<20646973706c61> 20.0195 <7973207468652063726f737363757474696e67206e617475726520696e2074686520666f726d206f66206c696e6b732e2054686174206d65616e732c>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.8451 Tw + +BT +48.24 51.726 Td +/F1.0 10.5 Tf +<666f72206578616d706c652c207468617420796f752063616e207365652065766572797468696e6720616666656374696e672061206d6574686f64207768656e2072656164696e672074686520646f63756d656e746174696f6e20666f72> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp1 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.978 14.263 Td +/F1.0 9 Tf +<3133> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +72 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 71 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F3.0 26 0 R +/F1.0 8 0 R +/F2.0 22 0 R +>> +/XObject << /Stamp1 360 0 R +>> +>> +>> +endobj +73 0 obj +[72 0 R /XYZ 0 336.23 null] +endobj +74 0 obj +[72 0 R /XYZ 0 268.37 null] +endobj +75 0 obj +[72 0 R /XYZ 0 135.33 null] +endobj +76 0 obj +<< /Length 17238 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +48.24 794.676 Td +/F1.0 10.5 Tf +<746865206d6574686f642e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1923 Tw + +BT +48.24 766.896 Td +/F1.0 10.5 Tf +[<54> 29.7852 <6f2072756e20>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.1923 Tw + +BT +84.6104 766.896 Td +/F3.0 10.5 Tf +<616a646f63> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1923 Tw + +BT +110.8604 766.896 Td +/F1.0 10.5 Tf +<2c20757365206f6e65206f6620746865207363726970747320696e20746865204173706563744a20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.1923 Tw + +BT +297.0029 766.896 Td +/F3.0 10.5 Tf +<62696e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1923 Tw + +BT +312.7529 766.896 Td +/F1.0 10.5 Tf +[<206469726563746f7279> 89.8438 <2e2054686520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.1923 Tw + +BT +388.0075 766.896 Td +/F3.0 10.5 Tf +<616a646f63> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1923 Tw + +BT +414.2575 766.896 Td +/F1.0 10.5 Tf +<20696d706c656d656e746174696f6e206275696c6473206f6e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1572 Tw + +BT +48.24 751.116 Td +/F1.0 10.5 Tf +<53756ed57320> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.1572 Tw + +BT +78.6082 751.116 Td +/F3.0 10.5 Tf +<6a617661646f63> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1572 Tw + +BT +115.3582 751.116 Td +/F1.0 10.5 Tf +[<20636f6d6d616e64206c696e6520746f6f6c2c20616e6420796f752075736520697420696e207468652073616d65207761> 20.0195 <792077697468206d616e> 20.0195 <79206f66207468652073616d65206f7074696f6e73>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5676 Tw + +BT +48.24 735.336 Td +/F1.0 10.5 Tf +<28> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.5676 Tw + +BT +51.873 735.336 Td +/F3.0 10.5 Tf +<6a617661646f63> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5676 Tw + +BT +88.623 735.336 Td +/F1.0 10.5 Tf +<206f7074696f6e7320617265206e6f7420646f63756d656e74656420686572653b20666f72206d6f726520696e666f726d6174696f6e206f6e20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.5676 Tw + +BT +394.7352 735.336 Td +/F3.0 10.5 Tf +<6a617661646f63> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5676 Tw + +BT +431.4852 735.336 Td +/F1.0 10.5 Tf +<2075736167652c207365652074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +0.5676 Tw + +BT +507.7595 735.336 Td +/F1.0 10.5 Tf +<4a617661646f63> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +48.24 719.556 Td +/F1.0 10.5 Tf +<686f6d6570616765> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +100.089 719.556 Td +/F1.0 10.5 Tf +<2e29> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4038 Tw + +BT +48.24 691.776 Td +/F1.0 10.5 Tf +<4173207769746820> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.4038 Tw + +BT +89.3676 691.776 Td +/F3.0 10.5 Tf +<616a63> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4038 Tw + +BT +105.1176 691.776 Td +/F1.0 10.5 Tf +[<202862757420756e6c696b> 20.0195 <6520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.4038 Tw + +BT +166.4834 691.776 Td +/F3.0 10.5 Tf +<6a617661646f63> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4038 Tw + +BT +203.2334 691.776 Td +/F1.0 10.5 Tf +<292c20796f75207061737320> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.4038 Tw + +BT +259.3073 691.776 Td +/F3.0 10.5 Tf +<616a646f63> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4038 Tw + +BT +285.5573 691.776 Td +/F1.0 10.5 Tf +[<20616c6c20796f75722061737065637420736f757263652066696c657320616e6420616e> 20.0195 <792066696c657320636f6e7461696e696e67>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4204 Tw + +BT +48.24 675.996 Td +/F1.0 10.5 Tf +[<74797065732061666665637465642062> 20.0195 <792074686520617370656374733b206974d573206f6674656e206561736965737420746f206a757374207061737320616c6c2074686520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.4204 Tw + +BT +375.3099 675.996 Td +/F3.0 10.5 Tf +<2e6a617661> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4204 Tw + +BT +401.5599 675.996 Td +/F1.0 10.5 Tf +<20616e6420> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.4204 Tw + +BT +426.9498 675.996 Td +/F3.0 10.5 Tf +<2e616a> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4204 Tw + +BT +442.6998 675.996 Td +/F1.0 10.5 Tf +<2066696c657320696e20796f75722073797374656d2e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.3647 Tw + +BT +48.24 660.216 Td +/F1.0 10.5 Tf +[<556e6c696b> 20.0195 <6520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.3647 Tw + +BT +83.7585 660.216 Td +/F3.0 10.5 Tf +<616a63> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.3647 Tw + +BT +99.5085 660.216 Td +/F1.0 10.5 Tf +<2c20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.3647 Tw + +BT +105.2178 660.216 Td +/F3.0 10.5 Tf +<616a646f63> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.3647 Tw + +BT +131.4678 660.216 Td +/F1.0 10.5 Tf +<2077696c6c2074727920746f2066696e64207061636b61676520736f7572636573207573696e67207468652073706563696669656420736f757263657061746820696620796f75206c697374207061636b61676573> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 644.436 Td +/F1.0 10.5 Tf +<6f6e2074686520636f6d6d616e64206c696e652e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.8994 Tw + +BT +48.24 616.656 Td +/F1.0 10.5 Tf +[<54> 29.7852 <6f2070726f7669646520616e2061726766696c65206c697374696e672074686520736f757263652066696c65732c20796f752063616e2075736520757365207468652073616d652061726766696c652028>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +3.8994 Tw + +BT +496.157 616.656 Td +/F3.0 10.5 Tf +<4066696c656e616d65> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.8994 Tw + +BT +543.407 616.656 Td +/F1.0 10.5 Tf +<29> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.4109 Tw + +BT +48.24 600.876 Td +/F1.0 10.5 Tf +<636f6e76656e74696f6e73206173207769746820> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +3.4109 Tw + +BT +161.0891 600.876 Td +/F3.0 10.5 Tf +<616a63> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.4109 Tw + +BT +176.8391 600.876 Td +/F1.0 10.5 Tf +[<2e2046> 40.0391 <6f72206578616d706c652c2074686520666f6c6c6f77696e6720646f63756d656e747320616c6c2074686520736f757263652066696c6573206c697374656420696e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +48.24 585.096 Td +/F3.0 10.5 Tf +<61726766696c652e6c7374> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +105.99 585.096 Td +/F1.0 10.5 Tf +<2c2073656e64696e6720746865206f757470757420746f2074686520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +239.1615 585.096 Td +/F3.0 10.5 Tf +<646f63446972> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +270.6615 585.096 Td +/F1.0 10.5 Tf +[<206f7574707574206469726563746f7279> 89.8438 <2e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 569.28 m +543.04 569.28 l +545.2491 569.28 547.04 567.4891 547.04 565.28 c +547.04 536.54 l +547.04 534.3309 545.2491 532.54 543.04 532.54 c +52.24 532.54 l +50.0309 532.54 48.24 534.3309 48.24 536.54 c +48.24 565.28 l +48.24 567.4891 50.0309 569.28 52.24 569.28 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 569.28 m +543.04 569.28 l +545.2491 569.28 547.04 567.4891 547.04 565.28 c +547.04 536.54 l +547.04 534.3309 545.2491 532.54 543.04 532.54 c +52.24 532.54 l +50.0309 532.54 48.24 534.3309 48.24 536.54 c +48.24 565.28 l +48.24 567.4891 50.0309 569.28 52.24 569.28 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 546.455 Td +/F3.0 11 Tf +<616a646f63202d6420646f63446972204061726766696c652e6c7374> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 508.576 Td +/F1.0 10.5 Tf +<5365652074686520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +86.586 508.576 Td +/F1.0 10.5 Tf +<616a6320646f63756d656e746174696f6e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +179.6055 508.576 Td +/F1.0 10.5 Tf +<20666f722064657461696c73206f6e2074686520746578742066696c6520666f726d61742e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +48.24 480.796 Td +/F3.0 10.5 Tf +<616a646f63> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +74.49 480.796 Td +/F1.0 10.5 Tf +<20686f6e6f75727320> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +121.8135 480.796 Td +/F3.0 10.5 Tf +<616a63> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +137.5635 480.796 Td +/F1.0 10.5 Tf +<206f7074696f6e732e205365652074686520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +221.0805 480.796 Td +/F1.0 10.5 Tf +<616a6320646f63756d656e746174696f6e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +314.1 480.796 Td +/F1.0 10.5 Tf +<20666f722064657461696c73206f6e207468657365206f7074696f6e732e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.3417 Tw + +BT +48.24 453.016 Td +/F3.0 10.5 Tf +<616a646f63> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.3417 Tw + +BT +74.49 453.016 Td +/F1.0 10.5 Tf +<2063757272656e746c792072657175697265732074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.3417 Tw + +BT +191.987 453.016 Td +/F3.0 10.5 Tf +<746f6f6c732e6a6172> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.3417 Tw + +BT +239.237 453.016 Td +/F1.0 10.5 Tf +<2066726f6d204a32534520312e3320746f206265206f6e2074686520636c617373706174682e204e6f726d616c6c7920746865207363726970747320736574> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.7089 Tw + +BT +48.24 437.236 Td +/F1.0 10.5 Tf +<746869732075702c20617373756d696e67207468617420796f757220> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.7089 Tw + +BT +195.7837 437.236 Td +/F3.0 10.5 Tf +<4a4156415f484f4d45> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.7089 Tw + +BT +243.0337 437.236 Td +/F1.0 10.5 Tf +[<207661726961626c6520706f696e747320746f20616e20617070726f70726961746520696e7374616c6c6174696f6e206f66204a6176612e2059> 69.8242 <6f75>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 421.456 Td +/F1.0 10.5 Tf +[<6d61> 20.0195 <79206e65656420746f2070726f766964652074686973206a6172207768656e207573696e67206120646966666572656e742076657273696f6e206f66204a617661206f722061204a52452e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 381.616 Td +/F2.0 18 Tf +<312e392e204578616d706c6573> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 353.596 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 353.596 Td +/F1.0 10.5 Tf +<4368616e676520696e746f2074686520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +147.279 353.596 Td +/F3.0 10.5 Tf +<6578616d706c6573> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +189.279 353.596 Td +/F1.0 10.5 Tf +[<206469726563746f7279> 89.8438 <2e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 331.816 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 331.816 Td +/F1.0 10.5 Tf +<5479706520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +93.3615 331.816 Td +/F3.0 10.5 Tf +<6d6b64697220646f63> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +140.6115 331.816 Td +/F1.0 10.5 Tf +<20746f20637265617465207468652064657374696e6174696f6e206469726563746f727920666f722074686520646f63756d656e746174696f6e2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 310.036 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 310.036 Td +/F1.0 10.5 Tf +<5479706520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +93.3615 310.036 Td +/F3.0 10.5 Tf +<616a646f63202d70726976617465202d6420646f6320737061636577617220636f6f7264696e6174696f6e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +319.1115 310.036 Td +/F1.0 10.5 Tf +[<20746f2067656e6572> 20.0195 <6174652074686520646f63756d656e746174696f6e2e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +74.954 288.256 Td +/F1.1 10.5 Tf +<23> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.0175 Tw + +BT +84.24 288.256 Td +/F1.0 10.5 Tf +<2855736520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +2.0175 Tw + +BT +110.481 288.256 Td +/F3.0 10.5 Tf +<2d70726976617465> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.0175 Tw + +BT +152.481 288.256 Td +/F1.0 10.5 Tf +[<20746f2067657420616c6c206d656d626572732c2073696e6365206d61> 20.0195 <79206f662074686520696e746572657374696e67206f6e657320696e20737061636577617220617265206e6f74>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +84.24 272.476 Td +/F1.0 10.5 Tf +<7075626c69632e29> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 250.696 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 250.696 Td +/F1.0 10.5 Tf +<5479706520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +93.3615 250.696 Td +/F3.0 10.5 Tf +<616a646f63202d70726976617465202d6420646f63204073706163657761722f64656d6f2e6c7374> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +303.3615 250.696 Td +/F1.0 10.5 Tf +<20746f20757365207468652061726766696c65206173736f63696174656420776974682053706163657761722e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 228.916 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 228.916 Td +/F1.0 10.5 Tf +[<54> 29.7852 <6f20766965772074686520646f63756d656e746174696f6e2c206f70656e207468652066696c6520>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +273.1763 228.916 Td +/F3.0 10.5 Tf +<696e6465782e68746d6c> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +325.6763 228.916 Td +/F1.0 10.5 Tf +<20696e2074686520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +359.9273 228.916 Td +/F3.0 10.5 Tf +<646f63> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +375.6773 228.916 Td +/F1.0 10.5 Tf +<206469726563746f7279207573696e672061207765622062726f777365722e20616a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 201.136 Td +/F1.0 10.5 Tf +<636f6d6d616e642d6c696e65206c61756e6368657220666f72206261736963206c6f61642d74696d652077656176696e67> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 173.356 Td +/F1.0 10.5 Tf +<616a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 145.576 Td +/F1.0 10.5 Tf +<4f7074696f6e73> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 117.796 Td +/F1.0 10.5 Tf +<617267c9> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp2 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +49.24 14.263 Td +/F1.0 9 Tf +<3134> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +77 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 76 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F1.0 8 0 R +/F3.0 26 0 R +/F2.0 22 0 R +/F1.1 47 0 R +>> +/XObject << /Stamp2 361 0 R +>> +>> +/Annots [78 0 R 79 0 R 80 0 R 81 0 R] +>> +endobj +78 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (http://java.sun.com/j2se/javadoc/) +>> +/Subtype /Link +/Rect [507.7595 732.27 547.04 746.55] +/Type /Annot +>> +endobj +79 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (http://java.sun.com/j2se/javadoc/) +>> +/Subtype /Link +/Rect [48.24 716.49 100.089 730.77] +/Type /Annot +>> +endobj +80 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#ajc) +>> +/Subtype /Link +/Rect [86.586 505.51 179.6055 519.79] +/Type /Annot +>> +endobj +81 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#ajc_options) +>> +/Subtype /Link +/Rect [221.0805 477.73 314.1 492.01] +/Type /Annot +>> +endobj +82 0 obj +[77 0 R /XYZ 0 405.64 null] +endobj +83 0 obj +<< /Length 4993 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +48.24 782.394 Td +/F2.0 22 Tf +<4368617074657220322e204465736372697074696f6e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4179 Tw + +BT +48.24 753.206 Td +/F1.0 10.5 Tf +<54686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.4179 Tw + +BT +70.0779 753.206 Td +/F3.0 10.5 Tf +<616a> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4179 Tw + +BT +80.5779 753.206 Td +/F1.0 10.5 Tf +[<20636f6d6d616e642072756e73204a6176612070726f6772> 20.0195 <616d7320696e204a61766120312e34206f72206c617465722062> 20.0195 <792073657474696e6720757020>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.4179 Tw + +BT +403.9082 753.206 Td +/F3.0 10.5 Tf +<57656176696e6755524c436c6173734c6f61646572> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4179 Tw + +BT +514.1582 753.206 Td +/F1.0 10.5 Tf +<20617320746865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 737.426 Td +/F1.0 10.5 Tf +[<73797374656d20636c617373206c6f616465722c20746f20646f206c6f61642d74696d652062> 20.0195 <797465636f64652077656176696e672e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6405 Tw + +BT +48.24 709.646 Td +/F1.0 10.5 Tf +[<54686520617267756d656e747320617265207468652073616d652061732074686f7365207573656420746f206c61756e636820746865204a6176612070726f6772> 20.0195 <616d2e2055736572732073686f756c6420646566696e6520746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 693.866 Td +/F1.0 10.5 Tf +<656e7669726f6e6d656e74207661726961626c657320> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +165.4935 693.866 Td +/F3.0 10.5 Tf +<434c41535350415448> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +212.7435 693.866 Td +/F1.0 10.5 Tf +<20616e6420> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +237.2925 693.866 Td +/F3.0 10.5 Tf +<41535045435450415448> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +289.7925 693.866 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 666.086 Td +/F1.0 10.5 Tf +[<46> 40.0391 <6f72206d6f726520696e666f726d6174696f6e20616e6420616c7465726e61746976657320666f72206c6f61642d74696d652077656176696e672c2073656520>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +378.7481 666.086 Td +/F1.0 10.5 Tf +<3f3f3f> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +394.4981 666.086 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 626.246 Td +/F2.0 18 Tf +<322e312e204578616d706c6573> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 598.226 Td +/F1.0 10.5 Tf +[<55736520616a6320746f206275696c642061206c696272> 20.0195 <617279> 89.8438 <2c207468656e207765617665206174206c6f61642074696d65>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 582.41 m +543.04 582.41 l +545.2491 582.41 547.04 580.6191 547.04 578.41 c +547.04 475.97 l +547.04 473.7609 545.2491 471.97 543.04 471.97 c +52.24 471.97 l +50.0309 471.97 48.24 473.7609 48.24 475.97 c +48.24 578.41 l +48.24 580.6191 50.0309 582.41 52.24 582.41 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 582.41 m +543.04 582.41 l +545.2491 582.41 547.04 580.6191 547.04 578.41 c +547.04 475.97 l +547.04 473.7609 545.2491 471.97 543.04 471.97 c +52.24 471.97 l +50.0309 471.97 48.24 473.7609 48.24 475.97 c +48.24 578.41 l +48.24 580.6191 50.0309 582.41 52.24 582.41 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 559.585 Td +/F3.0 11 Tf +<52454d20636f6d70696c65206c696272617279> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 544.845 Td +/F3.0 11 Tf +<247b4153504543544a5f484f4d457d5c62696e5c616a632e626174202d6f75746a6172206c69625c617370656374732e6a61722040617370656374732e6c7374> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 515.365 Td +/F3.0 11 Tf +<52454d2072756e2c2077656176696e6720696e746f206170706c69636174696f6e206174206c6f61642d74696d6520736574> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 500.625 Td +/F3.0 11 Tf +<415350454354504154483d6c69625c617370656374732e6a61722073657420434c415353504154483d6170705c6170702e6a6172> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 485.885 Td +/F3.0 11 Tf +<247b4153504543544a5f484f4d457d5c62696e5c616a2e62617420636f6d2e636f6d70616e792e6170702e4d61696e202248656c6c6f2c20576f726c642122> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp1 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.978 14.263 Td +/F1.0 9 Tf +<3135> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +84 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 83 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F2.0 22 0 R +/F1.0 8 0 R +/F3.0 26 0 R +>> +/XObject << /Stamp1 360 0 R +>> +>> +/Annots [86 0 R] +>> +endobj +85 0 obj +[84 0 R /XYZ 0 841.89 null] +endobj +86 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#ltw) +>> +/Subtype /Link +/Rect [378.7481 663.02 394.4981 677.3] +/Type /Annot +>> +endobj +87 0 obj +[84 0 R /XYZ 0 650.27 null] +endobj +88 0 obj +<< /Length 11860 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +48.24 782.394 Td +/F2.0 22 Tf +<4368617074657220332e204173706563744a2042726f77736572> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 741.146 Td +/F2.0 18 Tf +<332e312e20496e74726f64756374696f6e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 713.126 Td +/F1.0 10.5 Tf +[<414a42726f777365722070726573656e747320612047554920666f7220636f6d70696c696e672070726f6772> 20.0195 <616d73207769746820616a6320616e64206e617669676174696e672063726f737363757474696e67207374727563747572652e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2409 Tw + +BT +48.24 685.346 Td +/F1.0 10.5 Tf +[<546865204173706563744a2042726f777365722063616e20656469742070726f6772> 20.0195 <616d20736f757263652066696c65732c20636f6d70696c65207573696e6720746865204173706563744a20636f6d70696c657220>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.2409 Tw + +BT +499.0931 685.346 Td +/F3.0 10.5 Tf +<616a63> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2409 Tw + +BT +514.8431 685.346 Td +/F1.0 10.5 Tf +<2072756e2061> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0145 Tw + +BT +48.24 669.566 Td +/F1.0 10.5 Tf +[<70726f6772> 20.0195 <616d2c20616e64206772> 20.0195 <6170686963616c6c79206e61766967617465207468652070726f6772> 20.0195 <616dd5732063726f737363757474696e67207374727563747572652e2046> 40.0391 <6f72206d6f726520696e666f726d6174696f6e206f6e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +48.24 653.786 Td +/F3.0 10.5 Tf +<616a63> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.99 653.786 Td +/F1.0 10.5 Tf +<2c2073656520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +88.0245 653.786 Td +/F1.0 10.5 Tf +<3f3f3f> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +103.7745 653.786 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.4286 Tw + +BT +48.24 626.006 Td +/F1.0 10.5 Tf +[<4c61756e6368207468652062726f777365722066726f6d2074686520636f6d6d616e64206c696e65206569746865722062> 20.0195 <7920747970696e672022616a62726f777365722220746f20696e766f6b> 20.0195 <65207468652073637269707420696e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +3.441 Tw + +BT +48.24 610.226 Td +/F3.0 10.5 Tf +<7b6173706563746a7d2f62696e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.441 Tw + +BT +116.49 610.226 Td +/F1.0 10.5 Tf +[<20286966204173706563744a20697320696e7374616c6c656420636f72726563746c7929206f722062> 20.0195 <79207573696e672074686520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +3.441 Tw + +BT +391.5393 610.226 Td +/F3.0 10.5 Tf +<6173706563746a746f6f6c732e6a6172> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.441 Tw + +BT +475.5393 610.226 Td +/F1.0 10.5 Tf +[<206469726563746c79> 89.8438 <2c20616e64>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 594.446 Td +/F1.0 10.5 Tf +[<73706563696679696e67206e6f20617267756d656e7473206f7220736f6d65206e756d626572206f66206275696c6420636f6e6669677572> 20.0195 <6174696f6e2066696c6573202873756666697820>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +430.5448 594.446 Td +/F3.0 10.5 Tf +<2e6c7374> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +451.5448 594.446 Td +/F1.0 10.5 Tf +<293a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 578.63 m +543.04 578.63 l +545.2491 578.63 547.04 576.8391 547.04 574.63 c +547.04 545.89 l +547.04 543.6809 545.2491 541.89 543.04 541.89 c +52.24 541.89 l +50.0309 541.89 48.24 543.6809 48.24 545.89 c +48.24 574.63 l +48.24 576.8391 50.0309 578.63 52.24 578.63 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 578.63 m +543.04 578.63 l +545.2491 578.63 547.04 576.8391 547.04 574.63 c +547.04 545.89 l +547.04 543.6809 545.2491 541.89 543.04 541.89 c +52.24 541.89 l +50.0309 541.89 48.24 543.6809 48.24 545.89 c +48.24 574.63 l +48.24 576.8391 50.0309 578.63 52.24 578.63 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 555.805 Td +/F3.0 11 Tf +<6a617661202d6a6172206173706563746a312e312f6c69622f6173706563746a746f6f6c732e6a6172206173706563746a312e312f646f632f6578616d706c65732f73706163657761722f64656275672e6c7374> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 505.866 Td +/F2.0 18 Tf +[<332e322e204275696c64696e672050726f6772> 20.0195 <616d73>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 471.126 Td +/F2.0 13 Tf +[<332e322e312e204275696c6420436f6e6669677572> 20.0195 <6174696f6e73>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.8761 Tw + +BT +48.24 444.566 Td +/F1.0 10.5 Tf +[<41206275696c6420636f6e6669677572> 20.0195 <6174696f6e206973206120736574206f662066696c657320746f20636f6d70696c6520666f7220612070726f6772> 20.0195 <616d2028616e64206f7074696f6e616c6c7920736f6d65206164646974696f6e616c>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2068 Tw + +BT +48.24 428.786 Td +/F1.0 10.5 Tf +<636f6d70696c6520617267756d656e7473292e204265636175736520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.2068 Tw + +BT +197.509 428.786 Td +/F3.0 10.5 Tf +<616a63> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2068 Tw + +BT +213.259 428.786 Td +/F1.0 10.5 Tf +<20726571756972657320616c6c20736f757263657320746f2062652073706563696669656420286174206c65617374207573696e672074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.2068 Tw + +BT +484.04 428.786 Td +/F3.0 10.5 Tf +<2d736f75726365726f6f7473> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2068 Tw + +BT +547.04 428.786 Td +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1247 Tw + +BT +48.24 413.006 Td +/F1.0 10.5 Tf +<6f7074696f6e292c206d6f73742075736572732063726561746520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.1247 Tw + +BT +184.2826 413.006 Td +/F3.0 10.5 Tf +<2e6c7374> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1247 Tw + +BT +205.2826 413.006 Td +/F1.0 10.5 Tf +<2066696c65732074686174206c697374207468652066696c657320746f20636f6d70696c6520286f6e6520617267756d656e7420706572206c696e652c20676c6f6262696e67> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 397.226 Td +/F1.0 10.5 Tf +<7065726d6974746564202d20666f72206d6f72652064657461696c732c2073656520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +210.5175 397.226 Td +/F1.0 10.5 Tf +<3f3f3f> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +226.2675 397.226 Td +/F1.0 10.5 Tf +<292e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4504 Tw + +BT +48.24 369.446 Td +/F1.0 10.5 Tf +[<54> 29.7852 <6f20776f726b2077697468206120706172746963756c61722070726f6772> 20.0195 <616d2c2073656c6563742074686520636f72726573706f6e64696e6720222e6c737422206275696c6420636f6e6669677572> 20.0195 <6174696f6e2066696c652066726f6d20746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6467 Tw + +BT +48.24 353.666 Td +/F1.0 10.5 Tf +[<475549207573696e67207468652046696c65206d656e752c20226f70656e> 40.0391 <22206974656d2c206f722062> 20.0195 <79207573696e672074686520224f70656e204275696c6420436f6e6669677572> 20.0195 <6174696f6e> 40.0391 <2220627574746f6e20285b696d6167655d292e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.2796 Tw + +BT +48.24 337.886 Td +/F1.0 10.5 Tf +[<59> 69.8242 <6f752063616e20706f70756c61746520746865206275696c64206c6973742066726f6d2074686520636f6d6d616e64206c696e652062> 20.0195 <792070617373696e6720616e> 20.0195 <79206e756d626572206f6620222e6c7374222070617468732e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 322.106 Td +/F1.0 10.5 Tf +[<28486f77657665722c20696620796f75207061737320696e20616e> 20.0195 <79206e6f6e2d222e6c73742220617267756d656e74732c2069742077696c6c2072756e2074686520636f6d6d616e642d6c696e6520636f6d70696c6572206469726563746c79> 89.8438 <2e29>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.8092 Tw + +BT +48.24 294.326 Td +/F1.0 10.5 Tf +[<54> 29.7852 <6f20737769746368206265747765656e206275696c6420636f6e6669677572> 20.0195 <6174696f6e732c2073656c6563742c206164642c206f722072656d6f7665207468656d207573696e672074686520636f72726573706f6e64696e67>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 278.546 Td +/F1.0 10.5 Tf +<746f6f6c62617220627574746f6e732e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1994 Tw + +BT +48.24 250.766 Td +/F1.0 10.5 Tf +<476c6f62616c206275696c64206f7074696f6e73206172652073746f72656420696e20616e20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.1994 Tw + +BT +242.0551 250.766 Td +/F3.0 10.5 Tf +<2e616a62726f77736572> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1994 Tw + +BT +294.5551 250.766 Td +/F1.0 10.5 Tf +[<2066696c6520696e20796f757220484f4d45206469726563746f7279> 89.8438 <2e20456469742074686573652066726f6d20746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2116 Tw + +BT +48.24 234.986 Td +/F1.0 10.5 Tf +[<4755492062> 20.0195 <7920636c69636b696e672074686520224f7074696f6e732220627574746f6e206f722073656c656374696e67207468652054> 29.7852 <6f6f6c73206d656e75206974656d20224f7074696f6e73c9222e205468697320697320686f7720746f20736574>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 219.206 Td +/F1.0 10.5 Tf +<636c617373706174682c20617370656374706174682c206574632e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 191.426 Td +/F1.0 10.5 Tf +<54686520666f6c6c6f77696e672073656374696f6e732077616c6b207468726f7567682061206275696c642e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 156.926 Td +/F2.0 13 Tf +[<332e322e322e20436f6d70696c696e6720612050726f6772> 20.0195 <616d204275696c6420436f6e6669677572> 20.0195 <6174696f6e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 130.366 Td +/F1.0 10.5 Tf +[<54> 29.7852 <6f20636f6d70696c6520636c69636b2074686520224275696c642220627574746f6e20285b696d6167655d292c206f72206f72207573652074686520746f6f6c73206d656e752e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5662 Tw + +BT +48.24 102.586 Td +/F1.0 10.5 Tf +[<59> 69.8242 <6f75206d61> 20.0195 <792073656c6563742066726f6d20646966666572656e74206275696c6420636f6e6669677572> 20.0195 <6174696f6e7320696e20746865204755492028736565206c6162656c203120696e20746865206772> 20.0195 <61706869632062656c6f77292e20284966>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 86.806 Td +/F1.0 10.5 Tf +<796f752067657420636c61737370617468206f72206f74686572206572726f72732c207365742075702074686520676c6f62616c206275696c64206f7074696f6e73206173206465736372696265642061626f76652e29> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 59.026 Td +/F1.0 10.5 Tf +<5b696d6167655d> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp2 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +49.24 14.263 Td +/F1.0 9 Tf +<3136> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +89 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 88 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F2.0 22 0 R +/F1.0 8 0 R +/F3.0 26 0 R +>> +/XObject << /Stamp2 361 0 R +>> +>> +/Annots [94 0 R 97 0 R] +>> +endobj +90 0 obj +[89 0 R /XYZ 0 841.89 null] +endobj +91 0 obj +<< /Limits [(__anchor-top) (_stack_traces_and_the_sourcefile_attribute)] +/Names [(__anchor-top) 13 0 R (_argfiles_argument_list_files) 185 0 R (_build_configurations) 96 0 R (_compatibility) 57 0 R (_compiling_a_program_build_configuration) 98 0 R (_description) 75 0 R (_enabling_load_time_weaving) 211 0 R (_examples) 62 0 R (_examples_2) 82 0 R (_examples_3) 87 0 R (_file_names) 56 0 R (_jvmti) 239 0 R (_name) 39 0 R (_name_2) 73 0 R (_programmatically_handling_compiler_messages) 167 0 R (_stack_traces_and_the_sourcefile_attribute) 70 0 R] +>> +endobj +92 0 obj +<< /Limits [(_synopsis) (ajbrowser-limitations)] +/Names [(_synopsis) 40 0 R (_synopsis_2) 74 0 R (_the_aspectj_compiler_api) 69 0 R (_weaver_options) 230 0 R (_weaving_class_files_more_than_once) 206 0 R (aj) 85 0 R (ajbrowser) 90 0 R (ajbrowser-building) 95 0 R (ajbrowser-feedback) 114 0 R (ajbrowser-intro) 93 0 R (ajbrowser-knownProblems) 109 0 R (ajbrowser-limitations) 113 0 R] +>> +endobj +93 0 obj +[89 0 R /XYZ 0 765.17 null] +endobj +94 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#ajc-ref) +>> +/Subtype /Link +/Rect [88.0245 650.72 103.7745 665] +/Type /Annot +>> +endobj +95 0 obj +[89 0 R /XYZ 0 529.89 null] +endobj +96 0 obj +[89 0 R /XYZ 0 489.81 null] +endobj +97 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#ajc-ref) +>> +/Subtype /Link +/Rect [210.5175 394.16 226.2675 408.44] +/Type /Annot +>> +endobj +98 0 obj +[89 0 R /XYZ 0 175.61 null] +endobj +99 0 obj +<< /Length 13042 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +48.24 786.666 Td +/F2.0 18 Tf +[<332e332e204e617669676174696e672050726f6772> 20.0195 <616d20537472756374757265>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.3011 Tw + +BT +48.24 758.646 Td +/F1.0 10.5 Tf +[<53656c656374206e6f64657320696e207468652070726f6772> 20.0195 <616d207374727563747572652062> 20.0195 <7920636c69636b696e67207468656d2028736565206c6162656c2032292e204966206f6e65206e6f64652069732072656c6174656420746f206f6e65206f72>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0827 Tw + +BT +48.24 742.866 Td +/F1.0 10.5 Tf +[<6d6f7265206f74686572206e6f6465732062> 20.0195 <7920616e206173736f63696174696f6e20746865206e616d65206f6620746865206173736f63696174696f6e2077696c6c206170706561722062656c6f772074686174206e6f646520616e64>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.9048 Tw + +BT +48.24 727.086 Td +/F1.0 10.5 Tf +[<77696c6c20626520646973706c61> 20.0195 <79656420696e206974616c6963732e204c696e6b7320746f206f7468657220737472756374757265206e6f6465732061707065617220696e20626c75652062656c6f7720746865206173736f63696174696f6e2e204966>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 711.306 Td +/F1.0 10.5 Tf +<7468657265206973206e6f20636f72726573706f6e64696e6720736f7572636520666f7220746865206c696e6b2069742077696c6c20617070656172206c696768742d626c75652e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 683.526 Td +/F1.0 10.5 Tf +<5b696d6167655d> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 649.026 Td +/F2.0 13 Tf +<332e332e312e204578616d706c653a204578706c6f72696e672074686520225370616365776172222073616d706c6520636f6465> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 622.466 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 622.466 Td +/F1.0 10.5 Tf +<4c61756e636820> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +106.6545 622.466 Td +/F3.0 10.5 Tf +<616a62726f77736572> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 600.686 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.5072 Tw + +BT +66.24 600.686 Td +/F1.0 10.5 Tf +<43686f6f7365202246696c6520> Tj +/F1.1 10.5 Tf +<2420> Tj +/F1.0 10.5 Tf +[<4f70656e> 40.0391 <22206f7220636c69636b2074686520224f70656e204275696c6420436f6e6669677572> 20.0195 <6174696f6e> 40.0391 <2220627574746f6e20285b696d6167655d2920616e642073656c65637420746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 584.906 Td +/F1.0 10.5 Tf +[<636f6e6669677572> 20.0195 <6174696f6e2066696c6520666f7220646562756767696e6720746865207370616365776172206578616d706c652c20696e20>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +358.4968 584.906 Td +/F3.0 10.5 Tf +<6578616d706c65732f73706163657761722f64656275672e6c7374> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +500.2468 584.906 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 563.126 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.7699 Tw + +BT +66.24 563.126 Td +/F1.0 10.5 Tf +<436c69636b2074686520224275696c642220627574746f6e20285b696d6167655d2920746f20636f6d70696c652e20546865206c6566742070616e652073686f756c642066696c6c20776974682061207370616365776172> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 547.346 Td +/F1.0 10.5 Tf +[<6465636c6172> 20.0195 <6174696f6e20747265652e204966207468657265206973206120636f6d70696c6572206572726f722c2074686520636c69636b61626c65206572726f72206d6573736167652073686f777320757020617320696e206c6162656c20342e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4816 Tw + +BT +66.24 519.566 Td +/F1.0 10.5 Tf +<4e6f74653a20496620796f7520646964206e6f742073657420757020796f757220636c617373706174682c2074686520636f6d70696c652077696c6c206661696c20776974682061206d657373616765207468617420796f75206e65656420746f> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.952 Tw + +BT +66.24 503.786 Td +/F1.0 10.5 Tf +[<696e7374616c6c206173706563746a72742e6a6172206f6e20796f757220636f6d70696c6520636c617373706174682e2054> 29.7852 <6f20646f20746861742c2073656c656374202254> 29.7852 <6f6f6c7320>] TJ +/F1.1 10.5 Tf +<2420> Tj +/F1.0 10.5 Tf +<4f7074696f6e7322206f7220636c69636b20746865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.5004 Tw + +BT +66.24 488.006 Td +/F1.0 10.5 Tf +<224f7074696f6e732220627574746f6e20285b696d6167655d292e20436c69636b2074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.5004 Tw + +BT +256.2322 488.006 Td +/F3.0 10.5 Tf +<4275696c64204f7074696f6e73> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.5004 Tw + +BT +325.9826 488.006 Td +/F1.0 10.5 Tf +<2074616220746f207669657720746865204275696c642050617468732070616e652e204564697420746865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.484 Tw + +BT +66.24 472.226 Td +/F1.0 10.5 Tf +[<636c6173737061746820656e74727920746f2075736520796f757220696e7374616c6c206c6f636174696f6e2e2046> 40.0391 <6f72206578616d706c652c20696620796f752072> 20.0195 <616e2066726f6d207468652062617365204173706563746a>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4833 Tw + +BT +66.24 456.446 Td +/F1.0 10.5 Tf +[<6469726563746f7279> 89.8438 <2c2074686520636c61737370617468206e656564206f6e6c7920696e636c75646520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.4833 Tw + +BT +279.4356 456.446 Td +/F3.0 10.5 Tf +<6c69622f6173706563746a72742e6a6172> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4833 Tw + +BT +368.6856 456.446 Td +/F1.0 10.5 Tf +[<202874686f756768207468652062726f77736572206d61> 20.0195 <7920706f70756c617465>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +7.6119 Tw + +BT +66.24 440.666 Td +/F1.0 10.5 Tf +[<74686520636c6173737061746820776974682074686520626f6f74636c6173737061746820616e6420636c6173737061746820696e697469616c6c79> 89.8438 <2e29204265207375726520746f2075736520746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +66.24 424.886 Td +/F3.0 10.5 Tf +<6c69622f6173706563746a72742e6a6172> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +155.49 424.886 Td +/F1.0 10.5 Tf +<20746861742063616d652077697468207468652062726f777365722e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 397.106 Td +/F1.0 10.5 Tf +<5b696d6167655d> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 369.326 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.3039 Tw + +BT +66.24 369.326 Td +/F1.0 10.5 Tf +[<446966666572656e74207374727563747572652076696577733a2054686520737472756374757265207472656520617420746865206c6566742063616e20646973706c61> 20.0195 <7920646966666572656e74206f72646572696e677320616e64>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 353.546 Td +/F1.0 10.5 Tf +[<6772> 20.0195 <616e756c617269747920666f72207374727563747572653a>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +74.954 331.766 Td +/F1.1 10.5 Tf +<23> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +84.24 331.766 Td +/F1.0 10.5 Tf +[<546865207061636b6167652068696572> 20.0195 <61726368> 20.0195 <7920766965772073686f777320746865207472> 20.0195 <61646974696f6e616c2068696572> 20.0195 <61726368> 20.0195 <79206f66207061636b6167652c20636c6173732c20616e64206d656d626572732e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +74.954 309.986 Td +/F1.1 10.5 Tf +<23> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0111 Tw + +BT +84.24 309.986 Td +/F1.0 10.5 Tf +[<54686520696e6865726974616e636520766965772073686f7773207468652068696572> 20.0195 <61726368> 20.0195 <792066726f6d20746f706d6f737420706172656e7420636c6173736573207468726f75676820737562636c6173736573>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +84.24 294.206 Td +/F1.0 10.5 Tf +<746f206d656d626572732e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +74.954 272.426 Td +/F1.1 10.5 Tf +<23> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +84.24 272.426 Td +/F1.0 10.5 Tf +<5468652063726f737363757474696e6720766965772073686f77732074686520617370656374206d656d6265727320616e642074686520636f64652074686579206166666563742e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +74.954 250.646 Td +/F1.1 10.5 Tf +<23> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +84.24 250.646 Td +/F1.0 10.5 Tf +[<41> 20.0195 <64646974696f6e616c20627574746f6e7320696e207468652070616e652063616e206265207573656420746f206368616e676520746865206772> 20.0195 <616e756c617269747920616e642066696c746572206f7574206974656d732e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.3564 Tw + +BT +84.24 222.866 Td +/F1.0 10.5 Tf +[<5768656e6576657220796f752073656c65637420616e206974656d20696e2074686520747265652076696577> 69.8242 <2c2074686520736f757263652070616e65207363726f6c6c7320746f2074686174206974656d2e20496620796f75>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1244 Tw + +BT +84.24 207.086 Td +/F1.0 10.5 Tf +[<73656c6563742061206c656166206974656d20726570726573656e74696e6720616e6f746865722070726f6772> 20.0195 <616d20656c656d656e742c207468656e2074686520747265652073656c656374696f6e2077696c6c20676f20746f>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +84.24 191.306 Td +/F1.0 10.5 Tf +<74686520636f72726573706f6e64696e67206e6f64652e20285365652062656c6f7720666f7220686f7720746f207573652074776f2070616e657320746f206d61696e7461696e20796f757220706c6163652e29> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 163.526 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 163.526 Td +/F1.0 10.5 Tf +[<5768656e20776f726b696e67207769746820617370656374732c2069742068656c707320746f2062652061626c6520746f206e61766967617465206265747765656e20646966666572656e742070726f6772> 20.0195 <616d20656c656d656e74733a>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +74.954 141.746 Td +/F1.1 10.5 Tf +<23> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +84.24 141.746 Td +/F1.0 10.5 Tf +<5768656e206c6f6f6b696e672061742061206d6574686f642c2066696e642074686520616476696365207468617420616666656374732069742e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +74.954 119.966 Td +/F1.1 10.5 Tf +<23> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +84.24 119.966 Td +/F1.0 10.5 Tf +<5768656e206c6f6f6b696e67206174206120706f696e746375742c2066696e642074686520616476696365207468617420757365732069742e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +74.954 98.186 Td +/F1.1 10.5 Tf +<23> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1611 Tw + +BT +84.24 98.186 Td +/F1.0 10.5 Tf +<5768656e206c6f6f6b696e67206174206164766963652c2066696e6420776861742069742061647669736573202d20652e672e2c206d6574686f642063616c6c73206f7220657865637574696f6e732c20696e697469616c697a6572732c> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +84.24 82.406 Td +/F1.0 10.5 Tf +<6574632e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +74.954 60.626 Td +/F1.1 10.5 Tf +<23> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.3755 Tw + +BT +84.24 60.626 Td +/F1.0 10.5 Tf +[<5768656e206c6f6f6b696e67206174206120747970652c2066696e6420616e> 20.0195 <7920617370656374732074686174206465636c617265206d656d62657273206f722073757065727479706573206f662074686520747970652c206f72>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp1 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.978 14.263 Td +/F1.0 9 Tf +<3137> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +100 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 99 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F2.0 22 0 R +/F1.0 8 0 R +/F3.0 26 0 R +/F1.1 47 0 R +>> +/XObject << /Stamp1 360 0 R +>> +>> +>> +endobj +101 0 obj +[100 0 R /XYZ 0 841.89 null] +endobj +102 0 obj +[100 0 R /XYZ 0 667.71 null] +endobj +103 0 obj +<< /Length 14336 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +84.24 794.676 Td +/F1.0 10.5 Tf +<766963652d76657273612e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.3243 Tw + +BT +84.24 766.896 Td +/F1.0 10.5 Tf +[<59> 69.8242 <6f752063616e20766965772074686520616476696365206f6e206120706172746963756c6172206d6574686f64207573696e67207468652064656661756c742c2068696572> 20.0195 <617263686963616c2076696577> 69.8242 <2e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.6636 Tw + +BT +84.24 751.116 Td +/F1.0 10.5 Tf +<4e6176696761746520746f207468652074726565206974656d20666f7220> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +3.6636 Tw + +BT +249.7983 751.116 Td +/F3.0 10.5 Tf +<73706163657761722e52656769737472792e72656769737465722853706163654f626a65637429> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.6636 Tw + +BT +454.5483 751.116 Td +/F1.0 10.5 Tf +<20696e2074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +3.6636 Tw + +BT +499.79 751.116 Td +/F3.0 10.5 Tf +<64656275672e6c7374> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.6636 Tw + +BT +547.04 751.116 Td +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.549 Tw + +BT +84.24 735.336 Td +/F1.0 10.5 Tf +[<636f6e6669672066696c652e204e6f77> 69.8242 <2c20696e20746865206c6f7765722c2066696c652076696577> 69.8242 <2c20796f752063616e2073656520616e64206e6176696761746520746f2074686520616476696365207573696e6720746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +84.24 719.556 Td +/F1.0 10.5 Tf +<737562747265652077686f736520706172656e742069732074686520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +225.0765 719.556 Td +/F3.0 10.5 Tf +<6d6574686f64206166666563746564206279> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +319.5765 719.556 Td +/F1.0 10.5 Tf +<2072656c6174696f6e2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1135 Tw + +BT +84.24 691.776 Td +/F1.0 10.5 Tf +[<59> 69.8242 <6f752063616e20616c736f207573652063726f737363757474696e67207669657720746f207365652074686520616476696365207573696e67206120706f696e74637574206f7220746865206d6574686f6473206166666563746564>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1993 Tw + +BT +84.24 675.996 Td +/F1.0 10.5 Tf +[<62> 20.0195 <79206164766963652e2046> 40.0391 <6f72206578616d706c652c20746f207365652077686174206164766963652075736573206120706172746963756c617220706f696e746375742c206e6176696761746520746f207468652074726565>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.512 Tw + +BT +84.24 660.216 Td +/F1.0 10.5 Tf +<6974656d20666f722074686520706f696e7463757420> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.512 Tw + +BT +196.4221 660.216 Td +/F3.0 10.5 Tf +<73706163657761722e44656275672e616c6c436f6e7374727563746f72734375742829> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.512 Tw + +BT +380.1721 660.216 Td +/F1.0 10.5 Tf +<20696e2074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.512 Tw + +BT +418.9591 660.216 Td +/F3.0 10.5 Tf +<64656275672e6c7374> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.512 Tw + +BT +466.2091 660.216 Td +/F1.0 10.5 Tf +[<20636f6e6669672066696c652e2059> 69.8242 <6f75>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +84.24 644.436 Td +/F1.0 10.5 Tf +<63616e2073656520616e64206e6176696761746520746f2074686520616476696365207468617420757365732074686520706f696e74637574207573696e672074686520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +416.3865 644.436 Td +/F3.0 10.5 Tf +<706f696e746375742075736564206279> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +500.3865 644.436 Td +/F1.0 10.5 Tf +<2072656c6174696f6e2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6792 Tw + +BT +84.24 616.656 Td +/F1.0 10.5 Tf +[<417320616e206578616d706c65206f6620736565696e6720746865206d6574686f64732061666665637465642062> 20.0195 <79206164766963652c207768696c65207374696c6c20696e207468652073616d652076696577> 69.8242 <2c2073656c656374>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.3826 Tw + +BT +84.24 600.876 Td +/F1.0 10.5 Tf +<74686520666972737420> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.3826 Tw + +BT +127.0158 600.876 Td +/F3.0 10.5 Tf +<6265666f7265> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.3826 Tw + +BT +158.5158 600.876 Td +/F1.0 10.5 Tf +<2061647669636520696e20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.3826 Tw + +BT +210.4942 600.876 Td +/F3.0 10.5 Tf +<73706163657761722e4465627567> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.3826 Tw + +BT +283.9942 600.876 Td +/F1.0 10.5 Tf +<2e204974206861732072656c6174696f6e207375622d747265657320666f7220626f746820> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.3826 Tw + +BT +456.1952 600.876 Td +/F3.0 10.5 Tf +<7573657320706f696e74637574> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.3826 Tw + +BT +524.8279 600.876 Td +/F1.0 10.5 Tf +<20616e64> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +4.2605 Tw + +BT +84.24 585.096 Td +/F3.0 10.5 Tf +<6166666563747320636f6e737472756374696f6e73> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +4.2605 Tw + +BT +198.7505 585.096 Td +/F1.0 10.5 Tf +<2e2054686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +4.2605 Tw + +BT +234.0361 585.096 Td +/F3.0 10.5 Tf +<61666665637473> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +4.2605 Tw + +BT +270.7861 585.096 Td +/F1.0 10.5 Tf +<2072656c6174696f6e732077696c6c206c69737420646966666572656e74206b696e6473206f66206a6f696e20706f696e7473202d> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +84.24 569.316 Td +/F1.0 10.5 Tf +<636f6e7374727563746f72206f72206d6574686f642063616c6c732c206574632e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.1991 Tw + +BT +84.24 541.536 Td +/F1.0 10.5 Tf +[<4e6f7465207468617420746865204173706563744a2062726f777365722063616e206f6e6c7920646973706c61> 20.0195 <7920737461746963207374727563747572652028776865746865722068696572> 20.0195 <617263686963616c206f72>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.8338 Tw + +BT +84.24 525.756 Td +/F1.0 10.5 Tf +[<63726f737363757474696e67292e2054686174206d65616e7320746861742064796e616d69636c792d64657465726d696e656420706f696e746375747320286c696b> 20.0195 <6520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.8338 Tw + +BT +441.2037 525.756 Td +/F3.0 10.5 Tf +<63666c6f7728706f696e7463757429> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.8338 Tw + +BT +519.9537 525.756 Td +/F1.0 10.5 Tf +<292077696c6c> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.3812 Tw + +BT +84.24 509.976 Td +/F1.0 10.5 Tf +[<6e6f742062652073686f776e206173207069636b696e67206f75742073746174696320706f696e747320696e20736f7572636520636f64652e20446973706c61> 20.0195 <7961626c6520706f696e746375747320726f7567686c79>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +84.24 494.196 Td +/F1.0 10.5 Tf +<636f72726573706f6e6420746f2074686f736520746861742063616e206265207573656420696e206120> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +291.72 494.196 Td +/F3.0 10.5 Tf +<6465636c617265206572726f72> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +359.97 494.196 Td +/F1.0 10.5 Tf +<2073746174656d656e742e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 448.356 Td +/F2.0 18 Tf +[<332e342e2052756e6e696e672050726f6772> 20.0195 <616d73>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.3594 Tw + +BT +48.24 420.336 Td +/F1.0 10.5 Tf +[<5468652062726f7773657220737570706f7274732061206c696d6974656420666f726d206f662072756e6e696e6720636f6d70696c65642070726f6772> 20.0195 <616d732e2054> 29.7852 <6f2072756e2070726f6772> 20.0195 <616d7320746861742068617665>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.9857 Tw + +BT +48.24 404.556 Td +/F1.0 10.5 Tf +[<6265656e206275696c742c20636c69636b207468652072756e20627574746f6e206f722073656c656374206f6e65206f66207468652072756e206d656e75206974656d7320696e207468652070726f6a656374206d656e752e2059> 69.8242 <6f752063616e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 388.776 Td +/F1.0 10.5 Tf +[<72756e20696e207468652073616d6520564d206f7220737061776e2061206e65772070726f636573733b20746865206c61747465722069732067656e6572> 20.0195 <616c6c792062657474657220666f72204755492070726f6772> 20.0195 <616d732e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.6191 Tw + +BT +48.24 360.996 Td +/F1.0 10.5 Tf +[<426f74682072657175697265207468617420616e> 20.0195 <7920636c6173737061746820796f752073657420626520737065636966696564207573696e6720706c6174666f726d2d737065636966696320706174687320616e642070617468>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1322 Tw + +BT +48.24 345.216 Td +/F1.0 10.5 Tf +[<7365706172> 20.0195 <61746f7273202874686520636f6d70696c6572206d69676874206265206d6f726520746f6c6572> 20.0195 <616e74292e204f757470757420616e64206572726f722073747265616d732077696c6c206265206d657267656420696e746f20746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2046 Tw + +BT +48.24 329.436 Td +/F1.0 10.5 Tf +[<73747265616d73206f66207468652062726f7773657220287573696e67207365706172> 20.0195 <61746520746872656164732c20736f206974206d61> 20.0195 <792074616b> 20.0195 <65206120666577207365636f6e647320666f72207468652070697065207468726561647320746f>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 313.656 Td +/F1.0 10.5 Tf +[<6761696e20636f6e74726f6c2e29204572726f72732073686f756c6420626520646574656374656420616e6420646973706c61> 20.0195 <79656420696e2061206469616c6f672e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.0501 Tw + +BT +48.24 285.876 Td +/F1.0 10.5 Tf +[<5468652047554920646f6573206e6f7420737570706f7274206b696c6c696e6720612072756e6e696e672070726f6772> 20.0195 <616d2c20736f20696620796f75722070726f6772> 20.0195 <616d206d696768742068616e672c206265207375726520746f2073617665>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 270.096 Td +/F1.0 10.5 Tf +[<796f75722066696c65732073696e636520796f75206d61> 20.0195 <79206e65656420746f206b696c6c207468652062726f7773657220697473656c6620746f206b696c6c20697473206368696c642070726f6365737365732e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 230.256 Td +/F2.0 18 Tf +<332e352e2049736f6c6174696e672070726f626c656d732072756e6e696e6720746865204173706563744a2062726f77736572> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2234 Tw + +BT +48.24 202.236 Td +/F1.0 10.5 Tf +[<496620796f7520686176652070726f626c656d732077697468207468652062726f77736572206e6f7420736f6c7665642062> 20.0195 <792074686520646f63756d656e746174696f6e2c20706c656173652074727920746f2073656520696620796f75>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 186.456 Td +/F1.0 10.5 Tf +<68617665207468652073616d652070726f626c656d73207768656e2072756e6e696e6720616a63206469726563746c79206f6e2074686520636f6d6d616e64206c696e652e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 158.676 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1689 Tw + +BT +66.24 158.676 Td +/F1.0 10.5 Tf +[<4966207468652070726f626c656d206f6363757273206f6e2074686520636f6d6d616e64206c696e6520616c736f2c207468656e207468652070726f626c656d206973206e6f7420696e207468652062726f777365722e20284974206d61> 20.0195 <79>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 142.896 Td +/F1.0 10.5 Tf +<626520696e2074686520636f6d70696c65723b20706c656173652073656e6420627567207265706f7274732e29> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 121.116 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.8508 Tw + +BT +66.24 121.116 Td +/F1.0 10.5 Tf +[<4966207468652070726f626c656d20646f6573206e6f74206f63637572206f6e2074686520636f6d6d616e64206c696e652c207468656e206974206d61> 20.0195 <79206c696520696e2074686520706172> 20.0195 <616d657465727320796f7520617265>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 105.336 Td +/F1.0 10.5 Tf +<737570706c79696e6720696e20746865206275696c64206f7074696f6e732e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 83.556 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5554 Tw + +BT +66.24 83.556 Td +/F1.0 10.5 Tf +<496620746865206275696c64206f7074696f6e73206c6f6f6b20636f727265637420616e64207468652070726f626c656d206f6e6c79206f6363757273207768656e206275696c64696e672066726f6d207468652062726f777365722c> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 67.776 Td +/F1.0 10.5 Tf +<7468656e20706c65617365207375626d6974206120627567207265706f72742e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp2 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +49.24 14.263 Td +/F1.0 9 Tf +<3138> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +104 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 103 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F1.0 8 0 R +/F3.0 26 0 R +/F2.0 22 0 R +>> +/XObject << /Stamp2 361 0 R +>> +>> +>> +endobj +105 0 obj +[104 0 R /XYZ 0 472.38 null] +endobj +106 0 obj +[104 0 R /XYZ 0 254.28 null] +endobj +107 0 obj +<< /Length 7488 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +48.24 792.006 Td +/F2.0 13 Tf +<332e352e312e204b6e6f776e20697373756573207769746820746865204173706563744a2062726f77736572> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.3551 Tw + +BT +48.24 765.446 Td +/F1.0 10.5 Tf +[<46> 40.0391 <6f7220746865206d6f73742075702d746f2d6461746520696e666f726d6174696f6e206f6e206b6e6f776e2070726f626c656d732c207365652074686520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +2.3551 Tw + +BT +397.3953 765.446 Td +/F1.0 10.5 Tf +<627567206461746162617365> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.3551 Tw + +BT +465.8374 765.446 Td +/F1.0 10.5 Tf +<20666f7220756e7265736f6c766564> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +48.24 749.666 Td +/F1.0 10.5 Tf +<636f6d70696c65722062756773> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +119.178 749.666 Td +/F1.0 10.5 Tf +<206f7220> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +135.621 749.666 Td +/F1.0 10.5 Tf +<4944452062756773> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +179.847 749.666 Td +/F1.0 10.5 Tf +<202e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 721.886 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.7534 Tw + +BT +66.24 721.886 Td +/F1.0 10.5 Tf +[<4d656d6f727920616e6420666f726b696e673a20557365727320656d61696c206d6f73742061626f7574207468652062726f77736572207461736b2072756e6e696e67206f7574206f66206d656d6f7279> 89.8438 <2e2054686973206973>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.7995 Tw + +BT +66.24 706.106 Td +/F1.0 10.5 Tf +[<6e6f7420612070726f626c656d2077697468207468652062726f777365723b20736f6d6520636f6d70696c65732074616b> 20.0195 <652061206c6f74206f66206d656d6f7279> 89.8438 <2c206f6674656e206d6f7265207468616e2073696d696c6172>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0182 Tw + +BT +66.24 690.326 Td +/F1.0 10.5 Tf +<636f6d70696c6573207573696e67206a617661632e205468652062726f7773657220646f6573206e6f7420737570706f727420666f726b696e672c20736f20746865206f6e6c7920736f6c7574696f6e20697320746f206564697420746865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 674.546 Td +/F1.0 10.5 Tf +[<6a61766120636f6d6d616e64206c696e65206f72207363726970742074686174206c61756e63686573207468652062726f7773657220746f20616464206d656d6f7279> 89.8438 <2e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 652.766 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 652.766 Td +/F1.0 10.5 Tf +[<45646974696e67206275696c6420636f6e6669677572> 20.0195 <6174696f6e2066696c65733a2074686973206973206e6f742063757272656e746c7920737570706f727465642e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 630.986 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.5832 Tw + +BT +66.24 630.986 Td +/F1.0 10.5 Tf +[<54686520737472756374757265206d6f64656c20697320696e636f6d706c65746520616674657220696e6372656d656e74616c20636f6d70696c65732e2054> 29.7852 <6f20676574206120636f6d706c65746520737472756374757265>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 615.206 Td +/F1.0 10.5 Tf +<6d6f64656c20726571756972657320612066756c6c206275696c642e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 593.426 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 593.426 Td +/F1.0 10.5 Tf +[<496620796f75206368616e676520746865206f7574707574206469726563746f7279> 89.8438 <2c20796f75206d75737420646f20612066756c6c206275696c642e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 558.926 Td +/F2.0 13 Tf +<332e352e322e204c696d69746174696f6e73> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 532.366 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2137 Tw + +BT +66.24 532.366 Td +/F1.0 10.5 Tf +<54686520414a42726f77736572206578706563747320746865207061636b61676520616e64206469726563746f72792073747275637475726520746f206d617463682e204966207468657920646f206e6f742069742077696c6c206265> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 516.586 Td +/F1.0 10.5 Tf +<756e61626c6520746f2062726f77736520746f2074686520636f72726573706f6e64696e672066696c652e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 494.806 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1683 Tw + +BT +66.24 494.806 Td +/F1.0 10.5 Tf +[<546865202252756e> 40.0391 <222066656174757265206c61756e63686573206170706c69636174696f6e7320696e207468652073616d6520564d2e204173206120726573756c742c20696620612053> 9.7656 <77696e67206170706c69636174696f6e206973>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 479.026 Td +/F1.0 10.5 Tf +<646973706f7365642074686520414a42726f777365722077696c6c20626520646973706f7365642061732077656c6c2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 444.526 Td +/F2.0 13 Tf +<332e352e332e204173706563744a2042726f77736572207175657374696f6e7320616e642062756773> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.1043 Tw + +BT +48.24 417.966 Td +/F1.0 10.5 Tf +[<59> 69.8242 <6f752063616e2073656e6420656d61696c20746f20>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +3.1043 Tw + +BT +175.095 417.966 Td +/F1.0 10.5 Tf +[<6173706563746a2d757365727340646576> 69.8242 <2e65636c697073652e6f7267>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.1043 Tw + +BT +322.8739 417.966 Td +/F1.0 10.5 Tf +[<2e2028446f206a6f696e20746865206c69737420746f20706172746963697061746521292057> 60.0586 <6520616c736f>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6144 Tw + +BT +48.24 402.186 Td +/F1.0 10.5 Tf +[<77656c636f6d6520616e> 20.0195 <7920627567207265706f7274732c20706174636865732c20616e6420666561747572652072657175657374733b20796f752063616e207375626d6974207468656d20746f2074686520627567206461746162617365>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 386.406 Td +/F1.0 10.5 Tf +<617420> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +60.5565 386.406 Td +/F1.0 10.5 Tf +<687474703a2f2f627567732e65636c697073652e6f72672f62756773> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +196.1535 386.406 Td +/F1.0 10.5 Tf +<207573696e6720746865204173706563744a2070726f6475637420616e642049444520636f6d706f6e656e742e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp1 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.978 14.263 Td +/F1.0 9 Tf +<3139> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +108 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 107 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F2.0 22 0 R +/F1.0 8 0 R +>> +/XObject << /Stamp1 360 0 R +>> +>> +/Annots [110 0 R 111 0 R 112 0 R 115 0 R 116 0 R] +>> +endobj +109 0 obj +[108 0 R /XYZ 0 841.89 null] +endobj +110 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (http://bugs.eclipse.org/bugs) +>> +/Subtype /Link +/Rect [397.3953 762.38 465.8374 776.66] +/Type /Annot +>> +endobj +111 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (http://bugs.eclipse.org/bugs/buglist.cgi?&product=AspectJ&component=Compiler&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED) +>> +/Subtype /Link +/Rect [48.24 746.6 119.178 760.88] +/Type /Annot +>> +endobj +112 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (http://bugs.eclipse.org/bugs/buglist.cgi?&product=AspectJ&component=IDE&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED) +>> +/Subtype /Link +/Rect [135.621 746.6 179.847 760.88] +/Type /Annot +>> +endobj +113 0 obj +[108 0 R /XYZ 0 577.61 null] +endobj +114 0 obj +[108 0 R /XYZ 0 463.21 null] +endobj +115 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (mailto:aspectj-users@dev.eclipse.org) +>> +/Subtype /Link +/Rect [175.095 414.9 322.8739 429.18] +/Type /Annot +>> +endobj +116 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (http://bugs.eclipse.org/bugs) +>> +/Subtype /Link +/Rect [60.5565 383.34 196.1535 397.62] +/Type /Annot +>> +endobj +117 0 obj +<< /Length 11469 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +48.24 782.394 Td +/F2.0 22 Tf +[<4368617074657220342e204173706563744a20416e742054> 29.7852 <61736b73>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 741.146 Td +/F2.0 18 Tf +<342e312e20496e74726f64756374696f6e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1422 Tw + +BT +48.24 713.126 Td +/F1.0 10.5 Tf +<4173706563744a20636f6e7461696e73206120636f6d70696c65722c20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.1422 Tw + +BT +192.197 713.126 Td +/F3.0 10.5 Tf +<616a63> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1422 Tw + +BT +207.947 713.126 Td +/F1.0 10.5 Tf +<2c20746861742063616e2062652072756e2066726f6d20416e742e20496e636c7564656420696e2074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.1422 Tw + +BT +422.9815 713.126 Td +/F3.0 10.5 Tf +<6173706563746a746f6f6c732e6a6172> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1422 Tw + +BT +506.9815 713.126 Td +/F1.0 10.5 Tf +<2061726520416e74> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 697.346 Td +/F1.0 10.5 Tf +[<62696e617269657320746f20737570706f7274207468726565207761> 20.0195 <7973206f662072756e6e696e672074686520636f6d70696c65723a>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +52.6765 669.566 Td +/F1.0 10.5 Tf +<312e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4773 Tw + +BT +66.24 669.566 Td +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +0.4773 Tw + +BT +66.24 669.566 Td +/F1.0 10.5 Tf +[<416a6354> 29.7852 <61736b202869616a6329>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4773 Tw + +BT +132.8485 669.566 Td +/F1.0 10.5 Tf +<2c2061207461736b20746f2072756e20746865204173706563744a20706f73742d312e3120636f6d70696c65722c20776869636820737570706f72747320616c6c207468652065636c6970736520616e6420616a63> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 653.786 Td +/F1.0 10.5 Tf +<6f7074696f6e732c20696e636c7564696e6720696e6372656d656e74616c206d6f64652e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +52.6765 632.006 Td +/F1.0 10.5 Tf +<322e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.4397 Tw + +BT +66.24 632.006 Td +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +1.4397 Tw + +BT +66.24 632.006 Td +/F1.0 10.5 Tf +[<416a633131436f6d70696c657241> 20.0195 <64617074657220286a6176616329>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.4397 Tw + +BT +217.5355 632.006 Td +/F1.0 10.5 Tf +[<2c20616e206164617074657220636c61737320746f2072756e20746865206e657720636f6d70696c6572207573696e67204a61766163207461736b732062> 20.0195 <79>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 616.226 Td +/F1.0 10.5 Tf +<73657474696e6720746865206275696c642e636f6d70696c65722070726f7065727479> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +52.6765 594.446 Td +/F1.0 10.5 Tf +<332e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 594.446 Td +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +66.24 594.446 Td +/F1.0 10.5 Tf +<416a6331302028616a6329> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +117.879 594.446 Td +/F1.0 10.5 Tf +<2c2061207461736b20746f2072756e206275696c64207363726970747320636f6d70617469626c65207769746820746865204173706563744a20312e30207461736b73> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.8182 Tw + +BT +48.24 566.666 Td +/F1.0 10.5 Tf +[<546869732064657363726962657320686f7720746f20696e7374616c6c20616e642075736520746865207461736b7320616e642074686520616461707465722e2046> 40.0391 <6f7220616e206578616d706c6520416e74207363726970742c20736565>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +48.24 550.886 Td +/F1.0 10.5 Tf +<6578616d706c65732f6275696c642e786d6c> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +146.8035 550.886 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 511.046 Td +/F2.0 18 Tf +[<342e322e20496e7374616c6c696e6720416e742054> 29.7852 <61736b73>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2395 Tw + +BT +48.24 483.026 Td +/F1.0 10.5 Tf +<496e7374616c6c204a616b6172746120416e7420312e352e313a20506c656173652073656520746865206f6666696369616c204a616b6172746120416e74207765627369746520666f72206d6f726520696e666f726d6174696f6e20616e6420746865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0498 Tw + +BT +48.24 467.246 Td +/F1.0 10.5 Tf +<312e352e3120646973747269627574696f6e2e20546869732072656c6561736520697320736f757263652d636f6d70617469626c65207769746820416e7420312e3320616e6420416e7420312e342c2062757420746865207461736b20736f7572636573> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.9535 Tw + +BT +48.24 451.466 Td +/F1.0 10.5 Tf +[<6d75737420626520636f6d70696c656420776974682074686f73652076657273696f6e73206f662074686520416e74206c696272> 20.0195 <617269657320746f206265207573656420756e6465722074686f73652076657273696f6e73206f6620416e742e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 435.686 Td +/F1.0 10.5 Tf +<536f75726365732061726520617661696c61626c6520756e646572207468652045636c69707365205075626c6963204c6963656e7365207620322e3020617420> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +359.7435 435.686 Td +/F1.0 10.5 Tf +<687474703a2f2f65636c697073652e6f72672f6173706563746a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +480.4515 435.686 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.3627 Tw + +BT +48.24 407.906 Td +/F1.0 10.5 Tf +[<496e20416e7420312e352c2074686972642d7061727479207461736b732063616e206265206465636c61726564207573696e672061207461736b> 20.0195 <64656620656e74727920696e20746865206275696c64207363726970742c20746f206964656e7469667920746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.3744 Tw + +BT +48.24 392.126 Td +/F1.0 10.5 Tf +<6e616d6520616e6420636c61737365732e205768656e206465636c6172696e672061207461736b2c20696e636c7564652074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +3.3744 Tw + +BT +346.5063 392.126 Td +/F3.0 10.5 Tf +<6173706563746a746f6f6c732e6a6172> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.3744 Tw + +BT +430.5063 392.126 Td +/F1.0 10.5 Tf +[<2065697468657220696e20746865207461736b> 20.0195 <646566>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1094 Tw + +BT +48.24 376.346 Td +/F1.0 10.5 Tf +<636c61737370617468206f7220696e20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.1094 Tw + +BT +124.3363 376.346 Td +/F3.0 10.5 Tf +<247b414e545f484f4d457d2f6c6962> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1094 Tw + +BT +203.0863 376.346 Td +/F1.0 10.5 Tf +[<2077686572652069742077696c6c20626520616464656420746f207468652073797374656d20636c61737320706174682062> 20.0195 <792074686520616e74207363726970742e2059> 69.8242 <6f75>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.8036 Tw + +BT +48.24 360.566 Td +/F1.0 10.5 Tf +[<6d61> 20.0195 <79207370656369667920746865207461736b20736372697074206e616d6573206469726563746c79> 89.8438 <2c206f72207573652074686520227265736f75726365222061747472696275746520746f2073706563696679207468652064656661756c74>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 344.786 Td +/F1.0 10.5 Tf +<6e616d65733a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 328.97 m +543.04 328.97 l +545.2491 328.97 547.04 327.1791 547.04 324.97 c +547.04 296.23 l +547.04 294.0209 545.2491 292.23 543.04 292.23 c +52.24 292.23 l +50.0309 292.23 48.24 294.0209 48.24 296.23 c +48.24 324.97 l +48.24 327.1791 50.0309 328.97 52.24 328.97 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 328.97 m +543.04 328.97 l +545.2491 328.97 547.04 327.1791 547.04 324.97 c +547.04 296.23 l +547.04 294.0209 545.2491 292.23 543.04 292.23 c +52.24 292.23 l +50.0309 292.23 48.24 294.0209 48.24 296.23 c +48.24 324.97 l +48.24 327.1791 50.0309 328.97 52.24 328.97 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 306.145 Td +/F3.0 11 Tf +<3c7461736b646566207265736f757263653d226f72672f6173706563746a2f746f6f6c732f616e742f7461736b646566732f6173706563746a5461736b646566732e70726f70657274696573222f3e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0739 Tw + +BT +48.24 268.266 Td +/F1.0 10.5 Tf +<5468652063757272656e74207265736f757263652066696c652072657461696e7320746865206e616d652022616a632220666f722074686520416a633130207461736b2c20616e642075736573202269616a632220666f7220746865204173706563744a> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 252.486 Td +/F1.0 10.5 Tf +<706f73742d312e31207461736b2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2966 Tw + +BT +48.24 224.706 Td +/F1.0 10.5 Tf +<496e20416e7420312e362c2074686972642d7061727479207461736b7320617265206465636c6172656420696e207468656972206f776e206e616d657370616365207573696e6720> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.2966 Tw + +BT +421.6812 224.706 Td +/F3.0 10.5 Tf +<616e746c69622e786d6c> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2966 Tw + +BT +474.1812 224.706 Td +/F1.0 10.5 Tf +[<2e2046> 40.0391 <6f72206578616d706c652c>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.9011 Tw + +BT +48.24 208.926 Td +/F1.0 10.5 Tf +<74686520666f6c6c6f77696e672073637269707420776f756c64206275696c6420616e642072756e20746865207370616365776172206578616d706c652c20696620796f7520707574207468652073637269707420696e20746865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 193.146 Td +/F1.0 10.5 Tf +<6578616d706c6573206469726563746f727920616e6420> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +169.1895 193.146 Td +/F3.0 10.5 Tf +<6173706563746a746f6f6c732e6a6172> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +253.1895 193.146 Td +/F1.0 10.5 Tf +<20696e2074686520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +287.4405 193.146 Td +/F3.0 10.5 Tf +<247b414e545f484f4d457d2f6c6962> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +366.1905 193.146 Td +/F1.0 10.5 Tf +[<206469726563746f7279> 89.8438 <2e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp2 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +49.24 14.263 Td +/F1.0 9 Tf +<3230> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +118 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 117 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F2.0 22 0 R +/F1.0 8 0 R +/F3.0 26 0 R +>> +/XObject << /Stamp2 361 0 R +>> +>> +/Annots [122 0 R 123 0 R 124 0 R 125 0 R 127 0 R] +>> +endobj +119 0 obj +[118 0 R /XYZ 0 841.89 null] +endobj +120 0 obj +<< /Limits [(ajbrowser-navigating) (antTasks-iajc-options)] +/Names [(ajbrowser-navigating) 101 0 R (ajbrowser-problems) 106 0 R (ajbrowser-running) 105 0 R (ajc) 41 0 R (ajc_options) 44 0 R (antTasks) 119 0 R (antTasks-adapter) 168 0 R (antTasks-adapter-options) 173 0 R (antTasks-adapter-sample) 169 0 R (antTasks-ajc) 178 0 R (antTasks-ajc-nested) 186 0 R (antTasks-ajc-options) 181 0 R (antTasks-ajc-sample) 189 0 R (antTasks-feedback) 199 0 R (antTasks-iajc) 130 0 R (antTasks-iajc-options) 133 0 R] +>> +endobj +121 0 obj +[118 0 R /XYZ 0 765.17 null] +endobj +122 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#antTasks-iajc) +>> +/Subtype /Link +/Rect [66.24 666.5 132.8485 680.78] +/Type /Annot +>> +endobj +123 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#antTasks-adapter) +>> +/Subtype /Link +/Rect [66.24 628.94 217.5355 643.22] +/Type /Annot +>> +endobj +124 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#antTasks-ajc) +>> +/Subtype /Link +/Rect [66.24 591.38 117.879 605.66] +/Type /Annot +>> +endobj +125 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (../examples/build.xml) +>> +/Subtype /Link +/Rect [48.24 547.82 146.8035 562.1] +/Type /Annot +>> +endobj +126 0 obj +[118 0 R /XYZ 0 535.07 null] +endobj +127 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (http://eclipse.org/aspectj) +>> +/Subtype /Link +/Rect [359.7435 432.62 480.4515 446.9] +/Type /Annot +>> +endobj +128 0 obj +<< /Length 12405 +>> +stream +q +q +/DeviceRGB cs +0.9608 0.9608 0.9608 scn +52.24 805.89 m +543.04 805.89 l +545.2491 805.89 547.04 804.0991 547.04 801.89 c +547.04 611.01 l +547.04 608.8009 545.2491 607.01 543.04 607.01 c +52.24 607.01 l +50.0309 607.01 48.24 608.8009 48.24 611.01 c +48.24 801.89 l +48.24 804.0991 50.0309 805.89 52.24 805.89 c +h +f +/DeviceRGB CS +0.8 0.8 0.8 SCN +0.75 w +52.24 805.89 m +543.04 805.89 l +545.2491 805.89 547.04 804.0991 547.04 801.89 c +547.04 611.01 l +547.04 608.8009 545.2491 607.01 543.04 607.01 c +52.24 607.01 l +50.0309 607.01 48.24 608.8009 48.24 611.01 c +48.24 801.89 l +48.24 804.0991 50.0309 805.89 52.24 805.89 c +h +S +Q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +59.24 783.065 Td +/F3.0 11 Tf +<3c70726f6a656374206e616d653d226173706563746a2d616e74312e36222064656661756c743d22737061636577617222> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 768.325 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 753.585 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 738.845 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 724.105 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 709.365 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 694.625 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 679.885 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 665.145 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 650.405 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 635.665 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 620.925 Td +/F3.0 11 Tf +<3c2f70726f6a6563743e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.5191 Tw + +BT +48.24 583.046 Td +/F1.0 10.5 Tf +[<46> 40.0391 <6f72206d6f726520696e666f726d6174696f6e206f6e207573696e6720416e742c20706c6561736520726566657220746f204a616b61727461d57320646f63756d656e746174696f6e206f6e20696e74656772> 20.0195 <6174696e6720757365722d>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 567.266 Td +/F1.0 10.5 Tf +<646566696e656420416e74207461736b7320696e746f206275696c64732e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 527.426 Td +/F2.0 18 Tf +[<342e332e20416a6354> 29.7852 <61736b202869616a6329>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.9233 Tw + +BT +48.24 499.406 Td +/F1.0 10.5 Tf +[<54686973207461736b207573657320746865204173706563744a20706f73742d312e3120636f6d70696c657220616a632e20546865204173706563744a20636f6d70696c65722063616e2062652075736564206c696b> 20.0195 <65204a6176616320746f>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.5125 Tw + +BT +48.24 483.626 Td +/F1.0 10.5 Tf +<636f6d70696c65204a61766120736f75726365732c206275742069742063616e20616c736f20636f6d70696c65204173706563744a20736f7572636573206f722077656176652062696e61727920617370656374732077697468204a617661> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1948 Tw + +BT +48.24 467.846 Td +/F1.0 10.5 Tf +[<62> 20.0195 <797465636f64652e2049742063616e2072756e20696e206e6f726d616c20226261746368> 40.0391 <22206d6f6465206f7220696e20616e2022696e6372656d656e74616c22206d6f64652c207768657265206974206f6e6c79207265636f6d70696c6573>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.9173 Tw + +BT +48.24 452.066 Td +/F1.0 10.5 Tf +[<66696c65732069742068617320746f20726576697369742e2046> 40.0391 <6f72206d6f726520696e666f726d6174696f6e206f6e20616a632c2073656520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +0.9173 Tw + +BT +327.1926 452.066 Td +/F1.0 10.5 Tf +<3f3f3f> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.9173 Tw + +BT +342.9426 452.066 Td +/F1.0 10.5 Tf +[<2e20556e6c696b> 20.0195 <65204a61766163206f7220746865204a6176616320416e74207461736b2c2074686973>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.5374 Tw + +BT +48.24 436.286 Td +/F1.0 10.5 Tf +[<7461736b20616c7761> 20.0195 <797320636f6d70696c657320746865207370656369666965642066696c65732073696e636520617370656374732063616e206170706c7920746f206f74686572202875706461746564292066696c65732e2046> 40.0391 <6f722061>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 420.506 Td +/F1.0 10.5 Tf +<776f726b61726f756e642c2073656520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +135.222 420.506 Td +/F1.0 10.5 Tf +[<41> 60.0586 <766f6964696e6720636c65616e20636f6d70696c6573>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +256.3704 420.506 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.0878 Tw + +BT +48.24 392.726 Td +/F1.0 10.5 Tf +<4265796f6e6420746865206e6f726d616c20616a6320636f6d70696c6572206f7074696f6e732c2074686973207461736b20616c736f20737570706f72747320616e206578706572696d656e74616c206f7074696f6e20666f7220616e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5281 Tw + +BT +48.24 376.946 Td +/F1.0 10.5 Tf +[<696e6372656d656e74616c2022746167222066696c652c20616e642069742063616e20636f70> 20.0195 <79207265736f75726365732066726f6d20736f75726365206469726563746f72696573206f7220696e707574206a61727320746f20746865206f7574707574>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 361.166 Td +/F1.0 10.5 Tf +[<6a6172206f72206469726563746f7279> 89.8438 <2e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 333.386 Td +/F1.0 10.5 Tf +<54686973207461736b206973206e616d65642069616a6320746f2061766f696420636f6e666c69637420776974682074686520312e30207461736b20616a632e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 298.886 Td +/F2.0 13 Tf +[<342e332e312e20416a6354> 29.7852 <61736b202869616a6329204f7074696f6e73>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.7111 Tw + +BT +48.24 272.326 Td +/F1.0 10.5 Tf +[<54686520666f6c6c6f77696e67207461626c6573206c6973742074686520737570706f7274656420706172> 20.0195 <616d65746572732e2046> 40.0391 <6f7220616e> 20.0195 <7920706172> 20.0195 <616d6574657220737065636966696564206173206120506174682c20612073696e676c65>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.8334 Tw + +BT +48.24 256.546 Td +/F1.0 10.5 Tf +<706174682063616e20626520737065636966696564206469726563746c7920617320616e206174747269627574652c206d756c7469706c652070617468732063616e20626520737065636966696564207573696e672061206e6573746564> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1822 Tw + +BT +48.24 240.766 Td +/F1.0 10.5 Tf +[<656c656d656e74206f66207468652073616d65206e616d652c20616e64206120636f6d6d6f6e20706174682063616e206265207265757365642062> 20.0195 <7920646566696e696e67206974206173206120676c6f62616c20616e642070617373696e67>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 224.986 Td +/F1.0 10.5 Tf +<74686520696420746f2074686520636f72726573706f6e64696e67207b6e616d657d726566206174747269627574652e2053656520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +309.606 224.986 Td +/F1.0 10.5 Tf +<50617468> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +332.202 224.986 Td +/F1.0 10.5 Tf +<2062656c6f7720666f72206d6f72652064657461696c732e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0371 Tw + +BT +48.24 197.206 Td +/F1.0 10.5 Tf +<4d6f7374206174747269627574657320616e64206e657374656420656c656d656e747320617265206f7074696f6e616c2e2054686520636f6d70696c65722072657175697265732074686174207468652073616d652076657273696f6e206f66> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.5314 Tw + +BT +48.24 181.426 Td +/F3.0 10.5 Tf +<6173706563746a72742e6a6172> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.5314 Tw + +BT +116.49 181.426 Td +/F1.0 10.5 Tf +<20626520737065636966696564206f6e2074686520636c617373706174682c20616e64207468617420736f6d6520736f75726365732062652062652073706563696669656420287573696e67206f6e65206f72> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0489 Tw + +BT +48.24 165.646 Td +/F1.0 10.5 Tf +<6d6f7265206f6620> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.0489 Tw + +BT +92.2433 165.646 Td +/F3.0 10.5 Tf +<736f75726365726f6f7473> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0489 Tw + +BT +149.9933 165.646 Td +/F1.0 10.5 Tf +<2c20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.0489 Tw + +BT +156.3867 165.646 Td +/F3.0 10.5 Tf +<696e6a617273> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0489 Tw + +BT +187.8868 165.646 Td +/F1.0 10.5 Tf +<2c20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.0489 Tw + +BT +194.2802 165.646 Td +/F3.0 10.5 Tf +<696e70617468> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0489 Tw + +BT +225.7802 165.646 Td +/F1.0 10.5 Tf +<2c20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.0489 Tw + +BT +232.1736 165.646 Td +/F3.0 10.5 Tf +<61726766696c6573> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0489 Tw + +BT +274.1736 165.646 Td +/F1.0 10.5 Tf +<2c20616e642f6f7220> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.0489 Tw + +BT +317.4734 165.646 Td +/F3.0 10.5 Tf +<737263646972> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0489 Tw + +BT +348.9734 165.646 Td +/F1.0 10.5 Tf +<202877697468207061747465726e7329292e205768656e20696e20696e6372656d656e74616c> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 149.866 Td +/F1.0 10.5 Tf +<6d6f64652c206f6e6c7920> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +106.3365 149.866 Td +/F3.0 10.5 Tf +<736f75726365726f6f7473> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +164.0865 149.866 Td +/F1.0 10.5 Tf +[<206d61> 20.0195 <79206265207370656369666965642e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 122.086 Td +/F1.0 10.5 Tf +[<426f6f6c65616e20706172> 20.0195 <616d65746572732064656661756c7420746f20>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +202.3273 122.086 Td +/F3.0 10.5 Tf +<66616c7365> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +228.5773 122.086 Td +/F1.0 10.5 Tf +<20756e6c657373206f7468657277697365207374617465642e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 94.306 Td +/F2.0 10.5 Tf +[<416a6354> 29.7852 <61736b202869616a6329206f7074696f6e7320666f722073706563696679696e6720736f7572636573>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp1 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.978 14.263 Td +/F1.0 9 Tf +<3231> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +129 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 128 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F3.0 26 0 R +/F1.0 8 0 R +/F2.0 22 0 R +>> +/XObject << /Stamp1 360 0 R +>> +>> +/Annots [131 0 R 132 0 R 134 0 R] +>> +endobj +130 0 obj +[129 0 R /XYZ 0 551.45 null] +endobj +131 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#ajc-ref) +>> +/Subtype /Link +/Rect [327.1926 449 342.9426 463.28] +/Type /Annot +>> +endobj +132 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#antTasks-iajc-uptodate) +>> +/Subtype /Link +/Rect [135.222 417.44 256.3704 431.72] +/Type /Annot +>> +endobj +133 0 obj +[129 0 R /XYZ 0 317.57 null] +endobj +134 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#antTasks-iajc-paths) +>> +/Subtype /Link +/Rect [309.606 221.92 332.202 236.2] +/Type /Annot +>> +endobj +135 0 obj +<< /Length 19522 +>> +stream +q +/DeviceRGB cs +1.0 1.0 1.0 scn +48.24 784.11 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 784.11 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 714.99 249.4 69.12 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 714.99 249.4 69.12 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 677.43 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 677.43 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 576.75 249.4 100.68 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 576.75 249.4 100.68 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 539.19 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 539.19 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 501.63 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 501.63 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 448.29 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 448.29 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 394.95 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 394.95 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 341.61 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 341.61 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 256.71 249.4 84.9 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 256.71 249.4 84.9 re +f +0.0 0.0 0.0 scn +0.5 w +/DeviceRGB CS +0.8667 0.8667 0.8667 SCN +48.24 805.89 m +297.64 805.89 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +48.24 784.11 m +297.64 784.11 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 806.14 m +48.24 783.485 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 806.14 m +297.64 783.485 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 790.926 Td +/F2.0 10.5 Tf +<417474726962757465> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 805.89 m +547.04 805.89 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +297.64 784.11 m +547.04 784.11 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 806.14 m +297.64 783.485 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 806.14 m +547.04 783.485 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 790.926 Td +/F2.0 10.5 Tf +<4465736372697074696f6e> Tj +ET + +0.0 0.0 0.0 scn +1.25 w +0.8667 0.8667 0.8667 SCN +48.24 784.11 m +297.64 784.11 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 714.99 m +297.64 714.99 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 784.735 m +48.24 714.74 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 784.735 m +297.64 714.74 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 769.146 Td +/F1.0 10.5 Tf +<61726766696c65732c2061726766696c65735265662028> Tj +ET + +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +153.9615 769.146 Td +/F1.0 10.5 Tf +<50617468> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +176.5575 769.146 Td +/F1.0 10.5 Tf +<29> Tj +ET + +0.0 0.0 0.0 scn +1.25 w +0.8667 0.8667 0.8667 SCN +297.64 784.11 m +547.04 784.11 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 714.99 m +547.04 714.99 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 784.735 m +297.64 714.74 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 784.735 m +547.04 714.74 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 769.146 Td +/F1.0 10.5 Tf +<416e20617267756d656e742066696c6520636f6e7461696e732061206c697374206f6620617267756d656e7473> Tj +ET + + +BT +300.64 753.366 Td +/F1.0 10.5 Tf +[<726561642062> 20.0195 <792074686520636f6d70696c65722e2045616368206c696e65206973207265616420696e746f206f6e65>] TJ +ET + + +BT +300.64 737.586 Td +/F1.0 10.5 Tf +[<656c656d656e74206f662074686520617267756d656e7420617272> 20.0195 <61> 20.0195 <7920616e64206d61> 20.0195 <7920696e636c756465>] TJ +ET + + +BT +300.64 721.806 Td +/F1.0 10.5 Tf +[<616e6f746865722061726766696c652062> 20.0195 <79207265666572656e63652e>] TJ +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 714.99 m +297.64 714.99 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 677.43 m +297.64 677.43 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 715.24 m +48.24 677.18 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 715.24 m +297.64 677.18 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 700.026 Td +/F1.0 10.5 Tf +<736f75726365526f6f74732c20736f75726365526f6f74735265662028> Tj +ET + +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +200.5185 700.026 Td +/F1.0 10.5 Tf +<50617468> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +223.1145 700.026 Td +/F1.0 10.5 Tf +<29> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 714.99 m +547.04 714.99 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 677.43 m +547.04 677.43 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 715.24 m +297.64 677.18 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 715.24 m +547.04 677.18 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 700.026 Td +/F1.0 10.5 Tf +<4469726563746f7269657320636f6e7461696e696e6720736f757263652066696c65732028656e64696e672077697468> Tj +ET + + +BT +300.64 684.246 Td +/F1.0 10.5 Tf +<2e6a617661206f72202e616a2920746f20636f6d70696c652e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 677.43 m +297.64 677.43 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 576.75 m +297.64 576.75 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 677.68 m +48.24 576.5 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 677.68 m +297.64 576.5 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 662.466 Td +/F1.0 10.5 Tf +<7372636469722028> Tj +ET + +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +87.171 662.466 Td +/F1.0 10.5 Tf +<50617468> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +109.767 662.466 Td +/F1.0 10.5 Tf +<29> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 677.43 m +547.04 677.43 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 576.75 m +547.04 576.75 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 677.68 m +297.64 576.5 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 677.68 m +547.04 576.5 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 662.466 Td +/F1.0 10.5 Tf +<42617365206469726563746f7279206f6620736f757263657320746f20636f6d70696c652c20617373756d696e67> Tj +ET + + +BT +300.64 646.686 Td +/F1.0 10.5 Tf +<74686572652061726520> Tj +ET + +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +349.0765 646.686 Td +/F1.0 10.5 Tf +<6e6573746564206d617463686573> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +426.3565 646.686 Td +/F1.0 10.5 Tf +<2e205468697320617070726f6163682075736573> Tj +ET + + +BT +300.64 630.906 Td +/F1.0 10.5 Tf +<74686520416e742070726f6365737320666f72206d61746368696e67202e6a6176612066696c657320616e64206973> Tj +ET + + +BT +300.64 615.126 Td +/F1.0 10.5 Tf +<6e6f7420636f6d70617469626c65207769746820696e6372656d656e74616c206d6f64652e20556e6c657373> Tj +ET + + +BT +300.64 599.346 Td +/F1.0 10.5 Tf +<7573696e672066696c7465727320746f206c696d69742074686520736f757263657320696e636c756465642c20757365> Tj +ET + + +BT +300.64 583.566 Td +/F1.0 10.5 Tf +<736f75726365726f6f747320696e73746561642e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 576.75 m +297.64 576.75 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 539.19 m +297.64 539.19 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 577.0 m +48.24 538.94 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 577.0 m +297.64 538.94 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 561.786 Td +/F1.0 10.5 Tf +<696e6a6172732c20696e6a6172735265662028> Tj +ET + +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +136.9935 561.786 Td +/F1.0 10.5 Tf +<50617468> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +159.5895 561.786 Td +/F1.0 10.5 Tf +<29> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 576.75 m +547.04 576.75 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 539.19 m +547.04 539.19 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 577.0 m +297.64 538.94 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 577.0 m +547.04 538.94 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 561.786 Td +/F1.0 10.5 Tf +<44657072656361746564202d2075736520696e7061746820696e73746561642e2052656164202e636c6173732066696c6573> Tj +ET + + +BT +300.64 546.006 Td +/F1.0 10.5 Tf +[<666f722062> 20.0195 <797465636f64652077656176696e672066726f6d207a69702066696c657320286f6e6c79292e>] TJ +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 539.19 m +297.64 539.19 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 501.63 m +297.64 501.63 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 539.44 m +48.24 501.38 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 539.44 m +297.64 501.38 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 524.226 Td +/F1.0 10.5 Tf +<696e706174682c20696e706174685265662028> Tj +ET + +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +144.9315 524.226 Td +/F1.0 10.5 Tf +<50617468> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +167.5275 524.226 Td +/F1.0 10.5 Tf +<29> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 539.19 m +547.04 539.19 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 501.63 m +547.04 501.63 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 539.44 m +297.64 501.38 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 539.44 m +547.04 501.38 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 524.226 Td +/F1.0 10.5 Tf +[<52656164202e636c6173732066696c657320666f722062> 20.0195 <797465636f64652077656176696e672066726f6d>] TJ +ET + + +BT +300.64 508.446 Td +/F1.0 10.5 Tf +[<6469726563746f72696573206f72207a69702066696c657320286c696b> 20.0195 <6520636c61737370617468292e>] TJ +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 501.63 m +297.64 501.63 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 448.29 m +297.64 448.29 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 501.88 m +48.24 448.04 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 501.88 m +297.64 448.04 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 486.666 Td +/F1.0 10.5 Tf +<636c617373706174682c20636c617373706174685265662028> Tj +ET + +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +172.2735 486.666 Td +/F1.0 10.5 Tf +<50617468> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +194.8695 486.666 Td +/F1.0 10.5 Tf +<29> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 501.63 m +547.04 501.63 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 448.29 m +547.04 448.29 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 501.88 m +297.64 448.04 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 501.88 m +547.04 448.04 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 486.666 Td +/F1.0 10.5 Tf +[<54686520636c6173737061746820757365642062> 20.0195 <792074686520736f7572636573206265696e67>] TJ +ET + + +BT +300.64 470.886 Td +/F1.0 10.5 Tf +<636f6d70696c65642e205768656e20636f6d70696c696e6720617370656374732c20696e636c75646520746865> Tj +ET + + +BT +300.64 455.106 Td +/F1.0 10.5 Tf +<73616d652076657273696f6e206f662074686520> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +401.146 455.106 Td +/F3.0 10.5 Tf +<6173706563746a72742e6a6172> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +469.396 455.106 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 448.29 m +297.64 448.29 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 394.95 m +297.64 394.95 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 448.54 m +48.24 394.7 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 448.54 m +297.64 394.7 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 433.326 Td +/F1.0 10.5 Tf +<626f6f74636c617373706174682c20626f6f74636c617373706174685265662028> Tj +ET + +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +216.7725 433.326 Td +/F1.0 10.5 Tf +<50617468> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +239.3685 433.326 Td +/F1.0 10.5 Tf +<29> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 448.29 m +547.04 448.29 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 394.95 m +547.04 394.95 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 448.54 m +297.64 394.7 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 448.54 m +547.04 394.7 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 433.326 Td +/F1.0 10.5 Tf +<54686520626f6f74636c617373706174682073706563696669657320747970657320746f2075736520696e7374656164> Tj +ET + + +BT +300.64 417.546 Td +/F1.0 10.5 Tf +<6f662074686520696e766f6b696e6720564dd573207768656e207365656b696e6720747970657320647572696e67> Tj +ET + + +BT +300.64 401.766 Td +/F1.0 10.5 Tf +<636f6d70696c6174696f6e2e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 394.95 m +297.64 394.95 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 341.61 m +297.64 341.61 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 395.2 m +48.24 341.36 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 395.2 m +297.64 341.36 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 379.986 Td +/F1.0 10.5 Tf +<657874446972732c20657874446972735265662028> Tj +ET + +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +151.3995 379.986 Td +/F1.0 10.5 Tf +<50617468> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +173.9955 379.986 Td +/F1.0 10.5 Tf +<29> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 394.95 m +547.04 394.95 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 341.61 m +547.04 341.61 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 395.2 m +297.64 341.36 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 395.2 m +547.04 341.36 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 379.986 Td +/F1.0 10.5 Tf +<54686520657874656e73696f6e206469726563746f7269657320746f2075736520696e7374656164206f662074686f7365> Tj +ET + + +BT +300.64 364.206 Td +/F1.0 10.5 Tf +<696e2074686520696e766f6b696e6720564d207768656e207365656b696e6720747970657320647572696e67> Tj +ET + + +BT +300.64 348.426 Td +/F1.0 10.5 Tf +<636f6d70696c6174696f6e2e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 341.61 m +297.64 341.61 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 256.71 m +297.64 256.71 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 341.86 m +48.24 256.46 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 341.86 m +297.64 256.46 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 326.646 Td +/F1.0 10.5 Tf +<617370656374506174682c20617370656374506174685265662028> Tj +ET + +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +187.6035 326.646 Td +/F1.0 10.5 Tf +<50617468> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +210.1995 326.646 Td +/F1.0 10.5 Tf +<29> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 341.61 m +547.04 341.61 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 256.71 m +547.04 256.71 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 341.86 m +297.64 256.46 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 341.86 m +547.04 256.46 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 326.646 Td +/F1.0 10.5 Tf +<53696d696c617220746f20636c617373706174682c206173706563747061746820636f6e7461696e7320726561642d> Tj +ET + + +BT +300.64 310.866 Td +/F1.0 10.5 Tf +[<6f6e6c79> 89.8438 <2c2062696e61727920617370656374206c696272> 20.0195 <617269657320746861742061726520776f76656e20696e746f>] TJ +ET + + +BT +300.64 295.086 Td +/F1.0 10.5 Tf +<736f757263657320627574206e6f7420696e636c7564656420696e20746865206f75747075742e> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +300.64 279.306 Td +/F3.0 10.5 Tf +<61737065637470617468> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +353.14 279.306 Td +/F1.0 10.5 Tf +[<2061636365707473206a61722f7a69702066696c657320286275742c20756e6c696b> 20.0195 <65>] TJ +ET + + +BT +300.64 263.526 Td +/F1.0 10.5 Tf +<636c617373706174682c206e6f74206469726563746f72696573292e> Tj +ET + +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 232.746 Td +/F2.0 10.5 Tf +[<416a6354> 29.7852 <61736b202869616a6329206f7074696f6e7320666f722073706563696679696e67206f7574707574>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 195.15 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 195.15 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 141.81 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 141.81 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 88.47 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 88.47 249.4 53.34 re +f +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 216.93 m +297.64 216.93 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +48.24 195.15 m +297.64 195.15 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 217.18 m +48.24 194.525 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 217.18 m +297.64 194.525 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 201.966 Td +/F2.0 10.5 Tf +<417474726962757465> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 216.93 m +547.04 216.93 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +297.64 195.15 m +547.04 195.15 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 217.18 m +297.64 194.525 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 217.18 m +547.04 194.525 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 201.966 Td +/F2.0 10.5 Tf +<4465736372697074696f6e> Tj +ET + +0.0 0.0 0.0 scn +1.25 w +0.8667 0.8667 0.8667 SCN +48.24 195.15 m +297.64 195.15 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 141.81 m +297.64 141.81 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 195.775 m +48.24 141.56 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 195.775 m +297.64 141.56 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 180.186 Td +/F1.0 10.5 Tf +<64657374446972> Tj +ET + +0.0 0.0 0.0 scn +1.25 w +0.8667 0.8667 0.8667 SCN +297.64 195.15 m +547.04 195.15 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 141.81 m +547.04 141.81 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 195.775 m +297.64 141.56 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 195.775 m +547.04 141.56 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 180.186 Td +/F1.0 10.5 Tf +[<546865206469726563746f727920696e20776869636820746f20706c616365207468652067656e6572> 20.0195 <61746564>] TJ +ET + + +BT +300.64 164.406 Td +/F1.0 10.5 Tf +<636c6173732066696c65732e204f6e6c79206f6e65206f6620> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +413.6095 164.406 Td +/F3.0 10.5 Tf +<64657374446972> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +450.3595 164.406 Td +/F1.0 10.5 Tf +<20616e6420> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +474.9085 164.406 Td +/F3.0 10.5 Tf +<6f75744a6172> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +506.4085 164.406 Td +/F1.0 10.5 Tf +[<206d61> 20.0195 <79>] TJ +ET + + +BT +300.64 148.626 Td +/F1.0 10.5 Tf +<6265207365742e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 141.81 m +297.64 141.81 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 88.47 m +297.64 88.47 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 142.06 m +48.24 88.22 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 142.06 m +297.64 88.22 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 126.846 Td +/F1.0 10.5 Tf +<6f75744a6172> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 141.81 m +547.04 141.81 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 88.47 m +547.04 88.47 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 142.06 m +297.64 88.22 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 142.06 m +547.04 88.22 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 126.846 Td +/F1.0 10.5 Tf +[<546865207a69702066696c6520696e20776869636820746f20706c616365207468652067656e6572> 20.0195 <61746564>] TJ +ET + + +BT +300.64 111.066 Td +/F1.0 10.5 Tf +<6f757470757420636c6173732066696c65732e204f6e6c79206f6e65206f6620> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +449.53 111.066 Td +/F3.0 10.5 Tf +<64657374446972> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +486.28 111.066 Td +/F1.0 10.5 Tf +<20616e6420> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +510.829 111.066 Td +/F3.0 10.5 Tf +<6f75744a6172> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 95.286 Td +/F1.0 10.5 Tf +[<6d61> 20.0195 <79206265207365742e>] TJ +ET + +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp2 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +49.24 14.263 Td +/F1.0 9 Tf +<3232> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +136 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 135 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F2.0 22 0 R +/F1.0 8 0 R +/F3.0 26 0 R +>> +/XObject << /Stamp2 361 0 R +>> +>> +/Annots [137 0 R 138 0 R 139 0 R 140 0 R 141 0 R 142 0 R 143 0 R 144 0 R 145 0 R 146 0 R] +>> +endobj +137 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#antTasks-iajc-paths) +>> +/Subtype /Link +/Rect [153.9615 766.08 176.5575 780.36] +/Type /Annot +>> +endobj +138 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#antTasks-iajc-paths) +>> +/Subtype /Link +/Rect [200.5185 696.96 223.1145 711.24] +/Type /Annot +>> +endobj +139 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#antTasks-iajc-paths) +>> +/Subtype /Link +/Rect [87.171 659.4 109.767 673.68] +/Type /Annot +>> +endobj +140 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#antTasks-nested-includes) +>> +/Subtype /Link +/Rect [349.0765 643.62 426.3565 657.9] +/Type /Annot +>> +endobj +141 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#antTasks-iajc-paths) +>> +/Subtype /Link +/Rect [136.9935 558.72 159.5895 573] +/Type /Annot +>> +endobj +142 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#antTasks-iajc-paths) +>> +/Subtype /Link +/Rect [144.9315 521.16 167.5275 535.44] +/Type /Annot +>> +endobj +143 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#antTasks-iajc-paths) +>> +/Subtype /Link +/Rect [172.2735 483.6 194.8695 497.88] +/Type /Annot +>> +endobj +144 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#antTasks-iajc-paths) +>> +/Subtype /Link +/Rect [216.7725 430.26 239.3685 444.54] +/Type /Annot +>> +endobj +145 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#antTasks-iajc-paths) +>> +/Subtype /Link +/Rect [151.3995 376.92 173.9955 391.2] +/Type /Annot +>> +endobj +146 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#antTasks-iajc-paths) +>> +/Subtype /Link +/Rect [187.6035 323.58 210.1995 337.86] +/Type /Annot +>> +endobj +147 0 obj +<< /Length 16525 +>> +stream +q +/DeviceRGB cs +1.0 1.0 1.0 scn +48.24 784.11 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 784.11 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 683.43 249.4 100.68 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 683.43 249.4 100.68 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 551.19 249.4 132.24 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 551.19 249.4 132.24 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 358.665 249.4 192.525 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 358.665 249.4 192.525 re +f +0.0 0.0 0.0 scn +0.5 w +/DeviceRGB CS +0.8667 0.8667 0.8667 SCN +48.24 805.89 m +297.64 805.89 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +48.24 784.11 m +297.64 784.11 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 806.14 m +48.24 783.485 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 806.14 m +297.64 783.485 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 790.926 Td +/F2.0 10.5 Tf +<417474726962757465> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 805.89 m +547.04 805.89 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +297.64 784.11 m +547.04 784.11 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 806.14 m +297.64 783.485 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 806.14 m +547.04 783.485 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 790.926 Td +/F2.0 10.5 Tf +<4465736372697074696f6e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 784.11 m +297.64 784.11 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 683.43 m +297.64 683.43 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 784.36 m +48.24 683.18 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 784.36 m +297.64 683.18 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 769.146 Td +/F1.0 10.5 Tf +[<636f70> 20.0195 <79496e6a617273>] TJ +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 784.11 m +547.04 784.11 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 683.43 m +547.04 683.43 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 784.36 m +297.64 683.18 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 784.36 m +547.04 683.18 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 769.146 Td +/F1.0 10.5 Tf +[<28446570726563617465642f69676e6f7265643b20616a6320646f657320746869732e2920496620747275652c20636f70> 20.0195 <79>] TJ +ET + + +BT +300.64 753.366 Td +/F1.0 10.5 Tf +<616c6c206e6f6e2d2e636c6173732066696c65732066726f6d20696e707574206a617228732920746f20746865206f7574707574> Tj +ET + + +BT +300.64 737.586 Td +/F1.0 10.5 Tf +<6a6172206f722064657374696e6174696f6e206469726563746f72792061667465722074686520636f6d70696c6520286f72> Tj +ET + + +BT +300.64 721.806 Td +/F1.0 10.5 Tf +[<696e6372656d656e74616c20636f6d70696c652920636f6d706c657465732e20496e20666f726b> 20.0195 <6564>] TJ +ET + + +BT +300.64 706.026 Td +/F1.0 10.5 Tf +<6d6f64652c207468697320636f70696573206f6e6c79206166746572207468652070726f63657373> Tj +ET + + +BT +300.64 690.246 Td +/F1.0 10.5 Tf +<636f6d706c657465732c206e6f7420616674657220696e6372656d656e74616c20636f6d70696c65732e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 683.43 m +297.64 683.43 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 551.19 m +297.64 551.19 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 683.68 m +48.24 550.94 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 683.68 m +297.64 550.94 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 668.466 Td +/F1.0 10.5 Tf +[<736f75726365526f6f74436f70> 20.0195 <7946696c746572>] TJ +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 683.43 m +547.04 683.43 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 551.19 m +547.04 551.19 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 683.68 m +297.64 550.94 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 683.68 m +547.04 550.94 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 668.466 Td +/F1.0 10.5 Tf +[<5768656e207365742c20636f70> 20.0195 <7920616c6c2066696c65732066726f6d2074686520736f75726365726f6f74>] TJ +ET + + +BT +300.64 652.686 Td +/F1.0 10.5 Tf +<6469726563746f7269657320746f20746865206f7574707574206a6172206f722064657374696e6174696f6e> Tj +ET + + +BT +300.64 636.906 Td +/F1.0 10.5 Tf +<6469726563746f7279206578636570742074686f73652073706563696669656420696e207468652066696c746572> Tj +ET + + +BT +300.64 621.126 Td +/F1.0 10.5 Tf +<7061747465726e2e20546865207061747465726e2073686f756c6420626520636f6d70617469626c652077697468> Tj +ET + + +BT +300.64 605.346 Td +/F1.0 10.5 Tf +<616e20416e742066696c65736574206578636c756465732066696c7465723b207768656e207573696e6720746869732c> Tj +ET + + +BT +300.64 589.566 Td +/F1.0 10.5 Tf +<6d6f737420646576656c6f70657273207061737320> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +409.8085 589.566 Td +/F4.0 10.5 Tf +<2f4356532f> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +436.0585 589.566 Td +/F4.0 10.5 Tf +<2c> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +441.3085 589.566 Td +/F4.0 10.5 Tf +<2f> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +446.5585 589.566 Td +/F3.0 10.5 Tf +<2e6a617661> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +472.8085 589.566 Td +/F1.0 10.5 Tf +<20746f206578636c756465> Tj +ET + + +BT +300.64 573.786 Td +/F1.0 10.5 Tf +[<616e> 20.0195 <7920435653206469726563746f72696573206f7220736f757263652066696c65732e20536565>] TJ +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +300.64 558.006 Td +/F3.0 10.5 Tf +<696e70617468446972436f707946696c746572> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +400.39 558.006 Td +/F1.0 10.5 Tf +<2e20526571756972657320> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +452.6905 558.006 Td +/F3.0 10.5 Tf +<64657374446972> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +489.4405 558.006 Td +/F1.0 10.5 Tf +<206f7220> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +505.8835 558.006 Td +/F3.0 10.5 Tf +<6f75744a6172> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +537.3835 558.006 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 551.19 m +297.64 551.19 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 358.665 m +297.64 358.665 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 551.44 m +48.24 358.415 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 551.44 m +297.64 358.415 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 536.226 Td +/F1.0 10.5 Tf +[<696e70617468446972436f70> 20.0195 <7946696c746572>] TJ +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 551.19 m +547.04 551.19 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 358.665 m +547.04 358.665 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 551.44 m +297.64 358.415 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 551.44 m +547.04 358.415 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 536.226 Td +/F1.0 10.5 Tf +[<5768656e207365742c20636f70> 20.0195 <7920616c6c2066696c65732066726f6d2074686520696e70617468>] TJ +ET + + +BT +300.64 520.446 Td +/F1.0 10.5 Tf +<6469726563746f7269657320746f20746865206f7574707574206a6172206f722064657374696e6174696f6e> Tj +ET + + +BT +300.64 504.666 Td +/F1.0 10.5 Tf +<6469726563746f7279206578636570742074686f73652073706563696669656420696e207468652066696c746572> Tj +ET + + +BT +300.64 488.886 Td +/F1.0 10.5 Tf +<7061747465726e2e20546865207061747465726e2073686f756c6420626520636f6d70617469626c652077697468> Tj +ET + + +BT +300.64 473.106 Td +/F1.0 10.5 Tf +<616e20416e742066696c65736574206578636c756465732066696c7465723b207768656e207573696e6720746869732c> Tj +ET + + +BT +300.64 457.326 Td +/F1.0 10.5 Tf +<6d6f737420646576656c6f70657273207061737320> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +409.8085 457.326 Td +/F4.0 10.5 Tf +<2f4356532f> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +436.0585 457.326 Td +/F4.0 10.5 Tf +<2c> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +441.3085 457.326 Td +/F4.0 10.5 Tf +<2f> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +446.5585 457.326 Td +/F3.0 10.5 Tf +<2e6a6176612c> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +478.0585 457.326 Td +/F4.0 10.5 Tf +<2f> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +483.3085 457.326 Td +/F4.0 10.5 Tf +<2e636c617373> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +514.8085 457.326 Td +/F4.0 10.5 Tf +<20746f> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +300.64 444.381 Td +/F4.0 10.5 Tf +<6578636c75646520616e7920435653206469726563746f726965732c20736f757263652066696c65732c206f72> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +300.64 428.601 Td +/F4.0 10.5 Tf +<756e776f76656e202e636c6173732066696c65732e20284966202f> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +442.39 428.601 Td +/F3.0 10.5 Tf +<2e636c617373> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +473.89 428.601 Td +/F1.0 10.5 Tf +<206973206e6f74> Tj +ET + + +BT +300.64 412.821 Td +/F1.0 10.5 Tf +<7370656369666965642c2069742077696c6c2062652070726570656e64656420746f207468652066696c7465722e2920536565> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +300.64 397.041 Td +/F3.0 10.5 Tf +<736f75726365526f6f74436f707946696c746572> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +405.64 397.041 Td +/F1.0 10.5 Tf +<2e20284e6f7465207468617420616a6320697473656c6620636f70696573> Tj +ET + + +BT +300.64 381.261 Td +/F1.0 10.5 Tf +<616c6c207265736f75726365732066726f6d20696e707574206a61722f7a69702066696c6573206f6e20746865> Tj +ET + + +BT +300.64 365.481 Td +/F1.0 10.5 Tf +<696e706174682e2920526571756972657320> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +389.386 365.481 Td +/F3.0 10.5 Tf +<64657374446972> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +426.136 365.481 Td +/F1.0 10.5 Tf +<206f7220> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +442.579 365.481 Td +/F3.0 10.5 Tf +<6f75744a6172> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +474.079 365.481 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 334.701 Td +/F2.0 10.5 Tf +[<416a6354> 29.7852 <61736b202869616a6329206f7074696f6e7320666f722073706563696679696e6720636f6d70696c6572206265686176696f72>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 297.105 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 297.105 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 164.865 249.4 132.24 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 164.865 249.4 132.24 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 127.305 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 127.305 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 73.965 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 73.965 249.4 53.34 re +f +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 318.885 m +297.64 318.885 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +48.24 297.105 m +297.64 297.105 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 319.135 m +48.24 296.48 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 319.135 m +297.64 296.48 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 303.921 Td +/F2.0 10.5 Tf +<417474726962757465> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 318.885 m +547.04 318.885 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +297.64 297.105 m +547.04 297.105 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 319.135 m +297.64 296.48 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 319.135 m +547.04 296.48 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 303.921 Td +/F2.0 10.5 Tf +<4465736372697074696f6e> Tj +ET + +0.0 0.0 0.0 scn +1.25 w +0.8667 0.8667 0.8667 SCN +48.24 297.105 m +297.64 297.105 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 164.865 m +297.64 164.865 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 297.73 m +48.24 164.615 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 297.73 m +297.64 164.615 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 282.141 Td +/F1.0 10.5 Tf +<666f726b> Tj +ET + +0.0 0.0 0.0 scn +1.25 w +0.8667 0.8667 0.8667 SCN +297.64 297.105 m +547.04 297.105 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 164.865 m +547.04 164.865 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 297.73 m +297.64 164.615 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 297.73 m +547.04 164.615 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 282.141 Td +/F1.0 10.5 Tf +<52756e2070726f6365737320696e20616e6f7468657220564d2e205468697320676574732074686520666f726b696e67> Tj +ET + + +BT +300.64 266.361 Td +/F1.0 10.5 Tf +<636c6173737061746820656974686572206578706c696369746c792066726f6d206120> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +467.4115 266.361 Td +/F3.0 10.5 Tf +<666f726b636c61737370617468> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +535.6615 266.361 Td +ET + + +BT +300.64 250.581 Td +/F1.0 10.5 Tf +[<656e747279206f722062> 20.0195 <7920736561726368696e6720746865207461736b206f722073797374656d2f416e74>] TJ +ET + + +BT +300.64 234.801 Td +/F1.0 10.5 Tf +<636c6173737061746820666f7220746865206669727374207265616461626c652066696c6520776974682061206e616d65> Tj +ET + + +BT +300.64 219.021 Td +/F1.0 10.5 Tf +<6f662074686520666f726d20> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +359.4925 219.021 Td +/F3.0 10.5 Tf +<6173706563746a7b2d7d746f6f6c737b2e2a7d2e6a6172> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +480.2425 219.021 Td +/F1.0 10.5 Tf +<2e205768656e> Tj +ET + + +BT +300.64 203.241 Td +/F1.0 10.5 Tf +<666f726b696e6720796f752063616e20737065636966792074686520616d6f756e74206f66206d656d6f7279> Tj +ET + + +BT +300.64 187.461 Td +/F1.0 10.5 Tf +<75736564207769746820> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +352.2685 187.461 Td +/F3.0 10.5 Tf +<6d61786d656d> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +383.7685 187.461 Td +/F1.0 10.5 Tf +[<2e2046> 40.0391 <6f726b2063616e6e6f74206265207573656420696e>] TJ +ET + + +BT +300.64 171.681 Td +/F1.0 10.5 Tf +<696e6372656d656e74616c206d6f64652c20756e6c657373207573696e672061207461672066696c652e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 164.865 m +297.64 164.865 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 127.305 m +297.64 127.305 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 165.115 m +48.24 127.055 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 165.115 m +297.64 127.055 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 149.901 Td +/F1.0 10.5 Tf +[<666f726b> 20.0195 <636c617373706174682c20666f726b> 20.0195 <636c617373706174685265662028>] TJ +ET + +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +213.8741 149.901 Td +/F1.0 10.5 Tf +<50617468> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +236.4701 149.901 Td +/F1.0 10.5 Tf +<29> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 164.865 m +547.04 164.865 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 127.305 m +547.04 127.305 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 165.115 m +297.64 127.055 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 165.115 m +547.04 127.055 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 149.901 Td +/F1.0 10.5 Tf +<537065636966792074686520636c6173737061746820746f2075736520666f722074686520636f6d70696c6572> Tj +ET + + +BT +300.64 134.121 Td +/F1.0 10.5 Tf +<7768656e20666f726b696e672e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 127.305 m +297.64 127.305 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 73.965 m +297.64 73.965 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 127.555 m +48.24 73.715 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 127.555 m +297.64 73.715 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 112.341 Td +/F1.0 10.5 Tf +<6d61786d656d> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 127.305 m +547.04 127.305 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 73.965 m +547.04 73.965 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 127.555 m +297.64 73.715 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 127.555 m +547.04 73.715 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 112.341 Td +/F1.0 10.5 Tf +<546865206d6178696d756d206d656d6f727920746f2075736520666f7220746865206e657720564d> Tj +ET + + +BT +300.64 96.561 Td +/F1.0 10.5 Tf +[<7768656e20666f726b20697320747275652e2056> 60.0586 <616c7565732073686f756c642068617665207468652073616d65>] TJ +ET + + +BT +300.64 80.781 Td +/F1.0 10.5 Tf +[<666f726d2061732061636365707465642062> 20.0195 <792074686520564d2c20652e672e2c20223132386d222e>] TJ +ET + +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp1 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.978 14.263 Td +/F1.0 9 Tf +<3233> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +148 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 147 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F2.0 22 0 R +/F1.0 8 0 R +/F4.0 149 0 R +/F3.0 26 0 R +>> +/XObject << /Stamp1 360 0 R +>> +>> +/Annots [150 0 R] +>> +endobj +149 0 obj +<< /Type /Font +/BaseFont /936a7f+mplus1mn-bold +/Subtype /TrueType +/FontDescriptor 379 0 R +/FirstChar 32 +/LastChar 255 +/Widths 381 0 R +/ToUnicode 380 0 R +>> +endobj +150 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#antTasks-iajc-paths) +>> +/Subtype /Link +/Rect [213.8741 146.835 236.4701 161.115] +/Type /Annot +>> +endobj +151 0 obj +<< /Length 17061 +>> +stream +q +/DeviceRGB cs +1.0 1.0 1.0 scn +48.24 784.11 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 784.11 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 699.21 249.4 84.9 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 699.21 249.4 84.9 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 614.31 249.4 84.9 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 614.31 249.4 84.9 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 434.73 249.4 179.58 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 434.73 249.4 179.58 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 397.17 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 397.17 249.4 37.56 re +f +0.0 0.0 0.0 scn +0.5 w +/DeviceRGB CS +0.8667 0.8667 0.8667 SCN +48.24 805.89 m +297.64 805.89 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +48.24 784.11 m +297.64 784.11 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 806.14 m +48.24 783.485 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 806.14 m +297.64 783.485 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 790.926 Td +/F2.0 10.5 Tf +<417474726962757465> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 805.89 m +547.04 805.89 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +297.64 784.11 m +547.04 784.11 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 806.14 m +297.64 783.485 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 806.14 m +547.04 783.485 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 790.926 Td +/F2.0 10.5 Tf +<4465736372697074696f6e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 784.11 m +297.64 784.11 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 699.21 m +297.64 699.21 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 784.36 m +48.24 698.96 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 784.36 m +297.64 698.96 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 769.146 Td +/F1.0 10.5 Tf +<696e6372656d656e74616c> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 784.11 m +547.04 784.11 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 699.21 m +547.04 699.21 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 784.36 m +297.64 698.96 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 784.36 m +547.04 698.96 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 769.146 Td +/F1.0 10.5 Tf +<696e6372656d656e74616c206d6f64653a204275696c64206f6e63652c207468656e207265636f6d70696c65> Tj +ET + + +BT +300.64 753.366 Td +/F1.0 10.5 Tf +<6f6e6c7920726571756972656420736f757263652066696c6573207768656e20757365722070726f7669646573> Tj +ET + + +BT +300.64 737.586 Td +/F1.0 10.5 Tf +<696e7075742e205265717569726573207468617420736f757263652066696c657320626520737065636966696564> Tj +ET + + +BT +300.64 721.806 Td +/F1.0 10.5 Tf +<6f6e6c79207573696e6720> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +355.2505 721.806 Td +/F3.0 10.5 Tf +<736f75726365726f6f7473> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +413.0005 721.806 Td +/F1.0 10.5 Tf +<2e20496e636f6d70617469626c652077697468> Tj +ET + + +BT +300.64 706.026 Td +/F1.0 10.5 Tf +<666f726b696e672e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 699.21 m +297.64 699.21 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 614.31 m +297.64 614.31 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 699.46 m +48.24 614.06 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 699.46 m +297.64 614.06 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 684.246 Td +/F1.0 10.5 Tf +<74616766696c65> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 699.21 m +547.04 699.21 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 614.31 m +547.04 614.31 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 699.46 m +297.64 614.06 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 699.46 m +547.04 614.06 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 684.246 Td +/F1.0 10.5 Tf +<696e6372656d656e74616c206d6f64653a204275696c64206f6e63652c207468656e207265636f6d70696c65> Tj +ET + + +BT +300.64 668.466 Td +/F1.0 10.5 Tf +<6f6e6c7920726571756972656420736f757263652066696c6573207768656e20746865207461672066696c65206973> Tj +ET + + +BT +300.64 652.686 Td +/F1.0 10.5 Tf +<757064617465642c2066696e616c6c792065786974696e67207768656e207461672066696c652069732064656c657465642e> Tj +ET + + +BT +300.64 636.906 Td +/F1.0 10.5 Tf +<5265717569726573207468617420736f757263652066696c657320626520737065636966696564206f6e6c79207573696e67> Tj +ET + + +BT +300.64 621.126 Td +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +300.64 621.126 Td +/F3.0 10.5 Tf +<736f75726365726f6f7473> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +358.39 621.126 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 614.31 m +297.64 614.31 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 434.73 m +297.64 434.73 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 614.56 m +48.24 434.48 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 614.56 m +297.64 434.48 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 599.346 Td +/F1.0 10.5 Tf +<58> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 614.31 m +547.04 614.31 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 434.73 m +547.04 434.73 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 614.56 m +297.64 434.48 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 614.56 m +547.04 434.48 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 599.346 Td +/F1.0 10.5 Tf +<536574206578706572696d656e74616c206f7074696f6e2873292c207573696e6720636f6d6d612d> Tj +ET + + +BT +300.64 583.566 Td +/F1.0 10.5 Tf +[<7365706172> 20.0195 <61746564206c697374206f66206163636570746564206f7074696f6e73204f7074696f6e732073686f756c64>] TJ +ET + + +BT +300.64 567.786 Td +/F1.0 10.5 Tf +<6e6f7420636f6e7461696e20746865206c656164696e6720582e20536f6d6520636f6d6d6f6e6c792d75736564> Tj +ET + + +BT +300.64 552.006 Td +/F1.0 10.5 Tf +<6578706572696d656e74616c206f7074696f6e732068617665207468656972206f776e20656e74726965732e> Tj +ET + + +BT +300.64 536.226 Td +/F1.0 10.5 Tf +<546865206f74686572207065726d6974746564206f6e6573202863757272656e746c792920617265> Tj +ET + + +BT +300.64 520.446 Td +/F1.0 10.5 Tf +<73657269616c697a61626c65417370656374732c20696e6372656d656e74616c46696c652c206c617a79546a702c> Tj +ET + + +BT +300.64 504.666 Td +/F1.0 10.5 Tf +<72657765617661626c652c206e6f7452657765617661626c652c206e6f496e6c696e652c> Tj +ET + + +BT +300.64 488.886 Td +/F1.0 10.5 Tf +<7465726d696e6174654166746572436f6d70696c6174696f6e2c20616a72756e74696d656c6576656c3a312e322c> Tj +ET + + +BT +300.64 473.106 Td +/F1.0 10.5 Tf +<616e6420616a72756e74696d656c6576656c3a312e352e204f662074686573652c20736f6d652077657265> Tj +ET + + +BT +300.64 457.326 Td +/F1.0 10.5 Tf +<6465707265636174656420696e204173706563744a2035202872657765617661626c652c> Tj +ET + + +BT +300.64 441.546 Td +/F1.0 10.5 Tf +<7465726d696e6174654166746572436f6d70696c6174696f6e2c206574632e292e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 434.73 m +297.64 434.73 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 397.17 m +297.64 397.17 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 434.98 m +48.24 396.92 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 434.98 m +297.64 396.92 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 419.766 Td +/F1.0 10.5 Tf +<587465726d696e6174654166746572436f6d70696c6174696f6e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 434.73 m +547.04 434.73 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 397.17 m +547.04 397.17 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 434.98 m +297.64 396.92 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 434.98 m +547.04 396.92 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 419.766 Td +/F1.0 10.5 Tf +[<54> 29.7852 <65726d696e61746573206265666f7265207468652077656176696e672070726f636573732c>] TJ +ET + + +BT +300.64 403.986 Td +/F1.0 10.5 Tf +<64756d70696e67206f757420756e66696e697368656420636c6173732066696c65732e> Tj +ET + +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 373.206 Td +/F2.0 10.5 Tf +[<416a6354> 29.7852 <61736b202869616a6329206f7074696f6e7320666f722073706563696679696e6720636f6d70696c657220736964652d6566666563747320616e64206d65737361676573>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 335.61 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 335.61 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 298.05 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 298.05 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 276.27 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 276.27 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 238.71 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 238.71 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 185.37 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 185.37 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 147.81 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 147.81 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 110.25 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 110.25 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 72.69 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 72.69 249.4 37.56 re +f +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 357.39 m +297.64 357.39 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +48.24 335.61 m +297.64 335.61 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 357.64 m +48.24 334.985 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 357.64 m +297.64 334.985 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 342.426 Td +/F2.0 10.5 Tf +<417474726962757465> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 357.39 m +547.04 357.39 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +297.64 335.61 m +547.04 335.61 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 357.64 m +297.64 334.985 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 357.64 m +547.04 334.985 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 342.426 Td +/F2.0 10.5 Tf +<4465736372697074696f6e> Tj +ET + +0.0 0.0 0.0 scn +1.25 w +0.8667 0.8667 0.8667 SCN +48.24 335.61 m +297.64 335.61 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 298.05 m +297.64 298.05 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 336.235 m +48.24 297.8 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 336.235 m +297.64 297.8 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 320.646 Td +/F1.0 10.5 Tf +<656d61637373796d> Tj +ET + +0.0 0.0 0.0 scn +1.25 w +0.8667 0.8667 0.8667 SCN +297.64 335.61 m +547.04 335.61 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 298.05 m +547.04 298.05 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 336.235 m +297.64 297.8 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 336.235 m +547.04 297.8 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 320.646 Td +/F1.0 10.5 Tf +<496620747275652c20656d697420> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +362.6425 320.646 Td +/F3.0 10.5 Tf +<2e616a6573796d> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +399.3925 320.646 Td +/F1.0 10.5 Tf +<2073796d626f6c2066696c657320666f7220456d616373> Tj +ET + + +BT +300.64 304.866 Td +/F1.0 10.5 Tf +<737570706f72742e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 298.05 m +297.64 298.05 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 276.27 m +297.64 276.27 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 298.3 m +48.24 276.02 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 298.3 m +297.64 276.02 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 283.086 Td +/F1.0 10.5 Tf +<63726f7373726566> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 298.05 m +547.04 298.05 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 276.27 m +547.04 276.27 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 298.3 m +297.64 276.02 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 298.3 m +547.04 276.02 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 283.086 Td +/F1.0 10.5 Tf +<496620747275652c20656d697420> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +362.6425 283.086 Td +/F3.0 10.5 Tf +<2e616a73796d> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +394.1425 283.086 Td +/F1.0 10.5 Tf +[<2066696c6520696e746f20746865206f7574707574206469726563746f7279> 89.8438 <2e>] TJ +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 276.27 m +297.64 276.27 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 238.71 m +297.64 238.71 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 276.52 m +48.24 238.46 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 276.52 m +297.64 238.46 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 261.306 Td +/F1.0 10.5 Tf +<766572626f7365> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 276.27 m +547.04 276.27 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 238.71 m +547.04 238.71 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 276.52 m +297.64 238.46 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 276.52 m +547.04 238.46 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 261.306 Td +/F1.0 10.5 Tf +<496620747275652c206c6f6720636f6d70696c657220766572626f7365206d65737361676573206173> Tj +ET + + +BT +300.64 245.526 Td +/F1.0 10.5 Tf +<50726f6a6563742e494e464f20647572696e672074686520636f6d70696c652e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 238.71 m +297.64 238.71 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 185.37 m +297.64 185.37 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 238.96 m +48.24 185.12 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 238.96 m +297.64 185.12 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 223.746 Td +/F1.0 10.5 Tf +<6c6f67436f6d6d616e64> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 238.71 m +547.04 238.71 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 185.37 m +547.04 185.37 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 238.96 m +297.64 185.12 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 238.96 m +547.04 185.12 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 223.746 Td +/F1.0 10.5 Tf +<496620747275652c206c6f6720636f6d70696c657220636f6d6d616e6420656c656d656e7473206173> Tj +ET + + +BT +300.64 207.966 Td +/F1.0 10.5 Tf +[<50726f6a6563742e494e464f202872> 20.0195 <6174686572207468616e2074686520757375616c>] TJ +ET + + +BT +300.64 192.186 Td +/F1.0 10.5 Tf +<50726f6a6563742e564552424f5345206c6576656c292e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 185.37 m +297.64 185.37 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 147.81 m +297.64 147.81 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 185.62 m +48.24 147.56 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 185.62 m +297.64 147.56 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 170.406 Td +/F1.0 10.5 Tf +<586c69737466696c6561726773> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 185.37 m +547.04 185.37 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 147.81 m +547.04 147.81 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 185.62 m +297.64 147.56 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 185.62 m +547.04 147.56 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 170.406 Td +/F1.0 10.5 Tf +<496620747275652c20656d6974206c697374206f662066696c6520617267756d656e747320647572696e6720746865> Tj +ET + + +BT +300.64 154.626 Td +/F1.0 10.5 Tf +[<636f6d70696c6520286275742062656861766573206e6f77206c696b> 20.0195 <6520766572626f7365292e>] TJ +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 147.81 m +297.64 147.81 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 110.25 m +297.64 110.25 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 148.06 m +48.24 110.0 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 148.06 m +297.64 110.0 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 132.846 Td +/F1.0 10.5 Tf +<76657273696f6e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 147.81 m +547.04 147.81 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 110.25 m +547.04 110.25 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 148.06 m +297.64 110.0 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 148.06 m +547.04 110.0 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 132.846 Td +/F1.0 10.5 Tf +<496620747275652c20646f206e6f7420636f6d70696c65202d206a757374207072696e74204173706563744a> Tj +ET + + +BT +300.64 117.066 Td +/F1.0 10.5 Tf +<76657273696f6e2e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 110.25 m +297.64 110.25 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 72.69 m +297.64 72.69 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 110.5 m +48.24 72.44 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 110.5 m +297.64 72.44 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 95.286 Td +/F1.0 10.5 Tf +<68656c70> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 110.25 m +547.04 110.25 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 72.69 m +547.04 72.69 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 110.5 m +297.64 72.44 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 110.5 m +547.04 72.44 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 95.286 Td +/F1.0 10.5 Tf +<496620747275652c206a757374207072696e742068656c7020666f722074686520636f6d6d616e642d6c696e65> Tj +ET + + +BT +300.64 79.506 Td +/F1.0 10.5 Tf +<636f6d70696c65722e> Tj +ET + +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp2 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +49.24 14.263 Td +/F1.0 9 Tf +<3234> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +152 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 151 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F2.0 22 0 R +/F1.0 8 0 R +/F3.0 26 0 R +>> +/XObject << /Stamp2 361 0 R +>> +>> +>> +endobj +153 0 obj +<< /Length 22103 +>> +stream +q +/DeviceRGB cs +1.0 1.0 1.0 scn +48.24 784.11 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 784.11 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 746.55 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 746.55 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 708.99 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 708.99 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 624.09 249.4 84.9 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 624.09 249.4 84.9 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 554.97 249.4 69.12 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 554.97 249.4 69.12 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 454.29 249.4 100.68 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 454.29 249.4 100.68 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 432.51 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 432.51 249.4 21.78 re +f +0.0 0.0 0.0 scn +0.5 w +/DeviceRGB CS +0.8667 0.8667 0.8667 SCN +48.24 805.89 m +297.64 805.89 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +48.24 784.11 m +297.64 784.11 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 806.14 m +48.24 783.485 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 806.14 m +297.64 783.485 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 790.926 Td +/F2.0 10.5 Tf +<417474726962757465> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 805.89 m +547.04 805.89 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +297.64 784.11 m +547.04 784.11 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 806.14 m +297.64 783.485 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 806.14 m +547.04 783.485 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 790.926 Td +/F2.0 10.5 Tf +<4465736372697074696f6e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 784.11 m +297.64 784.11 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 746.55 m +297.64 746.55 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 784.36 m +48.24 746.3 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 784.36 m +297.64 746.3 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 769.146 Td +/F1.0 10.5 Tf +<586c696e747761726e696e6773> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 784.11 m +547.04 784.11 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 746.55 m +547.04 746.55 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 784.36 m +297.64 746.3 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 784.36 m +547.04 746.3 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 769.146 Td +/F1.0 10.5 Tf +<53616d6520617320> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +343.8475 769.146 Td +/F3.0 10.5 Tf +<786c696e743a7761726e696e67> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +412.0975 769.146 Td +/F1.0 10.5 Tf +<3a20696620747275652c207365742064656661756c74206c6576656c> Tj +ET + + +BT +300.64 753.366 Td +/F1.0 10.5 Tf +<6f6620616c6c206c616e6775616765207573616765206d6573736167657320746f207761726e696e672e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 746.55 m +297.64 746.55 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 708.99 m +297.64 708.99 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 746.8 m +48.24 708.74 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 746.8 m +297.64 708.74 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 731.586 Td +/F1.0 10.5 Tf +<586c696e74> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 746.55 m +547.04 746.55 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 708.99 m +547.04 708.99 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 746.8 m +297.64 708.74 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 746.8 m +547.04 708.74 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 731.586 Td +/F1.0 10.5 Tf +<537065636966792064656661756c74206c6576656c206f6620616c6c206c616e6775616765207573616765> Tj +ET + + +BT +300.64 715.806 Td +/F1.0 10.5 Tf +<6d6573736167657320746f206f6e65206f66205b> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +400.327 715.806 Td +/F3.0 10.5 Tf +<6572726f72207761726e696e672069676e6f7265> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +505.327 715.806 Td +/F1.0 10.5 Tf +<5d2e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 708.99 m +297.64 708.99 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 624.09 m +297.64 624.09 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 709.24 m +48.24 623.84 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 709.24 m +297.64 623.84 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 694.026 Td +/F1.0 10.5 Tf +<586c696e7446696c65> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 708.99 m +547.04 708.99 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 624.09 m +547.04 624.09 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 709.24 m +297.64 623.84 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 709.24 m +547.04 623.84 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 694.026 Td +/F1.0 10.5 Tf +<537065636966792070726f70657274792066696c6520636f6e7461696e696e6720> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +461.227 694.026 Td +/F3.0 10.5 Tf +<6e616d653a6c6576656c> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +513.727 694.026 Td +ET + + +BT +300.64 678.246 Td +/F1.0 10.5 Tf +<6173736f63696174696f6e732073657474696e67206c6576656c20666f72206c616e6775616765206d65737361676573> Tj +ET + + +BT +300.64 662.466 Td +/F1.0 10.5 Tf +[<656d697474656420647572696e6720636f6d70696c6174696f6e2e20416e> 20.0195 <79206c6576656c7320736574>] TJ +ET + + +BT +300.64 646.686 Td +/F1.0 10.5 Tf +<6f76657272696465207468652064656661756c74206173736f63696174696f6e7320696e> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +300.64 630.906 Td +/F3.0 10.5 Tf +<6f72672f6173706563746a2f7765617665722f584c696e7444656661756c742e70726f70657274696573> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +521.14 630.906 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 624.09 m +297.64 624.09 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 554.97 m +297.64 554.97 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 624.34 m +48.24 554.72 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 624.34 m +297.64 554.72 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 609.126 Td +/F1.0 10.5 Tf +<6661696c6f6e6572726f72> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 624.09 m +547.04 624.09 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 554.97 m +547.04 554.97 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 624.34 m +297.64 554.72 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 624.34 m +547.04 554.72 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 609.126 Td +/F1.0 10.5 Tf +<496620747275652c207468726f77204275696c64457863657074696f6e20746f2068616c74206275696c64206966> Tj +ET + + +BT +300.64 593.346 Td +/F1.0 10.5 Tf +[<74686572652061726520616e> 20.0195 <7920636f6d70696c6572206572726f72732e2049662066616c73652c20636f6e74696e7565>] TJ +ET + + +BT +300.64 577.566 Td +/F1.0 10.5 Tf +<6e6f74776974687374616e64696e6720636f6d70696c65206572726f72732e2044656661756c747320746f> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +300.64 561.786 Td +/F3.0 10.5 Tf +<74727565> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +321.64 561.786 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 554.97 m +297.64 554.97 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 454.29 m +297.64 454.29 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 555.22 m +48.24 454.04 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 555.22 m +297.64 454.04 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 540.006 Td +/F1.0 10.5 Tf +<6d657373616765486f6c646572436c617373> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 554.97 m +547.04 554.97 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 454.29 m +547.04 454.29 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 555.22 m +297.64 454.04 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 555.22 m +547.04 454.04 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 540.006 Td +/F1.0 10.5 Tf +<53706563696679206120636c61737320746f2075736520617320746865206d65737361676520686f6c64657220666f72> Tj +ET + + +BT +300.64 524.226 Td +/F1.0 10.5 Tf +<74686520636f6d70696c652070726f636573732e2054686520656e747279206d75737420626520612066756c6c792d> Tj +ET + + +BT +300.64 508.446 Td +/F1.0 10.5 Tf +<7175616c6966696564206e616d65206f66206120636c617373207265736f6c766561626c652066726f6d20746865> Tj +ET + + +BT +300.64 492.666 Td +/F1.0 10.5 Tf +<7461736b20636c6173737061746820636f6d706c79696e67207769746820746865> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +300.64 476.886 Td +/F3.0 10.5 Tf +<6f72672e6173706563746a2e6272696467652e494d657373616765486f6c646572> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +473.89 476.886 Td +/F1.0 10.5 Tf +<20696e7465726661636520616e64> Tj +ET + + +BT +300.64 461.106 Td +/F1.0 10.5 Tf +<686176696e672061207075626c6963206e6f2d617267756d656e7420636f6e7374727563746f722e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 454.29 m +297.64 454.29 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 432.51 m +297.64 432.51 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 454.54 m +48.24 432.26 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 454.54 m +297.64 432.26 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 439.326 Td +/F1.0 10.5 Tf +[<73686f7757> 60.0586 <65617665496e666f>] TJ +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 454.29 m +547.04 454.29 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 432.51 m +547.04 432.51 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 454.54 m +297.64 432.26 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 454.54 m +547.04 432.26 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 439.326 Td +/F1.0 10.5 Tf +<496620747275652c20656d697420776561766572206d657373616765732e2044656661756c747320746f20> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +511.375 439.326 Td +/F3.0 10.5 Tf +<66616c7365> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +537.625 439.326 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 408.546 Td +/F2.0 10.5 Tf +[<416a6354> 29.7852 <61736b202869616a6329206f7074696f6e7320666f722073706563696679696e672045636c6970736520636f6d70696c6572206f7074696f6e73>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 370.95 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 370.95 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 349.17 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 349.17 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 327.39 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 327.39 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 235.215 249.4 92.175 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 235.215 249.4 92.175 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 213.435 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 213.435 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 175.875 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 175.875 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 138.315 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 138.315 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 116.535 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 116.535 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 94.755 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 94.755 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 72.975 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 72.975 249.4 21.78 re +f +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 392.73 m +297.64 392.73 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +48.24 370.95 m +297.64 370.95 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 392.98 m +48.24 370.325 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 392.98 m +297.64 370.325 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 377.766 Td +/F2.0 10.5 Tf +<417474726962757465> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 392.73 m +547.04 392.73 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +297.64 370.95 m +547.04 370.95 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 392.98 m +297.64 370.325 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 392.98 m +547.04 370.325 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 377.766 Td +/F2.0 10.5 Tf +<4465736372697074696f6e> Tj +ET + +0.0 0.0 0.0 scn +1.25 w +0.8667 0.8667 0.8667 SCN +48.24 370.95 m +297.64 370.95 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 349.17 m +297.64 349.17 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 371.575 m +48.24 348.92 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 371.575 m +297.64 348.92 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 355.986 Td +/F1.0 10.5 Tf +<6e6f7761726e> Tj +ET + +0.0 0.0 0.0 scn +1.25 w +0.8667 0.8667 0.8667 SCN +297.64 370.95 m +547.04 370.95 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 349.17 m +547.04 349.17 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 371.575 m +297.64 348.92 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 371.575 m +547.04 348.92 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 355.986 Td +/F1.0 10.5 Tf +<496620747275652c2073616d6520617320> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +379.5895 355.986 Td +/F3.0 10.5 Tf +<7761726e3a6e6f6e65> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +426.8395 355.986 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 349.17 m +297.64 349.17 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 327.39 m +297.64 327.39 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 349.42 m +48.24 327.14 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 349.42 m +297.64 327.14 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 334.206 Td +/F1.0 10.5 Tf +<6465707265636174696f6e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 349.17 m +547.04 349.17 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 327.39 m +547.04 327.39 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 349.42 m +297.64 327.14 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 349.42 m +547.04 327.14 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 334.206 Td +/F1.0 10.5 Tf +<496620747275652c2073616d6520617320> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +379.5895 334.206 Td +/F3.0 10.5 Tf +<7761726e3a6465707265636174696f6e> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 327.39 m +297.64 327.39 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 235.215 m +297.64 235.215 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 327.64 m +48.24 234.965 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 327.64 m +297.64 234.965 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 312.426 Td +/F1.0 10.5 Tf +<7761726e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 327.39 m +547.04 327.39 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 235.215 m +547.04 235.215 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 327.64 m +297.64 234.965 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 327.64 m +547.04 234.965 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 312.426 Td +/F1.0 10.5 Tf +[<4f6e65206f72206d6f726520636f6d6d612d7365706172> 20.0195 <61746564207761726e696e67>] TJ +ET + + +BT +300.64 296.646 Td +/F1.0 10.5 Tf +<73706563696669636174696f6e732066726f6d205b> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +402.847 296.646 Td +/F3.0 10.5 Tf +<636f6e7374727563746f724e616d65> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +300.64 283.701 Td +/F3.0 10.5 Tf +<7061636b61676544656661756c744d6574686f64206465707265636174696f6e2c> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +300.64 270.756 Td +/F3.0 10.5 Tf +<6d61736b65644361746368426c6f636b7320756e757365644c6f63616c73> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +300.64 257.811 Td +/F3.0 10.5 Tf +<756e75736564417267756d656e74732c20756e75736564496d706f7274732073796e746865746963416363657373> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +300.64 242.031 Td +/F3.0 10.5 Tf +<6173736572744964656e746966696572> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +384.64 242.031 Td +/F1.0 10.5 Tf +<5d2e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 235.215 m +297.64 235.215 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 213.435 m +297.64 213.435 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 235.465 m +48.24 213.185 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 235.465 m +297.64 213.185 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 220.251 Td +/F1.0 10.5 Tf +<6465627567> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 235.215 m +547.04 235.215 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 213.435 m +547.04 213.435 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 235.465 m +297.64 213.185 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 235.465 m +547.04 213.185 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 220.251 Td +/F1.0 10.5 Tf +<496620747275652c2073616d6520617320> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +379.5895 220.251 Td +/F3.0 10.5 Tf +<64656275673a6c696e65732c766172732c736f75726365> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 213.435 m +297.64 213.435 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 175.875 m +297.64 175.875 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 213.685 m +48.24 175.625 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 213.685 m +297.64 175.625 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 198.471 Td +/F1.0 10.5 Tf +<64656275674c6576656c> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 213.435 m +547.04 213.435 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 175.875 m +547.04 175.875 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 213.685 m +297.64 175.625 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 213.685 m +547.04 175.625 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 198.471 Td +/F1.0 10.5 Tf +[<4f6e65206f72206d6f726520636f6d6d612d7365706172> 20.0195 <61746564206465627567>] TJ +ET + + +BT +300.64 182.691 Td +/F1.0 10.5 Tf +<73706563696669636174696f6e732066726f6d205b> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +402.847 182.691 Td +/F3.0 10.5 Tf +<6c696e6573207661727320736f75726365> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +492.097 182.691 Td +/F1.0 10.5 Tf +<5d2e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 175.875 m +297.64 175.875 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 138.315 m +297.64 138.315 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 176.125 m +48.24 138.065 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 176.125 m +297.64 138.065 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 160.911 Td +/F1.0 10.5 Tf +<5072657365727665416c6c4c6f63616c73> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 175.875 m +547.04 175.875 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 138.315 m +547.04 138.315 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 176.125 m +297.64 138.065 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 176.125 m +547.04 138.065 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 160.911 Td +/F1.0 10.5 Tf +<496620747275652c20636f64652067656e2070726573657276657320616c6c206c6f63616c207661726961626c65732028666f72> Tj +ET + + +BT +300.64 145.131 Td +/F1.0 10.5 Tf +<646562756720707572706f736573292e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 138.315 m +297.64 138.315 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 116.535 m +297.64 116.535 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 138.565 m +48.24 116.285 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 138.565 m +297.64 116.285 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 123.351 Td +/F1.0 10.5 Tf +<6e6f696d706f72746572726f72> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 138.315 m +547.04 138.315 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 116.535 m +547.04 116.535 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 138.565 m +297.64 116.285 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 138.565 m +547.04 116.285 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 123.351 Td +/F1.0 10.5 Tf +<496620747275652c20656d6974206e6f206572726f727320666f7220756e7265736f6c76656420696d706f7274732e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 116.535 m +297.64 116.535 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 94.755 m +297.64 94.755 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 116.785 m +48.24 94.505 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 116.785 m +297.64 94.505 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 101.571 Td +/F1.0 10.5 Tf +<7265666572656e6365696e666f> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 116.535 m +547.04 116.535 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 94.755 m +547.04 94.755 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 116.785 m +297.64 94.505 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 116.785 m +547.04 94.505 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 101.571 Td +/F1.0 10.5 Tf +<496620747275652c20636f6d70757465207265666572656e636520696e666f2e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 94.755 m +297.64 94.755 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 72.975 m +297.64 72.975 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 95.005 m +48.24 72.725 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 95.005 m +297.64 72.725 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 79.791 Td +/F1.0 10.5 Tf +<6c6f67> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 94.755 m +547.04 94.755 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 72.975 m +547.04 72.975 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 95.005 m +297.64 72.725 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 95.005 m +547.04 72.725 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 79.791 Td +/F1.0 10.5 Tf +<46696c6520746f206c6f6720636f6d70696c6572206d6573736167657320746f2e> Tj +ET + +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp1 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.978 14.263 Td +/F1.0 9 Tf +<3235> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +154 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 153 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F2.0 22 0 R +/F1.0 8 0 R +/F3.0 26 0 R +>> +/XObject << /Stamp1 360 0 R +>> +>> +>> +endobj +155 0 obj +<< /Length 17995 +>> +stream +q +/DeviceRGB cs +1.0 1.0 1.0 scn +48.24 784.11 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 784.11 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 746.55 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 746.55 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 708.99 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 708.99 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 687.21 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 687.21 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 665.43 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 665.43 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 627.87 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 627.87 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 558.75 249.4 69.12 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 558.75 249.4 69.12 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 521.19 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 521.19 249.4 37.56 re +f +0.0 0.0 0.0 scn +0.5 w +/DeviceRGB CS +0.8667 0.8667 0.8667 SCN +48.24 805.89 m +297.64 805.89 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +48.24 784.11 m +297.64 784.11 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 806.14 m +48.24 783.485 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 806.14 m +297.64 783.485 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 790.926 Td +/F2.0 10.5 Tf +<417474726962757465> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 805.89 m +547.04 805.89 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +297.64 784.11 m +547.04 784.11 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 806.14 m +297.64 783.485 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 806.14 m +547.04 783.485 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 790.926 Td +/F2.0 10.5 Tf +<4465736372697074696f6e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 784.11 m +297.64 784.11 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 746.55 m +297.64 746.55 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 784.36 m +48.24 746.3 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 784.36 m +297.64 746.3 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 769.146 Td +/F1.0 10.5 Tf +<656e636f64696e67> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 784.11 m +547.04 784.11 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 746.55 m +547.04 746.55 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 784.36 m +297.64 746.3 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 784.36 m +547.04 746.3 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 769.146 Td +/F1.0 10.5 Tf +<44656661756c7420736f7572636520656e636f64696e6720666f726d617420287065722d66696c65> Tj +ET + + +BT +300.64 753.366 Td +/F1.0 10.5 Tf +<656e636f64696e67206e6f7420737570706f7274656420696e20416e74207461736b73292e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 746.55 m +297.64 746.55 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 708.99 m +297.64 708.99 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 746.8 m +48.24 708.74 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 746.8 m +297.64 708.74 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 731.586 Td +/F1.0 10.5 Tf +<70726f636565644f6e4572726f72> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 746.55 m +547.04 746.55 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 708.99 m +547.04 708.99 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 746.8 m +297.64 708.74 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 746.8 m +547.04 708.74 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 731.586 Td +/F1.0 10.5 Tf +[<496620747275652c206b> 20.0195 <65657020636f6d70696c696e67206166746572206572726f727320656e636f756e74657265642c>] TJ +ET + + +BT +300.64 715.806 Td +/F1.0 10.5 Tf +<64756d70696e6720636c6173732066696c657320776974682070726f626c656d206d6574686f64732e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 708.99 m +297.64 708.99 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 687.21 m +297.64 687.21 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 709.24 m +48.24 686.96 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 709.24 m +297.64 686.96 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 694.026 Td +/F1.0 10.5 Tf +<70726f6772657373> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 708.99 m +547.04 708.99 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 687.21 m +547.04 687.21 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 709.24 m +297.64 686.96 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 709.24 m +547.04 686.96 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 694.026 Td +/F1.0 10.5 Tf +<496620747275652c20656d69742070726f677265737320287265717569726573206c6f67292e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 687.21 m +297.64 687.21 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 665.43 m +297.64 665.43 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 687.46 m +48.24 665.18 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 687.46 m +297.64 665.18 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 672.246 Td +/F1.0 10.5 Tf +<74696d65> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 687.21 m +547.04 687.21 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 665.43 m +547.04 665.43 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 687.46 m +297.64 665.18 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 687.46 m +547.04 665.18 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 672.246 Td +/F1.0 10.5 Tf +[<496620747275652c20646973706c61> 20.0195 <7920737065656420696e666f726d6174696f6e2e>] TJ +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 665.43 m +297.64 665.43 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 627.87 m +297.64 627.87 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 665.68 m +48.24 627.62 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 665.68 m +297.64 627.62 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 650.466 Td +/F1.0 10.5 Tf +<746172676574> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 665.43 m +547.04 665.43 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 627.87 m +547.04 627.87 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 665.68 m +297.64 627.62 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 665.68 m +547.04 627.62 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 650.466 Td +/F1.0 10.5 Tf +<537065636966792074617267657420636c6173732066696c6520666f726d6174206173206f6e65206f66205b> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +505.033 650.466 Td +/F3.0 10.5 Tf +<312e31> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +300.64 634.686 Td +/F3.0 10.5 Tf +<312e32> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +316.39 634.686 Td +/F1.0 10.5 Tf +<5d2e2044656661756c747320746f20312e3120636c6173732066696c652e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 627.87 m +297.64 627.87 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 558.75 m +297.64 558.75 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 628.12 m +48.24 558.5 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 628.12 m +297.64 558.5 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 612.906 Td +/F1.0 10.5 Tf +<736f75726365> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 627.87 m +547.04 627.87 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 558.75 m +547.04 558.75 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 628.12 m +297.64 558.5 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 628.12 m +547.04 558.5 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 612.906 Td +/F1.0 10.5 Tf +<53657420736f7572636520636f6d706c69616e6365206c6576656c20746f206f6e65206f66205b> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +491.236 612.906 Td +/F3.0 10.5 Tf +<312e3320312e34> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +300.64 597.126 Td +/F3.0 10.5 Tf +<312e35> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +316.39 597.126 Td +/F1.0 10.5 Tf +<5d202864656661756c7420697320312e34292e20312e3320696d706c696573202d736f7572636520312e3320616e64> Tj +ET + + +BT +300.64 581.346 Td +/F1.0 10.5 Tf +<2d74617267657420312e312e20312e3420696d706c696573202d736f7572636520312e3420616e64202d74617267657420312e322e> Tj +ET + + +BT +300.64 565.566 Td +/F1.0 10.5 Tf +<312e3520696d706c696573202d736f7572636520312e3520616e64202d74617267657420312e352e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 558.75 m +297.64 558.75 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 521.19 m +297.64 521.19 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 559.0 m +48.24 520.94 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 559.0 m +297.64 520.94 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 543.786 Td +/F1.0 10.5 Tf +<736f75726365> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 558.75 m +547.04 558.75 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 521.19 m +547.04 521.19 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 559.0 m +297.64 520.94 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 559.0 m +547.04 520.94 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 543.786 Td +/F1.0 10.5 Tf +<53657420736f7572636520617373657274696f6e206d6f646520746f206f6e65206f66205b> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +483.613 543.786 Td +/F3.0 10.5 Tf +<312e3320312e34> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +520.363 543.786 Td +/F1.0 10.5 Tf +<5d2e> Tj +ET + + +BT +300.64 528.006 Td +/F1.0 10.5 Tf +<44656661756c7420646570656e6473206f6e20636f6d706c69616e6365206d6f64652e> Tj +ET + +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 490.506 Td +/F2.0 13 Tf +[<342e332e322e20416a6354> 29.7852 <61736b206d61746368696e6720706172> 20.0195 <616d657465727320737065636966696564206173206e657374656420656c656d656e7473>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0232 Tw + +BT +48.24 463.946 Td +/F1.0 10.5 Tf +<54686973207461736b20666f726d7320616e20696d706c696369742046696c6553657420616e6420737570706f72747320616c6c2061747472696275746573206f6620> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.0232 Tw + +BT +379.0631 463.946 Td +/F3.0 10.5 Tf +<3c66696c657365743e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0232 Tw + +BT +426.3131 463.946 Td +/F1.0 10.5 Tf +<2028646972206265636f6d65732073726364697229206173> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6513 Tw + +BT +48.24 448.166 Td +/F1.0 10.5 Tf +<77656c6c20617320746865206e657374656420> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.6513 Tw + +BT +146.3738 448.166 Td +/F3.0 10.5 Tf +<3c696e636c7564653e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6513 Tw + +BT +193.6238 448.166 Td +/F1.0 10.5 Tf +<2c20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.6513 Tw + +BT +200.6196 448.166 Td +/F3.0 10.5 Tf +<3c6578636c7564653e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6513 Tw + +BT +247.8696 448.166 Td +/F1.0 10.5 Tf +<2c20616e6420> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.6513 Tw + +BT +278.3462 448.166 Td +/F3.0 10.5 Tf +<3c7061747465726e7365743e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6513 Tw + +BT +341.3463 448.166 Td +/F1.0 10.5 Tf +<20656c656d656e74732e2054686573652063616e206265207573656420746f2073706563696679> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2035 Tw + +BT +48.24 432.386 Td +/F1.0 10.5 Tf +<736f757263652066696c65732e20486f77657665722c2069742069732062657474657220746f2075736520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.2035 Tw + +BT +248.4653 432.386 Td +/F3.0 10.5 Tf +<736f75726365726f6f7473> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2035 Tw + +BT +306.2153 432.386 Td +/F1.0 10.5 Tf +<20746f207370656369667920736f75726365206469726563746f7269657320756e6c657373207573696e672066696c74657273> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 416.606 Td +/F1.0 10.5 Tf +<746f206578636c75646520736f6d652066696c65732066726f6d20636f6d70696c6174696f6e2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 382.106 Td +/F2.0 13 Tf +[<342e332e332e20416a6354> 29.7852 <61736b20506174682d6c696b> 20.0195 <652053747275637475726573>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.7593 Tw + +BT +48.24 355.546 Td +/F1.0 10.5 Tf +[<536f6d6520706172> 20.0195 <616d65746572732061726520706174682d6c696b> 20.0195 <65207374727563747572657320636f6e7461696e696e67206f6e65206f72206d6f726520656c656d656e74733b2074686573652061726520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.7593 Tw + +BT +486.665 355.546 Td +/F3.0 10.5 Tf +<736f75726365726f6f7473> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.7593 Tw + +BT +544.415 355.546 Td +/F1.0 10.5 Tf +<2c> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.0918 Tw + +BT +48.24 339.766 Td +/F3.0 10.5 Tf +<61726766696c6573> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0918 Tw + +BT +90.24 339.766 Td +/F1.0 10.5 Tf +<2c20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.0918 Tw + +BT +96.6763 339.766 Td +/F3.0 10.5 Tf +<696e6a617273> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0918 Tw + +BT +128.1763 339.766 Td +/F1.0 10.5 Tf +<2c20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.0918 Tw + +BT +134.6125 339.766 Td +/F3.0 10.5 Tf +<696e70617468> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0918 Tw + +BT +166.1125 339.766 Td +/F1.0 10.5 Tf +<2c20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.0918 Tw + +BT +172.5488 339.766 Td +/F3.0 10.5 Tf +<636c61737370617468> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0918 Tw + +BT +219.7988 339.766 Td +/F1.0 10.5 Tf +<2c20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.0918 Tw + +BT +226.2351 339.766 Td +/F3.0 10.5 Tf +<626f6f74636c61737370617468> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0918 Tw + +BT +294.4851 339.766 Td +/F1.0 10.5 Tf +<2c20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.0918 Tw + +BT +300.9214 339.766 Td +/F3.0 10.5 Tf +<666f726b636c61737370617468> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0918 Tw + +BT +369.1714 339.766 Td +/F1.0 10.5 Tf +<2c20616e6420> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.0918 Tw + +BT +398.5289 339.766 Td +/F3.0 10.5 Tf +<61737065637470617468> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0918 Tw + +BT +451.0289 339.766 Td +/F1.0 10.5 Tf +<2e20496e20616c6c2063617365732c207468657365> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 323.986 Td +/F1.0 10.5 Tf +[<6d61> 20.0195 <7920626520737065636966696564206173206e657374656420656c656d656e74732c20736f6d657468696e67206c696b> 20.0195 <6520746869733a>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 308.17 m +543.04 308.17 l +545.2491 308.17 547.04 306.3791 547.04 304.17 c +547.04 172.25 l +547.04 170.0409 545.2491 168.25 543.04 168.25 c +52.24 168.25 l +50.0309 168.25 48.24 170.0409 48.24 172.25 c +48.24 304.17 l +48.24 306.3791 50.0309 308.17 52.24 308.17 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 308.17 m +543.04 308.17 l +545.2491 308.17 547.04 306.3791 547.04 304.17 c +547.04 172.25 l +547.04 170.0409 545.2491 168.25 543.04 168.25 c +52.24 168.25 l +50.0309 168.25 48.24 170.0409 48.24 172.25 c +48.24 304.17 l +48.24 306.3791 50.0309 308.17 52.24 308.17 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 285.345 Td +/F3.0 11 Tf +<3c69616a63207b617474726962757465732e2e7d202f3e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 270.605 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 255.865 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 241.125 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 226.385 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 211.645 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 196.905 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 182.165 Td +/F3.0 11 Tf +<3c2f69616a633e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.8336 Tw + +BT +48.24 144.286 Td +/F1.0 10.5 Tf +[<41732077697468206f7468657220506174682d6c696b> 20.0195 <6520737472756374757265732c2074686579206d61> 20.0195 <7920626520646566696e656420656c7365776865726520616e6420737065636966696564207573696e6720746865207265666964>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 128.506 Td +/F1.0 10.5 Tf +<6174747269627574653a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp2 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +49.24 14.263 Td +/F1.0 9 Tf +<3236> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +156 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 155 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F2.0 22 0 R +/F1.0 8 0 R +/F3.0 26 0 R +>> +/XObject << /Stamp2 361 0 R +>> +>> +>> +endobj +157 0 obj +[156 0 R /XYZ 0 509.19 null] +endobj +158 0 obj +[156 0 R /XYZ 0 400.79 null] +endobj +159 0 obj +<< /Length 10122 +>> +stream +q +q +/DeviceRGB cs +0.9608 0.9608 0.9608 scn +52.24 805.89 m +543.04 805.89 l +545.2491 805.89 547.04 804.0991 547.04 801.89 c +547.04 655.23 l +547.04 653.0209 545.2491 651.23 543.04 651.23 c +52.24 651.23 l +50.0309 651.23 48.24 653.0209 48.24 655.23 c +48.24 801.89 l +48.24 804.0991 50.0309 805.89 52.24 805.89 c +h +f +/DeviceRGB CS +0.8 0.8 0.8 SCN +0.75 w +52.24 805.89 m +543.04 805.89 l +545.2491 805.89 547.04 804.0991 547.04 801.89 c +547.04 655.23 l +547.04 653.0209 545.2491 651.23 543.04 651.23 c +52.24 651.23 l +50.0309 651.23 48.24 653.0209 48.24 655.23 c +48.24 801.89 l +48.24 804.0991 50.0309 805.89 52.24 805.89 c +h +S +Q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +59.24 783.065 Td +/F3.0 11 Tf +<3c706174682069643d226173706563742e70617468223e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 768.325 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 753.585 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 738.845 Td +/F3.0 11 Tf +<3c2f706174683e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 724.105 Td +/F3.0 11 Tf +<2e2e2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 709.365 Td +/F3.0 11 Tf +<3c69616a63207b617474726962757465732e2e7d202f3e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 694.625 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 679.885 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 665.145 Td +/F3.0 11 Tf +<3c2f69616a633e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 627.266 Td +/F1.0 10.5 Tf +<546865207461736b20616c736f20737570706f72747320616e2061747472696275746520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +224.0415 627.266 Td +/F3.0 10.5 Tf +<7b6e616d657d726566> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +271.2915 627.266 Td +/F1.0 10.5 Tf +[<20666f722065616368207375636820706172> 20.0195 <616d657465722e20452e672e2c20666f7220>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +442.0948 627.266 Td +/F3.0 10.5 Tf +<61737065637470617468> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +494.5948 627.266 Td +/F1.0 10.5 Tf +<3a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 611.45 m +543.04 611.45 l +545.2491 611.45 547.04 609.6591 547.04 607.45 c +547.04 578.71 l +547.04 576.5009 545.2491 574.71 543.04 574.71 c +52.24 574.71 l +50.0309 574.71 48.24 576.5009 48.24 578.71 c +48.24 607.45 l +48.24 609.6591 50.0309 611.45 52.24 611.45 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 611.45 m +543.04 611.45 l +545.2491 611.45 547.04 609.6591 547.04 607.45 c +547.04 578.71 l +547.04 576.5009 545.2491 574.71 543.04 574.71 c +52.24 574.71 l +50.0309 574.71 48.24 576.5009 48.24 578.71 c +48.24 607.45 l +48.24 609.6591 50.0309 611.45 52.24 611.45 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 588.625 Td +/F3.0 11 Tf +<3c69616a63207b617474726962757465732e2e7d20617370656374706174687265663d226173706563742e70617468222f3e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 544.026 Td +/F2.0 13 Tf +<342e332e342e2053616d706c65206f662069616a63207461736b> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 517.466 Td +/F1.0 10.5 Tf +<41206d696e696d616c206275696c642073637269707420646566696e657320746865207461736b20616e642072756e732069742c2073706563696679696e672074686520736f75726365733a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 501.65 m +543.04 501.65 l +545.2491 501.65 547.04 499.8591 547.04 497.65 c +547.04 292.03 l +547.04 289.8209 545.2491 288.03 543.04 288.03 c +52.24 288.03 l +50.0309 288.03 48.24 289.8209 48.24 292.03 c +48.24 497.65 l +48.24 499.8591 50.0309 501.65 52.24 501.65 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 501.65 m +543.04 501.65 l +545.2491 501.65 547.04 499.8591 547.04 497.65 c +547.04 292.03 l +547.04 289.8209 545.2491 288.03 543.04 288.03 c +52.24 288.03 l +50.0309 288.03 48.24 289.8209 48.24 292.03 c +48.24 497.65 l +48.24 499.8591 50.0309 501.65 52.24 501.65 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 478.825 Td +/F3.0 11 Tf +<3c70726f6a656374206e616d653d2273696d706c652d6578616d706c65222064656661756c743d22636f6d70696c6522203e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 464.085 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 449.345 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 434.605 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 419.865 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 405.125 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 390.385 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 360.905 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 346.165 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 331.425 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 316.685 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 301.945 Td +/F3.0 11 Tf +<3c2f70726f6a6563743e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 264.066 Td +/F1.0 10.5 Tf +<42656c6f77206973207363726970742077697468206d6f73742065766572797468696e6720696e2069742e2054686520636f6d70696c652070726f63657373c9> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +52.6765 236.286 Td +/F1.0 10.5 Tf +<312e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 236.286 Td +/F1.0 10.5 Tf +<52756e7320696e20696e6372656d656e74616c206d6f64652c207265636f6d70696c696e67207768656e20746865207573657220686974732072657475726e3b> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +52.6765 214.506 Td +/F1.0 10.5 Tf +<322e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 214.506 Td +/F1.0 10.5 Tf +<526561647320616c6c2074686520736f757263652066696c65732066726f6d2074776f206469726563746f726965733b> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +52.6765 192.726 Td +/F1.0 10.5 Tf +<332e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 192.726 Td +/F1.0 10.5 Tf +<52656164732062696e617279202e636c6173732066696c65732066726f6d20696e707574206a617220616e64206469726563746f72793b> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +52.6765 170.946 Td +/F1.0 10.5 Tf +<342e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 170.946 Td +/F1.0 10.5 Tf +[<5573657320612062696e61727920617370656374206c696272> 20.0195 <61727920666f722070657273697374656e63653b>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +52.6765 149.166 Td +/F1.0 10.5 Tf +<352e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 149.166 Td +/F1.0 10.5 Tf +<4f75747075747320746f20616e206170706c69636174696f6e206a61723b20616e64> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +52.6765 127.386 Td +/F1.0 10.5 Tf +<362e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.4145 Tw + +BT +66.24 127.386 Td +/F1.0 10.5 Tf +<436f70696573207265736f75726365732066726f6d2074686520736f75726365206469726563746f7269657320616e642062696e61727920696e707574206a617220616e64206469726563746f7269657320746f20746865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 111.606 Td +/F1.0 10.5 Tf +<6170706c69636174696f6e206a61722e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.3624 Tw + +BT +48.24 83.826 Td +/F1.0 10.5 Tf +<5768656e207468697320746172676574206973206275696c742c2074686520636f6d70696c65722077696c6c206275696c64206f6e636520616e64207468656e207761697420666f7220696e7075742066726f6d2074686520757365722e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 68.046 Td +/F1.0 10.5 Tf +<4d6573736167657320617265207072696e74656420617320757375616c2e205768656e2074686520757365722068617320717569742c207468656e20746869732072756e7320746865206170706c69636174696f6e2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp1 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.978 14.263 Td +/F1.0 9 Tf +<3237> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +160 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 159 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F3.0 26 0 R +/F1.0 8 0 R +/F2.0 22 0 R +>> +/XObject << /Stamp1 360 0 R +>> +>> +>> +endobj +161 0 obj +[160 0 R /XYZ 0 562.71 null] +endobj +162 0 obj +<< /Length 7421 +>> +stream +q +q +/DeviceRGB cs +0.9608 0.9608 0.9608 scn +52.24 805.89 m +543.04 805.89 l +545.2491 805.89 547.04 804.0991 547.04 801.89 c +547.04 360.43 l +547.04 358.2209 545.2491 356.43 543.04 356.43 c +52.24 356.43 l +50.0309 356.43 48.24 358.2209 48.24 360.43 c +48.24 801.89 l +48.24 804.0991 50.0309 805.89 52.24 805.89 c +h +f +/DeviceRGB CS +0.8 0.8 0.8 SCN +0.75 w +52.24 805.89 m +543.04 805.89 l +545.2491 805.89 547.04 804.0991 547.04 801.89 c +547.04 360.43 l +547.04 358.2209 545.2491 356.43 543.04 356.43 c +52.24 356.43 l +50.0309 356.43 48.24 358.2209 48.24 360.43 c +48.24 801.89 l +48.24 804.0991 50.0309 805.89 52.24 805.89 c +h +S +Q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +59.24 783.065 Td +/F3.0 11 Tf +<3c746172676574206e616d653d226275696c642d7465737422203e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 768.325 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 753.585 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 738.845 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 724.105 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 709.365 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 694.625 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 679.885 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 665.145 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 650.405 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 635.665 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 620.925 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 606.185 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 591.445 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 576.705 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 561.965 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 547.225 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 532.485 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 517.745 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 503.005 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 473.525 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 458.785 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 444.045 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 429.305 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 414.565 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 399.825 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 385.085 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 370.345 Td +/F3.0 11 Tf +<3c2f7461726765743e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 332.466 Td +/F1.0 10.5 Tf +[<46> 40.0391 <6f7220616e206578616d706c65206f662061206275696c64207363726970742c20736565202e2e2f6578616d706c65732f6275696c642e786d6c2e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 297.966 Td +/F2.0 13 Tf +[<342e332e352e2041> 60.0586 <766f6964696e6720636c65616e20636f6d70696c6573>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.3569 Tw + +BT +48.24 271.406 Td +/F1.0 10.5 Tf +[<556e6c696b> 20.0195 <65206a617661632c2074686520616a6320636f6d70696c657220616c7761> 20.0195 <79732070726f63657373657320616c6c20696e7075742062656361757365206e657720617370656374732063616e206170706c7920746f2075706461746564>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.0499 Tw + +BT +48.24 255.626 Td +/F1.0 10.5 Tf +<636c617373657320616e6420766963652d76657273612e20486f77657665722c20696e207468652063617365207768657265206e6f2066696c65732068617665206265656e20757064617465642c207468657265206973206e6f20726561736f6e20746f> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.2581 Tw + +BT +48.24 239.846 Td +/F1.0 10.5 Tf +[<7265636f6d70696c6520736f75726365732e204f6e65207761> 20.0195 <7920746f20696d706c656d656e742074686174206973207769746820616e206578706c6963697420646570656e64656e637920636865636b207573696e6720746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 224.066 Td +/F1.0 10.5 Tf +<7570746f64617465207461736b3a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp2 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +49.24 14.263 Td +/F1.0 9 Tf +<3238> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +163 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 162 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F3.0 26 0 R +/F1.0 8 0 R +/F2.0 22 0 R +>> +/XObject << /Stamp2 361 0 R +>> +>> +>> +endobj +164 0 obj +[163 0 R /XYZ 0 316.65 null] +endobj +165 0 obj +<< /Length 11307 +>> +stream +q +q +/DeviceRGB cs +0.9608 0.9608 0.9608 scn +52.24 805.89 m +543.04 805.89 l +545.2491 805.89 547.04 804.0991 547.04 801.89 c +547.04 625.75 l +547.04 623.5409 545.2491 621.75 543.04 621.75 c +52.24 621.75 l +50.0309 621.75 48.24 623.5409 48.24 625.75 c +48.24 801.89 l +48.24 804.0991 50.0309 805.89 52.24 805.89 c +h +f +/DeviceRGB CS +0.8 0.8 0.8 SCN +0.75 w +52.24 805.89 m +543.04 805.89 l +545.2491 805.89 547.04 804.0991 547.04 801.89 c +547.04 625.75 l +547.04 623.5409 545.2491 621.75 543.04 621.75 c +52.24 621.75 l +50.0309 621.75 48.24 623.5409 48.24 625.75 c +48.24 801.89 l +48.24 804.0991 50.0309 805.89 52.24 805.89 c +h +S +Q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +59.24 783.065 Td +/F3.0 11 Tf +<3c746172676574206e616d653d22636865636b2e617370656374732e6a6172223e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 768.325 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 753.585 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 738.845 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 724.105 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 709.365 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 694.625 Td +/F3.0 11 Tf +<3c2f7461726765743e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 665.145 Td +/F3.0 11 Tf +<3c746172676574206e616d653d22636f6d70696c652e617370656374732220646570656e64733d22707265706172652c636865636b2e617370656374732e6a617222> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 650.405 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 635.665 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6558 Tw + +BT +48.24 597.786 Td +/F1.0 10.5 Tf +<5768656e207573696e67207468697320746563686e697175652c206265206361726566756c20746f2076657269667920746861742062696e61727920696e707574206a61727320617265207468656d73656c7665732075702d746f2d64617465> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 582.006 Td +/F1.0 10.5 Tf +[<6166746572207468657920776f756c642068617665206265656e206d6f6469666965642062> 20.0195 <7920616e> 20.0195 <79206275696c6420636f6d6d616e64732e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 547.506 Td +/F2.0 13 Tf +[<342e332e362e2050726f6772> 20.0195 <616d6d61746963616c6c792068616e646c696e6720636f6d70696c6572206d65737361676573>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.4825 Tw + +BT +48.24 520.946 Td +/F1.0 10.5 Tf +[<5573657273206d61> 20.0195 <7920737065636966792061206d65737361676520686f6c64657220746f2077686963682074686520636f6d70696c65722077696c6c207061737320616c6c206d65737361676573206173207468657920617265>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1265 Tw + +BT +48.24 505.166 Td +/F1.0 10.5 Tf +[<67656e6572> 20.0195 <617465642e20546869732077696c6c206f7665727269646520616c6c206f6620746865206e6f726d616c206d657373616765207072696e74696e672c2062757420646f6573206e6f742070726576656e7420746865207461736b2066726f6d>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1004 Tw + +BT +48.24 489.386 Td +/F1.0 10.5 Tf +<6661696c696e6720696620657863657074696f6e732077657265207468726f776e206f72206966206661696c6f6e6572726f72206973207472756520616e642074686520636f6d70696c6572206465746563746564206572726f727320696e20746865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 473.606 Td +/F1.0 10.5 Tf +<736f75726365732e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.5797 Tw + +BT +48.24 445.826 Td +/F1.0 10.5 Tf +[<48616e646c696e67206d657373616765732070726f6772> 20.0195 <616d6d61746963616c6c7920636f756c642062652075736566756c207768656e207573696e672074686520636f6d70696c657220746f2076657269667920636f64652e204966>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.7458 Tw + +BT +48.24 430.046 Td +/F1.0 10.5 Tf +<6173706563747320636f6e73697374206f66206465636c617265205b6572726f727c7761726e696e675d2c207468656e2074686520636f6d70696c65722063616e2061637420746f2064657465637420696e76617269616e747320696e20746865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2351 Tw + +BT +48.24 414.266 Td +/F1.0 10.5 Tf +[<636f6465206265696e672070726f6365737365642e2046> 40.0391 <6f7220636f646520746f20636f6d7061726520657870656374656420616e642061637475616c206d657373616765732c2073656520746865204173706563744a2074657374696e67>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 398.486 Td +/F1.0 10.5 Tf +<6d6f64756c6520287768696368206973206e6f7420696e636c7564656420696e207468652062696e61727920646973747269627574696f6e292e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 358.646 Td +/F2.0 18 Tf +[<342e342e20416a633131436f6d70696c657241> 20.0195 <64617074657220286a6176616329>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.3467 Tw + +BT +48.24 330.626 Td +/F1.0 10.5 Tf +[<5468697320436f6d70696c657241> 20.0195 <6461707465722063616e206265207573656420696e206a61766163207461736b2063616c6c732062> 20.0195 <792073657474696e672074686520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.3467 Tw + +BT +398.4999 330.626 Td +/F3.0 10.5 Tf +<6275696c642e636f6d70696c6572> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.3467 Tw + +BT +471.9999 330.626 Td +/F1.0 10.5 Tf +[<2070726f7065727479> 89.8438 <2e2054686973>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4461 Tw + +BT +48.24 314.846 Td +/F1.0 10.5 Tf +<656e61626c657320757365727320746f20746f20656173696c7920737769746368206265747765656e20746865204a6176616320616e64204173706563744a20636f6d70696c6572732e20486f77657665722c2062656361757365207468657265> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2644 Tw + +BT +48.24 299.066 Td +/F1.0 10.5 Tf +<61726520646966666572656e63657320696e20736f757263652066696c652068616e646c696e67206265747765656e20746865204a61766163207461736b20616e642074686520616a6320636f6d70696c65722c206e6f7420616c6c204a61766163> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.46 Tw + +BT +48.24 283.286 Td +/F1.0 10.5 Tf +[<7461736b20696e766f636174696f6e732063616e206265207475726e6564206f76657220746f2069616a632e20486f77657665722c20616a632063616e20636f6d70696c6520616e> 20.0195 <797468696e672074686174204a617661632063616e2c20736f206974>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5111 Tw + +BT +48.24 267.506 Td +/F1.0 10.5 Tf +[<73686f756c6420626520706f737369626c6520666f7220616e> 20.0195 <7920676976656e20636f6d70696c65206a6f6220746f207265737461746520746865204a61766163207461736b20696e2061207761> 20.0195 <7920746861742063616e2062652068616e646c6564>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 251.726 Td +/F1.0 10.5 Tf +[<62> 20.0195 <792069616a632f616a632e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 217.226 Td +/F2.0 13 Tf +<342e342e312e2053616d706c65206f6620636f6d70696c65722061646170746572> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +4.7303 Tw + +BT +48.24 190.666 Td +/F1.0 10.5 Tf +[<54> 29.7852 <6f206275696c64207573696e672074686520616461707465722c207075742074686520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +4.7303 Tw + +BT +256.1478 190.666 Td +/F3.0 10.5 Tf +<6173706563746a746f6f6c732e6a6172> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +4.7303 Tw + +BT +340.1478 190.666 Td +/F1.0 10.5 Tf +<206f6e207468652073797374656d2f616e7420636c617373706174682028652e672e2c20696e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.7708 Tw + +BT +48.24 174.886 Td +/F3.0 10.5 Tf +<247b414e545f484f4d457d2f6c6962> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.7708 Tw + +BT +126.99 174.886 Td +/F1.0 10.5 Tf +<2920616e6420646566696e652074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.7708 Tw + +BT +215.3327 174.886 Td +/F3.0 10.5 Tf +<6275696c642e636f6d70696c6572> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.7708 Tw + +BT +288.8327 174.886 Td +/F1.0 10.5 Tf +<2070726f7065727479206173207468652066756c6c792d7175616c6966696564206e616d65206f662074686520636c6173732c> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +48.24 159.106 Td +/F3.0 10.5 Tf +<6f72672e6173706563746a2e746f6f6c732e616e742e7461736b646566732e416a633131436f6d70696c657241646170746572> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +315.99 159.106 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.9614 Tw + +BT +48.24 131.326 Td +/F1.0 10.5 Tf +[<546865204173706563744a20636f6d70696c65722073686f756c642072756e20666f7220616e> 20.0195 <7920636f6d70696c65207573696e6720746865204a61766163207461736b2028666f72206f7074696f6e732c207365652074686520416e74>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5459 Tw + +BT +48.24 115.546 Td +/F1.0 10.5 Tf +[<646f63756d656e746174696f6e20666f7220746865204a61766163207461736b292e2046> 40.0391 <6f72206578616d706c652c207468652063616c6c2062656c6f772070617373657320616c6c206f75742d6f662d6461746520736f757263652066696c657320696e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 99.766 Td +/F1.0 10.5 Tf +<74686520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +66.93 99.766 Td +/F3.0 10.5 Tf +<7372632f6f72672f6173706563746a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +145.68 99.766 Td +/F1.0 10.5 Tf +<207375626469726563746f7269657320746f2074686520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +254.0295 99.766 Td +/F3.0 10.5 Tf +<616a63> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +269.7795 99.766 Td +/F1.0 10.5 Tf +<20636f6d6d616e6420616c6f6e672077697468207468652064657374696e6174696f6e206469726563746f72793a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp1 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.978 14.263 Td +/F1.0 9 Tf +<3239> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +166 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 165 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F3.0 26 0 R +/F1.0 8 0 R +/F2.0 22 0 R +>> +/XObject << /Stamp1 360 0 R +>> +>> +>> +endobj +167 0 obj +[166 0 R /XYZ 0 566.19 null] +endobj +168 0 obj +[166 0 R /XYZ 0 382.67 null] +endobj +169 0 obj +[166 0 R /XYZ 0 235.91 null] +endobj +170 0 obj +<< /Limits [(antTasks-iajc-paths) (classpathInpathAndAspectpath)] +/Names [(antTasks-iajc-paths) 158 0 R (antTasks-iajc-sample) 161 0 R (antTasks-iajc-uptodate) 164 0 R (antTasks-install) 126 0 R (antTasks-intro) 121 0 R (antTasks-knownProblems) 193 0 R (antTasks-nested-includes) 157 0 R (antTasks-problems) 192 0 R (binaryCompatibility) 248 0 R (bytecode-concepts) 29 0 R (classpathInpathAndAspectpath) 32 0 R] +>> +endobj +171 0 obj +<< /Length 12008 +>> +stream +q +q +/DeviceRGB cs +0.9608 0.9608 0.9608 scn +52.24 805.89 m +543.04 805.89 l +545.2491 805.89 547.04 804.0991 547.04 801.89 c +547.04 655.23 l +547.04 653.0209 545.2491 651.23 543.04 651.23 c +52.24 651.23 l +50.0309 651.23 48.24 653.0209 48.24 655.23 c +48.24 801.89 l +48.24 804.0991 50.0309 805.89 52.24 805.89 c +h +f +/DeviceRGB CS +0.8 0.8 0.8 SCN +0.75 w +52.24 805.89 m +543.04 805.89 l +545.2491 805.89 547.04 804.0991 547.04 801.89 c +547.04 655.23 l +547.04 653.0209 545.2491 651.23 543.04 651.23 c +52.24 651.23 l +50.0309 651.23 48.24 653.0209 48.24 655.23 c +48.24 801.89 l +48.24 804.0991 50.0309 805.89 52.24 805.89 c +h +S +Q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +59.24 783.065 Td +/F3.0 11 Tf +<2d2d20636f6d6d616e643a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 753.585 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 738.845 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 724.105 Td +/F3.0 11 Tf +<2e2e2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 694.625 Td +/F3.0 11 Tf +<2d2d207461736b20696e766f636174696f6e20696e20746865206275696c64207363726970743a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 665.145 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 627.266 Td +/F1.0 10.5 Tf +[<54> 29.7852 <6f207061737320616a632d737065636966696320617267756d656e74732c20757365206120636f6d70696c6572> 20.0195 <61726720656e747279> 89.8438 <2e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 611.45 m +543.04 611.45 l +545.2491 611.45 547.04 609.6591 547.04 607.45 c +547.04 416.57 l +547.04 414.3609 545.2491 412.57 543.04 412.57 c +52.24 412.57 l +50.0309 412.57 48.24 414.3609 48.24 416.57 c +48.24 607.45 l +48.24 609.6591 50.0309 611.45 52.24 611.45 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 611.45 m +543.04 611.45 l +545.2491 611.45 547.04 609.6591 547.04 607.45 c +547.04 416.57 l +547.04 414.3609 545.2491 412.57 543.04 412.57 c +52.24 412.57 l +50.0309 412.57 48.24 414.3609 48.24 416.57 c +48.24 607.45 l +48.24 609.6591 50.0309 611.45 52.24 611.45 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 588.625 Td +/F3.0 11 Tf +<2d2d20636f6d6d616e64> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 559.145 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 529.665 Td +/F3.0 11 Tf +<2d2d206275696c6420736372697074> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 500.185 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 485.445 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 455.965 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 441.225 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 426.485 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5317 Tw + +BT +48.24 388.606 Td +/F1.0 10.5 Tf +[<546865204a61766163207461736b20646f6573207370656369616c2068616e646c696e67206f6620736f757263652066696c657320746861742063616e20696e74657266657265207769746820616a632e2049742072656d6f76657320616e> 20.0195 <792066696c6573>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.5832 Tw + +BT +48.24 372.826 Td +/F1.0 10.5 Tf +<7468617420617265206e6f74206f75742d6f662d646174652077697468207265737065637420746f2074686520636f72726573706f6e64696e67202e636c6173732066696c65732e2042757420616a6320726571756972657320616c6c20736f75726365> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.8909 Tw + +BT +48.24 357.046 Td +/F1.0 10.5 Tf +[<66696c65732c2073696e636520616e20617370656374206d61> 20.0195 <7920616666656374206120736f757263652066696c652074686174206973206e6f74206f7574206f6620646174652e202846> 40.0391 <6f72206120736f6c7574696f6e20746f20746869732c2073656520746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.095 Tw + +BT +48.24 341.266 Td +/F3.0 10.5 Tf +<6275696c642e636f6d70696c65722e636c65616e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.095 Tw + +BT +153.24 341.266 Td +/F1.0 10.5 Tf +[<2070726f7065727479206465736372696265642062656c6f77> 69.8242 <2e2920436f6e76657273656c79> 89.8438 <2c20646576656c6f7065727320736f6d6574696d65732073706563696679206120736f75726365>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5359 Tw + +BT +48.24 325.486 Td +/F1.0 10.5 Tf +<6469726563746f727920746f206a617661632c20616e64206c65742069742073656172636820666f722066696c657320666f722074797065732069742063616e6e6f742066696e642e204173706563744a2077696c6c206e6f7420646f2074686973206b696e64206f66> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.4957 Tw + +BT +48.24 309.706 Td +/F1.0 10.5 Tf +[<736561726368696e6720756e6465722074686520736f75726365206469726563746f7279202873696e6365207468652070726f6772> 20.0195 <616d6d6572206e6565647320746f20636f6e74726f6c20776869636820736f757263657320617265>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4613 Tw + +BT +48.24 293.926 Td +/F1.0 10.5 Tf +[<6166666563746564292e2028446f6ed57420636f6e667573652074686520736f75726365206469726563746f727920757365642062> 20.0195 <79204a6176616320776974682074686520736f7572636520726f6f7420757365642062> 20.0195 <7920616a633b20696620796f75>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.103 Tw + +BT +48.24 278.146 Td +/F1.0 10.5 Tf +[<73706563696679206120736f7572636520726f6f7420746f20616a632c2069742077696c6c20636f6d70696c6520616e> 20.0195 <7920736f757263652066696c6520756e646572207468617420736f7572636520726f6f742028776974686f757420657863657074696f6e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 262.366 Td +/F1.0 10.5 Tf +[<6f722066696c746572696e67292e292054> 29.7852 <6f207265706c61636520736f757263652064697220736561726368696e6720696e204a617661632c2075736520616e20416e742066696c74657220746f20737065636966792074686520736f757263652066696c65732e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 227.866 Td +/F2.0 13 Tf +[<342e342e322e20436f6d70696c6572206164617074657220636f6d70696c6572> 20.0195 <617267206f7074696f6e73>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.204 Tw + +BT +48.24 201.306 Td +/F1.0 10.5 Tf +[<546865206164617074657220737570706f72747320616e> 20.0195 <7920616a6320636f6d6d616e642d6c696e65206f7074696f6e20706173736564207573696e6720636f6d70696c6572> 20.0195 <6172672c2061732077656c6c20617320746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.9332 Tw + +BT +48.24 185.526 Td +/F1.0 10.5 Tf +[<666f6c6c6f77696e67206f7074696f6e7320617661696c61626c65206f6e6c7920696e20416a6354> 29.7852 <61736b2e2046696e64206d6f72652064657461696c73206f6e2074686520666f6c6c6f77696e67206f7074696f6e7320696e20>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +0.9332 Tw + +BT +508.4502 185.526 Td +/F1.0 10.5 Tf +[<416a6354> 29.7852 <61736b>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +48.24 169.746 Td +/F1.0 10.5 Tf +<2869616a6329> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +73.062 169.746 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 141.966 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 141.966 Td +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +66.24 141.966 Td +/F3.0 10.5 Tf +<2d586d61786d656d> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +108.24 141.966 Td +/F1.0 10.5 Tf +<3a20736574206d6178696d756d206d656d6f727920666f7220666f726b696e672028616c736f207365747461626c6520696e206a61766163292e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 120.186 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 120.186 Td +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +66.24 120.186 Td +/F3.0 10.5 Tf +<2d586c69737466696c6561726773> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +139.74 120.186 Td +/F1.0 10.5 Tf +<3a206c6973742066696c6520617267756d656e74732028616c736f207365747461626c6520696e206a61766163292e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 98.406 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 98.406 Td +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +66.24 98.406 Td +/F3.0 10.5 Tf +<2d586661696c6f6e6572726f72> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +134.49 98.406 Td +/F1.0 10.5 Tf +<3a207468726f77204275696c64457863657074696f6e206f6e20636f6d70696c6572206572726f722028616c736f207365747461626c6520696e206a61766163292e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 76.626 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 76.626 Td +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +66.24 76.626 Td +/F3.0 10.5 Tf +<2d586d657373616765686f6c646572636c617373> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +171.24 76.626 Td +/F1.0 10.5 Tf +<3a20737065636966792066756c6c792d7175616c6966696564206e616d65206f6620636c61737320746f2075736520617320746865206d65737361676520686f6c6465722e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 54.846 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 54.846 Td +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +66.24 54.846 Td +/F3.0 10.5 Tf +<2d58636f7079696e6a617273> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +129.24 54.846 Td +/F1.0 10.5 Tf +[<3a20636f70> 20.0195 <79207265736f75726365732066726f6d20616e> 20.0195 <7920696e707574206a61727320746f206f7574707574202864656661756c74206265686176696f722073696e636520312e312e3129>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp2 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +49.24 14.263 Td +/F1.0 9 Tf +<3330> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +172 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 171 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F3.0 26 0 R +/F1.0 8 0 R +/F2.0 22 0 R +>> +/XObject << /Stamp2 361 0 R +>> +>> +/Annots [174 0 R 175 0 R] +>> +endobj +173 0 obj +[172 0 R /XYZ 0 246.55 null] +endobj +174 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#antTasks-iajc) +>> +/Subtype /Link +/Rect [508.4502 182.46 547.04 196.74] +/Type /Annot +>> +endobj +175 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#antTasks-iajc) +>> +/Subtype /Link +/Rect [48.24 166.68 73.062 180.96] +/Type /Annot +>> +endobj +176 0 obj +<< /Length 15432 +>> +stream +q + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +56.8805 793.926 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.7985 Tw + +BT +66.24 793.926 Td +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.7985 Tw + +BT +66.24 793.926 Td +/F3.0 10.5 Tf +<2d58736f75726365726f6f74636f707966696c746572207b66696c7465727d> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.7985 Tw + +BT +229.7885 793.926 Td +/F1.0 10.5 Tf +[<3a20636f70> 20.0195 <79207265736f75726365732066726f6d20736f75726365206469726563746f7269657320746f206f757470757420286d696e75732066696c6573>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 778.146 Td +/F1.0 10.5 Tf +<73706563696669656420696e2066696c74657229> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 756.366 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 756.366 Td +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +66.24 756.366 Td +/F3.0 10.5 Tf +<2d5874616766696c65207b66696c657d> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +150.24 756.366 Td +/F1.0 10.5 Tf +<3a207573652066696c6520746f20636f6e74726f6c20696e6372656d656e74616c20636f6d70696c6174696f6e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 734.586 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 734.586 Td +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +66.24 734.586 Td +/F3.0 10.5 Tf +<2d58737263646972207b6469727d> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +139.74 734.586 Td +/F1.0 10.5 Tf +<3a2061646420746f206c697374206f6620616a6320736f7572636520726f6f74732028616c6c20736f757263652066696c65732077696c6c20626520696e636c75646564292e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 706.806 Td +/F1.0 10.5 Tf +[<5370656369616c20636f6e7369646572> 20.0195 <6174696f6e73207768656e207573696e67204a6176616320616e6420636f6d70696c6572> 20.0195 <6172673a>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 679.026 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1535 Tw + +BT +66.24 679.026 Td +/F1.0 10.5 Tf +[<546865206e616d65732061626f7665206d61> 20.0195 <792064696666657220736c696768746c792066726f6d207768617420796f75206d69676874206578706563742066726f6d20416a6354> 29.7852 <61736b3b2075736520746865736520666f726d73>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 663.246 Td +/F1.0 10.5 Tf +[<7768656e2073706563696679696e6720636f6d70696c6572> 20.0195 <6172672e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 641.466 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.517 Tw + +BT +66.24 641.466 Td +/F1.0 10.5 Tf +[<42> 20.0195 <792064656661756c742074686520616461707465722077696c6c206d696d696320746865204a61766163207461736bd57320636f70> 20.0195 <79696e67206f66207265736f757263652066696c65732062> 20.0195 <792073706563696679696e6720>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.517 Tw + +BT +515.54 641.466 Td +/F3.0 10.5 Tf +<22> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.517 Tw + +BT +520.79 641.466 Td +/F4.0 10.5 Tf +<2f4356532f> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +2.4417 Tw + +BT +66.24 628.521 Td +/F4.0 10.5 Tf +<2c> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +2.4417 Tw + +BT +71.49 628.521 Td +/F4.0 10.5 Tf +<2f> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +2.4417 Tw + +BT +76.74 628.521 Td +/F3.0 10.5 Tf +<2e6a6176612c> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +2.4417 Tw + +BT +108.24 628.521 Td +/F4.0 10.5 Tf +<2f> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +2.4417 Tw + +BT +113.49 628.521 Td +/F4.0 10.5 Tf +<2e616a22> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +2.4417 Tw + +BT +134.49 628.521 Td +/F4.0 10.5 Tf +<20666f722074686520736f75726365726f6f7420636f70792066696c7465722e20546f206368616e67652074686973206265686176696f722c20737570706c7920796f7572206f776e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +66.24 612.741 Td +/F4.0 10.5 Tf +<76616c75652028652e672e2c20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +134.49 612.741 Td +/F4.0 10.5 Tf +<22> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +139.74 612.741 Td +/F4.0 10.5 Tf +<2f> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +144.99 612.741 Td +/F3.0 10.5 Tf +<22> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +150.24 612.741 Td +/F1.0 10.5 Tf +[<20746f20636f70> 20.0195 <79206e6f7468696e67292e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 590.961 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.66 Tw + +BT +66.24 590.961 Td +/F1.0 10.5 Tf +[<57> 49.8047 <61726e696e67202d20646566696e65207468652073797374656d2070726f706572747920>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.66 Tw + +BT +259.937 590.961 Td +/F3.0 10.5 Tf +<6275696c642e636f6d70696c65722e636c65616e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.66 Tw + +BT +364.937 590.961 Td +/F1.0 10.5 Tf +<20746f20636f6d70696c6520616c6c2066696c65732c207768656e20617661696c61626c652e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.6514 Tw + +BT +66.24 575.181 Td +/F1.0 10.5 Tf +<4a61766163207072756e65732074686520736f757263652066696c65206c697374206f66202275702d746f2d646174652220736f757263652066696c6573206261736564206f6e207468652074696d657374616d7073206f66> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.9274 Tw + +BT +66.24 559.401 Td +/F1.0 10.5 Tf +<636f72726573706f6e64696e67202e636c6173732066696c65732c20616e642077696c6c206e6f7420636f6d70696c65206966206e6f20736f757263657320617265206f7574206f6620646174652e20546869732069732077726f6e6720666f72> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1769 Tw + +BT +66.24 543.621 Td +/F1.0 10.5 Tf +[<616a6320776869636820726571756972657320616c6c207468652066696c657320666f72206561636820636f6d70696c6520616e64207768696368206d61> 20.0195 <7920726566657220696e6469726563746c7920746f20736f7572636573207573696e67>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 527.841 Td +/F1.0 10.5 Tf +<617267756d656e742066696c65732e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.1074 Tw + +BT +66.24 500.061 Td +/F1.0 10.5 Tf +[<54> 29.7852 <6f20776f726b2061726f756e6420746869732c207365742074686520676c6f62616c2070726f706572747920>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +3.1074 Tw + +BT +313.6696 500.061 Td +/F3.0 10.5 Tf +<6275696c642e636f6d70696c65722e636c65616e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.1074 Tw + +BT +418.6696 500.061 Td +/F1.0 10.5 Tf +<2e20546869732074656c6c732074686520636f6d70696c6572> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.8679 Tw + +BT +66.24 484.281 Td +/F1.0 10.5 Tf +<6164617074657220746f2064656c65746520616c6c202e636c6173732066696c657320696e207468652064657374696e6174696f6e206469726563746f727920616e642072652d6578656375746520746865206a61766163207461736b20736f> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 468.501 Td +/F1.0 10.5 Tf +<6a617661632063616e20726563616c63756c61746520746865206c697374206f6620736f757263652066696c65732e20652e672e2c> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +70.24 452.685 m +543.04 452.685 l +545.2491 452.685 547.04 450.8941 547.04 448.685 c +547.04 405.205 l +547.04 402.9959 545.2491 401.205 543.04 401.205 c +70.24 401.205 l +68.0309 401.205 66.24 402.9959 66.24 405.205 c +66.24 448.685 l +66.24 450.8941 68.0309 452.685 70.24 452.685 c +h +f +0.8 0.8 0.8 SCN +0.75 w +70.24 452.685 m +543.04 452.685 l +545.2491 452.685 547.04 450.8941 547.04 448.685 c +547.04 405.205 l +547.04 402.9959 545.2491 401.205 543.04 401.205 c +70.24 401.205 l +68.0309 401.205 66.24 402.9959 66.24 405.205 c +66.24 448.685 l +66.24 450.8941 68.0309 452.685 70.24 452.685 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +77.24 429.86 Td +/F3.0 11 Tf +<416e74202d446275696c642e636f6d70696c65723d6f72672e6173706563746a2e746f6f6c732e616e742e7461736b646566732e416a633131436f6d70696c657241646170746572> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +77.24 415.12 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 377.241 Td +/F1.0 10.5 Tf +<4361766561747320746f20636f6e7369646572207768656e207573696e67207468697320676c6f62616c20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +280.7235 377.241 Td +/F3.0 10.5 Tf +<6275696c642e636f6d70696c65722e636c65616e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +385.7235 377.241 Td +/F1.0 10.5 Tf +<2070726f70657274793a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +70.6765 349.461 Td +/F1.0 10.5 Tf +<312e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1271 Tw + +BT +84.24 349.461 Td +/F1.0 10.5 Tf +<4966206a617661632062656c696576657320746865726520617265206e6f206f75742d6f662d6461746520736f757263652066696c65732c207468656e207468652061646170746572206973206e657665722063616c6c656420616e64> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.0104 Tw + +BT +84.24 333.681 Td +/F1.0 10.5 Tf +<63616e6e6f7420636c65616e2075702c20616e64207468652022636f6d70696c65222077696c6c2061707065617220746f20636f6d706c657465207375636365737366756c6c792074686f75676820697420646964> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +84.24 317.901 Td +/F1.0 10.5 Tf +<6e6f7468696e672e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +70.6765 296.121 Td +/F1.0 10.5 Tf +<322e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.8639 Tw + +BT +84.24 296.121 Td +/F1.0 10.5 Tf +[<436c65616e696e672077696c6c206d616b> 20.0195 <6573207374657077697365206275696c642070726f636573736573206661696c206966207468657920646570656e64206f6e2074686520726573756c7473206f6620746865207072696f72>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +84.24 280.341 Td +/F1.0 10.5 Tf +[<636f6d70696c6174696f6e206265696e6720696e207468652073616d65206469726563746f7279> 89.8438 <2c2073696e636520636c65616e696e672064656c6574657320616c6c202e636c6173732066696c65732e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +70.6765 258.561 Td +/F1.0 10.5 Tf +<332e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2641 Tw + +BT +84.24 258.561 Td +/F1.0 10.5 Tf +<5468697320636c65616e2070726f63657373206f6e6c79207065726d697473206f6e6520636f6d70696c652070726f6365737320617420612074696d6520666f7220656163682064657374696e6174696f6e206469726563746f7279> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +84.24 242.781 Td +/F1.0 10.5 Tf +[<62656361757365206974207472> 20.0195 <61636b7320726563757273696f6e2062> 20.0195 <792077726974696e672061207461672066696c6520746f207468652064657374696e6174696f6e206469726563746f7279> 89.8438 <2e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +70.6765 221.001 Td +/F1.0 10.5 Tf +<342e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +84.24 221.001 Td +/F1.0 10.5 Tf +[<5768656e2072756e6e696e6720696e6372656d656e74616c6c79> 89.8438 <2c2074686520636c65616e2068617070656e73206f6e6c79206265666f72652074686520696e697469616c20636f6d70696c652e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 181.161 Td +/F2.0 18 Tf +<342e352e20416a6331302028616a6329> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6326 Tw + +BT +48.24 153.141 Td +/F1.0 10.5 Tf +[<54686973207461736b2068616e646c6573207468652073616d6520617267756d656e74732061732074686f736520757365642062> 20.0195 <7920746865204173706563744a20312e30207461736b2e20546869732073686f756c64207065726d6974>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6168 Tw + +BT +48.24 137.361 Td +/F1.0 10.5 Tf +<74686f73652077697468206578697374696e67206275696c642073637269707473207573696e672074686520416a6320416e74207461736b20746f20636f6e74696e7565207573696e67207468652073616d652073637269707473207768656e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.0388 Tw + +BT +48.24 121.581 Td +/F1.0 10.5 Tf +[<636f6d70696c696e67207769746820312e312e20546869732077696c6c206c69737420616e> 20.0195 <7920757365206f66206f7074696f6e73206e6f206c6f6e67657220737570706f7274656420696e20312e312028652e672e2c20>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.0388 Tw + +BT +463.0012 121.581 Td +/F3.0 10.5 Tf +<6c656e69656e742c207374726963742c> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.4884 Tw + +BT +48.24 105.801 Td +/F3.0 10.5 Tf +<776f726b696e676469722c2070726570726f636573732c207573656a61766163> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.4884 Tw + +BT +219.2168 105.801 Td +/F1.0 10.5 Tf +<2cc9292c20616e6420646f6573206e6f742070726f766964652061636365737320746f20746865206e6577206665617475726573206f66204173706563744a> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2629 Tw + +BT +48.24 90.021 Td +/F1.0 10.5 Tf +[<312e312e2028446576656c6f70657273207573696e67204173706563744a20312e31206f6e6c792073686f756c642075706772> 20.0195 <616465207468656972207363726970747320746f2075736520416a6354> 29.7852 <61736b20696e73746561642e20546869732077696c6c>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 74.241 Td +/F1.0 10.5 Tf +<6e6f7420776f726b20666f72204173706563744a20312e32206f72206c617465722e29> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp1 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.978 14.263 Td +/F1.0 9 Tf +<3331> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +177 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 176 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F1.0 8 0 R +/F3.0 26 0 R +/F4.0 149 0 R +/F2.0 22 0 R +>> +/XObject << /Stamp1 360 0 R +>> +>> +>> +endobj +178 0 obj +[177 0 R /XYZ 0 205.185 null] +endobj +179 0 obj +<< /Length 21873 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +48.24 792.006 Td +/F2.0 13 Tf +<342e352e312e20416a6331302028616a6329204f7074696f6e73> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0371 Tw + +BT +48.24 765.446 Td +/F1.0 10.5 Tf +<4d6f7374206174747269627574657320616e64206e657374656420656c656d656e747320617265206f7074696f6e616c2e2054686520636f6d70696c65722072657175697265732074686174207468652073616d652076657273696f6e206f66> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.5314 Tw + +BT +48.24 749.666 Td +/F3.0 10.5 Tf +<6173706563746a72742e6a6172> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.5314 Tw + +BT +116.49 749.666 Td +/F1.0 10.5 Tf +<20626520737065636966696564206f6e2074686520636c617373706174682c20616e64207468617420736f6d6520736f75726365732062652062652073706563696669656420287573696e67206f6e65206f72> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 733.886 Td +/F1.0 10.5 Tf +<6d6f7265206f6620> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +90.1455 733.886 Td +/F3.0 10.5 Tf +<61726766696c6573> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +132.1455 733.886 Td +/F1.0 10.5 Tf +<20616e6420> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +156.6945 733.886 Td +/F3.0 10.5 Tf +<737263646972> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +188.1945 733.886 Td +/F1.0 10.5 Tf +<202877697468207061747465726e7329292e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 706.106 Td +/F1.0 10.5 Tf +[<426f6f6c65616e20706172> 20.0195 <616d65746572732064656661756c7420746f20>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +202.3273 706.106 Td +/F3.0 10.5 Tf +<66616c7365> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +228.5773 706.106 Td +/F1.0 10.5 Tf +<20756e6c657373206f7468657277697365207374617465642e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 678.9242 Td +/F5.0 9.975 Tf +[<54> 29.7852 <61626c6520312e20416a6354> 29.7852 <61736b2028616a6329206f7074696f6e7320666f722073706563696679696e6720736f7572636573>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 649.519 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 649.519 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 627.739 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 627.739 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 605.959 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 605.959 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 552.619 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 552.619 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 530.839 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 530.839 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 477.499 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 477.499 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 455.719 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 455.719 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 402.379 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 402.379 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 349.039 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 349.039 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 295.699 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 295.699 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 258.139 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 258.139 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 236.359 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 236.359 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 198.799 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 198.799 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 161.239 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 161.239 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 139.459 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 139.459 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 70.339 249.4 69.12 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 70.339 249.4 69.12 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 48.559 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 48.559 249.4 21.78 re +f +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 671.299 m +297.64 671.299 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +48.24 649.519 m +297.64 649.519 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 671.549 m +48.24 648.894 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 671.549 m +297.64 648.894 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 656.335 Td +/F2.0 10.5 Tf +<417474726962757465> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 671.299 m +547.04 671.299 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +297.64 649.519 m +547.04 649.519 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 671.549 m +297.64 648.894 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 671.549 m +547.04 648.894 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 656.335 Td +/F2.0 10.5 Tf +<4465736372697074696f6e> Tj +ET + +0.0 0.0 0.0 scn +1.25 w +0.8667 0.8667 0.8667 SCN +48.24 649.519 m +297.64 649.519 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 627.739 m +297.64 627.739 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 650.144 m +48.24 627.489 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 650.144 m +297.64 627.489 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 634.555 Td +/F1.0 10.5 Tf +<737263646972> Tj +ET + +0.0 0.0 0.0 scn +1.25 w +0.8667 0.8667 0.8667 SCN +297.64 649.519 m +547.04 649.519 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 627.739 m +547.04 627.739 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 650.144 m +297.64 627.489 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 650.144 m +547.04 627.489 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 634.555 Td +/F1.0 10.5 Tf +<5468652062617365206469726563746f7279206f6620746865206a6176612066696c65732e20536565> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 627.739 m +297.64 627.739 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 605.959 m +297.64 605.959 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 627.989 m +48.24 605.709 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 627.989 m +297.64 605.709 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 612.775 Td +/F1.0 10.5 Tf +<64657374646972> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 627.739 m +547.04 627.739 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 605.959 m +547.04 605.959 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 627.989 m +297.64 605.709 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 627.989 m +547.04 605.709 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 612.775 Td +/F1.0 10.5 Tf +<54686520746172676574206469726563746f727920666f7220746865206f7574707574202e636c6173732066696c6573> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 605.959 m +297.64 605.959 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 552.619 m +297.64 552.619 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 606.209 m +48.24 552.369 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 606.209 m +297.64 552.369 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 590.995 Td +/F1.0 10.5 Tf +<696e636c75646573> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 605.959 m +547.04 605.959 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 552.619 m +547.04 552.619 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 606.209 m +297.64 552.369 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 606.209 m +547.04 552.369 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 590.995 Td +/F1.0 10.5 Tf +[<436f6d6d612d7365706172> 20.0195 <61746564206c697374206f66207061747465726e73206f662066696c65732074686174>] TJ +ET + + +BT +300.64 575.215 Td +/F1.0 10.5 Tf +<6d75737420626520696e636c756465642e204e6f2066696c65732061726520696e636c75646564207768656e> Tj +ET + + +BT +300.64 559.435 Td +/F1.0 10.5 Tf +<6f6d69747465642e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 552.619 m +297.64 552.619 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 530.839 m +297.64 530.839 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 552.869 m +48.24 530.589 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 552.869 m +297.64 530.589 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 537.655 Td +/F1.0 10.5 Tf +<696e636c7564657366696c65> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 552.619 m +547.04 552.619 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 530.839 m +547.04 530.839 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 552.869 m +297.64 530.589 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 552.869 m +547.04 530.589 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 537.655 Td +/F1.0 10.5 Tf +<546865207061746820746f20612066696c6520636f6e7461696e696e6720696e636c756465207061747465726e732e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 530.839 m +297.64 530.839 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 477.499 m +297.64 477.499 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 531.089 m +48.24 477.249 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 531.089 m +297.64 477.249 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 515.875 Td +/F1.0 10.5 Tf +<6578636c75646573> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 530.839 m +547.04 530.839 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 477.499 m +547.04 477.499 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 531.089 m +297.64 477.249 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 531.089 m +547.04 477.249 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 515.875 Td +/F1.0 10.5 Tf +[<436f6d6d612d7365706172> 20.0195 <61746564206c697374206f66207061747465726e73206f662066696c65732074686174>] TJ +ET + + +BT +300.64 500.095 Td +/F1.0 10.5 Tf +<6d757374206265206578636c756465642e204e6f2066696c657320286578636570742064656661756c74> Tj +ET + + +BT +300.64 484.315 Td +/F1.0 10.5 Tf +<6578636c756465732920617265206578636c75646564207768656e206f6d69747465642e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 477.499 m +297.64 477.499 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 455.719 m +297.64 455.719 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 477.749 m +48.24 455.469 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 477.749 m +297.64 455.469 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 462.535 Td +/F1.0 10.5 Tf +<6578636c7564657366696c65> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 477.499 m +547.04 477.499 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 455.719 m +547.04 455.719 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 477.749 m +297.64 455.469 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 477.749 m +547.04 455.469 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 462.535 Td +/F1.0 10.5 Tf +<546865207061746820746f20612066696c6520636f6e7461696e696e67206578636c756465207061747465726e732e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 455.719 m +297.64 455.719 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 402.379 m +297.64 402.379 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 455.969 m +48.24 402.129 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 455.969 m +297.64 402.129 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 440.755 Td +/F1.0 10.5 Tf +<64656661756c746578636c75646573> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 455.719 m +547.04 455.719 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 402.379 m +547.04 402.379 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 455.969 m +297.64 402.129 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 455.969 m +547.04 402.129 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 440.755 Td +/F1.0 10.5 Tf +<496620747275652c207468656e2064656661756c74206578636c756465732061726520757365642e2044656661756c74> Tj +ET + + +BT +300.64 424.975 Td +/F1.0 10.5 Tf +<6578636c75646573206172652075736564207768656e206f6d69747465642028692e652e2c2064656661756c747320746f> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +300.64 409.195 Td +/F3.0 10.5 Tf +<74727565> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +321.64 409.195 Td +/F1.0 10.5 Tf +<292e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 402.379 m +297.64 402.379 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 349.039 m +297.64 349.039 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 402.629 m +48.24 348.789 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 402.629 m +297.64 348.789 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 387.415 Td +/F1.0 10.5 Tf +<636c617373706174682c20636c61737370617468726566> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 402.379 m +547.04 402.379 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 349.039 m +547.04 349.039 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 402.629 m +297.64 348.789 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 402.629 m +547.04 348.789 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 387.415 Td +/F1.0 10.5 Tf +<54686520636c6173737061746820746f207573652c206f7074696f6e616c6c7920676976656e2061732061> Tj +ET + + +BT +300.64 371.635 Td +/F1.0 10.5 Tf +<7265666572656e636520746f206120636c61737370617468205061746820656c656d656e7420646566696e6564> Tj +ET + + +BT +300.64 355.855 Td +/F1.0 10.5 Tf +<656c736577686572652e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 349.039 m +297.64 349.039 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 295.699 m +297.64 295.699 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 349.289 m +48.24 295.449 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 349.289 m +297.64 295.449 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 334.075 Td +/F1.0 10.5 Tf +<626f6f74636c617373706174682c20626f6f74636c61737370617468726566> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 349.039 m +547.04 349.039 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 295.699 m +547.04 295.699 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 349.289 m +297.64 295.449 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 349.289 m +547.04 295.449 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 334.075 Td +/F1.0 10.5 Tf +<54686520626f6f74636c6173737061746820746f207573652c206f7074696f6e616c6c7920676976656e2061732061> Tj +ET + + +BT +300.64 318.295 Td +/F1.0 10.5 Tf +<7265666572656e636520746f206120626f6f74636c61737370617468205061746820656c656d656e74> Tj +ET + + +BT +300.64 302.515 Td +/F1.0 10.5 Tf +<646566696e656420656c736577686572652e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 295.699 m +297.64 295.699 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 258.139 m +297.64 258.139 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 295.949 m +48.24 257.889 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 295.949 m +297.64 257.889 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 280.735 Td +/F1.0 10.5 Tf +<65787464697273> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 295.699 m +547.04 295.699 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 258.139 m +547.04 258.139 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 295.949 m +297.64 257.889 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 295.949 m +547.04 257.889 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 280.735 Td +/F1.0 10.5 Tf +<506174687320746f206469726563746f7269657320636f6e7461696e74696e6720696e7374616c6c6564> Tj +ET + + +BT +300.64 264.955 Td +/F1.0 10.5 Tf +<657874656e73696f6e732e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 258.139 m +297.64 258.139 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 236.359 m +297.64 236.359 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 258.389 m +48.24 236.109 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 258.389 m +297.64 236.109 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 243.175 Td +/F1.0 10.5 Tf +<6465627567> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 258.139 m +547.04 258.139 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 236.359 m +547.04 236.359 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 258.389 m +297.64 236.109 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 258.389 m +547.04 236.109 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 243.175 Td +/F1.0 10.5 Tf +<496620747275652c20656d697420646562756720696e666f20696e20746865202e636c6173732066696c65732e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 236.359 m +297.64 236.359 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 198.799 m +297.64 198.799 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 236.609 m +48.24 198.549 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 236.609 m +297.64 198.549 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 221.395 Td +/F1.0 10.5 Tf +<6465707265636174696f6e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 236.359 m +547.04 236.359 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 198.799 m +547.04 198.799 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 236.609 m +297.64 198.549 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 236.609 m +547.04 198.549 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 221.395 Td +/F1.0 10.5 Tf +<496620747275652c20656d6974206d657373616765732061626f757420757365206f662064657072656361746564> Tj +ET + + +BT +300.64 205.615 Td +/F1.0 10.5 Tf +<4150492e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 198.799 m +297.64 198.799 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 161.239 m +297.64 161.239 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 199.049 m +48.24 160.989 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 199.049 m +297.64 160.989 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 183.835 Td +/F1.0 10.5 Tf +<766572626f7365> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 198.799 m +547.04 198.799 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 161.239 m +547.04 161.239 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 199.049 m +297.64 160.989 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 199.049 m +547.04 160.989 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 183.835 Td +/F1.0 10.5 Tf +<456d697420636f6d70696c657220737461747573206d6573736167657320647572696e6720746865> Tj +ET + + +BT +300.64 168.055 Td +/F1.0 10.5 Tf +<636f6d70696c652e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 161.239 m +297.64 161.239 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 139.459 m +297.64 139.459 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 161.489 m +48.24 139.209 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 161.489 m +297.64 139.209 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 146.275 Td +/F1.0 10.5 Tf +<76657273696f6e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 161.239 m +547.04 161.239 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 139.459 m +547.04 139.459 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 161.489 m +297.64 139.209 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 161.489 m +547.04 139.209 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 146.275 Td +/F1.0 10.5 Tf +<456d69742076657273696f6e20696e666f726d6174696f6e20616e6420717569742e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 139.459 m +297.64 139.459 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 70.339 m +297.64 70.339 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 139.709 m +48.24 70.089 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 139.709 m +297.64 70.089 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 124.495 Td +/F1.0 10.5 Tf +<6661696c6f6e6572726f72> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 139.459 m +547.04 139.459 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 70.339 m +547.04 70.339 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 139.709 m +297.64 70.089 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 139.709 m +547.04 70.089 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 124.495 Td +/F1.0 10.5 Tf +<496620747275652c207468726f77204275696c64457863657074696f6e20746f2068616c74206275696c64206966> Tj +ET + + +BT +300.64 108.715 Td +/F1.0 10.5 Tf +[<74686572652061726520616e> 20.0195 <7920636f6d70696c6572206572726f72732e2049662066616c73652c20636f6e74696e7565>] TJ +ET + + +BT +300.64 92.935 Td +/F1.0 10.5 Tf +<6e6f74776974687374616e64696e6720636f6d70696c65206572726f72732e2044656661756c747320746f> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +300.64 77.155 Td +/F3.0 10.5 Tf +<74727565> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +321.64 77.155 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 70.339 m +297.64 70.339 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 48.559 m +297.64 48.559 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 70.589 m +48.24 48.309 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 70.589 m +297.64 48.309 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 55.375 Td +/F1.0 10.5 Tf +<736f75726365> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 70.339 m +547.04 70.339 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 48.559 m +547.04 48.559 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 70.589 m +297.64 48.309 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 70.589 m +547.04 48.309 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 55.375 Td +/F1.0 10.5 Tf +[<56> 60.0586 <616c7565206f66202d736f75726365206f7074696f6e202d2069676e6f72656420756e6c65737320>] TJ +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +500.1499 55.375 Td +/F3.0 10.5 Tf +<312e34> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +515.8999 55.375 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp2 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +49.24 14.263 Td +/F1.0 9 Tf +<3332> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +180 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 179 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F2.0 22 0 R +/F1.0 8 0 R +/F3.0 26 0 R +/F5.0 182 0 R +>> +/XObject << /Stamp2 361 0 R +>> +>> +>> +endobj +181 0 obj +[180 0 R /XYZ 0 841.89 null] +endobj +182 0 obj +<< /Type /Font +/BaseFont /247feb+NotoSerif-Italic +/Subtype /TrueType +/FontDescriptor 383 0 R +/FirstChar 32 +/LastChar 255 +/Widths 385 0 R +/ToUnicode 384 0 R +>> +endobj +183 0 obj +<< /Length 22285 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +48.24 794.5242 Td +/F5.0 9.975 Tf +[<54> 29.7852 <61626c6520322e20506172> 20.0195 <616d65746572732069676e6f7265642062> 20.0195 <7920746865206f6c6420616a63207461736b> 20.0195 <6465662c20627574206e6f7720737570706f72746564206f72206275676779>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 765.119 166.2665 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +214.5065 765.119 166.2665 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +380.773 765.119 166.267 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 743.339 166.2665 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +214.5065 743.339 166.2665 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +380.773 743.339 166.267 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 705.779 166.2665 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +214.5065 705.779 166.2665 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +380.773 705.779 166.267 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 668.219 166.2665 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +214.5065 668.219 166.2665 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +380.773 668.219 166.267 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 646.439 166.2665 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +214.5065 646.439 166.2665 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +380.773 646.439 166.267 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 608.879 166.2665 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +214.5065 608.879 166.2665 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +380.773 608.879 166.267 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 555.539 166.2665 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +214.5065 555.539 166.2665 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +380.773 555.539 166.267 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 533.759 166.2665 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +214.5065 533.759 166.2665 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +380.773 533.759 166.267 21.78 re +f +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 786.899 m +214.5065 786.899 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +48.24 765.119 m +214.5065 765.119 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 787.149 m +48.24 764.494 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 787.149 m +214.5065 764.494 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 771.935 Td +/F2.0 10.5 Tf +<417474726962757465> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 786.899 m +380.773 786.899 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +214.5065 765.119 m +380.773 765.119 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 787.149 m +214.5065 764.494 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 787.149 m +380.773 764.494 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +217.5065 771.935 Td +/F2.0 10.5 Tf +<4465736372697074696f6e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 786.899 m +547.04 786.899 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +380.773 765.119 m +547.04 765.119 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 787.149 m +380.773 764.494 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 787.149 m +547.04 764.494 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +383.773 771.935 Td +/F2.0 10.5 Tf +<537570706f727465643f> Tj +ET + +0.0 0.0 0.0 scn +1.25 w +0.8667 0.8667 0.8667 SCN +48.24 765.119 m +214.5065 765.119 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 743.339 m +214.5065 743.339 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 765.744 m +48.24 743.089 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 765.744 m +214.5065 743.089 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 750.155 Td +/F1.0 10.5 Tf +<656e636f64696e67> Tj +ET + +0.0 0.0 0.0 scn +1.25 w +0.8667 0.8667 0.8667 SCN +214.5065 765.119 m +380.773 765.119 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 743.339 m +380.773 743.339 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 765.744 m +214.5065 743.089 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 765.744 m +380.773 743.089 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +217.5065 750.155 Td +/F1.0 10.5 Tf +<44656661756c7420656e636f64696e67206f6620736f757263652066696c65732e> Tj +ET + +0.0 0.0 0.0 scn +1.25 w +0.8667 0.8667 0.8667 SCN +380.773 765.119 m +547.04 765.119 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 743.339 m +547.04 743.339 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 765.744 m +380.773 743.089 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 765.744 m +547.04 743.089 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +383.773 750.155 Td +/F1.0 10.5 Tf +<796573> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 743.339 m +214.5065 743.339 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 705.779 m +214.5065 705.779 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 743.589 m +48.24 705.529 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 743.589 m +214.5065 705.529 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 728.375 Td +/F1.0 10.5 Tf +<6f7074696d697a65> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 743.339 m +380.773 743.339 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 705.779 m +380.773 705.779 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 743.589 m +214.5065 705.529 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 743.589 m +380.773 705.529 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +217.5065 728.375 Td +/F1.0 10.5 Tf +<5768657468657220736f757263652073686f756c64206265> Tj +ET + + +BT +217.5065 712.595 Td +/F1.0 10.5 Tf +<636f6d70696c65642077697468206f7074696d697a6174696f6e2e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 743.339 m +547.04 743.339 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 705.779 m +547.04 705.779 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 743.589 m +380.773 705.529 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 743.589 m +547.04 705.529 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +383.773 728.375 Td +/F1.0 10.5 Tf +<7965733f> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 705.779 m +214.5065 705.779 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 668.219 m +214.5065 668.219 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 706.029 m +48.24 667.969 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 706.029 m +214.5065 667.969 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 690.815 Td +/F1.0 10.5 Tf +<746172676574> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 705.779 m +380.773 705.779 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 668.219 m +380.773 668.219 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 706.029 m +214.5065 667.969 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 706.029 m +380.773 667.969 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +217.5065 690.815 Td +/F1.0 10.5 Tf +[<47656e6572> 20.0195 <61746520636c6173732066696c657320666f72207370656369666963>] TJ +ET + + +BT +217.5065 675.035 Td +/F1.0 10.5 Tf +<564d2076657273696f6e2c206f6e65206f66205b> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +317.6345 675.035 Td +/F3.0 10.5 Tf +<312e3120312e32> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +354.3845 675.035 Td +/F1.0 10.5 Tf +<5d2e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 705.779 m +547.04 705.779 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 668.219 m +547.04 668.219 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 706.029 m +380.773 667.969 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 706.029 m +547.04 667.969 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +383.773 690.815 Td +/F1.0 10.5 Tf +<796573> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 668.219 m +214.5065 668.219 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 646.439 m +214.5065 646.439 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 668.469 m +48.24 646.189 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 668.469 m +214.5065 646.189 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 653.255 Td +/F1.0 10.5 Tf +<646570656e64> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 668.219 m +380.773 668.219 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 646.439 m +380.773 646.439 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 668.469 m +214.5065 646.189 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 668.469 m +380.773 646.189 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +217.5065 653.255 Td +/F1.0 10.5 Tf +[<456e61626c657320646570656e64656e63792d7472> 20.0195 <61636b696e672e>] TJ +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 668.219 m +547.04 668.219 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 646.439 m +547.04 646.439 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 668.469 m +380.773 646.189 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 668.469 m +547.04 646.189 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +383.773 653.255 Td +/F1.0 10.5 Tf +<6e6f> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 646.439 m +214.5065 646.439 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 608.879 m +214.5065 608.879 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 646.689 m +48.24 608.629 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 646.689 m +214.5065 608.629 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 631.475 Td +/F1.0 10.5 Tf +<696e636c756465416e7452756e74696d65> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 646.439 m +380.773 646.439 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 608.879 m +380.773 608.879 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 646.689 m +214.5065 608.629 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 646.689 m +380.773 608.629 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +217.5065 631.475 Td +/F1.0 10.5 Tf +<5768657468657220746f20696e636c7564652074686520416e742072756e2d> Tj +ET + + +BT +217.5065 615.695 Td +/F1.0 10.5 Tf +[<74696d65206c696272> 20.0195 <61726965732e>] TJ +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 646.439 m +547.04 646.439 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 608.879 m +547.04 608.879 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 646.689 m +380.773 608.629 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 646.689 m +547.04 608.629 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +383.773 631.475 Td +/F1.0 10.5 Tf +<6e6f> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 608.879 m +214.5065 608.879 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 555.539 m +214.5065 555.539 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 609.129 m +48.24 555.289 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 609.129 m +214.5065 555.289 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 593.915 Td +/F1.0 10.5 Tf +<696e636c7564654a61766152756e74696d65> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 608.879 m +380.773 608.879 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 555.539 m +380.773 555.539 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 609.129 m +214.5065 555.289 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 609.129 m +380.773 555.289 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +217.5065 593.915 Td +/F1.0 10.5 Tf +<5768657468657220746f20696e636c756465207468652072756e2d> Tj +ET + + +BT +217.5065 578.135 Td +/F1.0 10.5 Tf +[<74696d65206c696272> 20.0195 <61726965732066726f6d20746865>] TJ +ET + + +BT +217.5065 562.355 Td +/F1.0 10.5 Tf +<657865637574696e6720564d2e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 608.879 m +547.04 608.879 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 555.539 m +547.04 555.539 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 609.129 m +380.773 555.289 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 609.129 m +547.04 555.289 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +383.773 593.915 Td +/F1.0 10.5 Tf +<6e6f> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 555.539 m +214.5065 555.539 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 533.759 m +214.5065 533.759 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 555.789 m +48.24 533.509 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 555.789 m +214.5065 533.509 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 540.575 Td +/F1.0 10.5 Tf +<74687265616473> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 555.539 m +380.773 555.539 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 533.759 m +380.773 533.759 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +214.5065 555.789 m +214.5065 533.509 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 555.789 m +380.773 533.509 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +217.5065 540.575 Td +/F1.0 10.5 Tf +<4d756c74692d746872656164656420636f6d70696c6174696f6e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 555.539 m +547.04 555.539 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 533.759 m +547.04 533.759 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +380.773 555.789 m +380.773 533.509 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 555.789 m +547.04 533.509 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +383.773 540.575 Td +/F1.0 10.5 Tf +<6e6f> Tj +ET + +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.0568 Tw + +BT +48.24 509.795 Td +/F1.0 10.5 Tf +[<54686520666f6c6c6f77696e67207461626c652073686f77732074686174206d616e> 20.0195 <79206f662074686520756e6971756520706172> 20.0195 <616d657465727320696e204173706563744a20312e3020617265206e6f206c6f6e676572>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 494.015 Td +/F1.0 10.5 Tf +<737570706f727465642e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 466.8332 Td +/F5.0 9.975 Tf +[<54> 29.7852 <61626c6520332e20506172> 20.0195 <616d657465727320756e6971756520746f20616a63>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 437.428 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 437.428 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 384.088 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 384.088 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 362.308 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 362.308 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 308.968 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 308.968 249.4 53.34 re +f +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 459.208 m +297.64 459.208 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +48.24 437.428 m +297.64 437.428 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 459.458 m +48.24 436.803 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 459.458 m +297.64 436.803 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 444.244 Td +/F2.0 10.5 Tf +<417474726962757465> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 459.208 m +547.04 459.208 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +297.64 437.428 m +547.04 437.428 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 459.458 m +297.64 436.803 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 459.458 m +547.04 436.803 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 444.244 Td +/F2.0 10.5 Tf +<4465736372697074696f6e> Tj +ET + +0.0 0.0 0.0 scn +1.25 w +0.8667 0.8667 0.8667 SCN +48.24 437.428 m +297.64 437.428 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 384.088 m +297.64 384.088 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 438.053 m +48.24 383.838 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 438.053 m +297.64 383.838 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 422.464 Td +/F1.0 10.5 Tf +<58> Tj +ET + +0.0 0.0 0.0 scn +1.25 w +0.8667 0.8667 0.8667 SCN +297.64 437.428 m +547.04 437.428 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 384.088 m +547.04 384.088 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 438.053 m +297.64 383.838 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 438.053 m +547.04 383.838 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 422.464 Td +/F1.0 10.5 Tf +[<646570726563617465642058206f7074696f6e7320696e636c7564652072657765617661626c6520286f6e2062> 20.0195 <79>] TJ +ET + + +BT +300.64 406.684 Td +/F1.0 10.5 Tf +[<64656661756c74292072657765617661626c653a636f6d70726573732028636f6d707265737365642062> 20.0195 <79>] TJ +ET + + +BT +300.64 390.904 Td +/F1.0 10.5 Tf +<64656661756c7429> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 384.088 m +297.64 384.088 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 362.308 m +297.64 362.308 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 384.338 m +48.24 362.058 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 384.338 m +297.64 362.058 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 369.124 Td +/F1.0 10.5 Tf +<656d61637373796d> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 384.088 m +547.04 384.088 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 362.308 m +547.04 362.308 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 384.338 m +297.64 362.058 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 384.338 m +547.04 362.058 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 369.124 Td +/F1.0 10.5 Tf +[<47656e6572> 20.0195 <6174652073796d626f6c7320666f7220456d6163732049444520737570706f72742e>] TJ +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 362.308 m +297.64 362.308 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 308.968 m +297.64 308.968 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 362.558 m +48.24 308.718 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 362.558 m +297.64 308.718 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 347.344 Td +/F1.0 10.5 Tf +<61726766696c6573> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 362.308 m +547.04 362.308 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 308.968 m +547.04 308.968 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 362.558 m +297.64 308.718 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 362.558 m +547.04 308.718 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 347.344 Td +/F1.0 10.5 Tf +<4120636f6d6d612d64656c696d69746564206c697374206f662061726766696c6573207468617420636f6e7461696e2061> Tj +ET + + +BT +300.64 331.564 Td +/F1.0 10.5 Tf +<6c696e652d64656c696d69746564206c697374206f6620736f757263652066696c6520706174687320286162736f6c757465> Tj +ET + + +BT +300.64 315.784 Td +/F1.0 10.5 Tf +<6f722072656c617469766520746f207468652061726766696c65292e> Tj +ET + +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 280.954 Td +/F2.0 10.5 Tf +<342e352e312e312e2061726766696c6573202d20617267756d656e74206c6973742066696c6573> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.9738 Tw + +BT +48.24 255.124 Td +/F1.0 10.5 Tf +<416e20617267756d656e742066696c6520697320612066696c652028757375616c6c7920> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.9738 Tw + +BT +230.6134 255.124 Td +/F3.0 10.5 Tf +<7b66696c657d2e6c7374> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.9738 Tw + +BT +283.1134 255.124 Td +/F1.0 10.5 Tf +<2920636f6e7461696e696e672061206c697374206f6620736f757263652066696c6520706174687320286162736f6c757465206f72> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2407 Tw + +BT +48.24 239.344 Td +/F1.0 10.5 Tf +[<72656c617469766520746f207468652061726766696c65292e2059> 69.8242 <6f752063616e2075736520697420746f207370656369667920616c6c20736f757263652066696c657320746f20626520636f6d70696c65642c20776869636820616a6320726571756972657320746f>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.7313 Tw + +BT +48.24 223.564 Td +/F1.0 10.5 Tf +<61766f696420736561726368696e6720657665727920706f737369626c6520736f757263652066696c6520696e2074686520736f757263652070617468207768656e206275696c64696e6720617370656374732e20496620796f752073706563696679> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.7846 Tw + +BT +48.24 207.784 Td +/F1.0 10.5 Tf +[<616e2061726766696c6520746f2074686520616a63207461736b2c2069742077696c6c206e6f7420696e636c75646520616c6c2066696c657320696e20616e> 20.0195 <792073706563696669656420736f75726365206469726563746f72792028776869636820697320746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.4177 Tw + +BT +48.24 192.004 Td +/F1.0 10.5 Tf +[<64656661756c74206265686176696f7220666f7220746865204a61766163207461736b207768656e206e6f20696e636c756465732061726520737065636966696564292e20436f6e76657273656c79> 89.8438 <2c20696620796f752073706563696679>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.7811 Tw + +BT +48.24 176.224 Td +/F1.0 10.5 Tf +<6578636c756465732c20746865792077696c6c2062652072656d6f7665642066726f6d20746865206c697374206f662066696c657320636f6d70696c6564206576656e206966207468657920776572652073706563696669656420696e20616e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 160.444 Td +/F1.0 10.5 Tf +<617267756d656e742066696c652e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.4397 Tw + +BT +48.24 132.664 Td +/F1.0 10.5 Tf +<54686520636f6d70696c657220616c736f206163636570747320617267756d656e7473207468617420617265206e6f7420736f757263652066696c65732c20627574207468652049444520737570706f727420666f7220737563682066696c6573> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 116.884 Td +/F1.0 10.5 Tf +<7661726965732c20616e64204a6176616320646f6573206e6f7420737570706f7274207468656d2e204265207375726520746f20696e636c7564652065786163746c79206f6e6520617267756d656e74206f6e2065616368206c696e652e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 82.384 Td +/F2.0 13 Tf +[<342e352e322e20416a63313020706172> 20.0195 <616d657465727320737065636966696564206173206e657374656420656c656d656e7473>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0232 Tw + +BT +48.24 55.824 Td +/F1.0 10.5 Tf +<54686973207461736b20666f726d7320616e20696d706c696369742046696c6553657420616e6420737570706f72747320616c6c2061747472696275746573206f6620> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.0232 Tw + +BT +379.0631 55.824 Td +/F3.0 10.5 Tf +<3c66696c657365743e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0232 Tw + +BT +426.3131 55.824 Td +/F1.0 10.5 Tf +<2028646972206265636f6d65732073726364697229206173> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp1 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.978 14.263 Td +/F1.0 9 Tf +<3333> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +184 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 183 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F5.0 182 0 R +/F2.0 22 0 R +/F1.0 8 0 R +/F3.0 26 0 R +>> +/XObject << /Stamp1 360 0 R +>> +>> +>> +endobj +185 0 obj +[184 0 R /XYZ 0 296.968 null] +endobj +186 0 obj +[184 0 R /XYZ 0 101.068 null] +endobj +187 0 obj +<< /Length 11960 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +1.6513 Tw + +BT +48.24 794.676 Td +/F1.0 10.5 Tf +<77656c6c20617320746865206e657374656420> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.6513 Tw + +BT +146.3738 794.676 Td +/F3.0 10.5 Tf +<3c696e636c7564653e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6513 Tw + +BT +193.6238 794.676 Td +/F1.0 10.5 Tf +<2c20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.6513 Tw + +BT +200.6196 794.676 Td +/F3.0 10.5 Tf +<3c6578636c7564653e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6513 Tw + +BT +247.8696 794.676 Td +/F1.0 10.5 Tf +<2c20616e6420> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.6513 Tw + +BT +278.3462 794.676 Td +/F3.0 10.5 Tf +<3c7061747465726e7365743e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6513 Tw + +BT +341.3463 794.676 Td +/F1.0 10.5 Tf +<20656c656d656e74732e2054686573652063616e206265207573656420746f2073706563696679> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 778.896 Td +/F1.0 10.5 Tf +<736f757263652066696c65732e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.1071 Tw + +BT +48.24 751.116 Td +/F3.0 10.5 Tf +<616a63d5732060737263646972> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1071 Tw + +BT +116.1691 751.116 Td +/F1.0 10.5 Tf +<2c20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.1071 Tw + +BT +122.6206 751.116 Td +/F3.0 10.5 Tf +<636c61737370617468> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1071 Tw + +BT +169.8706 751.116 Td +/F1.0 10.5 Tf +<2c20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.1071 Tw + +BT +176.3222 751.116 Td +/F3.0 10.5 Tf +<626f6f74636c61737370617468> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1071 Tw + +BT +244.5722 751.116 Td +/F1.0 10.5 Tf +<2c20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.1071 Tw + +BT +251.0238 751.116 Td +/F3.0 10.5 Tf +<65787464697273> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1071 Tw + +BT +287.7738 751.116 Td +/F1.0 10.5 Tf +<2c20616e6420> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.1071 Tw + +BT +317.1619 751.116 Td +/F3.0 10.5 Tf +<6a766d617267> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1071 Tw + +BT +348.6619 751.116 Td +/F1.0 10.5 Tf +[<20617474726962757465732061726520706174682d6c696b> 20.0195 <65207374727563747572657320616e64>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6133 Tw + +BT +48.24 735.336 Td +/F1.0 10.5 Tf +<63616e20616c736f2062652073657420766961206e657374656420> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.6133 Tw + +BT +186.3348 735.336 Td +/F3.0 10.5 Tf +<3c7372633e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6133 Tw + +BT +212.5848 735.336 Td +/F1.0 10.5 Tf +<2c20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.6133 Tw + +BT +219.5425 735.336 Td +/F3.0 10.5 Tf +<3c636c617373706174683e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6133 Tw + +BT +277.2925 735.336 Td +/F1.0 10.5 Tf +<2c20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.6133 Tw + +BT +284.2503 735.336 Td +/F3.0 10.5 Tf +<3c626f6f74636c617373706174683e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6133 Tw + +BT +363.0003 735.336 Td +/F1.0 10.5 Tf +<2c20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.6133 Tw + +BT +369.9581 735.336 Td +/F3.0 10.5 Tf +<3c657874646972733e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6133 Tw + +BT +417.2081 735.336 Td +/F1.0 10.5 Tf +<2c20616e6420> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.6133 Tw + +BT +447.6087 735.336 Td +/F3.0 10.5 Tf +<3c6a766d617267733e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6133 Tw + +BT +494.8587 735.336 Td +/F1.0 10.5 Tf +<20656c656d656e74732c> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 719.556 Td +/F1.0 10.5 Tf +[<726573706563746976656c79> 89.8438 <2e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 685.056 Td +/F2.0 13 Tf +<342e352e332e2053616d706c65206f6620616a63207461736b> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.5607 Tw + +BT +48.24 658.496 Td +/F1.0 10.5 Tf +[<46> 40.0391 <6f6c6c6f77696e672069732061206465636c6172> 20.0195 <6174696f6e20666f722074686520616a63207461736b20616e6420612073616d706c6520696e766f636174696f6e207468617420757365732074686520616a6320636f6d70696c657220746f>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 642.716 Td +/F1.0 10.5 Tf +<636f6d70696c65207468652066696c6573206c697374656420696e20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +175.647 642.716 Td +/F3.0 10.5 Tf +<64656661756c742e6c7374> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +233.397 642.716 Td +/F1.0 10.5 Tf +<20696e746f207468652064657374206469723a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 626.9 m +543.04 626.9 l +545.2491 626.9 547.04 625.1091 547.04 622.9 c +547.04 328.84 l +547.04 326.6309 545.2491 324.84 543.04 324.84 c +52.24 324.84 l +50.0309 324.84 48.24 326.6309 48.24 328.84 c +48.24 622.9 l +48.24 625.1091 50.0309 626.9 52.24 626.9 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 626.9 m +543.04 626.9 l +545.2491 626.9 547.04 625.1091 547.04 622.9 c +547.04 328.84 l +547.04 326.6309 545.2491 324.84 543.04 324.84 c +52.24 324.84 l +50.0309 324.84 48.24 326.6309 48.24 328.84 c +48.24 622.9 l +48.24 625.1091 50.0309 626.9 52.24 626.9 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 604.075 Td +/F3.0 11 Tf +<3c70726f6a656374206e616d653d226578616d706c65222064656661756c743d22636f6d70696c6522203e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 589.335 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 574.595 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 559.855 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 545.115 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 530.375 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 515.635 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 500.895 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 471.415 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 456.675 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 441.935 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 427.195 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 412.455 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 397.715 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 382.975 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 368.235 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 353.495 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 338.755 Td +/F3.0 11 Tf +<3c2f70726f6a6563743e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 300.876 Td +/F1.0 10.5 Tf +<54686973206275696c642073637269707420736e6970706574> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 285.06 m +543.04 285.06 l +545.2491 285.06 547.04 283.2691 547.04 281.06 c +547.04 208.1 l +547.04 205.8909 545.2491 204.1 543.04 204.1 c +52.24 204.1 l +50.0309 204.1 48.24 205.8909 48.24 208.1 c +48.24 281.06 l +48.24 283.2691 50.0309 285.06 52.24 285.06 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 285.06 m +543.04 285.06 l +545.2491 285.06 547.04 283.2691 547.04 281.06 c +547.04 208.1 l +547.04 205.8909 545.2491 204.1 543.04 204.1 c +52.24 204.1 l +50.0309 204.1 48.24 205.8909 48.24 208.1 c +48.24 281.06 l +48.24 283.2691 50.0309 285.06 52.24 285.06 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 262.235 Td +/F3.0 11 Tf +<3c616a63207372636469723d22247b7372637d22> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 247.495 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 232.755 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 218.015 Td +/F3.0 11 Tf +<2f3e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.8647 Tw + +BT +48.24 180.136 Td +/F1.0 10.5 Tf +[<636f6d70696c657320616c6c202e6a6176612066696c65732073706563696669656420696e207468652064656d6f2e6c737420616e642073746f72657320746865202e636c6173732066696c657320696e2074686520247b6275696c647d206469726563746f7279> 89.8438 <2e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.8794 Tw + +BT +48.24 164.356 Td +/F1.0 10.5 Tf +[<556e6c696b> 20.0195 <6520746865204a61766163207461736b2c2074686520696e636c756465732061747472696275746520697320656d7074792062> 20.0195 <792064656661756c742c20736f206f6e6c792074686f73652066696c65732073706563696669656420696e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 148.576 Td +/F1.0 10.5 Tf +<64656d6f2e6c73742061726520696e636c756465642e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 120.796 Td +/F1.0 10.5 Tf +<54686973206e657874206578616d706c65> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp2 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +49.24 14.263 Td +/F1.0 9 Tf +<3334> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +188 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 187 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F1.0 8 0 R +/F3.0 26 0 R +/F2.0 22 0 R +>> +/XObject << /Stamp2 361 0 R +>> +>> +>> +endobj +189 0 obj +[188 0 R /XYZ 0 703.74 null] +endobj +190 0 obj +<< /Length 12572 +>> +stream +q +q +/DeviceRGB cs +0.9608 0.9608 0.9608 scn +52.24 805.89 m +543.04 805.89 l +545.2491 805.89 547.04 804.0991 547.04 801.89 c +547.04 714.19 l +547.04 711.9809 545.2491 710.19 543.04 710.19 c +52.24 710.19 l +50.0309 710.19 48.24 711.9809 48.24 714.19 c +48.24 801.89 l +48.24 804.0991 50.0309 805.89 52.24 805.89 c +h +f +/DeviceRGB CS +0.8 0.8 0.8 SCN +0.75 w +52.24 805.89 m +543.04 805.89 l +545.2491 805.89 547.04 804.0991 547.04 801.89 c +547.04 714.19 l +547.04 711.9809 545.2491 710.19 543.04 710.19 c +52.24 710.19 l +50.0309 710.19 48.24 711.9809 48.24 714.19 c +48.24 801.89 l +48.24 804.0991 50.0309 805.89 52.24 805.89 c +h +S +Q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +59.24 783.065 Td +/F3.0 11 Tf +<3c616a63207372636469723d22247b7372637d22> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 768.325 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 753.585 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 738.845 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 724.105 Td +/F3.0 11 Tf +<2f3e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.9706 Tw + +BT +48.24 686.226 Td +/F1.0 10.5 Tf +<636f6d70696c6573202e6a6176612066696c657320756e6465722074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.9706 Tw + +BT +207.0984 686.226 Td +/F3.0 10.5 Tf +<247b7372637d> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.9706 Tw + +BT +238.5984 686.226 Td +/F1.0 10.5 Tf +<206469726563746f727920696e2074686520737061636577617220616e6420636f6f7264696e6174696f6e207061636b616765732c20616e64> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.142 Tw + +BT +48.24 670.446 Td +/F1.0 10.5 Tf +<73746f72657320746865202e636c6173732066696c657320696e2074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.142 Tw + +BT +190.5102 670.446 Td +/F3.0 10.5 Tf +<247b6275696c647d> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.142 Tw + +BT +232.5102 670.446 Td +/F1.0 10.5 Tf +[<206469726563746f7279> 89.8438 <2e20416c6c20736f757263652066696c657320756e6465722073706163657761722f20616e6420636f6f7264696e6174696f6e2f>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 654.666 Td +/F1.0 10.5 Tf +<61726520757365642c206578636570742044656275672e6a6176612e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 626.886 Td +/F1.0 10.5 Tf +<536565202e2e2f6578616d706c65732f6275696c642e786d6c20666f7220616e206578616d706c65206275696c64207363726970742e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 587.046 Td +/F2.0 18 Tf +<342e362e2049736f6c6174696e672070726f626c656d732072756e6e696e672074686520416e74207461736b73> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.578 Tw + +BT +48.24 559.026 Td +/F1.0 10.5 Tf +[<496620796f7520686176652070726f626c656d73207769746820746865207461736b73206e6f7420736f6c7665642062> 20.0195 <792074686520646f63756d656e746174696f6e2c20706c656173652074727920746f2073656520696620796f752068617665>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 543.246 Td +/F1.0 10.5 Tf +<7468652073616d652070726f626c656d73207768656e2072756e6e696e6720616a63206469726563746c79206f6e2074686520636f6d6d616e64206c696e652e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 515.466 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5043 Tw + +BT +66.24 515.466 Td +/F1.0 10.5 Tf +[<4966207468652070726f626c656d206f6363757273206f6e2074686520636f6d6d616e64206c696e6520616c736f2c207468656e207468652070726f626c656d206973206e6f7420696e20746865207461736b2e20284974206d61> 20.0195 <79206265>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 499.686 Td +/F1.0 10.5 Tf +<696e2074686520746f6f6c733b20706c656173652073656e6420627567207265706f7274732e29> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 477.906 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.8508 Tw + +BT +66.24 477.906 Td +/F1.0 10.5 Tf +[<4966207468652070726f626c656d20646f6573206e6f74206f63637572206f6e2074686520636f6d6d616e64206c696e652c207468656e206974206d61> 20.0195 <79206c696520696e2074686520706172> 20.0195 <616d657465727320796f7520617265>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 462.126 Td +/F1.0 10.5 Tf +<737570706c79696e6720696e20416e74206f7220696e20746865207461736bd5732068616e646c696e67206f66207468656d2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 440.346 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.9673 Tw + +BT +66.24 440.346 Td +/F1.0 10.5 Tf +<496620746865206275696c6420736372697074206c6f6f6b7320636f727265637420616e64207468652070726f626c656d206f6e6c79206f6363757273207768656e206275696c64696e672066726f6d20416e742c207468656e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 424.566 Td +/F1.0 10.5 Tf +<706c656173652073656e642061207265706f72742028696e636c7564696e6720796f7572206275696c642066696c652c20696620706f737369626c65292e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 390.066 Td +/F2.0 13 Tf +<342e362e312e204b6e6f776e2069737375657320776974682074686520416e74207461736b73> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.3551 Tw + +BT +48.24 363.506 Td +/F1.0 10.5 Tf +[<46> 40.0391 <6f7220746865206d6f73742075702d746f2d6461746520696e666f726d6174696f6e206f6e206b6e6f776e2070726f626c656d732c207365652074686520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +2.3551 Tw + +BT +397.3953 363.506 Td +/F1.0 10.5 Tf +<627567206461746162617365> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.3551 Tw + +BT +465.8374 363.506 Td +/F1.0 10.5 Tf +<20666f7220756e7265736f6c766564> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +48.24 347.726 Td +/F1.0 10.5 Tf +<636f6d70696c65722062756773> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +119.178 347.726 Td +/F1.0 10.5 Tf +<206f7220> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +135.621 347.726 Td +/F1.0 10.5 Tf +[<7461736b> 20.0195 <6465662062756773>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +198.0013 347.726 Td +/F1.0 10.5 Tf +<202e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.9197 Tw + +BT +48.24 319.946 Td +/F1.0 10.5 Tf +[<5768656e2072756e6e696e6720416e74206275696c64207363726970747320756e6465722045636c6970736520322e782076617269616e74732c20796f752077696c6c2067657420612056> 60.0586 <65726966794572726f72206265636175736520746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.171 Tw + +BT +48.24 304.166 Td +/F1.0 10.5 Tf +[<45636c6970736520416e7420737570706f7274206661696c7320746f2069736f6c6174652074686520416e742072756e74696d652070726f7065726c79> 89.8438 <2e2054> 29.7852 <6f2072756e20696e207468697320636f6e746578742c207365742075702069616a6320746f>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 288.386 Td +/F1.0 10.5 Tf +[<666f726b2028616e642075736520666f726b> 20.0195 <636c61737370617468292e2045636c6970736520332e302077696c6c20666f726b20416e742070726f63657373657320746f2061766f69642070726f626c656d73206c696b> 20.0195 <6520746869732e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.0149 Tw + +BT +48.24 260.606 Td +/F1.0 10.5 Tf +[<4d656d6f727920616e6420666f726b696e673a20557365727320656d61696c206d6f7374206f6674656e2061626f75742074686520616a63207461736b2072756e6e696e67206f7574206f66206d656d6f7279> 89.8438 <2e2054686973206973206e6f742061>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1776 Tw + +BT +48.24 244.826 Td +/F1.0 10.5 Tf +[<70726f626c656d207769746820746865207461736b3b20736f6d6520636f6d70696c65732074616b> 20.0195 <652061206c6f74206f66206d656d6f7279> 89.8438 <2c206f6674656e206d6f7265207468616e2073696d696c617220636f6d70696c6573207573696e67>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 229.046 Td +/F1.0 10.5 Tf +<6a617661632e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.305 Tw + +BT +48.24 201.266 Td +/F1.0 10.5 Tf +[<46> 40.0391 <6f726b696e67206973206e6f7720737570706f7274656420696e20626f74682074686520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +0.305 Tw + +BT +237.9988 201.266 Td +/F1.0 10.5 Tf +[<416a633131436f6d70696c657241> 20.0195 <64617074657220286a6176616329>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.305 Tw + +BT +388.1595 201.266 Td +/F1.0 10.5 Tf +<20616e6420> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +0.305 Tw + +BT +413.3184 201.266 Td +/F1.0 10.5 Tf +[<416a6354> 29.7852 <61736b202869616a6329>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.305 Tw + +BT +479.7546 201.266 Td +/F1.0 10.5 Tf +<2c20616e6420796f752063616e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1141 Tw + +BT +48.24 185.486 Td +/F1.0 10.5 Tf +[<73657420746865206d6178696d756d206d656d6f727920617661696c61626c652e2059> 69.8242 <6f752063616e20616c736f206e6f7420666f726b20616e6420696e63726561736520746865206d656d6f727920617661696c61626c6520746f>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0134 Tw + +BT +48.24 169.706 Td +/F1.0 10.5 Tf +<416e7420287365652074686520416e7420646f63756d656e746174696f6e2c20736561726368696e6720666f7220414e545f4f5054532c20746865207661726961626c6520746865792075736520696e207468656972207363726970747320746f> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 153.926 Td +/F1.0 10.5 Tf +<7061737320564d206f7074696f6e732c20652e672e2c20414e545f4f5054533d2d586d783132386d292e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 119.426 Td +/F2.0 13 Tf +<342e362e322e20416e74207461736b207175657374696f6e7320616e642062756773> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6717 Tw + +BT +48.24 92.866 Td +/F1.0 10.5 Tf +[<46> 40.0391 <6f72207175657374696f6e732c20796f752063616e2073656e6420656d61696c20746f20>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +0.6717 Tw + +BT +237.2585 92.866 Td +/F1.0 10.5 Tf +[<6173706563746a2d757365727340646576> 69.8242 <2e65636c697073652e6f7267>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6717 Tw + +BT +385.0373 92.866 Td +/F1.0 10.5 Tf +<2e2028446f206a6f696e20746865206c69737420746f2070617274696369706174652129> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5177 Tw + +BT +48.24 77.086 Td +/F1.0 10.5 Tf +[<57> 60.0586 <6520616c736f2077656c636f6d6520616e> 20.0195 <7920627567207265706f7274732c20706174636865732c20616e642066656174757265733b20796f752063616e207375626d6974207468656d20746f2074686520627567206461746162617365>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 61.306 Td +/F1.0 10.5 Tf +<617420> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +60.5565 61.306 Td +/F1.0 10.5 Tf +<687474703a2f2f627567732e65636c697073652e6f72672f62756773> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +196.1535 61.306 Td +/F1.0 10.5 Tf +<207573696e6720746865204173706563744a2070726f6475637420616e6420416e7420636f6d706f6e656e742e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp1 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.978 14.263 Td +/F1.0 9 Tf +<3335> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +191 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 190 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F3.0 26 0 R +/F1.0 8 0 R +/F2.0 22 0 R +>> +/XObject << /Stamp1 360 0 R +>> +>> +/Annots [194 0 R 195 0 R 196 0 R 197 0 R 198 0 R 200 0 R 201 0 R] +>> +endobj +192 0 obj +[191 0 R /XYZ 0 611.07 null] +endobj +193 0 obj +[191 0 R /XYZ 0 408.75 null] +endobj +194 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (http://bugs.eclipse.org/bugs) +>> +/Subtype /Link +/Rect [397.3953 360.44 465.8374 374.72] +/Type /Annot +>> +endobj +195 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (http://bugs.eclipse.org/bugs/buglist.cgi?&product=AspectJ&component=Compiler&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED) +>> +/Subtype /Link +/Rect [48.24 344.66 119.178 358.94] +/Type /Annot +>> +endobj +196 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (http://bugs.eclipse.org/bugs/buglist.cgi?&product=AspectJ&component=Ant&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED) +>> +/Subtype /Link +/Rect [135.621 344.66 198.0013 358.94] +/Type /Annot +>> +endobj +197 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#antTasks-adapter) +>> +/Subtype /Link +/Rect [237.9988 198.2 388.1595 212.48] +/Type /Annot +>> +endobj +198 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#antTasks-iajc) +>> +/Subtype /Link +/Rect [413.3184 198.2 479.7546 212.48] +/Type /Annot +>> +endobj +199 0 obj +[191 0 R /XYZ 0 138.11 null] +endobj +200 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (mailto:aspectj-users@dev.eclipse.org) +>> +/Subtype /Link +/Rect [237.2585 89.8 385.0373 104.08] +/Type /Annot +>> +endobj +201 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (http://bugs.eclipse.org/bugs) +>> +/Subtype /Link +/Rect [60.5565 58.24 196.1535 72.52] +/Type /Annot +>> +endobj +202 0 obj +<< /Length 11495 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +48.24 782.394 Td +/F2.0 22 Tf +[<4368617074657220352e204c6f61642d54696d652057> 60.0586 <656176696e67>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 741.146 Td +/F2.0 18 Tf +<352e312e20496e74726f64756374696f6e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.6605 Tw + +BT +48.24 713.126 Td +/F1.0 10.5 Tf +[<546865204173706563744a207765617665722074616b> 20.0195 <657320636c6173732066696c657320617320696e70757420616e642070726f647563657320636c6173732066696c6573206173206f75747075742e205468652077656176696e67>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2576 Tw + +BT +48.24 697.346 Td +/F1.0 10.5 Tf +[<70726f6365737320697473656c662063616e2074616b> 20.0195 <6520706c616365206174206f6e65206f6620746872656520646966666572656e742074696d65733a20636f6d70696c652d74696d652c20706f73742d636f6d70696c652074696d652c20616e64>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1027 Tw + +BT +48.24 681.566 Td +/F1.0 10.5 Tf +[<6c6f61642d74696d652e2054686520636c6173732066696c65732070726f64756365642062> 20.0195 <79207468652077656176696e672070726f636573732028616e642068656e6365207468652072756e2d74696d65206265686176696f7572206f6620616e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 665.786 Td +/F1.0 10.5 Tf +<6170706c69636174696f6e2920617265207468652073616d65207265676172646c657373206f662074686520617070726f6163682063686f73656e2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 638.006 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.6398 Tw + +BT +66.24 638.006 Td +/F1.0 10.5 Tf +<436f6d70696c652d74696d652077656176696e67206973207468652073696d706c65737420617070726f6163682e205768656e20796f7520686176652074686520736f7572636520636f646520666f7220616e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.988 Tw + +BT +66.24 622.226 Td +/F1.0 10.5 Tf +<6170706c69636174696f6e2c20616a632077696c6c20636f6d70696c652066726f6d20736f7572636520616e642070726f6475636520776f76656e20636c6173732066696c6573206173206f75747075742e20546865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4796 Tw + +BT +66.24 606.446 Td +/F1.0 10.5 Tf +[<696e766f636174696f6e206f66207468652077656176657220697320696e74656772> 20.0195 <616c20746f2074686520616a6320636f6d70696c6174696f6e2070726f636573732e205468652061737065637473207468656d73656c766573206d61> 20.0195 <79>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4067 Tw + +BT +66.24 590.666 Td +/F1.0 10.5 Tf +<626520696e20736f75726365206f722062696e61727920666f726d2e2049662074686520617370656374732061726520726571756972656420666f722074686520616666656374656420636c617373657320746f20636f6d70696c652c207468656e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.7241 Tw + +BT +66.24 574.886 Td +/F1.0 10.5 Tf +<796f75206d75737420776561766520617420636f6d70696c652d74696d652e2041737065637473206172652072657175697265642c20652e672e2c207768656e207468657920616464206d656d6265727320746f206120636c617373> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 559.106 Td +/F1.0 10.5 Tf +<616e64206f7468657220636c6173736573206265696e6720636f6d70696c6564207265666572656e636520746865206164646564206d656d626572732e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 537.326 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.5903 Tw + +BT +66.24 537.326 Td +/F1.0 10.5 Tf +<506f73742d636f6d70696c652077656176696e672028616c736f20736f6d6574696d65732063616c6c65642062696e6172792077656176696e6729206973207573656420746f207765617665206578697374696e6720636c617373> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.0285 Tw + +BT +66.24 521.546 Td +/F1.0 10.5 Tf +[<66696c657320616e64204a41522066696c65732e204173207769746820636f6d70696c652d74696d652077656176696e672c207468652061737065637473207573656420666f722077656176696e67206d61> 20.0195 <7920626520696e20736f75726365>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 505.766 Td +/F1.0 10.5 Tf +[<6f722062696e61727920666f726d2c20616e64206d61> 20.0195 <79207468656d73656c76657320626520776f76656e2062> 20.0195 <7920617370656374732e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 483.986 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.087 Tw + +BT +66.24 483.986 Td +/F1.0 10.5 Tf +[<4c6f61642d74696d652077656176696e6720284c> 69.8242 <5457292069732073696d706c792062696e6172792077656176696e67206465666572656420756e74696c2074686520706f696e742074686174206120636c617373206c6f61646572>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.9288 Tw + +BT +66.24 468.206 Td +/F1.0 10.5 Tf +[<6c6f616473206120636c6173732066696c6520616e6420646566696e65732074686520636c61737320746f20746865204a564d2e2054> 29.7852 <6f20737570706f727420746869732c206f6e65206f72206d6f7265202277656176696e6720636c617373>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.0897 Tw + +BT +66.24 452.426 Td +/F1.0 10.5 Tf +[<6c6f6164657273222c206569746865722070726f7669646564206578706c696369746c792062> 20.0195 <79207468652072756e2d74696d6520656e7669726f6e6d656e74206f7220656e61626c6564207468726f7567682061202277656176696e67>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 436.646 Td +/F1.0 10.5 Tf +<6167656e7422206172652072657175697265642e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4766 Tw + +BT +48.24 408.866 Td +/F1.0 10.5 Tf +[<59> 69.8242 <6f75206d61> 20.0195 <7920616c736f206865617220746865207465726d202272756e2d74696d652077656176696e67222e2057> 60.0586 <6520646566696e652074686973206173207468652077656176696e67206f6620636c617373657320746861742068617665>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.4943 Tw + +BT +48.24 393.086 Td +/F1.0 10.5 Tf +<616c7265616479206265656e20646566696e656420746f20746865204a564d2028776974686f75742072656c6f6164696e672074686f736520636c6173736573292e204173706563744a203520646f6573206e6f742070726f76696465> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.802 Tw + +BT +48.24 377.306 Td +/F1.0 10.5 Tf +<6578706c6963697420737570706f727420666f722072756e2d74696d652077656176696e6720616c74686f7567682073696d706c6520636f64696e67207061747465726e732063616e20737570706f72742064796e616d6963616c6c79> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 361.526 Td +/F1.0 10.5 Tf +<656e61626c696e6720616e642064697361626c696e672061647669636520696e20617370656374732e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 327.026 Td +/F2.0 13 Tf +[<352e312e312e2057> 60.0586 <656176696e6720636c6173732066696c6573206d6f7265207468616e206f6e6365>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.6773 Tw + +BT +48.24 300.466 Td +/F1.0 10.5 Tf +[<4173206f66204173706563744a203520617370656374732028636f6465207374796c65206f7220616e6e6f746174696f6e207374796c652920616e6420776f76656e20636c6173736573206172652072657765617661626c652062> 20.0195 <79>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.4274 Tw + +BT +48.24 284.686 Td +/F1.0 10.5 Tf +<64656661756c742e20496620796f752061726520646576656c6f70696e67204173706563744a206170706c69636174696f6e7320746861742061726520746f206265207573656420696e2061206c6f61642d74696d652077656176696e67> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.9681 Tw + +BT +48.24 268.906 Td +/F1.0 10.5 Tf +<656e7669726f6e6d656e74207769746820616e206f6c6465722076657273696f6e206f662074686520636f6d70696c657220796f75206e65656420746f20737065636966792074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.9681 Tw + +BT +435.6119 268.906 Td +/F3.0 10.5 Tf +<2d5872657765617661626c65> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.9681 Tw + +BT +498.6119 268.906 Td +/F1.0 10.5 Tf +<20636f6d70696c6572> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1079 Tw + +BT +48.24 253.126 Td +/F1.0 10.5 Tf +<6f7074696f6e207768656e206275696c64696e67207468656d2e205468697320636175736573204173706563744a20746f2073617665206164646974696f6e616c20737461746520696e2074686520636c6173732066696c657320746861742069732075736564> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 237.346 Td +/F1.0 10.5 Tf +<746f20737570706f72742073756273657175656e7420726577656176696e672e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 197.506 Td +/F2.0 18 Tf +[<352e322e204c6f61642d74696d652057> 60.0586 <656176696e6720526571756972656d656e7473>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4851 Tw + +BT +48.24 169.486 Td +/F1.0 10.5 Tf +<416c6c206c6f61642d74696d652077656176696e6720697320646f6e6520696e2074686520636f6e74657874206f66206120636c617373206c6f616465722c20616e642068656e63652074686520736574206f662061737065637473207573656420666f72> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2362 Tw + +BT +48.24 153.706 Td +/F1.0 10.5 Tf +[<77656176696e6720616e642074686520747970657320746861742063616e20626520776f76656e206172652061666665637465642062> 20.0195 <792074686520636c617373206c6f616465722064656c65676174696f6e206d6f64656c2e2054686973>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.6739 Tw + +BT +48.24 137.926 Td +/F1.0 10.5 Tf +[<656e73757265732074686174204c> 69.8242 <545720636f6d706c696573207769746820746865204a6176612032207365637572697479206d6f64656c2e2054686520666f6c6c6f77696e672072756c657320676f7665726e20746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 122.146 Td +/F1.0 10.5 Tf +[<696e746572> 20.0195 <616374696f6e206f66206c6f61642d74696d652077656176696e67207769746820636c617373206c6f6164696e673a>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +52.6765 94.366 Td +/F1.0 10.5 Tf +<312e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4611 Tw + +BT +66.24 94.366 Td +/F1.0 10.5 Tf +[<416c6c206173706563747320746f206265207573656420666f722077656176696e67206d75737420626520646566696e656420746f2074686520776561766572206265666f726520616e> 20.0195 <7920747970657320746f20626520776f76656e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.2674 Tw + +BT +66.24 78.586 Td +/F1.0 10.5 Tf +[<617265206c6f616465642e20546869732061766f696473207479706573206265696e6720226d6973736564222062> 20.0195 <792061737065637473206164646564206c617465722c20776974682074686520726573756c742074686174>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 62.806 Td +/F1.0 10.5 Tf +<696e76617269616e7473206163726f7373207479706573206661696c2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp2 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +49.24 14.263 Td +/F1.0 9 Tf +<3336> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +203 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 202 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F2.0 22 0 R +/F1.0 8 0 R +/F3.0 26 0 R +>> +/XObject << /Stamp2 361 0 R +>> +>> +>> +endobj +204 0 obj +[203 0 R /XYZ 0 841.89 null] +endobj +205 0 obj +[203 0 R /XYZ 0 765.17 null] +endobj +206 0 obj +[203 0 R /XYZ 0 345.71 null] +endobj +207 0 obj +[203 0 R /XYZ 0 221.53 null] +endobj +208 0 obj +<< /Length 13951 +>> +stream +q + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +52.6765 793.926 Td +/F1.0 10.5 Tf +<322e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.3641 Tw + +BT +66.24 793.926 Td +/F1.0 10.5 Tf +[<416c6c20617370656374732076697369626c6520746f20746865207765617665722061726520757361626c652e20412076697369626c6520617370656374206973206f6e6520646566696e65642062> 20.0195 <79207468652077656176696e6720636c617373>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5805 Tw + +BT +66.24 778.146 Td +/F1.0 10.5 Tf +[<6c6f61646572206f72206f6e65206f662069747320706172656e7420636c617373206c6f61646572732e20416c6c20636f6e63726574652076697369626c6520617370656374732061726520776f76656e20616e6420616c6c206162737472> 20.0195 <616374>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 762.366 Td +/F1.0 10.5 Tf +[<76697369626c652061737065637473206d61> 20.0195 <7920626520657874656e6465642e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +52.6765 740.586 Td +/F1.0 10.5 Tf +<332e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.8496 Tw + +BT +66.24 740.586 Td +/F1.0 10.5 Tf +[<4120636c617373206c6f61646572206d61> 20.0195 <79206f6e6c7920776561766520636c6173736573207468617420697420646566696e65732e204974206d61> 20.0195 <79206e6f7420776561766520636c6173736573206c6f616465642062> 20.0195 <792061>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 724.806 Td +/F1.0 10.5 Tf +<64656c6567617465206f7220706172656e7420636c617373206c6f616465722e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 684.966 Td +/F2.0 18 Tf +[<352e332e20436f6e6669677572> 20.0195 <6174696f6e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1499 Tw + +BT +48.24 656.946 Td +/F1.0 10.5 Tf +[<4e657720696e204173706563744a2035206172652061206e756d626572206f66206d656368616e69736d7320746f206d616b> 20.0195 <65206c6f61642d74696d652077656176696e67206561737920746f207573652e20546865206c6f61642d>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4347 Tw + +BT +48.24 641.166 Td +/F1.0 10.5 Tf +[<74696d652077656176696e67206d656368616e69736d2069732063686f73656e207468726f756768204a564d2073746172747570206f7074696f6e732e20436f6e6669677572> 20.0195 <6174696f6e2066696c65732064657465726d696e6520746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.517 Tw + +BT +48.24 625.386 Td +/F1.0 10.5 Tf +[<736574206f66206173706563747320746f206265207573656420666f722077656176696e6720616e642077686963682074797065732077696c6c20626520776f76656e2e2041> 20.0195 <64646974696f6e616c20646961676e6f73746963206f7074696f6e73>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 609.606 Td +/F1.0 10.5 Tf +[<616c6c6f7720746865207573657220746f2064656275672074686520636f6e6669677572> 20.0195 <6174696f6e20616e642077656176696e672070726f636573732e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 575.106 Td +/F2.0 13 Tf +[<352e332e312e20456e61626c696e67204c6f61642d74696d652057> 60.0586 <656176696e67>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.4156 Tw + +BT +48.24 548.546 Td +/F1.0 10.5 Tf +[<4173706563744a203520737570706f727473207365766572> 20.0195 <616c207761> 20.0195 <7973206f6620656e61626c696e67206c6f61642d74696d652077656176696e6720666f7220616e206170706c69636174696f6e3a206167656e74732c2061>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5053 Tw + +BT +48.24 532.766 Td +/F1.0 10.5 Tf +[<636f6d6d616e642d6c696e65206c61756e6368207363726970742c20616e64206120736574206f6620696e746572666163657320666f7220696e74656772> 20.0195 <6174696f6e206f66204173706563744a206c6f61642d74696d652077656176696e6720696e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 516.986 Td +/F1.0 10.5 Tf +<637573746f6d20656e7669726f6e6d656e74732e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 489.206 Td +/F2.0 10.5 Tf +[<41> 20.0195 <67656e7473>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.8761 Tw + +BT +63.24 470.426 Td +/F1.0 10.5 Tf +<4173706563744a203520736869707320776974682061206c6f61642d74696d652077656176696e67206167656e74207468617420656e61626c6573206c6f61642d74696d652077656176696e672e2054686973206167656e7420616e64> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +5.5128 Tw + +BT +63.24 454.646 Td +/F1.0 10.5 Tf +[<69747320636f6e6669677572> 20.0195 <6174696f6e20697320657865637574696f6e20656e7669726f6e6d656e7420646570656e64656e742e20436f6e6669677572> 20.0195 <6174696f6e20666f722074686520737570706f72746564>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.9226 Tw + +BT +63.24 438.866 Td +/F1.0 10.5 Tf +<656e7669726f6e6d656e747320697320646973637573736564206c6174657220696e207468697320636861707465722e202b205573696e67204a6176612035204a564d544920796f752063616e207370656369667920746865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +3.9282 Tw + +BT +63.24 423.086 Td +/F3.0 10.5 Tf +<2d6a6176616167656e743a70617468746f2f6173706563746a7765617665722e6a6172> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.9282 Tw + +BT +246.99 423.086 Td +/F1.0 10.5 Tf +<206f7074696f6e20746f20746865204a564d2e202b2053696e6365204173706563744a20312e392e372c20746865206f62736f6c657465> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.3954 Tw + +BT +63.24 407.306 Td +/F1.0 10.5 Tf +[<4f72> 20.0195 <61636c652f424541204a526f636b6974206167656e74206973206e6f206c6f6e6765722070617274206f66204173706563744a2e204a526f636b6974204a444b206e6576657220737570706f72746564204a6176612076657273696f6e73>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.8258 Tw + +BT +63.24 391.526 Td +/F1.0 10.5 Tf +[<686967686572207468616e20312e362e205365766572> 20.0195 <616c204a526f636b6974204a564d20666561747572657320617265206e6f772070617274206f6620486f7453706f7420616e6420746f6f6c73206c696b> 20.0195 <65204d697373696f6e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 375.746 Td +/F1.0 10.5 Tf +[<436f6e74726f6c20617661696c61626c6520666f72204f70656e4a444b20616e64204f72> 20.0195 <61636c65204a444b2e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 347.966 Td +/F2.0 10.5 Tf +[<436f6d6d616e642d6c696e65207772> 20.0195 <6170706572207363726970747320>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +215.7148 347.966 Td +/F4.0 10.5 Tf +<616a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6918 Tw + +BT +63.24 329.186 Td +/F1.0 10.5 Tf +<54686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.6918 Tw + +BT +85.3518 329.186 Td +/F3.0 10.5 Tf +<616a> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6918 Tw + +BT +95.8518 329.186 Td +/F1.0 10.5 Tf +[<20636f6d6d616e642072756e73204a6176612070726f6772> 20.0195 <616d7320696e204a61766120312e34206f72206c617465722062> 20.0195 <792073657474696e6720757020>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.6918 Tw + +BT +422.7422 329.186 Td +/F3.0 10.5 Tf +<57656176696e6755524c436c6173734c6f61646572> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6918 Tw + +BT +532.9922 329.186 Td +/F1.0 10.5 Tf +<206173> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6162 Tw + +BT +63.24 313.406 Td +/F1.0 10.5 Tf +[<7468652073797374656d20636c617373206c6f616465722e2046> 40.0391 <6f72206d6f726520696e666f726d6174696f6e2c2073656520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +0.6162 Tw + +BT +321.7335 313.406 Td +/F1.0 10.5 Tf +<3f3f3f> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6162 Tw + +BT +337.4835 313.406 Td +/F1.0 10.5 Tf +<2e202b2054686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.6162 Tw + +BT +374.6855 313.406 Td +/F3.0 10.5 Tf +<616a35> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6162 Tw + +BT +390.4355 313.406 Td +/F1.0 10.5 Tf +[<20636f6d6d616e642072756e73204a6176612070726f6772> 20.0195 <616d73>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.8282 Tw + +BT +63.24 297.626 Td +/F1.0 10.5 Tf +[<696e204a61766120352062> 20.0195 <79207573696e672074686520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.8282 Tw + +BT +183.4194 297.626 Td +/F3.0 10.5 Tf +<2d6a6176616167656e743a70617468746f2f6173706563746a7765617665722e6a6172> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.8282 Tw + +BT +367.1694 297.626 Td +/F1.0 10.5 Tf +[<206f7074696f6e206465736372696265642061626f76652e2046> 40.0391 <6f72206d6f7265>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +63.24 281.846 Td +/F1.0 10.5 Tf +<696e666f726d6174696f6e2c2073656520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +147.9645 281.846 Td +/F1.0 10.5 Tf +<3f3f3f> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +163.7145 281.846 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 254.066 Td +/F2.0 10.5 Tf +<437573746f6d20636c617373206c6f61646572> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2188 Tw + +BT +63.24 235.286 Td +/F1.0 10.5 Tf +<41207075626c696320696e746572666163652069732070726f766964656420746f20616c6c6f7720612075736572207772697474656e20636c617373206c6f6164657220746f20696e7374616e746961746520612077656176657220616e64> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.4514 Tw + +BT +63.24 219.506 Td +/F1.0 10.5 Tf +<776561766520636c6173736573206166746572206c6f6164696e6720616e64206265666f726520646566696e696e67207468656d20696e20746865204a564d2e205468697320656e61626c6573206c6f61642d74696d65> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.0295 Tw + +BT +63.24 203.726 Td +/F1.0 10.5 Tf +<77656176696e6720746f20626520737570706f7274656420696e20656e7669726f6e6d656e7473207768657265206e6f2077656176696e67206167656e7420697320617661696c61626c652e20497420616c736f20616c6c6f777320746865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.479 Tw + +BT +63.24 187.946 Td +/F1.0 10.5 Tf +[<7573657220746f206578706c696369746c792072657374726963742062> 20.0195 <7920636c617373206c6f6164657220776869636820636c61737365732063616e20626520776f76656e2e2046> 40.0391 <6f72206d6f726520696e666f726d6174696f6e2c20736565>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +63.24 172.166 Td +/F1.0 10.5 Tf +<3f3f3f> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +78.99 172.166 Td +/F1.0 10.5 Tf +<20616e64207468652041504920646f63756d656e746174696f6e20616e6420736f7572636520666f7220> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +296.6865 172.166 Td +/F3.0 10.5 Tf +<57656176696e6755524c436c6173734c6f61646572> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +406.9365 172.166 Td +/F1.0 10.5 Tf +<20616e6420> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +431.4855 172.166 Td +/F3.0 10.5 Tf +<57656176696e6741646170746572> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +504.9855 172.166 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 137.666 Td +/F2.0 13 Tf +[<352e332e322e20436f6e6669677572696e67204c6f61642d74696d652057> 60.0586 <656176696e67207769746820616f702e786d6c2066696c6573>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.3781 Tw + +BT +48.24 111.106 Td +/F1.0 10.5 Tf +<5468652077656176657220697320636f6e66696775726564207573696e67206f6e65206f72206d6f726520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +2.3781 Tw + +BT +290.6836 111.106 Td +/F3.0 10.5 Tf +<4d4554412d494e462f616f702e786d6c> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.3781 Tw + +BT +374.6836 111.106 Td +/F1.0 10.5 Tf +<2066696c6573206c6f6361746564206f6e2074686520636c617373206c6f61646572> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4205 Tw + +BT +48.24 95.326 Td +/F1.0 10.5 Tf +[<73656172636820706174682e20456163682066696c65206d61> 20.0195 <79206465636c6172652061206c697374206f66206173706563747320746f206265207573656420666f722077656176696e672c2074797065207061747465726e732064657363726962696e67>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1094 Tw + +BT +48.24 79.546 Td +/F1.0 10.5 Tf +<77686963682074797065732073686f756c6420776f76656e2c20616e64206120736574206f66206f7074696f6e7320746f2062652070617373656420746f20746865207765617665722e20496e206164646974696f6e204173706563744a2035> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.7834 Tw + +BT +48.24 63.766 Td +/F1.0 10.5 Tf +[<737570706f7274732074686520646566696e6974696f6e206f6620636f6e6372657465206173706563747320696e20584d4c2e204173706563747320646566696e656420696e2074686973207761> 20.0195 <79206d75737420657874656e6420616e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp1 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.978 14.263 Td +/F1.0 9 Tf +<3337> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +209 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 208 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F1.0 8 0 R +/F2.0 22 0 R +/F3.0 26 0 R +/F4.0 149 0 R +>> +/XObject << /Stamp1 360 0 R +>> +>> +/Annots [212 0 R 213 0 R 214 0 R] +>> +endobj +210 0 obj +[209 0 R /XYZ 0 708.99 null] +endobj +211 0 obj +[209 0 R /XYZ 0 593.79 null] +endobj +212 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#aj) +>> +/Subtype /Link +/Rect [321.7335 310.34 337.4835 324.62] +/Type /Annot +>> +endobj +213 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#aj) +>> +/Subtype /Link +/Rect [147.9645 278.78 163.7145 293.06] +/Type /Annot +>> +endobj +214 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (#aj) +>> +/Subtype /Link +/Rect [63.24 169.1 78.99 183.38] +/Type /Annot +>> +endobj +215 0 obj +[209 0 R /XYZ 0 156.35 null] +endobj +216 0 obj +<< /Length 8466 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +1.6454 Tw + +BT +48.24 794.676 Td +/F1.0 10.5 Tf +[<6162737472> 20.0195 <616374206173706563742076697369626c6520746f20746865207765617665722e20546865206162737472> 20.0195 <61637420617370656374206d61> 20.0195 <7920646566696e65206162737472> 20.0195 <61637420706f696e74637574732028627574206e6f74>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 778.896 Td +/F1.0 10.5 Tf +[<6162737472> 20.0195 <616374206d6574686f6473292e2054686520666f6c6c6f77696e67206578616d706c652073686f777320612073696d706c6520616f702e786d6c2066696c653a>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 763.08 m +543.04 763.08 l +545.2491 763.08 547.04 761.2891 547.04 759.08 c +547.04 67.04 l +547.04 64.8309 545.2491 63.04 543.04 63.04 c +52.24 63.04 l +50.0309 63.04 48.24 64.8309 48.24 67.04 c +48.24 759.08 l +48.24 761.2891 50.0309 763.08 52.24 763.08 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 763.08 m +543.04 763.08 l +545.2491 763.08 547.04 761.2891 547.04 759.08 c +547.04 67.04 l +547.04 64.8309 545.2491 63.04 543.04 63.04 c +52.24 63.04 l +50.0309 63.04 48.24 64.8309 48.24 67.04 c +48.24 759.08 l +48.24 761.2891 50.0309 763.08 52.24 763.08 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 740.255 Td +/F3.0 11 Tf +<3c6173706563746a3e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 710.775 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 696.035 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 681.295 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 666.555 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 637.075 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 622.335 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 607.595 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 592.855 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 578.115 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 563.375 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 533.895 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 519.155 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 504.415 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 474.935 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 460.195 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 445.455 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 415.975 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 386.495 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 371.755 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 357.015 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 342.275 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 327.535 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 312.795 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 298.055 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 268.575 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 253.835 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 224.355 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 209.615 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 194.875 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 165.395 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 150.655 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 135.915 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 121.175 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 106.435 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 76.955 Td +/F3.0 11 Tf +<3c2f6173706563746a3e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp2 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +49.24 14.263 Td +/F1.0 9 Tf +<3338> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +217 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 216 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F1.0 8 0 R +/F3.0 26 0 R +>> +/XObject << /Stamp2 361 0 R +>> +>> +>> +endobj +218 0 obj +<< /Length 19049 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +21.5153 Tw + +BT +48.24 794.676 Td +/F1.0 10.5 Tf +[<5468652044> 20.0195 <544420646566696e696e672074686520666f726d6174206f6620746869732066696c6520697320617661696c61626c6520686572653a>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +48.24 778.896 Td +/F1.0 10.5 Tf +[<687474703a2f2f777777> 69.8242 <2e65636c697073652e6f72672f6173706563746a2f6474642f>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +220.5783 778.896 Td +/F1.0 10.5 Tf +<6173706563746a2e647464> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +274.4643 778.896 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.9659 Tw + +BT +48.24 751.116 Td +/F1.0 10.5 Tf +[<416e20616f702e786d6c2066696c6520636f6e7461696e732074776f206b> 20.0195 <65792073656374696f6e733a20>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.9659 Tw + +BT +266.4078 751.116 Td +/F3.0 10.5 Tf +<61737065637473> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.9659 Tw + +BT +303.1578 751.116 Td +/F1.0 10.5 Tf +<20646566696e6573206f6e65206f72206d6f7265206173706563747320746f207468652077656176657220616e64> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1947 Tw + +BT +48.24 735.336 Td +/F1.0 10.5 Tf +<636f6e74726f6c7320776869636820617370656374732061726520746f206265207573656420696e207468652077656176696e672070726f636573733b20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.1947 Tw + +BT +370.0611 735.336 Td +/F3.0 10.5 Tf +<776561766572> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1947 Tw + +BT +401.5611 735.336 Td +/F1.0 10.5 Tf +<20646566696e657320776561766572206f7074696f6e7320616e64> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 719.556 Td +/F1.0 10.5 Tf +<77686963682074797065732073686f756c6420626520776f76656e2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6935 Tw + +BT +48.24 691.776 Td +/F1.0 10.5 Tf +[<5468652073696d706c657374207761> 20.0195 <7920746f20646566696e6520616e2061737065637420746f207468652077656176657220697320746f2073706563696679207468652066756c6c792d7175616c6966696564206e616d65206f6620746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.7125 Tw + +BT +48.24 675.996 Td +/F1.0 10.5 Tf +[<617370656374207479706520696e20616e2061737065637420656c656d656e742e2059> 69.8242 <6f752063616e20616c736f206465636c6172652028616e6420646566696e6520746f207468652077656176657229206173706563747320696e6c696e6520696e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1711 Tw + +BT +48.24 660.216 Td +/F1.0 10.5 Tf +<74686520616f702e786d6c2066696c652e205468697320697320646f6e65207573696e672074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.1711 Tw + +BT +243.5854 660.216 Td +/F3.0 10.5 Tf +<636f6e63726574652d617370656374> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1711 Tw + +BT +322.3354 660.216 Td +/F1.0 10.5 Tf +[<20656c656d656e742e204120636f6e63726574652d617370656374206465636c6172> 20.0195 <6174696f6e206d757374>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.2814 Tw + +BT +48.24 644.436 Td +/F1.0 10.5 Tf +[<70726f76696465206120706f696e7463757420646566696e6974696f6e20666f72206576657279206162737472> 20.0195 <61637420706f696e7463757420696e20746865206162737472> 20.0195 <6163742061737065637420697420657874656e64732e2054686973>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0 Tw + +BT +48.24 628.656 Td +/F1.0 10.5 Tf +[<6d656368616e69736d20697320612075736566756c207761> 20.0195 <79206f662065787465726e616c697a696e6720636f6e6669677572> 20.0195 <6174696f6e20666f7220696e6672> 20.0195 <6173747275637475726520616e6420617578696c696172792061737065637473>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.9212 Tw + +BT +48.24 612.876 Td +/F1.0 10.5 Tf +[<77686572652074686520706f696e7463757420646566696e6974696f6e73207468656d73656c7665732063616e20626520636f6e736964657265642070617274206f662074686520636f6e6669677572> 20.0195 <6174696f6e206f6620746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 597.096 Td +/F1.0 10.5 Tf +<736572766963652e20526566657220746f20746865206e6578742073656374696f6e20666f72206d6f72652064657461696c732e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5129 Tw + +BT +48.24 569.316 Td +/F1.0 10.5 Tf +<54686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.5129 Tw + +BT +70.1729 569.316 Td +/F3.0 10.5 Tf +<61737065637473> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5129 Tw + +BT +106.9229 569.316 Td +/F1.0 10.5 Tf +[<20656c656d656e74206d61> 20.0195 <79206f7074696f6e616c6c7920636f6e7461696e206f6e65206f72206d6f726520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.5129 Tw + +BT +339.201 569.316 Td +/F3.0 10.5 Tf +<696e636c756465> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5129 Tw + +BT +375.951 569.316 Td +/F1.0 10.5 Tf +<20616e6420> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.5129 Tw + +BT +401.5257 569.316 Td +/F3.0 10.5 Tf +<6578636c756465> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5129 Tw + +BT +438.2757 569.316 Td +/F1.0 10.5 Tf +[<20656c656d656e7473202862> 20.0195 <792064656661756c742c>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1846 Tw + +BT +48.24 553.536 Td +/F1.0 10.5 Tf +<616c6c20646566696e6564206173706563747320617265207573656420666f722077656176696e67292e2053706563696679696e6720696e636c756465206f72206578636c75646520656c656d656e7473207265737472696374732074686520736574206f66> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5202 Tw + +BT +48.24 537.756 Td +/F1.0 10.5 Tf +[<646566696e6564206173706563747320746f206265207573656420666f722077656176696e6720746f2074686f7365207468617420617265206d6174636865642062> 20.0195 <7920616e20696e636c756465207061747465726e2c20627574206e6f742062> 20.0195 <79>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1122 Tw + +BT +48.24 521.976 Td +/F1.0 10.5 Tf +<616e206578636c756465207061747465726e2e2054686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.1122 Tw + +BT +173.4494 521.976 Td +/F3.0 10.5 Tf +<77697468696e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1122 Tw + +BT +204.9494 521.976 Td +/F1.0 10.5 Tf +<20617474726962757465206163636570747320612074797065207061747465726e206f66207468652073616d6520666f726d20617320612077697468696e207063642c> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 506.196 Td +/F1.0 10.5 Tf +[<657863657074207468617420262620616e64207c7c20617265207265706c616365642062> 20.0195 <792027> 80.0781 <414e442720616e6420274f52272e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6277 Tw + +BT +48.24 478.416 Td +/F1.0 10.5 Tf +<4e6f7465207468617420> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.6277 Tw + +BT +98.268 478.416 Td +/F3.0 10.5 Tf +<696e636c756465> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6277 Tw + +BT +135.018 478.416 Td +/F1.0 10.5 Tf +<20616e6420> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.6277 Tw + +BT +160.8224 478.416 Td +/F3.0 10.5 Tf +<6578636c756465> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6277 Tw + +BT +197.5724 478.416 Td +/F1.0 10.5 Tf +<20656c656d656e74732061666665637420616c6c2061737065637473206465636c6172656420746f207468652077656176657220696e636c7564696e672074686f736520696e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5321 Tw + +BT +48.24 462.636 Td +/F1.0 10.5 Tf +[<6f7468657220616f702e786d6c2066696c65732e2054> 29.7852 <6f2068656c702061766f696420756e6578706563746564206265686176696f75722061206c696e74207761726e696e672069732069737375656420696620616e20617370656374206973206e6f74>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2665 Tw + +BT +48.24 446.856 Td +/F1.0 10.5 Tf +<6465636c61726564206173206120726573756c74206f66206f66206170706c79696e672074686573652066696c746572732e20416c736f206e6f746520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.2665 Tw + +BT +335.5119 446.856 Td +/F3.0 10.5 Tf +<617370656374> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2665 Tw + +BT +367.0119 446.856 Td +/F1.0 10.5 Tf +<20616e6420> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.2665 Tw + +BT +392.0939 446.856 Td +/F3.0 10.5 Tf +<636f6e63726574652d617370656374> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2665 Tw + +BT +470.8439 446.856 Td +/F1.0 10.5 Tf +<20656c656d656e7473206d757374> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.9706 Tw + +BT +48.24 431.076 Td +/F1.0 10.5 Tf +<6265207573656420746f206465636c617265206173706563747320746f207468652077656176657220692e652e20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.9706 Tw + +BT +286.0761 431.076 Td +/F3.0 10.5 Tf +<696e636c756465> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.9706 Tw + +BT +322.8261 431.076 Td +/F1.0 10.5 Tf +<20616e6420> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.9706 Tw + +BT +351.3162 431.076 Td +/F3.0 10.5 Tf +<6578636c756465> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.9706 Tw + +BT +388.0662 431.076 Td +/F1.0 10.5 Tf +<20656c656d656e74732063616e6e6f7420626520757365642066696e64> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 415.296 Td +/F1.0 10.5 Tf +<61737065637473206f6e2074686520636c617373206c6f616465722073656172636820706174682e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4862 Tw + +BT +48.24 387.516 Td +/F1.0 10.5 Tf +<54686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.4862 Tw + +BT +70.1462 387.516 Td +/F3.0 10.5 Tf +<776561766572> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4862 Tw + +BT +101.6462 387.516 Td +/F1.0 10.5 Tf +<20656c656d656e74206973207573656420746f2070617373206f7074696f6e7320746f207468652077656176657220616e6420746f20737065636966792074686520736574206f6620747970657320746861742073686f756c64> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1352 Tw + +BT +48.24 371.736 Td +/F1.0 10.5 Tf +<626520776f76656e2e204966206e6f20696e636c75646520656c656d656e74732061726520737065636966696564207468656e20616c6c2074797065732076697369626c6520746f20746865207765617665722077696c6c20626520776f76656e2e20496e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.4446 Tw + +BT +48.24 355.956 Td +/F1.0 10.5 Tf +<6164646974696f6e2074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.4446 Tw + +BT +114.5388 355.956 Td +/F3.0 10.5 Tf +<64756d70> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.4446 Tw + +BT +135.5388 355.956 Td +/F1.0 10.5 Tf +[<20656c656d656e742063616e20626520757365642063617074757265206f6e206469736b2062> 20.0195 <7974652d636f6465206f6620776f76656e20636c617373657320666f7220646961676e6f73746963>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 340.176 Td +/F1.0 10.5 Tf +[<707572706f73657320626f7468206265666f72652c20696e207468652063617365206f662074686f73652067656e6572> 20.0195 <617465642061742072756e74696d652c20616e64206166746572207468652077656176696e672070726f636573732e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1984 Tw + +BT +48.24 312.396 Td +/F1.0 10.5 Tf +[<5768656e207365766572> 20.0195 <616c20636f6e6669677572> 20.0195 <6174696f6e2066696c6573206172652076697369626c652066726f6d206120676976656e2077656176696e6720636c617373206c6f6164657220746865697220636f6e74656e747320617265>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.8615 Tw + +BT +48.24 296.616 Td +/F1.0 10.5 Tf +<636f6e6365707475616c6c79206d65726765642e205468652066696c657320617265206d657267656420696e20746865206f7264657220746865792061726520666f756e64206f6e207468652073656172636820706174682028776974682061> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 280.836 Td +/F1.0 10.5 Tf +<726567756c617220> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +87.93 280.836 Td +/F3.0 10.5 Tf +<6765745265736f75726365417353747265616d> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +187.68 280.836 Td +/F1.0 10.5 Tf +<206c6f6f6b757029206163636f7264696e6720746f2074686520666f6c6c6f77696e672072756c65733a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 253.056 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.8626 Tw + +BT +66.24 253.056 Td +/F1.0 10.5 Tf +<54686520736574206f6620617661696c61626c6520617370656374732069732074686520736574206f6620616c6c206465636c6172656420616e6420646566696e656420617370656374732028> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.8626 Tw + +BT +442.0158 253.056 Td +/F3.0 10.5 Tf +<617370656374> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.8626 Tw + +BT +473.5158 253.056 Td +/F1.0 10.5 Tf +<20616e6420> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.8626 Tw + +BT +499.79 253.056 Td +/F3.0 10.5 Tf +<636f6e63726574652d> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +66.24 237.276 Td +/F3.0 10.5 Tf +<617370656374> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +97.74 237.276 Td +/F1.0 10.5 Tf +<20656c656d656e7473206f662074686520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +179.745 237.276 Td +/F3.0 10.5 Tf +<61737065637473> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +216.495 237.276 Td +/F1.0 10.5 Tf +<2073656374696f6e292e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 215.496 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.3765 Tw + +BT +66.24 215.496 Td +/F1.0 10.5 Tf +[<54686520736574206f662061737065637473207573656420666f722077656176696e672069732074686520737562736574206f662074686520617661696c61626c652061737065637473207468617420617265206d6174636865642062> 20.0195 <79206174>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.7371 Tw + +BT +66.24 199.716 Td +/F1.0 10.5 Tf +[<6c65617374206f6e6520696e636c7564652073746174656d656e7420616e6420617265206e6f74206d6174636865642062> 20.0195 <7920616e> 20.0195 <79206578636c7564652073746174656d656e74732e20496620746865726520617265206e6f>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 183.936 Td +/F1.0 10.5 Tf +<696e636c7564652073746174656d656e7473207468656e20616c6c206e6f6e2d6578636c7564656420617370656374732061726520696e636c756465642e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 162.156 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1318 Tw + +BT +66.24 162.156 Td +/F1.0 10.5 Tf +[<54686520736574206f6620747970657320746f20626520776f76656e206172652074686f7365207479706573206d6174636865642062> 20.0195 <79206174206c65617374206f6e652077656176657220>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.1318 Tw + +BT +465.9507 162.156 Td +/F3.0 10.5 Tf +<696e636c756465> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1318 Tw + +BT +502.7007 162.156 Td +/F1.0 10.5 Tf +<20656c656d656e74> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6939 Tw + +BT +66.24 146.376 Td +/F1.0 10.5 Tf +[<616e64206e6f74206d6174636865642062> 20.0195 <7920616e> 20.0195 <792077656176657220>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.6939 Tw + +BT +239.4784 146.376 Td +/F3.0 10.5 Tf +<6578636c756465> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6939 Tw + +BT +276.2284 146.376 Td +/F1.0 10.5 Tf +<20656c656d656e742e20496620746865726520617265206e6f2077656176657220696e636c7564652073746174656d656e7473> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 130.596 Td +/F1.0 10.5 Tf +<7468656e20616c6c206e6f6e2d6578636c756465642074797065732061726520696e636c756465642e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 108.816 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.0715 Tw + +BT +66.24 108.816 Td +/F1.0 10.5 Tf +[<54686520776561766572206f7074696f6e732061726520646572697665642062> 20.0195 <792074616b696e672074686520756e696f6e206f6620746865206f7074696f6e732073706563696669656420696e2065616368206f6620746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6748 Tw + +BT +66.24 93.036 Td +/F1.0 10.5 Tf +[<776561766572206f7074696f6e73206174747269627574652073706563696669636174696f6e732e20576865726520616e206f7074696f6e2074616b> 20.0195 <657320612076616c756520652e672e20>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.6748 Tw + +BT +447.3789 93.036 Td +/F3.0 10.5 Tf +<2d7761726e3a6e6f6e65> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6748 Tw + +BT +499.8789 93.036 Td +/F1.0 10.5 Tf +<20746865206d6f7374> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 77.256 Td +/F1.0 10.5 Tf +<726563656e746c7920646566696e65642076616c75652077696c6c20626520757365642e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp1 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.978 14.263 Td +/F1.0 9 Tf +<3339> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +219 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 218 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F1.0 8 0 R +/F3.0 26 0 R +>> +/XObject << /Stamp1 360 0 R +>> +>> +/Annots [220 0 R 221 0 R] +>> +endobj +220 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (http://www.eclipse.org/aspectj/dtd/aspectj.dtd) +>> +/Subtype /Link +/Rect [48.24 775.83 220.5783 790.11] +/Type /Annot +>> +endobj +221 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (http://www.eclipse.org/aspectj/dtd/aspectj.dtd) +>> +/Subtype /Link +/Rect [220.5783 775.83 274.4643 790.11] +/Type /Annot +>> +endobj +222 0 obj +<< /Length 11931 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +1.2226 Tw + +BT +48.24 794.676 Td +/F1.0 10.5 Tf +<4974206973206e6f7420616e206572726f7220666f72207468652073616d652061737065637420746f20626520646566696e656420746f207468652077656176657220696e206d6f7265207468616e206f6e652076697369626c6520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.2226 Tw + +BT +520.79 794.676 Td +/F3.0 10.5 Tf +<4d4554412d> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.1967 Tw + +BT +48.24 778.896 Td +/F3.0 10.5 Tf +<494e462f616f702e786d6c> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1967 Tw + +BT +105.99 778.896 Td +/F1.0 10.5 Tf +<2066696c652e20486f77657665722c206966207468652073616d6520636f6e63726574652061737065637420697320646566696e656420696e206d6f7265207468616e206f6e6520616f702e786d6c2066696c65207468656e> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2552 Tw + +BT +48.24 763.116 Td +/F1.0 10.5 Tf +[<616e206572726f722077696c6c206265206973737565642e204120636f6e63726574652061737065637420646566696e656420696e2074686973207761> 20.0195 <792077696c6c206265207573656420746f207765617665207479706573206c6f616465642062> 20.0195 <79>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 747.336 Td +/F1.0 10.5 Tf +<74686520636c617373206c6f616465722074686174206c6f616465642074686520616f702e786d6c2066696c6520696e2077686963682069742077617320646566696e65642e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.5506 Tw + +BT +48.24 719.556 Td +/F1.0 10.5 Tf +<4120> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +2.5506 Tw + +BT +60.9126 719.556 Td +/F3.0 10.5 Tf +<4d4554412d494e462f616f702e786d6c> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.5506 Tw + +BT +144.9126 719.556 Td +/F1.0 10.5 Tf +[<2063616e2062652067656e6572> 20.0195 <617465642062> 20.0195 <79207573696e67206569746865722074686520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +2.5506 Tw + +BT +352.175 719.556 Td +/F3.0 10.5 Tf +<2d6f7574786d6c> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.5506 Tw + +BT +388.925 719.556 Td +/F1.0 10.5 Tf +<206f7220> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +2.5506 Tw + +BT +410.4692 719.556 Td +/F3.0 10.5 Tf +<2d6f7574786d6c66696c65> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.5506 Tw + +BT +468.2192 719.556 Td +/F1.0 10.5 Tf +<206f7074696f6e73206f6620746865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.9976 Tw + +BT +48.24 703.776 Td +/F1.0 10.5 Tf +<4173706563744a20636f6d70696c65722e2049742077696c6c2073696d706c7920636f6e7461696e20612028706f737369626c7920656d7074792920736574206f662061737065637420656c656d656e74733b206f6e6520666f722065616368> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.3427 Tw + +BT +48.24 687.996 Td +/F1.0 10.5 Tf +[<6162737472> 20.0195 <616374206f7220636f6e63726574652061737065637420646566696e65642e205768656e207573656420696e20636f6e6a756374696f6e20776974682074686520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +2.3427 Tw + +BT +425.6655 687.996 Td +/F3.0 10.5 Tf +<2d6f75746a6172> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.3427 Tw + +BT +462.4155 687.996 Td +/F1.0 10.5 Tf +<206f7074696f6e2061204a4152206973> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 672.216 Td +/F1.0 10.5 Tf +<70726f647563656420746861742063616e206265207573656420776974682074686520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +227.034 672.216 Td +/F3.0 10.5 Tf +<616a35> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +242.784 672.216 Td +/F1.0 10.5 Tf +<20636f6d6d616e64206f722061206c6f61642d74696d652077656176696e6720656e7669726f6e6d656e742e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 637.716 Td +/F2.0 13 Tf +<352e332e332e205573696e6720436f6e63726574652041737065637473> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.964 Tw + +BT +48.24 611.156 Td +/F1.0 10.5 Tf +[<497420697320706f737369626c6520746f206d616b> 20.0195 <6520616e206162737472> 20.0195 <6163742061737065637420636f6e63726574652062> 20.0195 <79206d65616e73206f662074686520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.964 Tw + +BT +401.0149 611.156 Td +/F3.0 10.5 Tf +<4d4554412d494e462f616f702e786d6c> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.964 Tw + +BT +485.0149 611.156 Td +/F1.0 10.5 Tf +<2066696c652e2054686973206973> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.3372 Tw + +BT +48.24 595.376 Td +/F1.0 10.5 Tf +[<75736566756c207761> 20.0195 <7920746f20696d706c656d656e74206162737472> 20.0195 <61637420706f696e7463757473206174206465706c6f> 20.0195 <796d656e742074696d652c20616e6420616c736f20676976657320636f6e74726f6c206f766572>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.4825 Tw + +BT +48.24 579.596 Td +/F1.0 10.5 Tf +<707265636564656e6365207468726f7567682074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +2.4825 Tw + +BT +177.5296 579.596 Td +/F3.0 10.5 Tf +<707265636564656e6365> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.4825 Tw + +BT +230.0296 579.596 Td +/F1.0 10.5 Tf +<20617474726962757465206f662074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +2.4825 Tw + +BT +320.7363 579.596 Td +/F3.0 10.5 Tf +<636f6e63726574652d617370656374> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.4825 Tw + +BT +399.4863 579.596 Td +/F1.0 10.5 Tf +<20584d4c20656c656d656e742e20436f6e736964657220746865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 563.816 Td +/F1.0 10.5 Tf +<666f6c6c6f77696e673a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 548.0 m +543.04 548.0 l +545.2491 548.0 547.04 546.2091 547.04 544.0 c +547.04 323.64 l +547.04 321.4309 545.2491 319.64 543.04 319.64 c +52.24 319.64 l +50.0309 319.64 48.24 321.4309 48.24 323.64 c +48.24 544.0 l +48.24 546.2091 50.0309 548.0 52.24 548.0 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 548.0 m +543.04 548.0 l +545.2491 548.0 547.04 546.2091 547.04 544.0 c +547.04 323.64 l +547.04 321.4309 545.2491 319.64 543.04 319.64 c +52.24 319.64 l +50.0309 319.64 48.24 321.4309 48.24 323.64 c +48.24 544.0 l +48.24 546.2091 50.0309 548.0 52.24 548.0 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 525.175 Td +/F3.0 11 Tf +<7061636b616765206d797061636b3b> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 495.695 Td +/F3.0 11 Tf +<40417370656374> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 480.955 Td +/F3.0 11 Tf +<7075626c696320616273747261637420636c617373204162737472616374417370656374207b> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 451.475 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 436.735 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 421.995 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 392.515 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 377.775 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 363.035 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 348.295 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 333.555 Td +/F3.0 11 Tf +<7d> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 295.676 Td +/F1.0 10.5 Tf +<5468697320617370656374206973206571756976616c656e7420746f2074686520666f6c6c6f77696e6720696e20636f6465207374796c653a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 279.86 m +543.04 279.86 l +545.2491 279.86 547.04 278.0691 547.04 275.86 c +547.04 99.72 l +547.04 97.5109 545.2491 95.72 543.04 95.72 c +52.24 95.72 l +50.0309 95.72 48.24 97.5109 48.24 99.72 c +48.24 275.86 l +48.24 278.0691 50.0309 279.86 52.24 279.86 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 279.86 m +543.04 279.86 l +545.2491 279.86 547.04 278.0691 547.04 275.86 c +547.04 99.72 l +547.04 97.5109 545.2491 95.72 543.04 95.72 c +52.24 95.72 l +50.0309 95.72 48.24 97.5109 48.24 99.72 c +48.24 275.86 l +48.24 278.0691 50.0309 279.86 52.24 279.86 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 257.035 Td +/F3.0 11 Tf +<7061636b616765206d797061636b3b> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 227.555 Td +/F3.0 11 Tf +<7075626c696320616273747261637420617370656374204162737472616374417370656374207b> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 198.075 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 183.335 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 153.855 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 139.115 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 124.375 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 109.635 Td +/F3.0 11 Tf +<7d> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6236 Tw + +BT +48.24 71.756 Td +/F1.0 10.5 Tf +<54686973206173706563742028696e20656974686572207374796c65292063616e206265206d61646520636f6e6372657465207573696e6720> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.6236 Tw + +BT +342.8519 71.756 Td +/F3.0 10.5 Tf +<4d4554412d494e462f616f702e786d6c> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6236 Tw + +BT +426.8519 71.756 Td +/F1.0 10.5 Tf +[<2e20497420646566696e657320746865206162737472> 20.0195 <616374>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 55.976 Td +/F1.0 10.5 Tf +<706f696e7463757420> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +92.7915 55.976 Td +/F3.0 10.5 Tf +<73636f70652829> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +129.5415 55.976 Td +/F1.0 10.5 Tf +<2e205768656e207573696e672074686973206d656368616e69736d2074686520666f6c6c6f77696e672072756c6573206170706c793a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp2 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +49.24 14.263 Td +/F1.0 9 Tf +<3430> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +223 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 222 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F1.0 8 0 R +/F3.0 26 0 R +/F2.0 22 0 R +>> +/XObject << /Stamp2 361 0 R +>> +>> +>> +endobj +224 0 obj +[223 0 R /XYZ 0 656.4 null] +endobj +225 0 obj +<< /Length 13746 +>> +stream +q + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +56.8805 793.926 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 793.926 Td +/F1.0 10.5 Tf +[<54686520706172656e7420617370656374206d757374206265206162737472> 20.0195 <6163742e2049742063616e20626520616e20404173706563744a206f72206120726567756c617220636f6465207374796c65206173706563742e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 772.146 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.7959 Tw + +BT +66.24 772.146 Td +/F1.0 10.5 Tf +[<4f6e6c7920612073696d706c65206162737472> 20.0195 <61637420706f696e746375742063616e20626520696d706c656d656e74656420692e652e206120706f696e74637574207468617420646f65736ed574206578706f7365207374617465>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6361 Tw + +BT +66.24 756.366 Td +/F1.0 10.5 Tf +<287468726f75676820> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.6361 Tw + +BT +113.5486 756.366 Td +/F3.0 10.5 Tf +<6172677328292c207468697328292c2074617267657428292c2069662829> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.6361 Tw + +BT +272.9567 756.366 Td +/F1.0 10.5 Tf +[<292e20496e20404173706563744a2073796e74617820617320696c6c75737472> 20.0195 <6174656420696e20746869732073616d706c652c2074686973>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.8941 Tw + +BT +66.24 740.586 Td +/F1.0 10.5 Tf +[<6d65616e7320746865206d6574686f64207468617420686f7374732074686520706f696e74637574206d757374206265206162737472> 20.0195 <6163742c2068617665206e6f20617267756d656e74732c20616e642072657475726e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 724.806 Td +/F1.0 10.5 Tf +<766f69642e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 703.026 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 703.026 Td +/F1.0 10.5 Tf +[<54686520636f6e637265746520617370656374206d75737420696d706c656d656e7420616c6c20696e68657269746564206162737472> 20.0195 <61637420706f696e74637574732e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 681.246 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.2197 Tw + +BT +66.24 681.246 Td +/F1.0 10.5 Tf +[<54686520636f6e637265746520617370656374206d61> 20.0195 <79206e6f7420696d706c656d656e74206d6574686f647320736f20746865206162737472> 20.0195 <6163742061737065637420697420657874656e6473206d61> 20.0195 <79206e6f74>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 665.466 Td +/F1.0 10.5 Tf +[<636f6e7461696e20616e> 20.0195 <79206162737472> 20.0195 <616374206d6574686f64732e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1088 Tw + +BT +48.24 637.686 Td +/F5.0 10.5 Tf +<41206c696d69746174696f6e206f662074686520696d706c656d656e746174696f6e206f662074686973206665617475726520696e204173706563744a20312e352e302069732074686174206173706563747320646566696e6564207573696e6720616f702e786d6c> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.2482 Tw + +BT +48.24 621.906 Td +/F5.0 10.5 Tf +[<617265206e6f74206578706f73656420746f20746865207765617665722e2054686973206d65616e732074686174207468657920617265206e6f742061666665637465642062> 20.0195 <792061647669636520616e64204954447320646566696e656420696e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 606.126 Td +/F5.0 10.5 Tf +<6f7468657220617370656374732e20537570706f727420666f722074686973206361706162696c6974792077696c6c20626520636f6e7369646572656420696e2061206675747572652072656c656173652e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5721 Tw + +BT +48.24 578.346 Td +/F1.0 10.5 Tf +<4966206d6f726520636f6d706c65782061737065637420696e6865726974616e63652069732072657175697265642075736520726567756c61722061737065637420696e6865726974616e636520696e7374656164206f6620584d4c2e20546865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 562.566 Td +/F1.0 10.5 Tf +[<666f6c6c6f77696e6720584d4c20646566696e6974696f6e2073686f777320612076616c696420636f6e6372657465207375622d61737065637420666f7220746865206162737472> 20.0195 <61637420617370656374732061626f76653a>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 546.75 m +543.04 546.75 l +545.2491 546.75 547.04 544.9591 547.04 542.75 c +547.04 410.83 l +547.04 408.6209 545.2491 406.83 543.04 406.83 c +52.24 406.83 l +50.0309 406.83 48.24 408.6209 48.24 410.83 c +48.24 542.75 l +48.24 544.9591 50.0309 546.75 52.24 546.75 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 546.75 m +543.04 546.75 l +545.2491 546.75 547.04 544.9591 547.04 542.75 c +547.04 410.83 l +547.04 408.6209 545.2491 406.83 543.04 406.83 c +52.24 406.83 l +50.0309 406.83 48.24 408.6209 48.24 410.83 c +48.24 542.75 l +48.24 544.9591 50.0309 546.75 52.24 546.75 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 523.925 Td +/F3.0 11 Tf +<3c6173706563746a3e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 509.185 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 494.445 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 479.705 Td +/F3.0 11 Tf +<657874656e64733d226d797061636b2e4162737472616374417370656374223e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 464.965 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 450.225 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 435.485 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 420.745 Td +/F3.0 11 Tf +<3c2f6173706563746a3e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2329 Tw + +BT +48.24 382.866 Td +/F1.0 10.5 Tf +<497420697320696d706f7274616e7420746f2072656d656d62657220746861742074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.2329 Tw + +BT +233.988 382.866 Td +/F3.0 10.5 Tf +<6e616d65> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2329 Tw + +BT +254.988 382.866 Td +/F1.0 10.5 Tf +<2061747472696275746520696e2074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.2329 Tw + +BT +336.8853 382.866 Td +/F3.0 10.5 Tf +<636f6e63726574652d617370656374> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2329 Tw + +BT +415.6353 382.866 Td +/F1.0 10.5 Tf +<2064697265637469766520646566696e6573207468652066756c6c79> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.565 Tw + +BT +48.24 367.086 Td +/F1.0 10.5 Tf +<7175616c6966696564206e616d6520746861742077696c6c20626520676976656e20746f2074686520636f6e6372657465206173706563742e204974206d75737420612076616c696420636c617373206e616d65206265636175736520746865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.4266 Tw + +BT +48.24 351.306 Td +/F1.0 10.5 Tf +[<6173706563742077696c6c2062652067656e6572> 20.0195 <61746564206f6e2074686520666c792062> 20.0195 <7920746865207765617665722e2059> 69.8242 <6f75206d75737420616c736f20656e73757265207468617420746865726520617265206e6f206e616d65>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.5716 Tw + +BT +48.24 335.526 Td +/F1.0 10.5 Tf +<636f6c6c6973696f6e732e204e6f746520746861742074686520636f6e6372657465206173706563742077696c6c20626520646566696e65642061742074686520636c6173736c6f61646572206c6576656c20666f7220776869636820746865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.4266 Tw + +BT +48.24 319.746 Td +/F1.0 10.5 Tf +<616f702e786d6c2069732076697369626c652e205468697320696d706c696573207468617420696620796f75206e65656420746f207573652074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.4266 Tw + +BT +352.5974 319.746 Td +/F3.0 10.5 Tf +<6173706563746f66> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.4266 Tw + +BT +394.5974 319.746 Td +/F1.0 10.5 Tf +<206d6574686f647320746f206163636573732074686520617370656374> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.5368 Tw + +BT +48.24 303.966 Td +/F1.0 10.5 Tf +<696e7374616e63652873292028646570656e64696e67206f6e2074686520706572636c61757365206f66207468652061737065637420697420657874656e64732920796f75206861766520746f20757365207468652068656c70657220415049> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +48.24 288.186 Td +/F3.0 10.5 Tf +<6f72672e6173706563746a2e6c616e672e417370656374732e6173706563744f66282e2e29> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +242.49 288.186 Td +/F1.0 10.5 Tf +<20617320696e3a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 272.37 m +543.04 272.37 l +545.2491 272.37 547.04 270.5791 547.04 268.37 c +547.04 180.67 l +547.04 178.4609 545.2491 176.67 543.04 176.67 c +52.24 176.67 l +50.0309 176.67 48.24 178.4609 48.24 180.67 c +48.24 268.37 l +48.24 270.5791 50.0309 272.37 52.24 272.37 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 272.37 m +543.04 272.37 l +545.2491 272.37 547.04 270.5791 547.04 268.37 c +547.04 180.67 l +547.04 178.4609 545.2491 176.67 543.04 176.67 c +52.24 176.67 l +50.0309 176.67 48.24 178.4609 48.24 180.67 c +48.24 268.37 l +48.24 270.5791 50.0309 272.37 52.24 272.37 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 249.545 Td +/F3.0 11 Tf +<2f2f20657863657074696f6e2068616e646c696e67206f6d6974746564> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 234.805 Td +/F3.0 11 Tf +<436c617373206d79436f6e6372657465417370656374436c617373203d20436c6173732e666f724e616d6528226d797061636b2e5f5f4d795f5f416273747261637441737065637422293b> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 205.325 Td +/F3.0 11 Tf +<2f2f206865726520776520617265207573696e6720612073696e676c65746f6e20617370656374> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 190.585 Td +/F3.0 11 Tf +<416273747261637441737065637420636f6e6372657465496e7374616e6365203d20417370656374732e6173706563744f66286d79436f6e6372657465417370656374436c617373293b> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 145.986 Td +/F2.0 13 Tf +<352e332e342e205573696e6720436f6e6372657465204173706563747320746f20646566696e6520707265636564656e6365> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.2135 Tw + +BT +48.24 119.426 Td +/F1.0 10.5 Tf +<41732064657363726962656420696e207468652070726576696f75732073656374696f6e2c2074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +2.2135 Tw + +BT +267.6133 119.426 Td +/F3.0 10.5 Tf +<636f6e63726574652d617370656374> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.2135 Tw + +BT +346.3633 119.426 Td +/F1.0 10.5 Tf +<20656c656d656e7420696e20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +2.2135 Tw + +BT +411.7724 119.426 Td +/F3.0 10.5 Tf +<4d4554412d494e462f616f702e786d6c> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.2135 Tw + +BT +495.7724 119.426 Td +/F1.0 10.5 Tf +<20676976657320746865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.1596 Tw + +BT +48.24 103.646 Td +/F1.0 10.5 Tf +<6f7074696f6e20746f206465636c6172652074686520707265636564656e63652c206a75737420617320> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +2.1596 Tw + +BT +266.3115 103.646 Td +/F3.0 10.5 Tf +<404465636c617265507265636564656e6365> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.1596 Tw + +BT +360.8115 103.646 Td +/F1.0 10.5 Tf +<206f7220> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +2.1596 Tw + +BT +381.5737 103.646 Td +/F3.0 10.5 Tf +<6465636c61726520707265636564656e6365> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.1596 Tw + +BT +478.2333 103.646 Td +/F1.0 10.5 Tf +<20646f20696e20617370656374> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 87.866 Td +/F1.0 10.5 Tf +<736f7572636520636f64652e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.2783 Tw + +BT +48.24 60.086 Td +/F1.0 10.5 Tf +[<536f6d6574696d6573206974206973206e656365737361727920746f206465636c61726520707265636564656e636520776974686f757420657874656e64696e6720616e> 20.0195 <79206162737472> 20.0195 <616374206173706563742e204974206973>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp1 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.978 14.263 Td +/F1.0 9 Tf +<3431> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +226 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 225 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F1.0 8 0 R +/F3.0 26 0 R +/F5.0 182 0 R +/F2.0 22 0 R +>> +/XObject << /Stamp1 360 0 R +>> +>> +>> +endobj +227 0 obj +[226 0 R /XYZ 0 164.67 null] +endobj +228 0 obj +<< /Length 15275 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +0.1 Tw + +BT +48.24 794.676 Td +/F1.0 10.5 Tf +<7468657265666f726520706f737369626c6520746f207573652074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.1 Tw + +BT +192.7264 794.676 Td +/F3.0 10.5 Tf +<636f6e63726574652d617370656374> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1 Tw + +BT +271.4764 794.676 Td +/F1.0 10.5 Tf +<20656c656d656e7420776974686f75742074686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.1 Tw + +BT +378.3673 794.676 Td +/F3.0 10.5 Tf +<657874656e6473> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1 Tw + +BT +415.1173 794.676 Td +/F1.0 10.5 Tf +[<2061747472696275746520616e6420776974686f757420616e> 20.0195 <79>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 778.896 Td +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +48.24 778.896 Td +/F3.0 10.5 Tf +<706f696e74637574> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +90.24 778.896 Td +/F1.0 10.5 Tf +<206e657374656420656c656d656e74732c206a757374206120> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +208.6905 778.896 Td +/F3.0 10.5 Tf +<707265636564656e6365> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +261.1905 778.896 Td +/F1.0 10.5 Tf +<206174747269627574652e20436f6e73696465722074686520666f6c6c6f77696e673a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 763.08 m +543.04 763.08 l +545.2491 763.08 547.04 761.2891 547.04 759.08 c +547.04 656.64 l +547.04 654.4309 545.2491 652.64 543.04 652.64 c +52.24 652.64 l +50.0309 652.64 48.24 654.4309 48.24 656.64 c +48.24 759.08 l +48.24 761.2891 50.0309 763.08 52.24 763.08 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 763.08 m +543.04 763.08 l +545.2491 763.08 547.04 761.2891 547.04 759.08 c +547.04 656.64 l +547.04 654.4309 545.2491 652.64 543.04 652.64 c +52.24 652.64 l +50.0309 652.64 48.24 654.4309 48.24 656.64 c +48.24 759.08 l +48.24 761.2891 50.0309 763.08 52.24 763.08 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 740.255 Td +/F3.0 11 Tf +<3c6173706563746a3e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 725.515 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 710.775 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 696.035 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 681.295 Td +/F3.0 11 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 666.555 Td +/F3.0 11 Tf +<3c2f6173706563746a3e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0265 Tw + +BT +48.24 628.676 Td +/F1.0 10.5 Tf +[<54686973206465706c6f> 20.0195 <796d656e742074696d6520646566696e6974696f6e73206973206f6e6c79206465636c6172696e67206120707265636564656e63652072756c652e2059> 69.8242 <6f75206861766520746f2072656d656d6265722074686174>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.9312 Tw + +BT +48.24 612.896 Td +/F1.0 10.5 Tf +<74686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.9312 Tw + +BT +68.8612 612.896 Td +/F3.0 10.5 Tf +<6e616d65> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.9312 Tw + +BT +89.8612 612.896 Td +/F1.0 10.5 Tf +<20617474726962757465206d75737420626520612076616c69642066756c6c79207175616c696669656420636c617373206e616d6520746861742077696c6c206265207468656e20726573657276656420666f722074686973> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 597.116 Td +/F1.0 10.5 Tf +[<636f6e63726574652d61737065637420616e64206d757374206e6f7420636f6e666c6963742077697468206f7468657220636c617373657320796f75206465706c6f> 20.0195 <79> 89.8438 <2e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 562.616 Td +/F2.0 13 Tf +[<352e332e352e2057> 60.0586 <6561766572204f7074696f6e73>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.474 Tw + +BT +48.24 536.056 Td +/F1.0 10.5 Tf +[<546865207461626c652062656c6f77206c6973747320746865204173706563744a206f7074696f6e7320737570706f727465642062> 20.0195 <79204c> 69.8242 <5457> 89.8438 <2e20416c6c206f74686572206f7074696f6e732077696c6c2062652069676e6f72656420616e642061>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 520.276 Td +/F1.0 10.5 Tf +<7761726e696e67206973737565642e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 482.68 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 482.68 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 366.22 249.4 116.46 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 366.22 249.4 116.46 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 265.54 249.4 100.68 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 265.54 249.4 100.68 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 196.42 249.4 69.12 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 196.42 249.4 69.12 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 143.08 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 143.08 249.4 53.34 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 105.52 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 105.52 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 83.74 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 83.74 249.4 21.78 re +f +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 504.46 m +297.64 504.46 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +48.24 482.68 m +297.64 482.68 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 504.71 m +48.24 482.055 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 504.71 m +297.64 482.055 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 489.496 Td +/F2.0 10.5 Tf +<4f7074696f6e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 504.46 m +547.04 504.46 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +297.64 482.68 m +547.04 482.68 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 504.71 m +297.64 482.055 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 504.71 m +547.04 482.055 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 489.496 Td +/F2.0 10.5 Tf +<507572706f7365> Tj +ET + +0.0 0.0 0.0 scn +1.25 w +0.8667 0.8667 0.8667 SCN +48.24 482.68 m +297.64 482.68 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 366.22 m +297.64 366.22 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 483.305 m +48.24 365.97 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 483.305 m +297.64 365.97 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +51.24 469.9 Td +/F3.0 10.5 Tf +<2d766572626f7365> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.0 0.0 0.0 scn +1.25 w +0.8667 0.8667 0.8667 SCN +297.64 482.68 m +547.04 482.68 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 366.22 m +547.04 366.22 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 483.305 m +297.64 365.97 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 483.305 m +547.04 365.97 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 467.716 Td +/F1.0 10.5 Tf +<497373756520696e666f726d6174696f6e616c206d657373616765732061626f7574207468652077656176696e67> Tj +ET + + +BT +300.64 451.936 Td +/F1.0 10.5 Tf +<70726f636573732e204d6573736167657320697373756564207768696c652074686520776561766572206973> Tj +ET + + +BT +300.64 436.156 Td +/F1.0 10.5 Tf +[<6265696e6720626f6f74737472> 20.0195 <61707065642061726520616363756d756c6174656420756e74696c20616c6c>] TJ +ET + + +BT +300.64 420.376 Td +/F1.0 10.5 Tf +<6f7074696f6e7320617265207061727365642e20496620746865206d6573736167657320617265207265717569726564> Tj +ET + + +BT +300.64 404.596 Td +/F1.0 10.5 Tf +<746f206265206f757470757420696d6d6564696174656c7920796f752063616e2075736520746865206f7074696f6e> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +300.64 388.816 Td +/F3.0 10.5 Tf +<2d44616a2e77656176696e672e766572626f73653d74727565> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +431.89 388.816 Td +/F1.0 10.5 Tf +<206f6e20746865204a564d2073746172747570> Tj +ET + + +BT +300.64 373.036 Td +/F1.0 10.5 Tf +<636f6d6d616e64206c696e652e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 366.22 m +297.64 366.22 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 265.54 m +297.64 265.54 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 366.47 m +48.24 265.29 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 366.47 m +297.64 265.29 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +51.24 353.44 Td +/F3.0 10.5 Tf +<2d6465627567> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 366.22 m +547.04 366.22 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 265.54 m +547.04 265.54 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 366.47 m +297.64 265.29 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 366.47 m +547.04 265.29 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 351.256 Td +/F1.0 10.5 Tf +<49737375652061206d6573736167657320666f72206561636820636c6173732070617373656420746f20746865> Tj +ET + + +BT +300.64 335.476 Td +/F1.0 10.5 Tf +<77656176657220696e6469636174696e6720776865746865722069742077617320776f76656e2c> Tj +ET + + +BT +300.64 319.696 Td +/F1.0 10.5 Tf +<6578636c75646564206f722069676e6f7265642e20416c736f206973737565206d6573736167657320666f72> Tj +ET + + +BT +300.64 303.916 Td +/F1.0 10.5 Tf +<636c617373657320646566696e656420647572696e67207468652077656176696e672070726f636573732073756368> Tj +ET + + +BT +300.64 288.136 Td +/F1.0 10.5 Tf +<61732061726f756e642061647669636520636c6f737572657320616e6420636f6e63726574652061737065637473> Tj +ET + + +BT +300.64 272.356 Td +/F1.0 10.5 Tf +<646566696e656420696e20> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +354.3055 272.356 Td +/F3.0 10.5 Tf +<4d4554412d494e462f616f702e786d6c> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +438.3055 272.356 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 265.54 m +297.64 265.54 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 196.42 m +297.64 196.42 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 265.79 m +48.24 196.17 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 265.79 m +297.64 196.17 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +51.24 252.76 Td +/F3.0 10.5 Tf +<2d73686f775765617665496e666f> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 265.54 m +547.04 265.54 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 196.42 m +547.04 196.42 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 265.79 m +297.64 196.17 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 265.79 m +547.04 196.17 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 250.576 Td +/F1.0 10.5 Tf +<497373756520696e666f726d6174696f6e616c206d65737361676573207768656e6576657220746865> Tj +ET + + +BT +300.64 234.796 Td +/F1.0 10.5 Tf +[<77656176657220746f7563686573206120636c6173732066696c652e2054686973206f7074696f6e206d61> 20.0195 <7920616c736f>] TJ +ET + + +BT +300.64 219.016 Td +/F1.0 10.5 Tf +[<626520656e61626c6564207573696e67207468652053> 20.0195 <797374656d2070726f7065727479>] TJ +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +300.64 203.236 Td +/F3.0 10.5 Tf +<2d446f72672e6173706563746a2e7765617665722e73686f775765617665496e666f3d74727565> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +505.39 203.236 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 196.42 m +297.64 196.42 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 143.08 m +297.64 143.08 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 196.67 m +48.24 142.83 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 196.67 m +297.64 142.83 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +51.24 183.64 Td +/F3.0 10.5 Tf +<2d586c696e7466696c653a70617468546f415265736f75726365> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 196.42 m +547.04 196.42 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 143.08 m +547.04 143.08 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 196.67 m +297.64 142.83 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 196.67 m +547.04 142.83 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 181.456 Td +/F1.0 10.5 Tf +<436f6e666967757265206c696e74206d657373616765732061732073706563696669656420696e2074686520676976656e> Tj +ET + + +BT +300.64 165.676 Td +/F1.0 10.5 Tf +<7265736f75726365202876697369626c652066726f6d207468697320616f702e786d6c2066696c6527> Tj +ET + + +BT +300.64 149.896 Td +/F1.0 10.5 Tf +<636c6173736c6f6164657229> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 143.08 m +297.64 143.08 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 105.52 m +297.64 105.52 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 143.33 m +48.24 105.27 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 143.33 m +297.64 105.27 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +51.24 130.3 Td +/F3.0 10.5 Tf +<2d586c696e743a64656661756c742c202d586c696e743a69676e6f72652c20c9> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 143.08 m +547.04 143.08 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 105.52 m +547.04 105.52 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 143.33 m +297.64 105.27 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 143.33 m +547.04 105.27 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 128.116 Td +/F1.0 10.5 Tf +<436f6e666967757265206c696e74206d657373616765732c20726566657220746f20646f63756d656e746174696f6e> Tj +ET + + +BT +300.64 112.336 Td +/F1.0 10.5 Tf +<666f72206d65616e696e6766756c6c2076616c756573> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 105.52 m +297.64 105.52 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 83.74 m +297.64 83.74 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 105.77 m +48.24 83.49 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 105.77 m +297.64 83.49 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +51.24 92.74 Td +/F3.0 10.5 Tf +<2d6e6f7761726e2c202d7761726e3a6e6f6e65> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 105.52 m +547.04 105.52 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 83.74 m +547.04 83.74 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 105.77 m +297.64 83.49 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 105.77 m +547.04 83.49 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 90.556 Td +/F1.0 10.5 Tf +<5375707072657373207761726e696e67206d65737361676573> Tj +ET + +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp2 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +49.24 14.263 Td +/F1.0 9 Tf +<3432> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +229 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 228 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F1.0 8 0 R +/F3.0 26 0 R +/F2.0 22 0 R +>> +/XObject << /Stamp2 361 0 R +>> +>> +>> +endobj +230 0 obj +[229 0 R /XYZ 0 581.3 null] +endobj +231 0 obj +<< /Length 12726 +>> +stream +q +/DeviceRGB cs +1.0 1.0 1.0 scn +48.24 784.11 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 784.11 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 746.55 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 746.55 249.4 37.56 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 724.77 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 724.77 249.4 21.78 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +48.24 529.41 249.4 195.36 re +f +0.0 0.0 0.0 scn +1.0 1.0 1.0 scn +297.64 529.41 249.4 195.36 re +f +0.0 0.0 0.0 scn +0.5 w +/DeviceRGB CS +0.8667 0.8667 0.8667 SCN +48.24 805.89 m +297.64 805.89 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +48.24 784.11 m +297.64 784.11 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 806.14 m +48.24 783.485 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 806.14 m +297.64 783.485 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +51.24 790.926 Td +/F2.0 10.5 Tf +<4f7074696f6e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 805.89 m +547.04 805.89 l +S +[] 0 d +1.25 w +0.8667 0.8667 0.8667 SCN +297.64 784.11 m +547.04 784.11 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 806.14 m +297.64 783.485 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 806.14 m +547.04 783.485 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 790.926 Td +/F2.0 10.5 Tf +<507572706f7365> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 784.11 m +297.64 784.11 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 746.55 m +297.64 746.55 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 784.36 m +48.24 746.3 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 784.36 m +297.64 746.3 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +51.24 771.33 Td +/F3.0 10.5 Tf +<2d5872657765617661626c65> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 784.11 m +547.04 784.11 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 746.55 m +547.04 746.55 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 784.36 m +297.64 746.3 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 784.36 m +547.04 746.3 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 769.146 Td +/F1.0 10.5 Tf +<50726f6475636520636c6173732066696c657320746861742063616e2073756273657175656e746c79206265> Tj +ET + + +BT +300.64 753.366 Td +/F1.0 10.5 Tf +<7265776f76656e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 746.55 m +297.64 746.55 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 724.77 m +297.64 724.77 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 746.8 m +48.24 724.52 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 746.8 m +297.64 724.52 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +51.24 733.77 Td +/F3.0 10.5 Tf +<2d586e6f496e6c696e65> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 746.55 m +547.04 746.55 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 724.77 m +547.04 724.77 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 746.8 m +297.64 724.52 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 746.8 m +547.04 724.52 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 731.586 Td +/F1.0 10.5 Tf +<446f6ed57420696e6c696e652061726f756e64206164766963652e> Tj +ET + +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 724.77 m +297.64 724.77 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 529.41 m +297.64 529.41 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +48.24 725.02 m +48.24 529.16 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 725.02 m +297.64 529.16 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +51.24 711.99 Td +/F3.0 10.5 Tf +<2d586d65737361676548616e646c6572436c6173733ac9> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn +0.0 0.0 0.0 scn +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 724.77 m +547.04 724.77 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 529.41 m +547.04 529.41 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +297.64 725.02 m +297.64 529.16 l +S +[] 0 d +0.5 w +0.8667 0.8667 0.8667 SCN +547.04 725.02 m +547.04 529.16 l +S +[] 0 d +1 w +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +300.64 709.806 Td +/F1.0 10.5 Tf +<50726f7669646520616c7465726e6174697665206f75747075742064657374696e6174696f6e20746f> Tj +ET + + +BT +300.64 694.026 Td +/F1.0 10.5 Tf +<7374646f75742f73746465727220666f7220616c6c20776561766572206d657373616765732e2054686520676976656e> Tj +ET + + +BT +300.64 678.246 Td +/F1.0 10.5 Tf +<76616c7565206d757374206265207468652066756c6c207175616c696669656420636c617373206e616d65206f662061> Tj +ET + + +BT +300.64 662.466 Td +/F1.0 10.5 Tf +<636c617373207468617420696d706c656d656e747320746865> Tj +ET + +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +300.64 646.686 Td +/F3.0 10.5 Tf +<6f72672e6173706563746a2e6272696467652e494d65737361676548616e646c6572> Tj +ET + +0.0 0.0 0.0 SCN +0.2 0.2 0.2 scn + +BT +479.14 646.686 Td +/F1.0 10.5 Tf +<20696e74657266616365> Tj +ET + + +BT +300.64 630.906 Td +/F1.0 10.5 Tf +<616e642069732076697369626c6520746f2074686520636c6173736c6f61646572207769746820776869636820746865> Tj +ET + + +BT +300.64 615.126 Td +/F1.0 10.5 Tf +<776561766572206265696e6720636f6e66696775726564206973206173736f6369617465642e204578657263697365> Tj +ET + + +BT +300.64 599.346 Td +/F1.0 10.5 Tf +<63617574696f6e207768656e207061636b6167696e67206120637573746f6d206d657373616765> Tj +ET + + +BT +300.64 583.566 Td +/F1.0 10.5 Tf +<68616e646c6572207769746820616e206170706c69636174696f6e207468617420697320746f20626520776f76656e2e> Tj +ET + + +BT +300.64 567.786 Td +/F1.0 10.5 Tf +<5468652068616e646c6572202861732077656c6c20617320636c6173736573206f6e207768696368206974> Tj +ET + + +BT +300.64 552.006 Td +/F1.0 10.5 Tf +[<646570656e6473292063616e6e6f7420697473656c6620626520776f76656e2062> 20.0195 <79207468652061737065637473>] TJ +ET + + +BT +300.64 536.226 Td +/F1.0 10.5 Tf +<7468617420617265206465636c6172656420746f207468652073616d65207765617665722e> Tj +ET + +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 493.386 Td +/F2.0 18 Tf +<352e342e205370656369616c206361736573> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.7375 Tw + +BT +48.24 465.366 Td +/F1.0 10.5 Tf +[<54686520666f6c6c6f77696e6720636c617373657320617265206e6f74206578706f73656420746f20746865204c> 69.8242 <545720696e6672> 20.0195 <61737472756374757265207265676172646c657373206f662074686520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.7375 Tw + +BT +477.735 465.366 Td +/F3.0 10.5 Tf +<616f702e786d6c> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.7375 Tw + +BT +514.485 465.366 Td +/F1.0 10.5 Tf +<2066696c65287329> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 449.586 Td +/F1.0 10.5 Tf +<757365643a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 421.806 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 421.806 Td +/F1.0 10.5 Tf +<416c6c20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +82.872 421.806 Td +/F3.0 10.5 Tf +<6f72672e6173706563746a2e2a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +151.122 421.806 Td +/F1.0 10.5 Tf +[<20636c61737365732028616e64207375627061636b6167657329202d2061732074686f736520617265206e65656465642062> 20.0195 <792074686520696e6672> 20.0195 <6173747275637475726520697473656c66>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 400.026 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 400.026 Td +/F1.0 10.5 Tf +<416c6c20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +82.872 400.026 Td +/F3.0 10.5 Tf +<6a6176612e20616e6420> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +135.372 400.026 Td +/F3.0 10.5 Tf +<6a617661782e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +166.872 400.026 Td +/F1.0 10.5 Tf +<20636c61737365732028616e64207375627061636b6167657329> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +-0.5 Tc + +0.0 Tc + +-0.5 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +56.8805 378.246 Td +/F1.0 10.5 Tf + Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn + +0.0 Tc +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +66.24 378.246 Td +/F1.0 10.5 Tf +<416c6c20> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +BT +82.872 378.246 Td +/F3.0 10.5 Tf +<73756e2e7265666c6563742e2a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +151.122 378.246 Td +/F1.0 10.5 Tf +<20636c6173736573202d2061732074686f736520617265204a444b20737065636966696320636c61737365732075736564207768656e207265666c6563746976652063616c6c73206f6363757273> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.4495 Tw + +BT +48.24 350.466 Td +/F1.0 10.5 Tf +<44657370697465207468657365207265737472696374696f6e732c20697420697320706572666563746c7920706f737369626c6520746f206d617463682063616c6c206a6f696e20706f696e747320666f722063616c6c7320746f207468657365207479706573> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.1117 Tw + +BT +48.24 334.686 Td +/F1.0 10.5 Tf +<70726f766964696e67207468652063616c6c696e6720636c617373206973206578706f73656420746f20746865207765617665722e205375627479706573206f66207468657365206578636c75646564207479706573207468617420617265> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 318.906 Td +/F1.0 10.5 Tf +[<6578706f73656420746f2074686520776561766572206d61> 20.0195 <79206f6620636f7572736520626520776f76656e2e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.0075 Tw + +BT +48.24 291.126 Td +/F1.0 10.5 Tf +[<4e6f746520746861742064796e616d69632070726f787920726570726573656e746174696f6e7320617265206578706f73656420746f20746865204c> 69.8242 <545720696e6672> 20.0195 <6173747275637475726520616e6420617265206e6f74>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 275.346 Td +/F1.0 10.5 Tf +<636f6e736964657265642061207370656369616c20636173652e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.3925 Tw + +BT +48.24 247.566 Td +/F1.0 10.5 Tf +<536f6d65206c696e74206f7074696f6e732062656861766520646966666572656e746c79207768656e207573656420756e646572206c6f61642d74696d652077656176696e672e2054686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.3925 Tw + +BT +457.79 247.566 Td +/F3.0 10.5 Tf +<6164766963654469644e6f744d61746368> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.3925 Tw + +BT +547.04 247.566 Td +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 231.786 Td +/F1.0 10.5 Tf +<776f6ed5742062652068616e646c65642061732061207761726e2028617320647572696e6720636f6d70696c652074696d65292062757420617320616e20696e666f206d6573736167652e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 191.946 Td +/F2.0 18 Tf +[<352e352e2052756e74696d6520526571756972656d656e747320666f72204c6f61642d74696d652057> 60.0586 <656176696e67>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4497 Tw + +BT +48.24 163.926 Td +/F1.0 10.5 Tf +[<54> 29.7852 <6f20757365204c> 69.8242 <54572074686520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.4497 Tw + +BT +129.2863 163.926 Td +/F3.0 10.5 Tf +<6173706563746a7765617665722e6a6172> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4497 Tw + +BT +218.5363 163.926 Td +/F1.0 10.5 Tf +[<206c696272> 20.0195 <617279206d75737420626520616464656420746f2074686520636c617373706174682e205468697320636f6e7461696e7320746865204173706563744a>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.9154 Tw + +BT +48.24 148.146 Td +/F1.0 10.5 Tf +[<352072756e74696d652c207765617665722c2077656176696e6720636c617373206c6f6164657220616e642077656176696e67206167656e74732e20497420616c736f20636f6e7461696e73207468652044> 20.0195 <544420666f722070617273696e67>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 132.366 Td +/F1.0 10.5 Tf +[<584d4c2077656176696e6720636f6e6669677572> 20.0195 <6174696f6e2066696c65732e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 92.526 Td +/F2.0 18 Tf +[<352e362e20537570706f727465642041> 20.0195 <67656e7473>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp1 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.978 14.263 Td +/F1.0 9 Tf +<3433> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +232 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 231 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F2.0 22 0 R +/F3.0 26 0 R +/F1.0 8 0 R +>> +/XObject << /Stamp1 360 0 R +>> +>> +>> +endobj +233 0 obj +[232 0 R /XYZ 0 517.41 null] +endobj +234 0 obj +<< /Limits [(compatibility) (versionCompatibility)] +/Names [(compatibility) 243 0 R (concrete-aspect) 224 0 R (concrete-aspect-precedence) 227 0 R (configuring-load-time-weaving-with-aopxml-files) 215 0 R (eclipse-aspectj) 23 0 R (example) 102 0 R (javaCompatibility) 245 0 R (jrockit) 240 0 R (ltw) 204 0 R (ltw-agents) 236 0 R (ltw-configuration) 210 0 R (ltw-introduction) 205 0 R (ltw-packaging) 235 0 R (ltw-rules) 207 0 R (ltw-specialcases) 233 0 R (runtimeCompatibility) 247 0 R (sourceCompatibility) 251 0 R (tools-intro) 21 0 R (upgrading) 253 0 R (versionCompatibility) 244 0 R] +>> +endobj +235 0 obj +[232 0 R /XYZ 0 215.97 null] +endobj +236 0 obj +[232 0 R /XYZ 0 116.55 null] +endobj +237 0 obj +<< /Length 2799 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +48.24 792.006 Td +/F2.0 13 Tf +<352e362e312e204a564d5449> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.0054 Tw + +BT +48.24 765.446 Td +/F1.0 10.5 Tf +[<5768656e207573696e67204a617661203520746865204a564d5449206167656e742063616e20626520757365642062> 20.0195 <79207374617274696e6720746865204a564d20776974682074686520666f6c6c6f77696e67206f7074696f6e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 749.666 Td +/F1.0 10.5 Tf +<286164617074206163636f7264696e6720746f20746865207061746820746f206173706563746a7765617665722e6a6172293a> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.9608 0.9608 0.9608 scn +52.24 733.85 m +543.04 733.85 l +545.2491 733.85 547.04 732.0591 547.04 729.85 c +547.04 701.11 l +547.04 698.9009 545.2491 697.11 543.04 697.11 c +52.24 697.11 l +50.0309 697.11 48.24 698.9009 48.24 701.11 c +48.24 729.85 l +48.24 732.0591 50.0309 733.85 52.24 733.85 c +h +f +0.8 0.8 0.8 SCN +0.75 w +52.24 733.85 m +543.04 733.85 l +545.2491 733.85 547.04 732.0591 547.04 729.85 c +547.04 701.11 l +547.04 698.9009 545.2491 697.11 543.04 697.11 c +52.24 697.11 l +50.0309 697.11 48.24 698.9009 48.24 701.11 c +48.24 729.85 l +48.24 732.0591 50.0309 733.85 52.24 733.85 c +h +S +Q +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +59.24 711.025 Td +/F3.0 11 Tf +<2d6a6176616167656e743a70617468746f2f6173706563746a7765617665722e6a6172> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 666.426 Td +/F2.0 13 Tf +<352e362e322e204a526f636b69742077697468204a61766120312e332f312e342028757365204a564d5449206f6e204a617661203529> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0302 Tw + +BT +48.24 639.866 Td +/F1.0 10.5 Tf +[<53696e6365204173706563744a20312e392e372c20746865206f62736f6c657465204f72> 20.0195 <61636c652f424541204a526f636b6974206167656e74206973206e6f206c6f6e6765722070617274206f66204173706563744a2e204a526f636b6974204a444b>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.9286 Tw + +BT +48.24 624.086 Td +/F1.0 10.5 Tf +[<6e6576657220737570706f72746564204a6176612076657273696f6e7320686967686572207468616e20312e362e205365766572> 20.0195 <616c204a526f636b6974204a564d20666561747572657320617265206e6f772070617274206f66>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 608.306 Td +/F1.0 10.5 Tf +[<486f7453706f7420616e6420746f6f6c73206c696b> 20.0195 <65204d697373696f6e20436f6e74726f6c20617661696c61626c6520666f72204f70656e4a444b20616e64204f72> 20.0195 <61636c65204a444b2e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp2 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +49.24 14.263 Td +/F1.0 9 Tf +<3434> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +238 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 237 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F2.0 22 0 R +/F1.0 8 0 R +/F3.0 26 0 R +>> +/XObject << /Stamp2 361 0 R +>> +>> +>> +endobj +239 0 obj +[238 0 R /XYZ 0 841.89 null] +endobj +240 0 obj +[238 0 R /XYZ 0 685.11 null] +endobj +241 0 obj +<< /Length 11703 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +BT +48.24 782.394 Td +/F2.0 22 Tf +<4368617074657220362e204173706563744a2076657273696f6e20636f6d7061746962696c697479> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 741.146 Td +/F2.0 18 Tf +[<362e312e2056> 60.0586 <657273696f6e20436f6d7061746962696c697479>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0189 Tw + +BT +48.24 713.126 Td +/F1.0 10.5 Tf +[<53> 20.0195 <797374656d732c20636f64652c20616e64206275696c6420746f6f6c73206368616e6765206f7665722074696d652c206f6674656e206e6f7420696e20737465702e2047656e6572> 20.0195 <616c6c79> 89.8438 <2c206c617465722076657273696f6e73206f6620746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.1208 Tw + +BT +48.24 697.346 Td +/F1.0 10.5 Tf +<6275696c6420746f6f6c7320756e6465727374616e64206561726c6965722076657273696f6e73206f662074686520636f64652c206275742073797374656d732073686f756c6420696e636c7564652076657273696f6e73206f6620746865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 681.566 Td +/F1.0 10.5 Tf +[<72756e74696d65207573656420746f206275696c6420746865204173706563744a2070726f6772> 20.0195 <616d2e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 647.066 Td +/F2.0 13 Tf +<362e312e312e204a61766120636f6d7061746962696c697479> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.7395 Tw + +BT +48.24 620.506 Td +/F1.0 10.5 Tf +[<4173706563744a2070726f6772> 20.0195 <616d732063616e2072756e206f6e20616e> 20.0195 <79204a61766120564d206f66207468652072657175697265642076657273696f6e2e20546865204173706563744a20746f6f6c732070726f64756365204a617661>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0032 Tw + +BT +48.24 604.726 Td +/F1.0 10.5 Tf +[<62> 20.0195 <797465636f6465202e636c6173732066696c657320746861742072756e206f6e204a61766120636f6d70617469626c6520564dd5732e2049662061204a61766120636c617373206973206368616e6765642062> 20.0195 <7920616e206173706563742c20746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6128 Tw + +BT +48.24 588.946 Td +/F1.0 10.5 Tf +<726573756c74696e6720636c6173732069732062696e61727920636f6d70617469626c652028617320646566696e656420696e20746865204a617661204c616e67756167652053706563696669636174696f6e292e20467572746865722c20746865> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4009 Tw + +BT +48.24 573.166 Td +/F1.0 10.5 Tf +[<4173706563744a20636f6d70696c657220616e642077656176696e6720646f20616c6c2074686520657863657074696f6e20636865636b696e67207265717569726564206f66204a61766120636f6d70696c6572732062> 20.0195 <7920746865204a617661>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 557.386 Td +/F1.0 10.5 Tf +<73706563696669636174696f6e732e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.3414 Tw + +BT +48.24 529.606 Td +/F1.0 10.5 Tf +[<4c696b> 20.0195 <65206f74686572204a61766120636f6d70696c6572732c20746865204173706563744a20636f6d70696c65722063616e2074617267657420706172746963756c6172204a6176612076657273696f6e732e204f6276696f75736c79> 89.8438 <2c20636f6465>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5902 Tw + +BT +48.24 513.826 Td +/F1.0 10.5 Tf +<7461726765746564206174206f6e652076657273696f6e2063616e6e6f742062652072756e20696e206120564d206f662061206c65737365722076657273696f6e2e2054686520> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +0.5902 Tw + +BT +406.4069 513.826 Td +/F3.0 10.5 Tf +<6173706563746a72742e6a6172> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5902 Tw + +BT +474.6569 513.826 Td +/F1.0 10.5 Tf +<2069732064657369676e656420746f> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4083 Tw + +BT +48.24 498.046 Td +/F1.0 10.5 Tf +[<74616b> 20.0195 <6520616476616e74616765206f6620666561747572657320617661696c61626c6520696e204a6176612032206f72204a61766120352c206275742077696c6c2072756e20696e2061204a444b20312e312e7820656e7669726f6e6d656e742c20736f>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4461 Tw + +BT +48.24 482.266 Td +/F1.0 10.5 Tf +[<796f752063616e20757365204173706563744a20746f20746172676574206f6c646572206f7220726573747269637465642076657273696f6e73206f66204a6176612e20486f77657665722c207468657265206d61> 20.0195 <792062652072657374726963746564>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.3632 Tw + +BT +48.24 466.486 Td +/F1.0 10.5 Tf +[<76617269616e7473206f66204a444b20312e312e78207468617420646f206e6f74206861766520415049d57320757365642062> 20.0195 <7920746865204173706563744a2072756e74696d652e20496620796f75206465706c6f> 20.0195 <7920746f206f6e65206f66>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1181 Tw + +BT +48.24 450.706 Td +/F1.0 10.5 Tf +<74686f73652c20796f752063616e20656d61696c20> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +1.1181 Tw + +BT +157.4918 450.706 Td +/F1.0 10.5 Tf +<6173706563746a2d6465764065636c697073652e6f7267> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1181 Tw + +BT +276.6878 450.706 Td +/F1.0 10.5 Tf +<206f7220646f776e6c6f6164207468652072756e74696d6520636f646520746f206d6f6469667920697420666f7220796f7572> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 434.926 Td +/F1.0 10.5 Tf +<656e7669726f6e6d656e742e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.3008 Tw + +BT +48.24 407.146 Td +/F1.0 10.5 Tf +<41736964652066726f6d207468652072756e74696d652c2072756e6e696e6720746865204173706563744a20746f6f6c73207468656d73656c7665732077696c6c20726571756972652061206d6f726520726563656e742076657273696f6e206f66> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 391.366 Td +/F1.0 10.5 Tf +[<4a6176612e2059> 69.8242 <6f75206d6967687420757365204a617661203520746f2072756e20746865204173706563744a20636f6d70696c657220746f2070726f6475636520636f646520666f72204a61766120312e312e382e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 356.866 Td +/F2.0 13 Tf +[<362e312e322e2052756e74696d65206c696272> 20.0195 <61727920636f6d7061746962696c697479>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.5595 Tw + +BT +48.24 330.306 Td +/F1.0 10.5 Tf +[<5768656e206465706c6f> 20.0195 <79696e67204173706563744a2070726f6772> 20.0195 <616d732c20696e636c756465206f6e2074686520636c617373706174682074686520636c61737365732c20617370656374732c20616e6420746865204173706563744a>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.5902 Tw + +BT +48.24 314.526 Td +/F1.0 10.5 Tf +[<72756e74696d65206c696272> 20.0195 <6172792028>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +1.5902 Tw + +BT +135.9873 314.526 Td +/F3.0 10.5 Tf +<6173706563746a72742e6a6172> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.5902 Tw + +BT +204.2373 314.526 Td +/F1.0 10.5 Tf +<292e20557365207468652076657273696f6e206f66207468652072756e74696d6520746861742063616d6520776974682074686520746f6f6c73207573656420746f> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.0864 Tw + +BT +48.24 298.746 Td +/F1.0 10.5 Tf +[<6275696c64207468652070726f6772> 20.0195 <616d2e204966207468652072756e74696d65206973206561726c696572207468616e20746865206275696c6420746f6f6c7320757365642c206974d5732076657279206c696b> 20.0195 <656c7920746f206661696c2e20496620746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 282.966 Td +/F1.0 10.5 Tf +[<72756e74696d65206973206c61746572207468616e20746865206275696c6420746f6f6c7320757365642c206974d57320706f737369626c652028627574206e6f742067756172> 20.0195 <616e746565642920746861742069742077696c6c20776f726b2e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.6473 Tw + +BT +48.24 255.186 Td +/F1.0 10.5 Tf +[<476976656e20746861742c207468726565207363656e6172696f732063617573652070726f626c656d732e2046697273742c20796f75206465706c6f> 20.0195 <79206e6577206173706563747320696e746f20616e20616e206578697374696e67>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.7946 Tw + +BT +48.24 239.406 Td +/F1.0 10.5 Tf +<73797374656d207468617420616c726561647920686173206173706563747320746861742077657265206275696c742077697468206120646966666572656e742076657273696f6e2e205365636f6e642c207468652072756e74696d65206973> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.4584 Tw + +BT +48.24 223.626 Td +/F1.0 10.5 Tf +[<616c7265616479206465706c6f> 20.0195 <79656420696e20796f75722073797374656d20616e642063616e6e6f74206265206368616e6765642028652e672e2c20736f6d65206170706c69636174696f6e207365727665727320707574>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +3.8313 Tw + +BT +48.24 207.846 Td +/F3.0 10.5 Tf +<6173706563746a72742e6a6172> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +3.8313 Tw + +BT +116.49 207.846 Td +/F1.0 10.5 Tf +[<206f6e2074686520626f6f74636c61737370617468292e2054686972642c20796f752028756e696e74656e74696f6e616c6c7929206465706c6f> 20.0195 <792074776f2076657273696f6e73206f6620746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 192.066 Td +/F1.0 10.5 Tf +[<72756e74696d652c20616e6420746865206f6e65206c6f616465642062> 20.0195 <79206120706172656e74206c6f616465722069732075736564292e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.7372 Tw + +BT +48.24 164.286 Td +/F1.0 10.5 Tf +[<496e206561726c6965722076657273696f6e73206f66204173706563744a2c2074686573652070726f626c656d732070726573656e7420696e206f627363757265207761> 20.0195 <79732028652e672e2c20756e61626c6520746f207265736f6c76652061>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.0856 Tw + +BT +48.24 148.506 Td +/F1.0 10.5 Tf +[<636c617373292e20496e206c617465722076657273696f6e732c206120737461636b207472> 20.0195 <616365206d69676874206576656e20737065636966792074686174207468652072756e74696d652076657273696f6e206973206f7574206f662073796e632077697468>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.929 Tw + +BT +48.24 132.726 Td +/F1.0 10.5 Tf +[<616e206173706563742e2054> 29.7852 <6f2066696e64206f7574206966207468652072756e74696d6520796f75206465706c6f> 20.0195 <79656420697320746865206f6e652061637475616c6c79206265696e6720757365642c206c6f672074686520646566696e696e67>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 116.946 Td +/F1.0 10.5 Tf +<636c617373206c6f6164657220666f7220746865206173706563747320616e642072756e74696d652e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 82.446 Td +/F2.0 13 Tf +<362e312e332e204173706563742062696e61727920636f6d7061746962696c697479> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1004 Tw + +BT +48.24 55.886 Td +/F1.0 10.5 Tf +[<47656e6572> 20.0195 <616c6c79> 89.8438 <2c2062696e61727920617370656374732063616e20626520726561642062> 20.0195 <79206c617465722076657273696f6e73206f6620746865207765617665722069662074686520617370656374732077657265206275696c742062> 20.0195 <79>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp1 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +535.978 14.263 Td +/F1.0 9 Tf +<3435> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +242 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 241 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F2.0 22 0 R +/F1.0 8 0 R +/F3.0 26 0 R +>> +/XObject << /Stamp1 360 0 R +>> +>> +/Annots [246 0 R] +>> +endobj +243 0 obj +[242 0 R /XYZ 0 841.89 null] +endobj +244 0 obj +[242 0 R /XYZ 0 765.17 null] +endobj +245 0 obj +[242 0 R /XYZ 0 665.75 null] +endobj +246 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (mailto:aspectj-dev@eclipse.org) +>> +/Subtype /Link +/Rect [157.4918 447.64 276.6878 461.92] +/Type /Annot +>> +endobj +247 0 obj +[242 0 R /XYZ 0 375.55 null] +endobj +248 0 obj +[242 0 R /XYZ 0 101.13 null] +endobj +249 0 obj +<< /Length 9149 +>> +stream +q +/DeviceRGB cs +0.2 0.2 0.2 scn +/DeviceRGB CS +0.2 0.2 0.2 SCN + +1.3401 Tw + +BT +48.24 794.676 Td +/F1.0 10.5 Tf +<76657273696f6e20312e322e31206f72206c617465722e2028536f6d65206675747572652077656176657273206d69676874206861766520646f63756d656e746564206c696d69746174696f6e7320696e20686f7720666172206261636b> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.3432 Tw + +BT +48.24 778.896 Td +/F1.0 10.5 Tf +[<7468657920676f2e29204966206120706f73742d312e322e312077656176657220726561647320616e20617370656374206275696c742062> 20.0195 <792061206c617465722076657273696f6e2c2069742077696c6c20656d69742061206d6573736167652e20496620746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5591 Tw + +BT +48.24 763.116 Td +/F1.0 10.5 Tf +[<77656176657220726561647320696e20612062696e6172792061737065637420616e6420777269746573206974206f757420616761696e2c2074686520726573756c742077696c6c20626520696e2074686520666f726d2070726f64756365642062> 20.0195 <79>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 747.336 Td +/F1.0 10.5 Tf +[<74686174207765617665722c206e6f7420746865206f726967696e616c20666f726d206f66207468652061737065637420286a757374206c696b> 20.0195 <65206f7468657220776561766572206f7574707574292e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +4.0585 Tw + +BT +48.24 719.556 Td +/F1.0 10.5 Tf +[<5769746820756e72656c6561736564206f7220646576656c6f706d656e742076657273696f6e73206f662074686520746f6f6c732c20746865726520617265206e6f2067756172> 20.0195 <616e7465657320666f722062696e617279>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.4666 Tw + +BT +48.24 703.776 Td +/F1.0 10.5 Tf +[<636f6d7061746962696c697479> 89.8438 <2c20756e6c6573732074686579206172652073746174656420696e207468652072656c65617365206e6f7465732e20496620796f75207573652061737065637473206275696c74207769746820646576656c6f706d656e74>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 687.996 Td +/F1.0 10.5 Tf +[<76657273696f6e73206f6620746865207765617665722c206265206361726566756c20746f2072656275696c6420616e642072656465706c6f> 20.0195 <79207769746820746865206e6578742072656c65617365642076657273696f6e2e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 653.496 Td +/F2.0 13 Tf +<362e312e342e2041737065637420736f7572636520636f6d7061746962696c697479> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.7208 Tw + +BT +48.24 626.936 Td +/F1.0 10.5 Tf +[<47656e6572> 20.0195 <616c6c79> 89.8438 <2c204173706563744a20736f757263652066696c65732063616e20626520726561642062> 20.0195 <79206c617465722076657273696f6e73206f662074686520636f6d70696c65722e204c616e677561676520666561747572657320646f>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.3067 Tw + +BT +48.24 611.156 Td +/F1.0 10.5 Tf +[<6e6f74206368616e676520696e20646f742072656c65617365732028652e672e2c2066726f6d20312e322e3120746f20312e322e32292e20496e20736f6d6520766572792072> 20.0195 <6172652063617365732c2061206c616e677561676520666561747572652077696c6c>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.0038 Tw + +BT +48.24 595.376 Td +/F1.0 10.5 Tf +[<6e6f206c6f6e67657220626520737570706f72746564206f72206d61> 20.0195 <79206368616e676520697473206d65616e696e673b2074686573652063617365732061726520646f63756d656e74656420696e207468652072656c65617365206e6f746573>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.5885 Tw + +BT +48.24 579.596 Td +/F1.0 10.5 Tf +[<666f7220746861742076657273696f6e2e20536f6d65206368616e676573206c696b> 20.0195 <6520746869732077657265206e6563657373617279207768656e206d6f76696e6720746f2062696e6172792077656176696e6720696e2074686520312e31>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.7007 Tw + +BT +48.24 563.816 Td +/F1.0 10.5 Tf +[<72656c656173652c2062757420617420746869732074696d6520776520646f6ed57420616e7469636970617465206d6f726520696e20746865206675747572652e2059> 69.8242 <6f75206d6967687420616c736f2066696e64207468617420746865>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.7534 Tw + +BT +48.24 548.036 Td +/F1.0 10.5 Tf +[<70726f6772> 20.0195 <616d206265686176657320646966666572656e746c7920696620796f752072656c696564206f6e206265686176696f7220737065636966696320746f207468617420636f6d70696c65722f7765617665722c20627574207768696368>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 532.256 Td +/F1.0 10.5 Tf +<6973206e6f742073706563696669656420696e2074686520> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2588 0.5451 0.7922 scn +0.2588 0.5451 0.7922 SCN + +BT +157.125 532.256 Td +/F1.0 10.5 Tf +[<53656d616e7469637320617070656e64697820746f207468652050726f6772> 20.0195 <616d6d696e67204775696465>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +393.0913 532.256 Td +/F1.0 10.5 Tf +<2e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 497.756 Td +/F2.0 13 Tf +[<362e312e352e2050726f626c656d73207768656e2075706772> 20.0195 <6164696e6720746f206e6577204173706563744a2076657273696f6e73>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.1305 Tw + +BT +48.24 471.196 Td +/F1.0 10.5 Tf +[<4c6574d573207361> 20.0195 <7920796f75722070726f6772> 20.0195 <616d206265686176657320646966666572656e746c79206166746572206265696e67206275696c7420776974682061206e65772076657273696f6e206f6620746865204173706563744a20746f6f6c732e>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2303 Tw + +BT +48.24 455.416 Td +/F1.0 10.5 Tf +[<497420636f756c6420626520612062756720746861742077617320696e74726f64756365642062> 20.0195 <792074686520746f6f6c732c20627574206f6674656e20697420726573756c74732066726f6d2072656c79696e67206f6e206265686176696f722074686174>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.6701 Tw + +BT +48.24 439.636 Td +/F1.0 10.5 Tf +[<776173206e6f742067756172> 20.0195 <616e746565642062> 20.0195 <792074686520636f6d70696c65722e2046> 40.0391 <6f72206578616d706c652c20746865206f72646572206f6620616476696365206163726f73732074776f2061737065637473206973206e6f74>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2535 Tw + +BT +48.24 423.856 Td +/F1.0 10.5 Tf +[<67756172> 20.0195 <616e7465656420756e6c657373207468657265206973206120707265636564656e63652072656c6174696f6e73686970206265747765656e2074686520617370656374732e204966207468652070726f6772> 20.0195 <616d20696d706c696369746c79>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.615 Tw + +BT +48.24 408.076 Td +/F1.0 10.5 Tf +<72656c696573206f6e2061206365727461696e206f726465722074686174206f627461696e7320696e206f6e6520636f6d70696c65722c2069742063616e206661696c207768656e206275696c742077697468206120646966666572656e74> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 392.296 Td +/F1.0 10.5 Tf +<636f6d70696c65722e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.1006 Tw + +BT +48.24 364.516 Td +/F1.0 10.5 Tf +[<416e6f74686572207472> 20.0195 <6170206973206465706c6f> 20.0195 <79696e6720696e746f207468652073616d652073797374656d2c207768656e2074686520>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.6941 0.1294 0.2745 scn +0.6941 0.1294 0.2745 SCN + +2.1006 Tw + +BT +359.0456 364.516 Td +/F3.0 10.5 Tf +<6173706563746a72742e6a6172> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +2.1006 Tw + +BT +427.2956 364.516 Td +/F1.0 10.5 Tf +<20686173206e6f74206265656e206368616e676564> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 348.736 Td +/F1.0 10.5 Tf +[<6163636f7264696e676c79> 89.8438 <2e>] TJ +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.2406 Tw + +BT +48.24 320.956 Td +/F1.0 10.5 Tf +[<46696e616c6c79> 89.8438 <2c207768656e207570646174696e6720746f20612076657273696f6e207468617420686173206e6577206c616e67756167652066656174757265732c20746865726520697320612074656d70746174696f6e20746f206368616e6765>] TJ +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +1.1081 Tw + +BT +48.24 305.176 Td +/F1.0 10.5 Tf +<626f74682074686520636f646520616e642074686520746f6f6c73206174207468652073616d652074696d652e204974d573206265737420746f2076616c696461746520746865206f6c6420636f6465207769746820746865206e657720746f6f6c73> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +0.0058 Tw + +BT +48.24 289.396 Td +/F1.0 10.5 Tf +<6265666f7265207570646174696e672074686520636f646520746f20757365206e65772066656174757265732e20546861742064697374696e677569736865732070726f626c656d73206f66206e657720656e67696e656572696e672066726f6d> Tj +ET + + +0.0 Tw +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +48.24 273.616 Td +/F1.0 10.5 Tf +<74686f7365206f66206e65772073656d616e746963732e> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +q +0.0 0.0 0.0 scn +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +/Stamp2 Do +0.2 0.2 0.2 scn +0.2 0.2 0.2 SCN + +BT +49.24 14.263 Td +/F1.0 9 Tf +<3436> Tj +ET + +0.0 0.0 0.0 SCN +0.0 0.0 0.0 scn +Q +Q + +endstream +endobj +250 0 obj +<< /Type /Page +/Parent 3 0 R +/MediaBox [0 0 595.28 841.89] +/CropBox [0 0 595.28 841.89] +/BleedBox [0 0 595.28 841.89] +/TrimBox [0 0 595.28 841.89] +/ArtBox [0 0 595.28 841.89] +/Contents 249 0 R +/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI] +/Font << /F1.0 8 0 R +/F2.0 22 0 R +/F3.0 26 0 R +>> +/XObject << /Stamp2 361 0 R +>> +>> +/Annots [252 0 R] +>> +endobj +251 0 obj +[250 0 R /XYZ 0 672.18 null] +endobj +252 0 obj +<< /Border [0 0 0] +/A << /Type /Action +/S /URI +/URI (../progguide/semantics.html) +>> +/Subtype /Link +/Rect [157.125 529.19 393.0913 543.47] +/Type /Annot +>> +endobj +253 0 obj +[250 0 R /XYZ 0 516.44 null] +endobj +254 0 obj +<< /Border [0 0 0] +/Dest (tools-intro) +/Subtype /Link +/Rect [48.24 748.79 220.1145 763.07] +/Type /Annot +>> +endobj +255 0 obj +<< /Border [0 0 0] +/Dest (tools-intro) +/Subtype /Link +/Rect [541.1705 748.79 547.04 763.07] +/Type /Annot +>> +endobj +256 0 obj +<< /Border [0 0 0] +/Dest (eclipse-aspectj) +/Subtype /Link +/Rect [60.24 730.31 259.047 744.59] +/Type /Annot +>> +endobj +257 0 obj +<< /Border [0 0 0] +/Dest (eclipse-aspectj) +/Subtype /Link +/Rect [541.1705 730.31 547.04 744.59] +/Type /Annot +>> +endobj +258 0 obj +<< /Border [0 0 0] +/Dest (bytecode-concepts) +/Subtype /Link +/Rect [60.24 711.83 400.0828 726.11] +/Type /Annot +>> +endobj +259 0 obj +<< /Border [0 0 0] +/Dest (bytecode-concepts) +/Subtype /Link +/Rect [541.1705 711.83 547.04 726.11] +/Type /Annot +>> +endobj +260 0 obj +<< /Border [0 0 0] +/Dest (_name) +/Subtype /Link +/Rect [60.24 693.35 109.3905 707.63] +/Type /Annot +>> +endobj +261 0 obj +<< /Border [0 0 0] +/Dest (_name) +/Subtype /Link +/Rect [541.1705 693.35 547.04 707.63] +/Type /Annot +>> +endobj +262 0 obj +<< /Border [0 0 0] +/Dest (_synopsis) +/Subtype /Link +/Rect [60.24 674.87 123.4498 689.15] +/Type /Annot +>> +endobj +263 0 obj +<< /Border [0 0 0] +/Dest (_synopsis) +/Subtype /Link +/Rect [541.1705 674.87 547.04 689.15] +/Type /Annot +>> +endobj +264 0 obj +<< /Border [0 0 0] +/Dest (ajc) +/Subtype /Link +/Rect [60.24 656.39 137.709 670.67] +/Type /Annot +>> +endobj +265 0 obj +<< /Border [0 0 0] +/Dest (ajc) +/Subtype /Link +/Rect [541.1705 656.39 547.04 670.67] +/Type /Annot +>> +endobj +266 0 obj +<< /Border [0 0 0] +/Dest (_name_2) +/Subtype /Link +/Rect [60.24 637.91 109.3905 652.19] +/Type /Annot +>> +endobj +267 0 obj +<< /Border [0 0 0] +/Dest (_name_2) +/Subtype /Link +/Rect [535.301 637.91 547.04 652.19] +/Type /Annot +>> +endobj +268 0 obj +<< /Border [0 0 0] +/Dest (_synopsis_2) +/Subtype /Link +/Rect [60.24 619.43 123.4498 633.71] +/Type /Annot +>> +endobj +269 0 obj +<< /Border [0 0 0] +/Dest (_synopsis_2) +/Subtype /Link +/Rect [535.301 619.43 547.04 633.71] +/Type /Annot +>> +endobj +270 0 obj +<< /Border [0 0 0] +/Dest (_description) +/Subtype /Link +/Rect [60.24 600.95 137.709 615.23] +/Type /Annot +>> +endobj +271 0 obj +<< /Border [0 0 0] +/Dest (_description) +/Subtype /Link +/Rect [535.301 600.95 547.04 615.23] +/Type /Annot +>> +endobj +272 0 obj +<< /Border [0 0 0] +/Dest (_examples_2) +/Subtype /Link +/Rect [60.24 582.47 128.4165 596.75] +/Type /Annot +>> +endobj +273 0 obj +<< /Border [0 0 0] +/Dest (_examples_2) +/Subtype /Link +/Rect [535.301 582.47 547.04 596.75] +/Type /Annot +>> +endobj +274 0 obj +<< /Border [0 0 0] +/Dest (aj) +/Subtype /Link +/Rect [48.24 563.99 117.2145 578.27] +/Type /Annot +>> +endobj +275 0 obj +<< /Border [0 0 0] +/Dest (aj) +/Subtype /Link +/Rect [535.301 563.99 547.04 578.27] +/Type /Annot +>> +endobj +276 0 obj +<< /Border [0 0 0] +/Dest (_examples_3) +/Subtype /Link +/Rect [60.24 545.51 128.4165 559.79] +/Type /Annot +>> +endobj +277 0 obj +<< /Border [0 0 0] +/Dest (_examples_3) +/Subtype /Link +/Rect [535.301 545.51 547.04 559.79] +/Type /Annot +>> +endobj +278 0 obj +<< /Border [0 0 0] +/Dest (ajbrowser) +/Subtype /Link +/Rect [48.24 527.03 141.165 541.31] +/Type /Annot +>> +endobj +279 0 obj +<< /Border [0 0 0] +/Dest (ajbrowser) +/Subtype /Link +/Rect [535.301 527.03 547.04 541.31] +/Type /Annot +>> +endobj +280 0 obj +<< /Border [0 0 0] +/Dest (ajbrowser-intro) +/Subtype /Link +/Rect [60.24 508.55 143.4105 522.83] +/Type /Annot +>> +endobj +281 0 obj +<< /Border [0 0 0] +/Dest (ajbrowser-intro) +/Subtype /Link +/Rect [535.301 508.55 547.04 522.83] +/Type /Annot +>> +endobj +282 0 obj +<< /Border [0 0 0] +/Dest (ajbrowser-building) +/Subtype /Link +/Rect [60.24 490.07 173.2723 504.35] +/Type /Annot +>> +endobj +283 0 obj +<< /Border [0 0 0] +/Dest (ajbrowser-building) +/Subtype /Link +/Rect [535.301 490.07 547.04 504.35] +/Type /Annot +>> +endobj +284 0 obj +<< /Border [0 0 0] +/Dest (ajbrowser-navigating) +/Subtype /Link +/Rect [60.24 471.59 230.3713 485.87] +/Type /Annot +>> +endobj +285 0 obj +<< /Border [0 0 0] +/Dest (ajbrowser-navigating) +/Subtype /Link +/Rect [535.301 471.59 547.04 485.87] +/Type /Annot +>> +endobj +286 0 obj +<< /Border [0 0 0] +/Dest (ajbrowser-running) +/Subtype /Link +/Rect [60.24 453.11 173.7973 467.39] +/Type /Annot +>> +endobj +287 0 obj +<< /Border [0 0 0] +/Dest (ajbrowser-running) +/Subtype /Link +/Rect [535.301 453.11 547.04 467.39] +/Type /Annot +>> +endobj +288 0 obj +<< /Border [0 0 0] +/Dest (ajbrowser-problems) +/Subtype /Link +/Rect [60.24 434.63 319.674 448.91] +/Type /Annot +>> +endobj +289 0 obj +<< /Border [0 0 0] +/Dest (ajbrowser-problems) +/Subtype /Link +/Rect [535.301 434.63 547.04 448.91] +/Type /Annot +>> +endobj +290 0 obj +<< /Border [0 0 0] +/Dest (antTasks) +/Subtype /Link +/Rect [48.24 416.15 147.1733 430.43] +/Type /Annot +>> +endobj +291 0 obj +<< /Border [0 0 0] +/Dest (antTasks) +/Subtype /Link +/Rect [535.301 416.15 547.04 430.43] +/Type /Annot +>> +endobj +292 0 obj +<< /Border [0 0 0] +/Dest (antTasks-intro) +/Subtype /Link +/Rect [60.24 397.67 143.4105 411.95] +/Type /Annot +>> +endobj +293 0 obj +<< /Border [0 0 0] +/Dest (antTasks-intro) +/Subtype /Link +/Rect [535.301 397.67 547.04 411.95] +/Type /Annot +>> +endobj +294 0 obj +<< /Border [0 0 0] +/Dest (antTasks-install) +/Subtype /Link +/Rect [60.24 379.19 178.1153 393.47] +/Type /Annot +>> +endobj +295 0 obj +<< /Border [0 0 0] +/Dest (antTasks-install) +/Subtype /Link +/Rect [535.301 379.19 547.04 393.47] +/Type /Annot +>> +endobj +296 0 obj +<< /Border [0 0 0] +/Dest (antTasks-iajc) +/Subtype /Link +/Rect [60.24 360.71 146.0798 374.99] +/Type /Annot +>> +endobj +297 0 obj +<< /Border [0 0 0] +/Dest (antTasks-iajc) +/Subtype /Link +/Rect [535.301 360.71 547.04 374.99] +/Type /Annot +>> +endobj +298 0 obj +<< /Border [0 0 0] +/Dest (antTasks-adapter) +/Subtype /Link +/Rect [60.24 342.23 229.8043 356.51] +/Type /Annot +>> +endobj +299 0 obj +<< /Border [0 0 0] +/Dest (antTasks-adapter) +/Subtype /Link +/Rect [535.301 342.23 547.04 356.51] +/Type /Annot +>> +endobj +300 0 obj +<< /Border [0 0 0] +/Dest (antTasks-ajc) +/Subtype /Link +/Rect [60.24 323.75 131.5875 338.03] +/Type /Annot +>> +endobj +301 0 obj +<< /Border [0 0 0] +/Dest (antTasks-ajc) +/Subtype /Link +/Rect [535.301 323.75 547.04 338.03] +/Type /Annot +>> +endobj +302 0 obj +<< /Border [0 0 0] +/Dest (antTasks-problems) +/Subtype /Link +/Rect [60.24 305.27 284.1735 319.55] +/Type /Annot +>> +endobj +303 0 obj +<< /Border [0 0 0] +/Dest (antTasks-problems) +/Subtype /Link +/Rect [535.301 305.27 547.04 319.55] +/Type /Annot +>> +endobj +304 0 obj +<< /Border [0 0 0] +/Dest (ltw) +/Subtype /Link +/Rect [48.24 286.79 159.3924 301.07] +/Type /Annot +>> +endobj +305 0 obj +<< /Border [0 0 0] +/Dest (ltw) +/Subtype /Link +/Rect [535.301 286.79 547.04 301.07] +/Type /Annot +>> +endobj +306 0 obj +<< /Border [0 0 0] +/Dest (ltw-introduction) +/Subtype /Link +/Rect [60.24 268.31 143.4105 282.59] +/Type /Annot +>> +endobj +307 0 obj +<< /Border [0 0 0] +/Dest (ltw-introduction) +/Subtype /Link +/Rect [535.301 268.31 547.04 282.59] +/Type /Annot +>> +endobj +308 0 obj +<< /Border [0 0 0] +/Dest (ltw-rules) +/Subtype /Link +/Rect [60.24 249.83 250.1109 264.11] +/Type /Annot +>> +endobj +309 0 obj +<< /Border [0 0 0] +/Dest (ltw-rules) +/Subtype /Link +/Rect [535.301 249.83 547.04 264.11] +/Type /Annot +>> +endobj +310 0 obj +<< /Border [0 0 0] +/Dest (ltw-configuration) +/Subtype /Link +/Rect [60.24 231.35 149.2588 245.63] +/Type /Annot +>> +endobj +311 0 obj +<< /Border [0 0 0] +/Dest (ltw-configuration) +/Subtype /Link +/Rect [535.301 231.35 547.04 245.63] +/Type /Annot +>> +endobj +312 0 obj +<< /Border [0 0 0] +/Dest (ltw-specialcases) +/Subtype /Link +/Rect [60.24 212.87 144.2505 227.15] +/Type /Annot +>> +endobj +313 0 obj +<< /Border [0 0 0] +/Dest (ltw-specialcases) +/Subtype /Link +/Rect [535.301 212.87 547.04 227.15] +/Type /Annot +>> +endobj +314 0 obj +<< /Border [0 0 0] +/Dest (ltw-packaging) +/Subtype /Link +/Rect [60.24 194.39 313.3104 208.67] +/Type /Annot +>> +endobj +315 0 obj +<< /Border [0 0 0] +/Dest (ltw-packaging) +/Subtype /Link +/Rect [535.301 194.39 547.04 208.67] +/Type /Annot +>> +endobj +316 0 obj +<< /Border [0 0 0] +/Dest (ltw-agents) +/Subtype /Link +/Rect [60.24 175.91 168.3163 190.19] +/Type /Annot +>> +endobj +317 0 obj +<< /Border [0 0 0] +/Dest (ltw-agents) +/Subtype /Link +/Rect [535.301 175.91 547.04 190.19] +/Type /Annot +>> +endobj +318 0 obj +<< /Border [0 0 0] +/Dest (compatibility) +/Subtype /Link +/Rect [48.24 157.43 205.7715 171.71] +/Type /Annot +>> +endobj +319 0 obj +<< /Border [0 0 0] +/Dest (compatibility) +/Subtype /Link +/Rect [535.301 157.43 547.04 171.71] +/Type /Annot +>> +endobj +320 0 obj +<< /Border [0 0 0] +/Dest (versionCompatibility) +/Subtype /Link +/Rect [60.24 138.95 188.3919 153.23] +/Type /Annot +>> +endobj +321 0 obj +<< /Border [0 0 0] +/Dest (versionCompatibility) +/Subtype /Link +/Rect [535.301 138.95 547.04 153.23] +/Type /Annot +>> +endobj +322 0 obj +<< /Type /Outlines +/Count 36 +/First 323 0 R +/Last 357 0 R +>> +endobj +323 0 obj +<< /Title +/Parent 322 0 R +/Count 0 +/Next 324 0 R +/Dest [7 0 R /XYZ 0 841.89 null] +>> +endobj +324 0 obj +<< /Title +/Parent 322 0 R +/Count 0 +/Next 325 0 R +/Prev 323 0 R +/Dest [10 0 R /XYZ 0 841.89 null] +>> +endobj +325 0 obj +<< /Title +/Parent 322 0 R +/Count 9 +/First 326 0 R +/Last 334 0 R +/Next 335 0 R +/Prev 324 0 R +/Dest [20 0 R /XYZ 0 841.89 null] +>> +endobj +326 0 obj +<< /Title +/Parent 325 0 R +/Count 0 +/Next 327 0 R +/Dest [20 0 R /XYZ 0 765.17 null] +>> +endobj +327 0 obj +<< /Title +/Parent 325 0 R +/Count 0 +/Next 328 0 R +/Prev 326 0 R +/Dest [20 0 R /XYZ 0 310.37 null] +>> +endobj +328 0 obj +<< /Title +/Parent 325 0 R +/Count 0 +/Next 329 0 R +/Prev 327 0 R +/Dest [38 0 R /XYZ 0 841.89 null] +>> +endobj +329 0 obj +<< /Title +/Parent 325 0 R +/Count 0 +/Next 330 0 R +/Prev 328 0 R +/Dest [38 0 R /XYZ 0 742.83 null] +>> +endobj +330 0 obj +<< /Title +/Parent 325 0 R +/Count 0 +/Next 331 0 R +/Prev 329 0 R +/Dest [38 0 R /XYZ 0 654.01 null] +>> +endobj +331 0 obj +<< /Title +/Parent 325 0 R +/Count 0 +/Next 332 0 R +/Prev 330 0 R +/Dest [72 0 R /XYZ 0 336.23 null] +>> +endobj +332 0 obj +<< /Title +/Parent 325 0 R +/Count 0 +/Next 333 0 R +/Prev 331 0 R +/Dest [72 0 R /XYZ 0 268.37 null] +>> +endobj +333 0 obj +<< /Title +/Parent 325 0 R +/Count 0 +/Next 334 0 R +/Prev 332 0 R +/Dest [72 0 R /XYZ 0 135.33 null] +>> +endobj +334 0 obj +<< /Title +/Parent 325 0 R +/Count 0 +/Prev 333 0 R +/Dest [77 0 R /XYZ 0 405.64 null] +>> +endobj +335 0 obj +<< /Title +/Parent 322 0 R +/Count 1 +/First 336 0 R +/Last 336 0 R +/Next 337 0 R +/Prev 325 0 R +/Dest [84 0 R /XYZ 0 841.89 null] +>> +endobj +336 0 obj +<< /Title +/Parent 335 0 R +/Count 0 +/Dest [84 0 R /XYZ 0 650.27 null] +>> +endobj +337 0 obj +<< /Title +/Parent 322 0 R +/Count 5 +/First 338 0 R +/Last 342 0 R +/Next 343 0 R +/Prev 335 0 R +/Dest [89 0 R /XYZ 0 841.89 null] +>> +endobj +338 0 obj +<< /Title +/Parent 337 0 R +/Count 0 +/Next 339 0 R +/Dest [89 0 R /XYZ 0 765.17 null] +>> +endobj +339 0 obj +<< /Title +/Parent 337 0 R +/Count 0 +/Next 340 0 R +/Prev 338 0 R +/Dest [89 0 R /XYZ 0 529.89 null] +>> +endobj +340 0 obj +<< /Title +/Parent 337 0 R +/Count 0 +/Next 341 0 R +/Prev 339 0 R +/Dest [100 0 R /XYZ 0 841.89 null] +>> +endobj +341 0 obj +<< /Title +/Parent 337 0 R +/Count 0 +/Next 342 0 R +/Prev 340 0 R +/Dest [104 0 R /XYZ 0 472.38 null] +>> +endobj +342 0 obj +<< /Title +/Parent 337 0 R +/Count 0 +/Prev 341 0 R +/Dest [104 0 R /XYZ 0 254.28 null] +>> +endobj +343 0 obj +<< /Title +/Parent 322 0 R +/Count 6 +/First 344 0 R +/Last 349 0 R +/Next 350 0 R +/Prev 337 0 R +/Dest [118 0 R /XYZ 0 841.89 null] +>> +endobj +344 0 obj +<< /Title +/Parent 343 0 R +/Count 0 +/Next 345 0 R +/Dest [118 0 R /XYZ 0 765.17 null] +>> +endobj +345 0 obj +<< /Title +/Parent 343 0 R +/Count 0 +/Next 346 0 R +/Prev 344 0 R +/Dest [118 0 R /XYZ 0 535.07 null] +>> +endobj +346 0 obj +<< /Title +/Parent 343 0 R +/Count 0 +/Next 347 0 R +/Prev 345 0 R +/Dest [129 0 R /XYZ 0 551.45 null] +>> +endobj +347 0 obj +<< /Title +/Parent 343 0 R +/Count 0 +/Next 348 0 R +/Prev 346 0 R +/Dest [166 0 R /XYZ 0 382.67 null] +>> +endobj +348 0 obj +<< /Title +/Parent 343 0 R +/Count 0 +/Next 349 0 R +/Prev 347 0 R +/Dest [177 0 R /XYZ 0 205.185 null] +>> +endobj +349 0 obj +<< /Title +/Parent 343 0 R +/Count 0 +/Prev 348 0 R +/Dest [191 0 R /XYZ 0 611.07 null] +>> +endobj +350 0 obj +<< /Title +/Parent 322 0 R +/Count 6 +/First 351 0 R +/Last 356 0 R +/Next 357 0 R +/Prev 343 0 R +/Dest [203 0 R /XYZ 0 841.89 null] +>> +endobj +351 0 obj +<< /Title +/Parent 350 0 R +/Count 0 +/Next 352 0 R +/Dest [203 0 R /XYZ 0 765.17 null] +>> +endobj +352 0 obj +<< /Title +/Parent 350 0 R +/Count 0 +/Next 353 0 R +/Prev 351 0 R +/Dest [203 0 R /XYZ 0 221.53 null] +>> +endobj +353 0 obj +<< /Title +/Parent 350 0 R +/Count 0 +/Next 354 0 R +/Prev 352 0 R +/Dest [209 0 R /XYZ 0 708.99 null] +>> +endobj +354 0 obj +<< /Title +/Parent 350 0 R +/Count 0 +/Next 355 0 R +/Prev 353 0 R +/Dest [232 0 R /XYZ 0 517.41 null] +>> +endobj +355 0 obj +<< /Title +/Parent 350 0 R +/Count 0 +/Next 356 0 R +/Prev 354 0 R +/Dest [232 0 R /XYZ 0 215.97 null] +>> +endobj +356 0 obj +<< /Title +/Parent 350 0 R +/Count 0 +/Prev 355 0 R +/Dest [232 0 R /XYZ 0 116.55 null] +>> +endobj +357 0 obj +<< /Title +/Parent 322 0 R +/Count 1 +/First 358 0 R +/Last 358 0 R +/Prev 350 0 R +/Dest [242 0 R /XYZ 0 841.89 null] +>> +endobj +358 0 obj +<< /Title +/Parent 357 0 R +/Count 0 +/Dest [242 0 R /XYZ 0 765.17 null] +>> +endobj +359 0 obj +<< /Nums [0 << /P (i) +>> 1 << /P (ii) +>> 2 << /P (1) +>> 3 << /P (2) +>> 4 << /P (3) +>> 5 << /P (4) +>> 6 << /P (5) +>> 7 << /P (6) +>> 8 << /P (7) +>> 9 << /P (8) +>> 10 << /P (9) +>> 11 << /P (10) +>> 12 << /P (11) +>> 13 << /P (12) +>> 14 << /P (13) +>> 15 << /P (14) +>> 16 << /P (15) +>> 17 << /P (16) +>> 18 << /P (17) +>> 19 << /P (18) +>> 20 << /P (19) +>> 21 << /P (20) +>> 22 << /P (21) +>> 23 << /P (22) +>> 24 << /P (23) +>> 25 << /P (24) +>> 26 << /P (25) +>> 27 << /P (26) +>> 28 << /P (27) +>> 29 << /P (28) +>> 30 << /P (29) +>> 31 << /P (30) +>> 32 << /P (31) +>> 33 << /P (32) +>> 34 << /P (33) +>> 35 << /P (34) +>> 36 << /P (35) +>> 37 << /P (36) +>> 38 << /P (37) +>> 39 << /P (38) +>> 40 << /P (39) +>> 41 << /P (40) +>> 42 << /P (41) +>> 43 << /P (42) +>> 44 << /P (43) +>> 45 << /P (44) +>> 46 << /P (45) +>> 47 << /P (46) +>>] +>> +endobj +360 0 obj +<< /Type /XObject +/Subtype /Form +/BBox [0 0 595.28 841.89] +/Length 162 +>> +stream +q +/DeviceRGB cs +0.0 0.0 0.0 scn +/DeviceRGB CS +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +q +0.25 w +/DeviceRGB CS +0.8667 0.8667 0.8667 SCN +48.24 30.0 m +547.04 30.0 l +S +Q +Q + +endstream +endobj +361 0 obj +<< /Type /XObject +/Subtype /Form +/BBox [0 0 595.28 841.89] +/Length 162 +>> +stream +q +/DeviceRGB cs +0.0 0.0 0.0 scn +/DeviceRGB CS +0.0 0.0 0.0 SCN +1 w +0 J +0 j +[] 0 d +q +0.25 w +/DeviceRGB CS +0.8667 0.8667 0.8667 SCN +48.24 30.0 m +547.04 30.0 l +S +Q +Q + +endstream +endobj +362 0 obj +<< /Length1 18864 +/Length 11954 +/Filter [/FlateDecode] +>> +stream +xœ| `SǕè̽’,ÿ-[òG²¥+_ËòO’mYþK–mùÿ·eYþ`,ÿ þáÁ¸(!!)’%4!,Mx©H³„Ðn6í†4Ýn^6¯¥mÚ² Û¦mÒ4d³4Ûöõ;s%Û²!M÷]qï9sæ̙sΜsf$ƒ0B(íA4êih1dÎKŽt#„‡ÚÓ7æšüÎoÚ¢sÞ·}†™©z:ü!*wprhlÿ÷|Œ !¿Œ!×ô$òƒª: ýƒ†Fç·T¶<‹ä-„t¿põÓe[w@Û'pg ìªðg@;ê Ãc3;¾a‹]†:àãÉщ>~î¿¥Ð?Ú¯Œ¹vLRWð>h«„:3î8òô¿ TãùÇNNLϼz«ø&B•¯CûLN LÞ¬ZPà˜C "sÅ¡]w_ÚZøg(Fäúþ©¬ÏÉû—ŽëŸ-ÿž“ŠëEÉP# +y.è'>²tž=Ë¿_Þ&®ç)ù^]<¤ ½ˆÂÐ÷¯E¡èJfJA]@ÿ?-HxJh¸Òó¦ÿ âÏ)D +)P@Q‚ ”QECC²"]óòp„r2Þ6Aµð‘”¤@RÔóè'´ Í +æÐág¨ÿ3š¥®òw ÀöÔÌÔ<2Â{7UýæPÁ…{îûàfáÞ÷.¸çàî&mT5:w/¡±z#äôëFû… }aª|„f…ïÂ{î˨x›9Q=õÜ¿ZþHxÊÓæ·ՋÐþš\ƒwÀ;€öïQ²ð{H%$’FáÂJ&DË_P7ÐÛp×Ò–¿ìEƒ0Ž†þ xüîJ´º…rõÈ ”" u¨Áåß ^„òÁ3H,úQ‚3(@°‰QÈAÁ8s˜#oêCÔ/ºŽÎùŠ ? CÞ*bcÛ÷Ÿør_$ò•`¨¨ÕЃ)‹¶1nÜԹ˷/”õ؀ÞÅÀ€R¶t @—†.B1Jî$vò"N²`¾@%•å_¤8˜ ë¦5e®~wc“³Ì¦P«ÛuiUîÖÆ7¡Rž¤[TêöãI2#„utˆ¹˜öúÂáËa¨·'5¨Ÿíwu9Ý´ ú.Ðe ܒTw2ks'ïüm4Ì|ÀÆÚÊÜ©„jMóê85kCb·PÆ2 F0öOŸ¬‡¸¼‘&ìψËA¼ å,S¾Ð³àº¼¼§—eÂ؅‹AA “e aÔè„^——¯R¸Ë·»Ãz†q¾w²åÍ5N§›Ò”3Ã.€À¿"V«PKÚWp¿¬ @ SµšLüÐe+ꅊ{O“ÓSgP¯â%d5¤¶»©ÒòúJ‹¬•´ìYiYíÞÂ6kZœ n¦ªŸ-r¹÷ô‚=m!ª`ÃÜ!_(ÔìB¸„É3´ó¸ pUÕ?¸…‰ èåÛ,…tYã+!_x^RÀ‰’p&2„N[Öãý·}80º4weªGõv§Ûjƒ‚ÕåÕQÙÅtôpõ€ŠFl¼úÜvÒ-eKVõIØ*iqò]¼ÝÜÒR7uo/·¡ÌFFfʈmý­šÜšÜ{¸}´XÃ69_EÆå.f1ŠïQj·‘¥`ƒ‰e ÎþA·ªGÑ«rq*Ônk;hgíÄ(AšÉkjž;7UjwÖ´°5MÎ\/ӞBN )Û@†u*íT~æIú¤êIÊÿIì89xrûI=öøäã{¢ ãaÇ©ÂwŽãžãøæñåã”õ8†so>öícÿtìc‚£Çž>öþ±›Ç– IjxÏÖG¨fàÖNäLTLÐrݱ¬ò,«DÀÆ·‡ðåå×­‡‚ËU†*½ßÚ¦Ÿî.›áî†;ÂÞ*¶À~(½›¾IÓÖ6YtyºÃêhtÐE­ ­ï´¾ßz³UØhÿÌNѕªä +,WàX£¢5Ò(k•àÐÖ0ch+dP­¸µ>ú~(UúNèÍPzíFßF7‘´¿' ñeüÈE{KjjÍe¿eˆÃ~nü[ÓBžÖ¦·è!7jíèt^ÄøáöýGŽ ’¸wf‹ÓÝ×^ã•ö@!,îb$*iŸžžžIå/<½y:u3ÔSÑô +d:uyJˆLÏÌþÌìl÷4îžîd Xðð`øG ›ŸïšJðSÉpÓäÀÔi¸S h:5‰¤HÆï>¢`?rIøöú,UP¤è(BËdgæóä¤Üÿ$ÙýÊK¼Rø>ú!r ø² ¢Y´//¡ëðÙr½ƒ~ƒ~Ä·£°‡„ ‡Áj…ïõº††VimCg¿døn4Î£wÑÇøáUX?À`߆ŽÀþy‰K¡,œS˜EGøÑ"©RDöº¤Ž ß»üó†OÃXó_§ ýSÐâ¹®‚‹j5h çyØ$ì;7} =ƒv¡­ÈŽ +½bá¥Åǐlù&z =.{¡Íh¯·ô.z‡àK?« m"/‘”»¶ ]ÔÁBDI)±H*’‰~(ú9µ‹šðùÙÀ +®R¨ÓÀø[lÃe‚÷ŸP&*™zžº¼¼m¹Wø¡ð’§ƼŒ-¸Oá“àȆ %œj¦öPoÑ)ô0}I H|Cð±0AØ/Ü!<,<#ü\´ ú©_Šß¤ß¿?ˆñ”ø_Å·ýý¿îÿr€ Àð@À[±Sç?Ê +z8h1Ø<üHðéà/BšCù]hb薰°ž°3aÿ.ɖtIþ-\îÿ^„2¢7âJÄÇÒtéé/dVÙc²×e‹‘‘呃‘WàóVä§DI` ˆ>VO“£D-Ѩ%êA:kÉ@/}Cxévu¯àsÀûÉòçø…P„‘fé, eÌTR2iÅÆë©ëŸVv7KYƒBn`e2Ö WX©ðҝßq7’LLHcJÒf“w6?î,}zge\ ôøû‹÷,Ý\ <„—8¾Á©—F–»é`}f¢TNNAh™TÄfé)­„/úÉXS<©¥J*J¢§MÀ[ŽÉÁ£X0æÁ!45Öµ·Yã¬Ֆgw=ܓùæ¥!ãp_g¢#µa¬¤g³&£coãÐëR}•©«Ÿ3ÉRÌII–d™pŽÒ˜›ÓKJu5Y".>©qÓ¶ªS/Dü喿Œ‰Äy[[s„øvª}ÓhiÙd‹Ñÿé;óÉŹéÑ\^Ø,˜Zœ™Žÿ—¿6§æR½ü‰ðºðÇȂêQBjmM¤Çsìa|E¨~ØB›±ZÆÆC9ûE)é,Ód"i+) ócãE¤e¡'ž×´î«Ÿe®ÐÐ:W­-ÐJÓº ö.´i[öuãِð@Þ_’§ 7°¯…2©)á‹C…CŽÊ8®ÀPcŠMkšÄz©®*«³7ŒÍÖ¶çǾœR•­²l;íjÛÛ[­Ò·Ú™¶ñÆT}㖂’AG]7«ßÜÙ¦itˆãr %§ê~* 8ºcÒÌ øCyQËpIÍtC’ 2¹Ü¨ÜâÔÚJ+Såùevˆá`¸ž·Þ¢f½z'nÍr·©}¼OF¼údz +„nÁ9²WGXwykw~þŒì²FPw~zíekwî™ëXýê«Xõë§s»¬ßù駄V ÐjôÒ"&aRRá2)25Yh<Qü5 uAÁý@ëkÅ<­Ÿ~Çڕûô¯¹¯¾Ê½ýLn·õåk<­ýXCßCP‘°µI-U#£ææ¹xnÏSg¸ýx~ïäœ|3w<V†(ÕdÁ¦,½À”•MôŒ$4íî莌OŒ¬ËcrÓbÅ;‡[¦«PªIc“U–(])/#¾AURó¼¼Lj™‘’á§Nñní†õ¹Ɖ@(gÃÊܽqUîºkAbˆfbªd´£`-ÎÍáŸß÷¿ ~­v-"ˆ›@Z¢ ÅuÀ@8\2‚ašxƒ ¡q;^ž»ÿÒlnîì+»w|gGÁ’4¶h¨ºf°H¡(¨®²ÆR׿Å}üæèè›8êùç±ô-[ÞàþøÂɛϵµ=wóäÉO϶¶žýÔ3·àÞ¾†À2Œ&~ Y5‰ ½"l”Àà°0®dÍ:…¶ÜjVêòUE-ÆGöÉõf¶ß ÊOd¥×çªÌâ(I³åNjz¾*ÀAhíßÀÜ dfdÑ©>P¥Õ&X+’y—(+íÖ;w7qçð{úÂD™ŸØ°x;š'lÊcCvy[f¸Æš®0œèsÍÌV>tôT;·Wž’£Ôp§OàC›Oìß]^°¹L“i7©ŒÚ‚êäŒöûù¹Þ²¦€Ÿj°¯DS±ÉW¸¾¼ð~B)„—ÀãE²‰ ċæq{¦±gÁQ\l›mˌ6µ”;½| _§·Y2œ;*öº6­npfgÁÀ76ëÊ ØWG|ýý]Å#ÕÉúæÙªÂî’x_6ÓZæêËvö•K ÙõC¶æ¯»l)K‹ÎR–ÝY¢á텅|© Öu4o/2~Ôü$À¡™@eF&/Dò¦»:K¼béñ|¢À¥ƒÔÜ8ÎBÑBŸ\­Ñ0Aܛø·øÑó¼Êxež·Óï.ÖOãOu£“é!†|«ÙÎEóòÛ¶ü èóedZ“ï@µêV«§Y5ÍíêêX‘ÙGE[ÒҚ§*Lui%ԅ‡˜ŒNf¸i­j¶³ï…û+Jw_ž:îL(*Q™7õ³Mû]M;µâà0quû±9R% à,‘٣ώ_˜/ÕVÅçYÓjs^.»@·a Û”¬ÆS´…öá„,(‹Àà£MøVJ¶)+‘:vêt`Œ¹²5³ûäÖü‚mώ ¾¸»2.ßy߉Çn{rc]Dšm.©º8[FiËûÍãÓ»„ÃÜ»Ü5™6.<ô©Þї÷V¶¾‚Uÿâºrîð@nBa}r5³­X³t^¦N•úå‚õ…+ß>CdY™ +dy“«ãC1¡–a¼ÿféwãþ`ðôcœX6<ˆ§ +n@|Œî†¹)`nZ”‡êÀ?Ý#ž‘X푹Ыm^‹c`ٞ@Öm°O•æ÷–k3·|k{ω¡ì¤ÊAKí®ŽŒò=—&§_œ-À¿*«KItìsM±eÃ8=&§½8¯½P[~MZ8ž¨žh+gÔu]c֊-¦î½u¥ƒMŪ„æžÉR×[r +GŽü4¹²¿ «½¥!5ë܌u¸&Y 1tT¤jŠ;L9ÎÊ"&Î\Å|Shxù#z‘×›™XUxÄZÌæݟÏòËQÒ:džæ Ìø'Ï?YPәÝ~|kAá¶g‡†_ÜS¡ÈkŸ?Ó×6]›’\Pû`f‹ÕB%•» +ÆîS¶wàtœ¥ÈÔFe ?5<ñêþšÆóÜâË[ß¾tr¬ʴ2‰Yb¦@'§š±BW¨øçû _ûûŽZ–ç÷Ăó»Ç_oŒ’ õs£ÃWE zz   Q{ò¹^ˆs/Á˜Q(õޑnðø¥»"wkãÐ÷Ž…tå] @\F7 .¿‡D$6b™?–í§'–)7u¹¿w;Ä=Hø܏¯Ñ·èÞ¼¼¹é[‹Ò‹Rõ÷ŽÍÍ­§—còǀ¶Ÿr/5Ò7âmxö §­äçí\þœ> ¶¡»G˜•Ü;fðö¿1c¦vµÏU©äÙ­Ö¶ìhE'×m~¤Ïuv‡Í4øØæl”~ +ç$lž˜3›ÚÌñ)•›Mu¦:Ãna37/8í SÝÚ¥Ûw§ÚdÎÜuÑçà;a—ÈG9ˆZvՈÁçDFåi‘Ÿg9úÁJ='Š '$òA\’@ Yu$ß¡ÇSôyåÌъι¸@™©´%˲­Õcj™y¼»d³ª9c˜ÐY¼.F×]›áxâڞþï_8¶¥°÷ï¯Í~bßDZºñþcßÚü÷É'‹îûÖOÿïá Xðb۝Ûʲj³ÿúàb¹¯&› £ÙÇnžïèu&Ù2cStäìÙ}_gNBLêÒÑÑÒtY‚‰ «<ô/_ðíC¹c÷£[‡_øÏ'ÊãÒÍLubUÛyK¯<Šýþ㕽åƒÿ“ËÑUvð™8Æ䘘çå—ð,È+Ï +x©D®F°lÄ|&Nªà˜ ˜ÖcÈâýh5>]ïPZfà‚´Ê”xU~ó ~'(&>M©XzÛ0ï/n>˘$~‘±á‡ðÿÆý<Ú ÉJw8‚,‚×ï3)1áz% Qâ·;Ÿ®Ö”U6¤sxÿJ¾u} xR#=ì‚<¹ŠŒxTA²7=xR5#ÀÆ»3‡T,Ø«µmÊ.ŸiÑs‹ÜK§å¬Y/WèÍñrJƒ°`©û‡m;jã•U;:~üpǎJU|í\ÛAAeÙp½)\”¿iwӛWùøK¢ËQú;.Þq1S͍Ûë™Ò-Õ5¹'w‡Xp֛S­Ø»‹ç¥¨Ä>aòHZ4òäQ‘^œ“×Y:óÌ >}ø›Ûj¦¥rI¤iôÜÔø»Fûs_ÌZìj“FšÞ]ch}ö橃¿}¶#.½(>0Q¥m*I…„2ò[ç°ôM.AnB’‹Èa…zsWõzyŽ ªa—ýÜí¿_:â#éÓy¡cÉ´ó•æÿú¯—©ëç¹ÿü§!_A¸®pŸ-^o9óñIœKîD}ƒqÁkÖRÊu{óØ=¨ñûøPF™^. Ùrç’<Þ¬WÜU.l D¥ë¹óøS.|pääN9ücstô§|Jĝrü¥÷ûWÆíqÉl e‰oöµahh’ì˶´”Ÿ°gÐh-]ظäîçê<™?äü„aH’«yu-< +ºï'ôú‡ìã=µž³2<¿§•IB0mz‰ûïo;:ÿ]œúÖ¶\¥±,)bñ×_™ÉÊÞùƒÃ©„%1%Çe%FýRº¦ÞvðħÏ؃‚qµ.'ŽÏ Ò¹GÒõ^™ˆ@&°‹Z‘×ÈÅ˘zC݃K_Rðê '_½àc"vE¼E§ N)tfVAÙ×Zx3ÁpÌZöê5¾ÌõâÓk-‹áºœXòòL=<ûìyîÅS=?o+^&xæ<ýևt¬wÇ´—?â¤<í8p,÷$µ¨ˆ’¡rïô*ï¡—åf5mŽ +~¿6‡;ìÂ+c+r¾t­P!q0‘’$‰õÇJ ̒x£Å~UôôuZL`¦_e‹‹Ë’¸ŸcwÁXž r聎ÒDîéWd¿j­^æÛ ÒBåv»"£Bǽ´t®©Å–R‘ƒoá޸˄y֗^C¾kUýe²^YÀ¤ ,àÇôÅ)Qé֐u"÷Wæèî<ª6•¨Ÿà*WÆð3ÂÙ+6˜#Á,¾·(üñz% ÃýÀÐ#).u‚ÓHµ9ñ"N»&ü|ŸÅo®ñæðWSå·#Œ¹óowÍüΘàØ]6Áëîð—Frþ{³…7HEpd yÔÁ­<¾ºN + +Šâ‚§ëî²ý;Ñ‡| È~züȼðí¿ýŒA8o?ûٓÏ~~¦±ñÌ­gŸüô¬ýίtýOOM=ݗ–Ö÷wSSgtëÏdolÝzÕ÷ŒáæY‡ãìM´'ûaþ,J¿Ë +¼Þ,uE.ôZP­÷qE{_ûš9ïëÿçä^R·}2¶é»–ÑC¾s/˜8Ýßy~owŽ_ìÔ)mÛAÙÁ­ò!¬>ø(¯ñY6콕ÂøÜRãç'²z‹Eq=ó3Ëýñy^댖D{“c4›;øÈJœ?t»¹Ù’T™ßæ:xÆ|Mæê›Íó…ᆤƍÍÓUj°—^Øg~¿ˆø}Ï.Ú»Uf}7~"ß åÙâÛýO eÕUÐê’Áʅ'™ê¹ŽÍwëKwœuu=Ükl«ŽÊvl²Æ35;Û;ŽôfU×CŠÑKL‡#ˆµdÞ)âyGHLÎzs"ÑÀ3(½~PÖ\â½ù<…Qœ.$Tû2- ·´J]‚2”;w™{‰ûá?rbâõÀoð úž\/ MVÜž_<8ø݊êgû¨AJ¥ÜŸç+Þb¼S$˜¿³=ÿÛ6}§ºñûè O ¹åϵžsã5N½ñ̳{ää}öþX×ÔK _!ǽ"‰KŠá×ÕúŒ8ˆmsºF­|éç;…! +ُãPlqÑÁšƒ>;¸5›ô +*UÄêåt@„äÕDÅ +5áQÁB‡#„ÍMáìKÏf8¶ÀHeZ<.çÜÁêMçp„Æg'á)M4û‡EJ +îֲȾ€¹‰`n–µœhMô„g¯ìé"¼Ñ6¼Ž—ó‹„Û/Qª“ärÊXËJýb‚OȔø+Ô áû¤kA!¾©MJ•sç!6ŧó+—,K ŽËä>-šOÌ63d‹bt:à^cÖ/}“;à Q½ÍݦNˆ¤Hû{Éúðø6þQ{¼'öÅ·s·ý Êo‰\ƒ]‡{2d‰YLlj\¨ª@_Ú[<çZBdْ³'˜QE;½–îùªÔoõ؁Òz¾C-X=¡ð¬WþÐ:Ûçè:Ê»|Ö@*YžõNv9ñ")Xž+ +•Ëä)RV§ï<´‰±4AoPü¡kO“¦øÁ·ýì§)]FY#µ–§•bÒ{qi*Í¡¡I™ñ*2tñLtá`ýøQ{¼ÂToüQjSQâ}m}™eiöþ¾V*R' Š–§Î:k÷v›0¦q@´21*F)꛶•8îË>}¤°Ãšäï¯LÉV›ÛS‹šzŒí‡{³#¢ƒÃ´êHIœöN´®>—Ñ”tfÌlHhJ-ݳo§Òâ*]xà€'þi oúؾ¯>×;‰ìuþM²bøÅÖ.½·Ñ?t½Ûv +=:%|ÛSÑ&‡ÅºÉ¬$^ý®xK¬Y®Œ»bpá<ûêŸK‡+5†¶ù®‘d¨ž|ُYà1šì\rÖsèMõ"6œ»V¯¤Â"<îÙ¿\9ΤÄD§¨""T)Ñ1)L8¦¨ƒÀK€cñiOÎ'´&¤+ƒ‚”é ðVÂF"ùŸ‡ñ#Iv…=[çu’Ú8:>]8z¼]šã(PñL|#\•JÆæßá‚ê;çȖÚEvÚôNž\{×Øý¸Eä·'Èw‡MûÉî¹Uð¨Ìgg.ò£.a‰i¤L×>m/O}ûqž¡»µ†‘:UaÄoTl¤Žq[›ŽÀä.ž|Õ³YðQÝâDZm)é&­ÉMQ‡ÊCŽþN=A†LõðºúM™Vƕcþ»[ùÒw})ß¾æQ¡•ûiøº¶{Øf”7v­¼ïmŸ÷0؞¥÷l~Jož¸X ²Õµ¦gvԙ#$ªÊ¦öôú¯9ô^ۍ26“cû(Ÿjign´)S»y՝˫J†¨Sa$ï»ì9Ã>náŠ|Ù];JV œŸ§à3˜gî_™ç_™ŽdE¢"\£`*Ú3šv·¢€i?îI²þÊ7çÇ| Ów1»Ž7O|Ôo¡dg…Ã<_§zBÍ]¿Ðýù“ ÷|ñ}JžKÊÒ­uu[Jâ”%ü[Ii¹÷¹ß•?üóG ÀD—¹öÈԋ³……³/NM]˜Îϟ¾@ÆS€_Ÿƒñ"ȷ㓵|&v™qøžK`EbÔË’¼w5­ƒ½Ãµq)Èñ l-»¡µ1OájW‚´I‘œ'~C—çï9ˆlá…úª7Éáes¹ +sÉâÑ´òå8Džìœ»ŒœuùîÆ ãêғ6¤'ýº;ÉÐàJ 0H¥Éui'åùs“,sc²q†o»s‚ðN 7dÄ6mlÏÁ ÞoüÂ#èHOÄOä¿IòpO[º(Z3Êm€4ÅÜa›“é+³Ò  uª1iËó5Çë›Ìl}“­•µÖ¤Vt¹z´Ük«k¤ òžAÉjWóCËØx‘¸ñ4âź]Ît…V™Õjɱç)£òz«fksn«š¬M¬«hí̂ ÅÖ4S“¿å¸T‘Ó”œÃgwW$+2ʒsÒ3¶¸ÖUZ>Z•¨4–%æ–ME§&hóÒu±ñ%õ½ÖÆMIÀ¯vùêa99ÛÕ@Ö*óêR%¨Án×(ãs£HJ¥±0Á)ÙÑõ“•ìSšöx65¬q·ZbQ‡(È_¨®Þé¤.4+Ùđ†ÅÙ¥ú‘^ o€uù¡ šÏÃ6f­¾>wÆ9¼F¸ï‚׫±we6ÝïÐyt4!Ëh±Ø\EJ²M‚˜ù>ïòÏåW&‡ê{OŽà?ò*Z2‘Þ¶³ŸK/X=Wƒÿz +x1x~³´º­§‰…Ü}î@öÿ¬˜Br‹Y,>#ø £âT!ÇüKm¡ø•þ›5î¿Ë½DÎ'è[GºQÂFq»Úì5òÈâºF >J ¼ß¬-^ oÖ<üP‰~ü›‡‹{œ~°´ö'^–éwÞRDK…"ÿ$Õ 8°´,_’+ÓXe(÷—³·4Ü¿?ÃÝâYáÛ +³%PÔ›mI”<øšÀ¶ôMMkKµÜx¼WË x6ƒX‹qñõîÅó^ØD§Gqç5ζZ¹¼¬¡YCmåù‡iNÿ•äL‡gzý‘„lCÿڑD¤ +ƒ©ÑáEÏy„!Sõ¬Ó5%*–n̋•ÑúKÃòËD\t„&73S‰)ŽÓµê”˜?Žˆ‰:°%*–¾¬‰'›•ÌýžÛê9ŠˆR¥1—ß +bâYþ "HiLÄõ¸Ç”ëpøK"ƒdÉÌå'X‹×>Àî‡ù_Äx¥">ùoZï¥u ö‹È1T8÷£ky˖…ÎðácU1Üþ¹:Äÿ‰Èböó?¢RD +DZùA°!‘ ÚcgûNl-O sYF9èÝL²<`ŒŽ±-M•rÝÞê;>Áœé³Àg”çwEÞ_ˆ©WÎe˜ºœ`PEø8¿G5s¯'e©e”CJK–.ÌÆêÍj÷r3½O–bIcÖ¾¸Û3ÿAî6-‚œˆß±yקÖ9š$+›OèD2’·É`ã"áÕIí®œ¨NԔ8Fg‰æø7˜;ë¶Mo¯ë4s·SjÇl¸¿¨9CF9(iF³>éÝÊ=Ó¿?‚’>0ȝwÂP˜ã¤Ôœç÷~˜•©¹ùyN*¾‹§(r¤ ¬ä˜ôމ|rÉûò(ð[ÞïŠ-ucÛ§¶ÕuZzôxb1á­81±z¼ò¡ÇGpïàR*b?îÞ:ê=;#×5èêM%kX#ӌ‹™™rõŒ¹¦¶2ƒ¾¬Ü5È: m`zdhœ±¸Æl®3<2>¬záýLﳊÜïAždýðÌÌd¾Ápß}÷é‡øÁô}c†¡ O|šÇ¼Ýy„é™Ùþ‘ û0°\>1>ôL ÎÜçš s韆1gÇû¦˜™á¦¥ª–i˜÷ ×zҘ5‰dè™{뙞™靅Ù0€égâ‹[˜ª–x¦¤¸¥ª%i«²W6´Ú™¶âææâz{UY ÓÐ̔6ÔÛªìU õP+gŠëۙšªz[30ìL1;&§¦§™‰)fdlrt„ˆªe`àËye'<3™žèécF]ãC³®!˜ÅäÀÔØÈ4™èo¼æ?62ãšáëCۦƉºæ&f§˜Y j¹kª+z˜î›™œ™ÖOŒê'¦† 嵨M I4‡¦Ð¬ßa4ƒ”‰Ò!+̄R´N| @­ +£>X« äУðaPój¯i¾6ï µžý€Y½gàfP Aƒ<Öš…þ.€ÔAë85|xFƒ–!À‡'ƒtpߋν`¾4 eB•Yèa.Ù>¸#<§.¸gÓ\ðãM¡­›_6ë¯æôË1m¼dˆ¬Wv¨¹ ¯ ž3xqºÿèkmfzàup P\ƒ—ò”îÝ{lÃèk¦6 ¼¹ÛùÙ)—óø3¼†ˆdg€ +‘ôÀªFáÝõqÞnÈ> +endobj +364 0 obj +<< /Length 1278 +/Filter [/FlateDecode] +>> +stream +xœe×ËnÛF†á½®BËtHs&Ã@‘n¼èu{stԒ + ß}ù½¤ikÀÆ/‰œy¾_Ã!}øôôÓÓùtß~»]ês¿ïÇéÜnýíòåVû¾ô—Óyg쾝êýë+þÖ×|ݶ“Ÿßßîýõé<.û‡‡Ýá÷í÷ûí}ÿáÇv)ý‡Ýá×[ë·ÓùeÿáÏOÏÛëç/×ë_ýµŸïûãîñqßúØú9_ɯ}ഏOmûütÿ¸óϼ_ûÞòÚLL½´þv͵ßòù¥ïŽÇLJ1wýÜþó‘9ç)eÔÏù6=n?[i(JKiU:J§ÒSz•2¨Œ”Qe¢L*ÊEåJ¹ªÌ”Ye¡,*+eUÙ(›ÊNÙUÊ-уÁkä5x¼¯‘×à5ò¼F^ƒ×Èkðy ^#¯Ákä5x¼¯‘×à5ò¼F^ƒ×Èkðy ^#¯Åkåµx­¼¯•×âµòZ¼V^‹×ÊkñZy-^+¯Åkåµx­¼¯•×âµòZ¼V^‹×ÊkñZy-^+¯Ãëäux¼¯“×áuò:¼N^‡×Éëð:y^'¯Ãëäux¼¯“×áuò:¼N^‡×Éëð:y^'¯Çëåõx½¼¯—×ãõòz¼^^×Ëëñzy=^/¯Çëåõx½¼¯—×ãõòz¼^^×Ëëñzy=^/oÀä xƒ¼o7à ò¼Aހ7ÈðyÞ oÀä xƒ¼o7à ò¼Aހ7ÈðyÞ oÄåx£¼o”7âÝþj·ùº«üo—‰$‰JI•$’$*I$IT’H’¨$‘$QI"I¢’D’D%‰$‰JI•$’$*I$IT’D’¤$‰$III’’$’$u>áMò&¼Iބ7ɛð&yÞ$o›äMx“¼ o’7áMò&¼Iބ7ɛð&y¼U†o•aÁ[5ñ‚·j¶oS orÁÛ4ۂ·sÞ®>,x»Â/x;³áíê·31ÞÎÄx;ãí +¿âíJ¼âíJ¼â특âíâ¬x»¯x»¯x‡+Þ!Êw¹âB®x‡b®x‡+ށïrÅ;àà2äÍkçΜñJ¼Y³e¼Y†Œ7+|œÆx‹ oSŠŒ7+[ƛețךyÞ¢oVûò浖 -㭌‹·é€"¯åþR¦W*–Ó4Xq”êC™^Jú[(£à®^ƒ1»¢y]•¡Èk¹}¼YM-x e#e®ÊÙ_y+ë¡h܊7k¶:û«/ âåæZå5«dUýµl¼uz5n¥¿[ç¾ÛeBø÷&Si|y»(ô%q& %+S%ñ*Aª¾ÛÊBijPUÃ6\¥h,ž(¶+L¥ºÝ,¥‚4G©5Þ<¥ô…ÂcD› [˧©ñ¡*t› [ jj¼aijü¼IµÙxʪw¹g¶FÉ›wžØ¶¥§Rô>¶Þís¡hâ>½:­O¯VRÇËí¾³P*#àÙi|e0¼Uýí,ì*o§¿Uáûì/ãÎþ*[§¿Uê,”¦Nö¹°•m€lšx°:š&\}M³¹»)üÒðL2„´\%CHËF7æÕ§‰ÇÊ»BŽLÉ…’)æjæ€Æ»J1:%¦H߯:=Së©ÿÛ³zýr»méükÀó¹žÌOçþí¿‡ë媳ôû7±Ùð +endstream +endobj +365 0 obj +[259 333 408 500 559 500 742 220 346 346 500 559 250 310 250 288 559 559 559 559 559 559 559 559 559 559 286 286 559 559 559 500 920 705 653 613 727 623 589 713 792 367 356 700 623 937 763 742 604 500 655 543 612 716 674 1046 660 625 500 359 500 359 500 458 500 562 613 492 613 535 369 538 634 319 299 584 310 944 645 577 613 613 471 451 352 634 579 861 578 564 511 428 559 428 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 361 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 857 259 500 500 500 500 500 500 1000 500 500 500 250 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500] +endobj +366 0 obj +<< /Length1 16780 +/Length 10896 +/Filter [/FlateDecode] +>> +stream +xœµ{ x[Օð½ï=-ÞdÉÖbK¶õ¤gI¶µÚ²-ïò"yw;râ8rlyI,Ûñ’BH MBœYZ ʤ)Ð6()B‡¡lÓiSÈ04Bg¦PZ˜LËÇ$öóޓœØ& ýçû)÷½{Ͻ÷ܳÝsϹrFIÐ.D"s»=çŽÒÃz„ð0@ýýÁ¾‰ü„ˆ?,¡Ë4=X³á^˜ðÀŠ'†‚E/ö$B”!QöPßÔÁUì‚ù±C£ÛÿɝX„l!cÊp o€¬ß´ú'Ê€ôç‚ÜéÐNNßæ‹K̄ö?B±ŒŽ÷÷Uõ­*@Hú[èÿN°ï¶ ây|új¡Mõ-¯})DÈu¡¨ü‰ñ©iQ¸¡r˜ÎOL&‚GwþB1%‘Ç+Žïù“ÿ·¯/ù Š²áóÒC¹×¹÷»]—?_±rñ~¡ƊÂ˜'>4ÿ<÷/„âý<¦¥ŸҀN#)z ø– +­© P# MQrâyèA‚‡N€§…ßä›h_%#&(EÔ +̨¦¹¹ÑðÝ¡áá£#}T½à' ¨]@/rxKÑ~҉f TkP±9὇h‚¾m¨J”Z(…P4PÚ ô@Y¥”ë#ÆÑ}ðÞ×AÔ("±À +>´YÈÀ»æ~‰ +Éåë«ø:eäqÐÐé`íMöÐ!짽¡ê-ó^¿𝉉®bªÑV :Õ¨…2˜‰38£ ó"Ã[t†@â8nÙiðö „ZZ}^F§ë¶ZêBÆÃw¡*eHXñ(éŽtt€>cyqöày)Úà7Ç0}=¾ÙsgIïì쾐ÌÊd<¡ÌÛÿ= 8„,ŒÇ2sXÚn¬ÓpsI¤ =ûì0Ÿ~²Ò Ò¿ ®Z ❝­fèêYÿlßù…]ZÊ̞‰ð‚„Q‹f_øéM¨ú`wHêÆEf«ÛB‰­k}!ÂPM÷þ¹]F'ë^ÓòuÝâ™êtãΗ£ Ðíjõ…Û4Ú 9‹Êíæîáçz^\ìQtr=»{nL÷3 Í†vßlˆ2Ô 0^ñ¾Ð® `O9U0Òä Ž™MÑ…ön~, TÕ ŒÐ!Ä³–NKá¦ÌJù†ä‹ðëS ,`”%Ѕ  áðx¯?òoËp  ­–P­9¬ú_¨Ü•ò¾ˆŽ¼gv˜Ñçxxõ…ìÌDHÎTÞÐ'G–w¤ÝÇO‰L É«Bp Gf…ì^·2íålë¯Õä.Ðä]»‡A‹ L«ï9ä\øàL.­ù‰å¢n‡XY6hôÎúCZ¿fvå íÓèBå݀¢›ñº9£if~¤éxêBDU‡¯¡ih]ã+ˆîàÐQï +4ŒOFæÄ´ÐÝ0P +º*Le ˜} Vó‹©© ÁPhIá‰q<ôIP'Ž…w ¼£áÅ/KEÁ2QâGa1ÀE<\„´P˜/˜æPð&ù>ò,.|±Â­ È ÏGùÚçðä·¯@!ÍÃǼå3(N|I€WoeyFç—hAkÿlýg„ÿS|Ýy­óŠórçûN²Óm×µÃ×B×Þ¼öÁµÏ¯‰Î/¼ø̵è¸ê7+bp + þÿtÀÓ…À)å ˜ì|ú2.¿ŒK.h˟õ?»ëÙÃφžýüYáÎsOŸ»rŽ”þ-–>ãæð3/>C=Ÿ¬?¥=e?Ežxª?üÆÃdüññão'£Ð1\ò³co#üÇð£Ç>;¶pŒ,?†ß8†éc¸ùÈú#„ûÈ}G=BþìÈGˆ–#øµC¸ûàÈA"î`êAâµ»±'u&'.hEԂVÔül荡+C¤c°|°e¤±;ð³ÊZ^xs@èLèpOî$?#ÉøÕÚՄ¿k¢kWYۉQ‡´Ãß1ѱ«CâÔt*ŠNŽï”:ã;!ÄêÄ5åZÔùhü•xÂÿFügñä8ډžFŸqÁ?Þ¥Ä|>ÓÑn67œ-ÀQ-jYÂ÷„ íܳ¼uMHxOu®Yë;ƒñ½Ý{B•© ¡pþÔî†Ðç%¸Ê.¨HSÏ(Qe÷ÔÔÔ´™ÿ`¨N¡©ÅÚ +ߘž2=3Ó;…{¹ASÜ è2óÿ¸¶™«Âc:<Ìl†ÒËC¸ïôŒyjf†¯Á# âx¯Qd9*4#8'¸°÷G¬>õ}œü‡óž»ÜO¿ù1—òV®"¸rm„)/HPÈ 啑x&¹ŠÇU]Íãªâp}üæÓî»<çÿÀ~ôýSì‡|λÛºø'Wûø`‘*„ r ÁaÈ˵Qy¹ùÎ%þE†ïÀ€µÊªRêL:e‡{õ`WÅíÃ획RÚ`MKLVªÒó2½µ·ñfƒœø¢–xäót +'¡À¯\ºîÛ³ð9~ÖIDȕ[F8sÒ¬ÇèmĵµŒÑ—Ú4[©ž)³ªØÝF©Ôè¶Ûʌ2™±Œ¿çYMàs·Ê„GŽà_#D±œª>¡œ‚_n'] ÅañÂB8Awæ”Ä+JÊYpû {¾¸57wëK‡ö¼°­`¾EšY[XX›ŸQ[PX—%%.?ÉþñµÑÑװꩧ°üՍ_eÿôÃ#>ÚÑñè‡GŽüþ‘ööG~æ­ lF.xéræñëÈ$$ÇӍ2X½+^BmTǚ¼å¥Úd3¨õ¬ò9ÿ>J•I?—æ4Q„£©@«È(ЋU†<ÃÆë¹tŽ^üµ€_ü™9î$T<Öåä^R—‡9m½PÁ­‘+ù‘"»eˉ¡ ø²»;A¶-f®Û×ß^ÒÙ0ÜQÔç5N<91õôÖj«cÓ]ßí{¥ÎëfÛÞÂy}ß½÷@óÌèOžV:V¹ +­vߝa AÆ ð ‹k-‘ª‡爑 +½1o‰’Ei$÷ÂW§°É™âp3†Êu9k«33[·¬Ú¹¯rC9ÝÕáò%»f 'Ÿœ>½½ÒÑ1YUv×FϺ‡_—gxº¦’LyņJ]ŠgÆW¼¡&c§¹e¼jâÎü5“%ݽùëk2,]w´x§{¼ª˜ìŽ;};ž²„÷¨d×{4 1À†"¬ +Ol)êdNÎÍwIHìÞk™^=ŸSȔZ5ó?'¼8õm Åі[,û ~ïØá(ÒFƒÑÚ"ǎäósMûð§kÞô'ut7'².^Vm «XX³öÔM¡ˆL‰ºDÆd##T·tpˆÃ—œk½™ì1¹óªÞ +R=#Ä*èd¶‹¤„¤Tê,©Òn}iCßC/¬›zlÀÚÝ ÊëÚN7ìì}ð¸0&Nd ^ezRå1X—ïažÆD \Á“c{þv̞éívÔV[|ÕÙôÙ S *²9—Ñts…! fRÏkә“L÷—ôÕd ùÞչ뾽©¨d뙙ɿÛS_sÿoöÏv™ÔEë<±iyc)e…ö8̔¶Ú›×Újg~·D£Œ+ +žûÛ»kÛ„…?yß½Óènµh‹,j[o£cþ¬,…I8ò/÷”ïÌ©Ã6¸t™rAH‡uzað÷W ¦á}òJ/[Ѿoå ðM'Ù~àæîðƒÞ&ÿLý ¹ó+¢°b9>?J%Îvà+ßc¿Í~÷ñã\yQ†î!ŽÎ’ão?ŽðÈ÷X]¿?>'¿ˆØçyaÓ2&þ| ›ÅŸ‹WpD~á|p0sG¦o¢")ÁTšÅî޸ʜ»éäæÑó{ç»VòHµµÝ=º6ë§sÌúàm¥Ù­ÅtVuon“Ÿž³ºÜàì;xý_9 . +aOdrv€E’å.΅u8¼Ñ„MkǤû‘:üB±X&Uëºæÿ”¬±š˜ü¦ Z›£6¯oɅÈBùä),mÌP¾:ÇXáÐ8mζG>:zôý#uœn9¹¹©Á¹¸FH1ºåòÊ¡” )TeXp¶çYö?2ßÓ¥2¦H¥©Feqò)÷wýì©Kg¦F۔O|ñûñ?Ž‡eñ^f¶:j´û ûåilÀi׫WŸü˜;ëÁÏ~ ëªà ÇËæ2Ì@h¬ÐÁ9úÖB' +¤÷Æ_oéRS¥Ò£ª‹Ú,¾/Z\âf€?dÕ;TY…z?»/(NÎÎ ß·ä¦D²ûúZX´EÖäxåNé¨eKmùæÚÝìfÊᕥd(wÎËÃËrSãÑTikíüÅml·L0¼ä‡<¯ì¾ðZĬ¥½¯EP+x•F–- ‹‘ã…x¥Kiâê&eWXtÿFÍÕçl|?£¸_)‰÷¸q™„2¯0sâ=,«~hÛ¾êzCöºZ Юè"^Ôs¯»Ö6Ø[ ]‡†¨·xÊÃt ®nˆÁ"P̝ÈQáMŽ‡2aÑ­¥aÜ¦³jbs݄9«¡¶:½Šw¤¹ +Šôⱦ-ÝåS"ûÉZN¦]ó¥7eʱŸ‘"£*™Âl‹B¯Þ¸Qí¨Ì`/ÍÿÊñÃêZbW_+÷H\»\ð +ÞQے ›ŠËþ-ÞzF£Ôٙ×CkW?ć]aü¢Àžp‘yÌà[‹# +/W6õ¶œÎ¦¥lÿ¶Ya*He©%ü7á\MT„§ Œ@œd5Pq×åÔ's¯0=ǐ—yÆç¬aÓàiš6 »Üš$¼BThîw²“¢kþcžg"øuâ-¾B¨º¤†çfošbdGϤâ¦ô¯ƒ/áüÚ{‚ 7r$ð%K|çFVäH‚÷֞a~ð4{ýG]]?ƂÐ)ŒCk¯ÿ‡±cÏzÿž6ƒ¡í[ëý{;ŒËó$Å«›6ýÃÒ<éÃGÛۍä˜þ/ó{Ü>Ì_# î@]âü/—þðTuBZ†bìô›¾mæÞ>à™ïÍiÜX¥Õ¯÷¶PTÏSw¯bÏgd'‹— ¤dócl©±ímͦEZ! ÅÁýêìZqñaaââž"L$³Hç² +9ù˺8Šõ8ÞÑ<ûguvvnª¸ªgÿPý_÷p½¾ùR‚˜ªY_˜œRâ÷Œ/µ“—Ÿk½³·BÁöXܙ‰A d øv”§ž¸jlØÜÐ4êՆm›‹cëá\òÞ:ÿ‚´biL»ôtR…ã["uöü¸B9+¸Ò’ÞJ}Vç]]›Ž¬15î=?ºùä¦\­{½[•Û^œYï¢Sv]onzà‚<·m0'¯Ö&÷íé¶êKZí¹­^wºeÝè ½ß-â¯ô2›ÚÜßYä¨±™ëê²Ìk†¶7ôK%O»h6„}»a¹¾9ù(žOŒÌ˜tóšßÃiù¤­Ì”HIfc¨¹èýñT¢©ÌvòêMc§jä†|ýN|ˆÚ©Ï7Èùµt`çïÀZyKüo8Áúª_¦uÁ;>n?ïxyïÞ·X%K5(|ÄËü3·LT{ÆVe…}tRØGÏýnèäd©sâ̝düͽ6÷q×L–©Ÿl"™°Ûÿ=ƒà8Д¡I^‰ãv‘¹RƆ+‘wë<9Çû%Je’”í½À6Fk™ôx;q²7>E%‰^„°-Ž$ã动·¨(‘ÀjØDÈõÙ¯7RAXԈ¤êD¹S6¿_Uæ©J‘{½)ÄxŒ&E-Ö§†m +qõtA ɝ Ë PD(ZJ¬ð­Ø…©·±&A«– Ä +Uì()’nPšÒlé©öåÙ'ØwXv”š±¦iˆÙËJãÄûc’• ”D—€%‚'æ®:ú×4j kú‡³ñOci­Fœgeʜ׻ȗæÜÔe:+9ztÔá”U¤°&ÓÚu]ºÊ©2xî^úëÃ÷`7©npÄÊø̓¹¸Xy3,ŽZ!-v•aʞ ÍJâÓvG{ oËè2jæ{¢·SñjÕó—õÑüõ8CA¶-²§eºÌFCœ2ö”­ê©³ $!)N0:Ïd±›æÏ»­Á`U¬2͢éìÛê*Zσrxû·‰&S#»‘)cå ûß)Þ°^.°× ٗ#ä1²åÇÔÂåӗY5Ü=…½&RFk‹²¯}è(ÖFó¶ÖÈ^#v‡çbÙr·Jìžÿ¹»ØÐXKŸPþå‡0¹Ø!Pgq“Ã÷û©$AnÎ?+×$" ™¸âNgÑš˜Å\ÎmNÒø¡‚KSÓSڑ£7’MˆbåÔfê;¨m@["ί(\rgÅßUk»qù`än‚Âáÿâ.òUá‹=~Oçó¨N\y+¾Y¢+̊S¦ÄËL1Št4{ð»›bôz­8N£ˆË39x´ÏV{äÊw®~zﾔü,µÆQ•a]å¢/¾W·Ã&ËÌ-7\†Ä¹=Û·ÿ»øîŸS½óC”xKÖÃÞÚÄ(Ui8/Š óz1ysr–¥08S%ø~C”ŽÝâÁ]ù#Ì<`C—pGŠu¾8;ÔÝ(mãâ”ö.ÞüjÃçnF¥C]uè7ǎ^:XÕÝ`·»èCa‹Äìù®kӉÀÆÃNŽî^V.°Ýù¨dùŒ;Jò]_ \ËcŞ‹Ò$ü}‰UÃH)ŠÖõ?´ÑåÚô݁ˆ·T‰™ø„X_jOáBüyhõê¡HÐÀʃfJ3™ÙEL‰9¹êàoŽùõªd{eV8ìº~– ‚‚3o\¼ðvþÈÃa"vHI© (¡•̑=uóì¦"ÔoÏw™¢,UØæɌ–;ªÖº·MÞsG”Ê”šž›®Š£”Ƽ´Jþ§?¢ÍêJ‹ +>fóÚT­½ÃYåYÊôÂÚºÊ$ö«+%j1g'EÎôWdìøñýVSq¥†.jÍÉ[•”\ÔWÛ¾sµÕ=ýxß=]}k»uÐ'»G;XcTšœ)ú<»59µ¢}“·íöÖ î7Aoíàf)m§u¹vGjRis ¢soO6Ðkzå‚Z”ÆÝ}çs˜Nœ™ÊQ»3êh©«®'ß;єõPå°Ö­} + ÙkîûcÄ{Ä ñѺUÛ×÷äê+÷³ç÷®ë +ë%bP†ªçâ©Hèi\æK·p®äk´¶¶m­ã±Jõy +¿Ÿ^bÍ®±*’2òӄø¢"='Mv^ûÚøÖ:68?Q¹±!ÓÜ:U‹÷[s5¢àÜI«S- +Fr^ê Á|#×A.È,Ínq8ƑD˜z'S¡Ó¦%°—Ø«l(&ÕäÔÛ»´†8áþdC´ !!ž<geŠñËäeH¨²çΓÛSJØ^::Ù!cï¨øVnRyiN4~8¥0EŸÌѱp !á{@÷Ë+·¤sٚ‹ÉwÌ-“oHe\‰äŸÿ1Y) +¢â¤±kÄ1U^ ~[fѧIÙ//ð§+ìǨõ–4!áӔ•Æ£¤q”0J«¾H¹çOÖÕ¶œb#6«Kd¹Ž`0–qç̽B<1ï#7ÓYIÑÁ ã”9T솦úJµ3ØHÔð:T-§ݜwXJ+¹<嶇ŠZžr㯤ÜäöB‡¿“f·çèÞÂV{3äÛÓ1ۅRmòÌ}‰IE^áü— oçh1Á²æ.»†ø–ˆ±ª£•É“}Iò1CR0“êÌ`Yö®âl.×N¢Íi÷žMÎUs™v\ZŽ»p}~>Re¬2S{pF[¹ÿý8ðRÁýeDŽ„I@$ÿËYØ*ÂR¡/½aò¨Çµv#-Mojn6¤—×tM~;Àl:>\•ÌÞ›¦ÏPµ%^‰0ÁdÐÇÅËãÄ+‘û(‘lª¡êƒ¦Ð<ø/o¿5Ø|¬Öœ°5׿·•Ü“ªOl j­2{¼9èM7¹f…Âi7ˆñýњu”ámØÉ t«Â¿QEþD·x—¦ÀÄU­Y«ˆŠÝ=—Mô°o«ôeLìödrzþñ nk%{¨ƒÜ§seeãFß܃‹wŒˆl„8ÇÊe[‘3÷A²Ü|þ*”÷õB‘2ÔÈö$öwíöY¹;@îGÊ3?~¥ÅR ‹Û¸u˦8]¥ee5OTãÞâº,±ƒfÕbÿá‡GÕ9 ö亭YêmëØÇ Nuø÷|âÑ=á¿óÁŒÌIì9r„•‹¿B_â¢[ÏwåÙð¢Óà<»Œÿë*HŠø‹¿RžžM[¶näéyåÇgiµúvw-  ÚÙàÀ½ënK•i¶®Ã=Ž†õèÇÙÇø?ÚAȲêŠÙÇ«'š!:F©xÍÿ_f_¼Aƒg4´ÂuQ¨0R'‘²p‚Øc}¤.@±h,R"º=RÁøû"u1ÀÏDêQHŽ^‹Ô£‘ ½©Ç -ßøßRiØ©ÇáìÔ%HMJ0ŝH½ÄS‘:FrR©HL¦Dê$òé‘:…ÒÈáH]€’Ƚ‘ºÆ<©CfNþk¤…2¨ØH=õP¹‘z *£iˆE%Ô¯"õ8⸠:R— \ÑcUãÛ&G††§éGv]3>>4 ëÆúmtÅè(ÝÆuMÑm©Àä–À€­i|zœnLŽ VŽ¬ŸÞ6ãƒ}C#cC´•¾9€æF¬hv&§FÆÇèl›#ƒÓµÁ1hæFð¬7ƏLÑ}ôôdß@ Ø7¹‰\JÖWÖ\ô¦F†ÆèŽ@_ÐÓ7ÝGŒMÙx`€Þ°¾1x |¬$€8!¢$)’¡Äÿçm¤„7 %#5Ò ”Š´H6’ñ¯™PäùÜÿá¶ÁZaÏëDyà§\¨b°"TŒÊP9èÚ tԀ Õ¡zX«öÐւZÁjÚÁV:ÁÚW#ØÇ´õ u¨b5? +ÿu±Açÿ‚~R +endstream +endobj +367 0 obj +<< /Type /FontDescriptor +/FontName /b37b0f+NotoSerif-Bold +/FontFile2 366 0 R +/FontBBox [-212 -250 1306 1058] +/Flags 6 +/StemV 0 +/ItalicAngle 0 +/Ascent 1068 +/Descent -292 +/CapHeight 1462 +/XHeight 1098 +>> +endobj +368 0 obj +<< /Length 1278 +/Filter [/FlateDecode] +>> +stream +xœe×ËnÛF†á½®BËtHs&Ã@‘n¼èu{stԒ + ß}ù½¤ikÀÆ/‰œy¾_Ã!}øôôÓÓùtß~»]ês¿ïÇéÜnýíòåVû¾ô—Óyg쾝êýë+þÖ×|ݶ“Ÿßßîýõé<.û‡‡Ýá÷í÷ûí}ÿáÇv)ý‡Ýá×[ë·ÓùeÿáÏOÏÛëç/×ë_ýµŸïûãîñqßúØú9_ɯ}ഏOmûütÿ¸óϼ_ûÞòÚLL½´þv͵ßòù¥ïŽÇLJ1wýÜþó‘9ç)eÔÏù6=n?[i(JKiU:J§ÒSz•2¨Œ”Qe¢L*ÊEåJ¹ªÌ”Ye¡,*+eUÙ(›ÊNÙUÊ-уÁkä5x¼¯‘×à5ò¼F^ƒ×Èkðy ^#¯Ákä5x¼¯‘×à5ò¼F^ƒ×Èkðy ^#¯Åkåµx­¼¯•×âµòZ¼V^‹×ÊkñZy-^+¯Åkåµx­¼¯•×âµòZ¼V^‹×ÊkñZy-^+¯Ãëäux¼¯“×áuò:¼N^‡×Éëð:y^'¯Ãëäux¼¯“×áuò:¼N^‡×Éëð:y^'¯Çëåõx½¼¯—×ãõòz¼^^×Ëëñzy=^/¯Çëåõx½¼¯—×ãõòz¼^^×Ëëñzy=^/oÀä xƒ¼o7à ò¼Aހ7ÈðyÞ oÀä xƒ¼o7à ò¼Aހ7ÈðyÞ oÄåx£¼o”7âÝþj·ùº«üo—‰$‰JI•$’$*I$IT’H’¨$‘$QI"I¢’D’D%‰$‰JI•$’$*I$IT’D’¤$‰$III’’$’$u>áMò&¼Iބ7ɛð&yÞ$o›äMx“¼ o’7áMò&¼Iބ7ɛð&y¼U†o•aÁ[5ñ‚·j¶oS orÁÛ4ۂ·sÞ®>,x»Â/x;³áíê·31ÞÎÄx;ãí +¿âíJ¼âíJ¼â특âíâ¬x»¯x»¯x‡+Þ!Êw¹âB®x‡b®x‡+ށïrÅ;àà2äÍkçΜñJ¼Y³e¼Y†Œ7+|œÆx‹ oSŠŒ7+[ƛețךyÞ¢oVûò浖 -㭌‹·é€"¯åþR¦W*–Ó4Xq”êC™^Jú[(£à®^ƒ1»¢y]•¡Èk¹}¼YM-x e#e®ÊÙ_y+ë¡h܊7k¶:û«/ âåæZå5«dUýµl¼uz5n¥¿[ç¾ÛeBø÷&Si|y»(ô%q& %+S%ñ*Aª¾ÛÊBijPUÃ6\¥h,ž(¶+L¥ºÝ,¥‚4G©5Þ<¥ô…ÂcD› [˧©ñ¡*t› [ jj¼aijü¼IµÙxʪw¹g¶FÉ›wžØ¶¥§Rô>¶Þís¡hâ>½:­O¯VRÇËí¾³P*#àÙi|e0¼Uýí,ì*o§¿Uáûì/ãÎþ*[§¿Uê,”¦Nö¹°•m€lšx°:š&\}M³¹»)üÒðL2„´\%CHËF7æÕ§‰ÇÊ»BŽLÉ…’)æjæ€Æ»J1:%¦H߯:=Së©ÿÛ³zýr»méükÀó¹žÌOçþí¿‡ë媳ôû7±Ùð +endstream +endobj +369 0 obj +[259 600 507 600 600 600 600 600 399 399 600 600 293 310 293 288 559 559 559 559 559 559 559 559 559 559 304 600 559 600 559 549 600 752 671 667 767 652 621 600 600 400 368 733 653 952 788 787 638 600 707 585 652 747 698 1066 731 600 600 414 600 414 600 600 600 599 648 526 648 570 407 560 666 352 345 636 352 985 666 612 645 647 522 487 404 666 605 855 645 579 528 441 559 441 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600] +endobj +370 0 obj +<< /Length1 8892 +/Length 6083 +/Filter [/FlateDecode] +>> +stream +xœ: XSWšçœ„„—@€ +â J€KB!¼ „GÁHÂÃB [[3µJµµS‡¯uÛi·ëXmm›ªÛµ;ÓnÇ>?Çéڎµ~®i;n×m;N·Óv[.ûŸ{/Ètg¾ÝoÁsïÎùÿÿüÿþ×UFÅ¡íH†Ö7·äÍÿ2‡„Õ¶¾ßؑãïüB2ÖÔ}›B Yтâ,ìÇö ŒÄŸÌ!y!B$0à›››N(ý$ìG oéï=Л‚r/BZf0àó+ƒþJØû†e”s²àóŒÁ‘ÐÔ3 Ë^€ù+0֏öù~ë½d„ó.ÂþñßÔބz`¯æLÐ7¸ïêL989c£¡SßÙßCHGñ/ÆÂ_æhaï˜ç!ª+N`¬ƒïíê/ùÅȮ +:³Å¤ ïKm|âç–ËÆdùT~Døtrÿ +êðãec§Å?^aŋ:‘À (1Œ$tã¯ð~[Óäç0ß+¾ñ‡¨“È(Eˆþ|3jÌadG :#ëž ¡N¹ ۙ…]<Œtø+x…^…1à #Mšß cÆ*Ù0f¤ù‹0òa”ÀpÃpÁ(—p:aTK|^†±†UÂ¥8, ­´o•ÖZaôÂȕð:¥7ÅñKòTKü\½ˆ/ݏ‡a”Σ²¥ùNé §ô¶JùèŒ! ž×cþ<ã"9ƒ‹öÒžVÚË]´wžîÃMOQ» +·/^b,€ŠïßÎÿüÁD†ä(B¡ŒŒŠŽ‰]Ÿ Rk´‰à ÉK—-OA©+ÒV2ºt6#SŸ•½juŽåæåsFB…f ²­Y[\Rj+³—;**«ªkjëê MÍ®uîOëÿ~þÿù§­ýÿIF†0Ò8ë]Þpý¦Ž0b˖†9ÞÒaíÎæ|kò–憱¹ŽÍÉ ƒÓí­b;t¹a™ah)¶»¼º°½#7,7PR«»ÝûAʯ:RÏ;›òûŽVŽÈñ†«7uÀ/°¤»37¬0<ŸŽwÃéÌîîî”06JÃó’}a)Ò V1kòsÃQæNzÈkÀ† Ë2ëX&,×ׇ‘Ë;˜ö1(JÑé:R¦…™[œÑ£EéRtÀ1ÆÀ¼+¨k`òÃʜn/ÃÔ°Õ¾Œ—ñoYP¼%ôd8š™fj¦«}ì43Í +DZ”yؘ ]Ût4qÂI¥–êt)̅i0Ձ4­’l:-ÞÀ2¤ÃYÆëlIхq‡wªc§YfºnšõQ‘„¾rà ôÔ ·Š*@õ÷˜¦/Ö·qýbM(©ÆJLßCÍVïg§•aÆå-Iyv´†ȎívžJ@}HxRäV/}º½ìžu¤À ³°¼Ýí=y¬¢Ïq3^a¦/¼,:V¢! «`x䂟Âsw‡ñ>ä Gº¼Ïc|_ÇóÕô6 àhZ7Û;V€Õº½amBsß@v$—Žlr-üf#ڊN¡7Ðeô%NÀzlÁ•Ø…×ãø0~ _'ZRBÆ!?BŽ“·Èeò…¬PÖ$Û);,;+ûXö|¹Ü(¯•÷Ë·Ë÷ËÃò·äW#"ìc;#8q>âK…\¡Vd(8…]TPœRüF©P®V¶)7)÷*(_Q¾«ä#—GEvG‰|#òj”ü&¹ü*ŸæãysR§²&Švl®Z€•B¢3S<È¿29‰í““ÒæpÌ>%ð÷.ýFW‰9†úªÅ Tx¿{¸¥bÅ-©#¤¢ÙsýMlmÂ2‹ .ƍów€6–æ(¨®àfT.Ócäí[~{å–_{Âd01ò Ík‚.`ãS`_`>è Âc”ðHš-1°£¿”7õ\žV³¤Eº>Am´$èÓ {/ûý—ý÷ï*+ÛUF®<ɯòIüøì·÷àî{îá ôÔ4fb!³"ÉïXÁó”‚+ªhÆÆoŽ„Vf{œ®ÉawU}NjjŽ³óÛn‹àOÎiƒSmM1üéåW-èi K£ü .­ÄlVÎÁ"_,U%>]V”¿¢¬­Xm1qÀû#þ"×]N*I.ë]F2ü.–€mÏiù#¶Æ{cÄ؛¯+iFó|2m¥Òѓu³ ÃqÖ2CÁ¨çW]UuÝ!ciϺ@OsC5y¢Ôlt$ÜÚör®»t«µ6uõ­ ­½i.ƒ˜{øü%±»ïÜÃx×Ãä!ð¸AQ±‡|N÷£êp÷kݞ¢5&Wt§Ÿèg¯5—Û]D={É/ÒÎûð·j„vW3{û)ÿSm÷¸Èô¬.wÅ£þóï¢YE ðt¸ÊHA“s£T»œž¼Çñ…Ù7ÈO „xžý”ޏÓ@¿d‘oƒ+ÊLߒ‘¶3Ý#dÄ;s jG:ÿ(¿ðÿŠ7ã>AƽÐ+î‚v‰ÖšHhìí:|øÆ r滏‹d÷}¯ÏҘ0›_‡ji—E÷‚@?(Òk„ð5©‚7n&gŠ¾/’¥ gçôÜ1JŸ V6âý{‹Š`}'QãÙj_˜…5 ÷Tw–Leõ®í“ræQ¢†ú|2Ō[,¥M³P™”7›ï£5=]ƒ_ë2Ö4¹ÝMƒ5n]{Cia~†6­½éä²òUºŠ´úPyqi%^Œ!ß]ƒXHZˆS¢ ¡ðRÿ@O;?Ï·Á}[QfF~I–ï¿+\úB»cßÛ:þGñ¾ùþì ȹ¨F2‰E"Öˆƒ®xmUcSåsQñðäG•…¸c“l``p0µ|ÙÝ{p\<•É*è{ r5pÊ4ZUÀ +8e >.¦d=–çgdÝVöÀ_^¾»¦§ 0uoúÎíÛ¡ýbVŸ¶ Íó:2©ÑR𪅒®+ºV™i¢rÞ+¯*+qÖ;Þ÷û»:ÿoïÉz‹¬×6xA*·oÇÖ}J­íÉú›}’PážçÎMÃ+0õV圲5å2õlJ́nü‚­º×]±$Áâȶñõø©‡™[9O U;…zƒÑRŠçÅJ†œ.ӚD½wnÎå^ +¶ÔþôjüLGÅ'öo¼ÍÝ}»–ϼý~üç_¬ÄÊ®…ü~l§¦µU ­Œ’æTáNñ‰¦UE©Å n÷GsöðÇ°½½x©†ï ×n¤u\C@WE®‹=åÀš­Ð³á*ÏîÐ ‰œ½ŽÏØ Ë[Сp£éW“Uðy­T¡MÞ7»/ó_v®×¦âgm|ì »¼.IßgAÆhú­¥a³h°©àê“OzévŸ%‘7ø/¯]#×øÒ¤>NìM!¶2›Mxåôo¦c³‘Gl‹sŒšZS§³8»ð¦F;8¼;1U§m¢ך¦¢«,õ&¼?+EŗͿþÀ.[fnäǤÜ+Ô&5ÍI&±F$Î3~È]{Ëmn—É^Ž?Í®óñáÁâüñ~àw§îû5ªj”öÇgúúÎôMoµX¶Zˆzÿñ¶m8ÿ‡Î«W…˜Ì€˜TCL&Ò¾YµÐðgYçcòQ·³s0àïårß¾C„Ëä\Úöûîߦ½ñv,¿o¥äûBÞøD˜o¶j*<ï^¸=—ëõ;ü‡Bhßqùí¶ûï۞6Ëáϭı¢‚Âw›Zȏ‰¢Qñ¡-·ºï#êò•|þÐ(Ý­ð ¤k•XªýE­ŠÈ6Ôöuyjš¥ÖÕÅ]õ]uMø|£O­ÝëL«`³s² ªå5k+kµåÉ ß€Ç©Fê ‹ õ ³éOǏ§qù9yÃïwã¯lü‡kõK*¢Ë[ñjÛËbŒ<"…z#f“ùzfÅíp©·6¹ ¥K"ù¤ìÚ ´ ²’êK¤PÇÄâ•eÂ=ãŸi«†^æ:l üÅ>>ò¯Õ±ýu 儫­î·“ZWµ;ۏ ýÐuü,oÖãH±ŽYiË¢ô´aÏtn$ÛxÀ‹-ïòßñß½û.–c¹Ø»f@o‰"iœÐC­2FäöÖ/Zšž[ÄgS?ÁüÍ<¸´çÒ%ʄOq™uaÏõëü±ë ‹ßDl6ÐÌÀø‚~Æ?4Ú0 +0C!³y(4ȌŽ ïÑÉ32êêê󅀑 Àj`¨GFã}C¾áá-98\¼”ÇxjëZC1u‚©Úê*«*™ôò˜§3íužÚæVÓ^îv—7y:òD³HŠ£ +4ŠÆÐ4e} ¢8aZ…He*@kjD9ð¬Fͨ yP À.ä†Y=ªz´_€F ¸Á)Ð$F>àY ܃À“¾Ça= ðÍÎ Z»ÀY¤WŒÈ„rQ!Œùóã´‡q4²Ž +/ ÐøÙC ËZ|À&7õKRLö(<ý0ËCÃTC°Â,à0 óq8‹Ê;;ý°³YÐ(” jÜaÀ‚5?¬ ²ô7%¹ ÀŽOà/â†`—¤ @}Ò-P˜âQ¿@nfà†ièyk³ D-{s>*`2 ǨÀ¡Fð IQڀ„(éÙ#ðKg}°ã͆A–yÎAîoaQkxP-ªübÞGi.úIÌ*ÁW*a%Zµi?ÞíQúf°©G˜—ž”Oð_|ÿ㋽‹ká‚Ü{ÜQîÜ[Ü(@ŸrßÍEîøt²€Û8Ž+oq‡¹#ÜÜ×ÁÎÁíávq÷ÖtDqÁ¨ÛtÜ­?~‚»V;9ÌÝÅõ¶Vlú!·Ñ½j2h\×Ïíä°ÀóVÎ#¬ã=ÊÝÐù¬Û÷@c øÞ r r €ß<:Âë¹þÛtÍL—ÀN+×\*¹^n½„Aþ¶Nhþÿ.ÌýÑ_ûñ +õAyX ýw4äàXÈ«qÐI$@U# ô‰ðí‘ _3Ë .¬€¾w%¦C,ʀº¨GYâ«ÐjÁÁ‘ÁBžBɊŠ èÖ¢bdCeȎâôòªQpÍõðýÐ +4Á•¹ 2¹á"=pympu^¸°NԅºÑ-¨õ¢õèiŒ•“Á!Ž+çĊ77‡Èg* +endstream +endobj +371 0 obj +<< /Type /FontDescriptor +/FontName /61e12f+mplus1mn-regular +/FontFile2 370 0 R +/FontBBox [0 -270 1000 1025] +/Flags 4 +/StemV 0 +/ItalicAngle 0 +/Ascent 860 +/Descent -140 +/CapHeight 860 +/XHeight 0 +>> +endobj +372 0 obj +<< /Length 1278 +/Filter [/FlateDecode] +>> +stream +xœe×ËnÛF†á½®BËtHs&Ã@‘n¼èu{stԒ + ß}ù½¤ikÀÆ/‰œy¾_Ã!}øôôÓÓùtß~»]ês¿ïÇéÜnýíòåVû¾ô—Óyg쾝êýë+þÖ×|ݶ“Ÿßßîýõé<.û‡‡Ýá÷í÷ûí}ÿáÇv)ý‡Ýá×[ë·ÓùeÿáÏOÏÛëç/×ë_ýµŸïûãîñqßúØú9_ɯ}ഏOmûütÿ¸óϼ_ûÞòÚLL½´þv͵ßòù¥ïŽÇLJ1wýÜþó‘9ç)eÔÏù6=n?[i(JKiU:J§ÒSz•2¨Œ”Qe¢L*ÊEåJ¹ªÌ”Ye¡,*+eUÙ(›ÊNÙUÊ-уÁkä5x¼¯‘×à5ò¼F^ƒ×Èkðy ^#¯Ákä5x¼¯‘×à5ò¼F^ƒ×Èkðy ^#¯Åkåµx­¼¯•×âµòZ¼V^‹×ÊkñZy-^+¯Åkåµx­¼¯•×âµòZ¼V^‹×ÊkñZy-^+¯Ãëäux¼¯“×áuò:¼N^‡×Éëð:y^'¯Ãëäux¼¯“×áuò:¼N^‡×Éëð:y^'¯Çëåõx½¼¯—×ãõòz¼^^×Ëëñzy=^/¯Çëåõx½¼¯—×ãõòz¼^^×Ëëñzy=^/oÀä xƒ¼o7à ò¼Aހ7ÈðyÞ oÀä xƒ¼o7à ò¼Aހ7ÈðyÞ oÄåx£¼o”7âÝþj·ùº«üo—‰$‰JI•$’$*I$IT’H’¨$‘$QI"I¢’D’D%‰$‰JI•$’$*I$IT’D’¤$‰$III’’$’$u>áMò&¼Iބ7ɛð&yÞ$o›äMx“¼ o’7áMò&¼Iބ7ɛð&y¼U†o•aÁ[5ñ‚·j¶oS orÁÛ4ۂ·sÞ®>,x»Â/x;³áíê·31ÞÎÄx;ãí +¿âíJ¼âíJ¼â특âíâ¬x»¯x»¯x‡+Þ!Êw¹âB®x‡b®x‡+ށïrÅ;àà2äÍkçΜñJ¼Y³e¼Y†Œ7+|œÆx‹ oSŠŒ7+[ƛețךyÞ¢oVûò浖 -㭌‹·é€"¯åþR¦W*–Ó4Xq”êC™^Jú[(£à®^ƒ1»¢y]•¡Èk¹}¼YM-x e#e®ÊÙ_y+ë¡h܊7k¶:û«/ âåæZå5«dUýµl¼uz5n¥¿[ç¾ÛeBø÷&Si|y»(ô%q& %+S%ñ*Aª¾ÛÊBijPUÃ6\¥h,ž(¶+L¥ºÝ,¥‚4G©5Þ<¥ô…ÂcD› [˧©ñ¡*t› [ jj¼aijü¼IµÙxʪw¹g¶FÉ›wžØ¶¥§Rô>¶Þís¡hâ>½:­O¯VRÇËí¾³P*#àÙi|e0¼Uýí,ì*o§¿Uáûì/ãÎþ*[§¿Uê,”¦Nö¹°•m€lšx°:š&\}M³¹»)üÒðL2„´\%CHËF7æÕ§‰ÇÊ»BŽLÉ…’)æjæ€Æ»J1:%¦H߯:=Së©ÿÛ³zýr»méükÀó¹žÌOçþí¿‡ë媳ôû7±Ùð +endstream +endobj +373 0 obj +[500 500 500 364 500 364 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 364 364 500 500 500 500 500 364 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 364 500 500 500 500 500 500 500 364 364 500 500 500 364 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 1000 500 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364] +endobj +374 0 obj +<< /Length1 6700 +/Length 3800 +/Filter [/FlateDecode] +>> +stream +xœÕ9kl[×yß¹—=l‰²%Y±âèÐגíRmËï©6%‘”h:z‘”I'•I‰—†¯ð^ÊqVÏrS·×Y5'©S,A°YQ,W^á)AÑ:@ƒ>€Î †bÀ0×6¶[ÃY°Ck™ûÎ᥮tÃþìPçÜï}¾ó}ß9÷ÔÁ,ˆñÙwýñº´€$žNGr¢Ñ܄ø-ìë¦gTªÆ¿ °ö+ÂþX.ž>÷þ…ß üŸæñˆ’3þ`#Eý5ñÔ©Øïg~PÿÄÿ-!G¢äïSÿðGØ÷&PwÇÄìoA|K"­>·ñÃ&ĆxK*;øêÿ€y™Ž<—¢ää!N3‘´Dø‚S +Q퇟䰡ƒ#k±ZQƒºZNª‘0uiî™DÑv¢½ùښi@®éê„ùšZkÒ¶I¹y²íူÍup^€ªµlZMlwE¢ÚèXÐålµZC]­Nrr p“ši@3s“4É\‡é|çµâK ˜ +ÛÖD¥häé &FP·(ºŠÅoh 6m»äÔ¶?ÿ/-¸rY딜.ÍƬzǗæñ.OI4c»E¢ÅO—#Ýùh5%¢SLí–On o±è–¨».FJ³SµHÅù5kŠ9FFƒ¨µPzïÅVÍýRH³„ä ¾X÷¸W[?öTPÚÝ4A +þ–¬û[­ ¡ŠÌè£Ø€Àp`L­V¶ð0…ˆ6;,ã¦Z¯€Ãn iB˜q®U8Mƙ­p–ÔÃfÓë 5C»'*¹0Æ/F´Ù)¬§/³TH­î³V«T\×@ØC\–¢Wžh’jÆ j­TÀJa*E Gê>+?î´â ëè Í0;.ÉÖÿf-h€vujC¶rêýAÍáDÀÑsäšßaGHS”tòôiv)§5JýKùdn¹’¾ WÑÕ´Æ _>º–fw9ÙÌÔUdµõ‡fr3yö¥P³è•Æ‚ïBOéÖünÚú×=°BNf¸yk°ÃU FcZ[¸5Š»2Fƒ­VÍB!)(‡XQb4·ßB׬Ü;Mð½>É;v<¸_wºÌ`æ í®ÌHÁÖ²,O­ª½Š…V1„‚$P7R/Žš¹½ +»“鬬û{i´BEÝжS—ìÔå¾Ê¨‘•ÞÀPŚ‰¡hg`¨Õ²–[W§€lªOŒU,C–ØŽ§Ò4ÃI,î-,ª4(ÉRHJPÍ1dkcááуÁó£çÕ¿ +[, X‘]AX05·­uepµAŽ/¡C°=6-VI^_‘—tƒ€ž{4`åîØßÐÊO +V1’;‚e‚5Ã+¦8ïp°jaÅA‹’'Z”|Á^.§ÍéÖçÙ\ëÀK¼þþ®N<øúç%r~lÞAÎûŽßµà ÷¼?xE Â@¸?4¿yÁw)¾W8U`TFde³4ŽH—o}×0˹NàøôN«ªÐL/eš¥Bf(ÓœÆf©%1ƳÞE£,?_ %Šá«qhƈàшt£#š'‚iV#ÉýZ­ÔÏè‡ýp™nbt3Vi&]Ï-.éӖ.|gö5’&%Žv¬GÊ:¤¼ƒ#‹l$•)?Àñøh) •È™±”ÈýÑÅÀè"©_$Éì"éëÅú%¹Õ¨Ý(‡X=Ž„Ô#V²ej¹L-ÎCÙHjVÍ%«á ö»ØEô?zfFš®c¡¿zF‰íð)rñ +9p­o+b·° pÇ78ô1Ž²:~»ˆ32ZEæ:ö»Ø ’ÇÐb ZހÏfÇúÀA©-|›ønãÀm²ï61-”î8Þ¾U?8v‹·Èî[Ät³çFà×=bàÿ$–Ú>øÉcm³Cè½Ù{‚ãê5î7_'õ¯·½.TŸ{L¼{mæ5^µ¼š{uöUC-¼‚ñ¸d¹$ô^¿D—ÈÝK¥K‚ãAŒ^"'æޙûñÜõ9ÃŹ7ænÎݝ+Í.Œ|†×·©Ø·f÷e³âFÒxl}©Íl(µ™Ðwâd¡tÍñR¬f­»M¶ËŽ¨#úfT £Ê ì“Ø×÷¬ Ñmº_/žãXS‹{DŽcbtB< \Ü Ü Gýûqh°¦mû 1U ’Ç{ZÍ=MR°ôÔð *@!ðFýÍzápýõú»õbÎÀ;p ˜ýÙfb$ äåy¿Ïfó.˜Kø6>¥‘óZ»Ž±ãšé¼ãOç ùfè܅ пɫíòµð¦W‹"à`À,–MóÍÐREµñF”Šíâ6P*Ŧ@>(jåÕBaR!“Ê$ +¥p(K¢…²üc”(Ïl6&ocÓ)ì‡D›‚ÝÆHŠ­LÐÃø¿ +Æ«Æ_®þJ5F¸Pb7ˆãýÆûÿ§_ÃUà}ø)LÀ¿sxïAxÃ‹pÏ⏵ëðÏðsÎÏÀ7𮃍Xp·ð·²]‡_A|ÉÖ³ð˜~²ð6|¿!ß\¢E‘v +ÎÁ¼ç-Þÿ‚pèþ‰@$¸ÀgkÐ&@׃¦¨÷!o¯`¼‡{þ«"³9åöža›ÑšrH}›Órp F0ú#x NÃ3à‡^Òg¼zïÏ ©t®À÷ð~ZnãpV‡>„ëb ‡~Ž1`í|‰=L÷ _†Ó›†ÏŒ 4 +U¦FS“駦N Y³ÉìÄ*ø@ø¾ðçèž·ÄI\†›†„=Âvá{ÂBéÙҔñ_x×ÆÊh„ø ‚ÊÎn­âe¬$‘ݾ{¬ íÖkLܽh2‹ß2^ýí‘)Ã'xj¾En™&Åk°–ÅqƒÔ±uÏÞ}=&³µI8{àÐЙ‹Ï : Þ¾ë<ûÊЖ¡WÎ:'¸}…œ¦ÄÞ![˜o&isǞÝ{{vmh6ïî6›š›{ví¦.MÇþt.št{¼q·+>í>!œ~æÂˉطŽ Åܱ˜{(š€üèØÚÓ¼¡Éd–öî³î1žYöãž$ün•›ÈÔÒíØ•›2ÄÊ°€8 Ã"l‡PæK:lÄuÄu؄7vE‡Í°k¾ WáÞü®Wc´ßÓá膿ÕáZhƒ{K·ë'ð]V†×/©øP…¯¡'ÄPØ$æ¶ hîé°u¢E‡E8(>¡Ãhƒ:l„1¥ÃfpŠ›Uðñg:\ ÛÄOt¸ž6lÔáZ8d˜Ñá5Ðkø¯^1|¬Ãu°ÛüõlîT>O¨t׎»è`6OÉԓ™î¦}©g,…ŽËŠœŸ‘£ÝÃY5K}r>—ã…T$ÿd6“UOåP%‰'3qÚE—e–¡ 9¯$³º³{ÇÞý1yß.ÙƘËRIoÍj>•Ó‘ü34[éÊïM²Šè”•dÏQ:’“3eá£eNº‘ÝôáÆ¢IEÍ'§ +¸Š’‘ ÝÜç£ßfÚßçóø:é1h$à§ÇúÆÇû†ý—ŽŒÓ‘a§ÇïFÌMû†CÔëvvR9‰îä©ü\./+ +Íæi2K%Y¨|²üh_i,[^‰’“§“±ä4ME2ñB$Ž«ÈÉùtRa Áüe¢¸þtR¨ggä|†¥ëT¶§´„iUo©•<(ÓùdNUº•dª;›ÛGÜGaß 9<ÁóÄý›À³Â.<wâHa¹Y¤§@F̃ï§iÜ«ú’Âçø’–Â1Ÿ2ښÁ1Š’è­b§àãô$žªL*Žo¶Dò$r3\êúQž%œ8Êfp¤øN¢µó0Ú‡„™UŠ«èƵì]!›äžF°«(A/e>_ßG%b\õç{úhI' ‹óʏXu8ªÜ—·¡êQ[-Ïh¦Ð}ˆåè*˪n¹›çDE™ƒxŠÛá$ÿu£ÔòʺÑ×,ÊÚ—QÖ®[Î"ôpíô³/[PV@_XÜý|5,Ên.¯ò ±Èªh…EZ^ÊC +ŸÓˆgxÝ°uŽò,²Õ$¸¬#{Ÿ#|ÖÌ*ËGWYèDÊÃj`'êÿij(ª¼®¦Ð+U÷¯l3ÂÇ͸|<ï>„)ôsœȁcùa½à“á}Xûã8#î×A +Å]8‚T'×ðp¸Ìsó½6 !|z‘Ãd˜m½*G'ϱç02y^ +÷1ÏבF*‹p¥ªØ>‘ÿWq¥£ìªœ(\gšï:&Iù~ÎðáÅüÌqÓ<–•Œ(zü¢zþÓ|-l',óYÎpÝÌÒî:…´÷¡ ûTÞ­êÕ÷ƒ‚³ÌæøÉÕÍ}Kᓭ1Ž|ù£•ÿ«(ÅØ·àCû—‘àýœˆøºäóٓ)9¦š ™ä®;Ôdñ Ÿ*¤R²ZÙü3@ÿ¢ª¡Tñ¿­3È\ +endstream +endobj +375 0 obj +<< /Type /FontDescriptor +/FontName /8fe72e+NotoSerif +/FontFile2 374 0 R +/FontBBox [-212 -250 1246 1047] +/Flags 6 +/StemV 0 +/ItalicAngle 0 +/Ascent 1068 +/Descent -292 +/CapHeight 1462 +/XHeight 1098 +>> +endobj +376 0 obj +<< /Length 244 +/Filter [/FlateDecode] +>> +stream +xœ]PÁjÃ0 ½û+tlÅN¶ +Á0ºKÝƲ}€c˙a±ãò÷“ÝÒÁï!½§‡ø¹é½ËÀßSÐf°Î›„KX“Fqrž5-§óÕ®g'ñ°-çÞÛ]Çø —œ6Ø=›0âžñ·d09?Áîë<ÖpFŸA0)Á %£‹Š¯jFàUvè Í]Þ¤ùÛøÜ"B[ys £ƒÁ%*Iù Y'„쬕 ½ù7:^£Õß*±®¥E!¨l$թ– §ñ©ÀǺÐVۛA9P^p®×”(sýS [b:÷WÆ‹ªÔ/â3vÁ +endstream +endobj +377 0 obj +[259 1000 200 354 1000 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500 500] +endobj +378 0 obj +<< /Length1 5112 +/Length 3482 +/Filter [/FlateDecode] +>> +stream +xœ½W{P[Wz?犧 !‰‡s¤‹yJp‘gcÂü„ ˆ±  £‡%á,Þµëu¶‰³u¦Mn²“õfÒÝÄM¯ímïl²^o&Τig'ãM3nÉlO&ÙMwÜ$“MèïÉ8MÓÙÿ*8ç~ç{ü¾ÇùÎÑ¡„Mä(ѐ½ƒ#õÖæNÝ „úÀ› xÂzò铄HÝàåÍŒ1©,u„ÔO Ϛ Ïr~\ÿׄh¦ ã÷DÃkk@"ºßAž1¿¸<÷ö†ë„¤Á>ý!Ÿ×3›úï³FÈ~ƒÑì#-Fn»ër_ öÍöw3 X_ÆúÄbhÆSöréØcIºžo†ii…x„=oñù¹¿%$û Äô“p(Óü2XºÏ…#Þ°z«VÙ+Xמ+ÍeE¿þå?Nç´~J6j>àÀ¯/ۄƒëc7~GrÖ6Ó÷5Y<~"‘Äv)¶øe2AyÞ9ô}ôåIpLäžD¨°¤ùä®"¥ŸH?%©­àIȩē¾K¨”‘)mĐRðÿdÒ_Ëi#Œ,k¦Öbd"ÅFÛغ”.# +c#ˆqãF5†c£5IçcØ1Ú1Z’¼zŒÖ$:)³'íª0îÅð$õîØs~NCUJ$‹ÚÑ´¯fñ¿?4Y^´ I!©_g‘.æŒõuæ²ñ®4+{SN®6O§7 Ð…EdsqIé–2füþÿ>*1«D×§Ö ¹Ôރn•Èß(TÓj];܂wØÍ®©TWWhQ©™]W³j-ªdîs¸vÉn£E՘ý…LmrÕ6·EM1sS£l<äºQüOîbè¹V‹ë.–jj­Kí:è·x©æì© ‹šf>o¢'à˜š*V `ÒÍçË«m•aÎÓ²–z‹šif‡¹“WÃTÍÖ™©)½*r­xW<Œ÷îâ±r$VÜá†Dt¹Å¹F n4³7E:YfV¯¦×N¹»Oîò,0›Ý—€àzÙÜ3\³vßJ—G^a+²p'spµ šÈ3Ô6/_Àf“ð´ã­B£±˜½µ‚2À¨ь&c3 +µ³ÌÞJ:—™«o¤Ø¨R·k õÈ+2[éY‘=Ü aÂ5—oCâÖò8‘÷•VøCö,ìýr&ÜTgF+ÇyÙzgå•t• ¹Z‹/C¢7_$m´­£ƒö½˜Kfˆ˜¹ò¨‹Ï—¼ÑËÅxP¹•os¸.à¼ïœé¸@ÅCe3j‘·äŽ/ƒYuÁdAŸ½H×Véc¤OÍr§ô»îó]|7Ô\4šÞ⨻U›r¹U}-!kŸáʐ®£´ s=þjpà ‘)²H¾Kž!×p'Ak¨ƒ¤ß£¯Ò¥|©YÚ-ù¤CҟI?–Þ–~£Ù¢iÓLišӚsÜÐ8Ì8w´F:ƒskÓµ•6­l¤™\½*Y3J."ôÆé»ôIÜ°BÚ4²ƒn>V4ôoš¬ø5jŽ_㺔×¼ô D2q§çÚmiÚܹ"xÅûóŸ{¯ÐFj¸t)þQüÃK—¸îñµ#tyŽß±r3”oNWëþªö؟?qF`Ã´r\8¶&›áÜÓÏ='øÕkoÓ×Q ð3©LéëñŸí¥íÒõÛq8†Ü²ö}Azè°0ismV»!MDAnª æǟ¶moéZý¢¯uÿ&éúUÙTý äÿúɔDC˜ž\_Õ´ ui2d­>?Sg8<.™ÇÇW¯qÝVø»eXTȦ4ƒ¾` 5èeSeS¾ÍÚÜÔXQYG››áŸ¾Ð?ÐpÏPdì_<=ýÖ{j­s#~{PÚWÛXçÜj[}MñµÛ›î-¬_蟘Ý"òÁt±ðêke +µ†Ÿ g¤WKŽC‡sÝHèØub‹t·#¡;ÌJW+¤ë«+|/íˆõ¢”G zøÓø;.ýC¥ôÌp9ˆ‚w%2Ñ&3iíõY¬j®, ÒjzâgéLSU~|ŒÇT…ý~véÜ2ϚŸ›fªÈͳ67V˜Òô§¯ù|×|O-X, )ïhü½£GiIüï¯^‡í½kåôØfâÔ]â à°äâp LÆoËKYí´íû—뫃SQ?½¼1þ£‚—æG¿¥¿)ý3;ŒØ=ˆýy¡Sº¦ôù% ~OÊ)ï¡ï4&z ±þô¿ÿÐãâ6JûºëÈPA3Æ嚅~ïÔt¿£§©®\™ÚsÿÄn½Ò^bÚXÔÛÓ=À\•ÆrVžUØßÖ՗?R”¨µ8OxFÔ ùLò²c£èÅn®¯©­ß6yßü|€~2üûíƜɬÎ)š=üòˉž¼¢4q›´6­€¢»‚½ÞŽý[*K¥ŒxaM¯—Îğj®Ôî +úoÀŽßu¶Äe÷_’'xêÔ©È}qõs)#±×÷ý>îD]BUwã_ìmєO¶j’ZçÛçÙaúhÜA_@þe|—îÞ»$›w¬Ý¦Ñɕrº¬ãÞÜŽ_•F—Ž_¢¯ÆoÇoÿâ4…¦p;ûý¯°Ëà}ȝÚ56²&ù"ÿtüMàýöjÉMO¼ræ‘wÖr˜ÈŸ¿JLIZÂËvU’֐jbNÒ)ønMÒ©8){“tÞ‚Iz#ÙLŽ%élò&y4'tÒ`’¦$‹^HÒÉ /'i qÐW“t +ɗ +“t*)‘ê’ôFÒ(õ&él|_´¾~’bÚ +/Güó¾XÕL5³* - ¿Œºœ#lÈ1Ø»k§ë†@°#´8Û +ƺB‘y/³Ö)lKHXÀ;ë_ +`mµY-#)à6cÞHÔ +²†:¥Ùæi±5{ìsµðâR–}ÐðÅbámõõ‚g™ƒ‹h](:¬[;}þ(ãƟ¯—ECs±<o .úþ˜w–…½‘€?*œ@m>â rn,Ė¢^3›A~fæ βY4ñï[Šy™?fføc>Šˆgh)Æ¡YÿœÆ™yÁõF`x#3~Ïââ2W†‚_fÕ1gwψ(ëëéÜÕÉLí#X›Øx³{pÔÉÆÛŽö§»ß !&Ë$BüdžøH ]3ƒ~aÄJÒ@Z@õ“ZÌ]d '=DXõ’]°w&å $€êÞ"™…v«˜xF€ìˆuÀddÛ:f†aöÂÆO–@%äVbÃIjĸÇÿ´¸ãg –…mHð„fX{D61d·Ôã/j¢ÀœKF…vó,VudNXùÁaë:l}/žG’9H€Ϋoº‹Ð `ÄD6 h<¶€°¿amÀOèÆ e":/Î*Ã$ö…Ó\ëÌ +ۘث}Ѝ‰h¸?®õ€ | xÅï®CB“×8$æ0f€KFÄm½I]¯°ä¾bO" ýÐ]Äßò:rPØý_Z¼NÒMzD§Üé–\':g «NtO'8&¼%Œ$å&<ÇAqûAÔÔ)Öí°q`æ8nR§Œ(AåWʏ”ÿT^SB >Tn¯e|çÃ¥ea-Sy œ×”g•*g•yÅ­HJ‡rRyDyÔÛâÎT‚ó™ŒÊþ'Î* î„B•#Êôh—?pð!eÁQ½T›eF™SŽ)T`îWœ‚OO¦ŸXUèðc÷ïÑ÷QÄáSvC¿nPtاÌ0ÞXi…dT™J§2­ìMjHâ^ŸµÑ×_÷1‰û:wdޚòHö§ï(-¢^]ä>QÙ^ÒGvãD ’aTf•C\¨Î™Äï;ñm°¶F¤ÿõÏf… +endstream +endobj +379 0 obj +<< /Type /FontDescriptor +/FontName /936a7f+mplus1mn-bold +/FontFile2 378 0 R +/FontBBox [0 -275 1000 1042] +/Flags 4 +/StemV 0 +/ItalicAngle 0 +/Ascent 860 +/Descent -140 +/CapHeight 860 +/XHeight 0 +>> +endobj +380 0 obj +<< /Length 1278 +/Filter [/FlateDecode] +>> +stream +xœe×ËnÛF†á½®BËtHs&Ã@‘n¼èu{stԒ + ß}ù½¤ikÀÆ/‰œy¾_Ã!}øôôÓÓùtß~»]ês¿ïÇéÜnýíòåVû¾ô—Óyg쾝êýë+þÖ×|ݶ“Ÿßßîýõé<.û‡‡Ýá÷í÷ûí}ÿáÇv)ý‡Ýá×[ë·ÓùeÿáÏOÏÛëç/×ë_ýµŸïûãîñqßúØú9_ɯ}ഏOmûütÿ¸óϼ_ûÞòÚLL½´þv͵ßòù¥ïŽÇLJ1wýÜþó‘9ç)eÔÏù6=n?[i(JKiU:J§ÒSz•2¨Œ”Qe¢L*ÊEåJ¹ªÌ”Ye¡,*+eUÙ(›ÊNÙUÊ-уÁkä5x¼¯‘×à5ò¼F^ƒ×Èkðy ^#¯Ákä5x¼¯‘×à5ò¼F^ƒ×Èkðy ^#¯Åkåµx­¼¯•×âµòZ¼V^‹×ÊkñZy-^+¯Åkåµx­¼¯•×âµòZ¼V^‹×ÊkñZy-^+¯Ãëäux¼¯“×áuò:¼N^‡×Éëð:y^'¯Ãëäux¼¯“×áuò:¼N^‡×Éëð:y^'¯Çëåõx½¼¯—×ãõòz¼^^×Ëëñzy=^/¯Çëåõx½¼¯—×ãõòz¼^^×Ëëñzy=^/oÀä xƒ¼o7à ò¼Aހ7ÈðyÞ oÀä xƒ¼o7à ò¼Aހ7ÈðyÞ oÄåx£¼o”7âÝþj·ùº«üo—‰$‰JI•$’$*I$IT’H’¨$‘$QI"I¢’D’D%‰$‰JI•$’$*I$IT’D’¤$‰$III’’$’$u>áMò&¼Iބ7ɛð&yÞ$o›äMx“¼ o’7áMò&¼Iބ7ɛð&y¼U†o•aÁ[5ñ‚·j¶oS orÁÛ4ۂ·sÞ®>,x»Â/x;³áíê·31ÞÎÄx;ãí +¿âíJ¼âíJ¼â특âíâ¬x»¯x»¯x‡+Þ!Êw¹âB®x‡b®x‡+ށïrÅ;àà2äÍkçΜñJ¼Y³e¼Y†Œ7+|œÆx‹ oSŠŒ7+[ƛețךyÞ¢oVûò浖 -㭌‹·é€"¯åþR¦W*–Ó4Xq”êC™^Jú[(£à®^ƒ1»¢y]•¡Èk¹}¼YM-x e#e®ÊÙ_y+ë¡h܊7k¶:û«/ âåæZå5«dUýµl¼uz5n¥¿[ç¾ÛeBø÷&Si|y»(ô%q& %+S%ñ*Aª¾ÛÊBijPUÃ6\¥h,ž(¶+L¥ºÝ,¥‚4G©5Þ<¥ô…ÂcD› [˧©ñ¡*t› [ jj¼aijü¼IµÙxʪw¹g¶FÉ›wžØ¶¥§Rô>¶Þís¡hâ>½:­O¯VRÇËí¾³P*#àÙi|e0¼Uýí,ì*o§¿Uáûì/ãÎþ*[§¿Uê,”¦Nö¹°•m€lšx°:š&\}M³¹»)üÒðL2„´\%CHËF7æÕ§‰ÇÊ»BŽLÉ…’)æjæ€Æ»J1:%¦H߯:=Së©ÿÛ³zýr»méükÀó¹žÌOçþí¿‡ë媳ôû7±Ùð +endstream +endobj +381 0 obj +[500 364 500 364 364 364 364 364 500 364 364 364 500 364 500 500 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 500 364 364 364 364 364 500 364 364 364 364 364 364 364 364 364 500 500 364 500 364 364 364 364 364 364 364 364 364 364 500 500 500 500 500 500 500 500 500 500 364 500 364 500 500 500 364 500 500 500 500 500 500 500 500 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364 364] +endobj +382 0 obj +<< /Length1 10908 +/Length 6997 +/Filter [/FlateDecode] +>> +stream +xœ½z XW¶ð½UՋˆÐt7‹¶J5Å"" 4ˆ Ê֍, +H/6ÄAºÙÝØݨ¸ cLPb3YŒq|yã_ÒGљÑø2Ž1Æ8y&3qL4‰Yuô9Æɨ]ýŸ[]­`̛ÿÿ¿ÿû «êœsÏ=û=÷ˆ0B(­E4j¨2ff­ŠÚü*B¸¨ M¶®“ï}…åš²i™—m·}Bcª6«¹«¥ÓóçCˆ~!™¤ÅæéB2øA“Ÿ€ùá-=Í/%!ù9BŠ¯Z6;N¼î€±KpOoB„‘ƒìDÀ[;½+^?@µþ6à{;\M¶šÕ‹ÂaþfÀ­¶]T –Àx)à¬ÓÖéØÔ¹ú €ï"4ª¼Ëåñ2’:Ðã+ºÜŽ.YÂÀ귈øŠ£.Mvïú¯%‘yß¡Ñ ®cW]EÞYÎ]å÷ój™\šŠ($‡;xÁ:É`³ûªZ zV[›>¥ÌÁé…!T,ˆôI‹}2A$ÛFLG›Ø)oömT Æ†´p;g·-¶úhÌí£ }}}Qi¾TNïK]ùyxîðMáô_‘ZQsGOÅ]•Ø'IRplßwÜá._I±‰i’â;DÀo__ ǖô5ôÙk9VÁõ „‡÷u Â¨Ú +³‡7i|%›k}Š†Ve;3³VàeÁª2{ë“$CX`Öð P)dJŸB@"n_—5  9JÉÎä@ ‘cà â¿e­q €MŸâ+M ¦Þdõè(°‰92 L̈́¶HQ›^HŸ/“ëò©¹¢;ù$fڌVaŠ8ͧ.öÁ†(ÎòeôD3kèkÐM ²¸…ÖCH8?ÍjÞСlT«'Ì1ÅPWɆ>«½Ùß ±ÃJkf­­¯ \ËYµ¤Ð B©çAVÐ裊MÖ +#W±°Î:C4$8@Ä1I†{ÄpVMP ”œOž$g­”†®Fظ¢"œ"°¼Ì‡H ̈Ò«Ÿ¬g®Ä‹V´°žû + +ÈZn%˶+³÷qFkžÀ df%Ñ¥D¸ÂT”>šYч]8P€5ÖY)`cÔdÝGaª¸¡¨v Ƭ‡XØ+*E¨„H– DR r_s¨¡µÂ(#¼i#&Ñ0j¤‚4EˆF Ò +¹ Kq­cèßÖNò³º¶µ¯¡–Ô8ŠˆÀ?ìÃÜ\ˆ7wSÒp_ç(òæŠ=ŸÐóƒt)¡Ë 2p NŸ²²OaྋK‡}°p¢ñXTãÇÂ;ÞÑðV#3ÒÃs?ÜVE ”Wá‰Ñ&òÄÔ¾2b|¡‚ôê€y¯ +àÄV0‰0_í7Wûq¤oñãµ~œïÇȯð³~º0¡ZOŒ£€]X$<1Ž,L žÑ@%OŒÃà=Jà…zá¦Ð(8ÎTÃՌxÓ½Ï|³p"`çá¦P><.@W19ºDü¸iÄ +´Ï¸¯`º`ó= +Ä¢;gþXG›ÏaÚüW:¿öàՃTäîüÝÔÎpä ñ/PO<»óYjê3¸ê)ù$î®TÅ{áNqåºæ¹èq8ÎcþÄ|Å,©6]5Q>#~»—Î ‹—Ïñ8Ú£‹6GáH³Bi†ŠÏCæŸG~IåGž‰¼Iç#8Q¢×Ñ$8¯Á<ˆŸ0ÓÒ*eØèdÕøð£¾$#y,¬óIõ!sÝÖŒ¯ÝÐߏŠ&Tø²ŒV_Ã„Ú +Ÿ€¬@1a Õz<ošpaOšy0ҐG¤R‚—‡ "a —Çëõvw×7<ɃHëîNó,ñxàExÈHZܨ_©¾ *áT‹º%$§Gžò˜r¤F[ +\ +lºûDˆWóÍÿ/O“òp G ¿ °-F­¨­ÎÓçàg)üë$:·5£.´!8+ ì»ágøu ¡ß£AV3Ì}ùGÔ×CNw£÷Ñ7øñ;4;Ðz@z?|»}%êâx´M€Æ 22Ý+ŠšEžô°]ÔQd¢hŒ¯ãpÎJiàÇ6°€\]hª¾GèôZƒ®MràöÓ(:ðw´íAƒ?ðè|“~oC'…·¼D$ßüÍ sCBQjJ*M’N“—~@­¢Úe³eå’#’Ô^êe!¦Ñ¸˜sÌ×T•BíEQ¥+¼Zò¥ä{AH üd£äD¡×ÐG8—âÕø0¾DÅPEÔJêõ)=‘¶ÒÓï0ˆÉfžfþ$ “äI¼ð5yCš%],Ý!ý«Œ‘åÉ첗dïÊ¥ò¹r/4šc`_T%M¾ÎUÚ(m.ÜÇè²Û[©ÿFɁ›å­ÌB*…¿I롎á›J"KŒR $CE)ðšÿîǶhþ¢wýÏñçøEj[ÃâmþTþOüQan`;ÿ5õ˜”!sq.s%¹‰J˜Ûù.þßÕx¼_²«~¯ám~GýOž§Îá$\ Ì=Áá™Ð>á㍆ì”äœì麬˜hµt¦üý¢â’™†º#ü%sMâäÉss‹XðÌboNà*ž ­x|r'S`ÆþÞ²¹½eŠ5ó,kJÍB!¡šÀ×ÌX‘£É·;¹ +¤M rH•&r à#5¸ÿ}~ÿ·ƒĦÒ}~ðƟ%§o|Â/ó¯ÂÒopÕ~³ŸªÂË`ÛxŠÿM0^•`o«ä‹H÷VÏÆ2m®.kz®jz.¹„œéÐÍ[ùïåO;•~©¢ÓfÜÉ¥Ê×ýtzÍæ·vIŽÜâ’U5KY9uíå½gÂjò+À9șRr +M@ˆËÅsqNv2—@'„‚BÉ°6 $ëh. _8º­yÑ¥Ü'ÿqâÐ;¯Ýæ³ñÙâ%©–š]xßÞÛÏ,qñ§Ö»_Ù¾e%ï¿À7ÎY¬å_ +æëfàÁŽT’/°9';¨"1wÙD­f¸!ê!™ÃíÑE¯]xíóüçPàw¯:wtëNþØõão[JYùÔ¯Ÿ}Œ:Öú§WógÖ/ß±cãö/"_éýòfw£ÞØõø᝽›IÌ WõÈ’¢ÒÒѬ¥ƒž!-›“­ iKÀTÉ_©½3,ÒzÞ³±ÉöÎçü1þ&ÿü6ٟqhËr'u:‚:˟ªTNãg°oû>ç?~·÷ì{‡Þ +9ôC ž (4ɆgëT±ˆådgb:9E*£µø¹U)î©Q¼4*%·|urç†eÍÑDù?PLÝÊh ã©Ì¥gñüõ‡úŒr‹ef óæ­1éKëäññéÚ]ÿÉoê-0ºûA·AwKÑeA=äd§á\-‹`a¤â$òÖrX£Ù?$zœ’š ;f_Äoò¯¢¬x®åW½Ä_·l¥/‘á?á¯ó+üVü{ìƾ[q?ÐA׃Ž8â—Üu1¤®Wj-‘*ü{!m’–ò²Ûê´(=QƒPü[¼š6 —‰I§äÆQeš™üéߞz`þx]Íò‡'ã°Q!±·¸[b+÷`¾œ”K>„zþäjP©èà + F$˜uN4žÖ±$0©JMƒ%2™1_çOð'ž+õt±²¾ûø¡zÐ4û½ß~ÍÿƒßM4QÛðœ\—PcPۓ ã…j7%‡Š›#µ +cb‡ùÞ]Onù¥íß^îÅá÷ýñWn×ÊíÆ=ÿ¶…ÿÜÿþZ¼÷Å£¯´=òÀ’·:pvµíñ›7/[ÔÛTxù©Ï~Ñ;ÏÔ»òîüDI#Ú—‰9±ØÓ0õ¤üéL•½*³¥:â¿÷Ôì íf]Q{ØÆ„~0¯ˆYºÛŠ›ùmÕéë¡YÁŸç˜z¨¦$PÃQÄbhaY±¹:8Hx¬šM¶ +ü¢®Ì¥.ÙziÍ&¼ӛuE›'ϪKÚúøÎÇ2;^¿¼®ù|"ÎáÀãð§åÙþ®~KkNÞÊ=…Ô…r¾øÛË8ã Ò7sAo +ì±$o¹2N,--•é”:±¦@€•¤{P²¡ÅE8R¹%J…×7Fç„={~e¿“ç·Fϵíûj]א&g6ó½)®ÁÂg7íÅI¿9ÀÆOøEþýù+üÉÞ` ÁWú¢à+¤…|àlÁA….‹Î‰>öÒÅuXÞ¿£Éh*ß2tá ŒÆ$×lùô8ìG»Lsk:7ð¦Óü7Á=€Äp7ø’€ÒGÆé·þe,=…L±E¡Ä=ûB:­>ºÑÛ`¹õò}+ØBŸǒ¸Þë%“†R¤ÄI,¶eé0oÚ¿òON©b.¼ÎoTÿêÛåÈan¯víºAŸÅƒßñm~쟰¦/Àš¾(Mú-G[Ï*.ŸRjƒëtDbu拡œw=kŽJ—ÖäNÿðpøñ˜R&“¿wÛ#ñÝr;…*!EN_øÃ=ïŸMÊєÎ.MzÄkv¤dN¬wÿ7ë<ŠÃTO*©NL§K±ú³Â×V-nÌÌó:ëëþquqòÿuæZVã»÷ +5Ú¸DÕHcá ÄÇUËÿëЯ«Ö)÷ìÌÝpØt7„Îi´rýÜx‹åèþÁ½–ª‡ñ¼e|{(vþ[/}Ï@ìì /zþýãuF‰×_ãT¾$ý•1OHŽÀ +}j!‰O‡ÅvVΉokA&g£|[S¶rXêïÄF'ԈL÷?• +)ú¹·²•¡¢ØN:Ǫ\õ®3gõ+ïA匛•óÐ +Ss +—¶¤í|ºvLF^Ps§BèܙœÍÂóPBcã‚u´¼!TG;gôðߺuÝ©a°{±ûS¬œñØfÝ[ËW†YðÃ"~÷ùPo͇~6â|<_ç(„–MþÕà|}õÐðª_ž|û•÷˜úÞã¯ðóΟÀj|ðÖ5üäu<wÞà¿Î × Ÿ”€Ì ÄØHñpwĝGtŠ¾»á J¾+”Ä¡§…=ýٚü/ùëÝÆQòñª-™E ¯^^×þgŽo·HT–pë +N:²Ÿ¿Ì«2‹´kÌ–P)eøè—Wø¿üœø6Ìú49CÛv§ÏÆ¡ó¾jºÛ*>ùÙ7«7“b­=k*SÊ_ ïRñ›,r£7Ý9ðí:ÇÇ)w·‰Üñš›'Itñ¶Ü@­/çó¾ø§ +¹„¦ztÇòƒâ›‹IJéøš%Cº¿‡-·=-ºfgûn:ç%¾ï¿ILÛ_>Ü¿ÈÓÁžÓ µ‘Lä…Î?¡­G<㇎IâgÆEÛ¢Å6?xã«7_8X6c•ë\ýÒ­Ž³¾gIkZV7-Ð7d:ÿðìá5íE†Þþ#eŽì’Ÿ5>òjWM¯P‹ý°oJJˆýIÁvœÜ,•N¦“qÁåIµr}}Ÿ¨×lW½½´>çû±ß¯ÛiÜ6¿ñʂ%Te Ž¿Ýí\6«+ØOº¡Æö0å™N\ÞÊ\•îž…üêÊ{ØF¼fcª½íïIþ¾?^?«,顇, S¸^wžMª†aÊý/ž³gîżßùdMkzžÛiÊÑ|J·,Lµus¿1aŒ‰œ‹UÉ$ª˜XÝt%ùF ¶N‰G­Q+°nIâhéóçKfVÏÞÄ_ülÞØiñ¿ôÕú­ø±å¥¦òº#‡ù1_ª‰ÌùKR;ä7¾]é L¤*£tлàID§Á +8KñHœ[¥³¥r<úȞ´ˆW>²*[:üü;ñ?áÿCI»Kç[øj> á#rÿEÞ}?¹¬~BÏóü_üözÙ9ÿºà79‡¯‡ƇNáXÔ¬ÂÚà7„øaDãÔØq3ŒåXº!E7S…Û±Kµãò–~؟¨ËÓ(øË»øÓ]|žæ/ɱðx‡eV‰qq®¿Åρ³Ç~8{܄š›q)cu(*[ ›k…Ó‹_VΝÞ¦í,—âhGõôMþ?óoðW;Ìñ¥Vœ„ÇÑó¦Yüò7þ¦]†š½ÿ¸½Žÿ(©%S57Þùcq& +ýá£0À‚0…¤h¦Ó°¢óE˜AQ¨I„%(yEX +µ»V„epR{V„åÐå‰ð(¤Fï‰pÊ@ŸŠðhO~y,Àáh"Ù0Wà"ÆQϑÿ!ÀŒ¬žÚ'©i…S(œNa•ÒSE˜A ô +– 8z›ːžɑ£Éô …&1¬‡¡ÅL©Fs™—E8å1ŸŠðêÉDŽ@Ù²ýÅ®®w[K«—Íš:-‹çrµt8Ø2gS[ØÑÁ֐![ãð8ÜËöŒJ—×Åî¶æ2¯­£­iËéòötÁŒN[K›³…Mgï²°Až,·§Íåd§eLÍÍÊÎmv4¦%}؜6kc½n›ÝÑis?Ⱥš‡›÷Í#ˆz‡§­Åɚ¶N½Íkc[ۜ^0_¤;ìlc{‡ÙdösF«×Û5+3sùòå-‚²Œ&Wgf‹Ã› Ì®ÌaÝâtÁãí¶·¹L­`r‰Ëée®fïr›ÛA|wNèìvÚnÖÛê`eóÙª.‡3È> +endobj +384 0 obj +<< /Length 1278 +/Filter [/FlateDecode] +>> +stream +xœe×ËnÛF†á½®BËtHs&Ã@‘n¼èu{stԒ + ß}ù½¤ikÀÆ/‰œy¾_Ã!}øôôÓÓùtß~»]ês¿ïÇéÜnýíòåVû¾ô—Óyg쾝êýë+þÖ×|ݶ“Ÿßßîýõé<.û‡‡Ýá÷í÷ûí}ÿáÇv)ý‡Ýá×[ë·ÓùeÿáÏOÏÛëç/×ë_ýµŸïûãîñqßúØú9_ɯ}ഏOmûütÿ¸óϼ_ûÞòÚLL½´þv͵ßòù¥ïŽÇLJ1wýÜþó‘9ç)eÔÏù6=n?[i(JKiU:J§ÒSz•2¨Œ”Qe¢L*ÊEåJ¹ªÌ”Ye¡,*+eUÙ(›ÊNÙUÊ-уÁkä5x¼¯‘×à5ò¼F^ƒ×Èkðy ^#¯Ákä5x¼¯‘×à5ò¼F^ƒ×Èkðy ^#¯Åkåµx­¼¯•×âµòZ¼V^‹×ÊkñZy-^+¯Åkåµx­¼¯•×âµòZ¼V^‹×ÊkñZy-^+¯Ãëäux¼¯“×áuò:¼N^‡×Éëð:y^'¯Ãëäux¼¯“×áuò:¼N^‡×Éëð:y^'¯Çëåõx½¼¯—×ãõòz¼^^×Ëëñzy=^/¯Çëåõx½¼¯—×ãõòz¼^^×Ëëñzy=^/oÀä xƒ¼o7à ò¼Aހ7ÈðyÞ oÀä xƒ¼o7à ò¼Aހ7ÈðyÞ oÄåx£¼o”7âÝþj·ùº«üo—‰$‰JI•$’$*I$IT’H’¨$‘$QI"I¢’D’D%‰$‰JI•$’$*I$IT’D’¤$‰$III’’$’$u>áMò&¼Iބ7ɛð&yÞ$o›äMx“¼ o’7áMò&¼Iބ7ɛð&y¼U†o•aÁ[5ñ‚·j¶oS orÁÛ4ۂ·sÞ®>,x»Â/x;³áíê·31ÞÎÄx;ãí +¿âíJ¼âíJ¼â특âíâ¬x»¯x»¯x‡+Þ!Êw¹âB®x‡b®x‡+ށïrÅ;àà2äÍkçΜñJ¼Y³e¼Y†Œ7+|œÆx‹ oSŠŒ7+[ƛețךyÞ¢oVûò浖 -㭌‹·é€"¯åþR¦W*–Ó4Xq”êC™^Jú[(£à®^ƒ1»¢y]•¡Èk¹}¼YM-x e#e®ÊÙ_y+ë¡h܊7k¶:û«/ âåæZå5«dUýµl¼uz5n¥¿[ç¾ÛeBø÷&Si|y»(ô%q& %+S%ñ*Aª¾ÛÊBijPUÃ6\¥h,ž(¶+L¥ºÝ,¥‚4G©5Þ<¥ô…ÂcD› [˧©ñ¡*t› [ jj¼aijü¼IµÙxʪw¹g¶FÉ›wžØ¶¥§Rô>¶Þís¡hâ>½:­O¯VRÇËí¾³P*#àÙi|e0¼Uýí,ì*o§¿Uáûì/ãÎþ*[§¿Uê,”¦Nö¹°•m€lšx°:š&\}M³¹»)üÒðL2„´\%CHËF7æÕ§‰ÇÊ»BŽLÉ…’)æjæ€Æ»J1:%¦H߯:=Së©ÿÛ³zýr»méükÀó¹žÌOçþí¿‡ë媳ôû7±Ùð +endstream +endobj +385 0 obj +[259 600 600 600 600 600 600 600 346 346 600 600 250 600 250 600 559 559 559 559 600 559 600 600 600 600 600 600 600 600 600 600 600 705 600 600 725 600 600 600 600 367 356 600 600 600 600 600 620 600 600 543 612 600 600 600 600 600 600 600 600 600 600 600 600 579 562 486 579 493 317 556 599 304 291 568 304 895 599 574 577 560 467 463 368 599 538 818 545 527 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600 600] +endobj +xref +0 386 +0000000000 65535 f +0000000015 00000 n +0000000275 00000 n +0000000479 00000 n +0000000896 00000 n +0000000947 00000 n +0000001219 00000 n +0000001832 00000 n +0000002128 00000 n +0000002295 00000 n +0000027122 00000 n +0000027986 00000 n +0000032103 00000 n +0000032463 00000 n +0000032507 00000 n +0000032556 00000 n +0000032624 00000 n +0000032802 00000 n +0000032980 00000 n +0000033154 00000 n +0000046891 00000 n +0000047284 00000 n +0000047328 00000 n +0000047501 00000 n +0000047545 00000 n +0000047711 00000 n +0000047882 00000 n +0000048057 00000 n +0000048228 00000 n +0000048401 00000 n +0000048445 00000 n +0000064048 00000 n +0000064441 00000 n +0000064484 00000 n +0000064635 00000 n +0000064786 00000 n +0000064940 00000 n +0000065089 00000 n +0000077098 00000 n +0000077477 00000 n +0000077521 00000 n +0000077565 00000 n +0000077609 00000 n +0000077758 00000 n +0000077934 00000 n +0000077978 00000 n +0000087757 00000 n +0000088125 00000 n +0000088293 00000 n +0000097094 00000 n +0000097449 00000 n +0000106646 00000 n +0000107001 00000 n +0000114249 00000 n +0000114591 00000 n +0000128726 00000 n +0000129132 00000 n +0000129176 00000 n +0000129220 00000 n +0000129409 00000 n +0000129599 00000 n +0000129789 00000 n +0000129954 00000 n +0000129998 00000 n +0000140156 00000 n +0000140498 00000 n +0000150144 00000 n +0000150486 00000 n +0000162840 00000 n +0000163195 00000 n +0000163239 00000 n +0000163283 00000 n +0000174460 00000 n +0000174815 00000 n +0000174859 00000 n +0000174903 00000 n +0000174947 00000 n +0000192239 00000 n +0000192645 00000 n +0000192821 00000 n +0000192995 00000 n +0000193142 00000 n +0000193296 00000 n +0000193340 00000 n +0000198386 00000 n +0000198758 00000 n +0000198802 00000 n +0000198950 00000 n +0000198994 00000 n +0000210908 00000 n +0000211287 00000 n +0000211331 00000 n +0000211897 00000 n +0000212300 00000 n +0000212344 00000 n +0000212493 00000 n +0000212537 00000 n +0000212581 00000 n +0000212734 00000 n +0000212778 00000 n +0000225874 00000 n +0000226243 00000 n +0000226289 00000 n +0000226335 00000 n +0000240726 00000 n +0000241083 00000 n +0000241129 00000 n +0000241175 00000 n +0000248717 00000 n +0000249111 00000 n +0000249157 00000 n +0000249331 00000 n +0000249603 00000 n +0000249872 00000 n +0000249918 00000 n +0000249964 00000 n +0000250144 00000 n +0000250317 00000 n +0000261841 00000 n +0000262248 00000 n +0000262294 00000 n +0000262818 00000 n +0000262864 00000 n +0000263020 00000 n +0000263180 00000 n +0000263335 00000 n +0000263498 00000 n +0000263544 00000 n +0000263715 00000 n +0000276175 00000 n +0000276566 00000 n +0000276612 00000 n +0000276763 00000 n +0000276931 00000 n +0000276977 00000 n +0000277140 00000 n +0000296717 00000 n +0000297164 00000 n +0000297330 00000 n +0000297496 00000 n +0000297658 00000 n +0000297828 00000 n +0000297991 00000 n +0000298157 00000 n +0000298322 00000 n +0000298488 00000 n +0000298653 00000 n +0000298819 00000 n +0000315399 00000 n +0000315788 00000 n +0000315961 00000 n +0000316129 00000 n +0000333245 00000 n +0000333602 00000 n +0000355760 00000 n +0000356117 00000 n +0000374167 00000 n +0000374524 00000 n +0000374570 00000 n +0000374616 00000 n +0000384793 00000 n +0000385150 00000 n +0000385196 00000 n +0000392671 00000 n +0000393028 00000 n +0000393074 00000 n +0000404436 00000 n +0000404793 00000 n +0000404839 00000 n +0000404885 00000 n +0000404931 00000 n +0000405363 00000 n +0000417426 00000 n +0000417809 00000 n +0000417855 00000 n +0000418013 00000 n +0000418168 00000 n +0000433655 00000 n +0000434026 00000 n +0000434073 00000 n +0000456001 00000 n +0000456372 00000 n +0000456418 00000 n +0000456594 00000 n +0000478934 00000 n +0000479305 00000 n +0000479352 00000 n +0000479399 00000 n +0000491414 00000 n +0000491771 00000 n +0000491817 00000 n +0000504444 00000 n +0000504867 00000 n +0000504913 00000 n +0000504959 00000 n +0000505133 00000 n +0000505406 00000 n +0000505677 00000 n +0000505839 00000 n +0000505998 00000 n +0000506044 00000 n +0000506224 00000 n +0000506395 00000 n +0000517945 00000 n +0000518302 00000 n +0000518348 00000 n +0000518394 00000 n +0000518440 00000 n +0000518486 00000 n +0000532492 00000 n +0000532897 00000 n +0000532943 00000 n +0000532989 00000 n +0000533138 00000 n +0000533287 00000 n +0000533429 00000 n +0000533475 00000 n +0000541995 00000 n +0000542339 00000 n +0000561443 00000 n +0000561813 00000 n +0000562002 00000 n +0000562194 00000 n +0000574180 00000 n +0000574537 00000 n +0000574582 00000 n +0000588383 00000 n +0000588754 00000 n +0000588800 00000 n +0000604130 00000 n +0000604487 00000 n +0000604532 00000 n +0000617313 00000 n +0000617670 00000 n +0000617716 00000 n +0000618325 00000 n +0000618371 00000 n +0000618417 00000 n +0000621270 00000 n +0000621627 00000 n +0000621673 00000 n +0000621719 00000 n +0000633477 00000 n +0000633852 00000 n +0000633898 00000 n +0000633944 00000 n +0000633990 00000 n +0000634166 00000 n +0000634212 00000 n +0000634258 00000 n +0000643461 00000 n +0000643836 00000 n +0000643882 00000 n +0000644054 00000 n +0000644100 00000 n +0000644224 00000 n +0000644349 00000 n +0000644476 00000 n +0000644605 00000 n +0000644735 00000 n +0000644866 00000 n +0000644984 00000 n +0000645103 00000 n +0000645225 00000 n +0000645348 00000 n +0000645463 00000 n +0000645580 00000 n +0000645700 00000 n +0000645820 00000 n +0000645944 00000 n +0000646068 00000 n +0000646192 00000 n +0000646317 00000 n +0000646441 00000 n +0000646565 00000 n +0000646680 00000 n +0000646795 00000 n +0000646919 00000 n +0000647043 00000 n +0000647164 00000 n +0000647286 00000 n +0000647414 00000 n +0000647542 00000 n +0000647673 00000 n +0000647804 00000 n +0000647937 00000 n +0000648070 00000 n +0000648200 00000 n +0000648330 00000 n +0000648460 00000 n +0000648591 00000 n +0000648712 00000 n +0000648833 00000 n +0000648960 00000 n +0000649087 00000 n +0000649216 00000 n +0000649345 00000 n +0000649471 00000 n +0000649597 00000 n +0000649726 00000 n +0000649855 00000 n +0000649980 00000 n +0000650105 00000 n +0000650235 00000 n +0000650365 00000 n +0000650481 00000 n +0000650597 00000 n +0000650726 00000 n +0000650855 00000 n +0000650977 00000 n +0000651099 00000 n +0000651229 00000 n +0000651359 00000 n +0000651488 00000 n +0000651617 00000 n +0000651743 00000 n +0000651869 00000 n +0000651992 00000 n +0000652115 00000 n +0000652241 00000 n +0000652367 00000 n +0000652500 00000 n +0000652633 00000 n +0000652711 00000 n +0000652992 00000 n +0000653184 00000 n +0000653513 00000 n +0000653779 00000 n +0000654159 00000 n +0000654319 00000 n +0000654495 00000 n +0000654683 00000 n +0000654843 00000 n +0000655019 00000 n +0000655207 00000 n +0000655369 00000 n +0000655610 00000 n +0000655758 00000 n +0000656015 00000 n +0000656193 00000 n +0000656405 00000 n +0000656662 00000 n +0000656871 00000 n +0000657186 00000 n +0000657452 00000 n +0000657631 00000 n +0000657856 00000 n +0000658057 00000 n +0000658314 00000 n +0000658504 00000 n +0000658795 00000 n +0000659061 00000 n +0000659240 00000 n +0000659505 00000 n +0000659702 00000 n +0000659899 00000 n +0000660212 00000 n +0000660407 00000 n +0000660707 00000 n +0000660908 00000 n +0000661735 00000 n +0000662006 00000 n +0000662277 00000 n +0000674324 00000 n +0000674538 00000 n +0000675893 00000 n +0000676810 00000 n +0000687799 00000 n +0000688018 00000 n +0000689373 00000 n +0000690289 00000 n +0000696463 00000 n +0000696676 00000 n +0000698031 00000 n +0000698947 00000 n +0000702838 00000 n +0000703052 00000 n +0000703372 00000 n +0000704289 00000 n +0000707862 00000 n +0000708072 00000 n +0000709427 00000 n +0000710342 00000 n +0000717431 00000 n +0000717655 00000 n +0000719010 00000 n +trailer +<< /Size 386 +/Root 2 0 R +/Info 1 0 R +>> +startxref +719925 +%%EOF diff --git a/docs/devGuideDB/ltw.adoc b/docs/devGuideDB/ltw.adoc new file mode 100644 index 000000000..3000715a7 --- /dev/null +++ b/docs/devGuideDB/ltw.adoc @@ -0,0 +1,472 @@ +[[ltw]] +== Load-Time Weaving + +[[ltw-introduction]] +=== Introduction + +The AspectJ weaver takes class files as input and produces class files +as output. The weaving process itself can take place at one of three +different times: compile-time, post-compile time, and load-time. The +class files produced by the weaving process (and hence the run-time +behaviour of an application) are the same regardless of the approach +chosen. + +* Compile-time weaving is the simplest approach. When you have the +source code for an application, ajc will compile from source and produce +woven class files as output. The invocation of the weaver is integral to +the ajc compilation process. The aspects themselves may be in source or +binary form. If the aspects are required for the affected classes to +compile, then you must weave at compile-time. Aspects are required, +e.g., when they add members to a class and other classes being compiled +reference the added members. +* Post-compile weaving (also sometimes called binary weaving) is used to +weave existing class files and JAR files. As with compile-time weaving, +the aspects used for weaving may be in source or binary form, and may +themselves be woven by aspects. +* Load-time weaving (LTW) is simply binary weaving defered until the +point that a class loader loads a class file and defines the class to +the JVM. To support this, one or more "weaving class loaders", either +provided explicitly by the run-time environment or enabled through a +"weaving agent" are required. + +You may also hear the term "run-time weaving". We define this as the +weaving of classes that have already been defined to the JVM (without +reloading those classes). AspectJ 5 does not provide explicit support +for run-time weaving although simple coding patterns can support +dynamically enabling and disabling advice in aspects. + +==== Weaving class files more than once + +As of AspectJ 5 aspects (code style or annotation style) and woven +classes are reweavable by default. If you are developing AspectJ +applications that are to be used in a load-time weaving environment with +an older version of the compiler you need to specify the `-Xreweavable` +compiler option when building them. This causes AspectJ to save +additional state in the class files that is used to support subsequent +reweaving. + +[[ltw-rules]] +=== Load-time Weaving Requirements + +All load-time weaving is done in the context of a class loader, and +hence the set of aspects used for weaving and the types that can be +woven are affected by the class loader delegation model. This ensures +that LTW complies with the Java 2 security model. The following rules +govern the interaction of load-time weaving with class loading: + +[arabic] +. All aspects to be used for weaving must be defined to the weaver +before any types to be woven are loaded. This avoids types being +"missed" by aspects added later, with the result that invariants across +types fail. +. All aspects visible to the weaver are usable. A visible aspect is one +defined by the weaving class loader or one of its parent class loaders. +All concrete visible aspects are woven and all abstract visible aspects +may be extended. +. A class loader may only weave classes that it defines. It may not +weave classes loaded by a delegate or parent class loader. + +[[ltw-configuration]] +=== Configuration + +New in AspectJ 5 are a number of mechanisms to make load-time weaving +easy to use. The load-time weaving mechanism is chosen through JVM +startup options. Configuration files determine the set of aspects to be +used for weaving and which types will be woven. Additional diagnostic +options allow the user to debug the configuration and weaving process. + +==== Enabling Load-time Weaving + +AspectJ 5 supports several ways of enabling load-time weaving for an +application: agents, a command-line launch script, and a set of +interfaces for integration of AspectJ load-time weaving in custom +environments. + +Agents:: + AspectJ 5 ships with a load-time weaving agent that enables load-time + weaving. This agent and its configuration is execution environment + dependent. Configuration for the supported environments is discussed + later in this chapter. + + + Using Java 5 JVMTI you can specify the + `-javaagent:pathto/aspectjweaver.jar` option to the JVM. + + + Since AspectJ 1.9.7, the obsolete Oracle/BEA JRockit agent is no + longer part of AspectJ. JRockit JDK never supported Java versions + higher than 1.6. Several JRockit JVM features are now part of HotSpot + and tools like Mission Control available for OpenJDK and Oracle JDK. +Command-line wrapper scripts `aj`:: + The `aj` command runs Java programs in Java 1.4 or later by setting up + `WeavingURLClassLoader` as the system class loader. For more + information, see xref:#aj[???]. + + + The `aj5` command runs Java programs in Java 5 by using the + `-javaagent:pathto/aspectjweaver.jar` option described above. For more + information, see xref:#aj[???]. +Custom class loader:: + A public interface is provided to allow a user written class loader to + instantiate a weaver and weave classes after loading and before + defining them in the JVM. This enables load-time weaving to be + supported in environments where no weaving agent is available. It also + allows the user to explicitly restrict by class loader which classes + can be woven. For more information, see xref:#aj[???] and the API + documentation and source for `WeavingURLClassLoader` and + `WeavingAdapter`. + +[[configuring-load-time-weaving-with-aopxml-files]] +==== Configuring Load-time Weaving with aop.xml files + +The weaver is configured using one or more `META-INF/aop.xml` files +located on the class loader search path. Each file may declare a list of +aspects to be used for weaving, type patterns describing which types +should woven, and a set of options to be passed to the weaver. In +addition AspectJ 5 supports the definition of concrete aspects in XML. +Aspects defined in this way must extend an abstract aspect visible to +the weaver. The abstract aspect may define abstract pointcuts (but not +abstract methods). The following example shows a simple aop.xml file: + +.... + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - -

Guide for Developers of the AspectJ Compiler and Weaver

-

This document is written for developers who want to understand the -implementation of AspectJ. It provides a top-down picture of the compiler -and weaver implementations. This high-level picture should make it easier -to read and understand the source code for AspectJ.

-

The AspectJ compiler/weaver (ajc) is composed of three primary modules.

-
    -
  • org.aspectj.ajdt.core - this is the compiler front-end and - extends the eclipse Java compiler from org.eclipse.jdt.core. - Because of the dependencies on parts of eclipse this generates a large ~6MB jar.
    • -
  • weaver - this provides the bytecode weaving functionality. - It has very few external dependencies to minimize the size required for - deployment of load-time weavers. Currently the build process doesn't - produce a separate jar for just the weaver, but that will have to change for - AspectJ-1.2.
    • -
  • runtime - these are the classes that are used by generated code - at runtime and must be redistributed with any system built using AspectJ. - This module has no external dependencies and produces a tiny ~30KB jar.
    • -
-

-

-

The AspectJ compiler accepts both AspectJ bytecode and source code and -produces pure Java bytecode as a result. Internally it has two stages. The -front-end (org.aspectj.ajdt.core) compiles both AspectJ and pure Java source -code into pure Java bytecode annotated with additional attributes representing -any non-java forms such as advice and pointcut declarations. The back-end of the -AspectJ compiler (weaver) implements the transformations encoded in these -attributes to produce woven class files. The back-end can be run stand-alone to -weave pre-compiled aspects into pre-compiled .jar files. In addition, the -back-end exposes a weaving API which can be used to implement ClassLoaders that -will weave advice into classes dynamically as they are loaded by the virtual -machine.

-

Compiler front-end (org.aspectj.ajdt.core)

-

The front-end of the AspectJ compiler is implemented as an extension of the -Java compiler from eclipse.org. The source-file portion of the AspectJ compiler -is made complicated by inter-type declarations, declare parents, declare soft, -and privileged aspects. All of these constructs require changes to the -underlying compiler to modify Java’s name-binding and static checking behavior.

-

As the compiler extends the jdt.core compiler, the package structure of this -module mimics that of the jdt.core module. The design works hard to minimize the -set of changes required to org.eclipse.jdt.core because a fun 3-way merge is -required each time we want to move to a new underlying version of this code.  -The ultimate goal is to contribute all of our changes to jdt.core back into the -main development branch some day.

-

The basic structure of a compile is very simple:

-
    -
  1. Perform a shallow parse on all source files
    2. -
  2. Pass these compilation units through AjLookupManager to do type binding - and some AspectJ augmentation
  3. For each source file do a deep parse, - annotation/analysis, and then code generation
-

Top-level parse tree

-

Let's trace the following example program through the compiler.

-
package example.parse.tree;
-
-import org.aspectj.lang.*;
-
-public class Main {
-    public static void main(String[] args) {
-        new Main().doit();
-    }
-    
-    private void doit() {
-        System.out.println("hello");
-    }
-}
-
-aspect A {
-    pointcut entries(Main o): execution(void doit()) && this(o);
-    before(Main o): entries(o) {
-        o.counter++;
-        System.out.println("entering: " + thisJoinPoint);
-    }
-
-    private int Main.counter = 0;
-}
-

When parsed, this program will produce the following tree.

-

-

PointcutDeclaration processing

-

Let's look more closely at the pointcut -declaration:

-
pointcut entries(Main o): execution(void doit()) && this(o);
-

-

The pointcut declaration is implemented as a subtype of a method declaration. -The actual pointcut is parsed by the weaver module. This parsing happens -as part of the shallow parse phase. This is because this information might -be needed to implement a declare soft.

-

AdviceDeclaration processing

-

Next we look at the processing for an advice declaration:

-
before(Main o): entries(o) {
-    o.counter++;
-    System.out.println("entering: " + thisJoinPoint);
-}
-

-After parsing, the AdviceDeclaration.postParse method will be called to make this -a valid MethodDeclaration so that the standard eclipse code for analyzing a -method body can be applied to the advice. After postParse, the selector is -filled in and several additional arguments are added for the special -thisJoinPoint forms that could be used in the body.

-

-

-

-At this point the statements field which will hold the body of the advice is -still null. This field is not filled in until the second stage of the -compiler when full parsing is done on each source file as a prelude to -generating the classfile.

-

-Overview of the main classes in org.aspectj.ajdt.core

-

-The main classes in this module are shown in the following diagram:

-

-

-

Weaving back-end (weaver)

-

This provides all of the weaving functionality. It has very few -dependencies to keep the code as small as possible for deployment in load-time -weavers - only asm, bridge and util which are each very small modules with no -further dependencies. This also depends on a patched version of the bcel library from apache.org. -The patches are only to fix bcel bugs that can't be -worked around in any other way.

-

There are only four packages in this system.

-
    -
  • org.aspectj.weaver - general classes that can be used by any weaver - implementation
    • -
  • org.aspectj.weaver.patterns - patterns to represent pointcut designators - and related matching constructs
    • -
  • org.aspectj.weaver.ast - a very small library to represent simple - expressions without any bcel dependencies
    • -
  • org.aspectj.weaver.bcel - the concrete implementation of shadows and the - weaver using the bcel library from apache.org
    • -
-

The back-end of the AspectJ compiler instruments the code -of the system by inserting calls to the precompiled advice methods.  It does -this by considering that certain principled places in bytecode represent -possible join points; these are the “static shadow” of those join points.  For -each such static shadow, it checks each piece of advice in the system and -determines if the advice's pointcut could match that static shadow.  If it could -match, it inserts a call to the advice’s implementation method guarded by any -dynamic testing needed to ensure the match.

-

Runtime support library (runtime)

-

This library provides classes that are used by the generated code at runtime.  -These are the only classes that must be redistributed with a system built using -AspectJ.  Because these classes are redistributed this library must always -be kept as small as possible.  It is also important to worry about binary -compatibility when making changes to this library.  There are two packages -that are considered public and may be used by AspectJ programs.

-
    -
  • org.aspectj.lang
    • -
  • org.apectj.lang.reflect
    • -
-

There are also several packages all under the header org.aspectj.runtime that -are considered private to the implementation and may only be used by code -generated by the AspectJ compiler.

-

-

Mappings from AspectJ language to implementation

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
org.aspectj.ajdt.internal.compilerweaver - org.aspectj.weaver.
aspectast.AspectDeclarationCrosscuttingMembers
adviceast.AdviceDeclarationAdvice + bcel.BcelShadowMunger
pointcut declarationast.PointcutDeclarationResolvedPointcutDefinition
declare error/warningast.DeclareDeclarationChecker + patterns.DeclareErrorOrWarning
declare softast.DeclareDeclaration + - problem.AjProblemReporterAdvice (w/ kind = Softener) + - patterns.DeclareSoft
declare parentsast.DeclareDeclaration + - lookup.AjLookupEnvironmentpatterns.DeclareParents + NewParentTypeMunger
inter-type declsast.InterType*Declaration + lookup.InterType*Binding - + lookup.AjLookupEnvironmentNew*TypeMunger + bcel.BcelTypeMunger
if pcdast.IfPseudoToken + ast.IfMethodDeclarationpatterns.IfPointcut
pcdast.PointcutDesignatorpatterns.Pointcut hierarchy
-

-

Tutorial: implementing a throw join point

-

This tutorial will walk step-by-step through the process of adding a new join -point to AspectJ for the moment when an exception is thrown.  In Java -source code, the shadow of this point is a throw statement. In Java bytecode, -the shadow is the athrow instruction.

-

This tutorial is recommended to anyone who wants to get a better feel for how -the implementation of AspectJ really works.  Even if you're just working on -a bug fix or minor enhancement, the process of working with the AspectJ -implementation will be similar to that described below.  The size of your -actual code changes will likely be smaller, but you are likely to need to be -familiar with all of the pieces of the implementation described below.

-

Part 1: Adding the join point and corresponding pcd

-

The first part of this tutorial will implement the main features of the throw -join point. We will create a new join point shadow corresponding to the athrow -instruction and also create a new pointcut designator (pcd) for matching it.

-

Step 1. Synchronize with repository and run the existing test suite

-

Do a Team->Synchronize With Repository and make sure that your tree is -completely in sync with the existing repository. Make sure to address any -differences before moving on.

-

Run the existing test suite. I currently do this in four steps:

-
    -
  • weaver/testsrc/BcWeaverModuleTests.java
    • -
  • org.aspectj.ajdt.core/testsrc/EajcModuleTests.java
    • -
  • ajde/testsrc/AjdeModuleTests.java
    • -
  • Harness on ajctests.xml -- at least under 1.4, preferably under both 1.3 and -1.4.
    • -
-

There should be no failures when you run these tests. If there are -failures, resolve them with the AspectJ developers before moving on.

-

Step 2. Write a proto test case

-

a. Create a new file in tests/design/pcds/Throw.java

-
import org.aspectj.testing.Tester;
-
-public class Throws {
-    public static void main(String[] args) {
-        try {
-            willThrow();
-            Tester.checkFailed("should have thrown exception");
-        } catch (RuntimeException re) {
-            Tester.checkEqual("expected exception", re.getMessage());
-        }
-    }
-    
-    static void willThrow() {
-        throw new RuntimeException("expected exception");
-    }
-}
-
-aspect A {
-    before(): withincode(void willThrow()) {
-        System.out.println("about to execute: " + thisJoinPoint);
-    }
-}
-

b. Create a temporary test harness file to run just this test in myTests.xml

-
<!DOCTYPE suite SYSTEM "../tests/ajcTestSuite.dtd">
-<suite>
-    <ajc-test dir="design/pcds"
-        title="simple throw join point">
-        <compile files="Throws.java" />
-        <run class="Throws"/>
-    </ajc-test>
-</suite>
-
-

c. Run this test using the harness. You should see:

-
about to execute: execution(void Throws.willThrow())
-about to execute: call(java.lang.RuntimeException(String))
-PASS Suite.Spec(c:\aspectj\eclipse\tests) 1 tests (1 passed) 2 seconds
-

Step 3. Implement the new join point shadow kind

-

Modify runtime/org.aspectj.lang/JoinPoint.java to add a name for the Throw -shadow kind.

-
static String THROW = "throw";
-

Modify weaver/org.aspectj.weaver/Shadow.java to add the Throw shadow kind. -This adds a static typesafe enum for the Throw Kind. The constructor uses the -name from the runtime API to ensure that these names will always match. The '12' -is used for serialization of this kind to classfiles and is part of the binary -API for aspectj. The final 'true' indicates that this joinpoint has its -arguments on the stack. This is because the throw bytecode in Java operates on a -single argument that is a Throwable which must be the top element on the stack. -This argument is removed from the stack by the bytecode. -

-
public static final Kind Throw = new Kind(JoinPoint.THROW, 12, true);
-
-

We also modify the neverHasTarget method to include the Throw kind because in -Java there is no target for the throwing of an exception.

-
public boolean neverHasTarget() {
-    return this == ConstructorCall
-        || this == ExceptionHandler
-        || this == PreInitialization
-        || this == StaticInitialization
-        || this == Throw;
-}
-
-

In the read method on Shadow.Kind, add another case to read in our new -Shadow.Kind.

-
case 12: return Throw;
-
-

Step 4. Create this new kind of joinpoint for the throw bytecode

-

Modify weaver/org.aspectj.weaver.bcel/BcelClassWeaver.java to recognize this -new joinpoint kind. In the method -

private void match(
-    LazyMethodGen mg,
-    InstructionHandle ih,
-    BcelShadow enclosingShadow,
-    List shadowAccumulator) 
-{
-
-

Add a test for this instruction, i.e.

-
} else if (i == InstructionConstants.ATHROW) {
-    match(BcelShadow.makeThrow(world, mg, ih, enclosingShadow),
-          shadowAccumulator);
-}
-
-

Then, modify BcelShadow.java to create this new kind of join point shadow:

-
public static BcelShadow makeThrow(
-        BcelWorld world,
-        LazyMethodGen enclosingMethod,
-        InstructionHandle throwHandle,
-        BcelShadow enclosingShadow) 
-{
-    final InstructionList body = enclosingMethod.getBody();
-    TypeX throwType = TypeX.THROWABLE; //!!! not as precise as we'd like
-    TypeX inType = enclosingMethod.getEnclosingClass().getType();
-    BcelShadow s =
-        new BcelShadow(
-            world,
-            Throw,
-            Member.makeThrowSignature(inType, throwType),
-            enclosingMethod,
-            enclosingShadow);
-    ShadowRange r = new ShadowRange(body);
-    r.associateWithShadow(s);
-    r.associateWithTargets(
-        Range.genStart(body, throwHandle),
-        Range.genEnd(body, throwHandle));                
-    retargetAllBranches(throwHandle, r.getStart());
-    return s;
-}
-

Finally modify weaver/org.aspectj.weaver/Member.java to generate the needed -signature

-
public static Member makeThrowSignature(TypeX inType, TypeX throwType) {
-    return new Member(
-        HANDLER,
-        inType,
-        Modifier.STATIC,
-        "throw",
-        "(" + throwType.getSignature() + ")V");
-}
-

Run the proto test again and you should see:

-
about to execute: execution(void Throws.willThrow())
-about to execute: call(java.lang.RuntimeException(String))
-about to execute: throw(catch(Throwable))
-PASS Suite.Spec(c:\aspectj\eclipse\tests) 1 tests (1 passed) 3 seconds
-
-

That last line shows the 'throw(catch(Throwable))' -join point. This is a slightly confusing string form, but it is the first sign -of our brand new join point. The reason for the weird 'catch(Throwable)' part is -that we used Member.HANDLER for the kind of the signature of this join point. -That's clearly not correct. We'll fix that at the end of the lesson as -part of the clean-up. For now, let's go on with the interesting parts.

-

Step 5. Extend our proto-test to use a pointcut designator for matching

-

Add a second piece of before advice to the test aspect A:

-
before(): throw(Throwable) {
-    System.out.println("about to throw: " + thisJoinPoint);
-}
- -

When we run the test again we'll get a long error message from the harness. -The interesting part of the message is the following:

-
[  0] [error   0]: error can't find referenced pointcut at C:\aspectj\eclipse\tests\design\pcds\Throws.java:23:0
-
-

This error is not quite what you might have expected. You might have -hoped for a syntax error saying that there is not 'throw' pointcut designator -defined. Unfortunately, this is a weakness in the syntax of AspectJ where -primitive PCDs and named PCDs have the same syntax, so the compiler can't tell -the difference between a misspelled or non-existent primitive PCD and a named -PCD reference that is missing. This also has some impact on extending the -primitive PCDs because it will break existing programs. In this case, when -we add the throw PCD we will break any existing programs that use throw as the -name for a user-defined PCD. Fortunately because throw is a Java keyword -this particular change is very safe.

-

Step 6. Extend the PCD parser to handle this new primitive PCD

-

Modify the -parseSinglePointcut method in weaver/org.aspectj.weaver.patterns/PatternParser.java to add one more else if clause for the throw pcd:

-
} else  if (kind.equals("throw")) {
-    parseIdentifier(); eat("(");
-    TypePattern typePat = parseTypePattern();
-    eat(")");
-    return new KindedPointcut(Shadow.Throw,
-        new SignaturePattern(Member.HANDLER, ModifiersPattern.ANY,
-            TypePattern.ANY, TypePattern.ANY, NamePattern.ANY, 
-            new TypePatternList(new TypePattern[] {typePat}), 
-            ThrowsPattern.ANY));
-

Modify the matches method in weaver/org.aspectj.weaver.patterns/SignaturePattern.java -to add:

-
if (kind == Member.HANDLER) {
-    return parameterTypes.matches(world.resolve(sig.getParameterTypes()), 
-                                  TypePattern.STATIC).alwaysTrue();
-}
-

Run the proto test again and you should see:

- -
about to execute: execution(void Throws.willThrow())
-about to execute: call(java.lang.RuntimeException(String))
-about to execute: throw(catch(Throwable))
-about to throw: throw(catch(Throwable))
-PASS Suite.Spec(c:\aspectj\eclipse\tests) 1 tests (1 passed) 1 seconds
-
- -Make sure that you see the 'about to throw' printed before moving on. -This shows that the throw PCD is now successfully matching the throw join point -shadow we added earlier.

Step 7. Check that we're properly providing the -single thrown argument (and clean-up the test)

-

Now that we have a valid pcd for this advice, we can simplify our test case. -Modify our test aspect A to be the following. In addition to removing the -overly generic withincode pcd, this change also prints the actual -object that is about to be thrown:

-
aspect A {
-    before(Throwable t): throw(*) && args(t) {
-        System.out.println("about to throw: '" + t+ "' at " + thisJoinPoint);
-    }
-}
- -

When we run the test again we should see the output below:

-
about to throw: 'java.lang.RuntimeException: expected exception' at throw(catch(Throwable))
-PASS Suite.Spec(c:\aspectj\eclipse\tests) 1 tests (1 passed) 1 seconds
-
-

Congratulations! You've just -implemented the throw join point and PCD. This code isn't yet ready to be checked into any repository. It still -has some rough edges that need to be smoothed. However, you've now -added a new join point to the AspectJ language and a corresponding PCD to match -it. This is a good time to take a break before moving on to part two.

-

Part 2: Getting the signature of this new join point right

-

We know that throw(catch(Throwable)) is not the right thing to be printing -for the signature at this join point. What is the correct signature? -At the beginning of the tutorial, we explained that the preferred design for the -pcd was to have throw(StaticTypeOfExceptionThrown). In step 4, we set the -type of the exception thrown to be 'Throwable'. Can we set this to be more -accurate? Looking at the source code, it seems easy to identify the static -type of the exception that is thrown:

-
throw new RuntimeException("expected exception");
-

In the source code to a Java program there is a well-defined static type for -the exception that is thrown. This static type is used for various stages -of flow analysis to make sure that checked exceptions are always correctly -handled or declared. The ThrowStatement class in our own compiler has a -special field for exceptionType that stores the static type of the exception -thrown. Unfortunately, this static type is much harder to recover from the -corresponding bytecode. In this case we would need to do flow analysis to -figure out what the static type is for the object on the top of the stack -when the athrow instruction executes. This analysis can certainly be done. -In fact this analysis is a small part of what every JVM must do to verify the -type safety of a loaded classfile.

-

However, the current AspectJ weaver doesn't do any of this analysis. -There are many good reasons to extend it in this direction in order to optimize -the code produced by the weaver. If we were really implementing this -feature, this would be the time for a long discussion on the aspectj-dev list to -decide if this was the right time to extend the weaver with the code flow -analysis needed to support a static type for the throw join point. For the -purposes of this tutorial, we're going to assume that it isn't the right time to -do this (implementing flow analysis for bytecodes would add another 50 pages to -this tutorial). Instead we're going to change the definition of the throw -join point to state that its argument always has a static type of Throwable. -We still allow dynamic matching in args to select more specific types. In -general, good AspectJ code should use this dynamic matching anyway to correspond -to good OO designs.

-

Step 1. Change the signature of the throw pcd

-

Since we aren't going to recover the static type of the exception thrown, we -need to fix the parser for the throw pcd to remove this information. We'll -fix the PatternParser code that we added in step 1.6 to read as follows:

-
} else  if (kind.equals("throw")) {
-    parseIdentifier(); eat("(");
-    eat(")");
-    return new KindedPointcut(Shadow.Throw,
-        new SignaturePattern(Member.THROW, ModifiersPattern.ANY,
-            TypePattern.ANY, TypePattern.ANY, NamePattern.ANY, 
-            TypePatternList.ANY, 
-            ThrowsPattern.ANY));
-

Notice that this code also starts to fix the member kind to be Member.THROW -instead of the bogus Member.HANDLER that we were using before. To make -this work we have a set of things to do. First, let's create this new kind -in org.aspectj.weaver.Member. Find where the HANDLER kind is defined -there, and add a corresponding throw kind:

-
public static final Kind THROW         = new Kind("THROW", 8);
-
-

We also need to fix the serialization kind in -Member.Kind.read(DataInputStream) just above this constant list to add a case -for this new kind:

-
case 8: return THROW;
-
-

Still in this file, we also need to fix Member.makeThrowSignature to use this -new kind:

-
public static Member makeThrowSignature(TypeX inType, TypeX throwType) {
-    return new ResolvedMember(
-        THROW,
-        inType,
-        Modifier.STATIC,
-        "throw",
-        "(" + throwType.getSignature() + ")V");
-}
-
-

If you run the test now you'll get an error from the parser reminding us that -the throw pcd now doesn't accept a type pattern:

-
------------  FAIL: simple throw join point()
-...
-C:\aspectj\eclipse\tests\design\pcds\Throws.java:19:0 Syntax error on token "*", ")" expected
-
-FAIL Suite.Spec(c:\aspectj\eclipse\tests) 1 tests (1 failed) 1 seconds
-

This is an easy fix to the test case as we modify our pcd for the new syntax -in the aspect A in our Throws.java test code:

-
before(Throwable t): throw() && args(t) {
-

Now when we run the test case it looks like everything's fixed and we're -passing:

-
PASS Suite.Spec(c:\aspectj\eclipse\tests) 1 tests (1 passed) 2 seconds
-

Part 2. Make a real test case

-

The pass result from running our test should worry you. Unlike previous -runs, this test run doesn't show the output from our System.out.println in the -before advice. So, it's clear this advice is not running. The -problem is that even though the advice is not running, the test case is passing. -We need to make this a real test case to fix this. We'll do that by adding -code that notes when the advice runs and then checks for this event. This -code uses the Tester.event and Tester.checkEvent methods:

-
import org.aspectj.testing.Tester;
-
-public class Throws {
-    public static void main(String[] args) {
-        try {
-            willThrow();
-            Tester.checkFailed("should have thrown exception");
-        } catch (RuntimeException re) {
-            Tester.checkEqual("expected exception", re.getMessage());
-        }
-        Tester.checkEvents(new String[] { "before throw" });
-    }
-    
-    static void willThrow() {
-        throw new RuntimeException("expected exception");
-    }
-}
-
-aspect A {
-    before(Throwable t): throw() && args(t) {
-        Tester.event("before throw");
-        //System.out.println("about to throw: '" + t+ "' at " + thisJoinPoint);
-    }
-}
-

Now when we run our test case it will fail. This failure is good -because we're not matching the throw join point anymore.

-
------------  FAIL: simple throw join point()
-...
-[ 1] [fail 0]: fail [ expected event "before throw" not found]
-
-FAIL Suite.Spec(c:\aspectj\eclipse\tests) 1 tests (1 failed) 1 seconds
-

Step 3. Fix signature matching again

-

In org.aspectj.weaver.patterns.SignaturePattern.matches, we need to handle -throw signature matching the same way we handle advice signature matching. -Both of these pcds match solely on the kind of join point and use combinations -with other pcds to narrow their matches. So, find the line for kind == -Member.ADVICE and add the same line below it for Member.THROW.

-
if (kind == Member.ADVICE) return true;
-if (kind == Member.THROW) return true;
-

This change will make our test case pass again. Run it to be sure.

-

There's an interesting tension between a good automated test and a good test -for development. Our new test case now correctly includes an automated -test to let us know when we are and are not matching the new throw join point. -However, without the println the test doesn't feel as satisfactory to me to run -during development. I often like to turn this kind of printing back on the -see what's happening. If you uncomment to System.out.println in the test -aspect A and rerun the test, you won't be very happy with the results:

-
------------  FAIL: simple throw join point()
-...
-unimplemented
-java.lang.RuntimeException: unimplemented
-    at org.aspectj.weaver.Member.getSignatureString(Member.java:596)
-...
-
-FAIL Suite.Spec(c:\aspectj\eclipse\tests) 1 tests (1 failed) 1 seconds
-

It looks like there's more work to do to add the new member kind for -Member.THROW. This problem only shows up when we try to print -thisJoinPoint. It's showing that we haven't updated the reflection API to -understand this new signature kind.

-

Step 4. Extend org.aspectj.lang.reflect to understand throw signatures

-

We need to add a couple of classes to the reflection API to implement the -throw signature. Because we decided at the beginning of this section to -not include the static type of the exception thrown in the throw signature, -these classes are extremely simple. Nevertheless, we have to build them. -Notice that when we add new source files to the system we need to include the -standard eclipse EPL license header.

-
/* *******************************************************************
- * Copyright (c) 2006 Contributors.
- * All rights reserved. 
- * This program and the accompanying materials are made available 
- * under the terms of the Eclipse Public License v 2.0 
- * which accompanies this distribution and is available at 
- * https://www.eclipse.org/org/documents/epl-2.0/EPL-2.0.txt
- *  
- * Contributors: 
- *     Jim Hugunin    initial implementation 
- * ******************************************************************/
-
-package org.aspectj.lang.reflect;
-import org.aspectj.lang.Signature;
-
-public interface ThrowSignature extends Signature { }
-
/* *******************************************************************
- * Copyright (c) 2006 Contributors.
- * All rights reserved. 
- * This program and the accompanying materials are made available 
- * under the terms of the Eclipse Public License v 2.0 
- * which accompanies this distribution and is available at 
- * https://www.eclipse.org/org/documents/epl-2.0/EPL-2.0.txt
- *  
- * Contributors: 
- *     Jim Hugunin    initial implementation 
- * ******************************************************************/
-
-package org.aspectj.runtime.reflect;
-import org.aspectj.lang.reflect.ThrowSignature;
-
-class ThrowSignatureImpl extends SignatureImpl implements ThrowSignature {
-    
-    ThrowSignatureImpl(Class declaringType) {
-        super(0, "throw", declaringType);
-    }
-    
-    ThrowSignatureImpl(String stringRep) {
-        super(stringRep);
-    }
-
-    String toString(StringMaker sm) {
-        return "throw";
-    }    
-}
-

To finish up our work in the runtime module, we need to extend -org.aspectj.runtime.reflect.Factory to add a factory method for this new -signature kind:

-
public ThrowSignature makeThrowSig(String stringRep) {
-    ThrowSignatureImpl ret = new ThrowSignatureImpl(stringRep);
-    ret.setLookupClassLoader(lookupClassLoader);
-    return ret;
-}
-

We're not done yet. We still need to fix up the -org.aspectj.weaver.Member class to use these new methods and types and fix the -unimplemented exception that started us down this road in the first place. -First let's add a method to create a string for the throw signature. This -is a very simple method copied from the other create*SignatureString methods.

-
private String getThrowSignatureString(World world) {
-    StringBuffer buf = new StringBuffer();
-    buf.append('-'); // no modifiers
-    buf.append('-'); // no name
-    buf.append(makeString(getDeclaringType()));
-    buf.append('-');
-    return buf.toString();
-}
-

Now we need to modify three methods to add cases for the new Member.THROW -kind. First, Member.getSignatureMakerName add:

-
} else if (kind == THROW) {
-    return "makeThrowSig";
-
-

Next, to Member.getSignatureType add:

-
} else if (kind == THROW) {
-    return "org.aspectj.lang.reflect.ThrowSignature";
-
-

Finally, to Member.getSignatureString add:

-
} else if (kind == THROW) {
-    return getThrowSignatureString(world);
-
-

With all of these changes in place we should have working code for -thisJoinPoint reflection using our new join point and signature kinds. -Rerun the test to confirm:

-
about to throw: 'java.lang.RuntimeException: expected exception' at throw(throw)
-PASS Suite.Spec(c:\aspectj\eclipse\tests) 1 tests (1 passed) 1 seconds
-

Step 5. Extend the test for automated coverage of reflection

-

Modify the before advice to include at least minimal checks of the new -reflective information:

-
before(Throwable t): throw() && args(t) {
-    Tester.event("before throw");
-    Tester.checkEqual(thisJoinPoint.getSignature().toShortString(), "throw");
-    Tester.checkEqual(t.getMessage(), "expected exception");
-}
-

As usual, you should rerun the tests and make sure they pass.

-

With these changes to the reflection code, it looks like we have a working -version of the throw join point and there are no obvious pieces that we've -skipped. Take a break before proceeding to the final phase of tests.

-

Part 3: More serious testing

-

Now it's time to get a decent testing story. The test work that we will -do here is probably too little for adding a new join point to the aspectj -language; however, it should at least give you a sense of what's involved.

-

Step 1. Run the test suite again

-

Rerun the tests you ran at the beginning of part 1. Any failures that -occur should be resolved at this point. At the time of writing this -tutorial, I found 31 failures in the BcWeaverModuleTests. These failures -are for all of the test cases that check the exact set of shadows produces by a -given program. These test cases need to be updated based on the new join -point we're adding. These particular test cases will probably be removed -from the AspectJ test suite very soon because they've shown themselves to be -very fragile over time and they often break for changes that are not introducing -new bugs. However, you should be aware of this kind of failure because you -may find it in other unit tests.

-

You should expect to see at least one other test case fail when you run -ajcTests.xml. Here's the failure message:

-
------------  FAIL: validate (enclosing) join point and source locations()
-...
-[  1] [fail   0]: fail [ unexpected event "before AllTargetJoinPoints throw(throw)" found]
-

Most of this message can be ignored. To find out what went wrong you -should look for messages that have "fail" in them. The last line tells you -what happened. There was an unexpected event, "before AllTargetJoinPoints throw(catch(Throwable))". -This is the signature for one of the new throw join points that we added in part -1. How could an existing test case match this new join point? The -failing test case uses 'within(TargetClass)' to collect information about ALL -join points that are lexically within a given class. Whenever we add a new -kind of join point to the language we will extend the set of points matched by -pcds like within. This means that these changes need to be very -prominently noted in the release notes for any AspectJ release. Since -we're not writing documentation in this tutorial, we will move on an fix the -test case.

-

Step 2. Fix the failing test case

-

Now we need to fix this failing test case. The first step is to copy -the test specification into our local myTests.xml file. The easiest way to -do this is to copy the title of the failing test from the output buffer, then -open ajcTests.xml and use find to search for this title. Then copy the xml -spec for this one test into myTests.xml. Finally, run myTests.xml to make -sure you got the failing test. You should see the same failure as before -in step 1, but you should see it a lot faster because we're only running 2 -tests.

-

To fix the test we need to find the source code. If you look at the -test specification, you can see that the source file is the new directory with -the name NegativeSourceLocation.java. Looking at the bottom of this file, -we see a large list of expected events. These are the join points that we -expect to see. If we look back up in TargetClass, we can see that the only -occurence of throw is just before the handler for catch(Error) and right after -the call to new Error. We should add our new expected event between these -two:

-
, "before AllTargetJoinPoints call(java.lang.Error(String))"
-, "before AllTargetJoinPoints throw(throw)"  // added for new throw join point
-, "before AllTargetJoinPoints handler(catch(Error))"
-

Run the test suite again to see that this test now passes.

-

Step 3. Extend test coverage to after advice

-

There is a lot we should do now to extend test coverage for this new kind of -join point. For the purpose of this tutorial, we're just going to make -sure that the new join point kind is compatible with all 5 kinds of advice. -Let's extend our current simple Throws test to check for before and the three -kinds of after advice:

-
import org.aspectj.testing.Tester;
-
-public class Throws {
-    public static void main(String[] args) {
-        try {
-            willThrow(true);
-            Tester.checkFailed("should have thrown exception");
-        } catch (RuntimeException re) {
-            Tester.checkEqual("expected exception", re.getMessage());
-        }
-        Tester.checkEvents(new String[] 
-            { "before throw", "after throwing throw", "after throw" });
-    }
-    
-    static void willThrow(boolean shouldThrow) {
-        int x;
-        if (shouldThrow) throw new RuntimeException("expected exception");
-        else x = 42;
-        System.out.println("x = " + x);
-    }
-}
-
-aspect A {    
-    before(Throwable t): throw() && args(t) {
-        Tester.event("before throw");
-        Tester.checkEqual(thisJoinPoint.getSignature().toShortString(), "throw");
-        Tester.checkEqual(t.getMessage(), "expected exception");
-    }
-    
-    after() returning: throw() {
-        Tester.checkFailed("shouldn't ever return normally from a throw");
-    }
-    
-    after() throwing(RuntimeException re): throw() {
-        Tester.event("after throwing throw");
-        Tester.checkEqual(re.getMessage(), "expected exception");
-    }
-    
-    after(): throw() {
-        Tester.event("after throw");
-    }
-}
-

Run this test to confirm that it still passes. This is a very nice -property of the orthogonality of the implementation of join points and advice. -We never had to do any implementation work to make our new join point kind work -for before and all three kinds of after advice.

-

Step 4. Look at around advice on throw join points

-

Let's create a new test case to see how this new join point interacts with -around advice.

-
import org.aspectj.testing.Tester;
-
-public class AroundThrows {
-    public static void main(String[] args) {
-        try {
-            willThrow(true);
-            Tester.checkFailed("should have thrown exception");
-        } catch (RuntimeException re) {
-            Tester.checkEqual("expected exception", re.getMessage());
-        }
-    }
-    
-    static void willThrow(boolean shouldThrow) {
-        int x;
-        if (!shouldThrow) x = 42;
-        else throw new RuntimeException("expected exception");
-        System.out.println("x = " + x);
-    }
-}
-
-aspect A {    
-    void around(): throw() {
-        System.out.println("about to throw something");
-        proceed();
-    }
-}
-

When we run this test case we get a very unpleasant result:

-
------------  FAIL: simple throw join point with around()
-...
-[  1] --- thrown
-java.lang.VerifyError: (class: AroundThrows, method: willThrow signature: (Z)V) Accessing value from uninitialized register 1
-...
-FAIL Suite.Spec(c:\aspectj\eclipse\tests) 3 tests (1 failed, 2 passed) 3 seconds
-
-

A VerifyError at runtime is the second worst kind of bug the AspectJ compiler -can produce. The worst is silently behaving incorrectly.

-

Unfortunately, this VerifyError is either impossible or very hard to fix. -Think about what would happen if the around advice body didn't call proceed. -In this case the local variable x would in fact be uninitialized. There is -another serious language design question here, and for a real implementation -this would once again be the time to start a discussion on the aspectj-dev -mailing list to reach consensus on the best design. For the purpose of -this tutorial we're once again going to make the language design choice that is -easiest to implement and press on.

-

Step 5. Prohibit around advice on this new join point kind

-

The easiest solution to implement is to prohibit around advice on throw join -points. There are already a number of these kinds of rules implemented in -the org.aspectj.weaver.Shadow.match(Shadow, World) method. We can add our -new rule at the beginning of the if(kind == AdviceKind.Around) block:

-
} else if (kind == AdviceKind.Around) {
-     if (shadow.getKind() == Shadow.Throw) {
-         world.showMessage(IMessage.ERROR,
-             "around on throw not supported (possibly compiler limitation)", 
-             getSourceLocation(), shadow.getSourceLocation());
-         return false;
-     }
-

Now if we rerun our test we'll see errors telling us that around -is prohibited on throw join points:

-
------------  FAIL: simple throw join point with around()
-...
-[  0] [error   0]: error at C:\aspectj\eclipse\tests\design\pcds\AroundThrows.java:22 around on throw not supported (possibly compiler limitation)
-[  0] [error   1]: error at C:\aspectj\eclipse\tests\design\pcds\AroundThrows.java:16 around on throw not supported (possibly compiler limitation)
-...
-FAIL Suite.Spec(c:\aspectj\eclipse\tests) 3 tests (1 failed, 2 passed) 3 seconds
-

To finish this test case up we need to modify the specification to be looking -for these errors as the correct behavior. This will produce the following -specification:

-
<ajc-test dir="design/pcds"
-  title="simple throw join point with around">
-    <compile files="AroundThrows.java">
-        <message kind="error" line="16"/>
-        <message kind="error" line="22"/> 
-    </compile>
-</ajc-test>
-

Run myTests.xml one last time to see both tests passing.

-

Step 6. Final preparations for a commit or patch

-

You probably want to stop here for the purposes of this tutorial. We've -pointed out several language design decisions that would need to be resolved -before actually adding a throw join point to AspectJ. Some of those might -involve a large amount of additional implementation work. If this was -actually going into the tree, it would also be important to add several more -test cases exploring the space of what can be done with throw.

-

Assuming those issues were resolved and you are ready to commit this new -feature to the tree there are three steps left to follow:

-
    -
  1. Move our new test specifications from myTests.xml to the end of - ajcTests.xml
    2. -
  2. Rerun ajcTests.xml and the unit tests to ensure everything's okay.
    3. -
  3. Update from the repository to get any changes from other committers - since you started work on this new feature.
    4. -
  4. Rerun ajcTests.xml and the unit tests to make sure nothing broke as a - result of the update.
    5. -
  5. Finally you can commit these changes to the AspectJ tree.
    6. -
- - - diff --git a/docs/developer/index.adoc b/docs/developer/index.adoc new file mode 100644 index 000000000..aa347182e --- /dev/null +++ b/docs/developer/index.adoc @@ -0,0 +1,24 @@ += AspectJ Design Overview +:doctype: book + +Here are some sobering words: + +"Although it is essential to upgrade software to prevent aging, changing software can cause a different form of +aging. The designer of a piece of software usually had a simple concept in mind when writing the program. If the +program is large, understanding the concept allows one to find those sections of the program that must be altered +when an update or correction is needed. Understanding that concept also implies understanding the interfaces used +within the system and between the system and its environment. Changes made by people who do not understand the +original design concept almost always cause the structure of the program to degrade. Under those circumstances, +changes will be inconsistent with the original concept; in fact, they will invalidate the original concept. Sometimes +the damage is small, but often it is quite severe. After those changes, one must know both the original design rules +and the newly introduced exceptions to the rules, to understand the product. After many such changes, the original +designers no longer understand the product. Those who made the changes, never did. In other words, *nobody* +understands the modified product." + + + +Software that has been repeatedly modified (maintained) in this way becomes very expensive to update. Changes take +longer and are more likely to introduce new 'bugs'." +-- David Parnas on "Ignorant Surgery" in his paper on Software Aging + +include::compiler-weaver/index.adoc[Guide for Developers of the AspectJ Compiler and Weaver] +include::modules.adoc[Module Structure] +include::language.adoc[Language Design] diff --git a/docs/developer/index.html b/docs/developer/index.html deleted file mode 100644 index b01526817..000000000 --- a/docs/developer/index.html +++ /dev/null @@ -1,176 +0,0 @@ - - - - - - - -AJDT Project Proposal - - - - - -

AspectJ Design Overview

- -

Contents

- - -

Here are some sobering words from David Parnas on -"Ignorant Surgery" in his paper on Software Aging:

-

"Although it is essential to upgrade software to -prevent aging, changing software can cause a different form of aging. The -designer of a piece of software usually had a simple concept in mind when -writing the program. If the program is large, understanding the concept allows -one to find those sections of the program that must be altered when an update or -correction is needed. Understanding that concept also implies understanding the -interfaces used within the system and between the system and its environment.  -Changes made by people who do not understand the original design concept almost -always cause the structure of the program to degrade. Under those circumstances, -changes will be inconsistent with the original concept; in fact, they will -invalidate the original concept. Sometimes the damage is small, but often it is -quite severe. After those changes, one must know both the original design rules -and the newly introduced exceptions to the rules, to understand the product. -After many such changes, the original designers no longer understand the -product. Those who made the changes, never did. In other words, *nobody* -understands the modified product.
-Software that has been repeatedly modified (maintained) in this way becomes very -expensive to update. Changes take longer and are more likely to introduce new -'bugs'."

- - - - \ No newline at end of file diff --git a/docs/developer/language.adoc b/docs/developer/language.adoc new file mode 100644 index 000000000..c97ef8d11 --- /dev/null +++ b/docs/developer/language.adoc @@ -0,0 +1,81 @@ +== AspectJ Language Design + +=== User-suggested New Language Features + +* `-` wildcard +** http://dev.eclipse.org/mhonarc/lists/aspectj-dev/msg00717.html +** https://bugs.eclipse.org/bugs/show_bug.cgi?id=34054#c2 + +* Class cast pointcut +** http://dev.eclipse.org/mhonarc/lists/aspectj-users/msg01479.html + +* Extensible pointcuts, abstract pointcuts, and interfaces +** http://dev.eclipse.org/mhonarc/lists/aspectj-dev/msg00458.html +** http://dev.eclipse.org/mhonarc/lists/aspectj-dev/msg00467.html + + +=== Key Language Design Properties + +==== Orthogonal join point model + +The different kinds of join +points, the different primitive pointcuts, and the different kinds of +advice can be used in any combination. + +This was one of the hardest parts of the design to get right, because of +the "constructor must call super" rule in Java. But we finally got this +in 1.0. + +==== Pointcuts support composition and abstraction + +Abelson and Sussman +say that composition and abstraction are the key elements of a real +language. Clearly the pointcut mechanism is the new thing in AspectJ, +and so it was critical that it support composition and abstraction. The +fact that someone can write: + +[source, java] +---- +/* define an abstraction called stateChange */ +pointcut stateChange(): call(void FigureElement+.set*(*)); + +/* compose pointcuts to get other pointcuts */ +pointcut topLevelStateChange(): stateChange() && !cflowbelow(stateChange()); +---- + +is what makes it possible for people to really work with crosscutting +structure and make their code more clear. + +==== Statically type checked + +The efficiency, code quality and programmer +productivity arguments for this have been made elsewhere, so I won't +repeat them. + +==== Efficient + +AspectJ code is as fast as the equivalent functionality, +written by hand, in a scattered and tangled way. + +==== Simple kernel + +I've heard some people say that AspectJ is too big +and too complex. In the most important sense of simple AspectJ is +simple. I can reason about any AspectJ program with a simple model. The +kernel of AspectJ is simple, and the orthogonality described above means +that its easy to start with just the kernel and slowly add to that. + +Its pretty clear to pull out this kernel of AspectJ. I would argue that +the right idea for a standard AOP API +is this kernel, packaged in a way that allows building more +sophisticated tools on top of it. + +==== Supports multiple weave times + +AspectJ is neutral on whether weaving +happens at pre-process, compile, post-process, load, JIT or runtime. +This neutrality is critical. Its why there are serious JVM experts who +are already thinking about JVM support for AspectJ. + +There's more, but I think these are the most important ones. I think any +functionality this group comes up with should also meet these +criteria. diff --git a/docs/developer/language.html b/docs/developer/language.html deleted file mode 100644 index e047dc87c..000000000 --- a/docs/developer/language.html +++ /dev/null @@ -1,220 +0,0 @@ - - - - - - - -AJDT Project Proposal - - - - - -

AspectJ Language Design

- -

User-suggested New Language Features

- -

Key Language Design Properties

-

(1) Orthogonal join point model - the different kinds of join points, the -different primitive pointcuts, and the different kinds of advice can be used in -any combination.

-

This was one of the hardest parts of the design to get right, because of the -"constructor must call super" rule in Java. But we finally got this in 1.0.
-
-(2) Pointcuts support composition and abstraction. Abelson and Sussman say that -composition and abstraction are the key elements of a real language. Clearly the -pointcut mechanism is the new thing in AspectJ, and so it was critical that it -support composition and abstraction. The fact that someone can write:

-
-

/* define an abstraction called stateChange */
- pointcut stateChange(): call(void FigureElement+.set*(*));
-
- /* compose pointcuts to get other pointcuts */
- pointcut topLevelStateChange(): stateChange() `
- && !cflowbelow(stateChange());

-
-

is what makes it possible for people to really work with crosscutting -structure and make their code more clear.
-
-(3) Statically type checked. The efficiency, code quality and programmer -productivity arguments for this have been made elsewhere, so I won't repeat -them.
-
-(4) Efficient. AspectJ code is as fast as the equivalent functionality, written -by hand, in a scattered and tangled way.
-
-(5) Simple kernel. I've heard some people say that AspectJ is too big and too -complex. In the most important sense of simple AspectJ is simple. I can reason -about any AspectJ program with a simple model. The kernel of AspectJ is simple, -and the orthogonality described above means that its easy to start with just the -kernel and slowly add to that.

-

Its pretty clear to pull out this kernel of AspectJ. I would argue that the -right idea for a standard AOP API
-is this kernel, packaged in a way that allows building more sophisticated tools -on top of it.
-
-(6) Supports multiple weave times. AspectJ is neutral on whether weaving happens -at pre-process, compile, post-process, load, JIT or runtime. This neutrality is -critical. Its why there are serious JVM experts who are already thinking about -JVM support for AspectJ.

-

There's more, but I think these are the most important ones. I think any -functionality this group comes up with should also meet these criteria.
- 

- - - - \ No newline at end of file diff --git a/docs/developer/modules.adoc b/docs/developer/modules.adoc new file mode 100644 index 000000000..b6ea33d62 --- /dev/null +++ b/docs/developer/modules.adoc @@ -0,0 +1,108 @@ +== AspectJ Modules + +There are a number of different structures [Parnas]: "the module structure, the uses structure, the runtime structure, +..." This document overviews module structure and summarizes what is hidden by each. For detailed documentation refer to +the individual module sources and docs available via CVS. + +=== Core Modules + +*CVS Location:* dev.eclipse.org:/cvsroot/technology/org.aspectj/modules + +To set up for building, one need only check out the module directories within the `modules/` directory. In Eclipse, +check out each module into the workspace as a project. (Note: module dependencies may change at any time, so this +documentation might be out of date. The Eclipse .classpath files specify the module dependencies, even when using Ant to +build outside of Eclipse.) + +|=== +| *Module* | *Dependencies* | *Description* + +| ajbrowser | ajde, asm, bridge, util, taskdefs (pseudo, for build system) | This module contains the ajbrowser +application. It depends on the ajde module for access to the aspectj compiler, and also for the swing user interface +components that ajde provides. + +| ajde | asm, bridge, org.aspectj.ajdt.core, org.eclipse.jdt.core, util | Hides the details of accessing the AspectJ +compiler and interpreting compilation results (error messages, structure model, etc.) from other applications (typically +IDEs) that need to invoke it programmatically. Changing any public interface in ajde can break all the IDE integration +projects and should be done with care. + + + +It also contains a library of common swing user interface components that can be used by any swing based IDE. Ajbrowser +and the non-eclipse IDE integration projects use this library (except for the emacs support). + +| asm | bridge | Contains the Abstract Structure Model, which represents the result of an aspectj compilation. Clients +of ajde are returned an instance of the structure model which allows them to navigate and interpret the static structure +of an aspectj program. + +| bridge | util | Contains an interface and implementation of classes realted to compiler messages including: source +locations, handling, and formatting. Intended to minimize dependencies between testing, the compiler, and +ajde. + +| org.aspectj.ajdt.core | asm, bridge, org.eclipse.jdt.core, runtime, testing-util, util, weaver | Front-end of the +AspectJ compiler and extension of Eclipse's JDT compiler. Extends the JDT compiler's parsing and name resolution to +understand AspectJ declarations. Also extends incremental behavior with understanding of AspectJ dependencies. + +| org.eclipse.jdt.core | | The Eclipse JDT compiler, slightly patched for AspectJ and stored in binary form to avoid +accidental changes. Sources are available in CVS at dev.eclipse.org:/cvsroot/technology/org.aspectj/shadows. + +| runtime | | Small runtime library required for building and running AspectJ programs + +| taskdefs | bridge, org.aspectj.ajdt.core, util | Ant taskdef for the AspectJ compiler/weaver, ajc. + +| util | | Common utility classes including data type, file, and stream manipulation + +| weaver | asm, bridge, runtime, testing-util, util | Back-end of the AspectJ compiler, built on top of the BCEL +bytecode toolkit. All advice planning and weaving is done here. Takes an aspect bytecode format and other Java +classfiles as input. +|=== + +=== Supporting Modules + +*CVS Location:* dev.eclipse.org:/cvsroot/technology/org.aspectj/modules + +|=== +| *Module* | *Description* +| build | Ant files, scripts, taskdefs required for building the AspectJ distribution. Also contains the GUI installer. +| docs | Programmer and developer documentation +| lib | Libraries required for building AspectJ +| testing | Test support classes +| testing-client | Client used for running the harness and reporting results +| testing-drivers | Testing harness drivers and support classes +| testing-util | Common testing utility classes used by the unit test suites in the core modules +| tests | AspectJ test suite, including all language tests, regression tests, and test system sources +|=== + +=== Eclipse AspectJ Development Tools (AJDT) + +*CVS Location:* dev.eclipse.org:/cvsroot/technology/org.eclipse.ajdt/plugins/org.eclipse.ajdt + +|=== +| *Plug-in* | *Dependencies* | *Description* +| org.eclipse.ajdt.ui | org.aspectj.ajde | AspectJ IDE support for Eclipse +| org.aspectj.ajde | ajde, asm, bridge | AspectJ libraries plug-in +|=== + +=== JBuilder Support + +*CVS Location:* cvs.aspectj4jbuildr.sourceforge.net:/cvsroot/aspectj4jbuildr + +|=== +| *OpenTool* | *Dependencies* | *Description* +| jbuilder | ajde, asm, bridge | AspectJ IDE support for JBuilder +|=== + +=== NetBeans Support + +*CVS Location:* cvs.aspectj4netbean.sourceforge.net:/cvsroot/aspectj4netbean + +|=== +| *Module* | *Dependencies* | *Description* +| netbeans | ajde, asm, bridge | AspectJ IDE support for NetBeans and SunONE Studio +|=== + +=== Emacs Support + +*CVS Location:* cvs.aspectj4emacs.sourceforge.net:/cvsroot/aspectj4emacs + +|=== +| *Module* | *Dependencies* | *Description* +| emacs | ajde, asm, bridge | AspectJ support for Emacs and XEmacs +|=== diff --git a/docs/developer/modules.html b/docs/developer/modules.html deleted file mode 100644 index 0aa3e8cfd..000000000 --- a/docs/developer/modules.html +++ /dev/null @@ -1,565 +0,0 @@ - - - - - - - -AspectJ modules - - - - - -

AspectJ Modules

- -

There are a number of different structures [Parnas]: "the module structure, -the uses structure, the runtime structure, .."  This document overviews module structure and summarizes what is hidden by each. -For detailed documentation refer to the individual module sources and docs -available via CVS.

-

Core Modules

-

CVS Location: dev.eclipse.org:/cvsroot/technology/org.aspectj/modules

-

-To set up for building, one need only check out the module directories within the -modules/ directory. In Eclipse, check out each module into the -the workspace as a project. -(Note: module dependencies may change at any time, -so this documentation might be out of date. -The Eclipse .classpath files specify the module dependencies, -even when using Ant to build outside of Eclipse.) - -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-

Module

 -

Dependencies

-

- Description

-

ajbrowser

 -

ajde, asm, bridge, util, taskdefs - (pseudo, for build system)

-

- This retired module used to contain the ajbrowser application. It depends on the ajde module -for access to the aspectj compiler, and also for the swing user interface -components that ajde provides.

-

ajde

 -

asm, bridge, - org.aspectj.ajdt.core, org.eclipse.jdt.core, util

 -

- Hides the details of accessing the aspectj compiler - and interpreting compilation results (error messages, structure - model, etc.) from other applications (typically IDEs) that need - to invoke it programmatically. - Changing any public interface in ajde can break all the IDE - integration projects and should be done with care.
-
- It also contains a library of common swing user interface - components that can be used by any swing based IDE. Ajbrowser - and the non-eclipse IDE integration projects use this library - (except for the emacs support).

-

asm

 -

bridge

 -

- Contains the Abstract Structure Model, which represents the result of -an aspectj compilation. Clients of ajde are returned an instance of the -structure model which allows them to navigate and interpret the static structure of an aspectj program.

-

bridge

 -

util

 -

- Contains an interface and implementation of classes realted to - compiler messages including: source locations, handling, and - formatting.  Intended to minimize dependencies between - testing, the compiler, and ajde.

-

org.aspectj.ajdt.core

 -

asm, bridge, org.eclipse.jdt.core, - runtime, testing-util, util, weaver

 -

- Front-end of the AspectJ compiler and extension of Eclipse's JDT compiler.  - Extends the JDT compiler's parsing and name resolution to - understand AspectJ declarations.  Also extends incremental - behavior with understanding of AspectJ dependancies.

-

org.eclipse.jdt.core

 -

 

 -

- The Eclipse JDT compiler, slightly patched for AspectJ - and stored in binary form to avoid accidental changes. - Sources are available in CVS at - dev.eclipse.org:/cvsroot/technology/org.aspectj/shadows. -

-
-

runtime

 -

 

 -

- Small runtime library required for building and running AspectJ - programs.

-

taskdefs

 -

bridge, org.aspectj.ajdt.core, - util

 -

- Ant taskdef for the AspectJ compiler/weaver, ajc.

-

util

 -

 

 -

- Common utility classes including data type, file, and stream - manipulation.

-

weaver

 -

asm, bridge, runtime, testing-util, - util

 -

- Back-end of the AspectJ compiler, built on top of the BCEL - bytecode toolkit.  All advice planning and weaving is done - here.  Takes an aspect bytecode format and other Java - classfiles as input. 

- 

Supporting Modules

-

CVS Location: dev.eclipse.org:/cvsroot/technology/org.aspectj/modules

-

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-

Module

 -

- Description

-

build

 -

- Ant files, scripts, and taskdefs required for building the - AspectJ distribution.  Also contains the GUI installer.

-

docs

 -

- Programmer and developer documentation.

-

lib

 -

- Libraries required for building AspectJ.

-

testing

 -

- Test support classes.

-

testing-client

 -

- Client used for running the harness and reporting results.

-

testing-drivers

 -

- Testing harness drivers and support classes.

-

testing-util

 -

- Common testing utility classes used by the unit test suites in - the core modules.

-

tests

 -

- AspectJ test suite, including all language tests, regression - tests, and test system sources.

- -

Eclipse AspectJ Development Tools (AJDT)

-

CVS Location: dev.eclipse.org:/cvsroot/technology/org.eclipse.ajdt/plugins/org.eclipse.ajdt

- - - - - - - - - - - - - - - - - -
-

- Plug-in

 -

Dependencies

-

- Description

-

org.eclipse.ajdt.ui

 -

org.aspectj.ajde

 -

- AspectJ IDE support for Eclipse.

-

org.aspectj.ajde

 -

ajde, asm, bridge

 -

- AspectJ libraries plug-in.

- 

JBuilder Support

-

CVS Location: -cvs.aspectj4jbuildr.sourceforge.net:/cvsroot/aspectj4jbuildr

- - - - - - - - - - - - -
-

- OpenTool

 -

Dependencies

-

- Description

-

jbuilder

 -

ajde, asm, bridge

 -

- AspectJ IDE support for JBuilder.

-
-

NetBeans Support

-

CVS Location: -cvs.aspectj4netbean.sourceforge.net:/cvsroot/aspectj4netbean

- - - - - - - - - - - - -
-

Module

 -

Dependencies

-

- Description

-

netbeans

 -

ajde, asm, bridge

 -

- AspectJ IDE support for NetBeans and SunONE Studio.

- 

Emacs Support

-

CVS Location: -cvs.aspectj4emacs.sourceforge.net:/cvsroot/aspectj4emacs

- - - - - - - - - - - - -
-

Module

 -

Dependencies

-

- Description

-

emacs

 -

ajde, asm, bridge

 -

- AspectJ support for Emacs and XEmacs.

- - - - diff --git a/docs/dist/LICENSE-AspectJ.adoc b/docs/dist/LICENSE-AspectJ.adoc new file mode 100644 index 000000000..9a2a163d6 --- /dev/null +++ b/docs/dist/LICENSE-AspectJ.adoc @@ -0,0 +1,83 @@ +== *AspectJ^TM^ Compiler and Core Tools License* + +This is a binary-only release. Source code is available from +http://eclipse.org/aspectj + +The Eclipse Foundation makes available all content in this distribution +("Content"). Unless otherwise indicated below, the Content is provided +to you under the terms and conditions of the Eclipse Public License +Version v 2.0 ("EPL"). A copy of the EPL is available at +xref:../../org/documents/epl-2.0/EPL-2.0.txt[https://www.eclipse.org/org/documents/epl-2.0/EPL-2.0.txt]. +For purposes of the EPL, "Program" will mean the Content. + +If you did not receive this Content directly from the Eclipse +Foundation, the Content is being redistributed by another party +("Redistributor") and different terms and conditions may apply to your +use of any object code in the Content. Check the Redistributor's license +that was provided with the Content. If no such license exists, contact +the Redistributor. Unless otherwise indicated below, the terms and +conditions of the EPL still apply to any source code in the Content and +such source code may be obtained at link:/[http://www.eclipse.org]. + +=== Third Party Content + +The Content includes items that have been sourced from third parties as +set out below. If you did not receive this Content directly from the +Eclipse Foundation, the following is provided for informational purposes +only, and you should look to the Redistributor's license for terms and +conditions of use. + +__ + +==== BCEL v5.1 + +This product contains software developed by the Apache Software +Foundation (http://www.apache.org/[http://www.apache.org]). + +AspectJ includes a modified version of the Apache Jakarta Byte Code +Engineering Library (BCEL) v5.1. BCEL is available at +https://commons.apache.org/bcel/. Source code for the modified version +of BCEL is available at Eclipse.org in the AspectJ source tree. This +code is made available under the Apache Software License v1.1 + +==== ASM v2.2.1 + +AspectJ includes a binary version of ASM v2.2.1 +(http://asm.objectweb.org/index.html[http://asm.objectweb.org/]) The +source code for ASM is available from the ObjectWeb download site at +http://asm.objectweb.org/download/. + +The ASM license is available at http://asm.objectweb.org/license.html. +The license is also reproduced here: + +.... +Copyright (c) 2000-2005 INRIA, France Telecom +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: + +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + +2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + +3. Neither the name of the copyright holders nor the names of its + contributors may be used to endorse or promote products derived from + this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE +LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF +THE POSSIBILITY OF SUCH DAMAGE. +.... diff --git a/docs/dist/README-AspectJ.adoc b/docs/dist/README-AspectJ.adoc new file mode 100644 index 000000000..ecceb0a3e --- /dev/null +++ b/docs/dist/README-AspectJ.adoc @@ -0,0 +1,155 @@ +== AspectJ^TM^ + +_Version @build.version.long@ released on @build.date@._ + +=== 1 Contents of this Package + +* the link:bin[`/bin`] directory has scripts for +** `ajc`: the compiler for the AspectJ language +** `ajbrowser`: a graphical editor for compiling programs with `ajc` and +navigating the crosscutting structure of those programs +* the directory link:lib[`/lib`] has the AspectJ +binaries, +** `aspectjtools.jar`: libraries for `ajc`, `ajbrowser`, and the Ant +tasks +** `aspectjrt.jar`: runtime library for AspectJ programs +* the directory link:doc[`/doc`] has examples, +programming and development environment guides, instructions for the Ant +tasks, a README for 1.1 changes, and a quick reference, all linked from +the link:doc/index.html[index] page. +* this README-AspectJ.html, and +* the LICENSE-AspectJ.html applying to this distribution. + +''''' + +=== 2 Install Procedure + +The AspectJ tools `ajc` and `ajbrowser` are Java programs that can be +run indirectly from the scripts or directly from `aspectjtools.jar`. The +`aspectjrt.jar` needs to be on the classpath when compiling or running +programs compiled by `ajc`. This procedure shows ways to do that. + +After finishing automatic installation, we recommend that the following +steps to complete your installation: + +*2.1 Add `/lib/aspectjrt.jar` to your class path* + +____ +This small .jar file contains classes required to compile programs with +the ajc compiler, and to run programs compiled with the ajc compiler. +You must have these classes somewhere on your class path when running +programs compiled with ajc. For detailed instructions please see the +xref:#configInstructions[Configuration Instructions] at the bottom of +this document. +____ + +*2.2 Put the AspectJ `bin` directory on your PATH* + +____ +Modify your PATH to include `/bin`. This will +make it easier to run ajc. For detailed instructions please see the +xref:#configInstructions[Configuration Instructions] at the bottom of +this document. +____ + +*2.3 Review the documentation and examples* + +____ +Development and programming guides are available in +link:doc/index.html[docs], and example programs and an Ant script are +available in link:doc/examples/[examples]. +____ + +If you did not use the automatic installation process, you may wish to +create short launch scripts to start ajc easily (section 3). + +''''' + +=== 3. Running the Tools + +If you did not use the automatic installation process or the default +launch scripts do not work on your system, you may wish to create short +launch scripts to start ajc easily. + +You can also run the `aspectjtools.jar` directly using java's -jar +option: + +____ +`C:\jdk1.3\bin\java.exe -jar D:\aspectj\lib\aspectjtools.jar %*` +____ + +With no arguments or only argument list (.lst) files, this will launch +`ajbrowser`, the GUI structure browser; otherwise, it will run `ajc`, +the AspectJ compiler. This means that if your browser is set up to run +jar files, clicking a link to lib/aspectjtools.jar will launch +`ajbrowser`. + +You can also create scripts like those created by the installer. These +scripts use full paths that are system dependent so you will likely have +to change these. + +Here's a sample launch script for WinNT and Win2K (note that this is +single line in the .bat file): + +____ +`C:\jdk1.3\bin\java.exe -classpath D:\aspectj\lib\aspectjtools.jar -Xmx64M org.aspectj.tools.ajc.Main %*` +____ + +Here's a sample launch script for a Unix shell (on Linux using Sun's +JDK1.3): + +____ +`/usr/java/jdk1.3/jre/bin/java -classpath /home/aspectj/lib/aspectjtools.jar -Xmx64M org.aspectj.tools.ajc.Main "$@"` +____ + +''''' + +=== [#configInstructions]#4. Configuration Instructions# + +==== 4.1 Adding `/lib/aspectjrt.jar` to your classpath + +There are several ways to add this jar file to your classpath: + +* copy `aspectjrt.jar` to the `jdk/jre/lib/ext` directory +* add `aspectjrt.jar` to your CLASSPATH environment variable (see the +next section for details) +* always use the "`-classpath aspectjrt.jar`" option when running +programs compiled with ajc + +==== 4.2 [#6.1]#Setting the Environment Variables on Windows# + +The following instructions use the PATH variable as an example, but this +process is identical for the CLASSPATH variable. + +You can do the variables permanently for all the shells that you will +run or temporarily only for the current shell. To change the PATH only +in the current shell, and assuming you've installed AspectJ in +`C:\apps\aspectj`, type: + +____ +`> set PATH=%PATH%;C:\apps\aspectj\bin` +____ + +*Changing Environment Variables Permanently on WinNT and Win2000* + +* open the Environment Variables dialog +** WinNT: in "Control Panels" double-click "System" and select the +"Environment" tab +** Win2K: in "Control Panels" double-click "System", select the +"Advanced" tab and click the "Environment Variables..." button +* select the environment variable for editing, or add it using the +"New..." button if it does not exist +* add the new entry separated from the others by a semi-colon (;) and +close the dialog +* note that the change will not affect shells that were already running + +*Changing Environment Variables Permanently on Win9x* + +* open the AUTOEXEC.BAT with an editor such as NotePad +* edit the PATH statement to include the new entry and save the file, +e.g. + ++ +____ +`PATH C:\WINDOWS;C:\WINDOWS\COMMAND;C:\;C:\DOS;C:\apps\aspectj\bin` +____ +* note that the change will not affect shells that were already running diff --git a/docs/dist/doc/README-11.adoc b/docs/dist/doc/README-11.adoc new file mode 100644 index 000000000..0464ba88b --- /dev/null +++ b/docs/dist/doc/README-11.adoc @@ -0,0 +1,1330 @@ +[.small]#© Copyright 2002 Palo Alto Research Center, Incorporated, 2003 +Contributors. All rights reserved.# + +== AspectJ 1.1 Readme + +This is the initial release of AspectJ 1.1. It includes a small number +of new language features as well as major improvements to the +functionality of the tools. + +This document describes the differences between AspectJ versions 1.1 and +1.0.6. Users new to AspectJ need only read the +link:progguide/index.html[AspectJ Programming Guide] since it describes +the 1.1 language. Users familiar with AspectJ 1.0 may find this document +a quicker way to learn what changed in the language and tools, and +should use it as a guide for porting programs from 1.0 to 1.1. + +This document first summarizes changes from the 1.0 release in + +* xref:#language[the language], +* xref:#compiler[the compiler], +* xref:#tools[the support tools], +* xref:#runtime[the runtime], +* xref:#devenv[the development environment support], +* xref:#sources[the sources], and +* xref:#distribution[the distribution], + +then xref:#details[details] some of the language and compiler changes, +and finally points readers to the bug database for any +xref:#knownLimitations[known limitations]. + +''''' + +=== [#language]#The Language# + +AspectJ 1.1 is a slightly different language than AspectJ 1.0. In all +but a few cases, programs written in AspectJ 1.0 should compile +correctly in AspectJ 1.1. In many cases, there are new or preferred +forms in AspectJ 1.1. However, some AspectJ 1.0 features have changed in +1.1, so some 1.0 programs will not compile or will run differently in +1.1. The corresponding features are marked below as compile-time or +run-time incompatible (_CTI_ or _RTI_, respectively). When the language +change involves a move in the static shadow effective at run-time but +also apparent at compile-time (e.g., in declare error or warning +statements), it is marked _CRTI_. Programs using run-time incompatible +forms should be verified that they are behaving as expected in 1.1. + +Most changes to the language are additions to expressibility requested +by our users: + +* xref:#THROWS_PATTERN[Matching based on throws]: You can now make finer +discriminations between methods based on declared exceptions. +* xref:#NEW_PCDS[New kinded pointcut designators]: Now every kind of +join point has a corresponding kinded pointcut designator. + +Some are have different behavior in edge cases but offer improved power +and clarity: + +* xref:#ASPECT_PRECEDENCE[New aspect precedence form]: AspectJ 1.1 has a +new declare form, `declare precedence`, that replaces the +"dominates" clause on aspects. (_CTI_) +* The order of xref:#SUPER_IFACE_INITS[initialization join points for +super-interfaces] has been clarified. (_RTI_) + +But in order to support weaving into bytecode effectively, several +incompatible changes had to be made to the language: + +* A class's default constructor may +xref:#DEFAULT_CONSTRUCTOR_CONFLICT[conflict] with an inter-type +constructor. (_CTI_) +* xref:#NO_CALLEE_SIDE_CALL[No callee-side call join points]: The +AspectJ 1.1 compiler does not expose call join points unless it is given +the calling code. (_CRTI_) +* xref:#SINGLE_INTERCLASS_TARGET[One target for intertype declarations]. +(_CTI_) +* xref:#UNAVAILABLE_JOIN_POINTS[No initializer execution join points]. +(_RTI_) +* xref:#AFTER_HANDLER[No after or around advice on handler join points]. +(_CTI_) +* xref:#CONSTRUCTOR_EXECUTION_IS_BIGGER[Initializers run inside +constructor execution join points]. (_RTI_) +* xref:#INTER_TYPE_FIELD_INITIALIZERS[inter-type field initializers] run +before class-local field initializers. (_RTI_) +* xref:#WITHIN_MEMBER_TYPES[Small limitations of the within pointcut.] +(_CRTI_) +* xref:#WITHIN_CODE[Small limitations of the withincode pointcut.] +(_CRTI_) +* xref:#INSTANCEOF_ON_WILD[Can't do instanceof matching on type patterns +with wildcards]. (_CTI_) +* xref:#NO_SOURCE_COLUMN[SourceLocation.getColumn() is deprecated and +will always return 0]. (_RTI_) +* The interaction between aspect instantiation and advice has been +xref:#ASPECT_INSTANTIATION_AND_ADVICE[clarified]. (_RTI_) +* xref:#STRINGBUFFER[The String + operator is now correctly advised]. +(_CRTI_) + +[#NEW_LIMITATIONS]#There# are a couple of language limitations for +things that are rarely used that make the implementation simpler, so we +have restricted the language accordingly. + +* xref:#VOID_FIELD_SET[Field set join points now have a `void` return +type.] This will require porting of code that uses the `set` PCD in +conjunction with after-returning or around advice. (_CTI_) +* 'declare soft: TYPE: POINTCUT;' - AspectJ 1.1 only accepts TYPE rather +than a TYPE_PATTERN. This limitation makes declare soft much easier to +implement efficiently. (_CTI_) +* Inter-type field declarations only allow a single field per line, i.e. +this is now illegal 'int C.field1, D.field2;' This must instead be, 'int +C.field1; int D.field2;' (_CTI_) +* We did not implement the handling of more than one `..` wildcard in +args PCD's (rarely encountered in the wild) because we didn't have the +time. This might be available in later releases if there is significant +outcry. (_CTI_) + +We did not implement the long-awaited xref:#PER_TYPE[new pertype aspect +specifier] in this release, but it may well be in a future release. + +''''' + +=== [#compiler]#The Compiler# + +The compiler for AspectJ 1.1 is different than the compiler for AspectJ +1.0. While this document describes the differences in the compiler, it's +worthwhile noting that much effort has been made to make sure that the +interface to ajc 1.1 is, as much as possible, the same as the interface +to ajc 1.0. There are two important changes under the hood, however. + +First, the 1.1 compiler is implemented on top of the open-source Eclipse +compiler. This has two benefits: It allows us to concentrate on the +AspectJ extensions to Java and let the Eclipse team worry about making +sure the Java edge cases work, and it allows us to piggyback on +Eclipse's already mature incremental compilation facilities. + +Second, ajc now cleanly delineates compilation of source code from +assembly (or "weaving") of bytecode. The compiler still accepts source +code, but internally it transforms it into bytecode format before +weaving. + +This new architecture, and other changes to the compiler, allows us to +implement some features that were defined in the AspectJ 1.0 language +but not implementable in the 1.1 compiler. It also makes some new +features available: + +* xref:#SOURCEROOT[The -sourceroots option] takes one or more +directories, and indicates that all the source files in those +directories should be passed to the compiler. +* xref:#BYTECODE_WEAVING[The -injars option] takes one or more jar +files, and indicates that all the classfiles in the jar files should be +woven into. +* xref:#BINARY_ASPECTS[The -aspectpath option] takes one or more jar +files, and weaves any aspects in .class form into the sources. +* xref:#OUTJAR[The -outjar option] indicates that the result classfiles +of compiling and weaving should be placed in the specified jar file. +* xref:#XLINT[The -Xlint option] allows control over warnings. +* xref:#OTHER_X_OPTIONS[Various -X options] changed. +* xref:#INCREMENTAL[The -incremental option] tells the AspectJ 1.1 +compiler to recompile only as necessary. + +Some other features we wanted to support for 1.1, but did not make it +into this release: + +* xref:#ERROR_MESSAGES[Error messages will sometimes be scary] +* xref:#MESSAGE_CONTEXT[Source code context is not shown for errors and +warnings detected during bytecode weaving] + +But some features of the 1.0 compiler are not supported in the 1.1 +compiler: + +* xref:#NO_SOURCE[The source-related options] -preprocess, -usejavac, +-nocomment and -workingdir +* xref:#NO_STRICT_LENIENT[The -strict and -lenient options] +* xref:#NO_PORTING[The -porting option] +* xref:#13_REQUIRED[J2SE 1.2 is not supported; J2SE 1.3 or later is +required.] + +A short description of the options ajc accepts is available with +"`ajc -help`". Longer descriptions are available in the +link:devguide/ajc-ref.html[Development Environment Guide section on +ajc]. + +Some changes to the implementation are almost entirely internal: + +* The behavior of the compiler in xref:#TARGET_TYPES_MADE_PUBLIC[lifting +the visibility] of the target types of some declares and pointcuts to +public has been clarified. + +Also, it is worth noting that because AspectJ now works on bytecode, it +is somewhat sensitive to how different compilers generate bytecode, +especially when compiling with and without +xref:#ONE_FOUR_METHOD_SIGNATURES[the -1.4 flag]. + +''''' + +=== [#tools]#Support Tools# + +This release includes an Ant task for old-style 1.0 build scripts, a new +task for all the new compiler options, and a CompilerAdapter to support +running `ajc` with the Javac task by setting the `build.compiler` +property. The new task can automatically copy input resources to output +and work in incremental mode using a "tag" file. + +This release does not include `ajdoc`, the documentation tool for +AspectJ sources. Ajdoc is deeply dependent on the abstract syntax tree +classes from the old compiler, so it needs a bottom-up rewrite. We think +it best to use this opportunity to implement more general API's for +publishing and rendering static structure. Because those API's are last +to settle in the new architecture, and because the compiler itself is a +higher priority, we are delaying work on ajdoc until after the 1.1 +release. + +AspectJ 1.1 will not include ajdb, the AspectJ stand-alone debugger. It +is no longer necessary for two reasons. First, the -XnoInline flag will +tell the compiler to generate code without inlining that should work +correctly with any Java debugger. For code generated with inlining +enabled, more third-party debuggers are starting to work according to +JSR 45, "Debugging support for other languages," which is supported by +AspectJ 1.0. We aim to support JSR-45 in AspectJ 1.1, but support will +not be in the initial release. Consider using the -XnoInline flag until +support is available. + +''''' + +=== [#runtime]#The Runtime Library# + +This release has minor additions to the runtime library classes. As with +any release, you should compile and run with the runtime library that +came with your compiler, and you may run with a later version of the +library without recompiling your code. + +In one instance, however, runtime classes behave differently this +release. Because the AspectJ 1.1 compiler does its weaving through +bytecode, column numbers of source locations are not available. +Therefore, `thisJoinPoint.getSourceLocation().getColumn()` is deprecated +and will always return 0. + +''''' + +=== [#devenv]#The AJDE Tools# + +The AspectJ Browser supports incremental compilation and running +programs. AJDE for JBuilder, AJDE for NetBeans, and AJDE for Emacs are +now independent SourceForge projects (to keep their licenses). They use +the batch-build mode of the new compiler. + +''''' + +=== [#sources]#The Sources and the Licenses# + +The AspectJ tools sources are available under the +https://www.eclipse.org/org/documents/epl-2.0/EPL-2.0.txt[Eclipse Public +License v 2.0] in the Git repository at http://eclipse.org/aspectj. For +more information, see the FAQ entry on +faq.html#q:buildingsource[building sources]. + +''''' + +=== [#distribution]#The AspectJ distribution# + +AspectJ 1.0 had many distributions - for the tools, the documentation, +each IDE support package, their respective sources, and the Ant tasks - +because they came under different licenses. All of AspectJ 1.1 is +licensed under the CPL 1.0, so the tools, Ant tasks, and documentation +are all in one distribution available from http://eclipse.org/aspectj. +To retain their MPL 1.1 license, Ajde for +http://aspectj4emacs.sourceforge.net/[Emacs], +http://aspectj4netbean.sourceforge.net/[NetBeans] and +http://aspectj4jbuildr.sourceforge.net/[JBuilder] are now independent +SourceForge projects. + +''''' + +''''' + +=== [#details]#Details# of some language and compiler changes + +==== [#ASPECT_INSTANTIATION_AND_ADVICE]#Aspect Instantiation and Advice# + +In AspectJ 1.0.6, we made an effort to hide some complications with +Aspect instantiation from the user. In particular, the following code +compiled and ran: + +.... + public class Client + { + public static void main(String[] args) { + Client c = new Client(); + } + } + + aspect Watchcall { + pointcut myConstructor(): execution(new(..)); + + before(): myConstructor() { + System.err.println("Entering Constructor"); + } + } + +.... + +But there's a conceptual problem with this code: The before advice +should run before the execution of all constructors in the system. It +must run in the context of an instance of the Watchcall aspect. The only +way to get such an instance is to have Watchcall's default constructor +execute. But before that executes, we need to run the before advice... + +AspectJ 1.0.6 hid this circularity through the ad-hoc mechanism of +preventing an aspect's advice from matching join points that were within +the aspect's definition, and occurred before the aspect was initialized. +But even in AspectJ 1.0.6, this circularity could be exposed: + +.... + public class Client + { + public static int foo() { return 3; } + public static void main(String[] args) { + Client c = new Client(); + } + } + + aspect Watchcall { + int i = Client.foo(); + pointcut myConstructor(): + execution(new(..)) || execution(int foo()); + + before(): myConstructor() { + System.err.println("Entering Constructor"); + } + } + +.... + +This program would throw a NullPointerException when run, since +Client.foo() was called before the Watchcall instance could be +instantiated. + +In AspectJ 1.1, we have decided that half-hiding the problem just leads +to trouble, and so we are no longer silently hiding some join points +before aspect initialization. However, we have provided a better +exception than a NullPointerException for this case. In AspectJ 1.1, +both of the above programs will throw +org.aspectj.lang.NoAspectBoundException. + +==== [#THROWS_PATTERN]#Matching based on throws# + +Type patterns may now be used to pick out methods and constructors based +on their throws clauses. This allows the following two kinds of +extremely wildcarded pointcuts: + +.... + pointcut throwsMathlike(): + // each call to a method with a throws clause containing at least + // one exception with "Math" in its name. + call(* *(..) throws *..*Math*); + + pointcut doesNotThrowMathlike(): + // each call to a method with a throws clause containing no + // exceptions with "Math" in its name. + call(* *(..) throws !*..*Math*); + +.... + +The longwinded rules are that a method or constructor pattern can have a +"throws clause pattern". Throws clause patterns look like: + +.... + ThrowsClausePattern: + ThrowsClausePatternItem ("," ThrowsClausePatternItem)* + + ThrowsClausePatternItem: + ["!"] TypeNamePattern + +.... + +A ThrowsClausePattern matches the ThrowsClause of any code member +signature. To match, each ThrowsClausePatternItem must match the throws +clause of the member in question. If any item doesn't match, then the +whole pattern doesn't match. This rule is unchanged from AspectJ 1.0. + +If a ThrowsClausePatternItem begins with "!", then it matches a +particular throws clause if and only if _none_ of the types named in the +throws clause is matched by the TypeNamePattern. + +If a ThrowsClausePatternItem does not begin with "!", then it matches a +throws clause if and only if _any_ of the types named in the throws +clause is matched by the TypeNamePattern. + +These rules are completely backwards compatible with AspectJ 1.0. The +rule for "!" matching has one potentially surprising property, in that +the two PCD's shown below will have different matching rules. + +.... + [1] call(* *(..) throws !IOException) + [2] call(* *(..) throws (!IOException)) + + void m() throws RuntimeException, IOException {} + +.... + +[1] will NOT match the method m(), because method m's throws clause +declares that it throws IOException. [2] WILL match the method m(), +because method m's throws clause declares the it throws some exception +which does not match IOException, i.e. RuntimeException. + +==== [#NEW_PCDS]#New kinded pointcut designators# + +AspectJ 1.0 does not provide kinded pointcut designators for two (rarely +used) join points: preinitialization (the code that runs before a super +constructor call is made) and advice execution. AspectJ 1.1 does not +change the meaning of the join points, but provides two new pointcut +designators to pick out these join points, thus making join points and +pointcut designators more parallel. + +`adviceexectuion()` will pick out advice execution join points. You will +usually want to use `adviceexecution() && within(Aspect)` to +restrict it to only those pieces of advice defined in a particular +aspect. + +`preinitialization(ConstructorPattern)` will pick out pre-initialization +join points where the initialization process is entered through +`ConstructorPattern`. + +==== [#PER_TYPE]#New pertype aspect specifier# (not in 1.1) + +We strongly considered adding a pertype aspect kind to 1.1. This is +somewhat motivated by the new +xref:#SINGLE_INTERCLASS_TARGET[restrictions on inter-type declarations] + +. This is also motivated by many previous request to support a common +logging idiom. Here's what pertype would look like: + +.... + /** One instance of this aspect will be created for each class, + * interface or aspect in the com.bigboxco packages. + */ + aspect Logger pertype(com.bigboxco..*) { + /* This field holds a logger for the class. */ + Log log; + + /* This advice will run for every public execution defined by + * a type for which a Logger aspect has been created, i.e. + * any type in com.bigboxco..* + */ + before(): execution(public * *(..)) { + log.enterMethod(thisJoinPoint.getSignature().getName()); + } + + /* We can use a special constructor to initialize the log field */ + public Logger(Class myType) { + this.log = new Log(myType); + } + } + + /** External code could use aspectOf to get at the log, i.e. */ + Log l = Logger.aspectOf(com.bigboxco.Foo.class).log; + +.... + +The one open question that we see is how this should interact with inner +types. If a pertype aspect is created for an outer type should advice in +that aspect run for join points in inner types? That is the behavior of +the most common uses of this idiom. + +In any case, this feature will not be in AspectJ 1.1. + +==== [#SINGLE_INTERCLASS_TARGET]#One target for intertype declarations# + +Intertype declarations (once called "introductions") in AspectJ 1.1 can +only have one target type. So the following code intended to declare +that there is a void doStuff() method on all subtypes of Target is not +legal AspectJ 1.1 code. + +.... + aspect A { + public void Target+.doStuff() { ... } + } + +.... + +The functionality of "multi-intertype declarations" can be recovered by +using a helper interface. + +.... + aspect A { + private interface MyTarget {} + declare parents: Target+ implements MyTarget; + public void MyTarget.doStuff() { ... } + } + +.... + +We believe this is better style in AspectJ 1.0 as well, as it makes +clear the static type of "this" inside the method body. + +The one piece of functionality that can not be easily recovered is the +ability to add static fields to many classes. We believe that the +xref:#PER_TYPE[pertype proposal] provides this functionality in a much +more usable form. + +==== [#UNAVAILABLE_JOIN_POINTS]#No initializer execution join points# + +AspectJ 1.1 does not consider initializer execution a principled join +point. The collection of initializer code (the code that sets fields +with initializers and the code in non-static initializer blocks) is +something that makes sense only in Java source code, not in Java +bytecode. + +==== [#AFTER_HANDLER]####No after or around advice on handler join points + +The end of an exception handler is underdetermined in bytecode, so ajc +will not implement after or around advice on handler join points, +instead signaling a compile-time error. + +==== [#CONSTRUCTOR_EXECUTION_IS_BIGGER]#Initializers run inside constructor execution join points# + +The code generated by the initializers in Java source code now runs +inside of constructor execution join points. This changes how before +advice runs on constructor execution join points. Consider: + +.... + class C { + C() { } + String id = "identifier"; // this assignment + // has to happen sometime + } + aspect A { + before(C c) this(c) && execution(C.new()) { + System.out.println(c.id.length()); + } + } + +.... + +In AspectJ 1.0, this will print "10", since id is assigned its initial +value prior to the before advice's execution. However, in AspectJ 1.1, +this will throw a NullPointerExcception, since "id" does not have a +value prior to the before advice's execution. + +Note that the various flavors of after returning advice are unchanged in +this respect in AspectJ 1.1. Also note that this only matters for the +execution of constructors that call a super-constructor. Execution of +constructors that call a this-constructor are the same in AspectJ 1.1 as +in AspectJ 1.0. + +We believe this difference should be minimal to real programs, since +programmers using before advice on constructor execution must always +assume incomplete object initialization, since the constructor has not +yet run. + +==== [#INTER_TYPE_FIELD_INITIALIZERS]#Inter-type field initializers# + +The initializer, if any, of an inter-type field definition runs before +the class-local initializers of its target class. + +In AspectJ 1.0.6, such an initializer would run after the initializers +of a class but before the execution of any of its constructor bodies. As +already discussed in the sections about +xref:#UNAVAILABLE_JOIN_POINTS[initializer execution join points] and +xref:#CONSTRUCTOR_EXECUTION_IS_BIGGER[constructor execution], the point +in code between the initializers of a class and its constructor body is +not principled in bytecode. So we had a choice of running the +initializer of an inter-type field definition at the beginning of +initialization (i.e., before initializers from the target class) or at +the end (i.e., just before its called constructor exits). We chose the +former, having this pattern in mind: + +.... + int C.methodCount = 0; + before(C c): this(c) && execution(* *(..)) { c.methodCount++; } + +.... + +We felt there would be too much surprise if a constructor called a +method (thus incrementing the method count) and then the field was reset +to zero after the constructor was done. + +==== [#WITHIN_MEMBER_TYPES]#Small limitations of the within pointcut# + +Because of the guarantees made (and not made) by the Java classfile +format, there are cases where AspectJ 1.1 cannot guarantee that the +within pointcut designator will pick out all code that was originally +within the source code of a certain type. + +The non-guarantee applies to code inside of anonymous and local types +inside member types. While the within pointcut designator behaves +exactly as it did in AspectJ 1.0 when given a package-level type (like +C, below), if given a member-type (like C.InsideC, below), it is not +guaranteed to capture code in contained local and anonymous types. For +example: + +.... + class C { + Thread t; + class InsideC { + void setupOuterThread() { + t = new Thread( + new Runnable() { + public void run() { + // join points with code here + // might not be captured by + // within(C.InsideC), but are + // captured by within(C) + System.out.println("hi"); + } + }); + } + } + } + +.... + +We believe the non-guarantee is small, and we haven't verified that it +is a problem in practice. + +==== [#WITHIN_CODE]#Small limitations of the withincode pointcut# + +The withincode pointcut has similar issues to those described above for +within. + +==== [#INSTANCEOF_ON_WILD]#Can't do instanceof matching on type patterns with wildcard# + +The pointcut designators this, target and args specify a dynamic test on +their argument. These tests can not be performed on type patterns with +wildcards in them. The following code that compiled under 1.0 will be an +error in AspectJ-1.1: + +.... + pointcut oneOfMine(): this(com.bigboxco..*); + +.... + +The only way to implement this kind of matching in a modular way would +be to use the reflection API at runtime on the Class of the object. This +would have a very high performance cost and possible security issues. +There are two good work-arounds. If you control the source or bytecode +to the type you want to match then you can use declare parents, i.e.: + +.... + private interface OneOfMine {} + declare parents: com.bigboxco..* implements OneOfMine; + pointcut oneOfMine(): this(OneOfMine); + +.... + +If you want the more dynamic matching and are willing to pay for the +performance, then you should use the Java reflection API combined with +if. That would look something like: + +.... + pointcut oneOfMine(): this(Object) && + if(classMatches("com.bigboxco..*", + thisJoinPoint.getTarget().getClass())); + + static boolean classMatches(String pattern, Class _class) { + if (patternMatches(pattern, _class.getName())) return true; + ... + } + +.... + +Note: wildcard type matching still works in all other PCD's that match +based on static types. So, you can use 'within(com.bigboxco..*+)' to +match any code lexically within one of your classes or a subtype +thereof. This is often a good choice. + +==== [#NO_SOURCE_COLUMN]#SourceLocation.getColumn()# + +The Java .class file format contains information about the source file +and line numbers of its contents; however, it has no information about +source columns. As a result, we can not effectively support the access +of column information in the reflection API. So, any calls to +thisJoinPoint.getSourceLocation().getColumn() will be marked as +deprecated by the compiler, and will always return 0. + +==== [#ASPECT_PRECEDENCE]#Aspect precedence# + +AspectJ 1.1 has a new declare form: + +.... + declare precedence ":" TypePatternList ";" + +.... + +This is used to declare advice ordering constraints on join points. For +example, the constraints that (1) aspects that have Security as part of +their name should dominate all other aspects, and (2) the Logging aspect +(and any aspect that extends it) should dominate all non-security +aspects, can be expressed by: + +.... + declare precedence: *..*Security*, Logging+, *; + +.... + +In the TypePatternList, the wildcard * means "any type not matched by +another type in the declare precedence". + +===== Various cycles + +It is an error for any aspect to be matched by more than one TypePattern +in a single declare precedence, so: + +.... + declare precedence: A, B, A ; // error + +.... + +However, multiple declare precedence forms may legally have this kind of +circularity. For example, each of these declare precedence is perfectly +legal: + +.... + declare precedence: B, A; + declare precedence: A, B; + +.... + +And a system in which both constraints are active may also be legal, so +long as advice from A and B don't share a join point. So this is an +idiom that can be used to enforce that A and B are strongly independent. + +===== Applies to concrete aspects + +Consider the following library aspects: + +.... + abstract aspect Logging { + abstract pointcut logged(); + + before(): logged() { + System.err.println("thisJoinPoint: " + thisJoinPoint); + } + } + + aspect MyProfiling { + abstract pointcut profiled(); + + Object around(): profiled() { + long beforeTime = System.currentTimeMillis(); + try { + return proceed(); + } finally { + long afterTime = System.currentTimeMillis(); + addToProfile(thisJoinPointStaticPart, + afterTime - beforeTime); + } + } + abstract void addToProfile( + org.aspectj.JoinPoint.StaticPart jp, + long elapsed); + } + +.... + +In order to use either aspect, they must be extended with concrete +aspects, say, MyLogging and MyProfiling. In AspectJ 1.0, it was not +possible to express that Logging's advice (when concerned with the +concrete aspect MyLogging) dominated Profiling's advice (when concerned +with the concrete aspect MyProfiling) without adding a dominates clause +to Logging itself. In AspectJ 1.1, we can express that constraint with a +simple: + +.... + declare precedence: MyLogging, MyProfiling; + +.... + +===== Changing order of advice for sub-aspects + +By default, advice in a sub-aspect has more precedence than advice in a +super-aspect. One use of the AspectJ 1.0 dominates form was to change +this precedence: + +.... + abstract aspect SuperA dominates SubA { + pointcut foo(): ... ; + + before(): foo() { + // in AspectJ 1.0, runs before the advice in SubA + // because of the dominates clause + } + } + + aspect SubA extends SuperA { + before(): foo() { + // in AspectJ 1.0, runs after the advice in SuperA + // because of the dominates clause + } + } + +.... + +This no longer works in AspectJ 1.1, since declare precedence only +matters for concrete aspects. Thus, if you want to regain this kind of +precedence change, you will need to refactor your aspects. + +==== [#SOURCEROOT]#The -sourceroots option# + +The AspectJ 1.1 compiler now accepts a -sourceroots option used to pass +all .java files in particular directories to the compiler. It takes +either a single directory name, or a list of directory names separated +with the CLASSPATH separator character (":" for various Unices, ";" for +various Windows). + +So, if you have your project separated into a gui module and a base +module, each of which is stored in a directory tree, you might use one +of + +.... + ajc -sourceroots /myProject/gui:/myProject/base + ajc -sourceroots d:\myProject\gui;d:\myProject\base + +.... + +This option may be used in conjunction with lst files, listing .java +files on the command line, and the -injars option. + +==== [#BYTECODE_WEAVING]#The -injars option# + +The AspectJ 1.1 compiler now accepts an -injars option used to pass all +.class files in a particular jar file to the compiler. It takes either a +single directory name, or a list of directory names separated with the +CLASSPATH separator character (":" for various Unices, ";" for various +Windows). + +So, if MyTracing.java defines a trace aspect that you want to apply to +all the classes in myBase.jar and myGui.jar, you would use one of: + +.... + ajc -injars /bin/myBase.jar:/bin/myGui.jar MyTracing.java + ajc -injars d:\bin\myBase.jar;d:\bin\myGui.jar MyTracing.java + +.... + +The class files in the input jars must not have had advice woven into +them, since AspectJ enforces the requirement that advice is woven into a +particular classfile only once. So if the classfiles in the jar file are +to be created with the ajc compiler (as opposed to a pure Java +compiler), they should not be compiled with any non-abstract aspects. + +This option may be used in conjunction with lst files, listing .java +files on the command line, and the -sourceroots option. + +==== [#OUTJAR]#The -outjar option# + +The -outjar option takes the name of a jar file into which the results +of the compilation should be put. For example: + +.... + ajc -injars myBase.jar MyTracing.java -outjar myTracedBase.jar + +.... + +No meta information is placed in the output jar file. + +==== [#INCREMENTAL]#Incremental compilation# + +The AspectJ 1.1 compiler now supports incremental compilation. When ajc +is called with the -incremental option, it must also be passed a +-sourceroots option specifying a directory to incrementally compile. +Once the initial compile is done, ajc waits for console input. Every +time it reads a new line (i.e., every time the user hits return) ajc +recompiles those input files that need recompiling. + +===== Limitations + +This new functionality is still only lightly tested. + +==== [#XNOWEAVE]#-XnoWeave, a compiler option to suppress weaving# + +The -XnoWeave option suppresses weaving, and generates classfiles and +that can be passed to ajc again (through the -injars option) to generate +final, woven classfiles. + +This option was originally envisioned to be the primary way to generate +binary aspects that could be linked with other code, and so it was +previously (in AspectJ 1.1beta1) named `-noweave`. We feel that using +the `-aspectpath` option is a much better option. There may still be use +cases for unwoven classfiles, but we've moved the flag to experimental +status. + +==== [#BINARY_ASPECTS]#-aspectpath, working with aspects in .class/.jar form# + +When aspects are compiled into classfiles, they include all information +necessary for the ajc compiler to weave their advice and deal with their +inter-type declarations. In order for these aspects to have an effect on +a compilation process, they must be passed to the compiler on the +-aspectpath. Every .jar file on this path will be searched for aspects +and any aspects that are found will be enabled during the compilation. +The binary forms of this aspects will be untouched. + +==== [#NO_CALLEE_SIDE_CALL]#Callee-side call join points# + +The 1.0 implementation of AspectJ, when given: + +.... + class MyRunnable implements Runnable { + public void run() { ... } + } + + aspect A { + call(): (void run()) && target(MyRunnable) { + // do something here + } + } + +.... + +would cause A's advice to execute even when, say, java.lang.Thread +called run() on a MyRunnable instance. + +With the new compiler, two things have happened in regard to callee-side +calls: + +. because the programmer has access to more code (i.e., bytecode, not +just source code), callee-side calls are much less important to have. +. because compilation is more modular, allowing and encouraging separate +compilation, callee-side calls are much more difficult to implement + +With these two points in mind, advice in an aspect will not be applied +to call join points whose call site is completely unavailable to the +aspect. + +. One reason (though not the only reason) we worked so hard in the +_implementation_ of 1.0.6 to expose call join points, even if we only +had access to the callee's code, was that otherwise users couldn't get +access to call join points where the call was made from bytecode. This +is no longer the case. In short, the implementation controls much more +code (or has the capability to) than ever before. +. The implementation model for the AspectJ 1.1 compiler is to separate +the compilation of aspects/advice from their weaving/linking. A property +of the model is that the compilation requires no access to "target" +code, only the weaving/linking does, and weaving/linking is inherently +per-class local: No action at weaving/linking time depends on the +coordinated mangling of multiple classfiles. Rather, all weaving is done +on a per classfile basis. This is an essential property for the current +separate compilation model. + +However, allowing implementation of call advice on either side requires +simultaneous knowledge of both sides. If we first have access to a call, +we can't decide to simply put the advice on the call site, since later +we may decide to implement on the callee. + +This implementation decision is completely in the letter and the spirit +of the AspectJ language. From the semantics guide describing code the +implementation controls: + +____ +But AspectJ implementations are permitted to deviate from this in a +well-defined way -- they are permitted to advise only accesses in _code +the implementation controls_. Each implementation is free within certain +bounds to provide its own definition of what it means to control code. +____ + +And about a particular decision about the 1.0.6 implementation: + +____ +Different join points have different requirements. Method call join +points can be advised only if ajc controls _either_ the code for the +caller or the code for the receiver, and some call pointcut designators +may require caller context (what the static type of the receiver is, for +example) to pick out join points. +____ + +The 1.1 implementation makes a different design decision: Method call +join points can be advised only if ajc (in compiler or linker form) +controls the code for the caller. + +What does 1.1 gain from this? + +* a clear (and implemented) separate compilation model (see point 2, +above) +* a less confusing interaction between call join points and the +thisJoinPoint reflective object: We still get bug reports about source +information sometimes existing and sometimes not existing at call join +points. + +What does 1.1 lose from this? + +* The ability to capture all calls to Runnable.run() from anywhere to +code ajc has access too, even from Thread, even if you don't compile +java.lang with ajc. +* The ability to, without access to the caller, capture entry to a +particular method, but not super calls. +* A code-size-improvement performance optimization. + +What are the possibilities for the future? + +* AspectJ 1.1.1 could expand its capture of call join points, possibly +at the expense of separate compilation clarity, possibly not. +* AspectJ 1.1.1 could re-introduce reception join points from AspectJ +0.7 (what callee-side call join points actually are): though they would +never ever be taught in a tutorial or entry-level description of the +model, they may have specialized uses. + +How will this affect developers? + +* When using the call PCD but only supplying the callee code, supply the +calling code or use the execution PCD instead. + +==== [#OTHER_X_OPTIONS]#Various -X options# + +The AspectJ 1.0 compiler supported a number of options that started with +X, for "experimental". Some of them will not be supported in 1.1, either +because the "experiment" succeeded (in which case it's part of the +normal functionality) or failed. Others will be supported as is (or +nearly so) in 1.1: + +* -XOcodeSize: This is no longer necessary because inlining of around +advice is on by default. We support its inverse, +xref:#XNOINLINE[`-XnoInline`]. +* xref:#XNOWEAVE[-XnoWeave, a compiler option to suppress weaving] +* -XtargetNearSource: Not supported in this release. +* -XserializableAspects: Supported. +* -XaddSafePrefix: This option will not be supported in 1.1 at all +because we're now always using (what we believe to be) safe prefixes. +* -Xlint: Still supported, with xref:#XLINT[various options]. + +==== [#ERROR_MESSAGES]#Some confusing error messages# + +Building on the eclipse compiler has given us access to a very +sophisticated problem reporting system as well as highly optimized error +messages for pure Java code. Often this leads to noticeably better error +messages than from ajc-1.0.6. However, when we don't handle errors +correctly this can sometimes lead to cascading error messages where a +single small syntax error will produce dozens of other messages. Please +report any very confusing error messages as bugs. + +==== [#MESSAGE_CONTEXT]#Source code context is not shown for errors and warnings detected during bytecode weaving# + +For compiler errors and warnings detected during bytecode weaving, +source code context will not be displayed. In particular, for declare +error and declare warning statements, the compiler now only emits the +file and line. We are investigating ways to overcome this in cases where +the source code is available; in cases where source code is not +available, we might specify the signature of the offending code. For +more information, see bug 31724. + +==== [#XLINT]#The -Xlint option# + +`-Xlint:ignore,error,warning` will set the level for all Xlint warnings. +`-Xlint`, alone, is an abbreviation for `-Xlint:warning`. + +The `-Xlintfile:lint.properties` allows fine-grained control. In +tools.jar, see `org/aspectj/weaver/XlintDefault.properties` for the +default behavior and a template to copy. + +More `-Xlint` warnings are supported now, and we may add disabled +warnings in subsequent bug-fix releases of 1.1. Because the +configurability allows users to turn off warnings, we will be able to +warn about more potentially dangerous situations, such as the +potentially unsafe casts used by very polymorphic uses of proceed in +around advice. + +==== [#NO_SOURCE]#Source-specific options# + +Because AspectJ 1.1 does not generate source code after weaving, the +source-code-specific options -preprocess, -usejavac, -nocomment and +-workingdir options are meaningless and so not supported. + +==== [#NO_STRICT_LENIENT]#The -strict and -lenient options# + +Because AspectJ 1.1 uses the Eclipse compiler, which has its own +mechanism for changing strictness, we no longer support the -strict and +-lenient options. + +==== [#NO_PORTING]#The -porting option# + +AspectJ 1.1 does not have a -porting option. + +==== [#13_REQUIRED]#J2SE 1.3 required# + +Because we build on Eclipse, the compiler will no longer run under J2SE +1.2. You must run the compiler (and all tools based on the compiler) +using J2SE 1.3 or later. The code generated by the compiler can still +run on Java 1.1 or later VM's if compiled against the correct runtime +libraries. + +==== [#DEFAULT_CONSTRUCTOR_CONFLICT]#Default constructors# + +AspectJ 1.1 does not allow the inter-type definition of a zero-argument +constructor on a class with a visible default constructor. So this is no +longer allowed: + +.... + class C {} + + aspect A { + C.new() {} // was allowed in 1.0.6 + // is a "multiple definitions" conflict in 1.1 + } + +.... + +In the Java Programming Language, a class defined without a constructor +actually has a "default" constructor that takes no arguments and just +calls `super()`. + +This default constructor is a member of the class like any other member, +and can be referenced by other classes, and has code generated for it in +classfiles. Therefore, it was an oversight that AspectJ 1.0.6 allowed +such an "overriding" inter-type constructor definition. + +==== [#SUPER_IFACE_INITS]#Initialization join points for super-interfaces# + +In AspectJ, interfaces may have non-static members due to inter-type +declarations. Because of this, the semantics of AspectJ defines the +order that initializer code for interfaces is run. + +In the semantics document for AspectJ 1.0.6, the following promises were +made about the order of this initialization: + +. a supertype is initialized before a subtype +. initialized code runs only once +. initializers for supertypes run in left-to-right order + +The first two properties are important and are preserved in AspectJ 1.1, +but the third property is and was ludicrous, and was never properly +implemented (and never could be) in AspectJ 1.0.6. Consider: + +.... + interface Top0 {} + interface Top1 {} + interface I extends Top0, Top1 {} + interface J extends Top1, Top0 {} + + class C implements I, J {} + // I says Top0's inits must run before Top1's + // J says Top1's inits must run before Top0's + + aspect A { + int Top0.i = foo("I'm in Top0"); + int Top1.i = foo("I'm in Top1"); + static int foo(String s) { + System.out.println(s); + return 37; + } + } + +.... + +This was simply a bug in the AspectJ specification. The correct third +rule is: + +____ +the initializers for a type's superclass are run before the initializers +for its superinterfaces. +____ + +==== [#VOID_FIELD_SET]#Field Set Join Points# + +In AspectJ 1.0.6, the join point for setting a field F had, as a return +type, F's type. This was "java compatible" because field assignment in +java, such as "Foo.i = 37", is in fact an expression, and does in fact +return a value, the value that the field is assigned to. + +This was never "java programmer compatible", however, largely because +programmers have absorbed the good style of rarely using an assignment +statement in a value context. Programmers typically expect "Foo.i = 37" +not to return a value, but to simply assign a value. + +Thus, programmers typically wanted to write something like: + +.... + void around(): set(int Foo.i) { + if (theSetIsAllowed()) { + proceed(); + } + } + +.... + +And were confused by it being a compile-time error. They weren't +confused for long, and soon adapted to writing: + +.... + int around(): set(int Foo.i) { + if (theSetIsAllowed()) { + return proceed(); + } else { + return Foo.i; + } + } + +.... + +But there was definitely a short disconnect. + +On top of that, we were never shown a convincing use-case for returning +an interesting value from a set join point. When we revisited this +issue, in fact, we realized we had a long-standing bug in 1.0.6 dealing +with the return value of pre-increment expressions (such as ++Foo.i) +that nobody had found because nobody cares about the return value of +such join points. + +So, because it's easier to implement, and because we believe that this +is the last possibility to make the semantics more useful, we have made +set join points have a void return type in 1.1. + +==== [#XNOINLINE]#The -XnoInline Option# + +The `-XnoInline` option to indicate that no inlining of any kind should +be done. This is purely a compiler pragma: No program semantics (apart +from stack traces) will be changed by the presence or absence of this +option. + +==== [#TARGET_TYPES_MADE_PUBLIC]#Target types made public# + +Even in 1.0.6, the AspectJ compiler has occasionally needed to convert +the visibility of a package-level class to a public one. This was +previously done in an ad-hoc basis that took whole-program analysis into +account. With the incremental compilation model of AspectJ 1.1, we can +now specify the occasions when the compiler makes these visibility +changes. + +In particular, the types used in the `this`, `target`, and `args` +pointcuts are made public, as are the super-types from `declare parents` +and the exception type from `declare soft`. + +We believe the visibility changes could be avoided in the future with +various implementation tricks if they become a serious concern, but did +not encounter them as such a concern when they were done in the 1.0.6 +implementation. + +==== [#STRINGBUFFER]#String + now advised# + +In Java, the + operator sometimes results in StringBuffer objects being +created, appended to, and used to generate a new String. Thus, + +.... +class Foo { + String makeEmphatic(String s) { + return s + "!"; + } +} +.... + +is approximately the same at runtime as + +.... +class Foo { + String makeEmphatic(String s) { + return new StringBuffer(s).append("!").toString(); + } +} +.... + +In the design process of AspectJ 1.0.6 we didn't expose those +StringBuffer methods and constructors as join points (though we did +discuss it), but in 1.1 we do. + +This change is likely to affect highly wildcarded aspects, and can do so +in surprising ways. In particular: + +.... +class A { + before(int i): call(* *(int)) && args(i) { + System.err.println("entering with " + i); + } +} +.... + +may result in a stack overflow error, since the argument to println is +really + +.... +new StringBuffer("entering with ").append(i).toString() +.... + +which has a call to StringBuffer.append(int). In such cases, it's worth +restricting your pointcut, with something like one of: + +.... +call(* *(int)) && args(i) && !within(A) +call(* *(int)) && args(i) && !target(StringBuffer) +.... + +==== [#ONE_FOUR_METHOD_SIGNATURES]#The -1.4 flag and method signatures# + +Consider the following aspect + +.... +public aspect SwingCalls { + + pointcut callingAnySwing(): call(* javax.swing..*+.*(..)); + + before(): callingAnySwing() { + System.out.println("Calling any Swing"); + } +} +.... + +And then consider the two statements + +.... + JFrame frame = new JFrame(); + frame.setTitle("Title"); +.... + +According to the Java Language Specification version 2, the call to +`frame.setTitle("Title")` should always produce the bytecode for a call +to `javax.swing.JFrame.setTitle`. However, older compilers (and eclipse +when run without the `-1.4` flag) will generate the bytecode for a call +to `java.awt.Frame.setTitle` instead since this method is not overriden +by JFrame. The AspectJ weaver depends on the correctly generated +bytecode in order to match patterns like the one you show correctly. + +This is a good example of why the pattern +`call(* *(..)) && target(JFrame)` is the recommended style. In general, +OO programmers don't want to care about the static type of an object at +a call site, but only want to know the dynamic instanceof behavior which +is what the target matching will handle. + +=== [#knownLimitations]#Known limitations# + +The AspectJ 1.1.0 release contains a small number of known limitations +relative to the AspectJ 1.1 language. For the most up-to-date +information about known limitations in an AspectJ 1.1 release, see the +bug database at http://bugs.eclipse.org/bugs, especially the open bugs +for the +http://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&component=Compiler&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED[compiler], +http://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&component=IDE&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED[IDE +support], +http://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&component=Doc&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED[documentation], +and +http://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&component=Ant&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED[Ant +tasks]. Developers should know about bugs marked with the "info" keyword +because those bugs reflect failures to implement the 1.1 language +perfectly. These might be fixed during the 1.1 release cycle; find them +using the query +http://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&keywords=info +For ajc's 1.1 implementation limitations, see +link:progguide/implementation.html[Programming Guide Appendix: +"Implementation Notes"]. diff --git a/docs/dist/doc/README-12.adoc b/docs/dist/doc/README-12.adoc new file mode 100644 index 000000000..3aec6a919 --- /dev/null +++ b/docs/dist/doc/README-12.adoc @@ -0,0 +1,563 @@ +[.small]#© Copyright 2003,2004 Contributors. All rights reserved.# + +== AspectJ 1.2 Readme + +The definition of the AspectJ language is unchanged in the 1.2 release. +Instead, AspectJ 1.2 provides major improvements to the functionality of +the supporting tools and enforces some language limits that went +unchecked before. This document describes the tools differences between +AspectJ versions 1.2 and 1.1.1. Users new to AspectJ need only read the +link:progguide/index.html[AspectJ Programming Guide] since it describes +the 1.2 language. Users familiar with AspectJ 1.1 may find this document +a quicker way to learn what changed in the tools, and should use it as a +guide for porting programs from 1.1 to 1.2, together with porting.html. + +This document first summarizes changes from the 1.1.1 release in + +* xref:#compiler[the compiler], +* xref:#tools[the support tools], +* xref:#runtime[the runtime], +* xref:#devenv[the development environment support], + +then xref:#details[details] some of the changes, and finally points +readers to the bug database for xref:#allchanges[all the changes]. + +''''' + +=== [#compiler]#The Compiler# + +Compared to AspectJ 1.1.1, the AspectJ 1.2 compiler... + +* xref:#WEAVE_TIME[Is faster], with weaving completing in less than half +the time it used to take in many cases. +[#WEAVE_CHART]#image:images/AspectJ11v12.JPG[image]#. +* Supports the xref:#LAZY_TJP[-XlazyTjp option] which produces code that +runs faster and uses less memory in some common cases. +* Has xref:#INCREMENTAL[much better support for incremental +compilation]. +* Produces xref:#ERROR_MESSAGES[better error messages]. +* Has some xref:#LINT[new lint warnings] to catch common mistakes and +changes to serializability. +* Supports the xref:#REWEAVABLE[-Xreweavable option] that allows classes +to be woven more than once. +* {blank} +* Supports the xref:#INPATH[-inpath option] which allows both +directories and jars containing class files to be specified as input to +the weaver. +* xref:#COMPLIANCE[Changes the default compiler compliance mode] from +-1.3 to -1.4. + +A short description of the options ajc accepts is available with +"`ajc -help`". Longer descriptions are available in the +link:devguide/ajc-ref.html[Development Environment Guide section on +ajc]. + +''''' + +=== [#tools]#Support Tools# + +AspectJ 1.2 contains two important changes to the supporting tools: + +* xref:#AJDOC[ajdoc] is back +* A sample script is supplied for xref:#LTW[load-time weaving] from the +command-line. + +''''' + +=== [#runtime]#The Runtime Library# + +This release has minor updates to the runtime library classes. As with +any release, you should compile and run with the runtime library that +came with your compiler, and you may run with a later version of the +library without recompiling your code. + +* xref:#SOFTEX[`SoftException`] now supports `getCause()`. +* Although not part of `aspectjrt.jar` this release also provides a new +set of tools APIs in the xref:#LTW2[`org.aspectj.weaver.tools`] that +provide a weaving class loader and an adapter that can be used to +integrate load-time weaving into an existing class loader hierarchy. +* Cflow stack management has been modified to use thread local storage +on JVMs that support this feature. This improves performance in terms of +heap usage for multi-threaded applications that use cflow. + +''''' + +=== [#devenv]#The AJDE Tools# + +The AJDE based tools for JBuilder, NetBeans and Emacs continue to be +independent SourceForge projects. The AspectJ 1.2 distribution includes +an updated version of the AjBrowser tool that benefits from all the +enhancements made in the 1.2 compiler. + +The 1.2 release of AspectJ also lays a lot of the groundwork for a much +better AspectJ IDE experience that we hope to surface initially through +AJDT (AspectJ support for Eclipse). Amongst the many improvements, we +will have full eager parsing support that avoids the need to keep the +whole structure model of a project in memory, hopefully making AJDT much +less memory hungry and much slicker to use. For more details see the +http://www.eclipse.org/ajdt[AJDT project website]. + +''''' + +=== [#details]#Details# of some compiler changes + +==== [#WEAVE_TIME]#Compilation (weave) times reduced.# + +Our benchmark suite shows that AspectJ 1.2 is at least twice as fast in +the weaving phase as AspectJ 1.1.1 for matches based on a variety of +pointcut expressions (see the xref:#WEAVE_CHART[chart above]). We've +also made the base incremental compilation implementation in AspectJ 1.2 +approximately twice as fast as in AspectJ 1.1.1, so when this is +combined with the weave time improvements you should see speed-ups of up +to 4x for incremental compilation. + +In addition, AspectJ 1.2 maintains only weak references to some of its +recoverable data structures, allowing the JVM to optimise between +performance and memory usage. Experiments forcing GC showed that we can +achieve about a 20% memory usage reduction in this manner if needed. + +==== [#LAZY_TJP]#The -XlazyTjp option.# + +Under AspectJ 1.1.1, if the body of an advice contained a reference to a +non-statically determinable portion of `thisJoinPoint` (such as for +example a call to `getArgs()`), then a JoinPoint object was always +creating before entering the advice. This was the case even if the +advice was guarded with an `if()` pointcut that evaluated to false. + +AspectJ 1.2 now supports the `-XlazyTjp` option that only creates the +JoinPoint object just before dispatching to the advice body. By +promoting the guard to a test in an `if()` pointcut, the creation of the +JoinPoint object can be avoided altogether in the case where the test +returns false. + +Consider a simple tracing aspect as follows: + +.... + + public aspect Tracing { + + public static boolean enabled = false; + + pointcut toBeTraced() : execution(* *(..)) || execution(new(..)); + + before() : toBeTraced() && if(enabled) { + Object[] args = thisJoinPoint.getArgs(); + // format args and print out entry trace record etc.... + } + } + + +.... + +The most important consideration is the system overhead when tracing is +turned off. Using the `-XlazyTjp` option makes the program above run +10-100x faster, even when running a small test case with minimal GC +issues. The optimization is disabled at join points advised by around +advice, and an Xlint warning will be displayed in these cases. + +==== [#INCREMENTAL]#Improvements to incremental compilation.# + +AspectJ 1.2 provides more complete incremental compilation support than +AspectJ 1.1.1. Firstly, incremental compilation resulting from a change +to a source file is now approximately twice as fast as it was under +1.1.1 (even before taking the improvements to weaving time into +account). Secondly, the incremental coverage now takes into account +changes to resources, classes and jars on the inpath, injars, and +aspectpath. The new `inpath` option in AspectJ 1.2 allows directories to +be specified in addition to jars (just like a classpath) as input to the +weaver. Any update, addition or deletion of a class file in a directory +on the inpath will cause incremental (re)weaving. + +Changes to a jar file on the inpath, injars or aspectpath will now be +detected, but will trigger a full rebuild, as will any change to the +paths used to control compilation. + +==== [#ERROR_MESSAGES]#Improved error messages.# + +AspectJ 1.1.1 did not provide source context information for messages +produced during the weaving phase, even in the case where source files +were passed to the compiler. For example, an error message arising as a +result of a `declare error` statement might look as follows under +AspectJ 1.1.1: + +.... + BadClass.java:6 should not be calling bad methods + +.... + +whereas in AspectJ 1.2 you will see: + +.... + BadClass.java:6 error should not be calling bad methods + new C().bad(); + ^^^^^^^^^^^^^^ + method-call(void C.bad()) + see also: DeclareError.java:5 + +.... + +There are four new things to note about this error message. Firstly, +errors and warnings are now prefixed with the word "error", or "warning" +as appropriate. Secondly, the offending line of source is shown if +source code is available. Thirdly, in the case of weaver messages +arising as a result of `declare error` and `declare warning` statements, +AspectJ now shows not only the location of the error or warning, but +also the location of the `declare` statement itself. Finally, note that +messages produced as a result of `declare error` and `declare warning` +statements now also display the matched join point at the location of +the error: + +When source code is not available, the messages show the binary input +source (class file or jar file) in which the error or warning was +detected: + +.... + BadClass.java:6 error should not be calling bad methods + (no source information available) + method-call(void C.bad()) + see also: C:\...\DeclareError.java:5 + see also: C:\...\bin-input.jar + +.... + +This error message tells us that `BadClass.class` contained in a jar on +the inpath called `bin-input.jar`, and originally compiled from a source +file called `BadClass.java`, contains a join point +(`method-call(void C.bad())` matched by a `declare error` statement on +line 5 of the file `DeclareError.java`. + +==== [#LINT]#New lint warnings.# + +Consider the program: + +.... + + 01 class A { + 02 public void doIt() {...}; + 03 } + 04 + 05 class B extends A { + 06 public void doThisToo() {...}; + 07 } + 08 + 09 + 10 public class CallsAandB { + 11 + 12 public static void main(String[] args) { + 13 B b = new B(); + 14 A bInDisguise = new B(); + 15 + 16 b.doIt(); // AspectJ 1.2 matches here + 17 bInDisguise.doIt(); // this is never matched + 18 } + 19 + 20 } + 21 + 22 aspect CallPCDMatchingExample { + 23 + 24 before() : call(* B.doIt(..)) { + 25 System.out.println("About to call B.doIt(...)"); + 26 } + 27 + 28 } + + +.... + +Because the static type of `bInDisguise` is `A` (line 14), the call on +line 17 is never matched by the pointcut expression on 24, even though +the runtime type of `bInDisguise` is `B`. Type patterns matched in +`call` pointcut designators are matched based on static type matching. +Some users have found this static type matching confusing, and AspectJ +1.2 has a new Xlint warning (`unmatchedSuperTypeInCall`) which is +enabled by default. + +The compiler will now produce a warning whenever a call pointcut +designator does not match at a join point, and a user may have expected +it to. Compiling the above program using AspectJ 1.2 produces the +following compiler output: + +.... + + + CallsAandB.java:24 warning does not match because declaring type is A, if match desired use target(B) [Xlint:unmatchedSuperTypeInCall] + before() : call(* B.doIt(..)) { + ^^^^^^^^^^^^^^^ + see also: CallsAandB.java:17 + + + 1 warning + + + +.... + +The warning is telling us that the call pointcut associated with the +before advice on line 24 of the source file does not match at a join +point where the user may have expected it to. The source location +corresponding to the unmatched join point is indicated by the "see also" +line - in this case line 17 of the source file. At line 17 we find a +call to `bInDisguise.doIt()`. Since the static type of `bInDisguise` is +`A`, this call will never be matched. The warning also tells us a +possible solution if we intended the pointcut to match at this join +point: use `call(* doIt(..) && target(B)`. + +If you find warnings of this kind coming out when you use the AspectJ +1.2 compiler, the recommended fix is to switch to using the `target` +designator in place of a type pattern in the `call` pointcut expression. +Note that there is no loss of runtime efficiency here - runtime tests +are only added in the cases where it cannot be determined at compile +time whether the type of the receiver will match the type specified in +the `target` expression. Also note that `target` cannot be used in +`declare` statements. + +A new Xlint warning, `needsSerialVersionUIDField` (disabled by default) +will produce a warning at compile time if the process of weaving changes +the default `serialVersionUID` of a serializable class, and the class +does not define a `serialVersionUID`. By defining a `serialVersionUID` +field, the programmer can ensure that objects serialized without the +aspect present can be read by a version of the program in which the +aspect is present, and vice-versa. + +A complimentary Xlint warning, `brokeSerialVersionCompatibility` +(disabled by default) will produce a warning at compile time if the +process of weaving makes an incompatible change to a serializable class +(for example, through the addition of an inter-type declared field). + +==== [#REWEAVABLE]#The -Xreweavable option.# + +The new `-Xreweavable` option produces class files that contain enough +additional information in them that they can be rewoven. In time we hope +that this can become a standard option, replacing the current +`-Xnoweave` option. Using reweavable produces class files that can be +legally loaded by a JVM, whereas with noweave, it is too easy to produce +class files that will result in a verify error at runtime. The +reweavable option makes it easy to weave code many times without having +to decide which weave is the final one. In a future version of the +AspectJ compiler, producing reweavable class files may become the +default option. The trade-off at the moment is that reweavable class +files are currently approximately twice the size of their non-reweavable +counterparts. + +To ensure consistent semantics when reweaving, the AspectJ compiler +requires that all aspects that have previously modified a class file +during weaving be present in the system during a reweave. An error will +be issued if any are missing. + +==== [#INPATH]#The -inpath option.# + +The new `-inpath` option replaces the `-injars` option (which is still +supported for backwards compatibility). It allows both directories and +jar files to be specified using path separators to separate entries in +the path. This option makes it easy for class files produced as the +result of building one project to become binary input to the compilation +of a second project. + +==== [#COMPLIANCE]#The default compliance mode of the compiler has changed from -1.3 to -1.4.# + +The default AspectJ compiler compliance level is now 1.4 (whereas in +previous releases the default compliance level was 1.3). This has a +number of implications: + +* class files generated by the compiler are now JRE v1.2 and upwards +compatible. (At compliance level 1.3, AspectJ generated class files that +were compatible with JRE 1.1 also). +* `call` pointcuts may match more join points than in the same program +compiled at compliance level 1.3. + +The AspectJ compiler can be restored to 1.3 compliance settings by +specifying the "-1.3" option on the command-line. + +Consider again the following example program which illustrates the +differences in join point matching with the `call` pointcut designator +between 1.4 and 1.3 compliance levels. + +.... + + 01 class A { + 02 public void doIt() {...}; + 03 } + 04 + 05 class B extends A { + 06 public void doThisToo() {...}; + 07 } + 08 + 09 + 10 public class CallsAandB { + 11 + 12 public static void main(String[] args) { + 13 B b = new B(); + 14 A bInDisguise = new B(); + 15 + 16 b.doIt(); // AspectJ 1.2 matches here + 17 bInDisguise.doIt(); // this is never matched + 18 } + 19 + 20 } + 21 + 22 aspect CallPCDMatchingExample { + 23 + 24 before() : call(* B.doIt(..)) { + 25 System.out.println("About to call B.doIt(...)"); + 26 } + 27 + 28 } + + +.... + +When this program is compiled with AspectJ 1.2 using the default +compiler options, it will produce one line of output when it is +executed: + +`About to call B.doIt(...)` + +The same program compiled under AspectJ 1.1 (or using AspectJ 1.2 with +the -1.3 flag specified) does not produce any output when it is run. The +reason for the additional call pcd match is that prior to compliance +level 1.4, Java compilers produced bytecodes that call A.doIt() (the +defining type of the method), rather than B.doIt() (the declared type in +the program text). The generated call to A.doIt() is not matched by the +call pcd used in the before advice. At compliance level 1.4, the +bytecodes retain the declared type of the receiver in the program +source, generating a call to B.doIt(), which _is_ matched by the call +pcd. + +This is a good example of why the recommended style is to use +`call(* doIt(..)) && target(B)`, which always matches based on the +actual type of the receiver. + +''''' + +==== [#AJDOC]#The ajdoc tool makes a comeback in the AspectJ 1.2 distribution.# + +`ajdoc` (the AspectJ replacement for the `javadoc` tool) is once again +included in the AspectJ distribution. The `ajdoc` tool produces regular +javadoc that also shows advises and advised by relationships next to +methods and advice. A future enhancement will show inter-type +declarations in the target class too. + +*Known limitations:* Please note that `ajdoc` documents advice and +pointcut members, shows where advice applies and links affected members +back to the advice. It currently does not document or add structural +links for any inter-type declarations or other declare forms. + +Run the "ajdoc.bat" script just as you run javadoc. For a list of +accepted parameters run "ajdoc -help". For example, to document +everything in the Spacewar example run: + +> cd examples + +> ajdoc -d doc -private spacewar coordination + +`ajdoc` sample output for an aspect source file: + +image:images/ajdoc1.JPG[image] + +`ajdoc` sample output for advised methods: + +image:images/ajdoc2.JPG[image] + +==== [#LTW]#A sample script is supplied that supports load-time weaving from the command-line# + +The AspectJ 1.2 distribution ships with sample scripts for Windows and +Unix platforms that exploit AspectJ's binary weaving capabilities at +application load time. You will find these scripts in the +`doc/examples/ltw` directory of your AspectJ installation. + +The scripts allow you to set an environment variable, `ASPECTPATH`, +containing a path-separator delimited list of aspect-library jar files. +A Java application can then be launched using the "`aj`" script ("`aj`" +is to "`ajc`" as "`java`" is to "`javac`"). If the `ASPECTPATH` is unset +or empty, "`aj`" behaves exactly the same as "`java`", but if the +`ASPECTPATH` contains one or more aspect libraries, the aspects in the +library will be linked (woven) with the application code as it is +loaded. + +The `doc/examples/ltw` directory of your AspectJ installation contains a +sample application that demonstrates these capabilities. Following the +instructions in the `README` file in that directory, running +"`aj tracing.ExampleMain`" with `ASPECTPATH` unset produces the output: + +.... + c1.perimeter() = 12.566370614359172 + c1.area() = 12.566370614359172 + s1.perimeter() = 4.0 + s1.area() = 1.0 + c2.distance(c1) = 4.242640687119285 + s1.distance(c1) = 2.23606797749979 + s1.toString(): Square side = 1.0 @ (1.0, 2.0) + +.... + +If you set `ASPECTPATH` to include `../jars/tracingLib.jar`, and run +"`aj tracing.ExampleMain`" again, the output will be: + +.... + --> tracing.TwoDShape(double, double) + <-- tracing.TwoDShape(double, double) + --> tracing.Circle(double, double, double) + <-- tracing.Circle(double, double, double) + --> tracing.TwoDShape(double, double) + <-- tracing.TwoDShape(double, double) + --> tracing.Circle(double, double, double) + <-- tracing.Circle(double, double, double) + --> tracing.Circle(double) + <-- tracing.Circle(double) + --> tracing.TwoDShape(double, double) + <-- tracing.TwoDShape(double, double) + --> tracing.Square(double, double, double) + <-- tracing.Square(double, double, double) + --> tracing.Square(double, double) + <-- tracing.Square(double, double) + --> double tracing.Circle.perimeter() + <-- double tracing.Circle.perimeter() +c1.perimeter() = 12.566370614359172 + --> double tracing.Circle.area() + <-- double tracing.Circle.area() +c1.area() = 12.566370614359172 + --> double tracing.Square.perimeter() + <-- double tracing.Square.perimeter() +s1.perimeter() = 4.0 + --> double tracing.Square.area() + <-- double tracing.Square.area() +s1.area() = 1.0 + --> double tracing.TwoDShape.distance(TwoDShape) + --> double tracing.TwoDShape.getX() + <-- double tracing.TwoDShape.getX() + --> double tracing.TwoDShape.getY() + <-- double tracing.TwoDShape.getY() + <-- double tracing.TwoDShape.distance(TwoDShape) + etc... + +.... + +The scripts only support JDK 1.4 and above - attempting to use them with +a 1.3 or lower JDK will most likely produce `NoClassDefFound` errors. We +welcome contributions from users to improve these scripts. + +''''' + +==== [#SOFTEX]#SoftException now supports getCause()# + +`org.aspectj.lang.SoftException` now supports the `getCause()` method, +which returns the original exception wrapped by the `SoftException`. +This means that exception chains will print correctly on 1.4 and later +JREs. + +==== [#LTW2]#org.aspectj.weaver.tools package added# + +A new set of public APIs are exported by the +link:api/index.html[`org.aspectj.weaver.tools`] package that can be used +to integrate load-time weaving into an existing class loader hierachy. +The package implementation is included in `aspectjtools.jar`. For an +example of how to use these APIs, see the +`org.aspectj.weaver.WeavingURLClassLoader` implementation. + +''''' + +[#allchanges]## + +=== All changes are listed in the bug database + +For a complete list of changes in the 1.2 release, search for +`target 1.2` in the bug database: +https://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&component=Compiler&target_milestone=1.2 diff --git a/docs/dist/doc/README-121.adoc b/docs/dist/doc/README-121.adoc new file mode 100644 index 000000000..f2a66fda0 --- /dev/null +++ b/docs/dist/doc/README-121.adoc @@ -0,0 +1,134 @@ +[.small]#© Copyright 2004 Contributors. All rights reserved.# + +== AspectJ 1.2.1 Readme + +AspectJ 1.2.1 is largely a bug-fix release and the definition of the +AspectJ language is unchanged from the 1.2.0 release (with the exception +that AspectJ 1.2.1 permits the use of the '+' operator to concatenate +the messages for declare error and warning statements). This document +describes the tools differences between AspectJ versions 1.2 and 1.2.1. +Users familiar with AspectJ 1.2 may find this document a quicker way to +learn what changed in the tools. + +This document summarizes changes in: + +* Weaver messages +* Dump support +* JDT Compiler version +* Line number information for join points +* Runtime performance +* String concatentation in declare error and warning statements +* Load-time weaving support +* Use of aspect libraries generated by ajc 1.2.1 with earlier versions +of ajc + +See the link:changes.html[changes document] for more details, or +xref:#allchanges[all the changes] as detailed in the bugzilla database. + +=== Weaver Informational Messages + +The AspectJ 1.2.1 compiler can produce informational messages about the +weaving process. To see these messages, use the -showWeaveInfo compiler +option, or set showweaveinfo=true in the iajc ant task. + +The following is an example of the messages produced when this option is +enabled: + +.... + C:\aspectj1.2.1\doc\examples\tjp>ajc -showWeaveInfo *.java + + Type 'tjp.Demo' (Demo.java:20) advised by around advice from 'tjp.GetInfo' + (GetInfo.java:26) [RuntimeTest=true] + + Type 'tjp.Demo' (Demo.java:30) advised by around advice from 'tjp.GetInfo' + (GetInfo.java:26) [RuntimeTest=true] + + Type 'tjp.Demo' (Demo.java:34) advised by around advice from 'tjp.GetInfo' + (GetInfo.java:26) [RuntimeTest=true] +.... + +=== Dump Support + +In the event of a compiler crash, AspectJ 1.2.1 will produce a dump file +giving important information about the state of the compiler at the time +of the crash. These dump files should enable us to analyze problems more +effectively. In the rare event that you witness a compiler crash, please +attach the dump file to the bug report. + +In addition to producing a dump file when an abort condition is +detected, the AspectJ 1.2.1 compiler can also be requested to create a +dump file on detection of a compilation error. Set the property +org.aspectj.weaver.Dump.condition=error to enable this behaviour. + +=== JDT Compiler Version + +AspectJ 1.2.1 is based on the Eclipse 3.0 final JDT compiler. + +=== Line Number Information for Join Points + +For source files compiled by ajc (as opposed to binary inputs to the +compiler compiled with some other java compiler), ajc now emits better +line number information for execution join points. In particular, for a +method, constructor or advice execution join point (as matched for +example by a declare error or declare warning statement), ajc 1.2.1 +reports the first line number of the declaration, as opposed to the line +number of the first line of code in the body. + +=== Runtime Performance + +AspectJ 1.2.1 contains a small number of runtime performance +optimisations, including optimisations of if(true) and if(false) +pointcut expressions, caching of getSignature() and toString() results +on JoinPoint objects, and an optimised implementation of cflow. + +In the case where there are no arguments bound in the cflow pointcut, +programs compiled under AspectJ 1.2.1 and that make heavy use of cflow +will run significantly faster. Thanks to the abc compiler team for +detecting this performance related bug and for piloting the fix. + +=== String Concatentation in Declare Error/Warning Statements + +String concatentation in declare error and warning statements is now +supported. For example, you can write: + +.... + declare warning : jdbcCall() && !inDataLayer() + : "Please don't make calls to JDBC " + + "outside of the data layer."; + +.... + +=== Load-time Weaving Support + +The AspectJ 1.2.1 distribution contains a new jar in the lib directory, +aspectjweaver.jar, that contains the subset of aspectjtools.jar needed +for weaving only. This jar may be used in situations where you wish to +exploit AspectJ's binary weaving capabilities, but do not want the full +aspectjtools.jar around (aspectjweaver.jar is approx. 5 times smaller). + +In addition, the load-time weaving "aj" script which was included in the +doc/examples/ltw directory in the 1.2 distribution has been moved into +the regular bin directory. See link:README-12.html[README-12] for +details of using this script. + +=== Binary Compatibility + +AspectJ 1.2.1 introduces a backwards-incompatible change to the class +file format generated by the AspectJ compiler. Classes generated by ajc +v1.2.1 cannot be used on the inpath or aspectpath of a weaver from a +prior version of the compiler. Classes generated by prior versions of +the compiler can of course be placed on the inpath or aspectpath of the +1.2.1 weaver. + +As ever, you should use the AspectJ runtime library (aspectjrt.jar) that +comes with the distribution you used to build your application. + +''''' + +[#allchanges]## + +=== All changes are listed in the bug database + +For a complete list of changes in the 1.2.1 release, search for +`target 1.2.1` in the bug database: +https://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&component=Compiler&target_milestone=1.2.1[https://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&target_milestone=1.2.1&bug_status=RESOLVED&resolution=FIXED] diff --git a/docs/dist/doc/README-150.adoc b/docs/dist/doc/README-150.adoc new file mode 100644 index 000000000..3e553f239 --- /dev/null +++ b/docs/dist/doc/README-150.adoc @@ -0,0 +1,21 @@ +[.small]#© Copyright 2005 Contributors. All rights reserved.# + +== AspectJ 5 Readme + +AspectJ 5 introduces several important changes to the language and tools +in order to support Java 5 and extend the capabilities of AspectJ in +general. For language changes, see link:adk15notebook/index.html[AspectJ +5 Developer's Notebook]. For tools changes, see the +link:devguide/index.html[AspectJ Development Environment Guide], +especially the section on link:devguide/ltw.html[Load-time weaving]. The +changes are summarized in the faq.html#q:aspectj5features[FAQ entry on +AspectJ 5]. + +Some of the other documentation has not been updated for AspectJ 5. For +the latest documentation, see +http://eclipse.org/aspectj/doc/next/index.html , linked off +http://eclipse.org/aspectj/docs.php[the AspectJ documentation home page] +. + +For information on bug fixes in AspectJ 5 v1.5.0, see the +link:changes.html[changes] document. diff --git a/docs/dist/doc/README-151.adoc b/docs/dist/doc/README-151.adoc new file mode 100644 index 000000000..6216cd0c3 --- /dev/null +++ b/docs/dist/doc/README-151.adoc @@ -0,0 +1,22 @@ +[.small]#© Copyright 2006 Contributors. All rights reserved.# + +== AspectJ 5 v1.5.1 Readme + +This release is primarily a bug fix and performance / memory usage +release. Over 70 fixes and enhancements have been incorporated since +1.5.0, you can see the list through +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&product=AspectJ&target_milestone=1.5.1&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED[this +bugzilla query]. + +AspectJ 1.5.1 has significantly lower memory usage than AspectJ 1.5.0, +especially when building inside of AJDT. The improvements are also +noticeable when batch building with Ant, or when load-time weaving. +Batch building a project with over 1000 source files with both AspectJ +1.5.1 and AspectJ 1.5.0 shows a 16% reduction in peak memory usage, and +an 8% reduction in heap consumed by temporary objects. The AspectJ 1.5.1 +compiler integrated into AJDT gives memory savings of at least 50%. The +greater savings in the AJDT environment are due to improvements in areas +such as structure model generation that are not exercised + +For information on bug fixes in AspectJ 5 v1.5.1, see the +link:changes.html[changes] document. diff --git a/docs/dist/doc/README-152.adoc b/docs/dist/doc/README-152.adoc new file mode 100644 index 000000000..ec41e1488 --- /dev/null +++ b/docs/dist/doc/README-152.adoc @@ -0,0 +1,30 @@ +[.small]#© Copyright 2006 Contributors. All rights reserved.# + +== AspectJ 5 v1.5.2 Readme + +This release is primarily a bug fix release. It includes approximately +60 fixes and enhancements that have been incorporated since the 1.5.1 +release. You can see the full list through +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&product=AspectJ&target_milestone=1.5.2&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED[this +bugzilla query]. + +Notable changes since the 1.5.1 release include: + +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=126167[[126167]] The +handling of proceed in @Around advice has changed to be more compatible +with code style. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=147711[[147711]] Members +generated as a result of the AspectJ weaving process are now marked Java +synthetic - enabling coverage tools such as Emma to process woven +classes correctly. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=138316[[138316]] AspectJ +has now transitioned from the CPL to the EPL license. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=140695[[140695]] Using a +more optimal world for managing types when load-time weaving - reduces +heap usage (work in progress). +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=101983[[101983]] AspectJ +can now support separate output folders for each input source folder - +enables AJDT to behave more like JDT. + +For information on bug fixes in AspectJ 5 v1.5.2, see the +link:changes.html[changes] document. diff --git a/docs/dist/doc/README-153.adoc b/docs/dist/doc/README-153.adoc new file mode 100644 index 000000000..8b1c065f1 --- /dev/null +++ b/docs/dist/doc/README-153.adoc @@ -0,0 +1,121 @@ +[.small]#© Copyright 2006 Contributors. All rights reserved.# + +== AspectJ 5 v1.5.3 Readme + +This release includes a number of bug fixes and enhancements (over 80). +The full list of resolved issues can be found with +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=AspectJ&target_milestone=1.5.3&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&emailtype1=substring&email1=&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=[this +bugzilla query]. + +Notable changes since the 1.5.2 release include: + + +=== Pipeline compilation - https://bugs.eclipse.org/bugs/show_bug.cgi?id=146781[146781] + +Until this release, the memory profile for AspectJ looked like this +(time is along the X axis, memory usage is the Y axis) + +`` + +.... + /\_ + / \_ + / \_ + / \_ + / \_ +/ \ +.... + +The first phase (as we go up and up and up) is the compilation of every +file - when the peak is reached we then start weaving files one by one, +discarding them once woven and dumped to disk. In 1.5.3 we don't compile +everything up front - we compile and weave files one at a time. Giving +us this profile: + +`` + +.... + /\ /\ /\ + / \/ \/ \ +/ \ +.... + +Each peak is compiling a file, then it is woven, dumped to disk and the +space recovered (the trough) - we then move onto the next file. What +does this mean? The peaks are far far lower, so you need far less memory +to compile a project. For example, I have a 1000file project, affected +by aspects at >750 join points. For given values of Xmx, here are the +times taken to compile it (on the command line) with AspectJ1.5.2: + +.... +Xmx Time +512M 33seconds +256M 40seconds +220M 116seconds +212M OutOfMemory +.... + +The times gradually increase as the memory is reduced because the VM +starts to thrash in garbage collection. Here are the results for +AspectJ1.5.3: + +.... +Xmx Time +512M 33s +256M 33s +180M 33s +140M 33s +100M 35s +80M 43s +70M OutOfMemory +.... + +So with 1.5.3, it isn't until around 80M that the VM starts to struggle +with memory. These savings will affect any code built from source: on +the command line, in Ant, or in AJDT. It will not affect binary weaving +- that is a future enhancement. + +=== Serviceability - https://bugs.eclipse.org/bugs/show_bug.cgi?id=150487[150487] + +As AspectJ grows in popularity, we find that it is becoming more +difficult for users to come up with the small testcases that recreate +problems - the usage scenarios for AJ are becoming more and more +sophisticated. To help us work on problems in these scenarios we have +added a tracing and logging framework and improved our dump mechanism. +These traces and dumps can be attached to bug reports. In AspectJ 1.5.3 +we have included some +http://www.eclipse.org/aspectj/doc/released/pdguide/index.html[documentation] +on how to configure these new features. Don't be surprised if you get +asked for an AspectJ trace on a future bug report! + +=== LTW enhancements + +==== User and System Configuration Files - https://bugs.eclipse.org/bugs/show_bug.cgi?id=149289[149289] + +The `-outxml` option now generates a file named `META-INF/aop-ajc.xml`. +This no longer clashes with a user defined `META-INF/aop.xml` +configuration file. Both file names along with an OSGi-friendly +`org/aspectj/aop.xml` (which can also be signed) are used by default to +configure LTW. + +==== Weaving Concrete Aspects Defined in aop.xml - https://bugs.eclipse.org/bugs/show_bug.cgi?id=132080[132080] + +Concrete aspects defined using aop.xml are now exposed for weaving. + +=== Pertypewithin enhancement - https://bugs.eclipse.org/bugs/show_bug.cgi?id=123423[123423] + +It is now possible to ask an instance of a ptw aspect which type it is +'attached' to. The method: + +`` + +.... +String getWithinTypeName() +.... + +can be called on an aspect and will return the full qualified name of +the type (eg. "com.foo.MyClass") + +''''' + +For information on bug fixes in AspectJ 5 v1.5.3, see the +link:changes.html[changes] document. diff --git a/docs/dist/doc/README-154.adoc b/docs/dist/doc/README-154.adoc new file mode 100644 index 000000000..4565910d8 --- /dev/null +++ b/docs/dist/doc/README-154.adoc @@ -0,0 +1,16 @@ +[.small]#© Copyright 2006 Contributors. All rights reserved.# + +== AspectJ 5 v1.5.4 Readme + +This release includes a number of bug fixes and enhancements. The full +list of resolved issues can be found with +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=AspectJ&target_milestone=1.5.4&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&emailtype1=substring&email1=&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=[this +bugzilla query]. + +Some key fixes include better handling of generic type declarations, +both in regular Java classes and in combination with AspectJ constructs +(for example, inter-type declarations) + + + + +''''' diff --git a/docs/dist/doc/README-160.adoc b/docs/dist/doc/README-160.adoc new file mode 100644 index 000000000..cba5ce076 --- /dev/null +++ b/docs/dist/doc/README-160.adoc @@ -0,0 +1,165 @@ +[.small]#© Copyright 2008 Contributors. All rights reserved.# + +== AspectJ v1.6.0 Readme + +=== AspectJ v1.6.0 - 23 Apr 2008 + +For the complete list of every issue addressed since the last full +release, see +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=AspectJ&target_milestone=1.6.0+M1&target_milestone=1.6.0+M2&target_milestone=1.6.0+RC1&target_milestone=1.6.0&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&emailtype1=substring&email1=&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=[this +bugzilla link]. + +Some of the highlights of 1.6.0 are: + +==== Upgrade to a Java 1.6 compiler + +AspectJ1.6.0 upgrades the internal Eclipse compiler level to version +785_R33x - a Java 1.6 level compiler + +==== Better incremental compilation support in the IDE + +Changes under https://bugs.eclipse.org/bugs/show_bug.cgi?id=221427[bug +221427] mean that the compiler is better able to maintain incremental +state for projects in Eclipse and determine whether full builds or +incremental builds are required when project dependencies change. The +result is that the compiler will more frequently do an incremental build +rather than falling back to doing a full build. Some basic performance +findings can be seen in +http://dev.eclipse.org/mhonarc/lists/aspectj-users/msg09002.html[this +mailing list post]. + +==== Parameter annotation matching + +Parameter matching is possible for constructors and methods. The use of +parentheses around the parameter types in a method signature determine +whether the annotations relate to the type of the parameter or the +parameter itself. + +.... +execution(* *(@A *)); +.... + +- Execution of a method/ctor whose first parameter is of a type +annotated with @A. + +.... +execution(* *(@A (*))); +.... + +- Execution of a method/ctor whose first parameter is annotated with @A + +.... +execution(* *(@A (@B *))) +.... + +- Execution of a method/ctor whose first parameter is annotated with @A +and is of a type annotated with @B. Example: + +.... +------ Start of Test.java ----- +@interface A {} +@interface B {} + +class C { + public void foo(@A String s) {} + public void goo(@A @B String s) {} +} + +aspect X { + before(): execution(* *(@A (*))) {} + before(): execution(* *(@B (*))) {} +} +------ End of Test.java ----- +$ ajc -showWeaveInfo -1.6 Test.java +Join point 'method-execution(void C.foo(java.lang.String))' in Type 'C' (A.java:5) advised by before advice from 'X' (A.java:10) + +Join point 'method-execution(void C.goo(java.lang.String))' in Type 'C' (A.java:6) advised by before advice from 'X' (A.java:11) + +Join point 'method-execution(void C.goo(java.lang.String))' in Type 'C' (A.java:6) advised by before advice from 'X' (A.java:10) +.... + +The first piece of advice matched both methods. The second only matched +goo(). + + + + +==== Annotation Value Matching + +This allows static matching of the values of an annotation - if the +matching is done statically at weave time, it is possible to avoid some +of the reflection that is currently required within the advice (in some +cases). A typical use case is tracing where the trace level is defined +by an annotation but may be switched OFF for a method if the annotation +has a particular value. Perhaps tracing has been turned on at the type +level and a few critical methods should not get traced. Here is some +code showing the use case: + +.... +enum TraceLevel { NONE, LEVEL1, LEVEL2, LEVEL3 } + +@interface Trace { + TraceLevel value() default TraceLevel.LEVEL1; +} + +aspect X { + // Advise all methods marked @Trace except those with a tracelevel of none + before(): execution(@Trace !@Trace(TraceLevel.NONE) * *(..)) { + System.err.println("tracing "+thisJoinPoint); + } +} + +public class ExampleOne { + + public static void main(String[] args) { + ExampleOne eOne = new ExampleOne(); + eOne.m001(); + eOne.m002(); + eOne.m003(); + eOne.m004(); + eOne.m005(); + eOne.m006(); + eOne.m007(); + } + + @Trace(TraceLevel.NONE) + public void m001() {} + + @Trace(TraceLevel.LEVEL2) + public void m002() {} // gets advised + + @Trace(TraceLevel.LEVEL3) + public void m003() {} // gets advised + + @Trace(TraceLevel.NONE) + public void m004() {} + + @Trace(TraceLevel.LEVEL2) + public void m005() {} // gets advised + + @Trace(TraceLevel.NONE) + public void m006() {} + + @Trace + public void m007() {} // gets advised + +} +.... + +Matching is currently allowed on all annotation value types *except* +class and array. Also it is not currently supported for parameter +annotation values. + +==== Changes since release candidate + +The only fix 1.6.0 final includes beyond the release candidate is a +multi-threading problem in the weaver - +https://bugs.eclipse.org/bugs/show_bug.cgi?id=227029[bug 227029]. + +==== Releases leading up to AspectJ 1.6.0 + +AspectJ v1.6.0rc1- 16 Apr 2008 + +AspectJ v1.6.0M2 - 26 Feb 2008 + +AspectJ v1.6.0M1 - 16 Jan 2008 + +''''' diff --git a/docs/dist/doc/README-161.adoc b/docs/dist/doc/README-161.adoc new file mode 100644 index 000000000..2cea859bb --- /dev/null +++ b/docs/dist/doc/README-161.adoc @@ -0,0 +1,178 @@ +[.small]#© Copyright 2008 Contributors. All rights reserved.# + +== AspectJ 1.6.1 Readme + +The main themes of AspectJ1.6.1 are better memory usage and faster +weaving. This has been achieved through profiling of the weaving process +and has resulted in some serious refactoring of the weaver component +within AspectJ. It provides exactly the same functionality as in +previous releases, it just weaves faster now, using less code and less +memory. This readme will give an overview of the kind of changes made +and what can be expected when using 1.6.1 compared to previous releases. + +The complete list of issues resolved for AspectJ 1.6.1 can be found with +these bugzilla queries. The first lists bugs addressed (more than 60!) +whilst the second details enhancements made in this release. + +* https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=AspectJ&target_milestone=1.6.1&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&bug_severity=blocker&bug_severity=critical&bug_severity=major&bug_severity=normal&bug_severity=minor&bug_severity=trivial&emailtype1=substring&email1=&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=[Bugs +resolved] +* https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=AspectJ&target_milestone=1.6.1&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&bug_severity=enhancement&emailtype1=substring&email1=&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=[Enhancements +implemented] + +''''' + +=== Refactored (https://bugs.eclipse.org/bugs/show_bug.cgi?id=231396[bug 231396]) + +The bugzilla entry goes into more specifics on what has changed, the end +result is that aspectjweaver.jar has had around 275 classes removed +(about 25%) and has slimmed down by 350k (about 20%). In terms of +performance for different scenarios: + +==== Straight compilation + +The refactoring effort has been focused on the weaver component, hence +there is limited impact on the performance of source compilation but +this comparison shows it is faster. Four scenarios are compared, in each +scenario a different aspect is applied to the JDT compiler (just as a +sample piece of source code). + +. 1100 source files, few aspects that target 859 join points. +. 1100 source files, code style trace aspect targeting public methods +(22000 join points) +. 1100 source files, annotation style trace aspect (22000 join points) +. 1100 source files, insane aspect (before(): within(*) \{}) (203000 +join points) + +image:perfSourceCompile_161.jpg[image] + +==== Binary weaving + +Moving on from source compilation to pure binary weaving, the +improvements are more obvious. Here we are using the complete JVM +classes jar 'rt.jar' as an example of a large jar file for weaving. + +. Binary weaving rt.jar (~12000 classes) with a simple aspect (1200 join +points) +. Binary weaving rt.jar (~12000 classes) with a code style trace aspect +(121000 join points) +. Binary weaving rt.jar (~12000 classes) with an annotation style trace +aspect (121000 join points) +. Binary weaving rt.jar (~12000 classes) with an insane aspect +(before(): within(*) \{}) (352000 join points) + +image:perfBinaryWeave_161.jpg[image] + +==== Loadtime weaving + +The loadtime weaving improvements are similar to those seen for binary +weaving (naturally). Here we are using the JDK tools jar 'tools.jar' as +an example of a jar file for loadtime weaving. + +. Binary weaving tools.jar (~1900 classes) with a code style trace +aspect +. Binary weaving tools.jar (~1900 classes) with an insane aspect +(before(): within(*) \{}) + +image:perfLTW_161.jpg[image] + +The refactoring work has also reduced the amount of unnecessary garbage +created on the heap during the weaving process. The next comparison +shows roughly the reduction in amount of 'stuff' created on the heap +during a weave. This isn't the max heap required to do a weave, it is +just showing how many less temporary objects are allocated during an +entire run of the weaver + +. First, the number of kilobytes of memory allocated from the heap +during a weave of tools.jar with a code style trace aspect +. Second, another run of the same thing +. Third, this time using the insane aspect + +image:heapContents_161.jpg[image] + +So in terms of memory required, weaving the insane aspect into tools.jar +created 1.4G of 'stuff' over the entire weaving process, compared to +1.75G with 1.6.0. + +==== Loadtime weaving stress + +As well as addressing the memory usage of a single load time weaver, we +have also looked at the use of load time weaving in a larger scale +scenario, where multiple classloaders are being instantiated and +discarded over time and each has an associated load time weaver. Under +https://bugs.eclipse.org/bugs/show_bug.cgi?id=210470[bug 210470] we +looked in detail at whether the lifecycle of the weaver instance +correctly matched the lifecycle of the associated classloader. It did +not, but now it does! Here is a memory usage graph for AspectJ1.6.1 - +this shows an application that spawns 7 threads which run continuously +for a few minutes. Each thread repeatedly creates a classloader, weaves +500 classes using it then discards the classloader. You can see that +over time the memory is recovered correctly and when all threads +complete (and all classloaders are orphaned), all the weavers are +discarded. + +First, AspectJ 1.6.0, in which memory was never correctly recovered and +so an OutOfMemory problem would always occur eventually. + +image:memLtwStress_160.jpg[image] + +And now AspectJ 1.6.1: + +image:memLtwStress_161.jpg[image] + +=== Incremental compilation + +Following on from the work done to improve compilation under Eclipse in +AspectJ 1.6.0 (https://bugs.eclipse.org/bugs/show_bug.cgi?id=221427[Bug +221427] ) - we now support the building of 'broken code' +(https://bugs.eclipse.org/bugs/show_bug.cgi?id=102733[bug 102733]). This +is something the JDT has always been doing - where code containing +errors continues to build (if recovery is possible) but should the +actual methods containing the errors get invoked, an exception will be +thrown at runtime. A number of users typically extract large projects +from their library systems, knowing that they will only partially build +in their current eclipse setup, but as long at they do not invoke the +code containing the errors then they expect the rest of the project to +run normally. AspectJ now allows this mode of operation, and it has the +additional effect that the state of the project stays consistent, albeit +with known errors, and this means AspectJ will more frequently do +incremental builds rather than falling back to full builds because there +was a compilation error. + +=== Language changes + +==== Optmized syntax for annotation value binding (https://bugs.eclipse.org/bugs/show_bug.cgi?id=234943[Bug234943]) + +If only binding an annotation at a method-execution join point in order +to access an *enum value* within it, there is a more optimal syntax that +can be used to produce faster code. Given this setup: + +`` + +.... +enum Colour { RED,GREEN,BLUE;} + +@interface ColouredAnnotation { Colour value(); } + +@ColouredAnnotation(Colour.RED) +public void colouredMethod() { } +.... + +Current syntax: + +.... +before(ColouredAnnotation anno): execution(* *(..)) && @annotation(anno) { + printTheColour(anno.value()); +} +.... + +New optional syntax: + +`` + +.... +before(Colour col): execution(* *(..)) && @annotation(ColouredAnnotation(col)) { + printTheColour(col); +} +.... + +''''' diff --git a/docs/dist/doc/README-1610.adoc b/docs/dist/doc/README-1610.adoc new file mode 100644 index 000000000..faf6b85d6 --- /dev/null +++ b/docs/dist/doc/README-1610.adoc @@ -0,0 +1,47 @@ +[.small]#© Copyright 2010 Contributors. All rights reserved.# + +== AspectJ 1.6.10 Readme + +The full list of resolved issues in 1.6.10 is available +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;product=AspectJ;target_milestone=1.6.10;target_milestone=1.6.10M1;target_milestone=1.6.10M2;target_milestone=1.6.10RC1[here] + +=== Changes + +1.6.10 is primilarily just bug fixes for AspectJ, mainly in the areas of +ITDs and generic aspects. However, there are a couple of important +changes that users ought to be aware of: + +==== AJDT Memory usage + +Type demotion has been in use during loadtime weaving for a while now, +this enables the load time weavers to discard state and recover it at a +later time (and so generally run with a smaller memory footprint). Type +demotion is now supported under AJDT in Eclipse and will enable AJDT to +run with smaller heaps. This feature is still experimental and needs +turning ON if you want to try it out. To turn it on, open your AspectJ +project properties in eclipse and in the AspectJ Compiler section, +scroll down to 'Other' and in the non-standard compiler options setting, +specify: + +.... +-Xset:minimalModel=true,typeDemotion=true +.... + +If I can get enough positive feedback about this option, it will be made +the default. For a more detailed write up, check out the blog post: +http://andrewclement.blogspot.com/2010/07/ajdt-memory-usage-reduction.html + +==== Runtime changes + +A big thank you to Abraham Nevado and his team who have been working on +some issues to optimize loadtime weaving and the code generated by +AspectJ. 1.6.10 includes some new changes to the aspectjrt.jar. The +changes are new methods that enable the woven code to be a little +shorter/neater. As we want to continue to have compatibility with older +aspectjrt.jar a user needs to choose to activate these optimizations by +specifying the option: -Xset:targetRuntime1_6_10=true. With that option +on you will need to ensure you run against the aspectjrt.jar from a +1.6.10 build. + +The changes are discussed in +https://bugs.eclipse.org/bugs/show_bug.cgi?id=323438[bug 323438] diff --git a/docs/dist/doc/README-1611.adoc b/docs/dist/doc/README-1611.adoc new file mode 100644 index 000000000..e240e36f4 --- /dev/null +++ b/docs/dist/doc/README-1611.adoc @@ -0,0 +1,106 @@ +[.small]#© Copyright 2010-2011 Contributors. All rights reserved.# + +== AspectJ 1.6.11 Readme + +The full list of resolved issues in 1.6.11 is available +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;product=AspectJ;target_milestone=1.6.11;[here] + +. + +=== 1.6.11 available 15-03-2011 + +=== Notable Changes + +==== RC1 - Our own XML parser + +Due to the way AspectJ loads one of the standard XML parsers (for +processing aop.xml) it was possible to get into a deadlock situation. To +avoid this completely we now have our own XML parser inside for +processing this files. It is basic but should support all the known +syntax we have for aop files. To use it instead of the default (if you +are encountering the deadlock) you need to specify this system property: +org.aspectj.weaver.loadtime.configuration.lightxmlparser=true. + +''''' + +==== M2 - Multithreaded world access + +The weaver is backed by a representation of types called a world. +Traditionally the worlds have supported single threads - and that is how +they are used when doing compile time weaving or load time weaving. +However in some configurations, e.g. pointcut matching under Spring, a +single world instance may be getting accessed by multiple threads at the +same time. Under +https://bugs.eclipse.org/bugs/show_bug.cgi?id=337855[bug337855] some +changes have been made to better support this kind of configuration. + +==== M2 - various attribute deserialization issues + +In 1.6.9 we made some radical changes to the serialized form. It turns +out some of the deserialization code wasn't handling these new forms +quite right. This would manifest as an IllegalStateException or +IndexOutOfBoundsException or similar, during attribute unpacking. These +issues have now all been sorted out in 1.6.11.M2. + +==== M2 - further optimizations in model for AJDT + +More changes have been made for users trying out the +-Xset:minimalModel=true option to try and reduce the memory used in +their Eclipse/AJDT configurations. This option is discussed in detail +http://andrewclement.blogspot.com/2010/07/ajdt-memory-usage-reduction.html[here]. +It now saves even more memory. Also, previously the amount of memory it +recovered depended on compilation order (which the user has no control +over), but now it is insensitive to ordering and should always recover +the same amount across builds of the same project. With a bit more +positive feedback on this option, it will become the default under AJDT. + +==== M2 - spaces in path names can cause problems + +AspectJ had problems if the paths it was being passed (e.g. aspectpath) +included spaces. This is bug +https://bugs.eclipse.org/bugs/show_bug.cgi?id=282379[282379] and has now +been fixed. + +''''' + +==== M1 - Annotation removal + +Traditionally AspectJ has taken an additive approach, where +methods/fields/supertypes/annotations can only be added to types. Now, +chaos would likely ensue if we allowed removal of supertypes, methods, +etc, but we are seeing an increasing number of requirements to do more +with annotations. What kinds of thing? Basically remove existing +annotations, or modify existing annotations by changing their values. +1.6.11 includes a new piece of syntax that we are thinking might be +appropriate for one of these scenarios. 1.6.11 supports this: + +.... +declare @field: int Foo.i: -@Anno; +.... + +Notice the '-' in front of the annotation, meaning 'removal'. The whole +construct means 'remove the @Anno annotation from the int field called i +in type Foo'. It is not yet supported on the other forms of declare @. + +==== M1 - Intertype innertypes + +More work has gone into this feature. It was originally added in 1.6.9 +but the inability to use it with binary weaving greatly reduced the +usefulness. Fixes have gone into 1.6.11 to support binary weaving. What +do we mean by intertype innertypes? Here is an example: + +.... +class Foo { + public void m() { + System.out.println(Inner.i); + } +} + +aspect X { + public static class Foo.Inner { + static int i = 34; + } +} +.... + +Only static inner types are supported. diff --git a/docs/dist/doc/README-1612.adoc b/docs/dist/doc/README-1612.adoc new file mode 100644 index 000000000..d69061257 --- /dev/null +++ b/docs/dist/doc/README-1612.adoc @@ -0,0 +1,241 @@ +[.small]#© Copyright 2010-2011 Contributors. All rights reserved.# + +== AspectJ 1.6.12 Readme + +The full list of resolved issues in 1.6.12 is available +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;product=AspectJ;target_milestone=1.6.12;[here] + +. + +=== 1.6.12 released 18-Oct-2011 + +=== 1.6.12.RC1 available 3-Oct-2011 + +=== 1.6.12.M2 available 18-Aug-2011 + +=== 1.6.12.M1 available 7-Jun-2011 + +=== Notable Changes + +==== RC1 - annotation value matching and != + +Prior to this change it was only possible to specify an annotation match +like this: + + + +get(@Anno(someValue=1) * *) || get(@Anno(someValue=3) * *) + + +Now it is possible to use != and write this: + + + +get(@Anno(someValue!=2) * *) + + +This can enable a group of annotated elements to be more easily +identified. + + + + +==== RC1 - More flexible pointcut/code wiring in aop.xml + +Prior to this version the wiring was quite limited. In order to wire a +pointcut to a piece of code the user needed to write an abstract aspect +that included an abstract pointcut and some advice attached to that +abstract pointcut. Then compile this aspect and finally write the XML to +concretize the abstract pointcut. With 1.6.12 more flexibility has been +added and for some cases there can be no need for that abstract aspect. + +This is a work in progress but now you can write this in the aop.xml: + +.... + + + + + +public class SomeRegularJavaClass { + + public static void someMethod(org.aspectj.lang.JoinPoint tjp, String s) { + System.out.println("in advice4: s="+s+" at "+tjp); + } + + public static void someOtherMethod(org.aspectj.lang.JoinPoint tjp, String s) { + System.out.println("in advice5: s="+s+" at "+tjp); + } +} +.... + +In this example there is a simple regular java class containing some +static methods. In the XML these can be joined to pointcuts, kind as if +they were advice. Notice in the XML it specifies: + +* The pointcut +* The invokeClass - the fully qualified name of the class containing the +Java method +* The invokeMethod - the method, including signature in the specified +class. + +Due to the method specification being in XML the parameter types must be +fully specified. The only exception to this rule is that the AspectJ +core types JoinPoint (and JoinPoint.StaticPart) do not have to be fully +qualified (see the example above). *Important:* notice that in the case +above which does argument binding, the names are bound according to the +XML specification, not according to the parameter names in the Java +code. + +Around advice is also supported (the return type of the method must +match the joinpoint return type). The example shows after advice, +currently there is no way to specify either after returning or after +finally, there is only after. + +Expanding this further would enable support for all the code style +features in the XML. Some of the language features like declare +annotation cannot be done in annotation style aspects but the XML +doesn't have the same kind of restrictions. If anyone wants to help out +by fleshing this area of the weaver out, let me know and I'll help you +get started! + +''''' + +==== M2 - thisAspectInstance (https://bugs.eclipse.org/bugs/show_bug.cgi?id=239649[bug239649]) + +There is now a new well known name that you can use in the if clauses in +your aspects. thisAspectInstance provides access to the aspect instance. +Here is an example: `` + +.... +aspect X { + boolean doit() { + System.out.println("In instance check method doit()"); + return true; + } + + before():execution(* m(..)) && if(thisAspectInstance.doit()){ + System.out.println(thisJoinPoint); + } +} +.... + +Now why not just use X.aspectOf() instead of thisAspectInstance? Well +thisAspectInstance is quite useful when working with abstract/concrete +aspects: `` + +.... +abstract aspect X { +abstract pointcut p(); + +boolean doit() { + return true; + } + + before():p() && if(thisAspectInstance.doit()){ + System.out.println(thisJoinPoint); + } +} + +aspect Y extends X { + + pointcut p(): execution(* m(..)); + +} +.... + +Now thisAspectInstance will be an instance of the Y, not X. It enables +the aspect instance to be used in some kind of check/guard that will +avoid the costly creation of a thisJoinPoint object if the advice isn't +going to run. *Note:* right now this only works for singleton aspects. +If you have need of it with other instantiation models, please comment +on https://bugs.eclipse.org/bugs/show_bug.cgi?id=239649 + +==== M2 - weaving groovy + +Although we have been successfully weaving groovy for a long time, it is +becoming more popular and a few issues have been uncovered when using +non-singleton aspects with groovy code. These have been fixed. + +==== M2 - AJDT memory + +The release notes for the last few versions of AspectJ have mentioned +two options (minimalModel and typeDemotion) which can be switched on to +reduce memory consumption. They have had enough field testing now and +from 1.6.12.M2 onwards they are on by default. Users should see a +reduction in memory consumed by AspectJ projects in AJDT. It won't +affect load time weaving. It may also help command line (or Ant) compile +time weaving. If these options cause a problem then please raise a +bugzilla but in the interim you could work around the problem by +actively turning them off by specifying +-Xset:minimalModel=false,typeDemotion=false in the project properties +for your AspectJ project. + +==== M2 - Java7 weaving support + +Some preliminary work has been done to support Java7. Java7 class files +must contain the necessary extra verifier support attributes in order to +load successfully on a Java7 VM - the attributes were only optional in +Java6. It is possible to force loading of classes missing the attributes +but that requires use of a -XX option. AspectJ 1.6.12.M2 should create +these for you if you weave Java7 level class files. Nothing has been +done yet to rebase AspectJ on a version of the Eclipse compiler that +supports Java7 language constructs - that will happen after Eclipse +3.7.1 is out. + +''''' + +==== M1 - synthetic is supported in pointcut modifiers https://bugs.eclipse.org/bugs/show_bug.cgi?id=327867[327867] + +It is now possible to specify synthetic in pointcuts: + +.... +pointcut p(): execution(!synthetic * *(..)); +.... + +==== M1 - respect protection domain when generating types during weaving https://bugs.eclipse.org/bugs/show_bug.cgi?id=328099[328099] + +This enables us to weave signed jars correctly. AspectJ sometimes +generates closure classes during weaving and these must be defined with +the same protection domain as the jar that gave rise to them. In +1.6.12.M1 this should now work correctly. + +==== M1 - Suppressions inline with the JDT compiler https://bugs.eclipse.org/bugs/show_bug.cgi?id=335810[335810] + +Starting with Eclipse 3.6, the Eclipse compiler no longer suppresses raw +type warnings with @SuppressWarnings("unchecked"). You need to use +@SuppressWarnings("rawtypes") for that. AspectJ has now been updated +with this rule too. + +==== M1 - Optimized annotation value binding for ints https://bugs.eclipse.org/bugs/show_bug.cgi?id=347684[347684] + +The optimized annotation value binding now supports ints - this is for +use when you want to match upon the existence of an annotation but you +don't need the annotation, you just need a value from it. This code +snippet shows an example: + +.... +@interface SomeAnnotation { + int i(); +} + +before(int i): execution(* *(..)) && @annotation(SomeAnnotation(i)) { +.... + +Binding values in this way will result in code that runs *much* faster +than using pointcuts that bind the annotation itself then pull out the +value. + +Under that same bug some changes were made to match values by name when +binding too. Suppose the annotation had multiple int values, how would +we select which int to bind? AspectJ will now use the name (if it can) +to select the right value: + +.... +@interface SomeAnnotation { + int mods(); + int flags(); +} + +before(int flags): execution(* *(..)) && @annotation(SomeAnnotation(flags)) { +.... + +Here the use of 'flags' as the name of the value being bound will ensure +the 'flags' value from any SomeAnnotation is bound and not the 'mods' +value. diff --git a/docs/dist/doc/README-162.adoc b/docs/dist/doc/README-162.adoc new file mode 100644 index 000000000..f560778a6 --- /dev/null +++ b/docs/dist/doc/README-162.adoc @@ -0,0 +1,84 @@ +[.small]#© Copyright 2008 Contributors. All rights reserved.# + +== AspectJ 1.6.2 Readme + +The main theme of AspectJ1.6.2 was improved IDE incremental performance +and a number of changes have gone in to improve how AspectJ and AJDT +communicate - greatly reducing the time taken to perform an incremental +compile (more details below). 1.6.2 also includes a number of fixes and +enhancements covering areas such as: + +* better support for generics and intertype declarations +* better support for annotation style syntax +* improvements to ajdoc +* bringing the AspectJ structure model more in line with the JDT model + +Many thanks to all the users that helped diagnose problems, provide +testcases and contribute fixes. In particular: + +* Dave Whittaker - for generics and intertype declaration testing and +testcases +* Jason Naylor, Arturo Salazar - for ajdoc testcases, fixes and design +input +* Andrew Eisenberg - for helping shape the AJDT/AspectJ interface and +improving incremental + +The complete list of issues resolved for AspectJ 1.6.2 (more than 60) +can be found with this bugzilla query: + +* https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=AspectJ&target_milestone=1.6.2&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&emailtype1=substring&email1=&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=[Bugs +resolved] + +''''' + +=== Incremental compilation (https://bugs.eclipse.org/bugs/show_bug.cgi?id=247742[bug 247742], https://bugs.eclipse.org/bugs/show_bug.cgi?id=245566[bug 245566], https://bugs.eclipse.org/bugs/show_bug.cgi?id=243376[bug 243376]) + +Two main changes in this area. + +* Better communication between AJDT and AspectJ. The interface between +the two has been modified so that AJDT can give more input to AspectJ +about what needs to be done for an incremental compile, rather than +having AspectJ discover it each time. +* Structure model changes. The AspectJ structure model (of types in a +project and the weaving amongst them) allows handles to be created for +every node, as a lightweight reference to the elements of the model. +These handles were similar to those that JDT uses for references to +elements of a project but not identical. Many many fixes have gone in to +bring the handle formats closer and closer. For example including src +folders as elements in the AspectJ model and using the fully correct set +of JDT delimiters throughout each handle. This means there is no longer +an expensive transformation cost in going from an AspectJ element to its +related JDT element and no need for AJDT to maintain a more JDT like +version of the AspectJ structure model. The imminent development builds +of AJDT will utilise these changes. + +_What difference does it make?_ + +For every kind of build there are two numbers to take into account. +Firstly there is the time spent in the compiler (time spent compiling +and weaving), secondly there is the time spent in AJDT (time spent +communicating what happened back to the user via the problems view, +gutter annotations). Values for these times can be seen by opening the +'AJDT Event Trace View' in eclipse. The changes within AspectJ obviously +effect the time spent in the compiler and that is described as 'time +spent in AJDE' within the event trace view (AJDE being the compiler +wrapper invoked by AJDT). + +For a 1000 source file AspectJ project, the times spent in AJDE have +changed as follows for a single whitespace change and save operation: + +* For a sourcefile unaffected by aspects. Was 1828ms, now 75ms. +* For a sourcefile affected by some advice. Was 1844ms, now 90ms. +* For a sourcefile affected by lots of advice. Was 1937ms, now 188ms. + +The AspectJ changes are done to support this, but we are still bedding +them down in AJDT. If you want to see numbers like those above you need +to install the latest AJDT dev builds for Eclipse 3.4 (an AJDT 1.6.1 dev +build from the dev update site: +http://download.eclipse.org/tools/ajdt/34/dev/update ) and then after +starting Eclipse, select 'Window>Preferences' and in the AspectJ tab +select 'Incremental Compiler Optimizations'. Let us know how you get on! +When it has had enough testing it will be made the default and then is +likely to be back ported to Eclipse 3.3 AJDT. + +''''' diff --git a/docs/dist/doc/README-163.adoc b/docs/dist/doc/README-163.adoc new file mode 100644 index 000000000..74ca5e5a4 --- /dev/null +++ b/docs/dist/doc/README-163.adoc @@ -0,0 +1,90 @@ +[.small]#© Copyright 2008 Contributors. All rights reserved.# + +== AspectJ 1.6.3 Readme + +* xref:#split[Split matching/weaving] +* xref:#bugsfixed[Bugs fixed] +* xref:#notable[Notable bug fixes] +* xref:#whatsnext[What's next?] + +''''' + +[#split]## + +=== Split matching/weaving + +The main goal of AspectJ 1.6.3 was to make the line between matching and +weaving more explicit and introduce the notion of a matcher artifact. +This matcher would enable reuse of the semantics of AspectJ pointcut +matching without including the unnecessary code that is the weaver. Why? +In some environments, for example Spring AOP, the weaving may be done in +an entirely different way and the default weaver included in +aspectjweaver.jar is just unnecessary code. Some users also find they +have trouble getting approval for using the 'aspectjweaver.jar' in their +projects because it includes a bytecode modification library, even when +they are not using that code. + +The result of this work is documented in +https://bugs.eclipse.org/bugs/show_bug.cgi?id=246125[bug 246125] and +there is now a new jar file in the distribution called +org.aspectj.matcher.jar that includes a first pass at the matching code. +It is not quite as slimmed down as it could be but is a first pass that +includes no bytecode modification toolkit. + +To use this matcher standalone it simply requires an abstraction of some +type system to be plugged in. The matcher code can then be used to parse +standard pointcuts and answer questions about whether they match against +that type system. There is no documentation on how to do this yet, as we +don't think many users will be contributing new type systems, but +internally we are working on an Eclipse JDT type system abstraction that +will enable us to show matches in AJDT without actually compiling code +(currently the two type system abstractions we ship are bytecode based +and reflection based - both of which require compilation). + +''''' + +[#bugsfixed]## + +=== Bugs fixed + +The complete list of issues resolved for AspectJ 1.6.3 (more than 50) +can be found with this bugzilla query: + +* https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=AspectJ&target_milestone=1.6.3&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&emailtype1=substring&email1=&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=[Bugs +resolved] + +During 2008, there have been four AspectJ releases, fixing almost 200 +issues. + +''''' + +[#notable]## + +=== Notable bug fixes + +* More improvements to the way AspectJ/AJDT communicate (251277, 249216, +258325) +* More ajdoc improvements (256514) +* Better support for non standard annotation style parameter ordering +(164573, 219419) +* Fixed long standing issue with extending Spring SecurityInterceptor +(252722) +* Ensure parameter annotations made on an ITD reach the target affected +type (256669) + +''''' + +[#whatsnext]## + +=== What's next? + +The JDT World should be completed in the 1.6.4 timeframe and that will +surface as benefits in AJDT, possibly leading to better LTW tooling. +Some improved syntax for intertype declarations is a possible candidate +feature (see discussion in +http://dev.eclipse.org/mhonarc/lists/aspectj-users/msg10208.html[this +mailing list thread]). A possible introduction of a code style syntax +for the mixin style that is @DeclareParents (and a renaming of +@DeclareParents to perhaps DeclareMixin or DeclareDelegate). + +''''' diff --git a/docs/dist/doc/README-164.adoc b/docs/dist/doc/README-164.adoc new file mode 100644 index 000000000..dd5deea5a --- /dev/null +++ b/docs/dist/doc/README-164.adoc @@ -0,0 +1,256 @@ +[.small]#© Copyright 2009 Contributors. All rights reserved.# + +== AspectJ 1.6.4 Readme + +* xref:#compilation[Compilation times] +* xref:#language[Language enhancements] +* xref:#bugsfixed[Bugs fixed] +* xref:#whatsnext[What's next?] + +''''' + +[#compilation]## + +=== Compilation times + +In AspectJ 1.6.4 the goal was to improve the IDE experience, through a +combination of improved compilation speed (both full builds and +incremental builds), improved support for multiple-project +configurations, and improved feedback in the editor. The following +sections go into details on each of those topics. + +*Full Compilation* + +As an example project, all the measurements here are based on the +modified JDT compiler that AspectJ uses internally. It is 1100 source +files and includes aspects that affect around 850 join points. Here are +the full build times in AJDT: + +AJDT 1.6.3 (uses AspectJ 1.6.3) + +`` + +.... +21352ms +21597ms +21502ms +.... + +AJDT 1.6.5dev builds (use AspectJ 1.6.4) + +`` + +.... +19811ms +19802ms +19504ms +.... + +About 1.5-2 seconds faster for this example. + +*Incremental Compilation and multi-project scenarios* + +In most common project configurations there are multiple eclipse +projects in some kind of dependency hierarchy. Depending on what changes +in a top level project, those downstream may need to be rebuilt. The +analysis around this area has greatly improved in AspectJ 1.6.4, and +this has resulted in much reduced incremental build times. The example +timed here is around 20 AspectJ projects in a hierarchy, and a change is +made to a source file in the top level project and build times are +observed for the downstream projects. + +The timings reported here are accessible to anyone with AJDT installed - +just open the 'AJDT Event Trace View' and it will report ongoing +information about what the compiler/weaver and AJDT are up to. Be aware +that data is only recorded in this view if it is open - so for optimal +performance it should be shutdown, but it is useful for debugging +scenarios or collecting basic benchmark numbers. Within the event trace +view output, the time recorded for 'time spent in AJDE' represents the +time spent in the compiler: analysing what has changed on the classpath, +building code, weaving code. + +Initially this is using AJDT 1.6.2 (which embeds AspectJ 1.6.3): + +`` + +.... +Type of change: adding a new method to a type +Project build times (first one is the compile of our change, the rest are for downstream projects): +462ms, 4ms, 145ms, 8ms, 9ms, 287ms, 471ms, 222ms, 1028ms, 143ms, 505ms, 199ms, 261ms, 1224ms, +321ms, 704ms, 75ms, 233ms, 257ms +Summary: Total time spent in the compiler for that change: 6558ms +--- +Type of change: whitespace change (adding just a harmless space character) +Project build times (first one is the compile of our change, the rest are for downstream projects): +229ms, 5ms, 10ms, 9ms, 10ms, 79ms, 43ms, 62ms, 80ms, 37ms, 64ms, 32ms, 79ms, +154ms, 94ms, 189ms, 72ms, 144ms, 205ms +Summary: Total time spent in the compiler for that change: 1597ms +.... + +Now with AspectJ 1.6.5 dev builds (which embed AspectJ 1.6.4): + +`` + +.... +Type of change: adding a new method to a type +Project build times (first one is the compile of our change, the rest are for downstream projects): +288ms, 3ms, 143ms, 2ms, 2ms, 162ms, 244ms, 89ms, 489ms, 113ms, 277ms, 108ms, 143ms, 626ms, +135ms, 260ms, 2ms, 96ms, 6ms +Summary: Total time spent in the compiler for that change: 3188ms down from 6558ms + +Type of change: whitespace change (adding just a harmless space character) +Project build times (first one is the compile of our change, the rest are for downstream projects): +101ms, 1ms, 1ms, 1ms, 0ms, 1ms, 1ms, 1ms, 1ms, 1ms, 0ms, 1ms, 1ms, 2ms, 0ms, 1ms, 0ms, 2ms, 2ms +Summary: Total time spent in the compiler for that change: 118ms (down from 1597ms) +.... + +Improvements all round, and almost instant builds now for whitespace +changes, even in large project setups. + +In addition the compilation times are also improved in situations where +AspectJ projects depend upon Java projects and where aspectpath is used. +AJDT 1.6.5 dev builds also include some changes that really speed up +builds. + +=== Better editor feedback + +Under https://bugs.eclipse.org/bugs/show_bug.cgi?id=246393[bug 246393] +the problem has been addressed where sometimes spurious errors would +appear throughout the editor for a file in AJDT when just one single +simple syntax errors exists. More detail on this problem can be found +http://andrewclement.blogspot.com/2009/02/aspectj-fixing-reverse-cascade-errors.html[here]. + +''''' + +[#language]## + +=== Language Enhancements + +*Optimizing support for maintaining per join point state* + +The traditional way to maintain state on a per join point basis involves +using the JoinPoint.StaticPart as a key into a map: `` + +.... +aspect X pertypewithin(*) { + Map timerMap = ... + + Object around(): execution(public * *(..)) { + Timer timerToUse = timerMap.get(thisJoinPointStaticPart); + timerToUse.start(); + Object o = proceed(); + timerToUse.stop(); + return o; + } +} +.... + +These map lookups are slow. In AspectJ 1.6.4 there is a new getId() +method on the JoinPoint.StaticPart object. The ids for all affected join +points within a target type are unique (and start from 0) - they are +ideal for array lookups. So using this the above aspect can be +rewritten: + +`` + +.... +aspect X pertypewithin(*) { + Timer[] timerArray = ... + + Object around(): execution(public * *(..)) { + Timer timerToUse = timerArray[thisJoinPointStaticPart.getId()]; + timerToUse.start(); + Object o = proceed(); + timerToUse.stop(); + return o; + } +} +.... + +much faster. Just be aware that the ids are only unique within an +affected target type - hence the use of pertypewithin in this example to +ensure there is an aspect instance (and so a different array) for each +advised type. + +See related https://bugs.eclipse.org/bugs/show_bug.cgi?id=89009[bug +89009] for the full discussion + +=== @DeclareMixin + +The annotation style declare parents support (@DeclareParents) has been +(rightly) criticized because it really does not offer an equivalent to +what is possible with code style declare parents, it really offers a +mixin strategy. It also has limitations such as the delegate instance +used to satisfy any method invocations on an affected target cannot +access the object instance for which it is acting as a delegate. To +address these concerns a proper mixin notation has been introduced that +makes it more clear that a mixin strategy is being employed and it +addresses the problem of the mixin delegate accessing the affected +target instance. + +The @DeclareMixin annotation is attached to a factory method which +returns instances of the delegate. Here is a basic example: + +`` + +.... + // The factory method that can build the delegate instance is annotated with @DeclareMixin. + // The annotation value defines the type pattern for targets of the mixin. + // The parameter is the object for which a delegate is being constructed. + // The interface that will be mixed in is the return value of the factory method. + @DeclareMixin("org.xyz..*") + public static SomeInterface createDelegate(Object instance) { + return new SomeImplementation(instance); + } +.... + +More examples are +http://www.eclipse.org/aspectj/doc/released/adk15notebook/ataspectj-itds.html[here +in the online documentation]. + +Going forward attempts will be made to try and make @DeclareParents +behave more like code style - if this cannot be done it is likely to be +deprecated. + +''''' + +[#bugsfixed]## + +=== Bugs fixed + +The complete list of issues resolved for AspectJ 1.6.4 (more than 70) +can be found with this bugzilla query: + +* https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=AspectJ&target_milestone=1.6.4&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&emailtype1=substring&email1=&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=[Bugs +resolved] + +''''' + +[#whatsnext]## + +=== What's next? + +*More incremental build enhancements* + +A number of situations still exist where incremental compile speeds +still needs optimizing, particular when capabilities like aspectpath or +inpath are used. + +*Build state persistence* + +Between restarts of Eclipse the state of each project is not recorded - +hence full builds are required upon restart. The state (and associated +relationship model) should be persisted between restarts, but both of +these need a review first to ensure they are not larger than they need +to be. + +*Memory consumption* + +Both for source compilation and load-time weaving scenarios. The size of +the model in the IDE needs reviewing, and also the type map within the +weaver. Although the type map uses Weak/Soft references to try and +better control how it uses memory, the JVM policies for managing these +references vary wildly and so some work needs to be done to allow for +these differences. + +''''' diff --git a/docs/dist/doc/README-165.adoc b/docs/dist/doc/README-165.adoc new file mode 100644 index 000000000..4d52fc0eb --- /dev/null +++ b/docs/dist/doc/README-165.adoc @@ -0,0 +1,15 @@ +[.small]#© Copyright 2009 Contributors. All rights reserved.# + +== AspectJ 1.6.5 Readme + +[#bugsfixed]## + +=== Bugs fixed + +The complete list of issues resolved for AspectJ 1.6.5 can be found with +this bugzilla query: + +* https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=AspectJ&target_milestone=1.6.5&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&emailtype1=substring&email1=&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=[Bugs +resolved] + +''''' diff --git a/docs/dist/doc/README-166.adoc b/docs/dist/doc/README-166.adoc new file mode 100644 index 000000000..9064cb793 --- /dev/null +++ b/docs/dist/doc/README-166.adoc @@ -0,0 +1,65 @@ +[.small]#© Copyright 2009 Contributors. All rights reserved.# + +== AspectJ 1.6.6 Readme + +[#bugsfixed]## + +=== Bugs fixed + +The complete list of issues resolved for AspectJ 1.6.6 can be found with +this bugzilla query: + +* https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=AspectJ&target_milestone=1.6.6&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&emailtype1=substring&email1=&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=[Bugs +resolved] + +''''' + +=== Changes + +*Java5* + +The features of Java5 (generics, autoboxing, covariance, etc) are being +exploited in the AspectJ codebase. This does not in any way change the +generated code or supported source code, or the dependencies that code +has, but it *does* mean that AspectJ requires Java5 in order to run. The +ability to use typed collections has already flushed out a few issues +within the codebase, improving the quality of AspectJ. + + + + +*Closing streams* + +Some routes through AspectJ were leaving inputstreams open and this has +now been fixed. For example if supplying a user written configuration +file for Lint options. Thanks to Michael Pradel for supplying patches to +fix these issues. + + + + +*Concurrency (281654)* + +Fix to address a problem seen when using the weaver in a highly +concurrent environment. Thanks to Kristian Rosenvold for the patch. + + + + +*Incremental compilation* + +A few fixes to problems seen only on incremental builds, problem areas +included: + +* problems when fully qualifying the target type in an intertype +declaration (269652) +* problems when using annotation style pointcuts and reference pointcuts +together (286341) + + + + +*JavadocRunner in NetBeans* + +Fixed by a patch from Joseph A. Levin - thanks! + + + + +*Various fixes/enhancements to the structure model to fix issues with +feedback on weaving in AJDT* diff --git a/docs/dist/doc/README-167.adoc b/docs/dist/doc/README-167.adoc new file mode 100644 index 000000000..a6fea804f --- /dev/null +++ b/docs/dist/doc/README-167.adoc @@ -0,0 +1,183 @@ +[.small]#© Copyright 2009 Contributors. All rights reserved.# + +== AspectJ 1.6.7 Readme + +AspectJ 1.6.7 includes some radical internal changes. These improvements +enable faster compilation, faster binary weaving, faster load time +weaving and in some situations faster generated code. + +=== Pointcut timers + +Until 1.6.7 there has not really been a way to determine if it is just +one of your pointcuts that is hurting your weaving performance. In 1.6.7 +it is possible to turn on timers for pointcuts. These timers show the +time spent in the weaver matching the pointcut components against join +points. The details on this feature are here: +http://andrewclement.blogspot.com/2009/11/aspectj-profiling-pointcut-matching.html[Profiling +pointcut matching]. Basically by turning on the options '-timers +-verbose' on the command line (or via Ant), output will be produced that +looks a little like this: + +.... +Pointcut matching cost (total=6532ms for 675000 joinpoint match calls): +Time:482ms (jps:#168585) matching against + (staticinitialization(*y*.()) && persingleton(SimpleAspect)) +Time:3970ms (jps:#168585) matching against + (execution(* *t*.*(*)) && persingleton(SimpleAspect)) +Time:538ms (jps:#168584) matching against + (execution(* *f*(..)) && persingleton(SimpleAspect)) +Time:1536ms (jps:#168584) matching against + (execution(* java.lang.CharSequence+.*e*(..)) && persingleton(SimpleAspect)) +Time:4ms (jps:#662) matching against + (within(*p*) && persingleton(SimpleAspect)) +.... + +It shows the component, the number of joinpoints (jps) the weaver +attempted to match it against and how many milliseconds were spent +performing those matches. The options can also be turned on +http://contraptionsforprogramming.blogspot.com/2009/11/getting-aspectj-pointcut-matching-timer.html[]through +AJDT. Armed with this information you can optimize your pointcuts or +post on the mailing list asking for help. The timers can even be turned +on for load time weaving. + +=== Faster matching + +The changes to enable pointcut profiling enabled some targeted work to +be done on the matching algorithms. These have remained unchanged for a +few years, but in 1.6.7 have received a bit of an overhaul. 'Fast match' +has been implemented for the execution() pointcut, drastically reducing +weave times for heavy users of execution - more details +http://andrewclement.blogspot.com/2009/11/aspectj-how-much-faster-is-aspectj-167.html[here]. +The pointcut cost calculator (which is used to sort pointcuts to +optimize matching speed) has been reviewed and after determining that +this() ought to be considered cheaper than call() - any user combining +those two pointcut designators should see an improvement (one users +build time reduced from 38minutes to 6minutes with that change!). + +As well as faster matching there is also less exploration to determine a +match. Visitors that walk hierarchies and discover methods now terminate +as early as possible once they can determine something is a match or is +definetly not a match. This reduces memory usage, speeds up weaving and +reduces the occurrences of those annoying 'cantFindType' messages. + +=== aop.xml processing + +The processing of include/exclude entries in aop.xml has been rewritten. +It now optimizes for many more common patterns. If a pattern is +optimized then there is no need to ask the weaver to do an expensive +include/exclude match. More details +http://andrewclement.blogspot.com/2009/12/aspectj-167-and-faster-load-time.html[here]. + +=== Less need to tweak options for load time weaving + +A number of options were previously configurable for load time weaving +that were considered experimental. These options have now been tested +enough in the field that they are considered fully reliable and are on +by default in 1.6.7. If you have been using either of these: + +* typeDemotion +* runMinimalMemory + +then please delete them from your weaver options section, the weaver +will now do the right thing out of the box. + +=== Benchmarking memory and performance + +All those changes above, and some additional tweaks, mean we are now +using less memory than ever before and getting things done more quickly. + +http://andrewclement.blogspot.com/2009/12/aspectj-167-and-faster-load-time.html[This +post] discusses the details. From that article, the graph below shows +the speed and memory consumption of the various AspectJ 1.6 releases +when load time weaving a small application loading in Tomcat. For each +of 10 iterations (x axis), the top comparison is startup time in +milliseconds, the lower comparison is memory used in bytes. + +image:167Memory.png[image] + +=== Annotation binding + +All those changes affect compilation/weaving but what about the code +that actually runs? One user, Oliver Hoff, raised a query on the +performance of annotation binding. His case uncovered an old TODO left +in the code a few years ago: + +`` + +.... +// OPTIMIZE cache result of getDeclaredMethod and getAnnotation? +.... + +Annotation binding has become a very common use case since that was +written and 1.6.7 was the time TODO it. + +The result is an optimization for the general case of binding an +annotation, but also support for a new bit of syntax that aids binding +of a string annotation member value - using this latter syntax generates +extremely fast code. + +Here are some numbers for a simple benchmark retrieving the annotation +value at an execution join point in different ways. The three scenarios +look like this (where the annotation type is 'Marker' and it has a +String value field called 'message'): + +`` + +.... + // CaseOne: annotation value fetching is done in the advice: + pointcut adviceRetrievesAnnotation(): execution(@Marker * runOne(..)); + before(): adviceRetrievesAnnotation() { + Marker marker = (Marker) ((MethodSignature) + thisJoinPointStaticPart.getSignature()).getMethod().getAnnotation(Marker.class); + String s = marker.message(); + } + + // CaseTwo: annotation binding is done in the pointcut, advice retrieves message + pointcut pointcutBindsAnnotation(Marker l): execution(@Marker * runTwo(..)) && @annotation(l); + before(Marker l): pointcutBindsAnnotation(l) { + String s = l.message(); + } + + // CaseThree: annotation binding directly targets the message value in the annotation + pointcut pointcutBindsAnnotationValue(String msg): + execution(@Marker * runThree(..)) && @annotation(Marker(msg)); + before(String s): pointcutBindsAnnotationValue(s) { + // already got the string + } +.... + +Before 1.6.7, case 2 was slower than case 1 and case 3 wasn't supported +syntax. The two bugs with more info are +https://bugs.eclipse.org/bugs/show_bug.cgi?id=296484[Bug 296484] and +https://bugs.eclipse.org/bugs/show_bug.cgi?id=296501[Bug 296501]. + +Now this is a micro benchmark, slightly unrepresentative of the real +world because the advice isn't doing anything else, but it does really +stress the AspectJ binding code. For the benchmark numbers the join +points advised by those advice were invoked 1,000,000 times. AspectJ +1.6.7: + +`` + +.... +Manually fetching annotation with getAnnotation(): 645ms +Binding annotation with @annotation(Marker): 445ms (was >20 *seconds* for 1.6.6, due to an extra reflection call) +Binding annotation value with @annotation(Marker(message)): 3ms +.... + +The new syntax is definetly the best way to bind an annotation string +value. + +''''' + +[#bugsfixed]## + +==== Bugs fixed + +The complete list of issues resolved for AspectJ 1.6.7 can be found with +this bugzilla query: + +* https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=AspectJ&target_milestone=1.6.7&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&emailtype1=substring&email1=&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=[Bugs +resolved] + +''''' diff --git a/docs/dist/doc/README-168.adoc b/docs/dist/doc/README-168.adoc new file mode 100644 index 000000000..eee958509 --- /dev/null +++ b/docs/dist/doc/README-168.adoc @@ -0,0 +1,89 @@ +[.small]#© Copyright 2009 Contributors. All rights reserved.# + +== AspectJ 1.6.8 Readme + +The first sentence in the 1.6.7 readme was 'AspectJ 1.6.7 includes some +radical internal changes.' + +Unfortunately not enough testing was done on 1.6.7 and two nasty issues +were found that really needed addressing. Fixes for these issues are all +that is new in 1.6.8. + +=== Incorrect treatment of some aop.xml include/exclude patterns + +See https://bugs.eclipse.org/bugs/show_bug.cgi?id=298786[Bug 298786] + +Basically, if a certain combination of includes and excludes were +specified in the within section, then the weaver would fail to merge +them correctly. The conditions for the failure are: + +* you need an exclude pattern that the weaver is not optimizing for +(basically a pattern that could not be matched based upon the typename +alone, eg. based on whether the type has an annotation) +* you need two include patterns - one that is being optimized and one +that is not + +These three meet that spec: + +`` + +.... + + + +.... + +The include="*" can be optimized. The include="@Foo *" is not optimized. +The exclude="*Funk*y*" is not optimized (this one could be but isn't +right now as it includes multiple wildcards). + +With that configuration any types that the include="*" would have +accepted are not accepted. + +=== Stack overflow problem in ReferenceType.isAssignableFrom() + +See https://bugs.eclipse.org/bugs/show_bug.cgi?id=298908[Bug 298908] + +This is actually a problem AspectJ has had for a long time, but has +always proved elusive to recreate. It turns out that it is memory +related and the more aggressive policy in 1.6.7 causes it to occur much +more frequently. + +The stack trace when this is hit looks like: + +`` + +.... + ... + at org.aspectj.weaver.ReferenceType.isAssignableFrom(ReferenceType.java:393) + at org.aspectj.weaver.ReferenceType.isAssignableFrom(ReferenceType.java:427) + at org.aspectj.weaver.ReferenceType.isAssignableFrom(ReferenceType.java:393) + at org.aspectj.weaver.ReferenceType.isAssignableFrom(ReferenceType.java:427) + at org.aspectj.weaver.ReferenceType.isAssignableFrom(ReferenceType.java:393) + at org.aspectj.weaver.ReferenceType.isAssignableFrom(ReferenceType.java:427) + at org.aspectj.weaver.ReferenceType.isAssignableFrom(ReferenceType.java:393) + at org.aspectj.weaver.ReferenceType.isAssignableFrom(ReferenceType.java:427) + at org.aspectj.weaver.ReferenceType.isAssignableFrom(ReferenceType.java:393) + at org.aspectj.weaver.ReferenceType.isAssignableFrom(ReferenceType.java:427) + at org.aspectj.weaver.ReferenceType.isAssignableFrom(ReferenceType.java:393) + ... +.... + +The weaver has changed over the 1.5 and 1.6 releases and is now reaching +a point where it really shrinks quite small when not in use (maybe in a +loadtime environment you have finished loading all your classes). The +aim is that it can rebuild any required state that is needed later. With +the move in 1.6.7 from Soft to Weak references, things are being +discarded much sooner and this is exercising the state rebuilding code +that wasn't used that often prior to 1.6.7. + +The problem is actually because the call on a generic type to get the +raw type was actually broken and returning the generic type. This then +loops forever trying to get the raw type from the generic type. This +happens because the world should store only raw types (which point to +their generic form) but there was a bug in state rebuilding that instead +put the generic type directly in the world. + +''''' + +Thanks to everyone who helped get to the bottom of these problems. diff --git a/docs/dist/doc/README-169.adoc b/docs/dist/doc/README-169.adoc new file mode 100644 index 000000000..1df44489f --- /dev/null +++ b/docs/dist/doc/README-169.adoc @@ -0,0 +1,299 @@ +[.small]#© Copyright 2010 Contributors. All rights reserved.# + +== AspectJ 1.6.9 Readme + +The full list of resolved issues in 1.6.9 is available +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;product=AspectJ;target_milestone=1.6.9;target_milestone=1.6.9M1;target_milestone=1.6.9M2;target_milestone=1.6.9RC1[here] + +=== Features + +==== declare annotation supports compound signature patterns: https://bugs.eclipse.org/bugs/show_bug.cgi?id=287613[287613] + +Until now it wasn't possible to express a compound pattern in any of the +declare annotation constructs that take a member signature. For example, +if you wanted to attach an annotation to all your getter like methods, +you needed two constructs + +.... +declare @method: * is*(): @FooBar; +declare @method: * get*(): @FooBar; +.... + +Now AspectJ allows compound patterns for declare +@method/@constructor/@field. + +.... +declare @method: (* is*()) || (* get*()): @FooBar; +.... + +==== Intertype declaration of member types + +It is now possible to ITD member types. The syntax is as would be +expected. This example introduces a new member type called Inner into +type Foo: + +.... +public class Foo { + public static void main(String[] args) { + new Inner().run(); + } +} + +aspect Magic { + public static class Foo.Inner { + public void run() { + System.out.println("Inner.run() executing"); + } + } +} +.... + +Only static member types are supported. + +==== 'Optional' aspects: https://bugs.eclipse.org/bugs/show_bug.cgi?id=310506[310506] + +It is not uncommon to ship a library aspect separately to a jar upon +which it depends. In the case of Spring there is an aspect library +containing a multitude of aspects that attach different technologies +(transactions/persistence/etc) to your application. Normally an aspect +will fail with a "can't find type" style message if a weaver is told to +use it and yet it references some missing dependency. This can be +annoying and require you to include jars on your classpath (or in your +maven configuration) that you don't actually use, they are *only* there +to avoid problems with the aspect. In 1.6.9 you can add a setting to +these aspects in the aop.xml that makes them optional. The setting +mentions a type and if that type cannot be found the aspect immediately +shuts itself down. This basically means that the aspect is only going to +do its job if the type being mentioned in the setting is around. This +enables the aspect library to be on the aspect path but any aspects +within it to switch-off if there is nothing for them to do. + +Here is an example, 'AspectA' will switch itself off if the type +'a.b.c.Anno' cannot be found: + +`` + +.... + +.... + +==== Reduction in class file sizes: https://bugs.eclipse.org/bugs/show_bug.cgi?id=312839[312839] + +More details here: +http://andrewclement.blogspot.com/2010/05/aspectj-size-is-important.html +but basically some work has been done to improve the serialized form of +aspects. As an example, a compiled Roo petclinic sample (which uses lots +of aspects and ITDs) is down from 1Meg (AspectJ 1.6.9m2) to 630k +(AspectJ 1.6.9rc1). + +==== Transparent weaving: https://bugs.eclipse.org/bugs/show_bug.cgi?id=309743[309743] + +In a further step towards transparent weaving, support for the AjType +reflection system is now being made optional. This means if intending to +use the AjTypeSystem to reflect on woven code, then the code must be +built with the option -makeAjReflectable. This change is being made +because the reflection supporting metadata that enables the AjTypeSystem +to work can break other tools that are just using regular reflection on +the classes. These days many more users are processing classes using +standard reflection than are using AjTypeSystem. The related bugzilla +discussing this issue is +https://bugs.eclipse.org/bugs/show_bug.cgi?id=309743[309743]. + +==== Overweaving: https://bugs.eclipse.org/bugs/show_bug.cgi?id=293450[293450] + +Preliminary support for overweaving was added in AspectJ 1.6.7, but now +in AspectJ 1.6.9m2 it is much more reliable. Basically it is an +alternative to reweaving when needing to weave a class multiple times. +Overweaving can cope with 'other tools' modifying the bytecode in +between AspectJ weaves, whereas reweaving cannot. More details are in +the related bugzilla +https://bugs.eclipse.org/bugs/show_bug.cgi?id=293450[293450] and in this +http://andrewclement.blogspot.com/2010/05/aspectj-overweaving.html[blog +article]. A weaver is switched into overweaving mode by the option +-Xset:overWeaving=true - which can be specified on the command line or +in the weaver options section of aop.xml. There is still more work to be +done on this feature - any feedback is welcome. + +==== AOP Scoping: https://bugs.eclipse.org/bugs/show_bug.cgi?id=124460[124460] + +Another feature that had preliminary support a while ago is aspect +scoping in aop.xml. This has also been improved in AspectJ1.6.9m2. For +those not aware of it, it is the ability to specify a scope against +aspects defined in your loadtime weaving aop.xml file. A scope +effectively enables the user to limit the applicability of your aspect +to some subset of all those types included by the weaver include +section. Why is it needed? It can be useful when taking an aspect that +did not originally scope itself properly (using a within clause) and +needing to limit its effect in a load time weaving context. Think of it +as a within pattern that you can put into the aop.xml that augments all +the pointcuts defined in the original aspect. + +Here is an example: + +`` + +.... + + + + + + + + + +.... + +In this example the weaver include section specifies all the types in +com..* should be woven and the aspects to be used are X and Y. The new +'scope' setting on aspect Y's definition allows finer control, and +specifies that Y should in fact only be applied to com.foo..* types. + +==== Message inserts for declare warning/error messages + +It is now possible to use joinpoint context in the messages attached to +declare warning and declare error constructs. Some examples: + +`` + +.... +declare warning: execution(* A.m(..)): "joinpoint is {joinpoint}"; +declare warning: execution(* A.m(..)): "joinpoint kind is '{joinpoint.kind}'"; +declare warning: get(int *) && within(A): "joinpoint signature is {joinpoint.signature}"; +declare warning: execution(* A.m(..)): "joinpoint declaring type is {joinpoint.signature.declaringType}"; +declare warning: execution(* A.m(..)): "signature name for method is {joinpoint.signature.name}"; +declare warning: execution(* A.m(..)): "joinpoint location is {joinpoint.sourcelocation.sourcefile}:{joinpoint.sourcelocation.line}"; +declare warning: execution(* A.m(..)): "joinpoint line is '{joinpoint.sourcelocation.line}'"; + +declare warning: get(int *): "warning is from aspect {advice.aspecttype}"; +declare warning: execution(* A.m(..)): "warning sourcelocation is {advice.sourcelocation.sourcefile}:{advice.sourcelocation.line}"; +.... + +The syntax is to enclose the relevant key within curly brackets within +the message. Please raise an enhancement request if you need other keys +- the set supported so far are all those shown in the example above. + +==== declare warning/error for type patterns + +It is now possible to use a type pattern with declare warning and +declare error. For example: + +`` + +.... +declare warning: I+ && !hasfield(int i): "Implementations of I are expected to have a int field called i"; +.... + +==== Type category type patterns + +This is the ability to narrow the types of interest so that interfaces +can be ignored, or inner types, or classes or aspects. There is now a +new is() construct that enables this: + +`` + +.... +execution(* (!is(InnerType)).m(..)) {} +!within(* && is(InnerType)) {} +.... + +Options for use in is() are: ClassType, AspectType, InterfaceType, +InnerType, AnonymousType, EnumType, AnonymousType. + +Note: It is important to understand that "!within(is(InnerType))" and +"within(!is(InnerType))" are not the same. The latter one is unlikely to +be what you want to use. For example here: `` + +.... +class Boo { + void foo() {} + class Bar { + void foo() {} + } +} +.... + +Bar.foo() will match within(!is(InnerType)) because within considers all +surrounding types (so although Bar doesn't match the pattern, the +surrounding Boo will match it). Bar.foo() will not match +!within(is(InnerType)) because Bar will match the pattern and then the +result of that match will be negated. + +==== Intertype fields preserve visibility and name + +Some users always expect this: + +`` + +.... +class C { +} + +aspect X { + private int C.someField; +} +.... + +To cause a private field called 'someField' to be added to C. This is +conceptually what happens during compilation but if any user then later +attempts to access someField via reflection or runs a javap against the +class file, they will see that isn't what happens in practice. A public +member is added with a mangled name. For code attempting to access +someField built with ajc, the visibility of the declaration will, of +course, be respected. But for frameworks accessing the code later +(typically through reflection), it can cause confusion. With AspectJ +1.6.9 the name and visibility are now preserved. Compile time semantics +remain the same, it is only the weaving process that has changed to +produce slightly different output. + +Here is the output of javap when that is built with 1.6.8: + +`` + +.... +class C extends java.lang.Object{ + public int ajc$interField$X$someField; + C(); +} +.... + +Here is the output of javap when that is built with 1.6.9: + +`` + +.... +class C extends java.lang.Object{ + private int someField; + C(); + public static int ajc$get$someField(C); + public static void ajc$set$someField(C, int); +} +.... + +The name 'someField' is preserved. The visibility is also preserved but +because of that we also need to generate some accessors to get at the +field. + +==== AspectJ snapshots in a maven repo + +To ease how AspectJ development builds can be consumed, they are now +placed into a maven repo. When a new version of AspectJ is put into AJDT +it is also put into the maven.springframework.org repo. The maven +compatible repo is `maven.springframework.org/snapshot/org/aspectj` - +and if you browse to it you will see it currently contains 1.6.9 dev +builds under the name 1.6.9.BUILD-SNAPSHOT. The repo is added with this +magic: + +`` + +.... + + maven.springframework.org + SpringSource snapshots + http://maven.springframework.org/snapshot + +.... + +and then the version to depend upon is: 1.6.9.BUILD-SNAPSHOT + +''''' diff --git a/docs/dist/doc/README-170.adoc b/docs/dist/doc/README-170.adoc new file mode 100644 index 000000000..de0248de7 --- /dev/null +++ b/docs/dist/doc/README-170.adoc @@ -0,0 +1,118 @@ +[.small]#© Copyright 2011 Contributors. All rights reserved.# + +== AspectJ 1.7.0 Readme + +The full list of resolved issues in 1.7.0 is available +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;product=AspectJ;target_milestone=1.7.0;[here] + +. + +* 1.7.0 available 2-Jul-2012 +* 1.7.0.RC1 available 25-May-2012 +* 1.7.0.M1 available 16-Dec-2011 + +=== Notable Changes + +==== Java 7 bytecode weaving + +The first milestone of 1.7.0 upgraded the compiler but this still left +the weaver with some issues if it had to weave into bytecode containing +some of the new features that were allowed by Java 1.7. In particular +this meant any bytecode containing the INVOKEDYNAMIC (new instruction +for 1.7) and the related new constant pool entry types that support it. +RC1 now supports weaving into bytecode containing these features. +However, the new INVOKEDYNAMIC instruction does not surface as a join +point yet so you cannot write a pointcut to match on it. If you use +execution() pointcuts as opposed to call() then you will still be able +to advise what the invokedynamic actually calls. + +==== Bytecode caching for loadtime weaving + +Under https://bugs.eclipse.org/bugs/show_bug.cgi?id=367673[bug 367673] +we have had a contribution (thanks John Kew!) that enables a bytecode +cache for loadtime weaving. The details and some rudimentary benchmark +numbers are in the bug. Basically it caches woven bytecode on first +start of a system using LTW and then reuses that woven bytecode on +subsequent starts - this saves weaving time and also memory consumption. +To activate it, use the following system properties: + +.... +-Daj.weaving.cache.enabled=true +-Daj.weaving.cache.dir=/tmp/aspectj-cache/ +.... + +==== Upgrade to Java 7 + +For AspectJ 1.7.0, AspectJ moved from Eclipse JDT Core 0.785_R33x +(Eclipse 3.3) to Eclipse JDT Core 0.B79_R37x (Eclipse 3.7). This is a +big change where AspectJ is picking up four years of change from the +Eclipse compiler. + +It means that you can now use the new Java 7 language constructs in your +programs: + +- Diamond operator in advice: `` + +.... +aspect Foo { + before(): execution(* *(..)) { + List ls = new ArrayList<>(); + } +} +.... + +- Diamond operator in ITD: `` + +.... +public List DiamondITD.ls = new ArrayList<>(); +.... + +- Underscore literals and binary literals in advice: `` + +.... + before(): execution(* *(..)) { + int onemill = 1_000_000; + int four =0b100; + } +.... + +- Multi-catch:`` + +.... +before(): execution(* main(..)) { + try { + foo("abc"); + } catch (ExceptionA | ExceptionB ex) { + bar(ex); + } +} +.... + +- String switch:`` + +.... + before(String s): execution(* *(..)) && args(s) { + switch(s) { + case "quux": + foo(); + break; + case "bar": + foo(); + break; + default: + foo(); + break; + } + } +.... + +- Try with resources:`` + +.... + try ( + InputStream in = new FileInputStream(src); + OutputStream out = new FileOutputStream(dest)) + { + // code + } +.... diff --git a/docs/dist/doc/README-171.adoc b/docs/dist/doc/README-171.adoc new file mode 100644 index 000000000..81712abc7 --- /dev/null +++ b/docs/dist/doc/README-171.adoc @@ -0,0 +1,36 @@ +[.small]#© Copyright 2011 Contributors. All rights reserved.# + +== AspectJ 1.7.1 Readme + +The full list of resolved issues in 1.7.1 is available +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;product=AspectJ;target_milestone=1.7.1;[here] + +. + +* 1.7.1 available 6-Sep-2012 + +=== Changes + +https://bugs.eclipse.org/bugs/show_bug.cgi?id=388971[388971] Double +Synthetic attributes on some around advice members + +https://bugs.eclipse.org/bugs/show_bug.cgi?id=387718[387718] +RuntimeException when trying to compile broken code + +https://bugs.eclipse.org/bugs/show_bug.cgi?id=387568[387568] Warning +"Xlint:unresolvableMember" for enums + +https://bugs.eclipse.org/bugs/show_bug.cgi?id=387444[387444] Softening +exception in try-with-resources + +https://bugs.eclipse.org/bugs/show_bug.cgi?id=386888[386888] spring-data +hello-worlds sample fails to compile with 1.7.0 + +https://bugs.eclipse.org/bugs/show_bug.cgi?id=386337[386337] Light AOP +Parser does not support declare-annotation + +https://bugs.eclipse.org/bugs/show_bug.cgi?id=386049[386049] Error "must +implement abstract inter-type declaration" even though build is fine + +https://bugs.eclipse.org/bugs/show_bug.cgi?id=384401[384401] NPE when no +pointcut in afterthrowing annotation style advice + +https://bugs.eclipse.org/bugs/show_bug.cgi?id=384398[384398] Type +Mismatch error when using inner classes contained in generic types +within ITDs + +https://bugs.eclipse.org/bugs/show_bug.cgi?id=381906[381906] ASPECTJ +Internal Compiler Error + +https://bugs.eclipse.org/bugs/show_bug.cgi?id=73507[73507] Public ITD of +fields on interfaces creates mangled members + diff --git a/docs/dist/doc/README-172.adoc b/docs/dist/doc/README-172.adoc new file mode 100644 index 000000000..ed93e209f --- /dev/null +++ b/docs/dist/doc/README-172.adoc @@ -0,0 +1,25 @@ +[.small]#© Copyright 2011 Contributors. All rights reserved.# + +== AspectJ 1.7.2 Readme + +The full list of resolved issues in 1.7.2 is available +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;product=AspectJ;target_milestone=1.7.2;[here] + +. + +* 1.7.2 available 13-Feb-2013 + +=== Fixes: + +* Incorrect signature attributes generated into some class files for +complex generics declarations. +* Generics information incorrectly being placed in the stackmap +verification attributes. +* Problems with generic ITDs not being picked up correctly, resulting in +'method must be implemented' errors. +* Problems with multiple usages of 'requires' clause in aop.xml for +conditional aspects. +* Generated if() pointcut representations in class files change on only +a source whitespace change. +* Intermittent problem with generic ITDs due to weak references being +collected too soon. diff --git a/docs/dist/doc/README-173.adoc b/docs/dist/doc/README-173.adoc new file mode 100644 index 000000000..e50304f2b --- /dev/null +++ b/docs/dist/doc/README-173.adoc @@ -0,0 +1,10 @@ +[.small]#© Copyright 2011 Contributors. All rights reserved.# + +== AspectJ 1.7.3 Readme + +Available 13-Jun-2013 + +The list of resolved issues in 1.7.3 is available +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;product=AspectJ;target_milestone=1.7.3;[here] + +. diff --git a/docs/dist/doc/README-174.adoc b/docs/dist/doc/README-174.adoc new file mode 100644 index 000000000..7b4cbb54c --- /dev/null +++ b/docs/dist/doc/README-174.adoc @@ -0,0 +1,34 @@ +[.small]#© Copyright 2013 Contributors. All rights reserved.# + +== AspectJ 1.7.4 Readme + +Available 24-Oct-2013 + +The list of resolved issues in 1.7.4 is available +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;product=AspectJ;target_milestone=1.7.4;[here] + +. + +*Notes* + +* This release includes an important fix for using loadtime weaving in a +JVM where JMX is turned on +(https://bugs.eclipse.org/bugs/show_bug.cgi?id=415266[415266]) +* There are some new message insert keys usable in declare error/warning +(https://bugs.eclipse.org/bugs/show_bug.cgi?id=420210[420210]) The new +keys are: ++ +.... +joinpoint.enclosingclass // Bar +joinpoint.enclosingmember // void Bar.foo(String) +joinpoint.enclosingmember.name // foo +.... ++ +All keys are case insensitive. +* It is now possible to specify individual xlint settings without +needing to supply a file +(https://bugs.eclipse.org/bugs/show_bug.cgi?id=419279[419279]) ++ +.... +ajc -Xlint:adviceDidNotMatch=error,noGuardForLazyTjp=ignore Foo.java +.... diff --git a/docs/dist/doc/README-180.adoc b/docs/dist/doc/README-180.adoc new file mode 100644 index 000000000..fe988aa5a --- /dev/null +++ b/docs/dist/doc/README-180.adoc @@ -0,0 +1,71 @@ +[.small]#© Copyright 2014 Contributors. All rights reserved.# + +== AspectJ 1.8.0 Readme + +The full list of resolved issues in 1.8.0 is available +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;product=AspectJ;target_milestone=1.8.0.M1;target_milestone=1.8.0;[here] + +. + +* 1.8.0 available 17-Apr-2014 +* 1.8.0.RC1 available 18-Mar-2014 +* 1.8.0.M1 available 29-Jul-2013 + +=== Notable changes + +==== Java 8 compilation + +AspectJ has been updated to the latest available Eclipse Java compiler +version that compiles Java8 code (the version available as a feature +patch on top of Eclipse 4.3.2). + +Here is a sample AspectJ8 program: + +.... +=== 8< ==== C.java ==== 8< === +import java.util.Arrays; + +interface I { + // Default method + default void foo() { + System.out.println("ABC"); + } +} + +public class C implements I{ + public static void main(String[] args) { + new C().foo(); + // Lambda + Runnable r = () -> { System.out.println("hello world!"); }; + r.run(); + // Used Java8 b97 + Arrays.asList(MyClass.doSomething()).forEach((p) -> System.out.println(p)); + } +} + +aspect X { + before(): execution(* I.foo()) { + System.out.println("I.foo running"); + } + before(): staticinitialization(!X) { + System.out.println("Clazz "+thisJoinPointStaticPart); + } +} + + +class Utils { + public static int compareByLength(String in, String out) { + return in.length() - out.length(); + } +} + +class MyClass { + public static String[] doSomething() { + String []args = new String[]{"4444","333","22","1"}; + // Method reference + Arrays.sort(args,Utils::compareByLength); + return args; + } +} +=== 8< ==== C.java ==== 8< === +.... diff --git a/docs/dist/doc/README-181.adoc b/docs/dist/doc/README-181.adoc new file mode 100644 index 000000000..e008473da --- /dev/null +++ b/docs/dist/doc/README-181.adoc @@ -0,0 +1,18 @@ +[.small]#© Copyright 2014 Contributors. All rights reserved.# + +== AspectJ 1.8.1 Readme + +The full list of resolved issues in 1.8.1 is available +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;product=AspectJ;target_milestone=1.8.1;[here] + +. + +* 1.8.1 available 20-Jun-2014 + +=== Notable changes + +==== Java 8 update + +As Eclipse itself nears the 4.4 release, AspectJ has been updated to the +latest Eclipse JDT Core that will be included in it, picking up numerous +Java8 related fixes. diff --git a/docs/dist/doc/README-1810.adoc b/docs/dist/doc/README-1810.adoc new file mode 100644 index 000000000..947dae81c --- /dev/null +++ b/docs/dist/doc/README-1810.adoc @@ -0,0 +1,39 @@ +[.small]#© Copyright 2016 Contributors. All rights reserved.# + +== AspectJ 1.8.10 Readme + +The full list of resolved issues in 1.8.10 is available +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;product=AspectJ;target_milestone=1.8.10;[here] + +. + +* 1.8.10 available 9-Dec-2016 + +=== Notable changes + +==== JDT Upgrade + +The JDT compiler inside AspectJ has been upgraded to the Eclipse Neon.2 +level (JDT commit #75dbfad0). + +==== Java8 + +The Eclipse JDT compiler embedded inside AspectJ now requires Java 8, so +that is the minimum required level to compile sources with AspectJ. +However, if only doing weaving and no compilation then it is possible to +use Java 7. + +==== Annotation style around advice and proceed (https://bugs.eclipse.org/bugs/show_bug.cgi?id=500035[Bug 500035]) + +A long standing issue that has been lurking in the handling of arguments +passed to proceed for annotation style aspects has been fixed. If, at a +joinpoint where 'this'/'target' differ (for example at some call +joinpoints), the pointcut bound either 'this' or 'target' (but not +both), then the system would still expect the advice to pass both 'this' +and 'target' into the proceed call. With the fix here you only need to +pass what you bind. So if you bind only 'this' you don't need to pass +'target' (and vice versa). This will affect users that have been working +around this quirk by passing both 'this' and 'target'. That isn't +necessary anymore. This fix is in aspectjrt.jar so you will need to be +using the 1.8.10 version of aspectjrt.jar at runtime to pickup this +change. diff --git a/docs/dist/doc/README-1811.adoc b/docs/dist/doc/README-1811.adoc new file mode 100644 index 000000000..88b159139 --- /dev/null +++ b/docs/dist/doc/README-1811.adoc @@ -0,0 +1,19 @@ +[.small]#© Copyright 2017 Contributors. All rights reserved.# + +== AspectJ 1.8.11 Readme + +This release is a small compatibility release to improve the behaviour +of the AspectJ 1.8 line on JDK9. Importantly it includes a change that +knows about the Java 9 version information and so does not get confused +and think it is running on something really old (which typically +manifests as it complaining about annotations not being supported on +this level of Java). + +With that change this release is usable for Spring AOP use cases because +that is doing runtime pointcut matching with proxy creation rather than +actual weaving. Although if you using Spring AOP with class level +annotation retention there may still be issues. If you experience +problems or need to do actual weaving on JDK9, please use AspectJ9 +instead. + +* 1.8.11 available 26-Sep-2017 diff --git a/docs/dist/doc/README-182.adoc b/docs/dist/doc/README-182.adoc new file mode 100644 index 000000000..45215367d --- /dev/null +++ b/docs/dist/doc/README-182.adoc @@ -0,0 +1,171 @@ +[.small]#© Copyright 2014 Contributors. All rights reserved.# + +== AspectJ 1.8.2 Readme + +The full list of resolved issues in 1.8.2 is available +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;product=AspectJ;target_milestone=1.8.2;[here] + +. + +* 1.8.2 available 14-Aug-2014 + +=== Notable changes + +Although only a few bugs have been fixed here, they are quite important +ones: + +==== Update to more recent Eclipse Compiler + +AspectJ is now based on a more up to date Eclipse compiler level (git +hash 2b07958) so includes all the latest fixes + +==== Correct handling of RuntimeInvisibleTypeAnnotations (type annotations without runtime visibility) + +For anyone weaving code containing these kind of type annotations, this +is an important fix. Although AspectJ does not currently support +pointcuts matching on these kinds of annotation it was crashing when +they were encountered. That is now fixed. + +==== Annotation processing + +A very long standing issue, the AspectJ compiler now supports annotation +processors thanks to some work by Sergey Stupin. + +Here is a short example, a very basic annotation and application: + +===== Marker.java + +`` + +.... +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; + +@Retention(RetentionPolicy.RUNTIME) +public @interface Marker { } +.... + +===== Code.java + +`` + +.... +public class Code { + + public static void main(String []argv) { + new Code().moo(); + new Code().boo(); + new Code().too(); + new Code().woo(); + } + + public void moo() {} + + @Marker + public void boo() {} + + @Marker + public void too() {} + + public void woo() {} +} +.... + +And now a basic annotation processor. This processor will find methods +in the source marked with the annotation Marker and for each one +generate an aspect tailored to advising that method (this *is* a +contrived demo!) + +===== DemoProcessor.java + +`` + +.... +import java.io.*; +import javax.tools.*; +import java.util.*; +import javax.annotation.processing.*; +import javax.lang.model.*; +import javax.lang.model.element.*; + +@SupportedAnnotationTypes(value= {"*"}) +@SupportedSourceVersion(SourceVersion.RELEASE_6) +public class DemoProcessor extends AbstractProcessor { + + private Filer filer; + + @Override + public void init(ProcessingEnvironment env) { + filer = env.getFiler(); + } + + @Override + public boolean process(Set elements, RoundEnvironment env) { + // Discover anything marked with @Marker + for (Element element: env.getElementsAnnotatedWith(Marker.class)) { + if (element.getKind() == ElementKind.METHOD) { + // For any methods we find, create an aspect: + String methodName = element.getSimpleName().toString(); + String aspectText = + "public aspect Advise_"+methodName+" {\n"+ + " before(): execution(* "+methodName+"(..)) {\n"+ + " System.out.println(\""+methodName+" running\");\n"+ + " }\n"+ + "}\n"; + try { + JavaFileObject file = filer.createSourceFile("Advise_"+methodName, element); + file.openWriter().append(aspectText).close(); + System.out.println("Generated aspect to advise "+element.getSimpleName()); + } catch (IOException ioe) { + // already creates message can appear if processor runs more than once + if (!ioe.getMessage().contains("already created")) { + ioe.printStackTrace(); + } + } + } + } + return true; + } +} +.... + +With those sources, we compile the processor: + +`` + +.... +ajc -1.6 DemoProcessor.java Marker.java +.... + +Now compile the code with the processor specified: + +`` + +.... +ajc -1.6 -processor DemoProcessor -showWeaveInfo Code.java Marker.java +.... + +`` + +.... +Generated aspect to advise too +Generated aspect to advise boo +Join point 'method-execution(void Code.boo())' in Type 'Code' (Code.java:14) advised by before advice from 'Advise_boo' (Advise_boo.java:2) +Join point 'method-execution(void Code.too())' in Type 'Code' (Code.java:17) advised by before advice from 'Advise_too' (Advise_too.java:2) +.... + +Notice the processor generates the aspects and then they are woven into +the code being compiled immediately. + +Finally we can run it: + +`` + +.... +java Code +boo running +too running +.... + +*Note:* There is still work to be done to get annotation processors +behaving under AJDT. diff --git a/docs/dist/doc/README-183.adoc b/docs/dist/doc/README-183.adoc new file mode 100644 index 000000000..95425e392 --- /dev/null +++ b/docs/dist/doc/README-183.adoc @@ -0,0 +1,116 @@ +[.small]#© Copyright 2014 Contributors. All rights reserved.# + +== AspectJ 1.8.3 Readme + +The full list of resolved issues in 1.8.3 is available +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;product=AspectJ;target_milestone=1.8.3;[here] + +. + +* 1.8.3 available 22-Oct-2014 + +=== Notable changes + +==== Conditional aspect activation with @RequiredTypes - https://bugs.eclipse.org/bugs/show_bug.cgi?id=436653[Issue 436653] + +AspectJ is sometimes used to create aspect libraries. These libraries +contain a number of aspects often covering a variety of domains. The +library might typically be available as a jar and contains a single +aop.xml file that names all the aspects. The library is then consumed by +some application. However, the application may not need to use all those +aspects but because they are listed in the aop.xml they will be +'active'. Now the pointcuts in those unused aspects may not match +anything in the application and could be considered harmless but the +pointcuts and the aspects themselves may have references to types in +other libraries that the application does not have around. This can lead +to unhelpful "can't find type" messages and currently requires the user +to add unnecessary entries to their build dependencies just to keep the +unused aspects happy. + +With AspectJ 1.8.3 it is now possible to express a constraint on an +aspect. The @RequiredTypes annotation specifies one or more fully +qualified types that must be discoverable on the classpath in order for +the aspect to activate. Using this there is no need to add those +extraneous dependencies to an applications build classpath. + +Example: + +.... +import org.aspectj.lang.annotation.*; + +@RequiredTypes("com.foo.Bar") +public aspect Foo { + before(): execution(@com.foo.Bar * *(..)) {} +} +.... + +If the above aspect is listed in an aop.xml for loadtime weaving or +passed on the aspectpath for compile time weaving, if the type +'com.foo.Bar' is not accessible on the classpath then the aspect will be +turned off and the pointcut will have no effect. There will be no +attempt made to match it and so no unhelpful "can't find type" messages. + +==== cflow and the pre-initialization joinpoint changes due to Java 7 verifier modifications - https://bugs.eclipse.org/bugs/show_bug.cgi?id=443477[Issue 443477] + +There has been a change in the Java7 verifier in a recent patch release +of Java7 (update 67) that causes a verify error for usage of a +particular AspectJ construct. The problem occurs if you are using cflow +and it hits the preinitialization join point. The pattern of code +generated in that case causes the verifyerror. In this release of +AspectJ we have taken the 'quick' approach to solving this, namely to +avoid advising preinitialization with the cflow construct. This problem +appears to come up when the aspect is non-optimal anyway and hitting +preinitialization was never really intended by the pointcut writer. For +example: + +.... +execution(* foo(..)) && cflow(within(Bar)) +.... + +The use of cflow and within there will actually hit *a lot* of +joinpoints, many of which the user probably didn't mean to. It feels +like we actually need a warning to indicate the pointcut is probably +suboptimal. What the user probably meant was something more like this: + +.... +execution(* foo(..)) && cflow(execution(* Bar.*(..)) +.... + +or + +.... +execution(* foo(..)) && cflow(within(Bar) && execution(* *(..))) +.... + +But even if they did want the less optimal form of cflow there still +seems little use in applying it to pre-initialization - that is your cue +to raise an AspectJ bug with a realistic use case inside that proves +this an invalid assumption :) + +==== around advice and lambdas - https://bugs.eclipse.org/bugs/show_bug.cgi?id=445395[Issue 445395] + +For optimal performance, where possible, AspectJ tries to inline around +advice when it applies at a joinpoint. There are few characteristics of +a joinpoint match that can prevent this but we do try to inline where we +can (the inlining can be manually turned off via -XnoInline). + +Inlining of around advice basically means copying the advice +instructions into the target class. This causes a problem when the +advice uses lambdas. Lambda usage is currently implemented in java +compilers by generating invokedynamic bytecode instructions that +reference bootstrap methods created in the class and a helper method +generated in the class containing the lambda code. When the +invokedynamic is encountered at runtime, some magic happens and the +bootstrap method is used to generate a class on the fly that calls the +particular lambda method. All this 'extra stuff' breaks the basic +inlining algorithm that simply copies the advice bytecode into the +target. Effectively the inlining process needs to become much more +sophisticated and copy the bootstrap methods and the lambda helper +methods, avoiding clashes with existing bootstrap/helpers in the target. + +Prior to AspectJ 1.8.3 when the inlining failed you would get a horrible +class cast exception that mentions constant pool entries (because the +bootstrap method hadn't been copied over to the target). Temporarily in +1.8.3 we are turning off inlining of around advice containing lambdas, +which will at least avoid the failure, with the longer term goal of +improving the inlining process to do all the necessary extra work. diff --git a/docs/dist/doc/README-184.adoc b/docs/dist/doc/README-184.adoc new file mode 100644 index 000000000..002aea1ac --- /dev/null +++ b/docs/dist/doc/README-184.adoc @@ -0,0 +1,31 @@ +[.small]#© Copyright 2014 Contributors. All rights reserved.# + +== AspectJ 1.8.4 Readme + +The full list of resolved issues in 1.8.4 is available +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;product=AspectJ;target_milestone=1.8.4;[here] + +. + +* 1.8.4 available 6-Nov-2014 + +=== Notable changes + +==== Support for is(FinalType) + +AspectJ has had type category type patterns since version 1.6.9, see the +https://www.eclipse.org/aspectj/doc/released/README-169.html[README]. +This enabled pointcuts to include is(..) clauses to specify which kinds +of type they were or were not interested in matching, e.g. !within(* && +is(InnerType)) means not within innertypes. In 1.8.4 it is now possible +to recognize (for inclusion or exclusion) final types with +is(FinalType). + +==== thisAspectInstance correctly handled with -1.8 + +This is the key fix in this release. Some products based on AspectJ were +using the thisAspectInstance feature (see +https://www.eclipse.org/aspectj/doc/released/README-1612.html[README +1.6.12] for more info on the feature). Unfortunately if specifying -1.8 +compliance and using the feature an error would be reported at compile +time of the aspect. This is now fixed. diff --git a/docs/dist/doc/README-185.adoc b/docs/dist/doc/README-185.adoc new file mode 100644 index 000000000..909dbfecc --- /dev/null +++ b/docs/dist/doc/README-185.adoc @@ -0,0 +1,16 @@ +[.small]#© Copyright 2015 Contributors. All rights reserved.# + +== AspectJ 1.8.5 Readme + +The full list of resolved issues in 1.8.5 is available +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;product=AspectJ;target_milestone=1.8.5;[here] + +. + +* 1.8.5 available 28-Jan-2015 + +=== Notable changes + +The most important fixes in 1.8.5 are JDT compiler fixes that it +includes +(https://bugs.eclipse.org/bugs/show_bug.cgi?id=455277[455277],https://bugs.eclipse.org/bugs/show_bug.cgi?id=458660[458660]). diff --git a/docs/dist/doc/README-186.adoc b/docs/dist/doc/README-186.adoc new file mode 100644 index 000000000..9810ab863 --- /dev/null +++ b/docs/dist/doc/README-186.adoc @@ -0,0 +1,10 @@ +[.small]#© Copyright 2015 Contributors. All rights reserved.# + +== AspectJ 1.8.6 Readme + +The full list of resolved issues in 1.8.6 is available +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;product=AspectJ;target_milestone=1.8.6;[here] + +. + +* 1.8.6 available 5-Jun-2015 diff --git a/docs/dist/doc/README-187.adoc b/docs/dist/doc/README-187.adoc new file mode 100644 index 000000000..de61a362b --- /dev/null +++ b/docs/dist/doc/README-187.adoc @@ -0,0 +1,134 @@ +[.small]#© Copyright 2015 Contributors. All rights reserved.# + +== AspectJ 1.8.7 Readme + +The full list of resolved issues in 1.8.7 is available +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;product=AspectJ;target_milestone=1.8.7;[here] + +. + +* 1.8.7 available 9-Sep-2015 + +=== Notable changes + +==== ajdoc + +The ajdoc tool has been fixed! It is now working again if run on a 1.7 +JDK. + +==== Dynamic weaver attachment + +The AspectJ loadtime weaving agent can now be dynamically attached to a +JVM after it has started (you don't need to use -javaagent). This offers +extra flexibility but obviously any classes loaded before attachment +will not be woven. + +Here is a simple aspect: + +`` + +.... +public aspect Azpect { + before(): execution(* *(..)) { + System.out.println(thisJoinPointStaticPart); + } +} +.... + +Compiled via: + +`` + +.... +ajc -1.8 Azpect.java -outxml +.... + +This produces a compiled class Azpect.class and a file +META-INF/aop-ajc.xml. + +I then have this sample application (same directory): + +`` + +.... +import java.lang.management.ManagementFactory; +import org.aspectj.weaver.loadtime.Agent; +import com.sun.tools.attach.VirtualMachine; + +public class Application { + + public static void main(String[] args) { + if (!isAspectJAgentLoaded()) + System.err.println("WARNING: AspectJ weaving agent not loaded"); + new Sample().doSomething(); + } + + public static boolean isAspectJAgentLoaded() { + try { + Agent.getInstrumentation(); + } catch (NoClassDefFoundError e) { + System.out.println(e); + return false; + } catch (UnsupportedOperationException e) { + System.out.println(e); + return dynamicallyLoadAspectJAgent(); + } + return true; + } + + public static boolean dynamicallyLoadAspectJAgent() { + String nameOfRunningVM = ManagementFactory.getRuntimeMXBean().getName(); + int p = nameOfRunningVM.indexOf('@'); + String pid = nameOfRunningVM.substring(0, p); + try { + VirtualMachine vm = VirtualMachine.attach(pid); + String jarFilePath = System.getProperty("AGENT_PATH"); + vm.loadAgent(jarFilePath); + vm.detach(); + } catch (Exception e) { + System.out.println(e); + return false; + } + return true; + } +} +.... + +And this Sample class: + +`` + +.... +public class Sample { + public void doSomething() { + System.out.println("Do something"); + System.out.println("Square of 7 = " + square(7)); + } + + private int square(int i) { + return i * i; + } +} +.... + +Compile these with javac, *but you must have the aspectjweaver and the +JDK tools.jar on your classpath*. + +Once compiled we can run it: + +`` + +.... +java -DAGENT_PATH=/aspectjweaver.jar Application +.... + +What does it do? The main method calls the function that detects whether +the agent is attached, if it is not then it programmatically attaches it +using the VirtualMachine class. Then the main method accesses the Sample +class. At this point in program execution the Sample class is loaded and +because the agent has been attached it gets woven. Notice that the +Application class itself is not woven because it was loaded prior to +agent attachment. + +Thanks to Alexander Kriegisch for the sample code and the patch to add +this behaviour to AspectJ. diff --git a/docs/dist/doc/README-188.adoc b/docs/dist/doc/README-188.adoc new file mode 100644 index 000000000..3f720edac --- /dev/null +++ b/docs/dist/doc/README-188.adoc @@ -0,0 +1,19 @@ +[.small]#© Copyright 2016 Contributors. All rights reserved.# + +== AspectJ 1.8.8 Readme + +The full list of resolved issues in 1.8.8 is available +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;product=AspectJ;target_milestone=1.8.8;[here] + +. + +* 1.8.8 available 7-Jan-2016 + +=== Notable changes + +==== Around advice on default methods + +In previous releases attempting to apply around advice to default +methods would create methods with rogue modifiers in the interface +declaring the default method (loading these interfaces would then result +in a verifier error). This has now been fixed. diff --git a/docs/dist/doc/README-189.adoc b/docs/dist/doc/README-189.adoc new file mode 100644 index 000000000..c3ecd3a56 --- /dev/null +++ b/docs/dist/doc/README-189.adoc @@ -0,0 +1,15 @@ +[.small]#© Copyright 2016 Contributors. All rights reserved.# + +== AspectJ 1.8.9 Readme + +The full list of resolved issues in 1.8.9 is available +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;product=AspectJ;target_milestone=1.8.9;[here] + +. + +* 1.8.9 available 14-Mar-2016 + +=== Notable changes + +The JDT compiler inside AspectJ has been upgraded to the Eclipse Mars.2 +level (commit #a7bba8b1). diff --git a/docs/dist/doc/README-190.adoc b/docs/dist/doc/README-190.adoc new file mode 100644 index 000000000..3b1f27784 --- /dev/null +++ b/docs/dist/doc/README-190.adoc @@ -0,0 +1,339 @@ +[.small]#© Copyright 2018 Contributors. All rights reserved.# + +The full list of resolved issues in 1.9.0 is available +https://bugs.eclipse.org/bugs/buglist.cgi?bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&f0=OP&f1=OP&f3=CP&f4=CP&j1=OR&list_id=16866879&product=AspectJ&query_format=advanced&target_milestone=1.9.0[here] + +. + +== AspectJ 1.9.0 + +=== Improved runtime interface + +New factory methods have been added to the AspectJ runtime. This is an +attempt to more optimally create thisJoinPoint and +thisEnclosingJoinPoint objects. The generated code that invokes these +now also uses the ability for the LDC bytecode instruction to load class +constants directly (this replaces what was happening previously where +generated code referenced string classnames and classloading was being +done from the aspectj runtime as the woven application was starting). + +This is turned on by using -Xajruntimetarget:1.9. This option was used +previously to enable users to target an old runtime if they knew that +old runtime is all that was available at some deployed target. The new +generation mechanism is not the default, not until it has had a bit more +testing out in the wild. + +The changes to generated code have a couple of potential side effects: + +* *overall size*: the woven code may be smaller due to the use of +smaller string constant pieces in the generated code (previously strings +were smashed together in the generated code and then taken apart by +AspectJ at runtime). Since the pieces are smaller, they can be shared +across other uses in the class file. +* *method size*: although the overall class may be smaller there are +more instructions involved in preparing the data for invocation of the +new joinpoint factory methods. It is possible if you have a lot of +joinpoints that we might blow the 64k instruction limit for the +ajc$preClinit method (where the factory invocation code is generated). +Please provide feedback if this happens to you! + +In anticipation of not all build plugins supporting that +-Xajruntimetarget option, you can now specify these kinds of option in +the ASPECTJ_OPTS environment variable. Set that in your environment: + +.... +export ASPECTJ_OPTS="-Xajruntimetarget:1.9" +.... + +And it should get picked up by AspectJ when it runs. + +* 1.9.0 available 2-Apr-2018 + +== AspectJ 1.9.0.RC4 + +Primary changes in RC4 are to add support for in the Ant +task. This enables users of the Ant task to pass in options supported by +the underlying AspectJ but not yet surfaced elsewhere. Particularly +useful with Java9 which includes a number of module related commands. +For example, here is an iajc usage with compilerArg that is passing +--add-modules java.xml.bind: + +.... + + + + + + + + +.... + +1.9.0.RC4 available 21-Feb-2018 + +== AspectJ 1.9.0.RC3 + +Primary changes in RC3 are to upgrade JDT and pickup all the fixes for +Java9 that have gone into it over the last few months. + +1.9.0.RC3 available 5-Feb-2018 + +== AspectJ 1.9.0.RC2 + +* 1.9.0.RC2 available 9-Nov-2017 + +Key change in 1.9.0.RC2 is actually to be more tolerant of JDK10. The +version handling has been somewhat overhauled so AspectJ 9 will behave +better on Java 10 and future JDKs. This should put AspectJ in a better +place if new JDK versions are going to arrive thick and fast. + +== AspectJ 1.9.0.RC1 + +* 1.9.0.RC1 available 20-Oct-2017 + +This is the first release candidate of AspectJ 1.9.0 - the version of +AspectJ to be based on Java9. It includes a recent version of the +Eclipse Java9 compiler (from jdt core, commit #062ac5d7a6bf9). + +=== Automatic Modules + +AspectJ can now be used with the new module system available in Java9. +The key jars in AspectJ have been given automatic module names. The +automatic module name is org.aspectj.runtime for the aspectjrt module: + +.... +$ java --module-path /lib/aspectjrt.jar --list-modules | grep aspectj + +org.aspectj.runtime file:////lib/aspectjrt.jar automatic +.... + +And similarly org.aspectj.weaver and org.aspectj.tools for aspectjweaver +and aspectjtools respectively: + +.... +$ java --module-path /lib/aspectjweaver.jar --describe-module org.aspectj.weaver + +org.aspectj.weaver file:////lib/aspectjweaver.jar automatic +requires java.base mandated +contains aj.org.objectweb.asm +contains aj.org.objectweb.asm.signature +contains org.aspectj.apache.bcel +contains org.aspectj.apache.bcel.classfile +contains org.aspectj.apache.bcel.classfile.annotation +contains org.aspectj.apache.bcel.generic +contains org.aspectj.apache.bcel.util +contains org.aspectj.asm +contains org.aspectj.asm.internal +... +.... + + + + + + +=== Building woven modules + +AspectJ understands module-info.java source files and building modules +that include aspects. Here is an example: + +.... +module-info.java + +module demo { + exports pkg; + requires org.aspectj.runtime; +} + + +pkg/Demo.java + +package pkg; + +public class Demo { + public static void main(String[] argv) { + System.out.println("Demo running"); + } +} + + +otherpkg/Azpect.java + +package otherpkg; + +public aspect Azpect { + before(): execution(* *(..)) && !within(Azpect) { + System.out.println("Azpect running"); + } +} +.... + +We can now build those into a module: + +.... +$ ajc -1.9 module-info.java otherpkg/Azpect.java pkg/Demo.java -outjar demo.jar + +... +module-info.java:3 [error] org.aspectj.runtime cannot be resolved to a module +... +.... + +Wait, that failed! Yes, aspectjrt.jar (which includes the required +org.aspectj.weaver module) wasn't supplied. We need to pass it on the +module-path: + +.... +$ ajc -1.9 --module-path /aspectjrt.jar module-info.java otherpkg/Azpect.java pkg/Demo.java -outjar demo.jar +.... + +Now we have a demo module we can run: + +.... +$ java --module-path /aspectjrt.jar:demo.jar --module demo/pkg.Demo + +Azpect running +Demo running +.... + +That's it! + + + + + + +=== Binary weaving with modules + +A module is really just a jar with a module-info descriptor. As such you +can simply pass a module on the inpath and binary weave it with other +aspects. Take the module we built above, let's weave into it again: + +.... +extra/AnotherAzpect.java + +package extra; + +public aspect AnotherAzpect { + before(): execution(* *(..)) && !within(*Azpect) { + System.out.println("AnotherAzpect running"); + } +} +.... + +.... +$ ajc -inpath demo.jar AnotherAzpect.java -outjar newdemo.jar +.... + +Notice how there was no complaint here that the org.aspectj.runtime +module hadn't been passed in. That is because inpath was being used +which doesn't treat specified jars as modules (and so does not check +dependencies). There is no module-inpath right now. + +Because the new jar produced includes the compiled aspect, the +module-info specification inside is still correct, so we can run it +exactly as before: + +.... +$ java --module-path ~/installs/aspectj190rc1/lib/aspectjrt.jar:newdemo.jar --module demo/pkg.Demo + +Azpect running +AnotherAzpect running +Demo running +.... + + + + + + +=== Faster Spring AOP + +Dave Syer recently created a series of benchmarks for checking the speed +of Spring-AspectJ: https://github.com/dsyer/spring-boot-aspectj + +Here we can see the numbers for AspectJ 1.8.11 (on an older Macbook +Pro): + +.... +Benchmark (scale) Mode Cnt Score Error Units +StartupBenchmark.ltw N/A avgt 10 2.553 ~ 0.030 s/op +StartupBenchmark.ltw_100 N/A avgt 10 2.608 ~ 0.046 s/op +StartupBenchmark.spring v0_10 avgt 10 2.120 ~ 0.148 s/op +StartupBenchmark.spring v1_10 avgt 10 2.219 ~ 0.066 s/op +StartupBenchmark.spring v1_100 avgt 10 2.244 ~ 0.030 s/op +StartupBenchmark.spring v10_50 avgt 10 2.950 ~ 0.026 s/op +StartupBenchmark.spring v20_50 avgt 10 3.854 ~ 0.090 s/op +StartupBenchmark.spring v20_100 avgt 10 4.003 ~ 0.038 s/op +StartupBenchmark.spring a0_10 avgt 10 2.067 ~ 0.019 s/op +StartupBenchmark.spring a1_10 avgt 10 2.724 ~ 0.023 s/op +StartupBenchmark.spring a1_100 avgt 10 2.778 ~ 0.057 s/op +StartupBenchmark.spring a10_50 avgt 10 7.191 ~ 0.134 s/op +StartupBenchmark.spring a10_100 avgt 10 7.191 ~ 0.168 s/op +StartupBenchmark.spring a20_50 avgt 10 11.541 ~ 0.158 s/op +StartupBenchmark.spring a20_100 avgt 10 11.464 ~ 0.157 s/op +.... + +So this is the average startup of an app affected by aspects applying to +the beans involved. Where numbers are referenced the first is the number +of aspects/pointcuts and the second is the number of beans. The 'a' +indicates an annotation based pointcut vs a non-annotation based +pointcut ('v'). Notice things are much worse for annotation based +pointcuts. At 20 pointcuts and 50 beans the app is 9 seconds slower to +startup. + + +In AspectJ 1.8.12 and 1.9.0.RC1 some work has been done here. The key +change is to recognize that the use of annotations with runtime +retention is much more likely than annotations with class level +retention. Retrieving annotations with class retention is costly because +we must open the bytes for the class file and dig around in there (vs +runtime retention which are immediately accessible by reflection on the +types). In 1.8.11 the actual type of the annotation involved in the +matching is ignored and the code will fetch *all* the annotations on the +type/method/field being matched against. So even if the match is looking +for a runtime retention annotation, we were doing the costly thing of +fetching any class retention annotations. In 1.8.12/1.9.0.RC1 we take +the type of the match annotation into account - allowing us to skip +opening the classfiles in many cases. There is also some deeper work on +activating caches that were not previously being used correctly but the +primary change is factoring in the annotation type. + +What difference does that make? AspectJ 1.9.0.RC1: + +.... +Benchmark (scale) Mode Cnt Score Error Units +StartupBenchmark.ltw N/A avgt 10 2.568 ~ 0.035 s/op +StartupBenchmark.ltw_100 N/A avgt 10 2.622 ~ 0.075 s/op +StartupBenchmark.spring v0_10 avgt 10 2.096 ~ 0.054 s/op +StartupBenchmark.spring v1_10 avgt 10 2.206 ~ 0.031 s/op +StartupBenchmark.spring v1_100 avgt 10 2.252 ~ 0.025 s/op +StartupBenchmark.spring v10_50 avgt 10 2.979 ~ 0.071 s/op +StartupBenchmark.spring v20_50 avgt 10 3.851 ~ 0.058 s/op +StartupBenchmark.spring v20_100 avgt 10 4.000 ~ 0.046 s/op +StartupBenchmark.spring a0_10 avgt 10 2.071 ~ 0.026 s/op +StartupBenchmark.spring a1_10 avgt 10 2.182 ~ 0.032 s/op +StartupBenchmark.spring a1_100 avgt 10 2.272 ~ 0.024 s/op +StartupBenchmark.spring a10_50 avgt 10 2.557 ~ 0.027 s/op +StartupBenchmark.spring a10_100 avgt 10 2.598 ~ 0.040 s/op +StartupBenchmark.spring a20_50 avgt 10 2.961 ~ 0.043 s/op +StartupBenchmark.spring a20_100 avgt 10 3.093 ~ 0.098 s/op +.... + +Look at the a20_100 case - instead of impacting start time by 9 seconds, +it impacts it by 1 second. + +=== More to come... + +* Eclipse JDT Java 9 support is still being actively worked on and lots +of fixes will be coming through over the next few months and included in +AspectJ 1.9.X revisions. +* AspectJ does not currently modify module-info.java files. An aspect +from one module applying to code in another module clearly introduces a +dependency between those two modules. There is no reason - other than +time! - that this can't be done. +(https://bugs.eclipse.org/bugs/show_bug.cgi?id=526244[Issue 526244]) +* Related to that AspectJ, on detection of aspects should be able to +automatically introduce the requires org.aspectj.runtime to the +module-info. (https://bugs.eclipse.org/bugs/show_bug.cgi?id=526242[Issue +526242]) +* Module aware variants of AspectJ paths: --module-inpath, +--module-aspectpath. +(https://bugs.eclipse.org/bugs/show_bug.cgi?id=526243[Issue 526243]) + + + + + diff --git a/docs/dist/doc/README-191.adoc b/docs/dist/doc/README-191.adoc new file mode 100644 index 000000000..acab550c3 --- /dev/null +++ b/docs/dist/doc/README-191.adoc @@ -0,0 +1,35 @@ +[.small]#© Copyright 2018 Contributors. All rights reserved.# + +The full list of resolved issues in 1.9.1 is available +https://bugs.eclipse.org/bugs/buglist.cgi?bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&f0=OP&f1=OP&f3=CP&f4=CP&j1=OR&list_id=16866879&product=AspectJ&query_format=advanced&target_milestone=1.9.1[here] + +. + +== AspectJ 1.9.1 + +=== Java 10 support + +AspectJ has updated to a recent JDT compiler version (commit +#abe06abe4ce1 - 9-Apr-2018). With this update it now supports Java10. +This means you can use the 'var' support. A simple example of combining +var with an aspect: + +.... +public class Code3 { + public static void main(String []argv) { + var x = "hello"; + System.out.println(x.getClass()); + } +} + +aspect X { + before(): call(* *.getClass()) && target(String) { + System.out.println(thisJoinPointStaticPart); + } +} +.... + +Available: 1.9.1 available 20-Apr-2018 + + + + + diff --git a/docs/dist/doc/README-192.adoc b/docs/dist/doc/README-192.adoc new file mode 100644 index 000000000..03f3e6c15 --- /dev/null +++ b/docs/dist/doc/README-192.adoc @@ -0,0 +1,18 @@ +[.small]#© Copyright 2018 Contributors. All rights reserved.# + +The full list of resolved issues in 1.9.2 is available +https://bugs.eclipse.org/bugs/buglist.cgi?bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&f0=OP&f1=OP&f3=CP&f4=CP&j1=OR&list_id=16866879&product=AspectJ&query_format=advanced&target_milestone=1.9.2[here] + +. + +== AspectJ 1.9.2 + +=== Java 11 support + +AspectJ now supports Java11. It has been updated to a more recent JDT +compiler that supports Java 11 (JDTCore #6373b82afa49b). + +Available: 1.9.2 available Oct-2018 + + + + + diff --git a/docs/dist/doc/README-193.adoc b/docs/dist/doc/README-193.adoc new file mode 100644 index 000000000..a75724c2c --- /dev/null +++ b/docs/dist/doc/README-193.adoc @@ -0,0 +1,77 @@ +[.small]#© Copyright 2018 Contributors. All rights reserved.# + +The full list of resolved issues in 1.9.3 is available +https://bugs.eclipse.org/bugs/buglist.cgi?bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&f0=OP&f1=OP&f3=CP&f4=CP&j1=OR&list_id=16866879&product=AspectJ&query_format=advanced&target_milestone=1.9.3[here] + +. + +AspectJ 1.9.3 supports Java12. Java12 introduces the new switch +expression syntax, but you must activate support for that via an +--enable-preview flag when using the compiler and attempting to run the +resultant classes: Here is Switch3.java: + +.... +=========8<========= +public class Switch3 { + public static void main(String[] argv) { + System.out.println(one(Color.R)); + System.out.println(one(Color.G)); + System.out.println(one(Color.B)); + System.out.println(one(Color.Y)); + } + + public static int one(Color color) { + int result = switch(color) { + case R -> foo(0); + case G -> foo(1); + case B -> foo(2); + default -> foo(3); + }; + return result; + } + + public static final int foo(int i) { + return i+1; + } +} + +enum Color { + R, G, B, Y; +} + +aspect X { + int around(): call(* foo(..)) { + return proceed()*3; + } +} +=========8<========= +.... + +Compile it with: + +.... +$ ajc --enable-preview -showWeaveInfo -12 Switch3.java + +Join point 'method-call(int Switch3.foo(int))' in Type 'Switch3' (Switch3.java:12) advised by around advice from 'X' (Switch3.java:30) + +Join point 'method-call(int Switch3.foo(int))' in Type 'Switch3' (Switch3.java:13) advised by around advice from 'X' (Switch3.java:30) + +Join point 'method-call(int Switch3.foo(int))' in Type 'Switch3' (Switch3.java:14) advised by around advice from 'X' (Switch3.java:30) + +Join point 'method-call(int Switch3.foo(int))' in Type 'Switch3' (Switch3.java:15) advised by around advice from 'X' (Switch3.java:30) +.... + +Now run it: + +.... +$ java --enable-preview Switch3 +3 +6 +9 +12 +.... + +Available: 1.9.3.RC1 available 7-Mar-2019 + + + + + diff --git a/docs/dist/doc/README-194.adoc b/docs/dist/doc/README-194.adoc new file mode 100644 index 000000000..44d4e238d --- /dev/null +++ b/docs/dist/doc/README-194.adoc @@ -0,0 +1,29 @@ +[.small]#© Copyright 2019 Contributors. All rights reserved.# + +== AspectJ 1.9.4 + +The full list of resolved issues in 1.9.4 is available +https://bugs.eclipse.org/bugs/buglist.cgi?bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&f0=OP&f1=OP&f3=CP&f4=CP&j1=OR&list_id=16866879&product=AspectJ&query_format=advanced&target_milestone=1.9.4[here] + +. + +AspectJ 1.9.4 has a couple of important fixes in it: + +* Due to the new maven build process being used to build release +artifacts for the first time, there were errors in the aspectjweaver jar +that affected the ability to use it on the command line as an agent, +this is now fixed. +* A number of users were noticing a ClassCastException problem, which I +believe was due to trying to run AspectJ on one level of the JDK whilst +targeting another. This can happen quite easily in eclipse if running +your Eclipse on Java 8 but developing projects targeting Java 11. The +class cast is because Java8 couldn't understand the packaging of system +classes post Java9 and so couldn't find java.lang.Object. This has now +all been tidied up and should work much better. More details in +https://bugs.eclipse.org/bugs/show_bug.cgi?id=546807[546807], thanks to +Denys Khanzhyiev for some tips on getting to the right solution. + +Available: 1.9.4 available 10-May-2019 + + + + + diff --git a/docs/dist/doc/README-195.adoc b/docs/dist/doc/README-195.adoc new file mode 100644 index 000000000..2af7e42a7 --- /dev/null +++ b/docs/dist/doc/README-195.adoc @@ -0,0 +1,59 @@ +[.small]#© Copyright 2019 Contributors. All rights reserved.# + +== AspectJ 1.9.5 + +The full list of resolved issues in 1.9.5 is available +https://bugs.eclipse.org/bugs/buglist.cgi?bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&f0=OP&f1=OP&f3=CP&f4=CP&j1=OR&list_id=16866879&product=AspectJ&query_format=advanced&target_milestone=1.9.5[here] + +. + +AspectJ 1.9.5 supports Java13. Java13 introduces text blocks, but you +must activate support for that via an --enable-preview flag when using +the compiler and attempting to run the resultant classes: Here is +Code.java: + +.... +=======8<========= +public class Code { + public static void main(String[] argv) { + } + + static aspect X { + before(): execution(* Code.main(..)) { + System.out.println( +""" +This +is +on +multiple +lines +""" +); + } + } + +} +=========8<========= +.... + +Compile it with: + +.... +$ ajc --enable-preview -13 Code.java +.... + +Now run it: + +.... +$ java --enable-preview Code +This +is +on +multiple +lines +.... + +Available: 1.9.5 available 28-Nov-2019 + + + + + diff --git a/docs/dist/doc/README-196.adoc b/docs/dist/doc/README-196.adoc new file mode 100644 index 000000000..536cd4ec9 --- /dev/null +++ b/docs/dist/doc/README-196.adoc @@ -0,0 +1,57 @@ +[.small]#© Copyright 2020 Contributors. All rights reserved.# + +== AspectJ 1.9.6 + +The full list of resolved issues in 1.9.6 is available +https://bugs.eclipse.org/bugs/buglist.cgi?bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&f0=OP&f1=OP&f3=CP&f4=CP&j1=OR&list_id=16866879&product=AspectJ&query_format=advanced&target_milestone=1.9.6[here] + +. + +AspectJ 1.9.6 supports Java14. Java14 introduces records, but you must +activate support for that via an --enable-preview flag when using the +compiler and attempting to run the resultant classes: Here is Code.java: + +.... +=======8<========= +public record Person(String firstName, String lastName, int age) {} +=======8<========= + +=======8<========= +public class UsingPersonRecord { + public static void main(String[] argv) { + Person p = new Person("A","B",99); + System.out.println(p); + System.out.println(p.firstName()); + } +} +=======8<========= + +=======8<========= +public aspect TraceRecordComponents { + before(): execution(public * *()) { + System.out.println(thisJoinPointStaticPart); + } +} +=======8<========= +.... + +Compile it with: + +.... +$ ajc --enable-preview -14 Person.java UsingPersonRecord.java TraceRecordComponents.java +.... + +Now run it: + +.... +$ java --enable-preview UsingPersonRecord +execution(String Person.toString()) +Person[firstName=A, lastName=B, age=99] +execution(String Person.firstName()) +A +.... + +Available: 1.9.6 available 22-Jul-2020 + + + + + diff --git a/docs/dist/doc/README-197.adoc b/docs/dist/doc/README-197.adoc new file mode 100644 index 000000000..974891425 --- /dev/null +++ b/docs/dist/doc/README-197.adoc @@ -0,0 +1,109 @@ +[.small]#© Copyright 2021 Contributors. All rights reserved.# + +== AspectJ 1.9.7 + +AspectJ (binaries, source code, documentation) is now distributed under +the https://www.eclipse.org/org/documents/epl-2.0/EPL-2.0.txt[Eclipse +Public License v 2.0]. + +Please note that going forward Bugzilla for issue management is +deprecated and new issues should be filed as +https://github.com/eclipse/org.aspectj/issues/new[GitHub issues]. The +list of issues addressed for 1.9.7 can be found +https://bugs.eclipse.org/bugs/buglist.cgi?bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&f0=OP&f1=OP&f3=CP&f4=CP&j1=OR&list_id=16866879&product=AspectJ&query_format=advanced&target_milestone=1.9.7[here +for Bugzilla] and +https://github.com/eclipse/org.aspectj/issues?q=is%3Aissue+is%3Aclosed++milestone%3A1.9.7[here +for GitHub issues]. + +=== New features + +AspectJ 1.9.7 supports https://openjdk.java.net/projects/jdk/15/[Java +15] & https://openjdk.java.net/projects/jdk/16/[Java 16] and their +respective final and review features: + +* text blocks (final 15) +* records (preview 15, final 16) +* instanceof pattern matching (preview 15, final 16) +* hidden classes (final 15) +* sealed classes (preview 15, preview 16) + +For features marked as preview on a given JDK, you need to compile with +ajc --enable-preview and run with java --enable-preview on that JDK. + +Please note that you cannot run code compiled with preview features on +any other JDK than the one used for compilation. For example, records +compiled with preview on JDK 15 cannot be used on JDK 16 without +recompilation. This is a JVM limitation unrelated to AspectJ. Also, e.g. +sealed classes are preview-1 on JDK 15 and preview-2 on JDK 16. You +still need to recompile, no matter what. + +You can find some sample code in the AspectJ test suite under the +respective AspectJ version in which the features were first supported +(possibly as JVM preview features): + +* https://github.com/eclipse/org.aspectj/tree/master/tests/features195/textblock[AspectJ +1.9.5: text blocks] +* https://github.com/eclipse/org.aspectj/tree/master/tests/features196/java14[AspectJ +1.9.6: records, instanceof patterns] +* https://github.com/eclipse/org.aspectj/tree/master/tests/features197/java15[AspectJ +1.9.7: hidden classes, sealed classes] + +=== Using LTW on Java 16+ + +Please note that if you want to use load-time weaving on Java 16+, the +weaving agent collides with https://openjdk.java.net/jeps/396[JEP 396 +(Strongly Encapsulate JDK Internals by Default)]. Therefore, you need to +set the JVM parameter --add-opens java.base/java.lang=ALL-UNNAMED in +order to enable aspect weaving. This is due to the fact that the weaver +uses internal APIs for which we have not found an adequate replacement +yet when defining classes in different classloaders. + +=== Organisational and internal changes + +For AspectJ 1.9.7, we implemented a lot of internal changes concerning +the build and release process, most of which are not visible in the +product itself but will help us to more easily maintain and release the +product in the future and more easily on-boarding new developers or +contributors. For example: + +* The main repository has been moved to +https://github.com/eclipse/org.aspectj[GitHub], i.e. you can open bug +reports, feature requests and pull requests there now. +* The Maven build has been improved, i.e. it is now easier to build and +contribute to the product. Developers can just import the Maven project +and no longer depend on Eclipse to build and test AspectJ, but can e.g. +also use IntelliJ IDEA. +* Continuous integration builds now run on GitHub for different JDK +versions, also for pull requests. I.e. both maintainers and contributors +get to know if their changes break any tests. +* We can build releases and deploy them directly to Sonatype OSSRH +(snapshots) or Maven Central (releases) with Maven now, i.e. it should +be much easier in the future to publish development versions in order to +enable users to re-test fixed bugs or try new features. +* All tests are portable now, i.e. they correctly run on Windows, too. +This enables developers and contributors to make a choice if they want +to work on Linux or on Windows. + +=== Other changes and bug fixes + +* Remove legacy JRockit support. +* Support Windows 10 and Windows Server 2016/2019 in installer. Those +versions were not detected until now, which led to bogus Windows batch +files forwarding only 9 AJC parameters to the Java process via %1 %2 %3 +%4 %5 %6 %7 %8 %9 instead of %*. +* AJdoc (AspectJ's javadoc generator add-on for aspects) now supports +the JDK 16 javadoc generator. +* Fix serialVersionUID initialization for Java 9+ +* AJC (AspectJ Compiler) usage texts sometimes used to be printed twice +and they were printed too often, e.g. on top of every compile error. +This has been fixed. Furthermore, the partly outdated usage text is now +basically the same as ECJ (Eclipse Java Compiler), which AJC is a fork +of, plus AspectJ-specific additions which are added during runtime. +* Source and javadoc JARs distributed together with the AspectJ +artifacts on Maven Central are now more accurate and more complete with +regard to what is included (ASM, JDT Core) and how package names have +been relocated. +* Fix sample code formatting issues (indentation) throughout the +documentation. + +Available: 1.9.7 available 24-Jun-2021 diff --git a/docs/dist/doc/changes.adoc b/docs/dist/doc/changes.adoc new file mode 100644 index 000000000..12192b51c --- /dev/null +++ b/docs/dist/doc/changes.adoc @@ -0,0 +1,1538 @@ +[.small]#© Copyright 1998-2002 Palo Alto Research Center Incorporated +2003-2008 Contributors. All rights reserved.# + +== Changes in AspectJ + +* xref:#1.6.0[1.6.0] (released 2008-04) +* xref:#1.5.4[1.5.4] (released 2007-12) +* xref:#1.5.3[1.5.3] (released 2006-11) +* xref:#1.5.2[1.5.2] (released 2006-06) +* xref:#1.5.1[1.5.1] (released 2006-04) +* xref:#1.5.0[1.5.0] (released 2005-12) +* xref:#1.2.1[1.2.1] (released 2004-10) +* xref:#1.2[1.2] (released 2004-05) +* xref:#1.1.1[1.1.1] (released 2003-09) +* 1.1.0 (released 2003-06-06) See README-11.html +* xref:#1.0.6[1.0.6] (released 2002-07-24) +** xref:#1.0.6compiler[Compiler] +** xref:#1.0.6ajde[AJDE] +** xref:#1.0.6ajdoc[Ajdoc] +* xref:#1.0.5[1.0.5] (released 2002-06-27) +* xref:#1.0.4[1.0.4] (released 2002-04-17) +* xref:#1.0.3[1.0.3] (released 2002-02-08) +* xref:#1.0.2[1.0.2] (released 2002-02-06) +* xref:#1.0.1[1.0.1] (released 2001-12-18) +* xref:#1.0.0[1.0.0] (released 2001-11-30) +* xref:#1.0rc3[1.0rc3] (released 2001-11-14) +* xref:#1.0rc2[1.0rc2] (released 2001-10-12) +* xref:#1.0rc1[1.0rc1] (released 2001-10-5) +* xref:#1.0beta1[1.0beta1] (released 2001-08-29) +* xref:#1.0alpha1[1.0alpha1] (released 2001-08-09) +* xref:porting.adoc[Porting and Transition] + +''''' + +== [#1.6.0]#1.6.0# + +This release rebases AspectJ on the Eclipse Compiler version 785_R33X - +making it Java6 compliant. + +A full list of bugs fixed and enhancements implemented can be found in +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=AspectJ&target_milestone=1.6.0+M1&target_milestone=1.6.0+M2&target_milestone=1.6.0+RC1&target_milestone=1.6.0&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&emailtype1=substring&email1=&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=[Bugzilla]. + +== [#1.5.4]#1.5.4# + +This release contains around 40 bug fixes and enhancements since the +1.5.3 release. + +A full list of bugs fixed and enhancements implemented can be found in +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&product=AspectJ&target_milestone=1.5.4&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED[] +Bugzilla + +== [#1.5.3]#1.5.3# + +This release contains around 80 bug fixes and enhancements since the +1.5.2 release. + +A full list of bugs fixed and enhancements implemented can be found in +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&product=AspectJ&target_milestone=1.5.3&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED[] +Bugzilla + +== [#1.5.2]#1.5.2# + +This release contains around 60 bug fixes and enhancements since the +1.5.1 release. + +A full list of bugs fixed and enhancements implemented can be found in +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&product=AspectJ&target_milestone=1.5.2&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED[] +Bugzilla + +== [#1.5.1]#1.5.1# + +This release contains over 70 bug fixes and enhancements since the 1.5.0 +release. + +A full list of bugs fixed in AspectJ 5 can be found in +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&product=AspectJ&target_milestone=1.5.1&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED[] +Bugzilla + +== [#1.5.0]#1.5.0# + +This release contains nearly 400 bug fixes and enhancements since the +1.2.1 release. Major updates to the language are documented in the +link:adk15notebook/index.html[AspectJ 5 Developer's Notebook]. There are +also a number of enhancements to accompanying tools documented in the +link:devguide/index.html[Developer's Guide] + +A full list of bugs fixed in AspectJ 5 can be found in +https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&product=AspectJ&resolution=FIXED&chfieldfrom=2004-11-06&chfieldto=2005-12-20[bugzilla]. + +== [#1.2.1]#1.2.1# + +All known P1 and P2 bugs have been fixed in this release. The +https://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&target_milestone=1.2.1&bug_status=RESOLVED&resolution=FIXED[full +list of fixes and enhancements] can be found on bugzilla. Some of the +more significant bug fixes and enhancements include: + +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=53981[53981] Any +occurence of proceed(..) within the body of around advice is treated as +the special proceed form (even if the aspect defines a method named +proceed) unless a target other than the aspect instance is specified as +the recipient of the call. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=48990[48990] +Optimisations added for the special cases of if(true) and if(false) in +pointcut expressions. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=69319[69319] The Eclipse +JDT compiler inside AspectJ has been upgraded to the Eclipse 3.0 release +version. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=61572[61572] AspectJ +1.2.1 correctly detects an attempt to access instance variables of the +declaring aspect of an inter-type declared method from within the body +of that method. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=65319[65319] Error +message now correctly produced when attempting to bind a pointcut formal +in both a this() and a target() pointcut sub-expression. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=70619[70619] Conflicting +declare precedence statements are now handled gracefully. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=42573[42573] Relative +paths specified in .lst files are now resolved relative to the lst file +location. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=57666[57666] Resource +copying from jar files correctly handles duplicate manifests. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=61768[61768] Static +inner types of an aspect can now be referenced within the body of +inter-type declared methods in that aspect. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=62642[62642] +after-throwing advice on a static initialization join point no longer +swallows ExceptionInInitializer errors. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=67578[67578] AspectJ +1.2.1 correctly handles privileged access to members defined in a +different package to the privileged aspect. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=67592[67592] The +Object[] given in response to a getArgs() call on a JoinPoint object is +now a value copy. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=68991[68991] +Initialisers of inter-type declared fields now have field-set join +points. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=69459[69459] A static +inter-type method declaration is not allowed to hide an instance method. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=70794[70794] An +inter-type declaration of an abstract method on a target type which is +an interface must be declared as public. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=71372[71372] Calls can +be made to private static methods of enclosing types from the body of +around advice in an inner aspect. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=71377[71377] Join points +are now correctly detected for calls to private methods and set/get of +private fields within the body of around advice. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=71723[71723] A +non-privileged inter-type declared method cannot call protected methods +defined in parent classes of the target type. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=74238[74238] Any +privileged calls made by the AspectJ runtime library are now correctly +wrapped in doPrivileged blocks, with fall-back implementations, allowing +usage in restricted environments. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=74245[74245] Specifying +the -proceedOnError flag will now cause the compiler to attempt weaving +even in the face of errors. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=76030[76030] Runtime +optimisations for cflow (in the case where there are no arguments bound +in the cflow pointcut) have been implemented. This can dramatically +speed-up some programs making heavy use of cflow. Thanks to the abc +compiler team for detecting this performance related bug and for +piloting the fix. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=54421[54421] String +concatentation (using "+") is now allowed for the message associated +with a declare error or warning statement. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=69011[69011] ajdoc now +correctly handles types in the default package. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=36747[36747] The 1.2.1 +compiler supports an additional option, -showWeaveInfo, which will +produce informational messages concerning the activity of the weaver. +For example: ++ +.... + Type 'tjp.Demo' (Demo.java:30) advised by around advice from 'tjp.GetInfo' + (GetInfo.java:26) [RuntimeTest=true] + +.... +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=44191[44191] AspectJ +1.2.1 improves the error messages issued in many of the infamous "can't +find type" scenarios. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=46298[46298] The code +generated by ajc is now more easily digested by many decompilers (but +you wouldn't want to do that anyway would you?? ;) ). +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=49743[49743] Performance +optimisations in the AspectJ runtime library when using getSignature() +and toString(). +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=61374[61374] AspectJ now +includes its own version of BCEL under the org.aspectj namespace which +eliminates unwanted conflicts with BCEL versions inside JDKs or on +classpaths in general. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=68494[68494] ajdoc now +supports ".aj" files. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=72154[72154] The AspectJ +1.2.1 compiler includes the ability to dump information about the +current state of the compiler on failure. By default this only happens +on an abort, but it can also be forced to dump on error by specifying +the property: org.aspectj.weaver.Dump.condition=error +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=37020[37020] The line +number locations for method execution and static initialization join +points now give the first line of the method declaration (rather than +the line number of the first line of code in the method body) when the +source code is compiled by ajc. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=73369[73369] A new jar, +aspectjweaver.jar is included in the lib directory, which contains the +subset of aspectjtools.jar needed for weaving. The "aj" script is also +moved into the bin directory. + +== [#1.2]#1.2# + +All known P1 and P2 bugs have been fixed in this release. The +https://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&target_milestone=1.2[full +list of fixes and enhancements] can be found on bugzilla. Some of the +more significant bug fixes and enhancements include: + +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=46347[46347] The ajc +compiler now can read .class files from directories as well as zip files +for bytecode weaving, via the new -inpath option. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=48080[48080] Error and +warning messages emitted as a result of a declare error or declare +warning statement now include context information that indicates the +matched join point. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=54819[54819] Error and +warning messages coming from the weaving phase of compilation now show +source context wherever it is available, and also indicate as the source +location of the error either the class file or jar file from which the +binary source unit came. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=36430[36430] A new +-Xreweavable option has been added which allows class files to be woven +more than once. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=49250[49250] +SoftException now supports getCause(). +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=51320[51320] AspectJ 1.2 +now gives a compilation error if one of the non-statically determinable +pointcut forms is used in a declare statement. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=53012[53012] Declaring +precedence on a class type (rather than an aspect type) is now an error +unless subtypes are included. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=36069[36069] The source +information for inlined advice is now correct (using JSR 45). +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=34206[34206] (See also +https://bugs.eclipse.org/bugs/show_bug.cgi?id=44587[44587]). Errors +occuring during static initialisation of an aspect are now handled much +more gracefully. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=41952[41952] A new Xlint +warning warns users specifying declaring type patterns in call pointcut +designators if the pointcut does not match at places they may expect it +to. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=42574[42574] -extdirs +opion now recognises .zip files as well as .jar. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=48091[48091] New option +-XlazyTjp defers creation of JoinPoint objects until just before calling +the advice body that requires them. This allows the cost of creating +JoinPoint objects to be avoided using an if() pointcut test that returns +false when the advice body is not required to be executed. Speed-ups of +10-100X are obtained via this optimisation (as compared to putting the +test inside the advice body). +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=45441[45441] +IncompatibleClassChangeError at runtime when compiling with the -1.4 +option. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=54625[54625] Incremental +compilation did not support the -outjar option, but silently failed if +it was specified. AspectJ 1.2 always performs a full build when the +-outjar option is present. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=54965[54965] Incremental +compilation under AspectJ 1.2 is approximately twice as fast as under +AspectJ 1.1.1. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=55134[55134] Incremental +compilation now deletes any additional class files generated during the +weave phase when the class file from whence they came is deleted. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=54621[54621] Incremental +compilation will now detect changes (add, delete, modify) to class files +in directories on the inpath and will include them in incremental +compilation. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=54621[54621] Incremental +compilation will now detect changes to jars on the inpath (and injars), +and trigger a full build if a jar is modified. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=54622[54622] Incremental +compilation will now detect changes to resources on the inpath. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=54618[54618] Incremental +compilation will now detect changes to any of the paths affecting +compilation, and triggers a full build if there has been any change +since the last build. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=50200[50200] The +aspectjrt.jar manifest file now has the correct (upper) case. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=49457[49457] No error +given when overloading pointcuts, unless variables are bound. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=50776[50776] Compilation +failure when overriding an inter-type declared method with a different +throws clause. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=51919[51919] Polymorphic +inter-type declaration fails. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=52464[52464] Declare +warning coupled with inter-type declaration causes compiler crash. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=41125[41125] Variable +names in the local variable table (for debugging) are now correctly +preserved in all cases. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=43792[43792] Improved +support for non-US locales (and significantly boosted weaver performance +at the same time). +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=35636[35636] AspectJ 1.2 +behaves much more gracefully when running out of memory. (It also +requires less memory than 1.1.1 did in any case). +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=42711[42711] Super-types +of parameters not recognised when calling priveleged methods. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=43972[43972] (See also +https://bugs.eclipse.org/bugs/show_bug.cgi?id=45676[45676]). Incorrectly +adding synthetic attribute to generated methods. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=45184[45184] External +pointcut references not resolved when a named pointcut is used by a +declare statement. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=46750[46750] Declare +soft does not work inside a nested aspect. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=47754[47754] No error +signalled when attempting to declare a static method on an interface +using an inter-type declaration. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=48522[48522] Declare +soft softens all exceptions at matched join points, not just the +exception declared to be soft. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=49295[49295] AspectJ 1.2 +no longer supports inter-type constructor declarations on interfaces. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=51929[51929] Call to a +protected super-type method within a advice body causes +java.lang.VerifyError. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=52928[52928] Private +members introduced via an interface are incorrectly visible within +implementing classes. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=47910[47910] An output +jar file created by AspectJ when using the -outjar option does not +contain a valid manifest file. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=59909[59909] Thread +local storage used to manage cflow stacks when available - improves +cflow performance when working with a multi-threaded application. + +== [#1.1.1]#1.1.1# + +All known P1 and P2 bugs have been fixed in this release. The +https://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&target_milestone=1.1.1[full +list of bug fixes] (49 in all) can be found on bugzilla. + +Some of the more significant bug fixes and enhancements in this release +include: + +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=40943[40943] The ajc +compiler now copies resource files from jars specified using the -injars +option. When compiling with source directories, resources are _not_ +copied - mirroring the behaviour of javac so as to cause minimum +disruption when switching between ajc and javac. (To copy resources from +source directories, use the iajc Ant task sourceRootCopyFilter option.) +Thanks to Matthew Webster for contributing many of the patches for this +enhancement. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=39626[39626] ajc was +erroneously putting aspectjtools.jar in the classpath of a compilation. +This caused problems when attempting to compile projects using different +versions of any of the classes in aspectjtools.jar. Thanks to George +Harley and Igor Hjelmstrom Vinhas Ribeiro for their assistance in +tracking this down. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=40257[40257] Relative +paths are now supported in ".lst" files. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=40771[40771] The Ajde +apis are no longer coupled to swing. This is of most significance to +AJDT users on the Mac OS X platform, enabling AJDT to be used with Mac +OS X. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=41254[41254] Of interest +to those writing tools that need to interact with the structure model +for AspectJ programs: the interface to the AspectJ structure model was +significantly revised and enhanced in 1.1.1. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=39462[39462] A compiler +exception was thrown when an abstract aspect in a library was extended +by a concrete aspect using cflow. Thanks to Takao Naguchi for an easy to +reproduce bug report. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=39479[39479] Compiler +crashes when a constructor delegates to another constructor that uses a +switch statement. Thanks to Andy Clement for both the easy to reproduce +bug report and the patch. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=41175[41175] Declared +exceptions were being lost on inter-type declarations made from binary +aspects in an aspect library. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=41359[41359] Aspect +per-clauses were not inherited by sub-aspects when using binary aspect +libraries. Thanks to Chris Bozic for the easy to reproduce bug report. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=42539[42539] The "+" +pattern was being ignored for type patterns used in throws clauses. +Thanks to Keith Sader for the easy to reproduce bug report. +* https://bugs.eclipse.org/bugs/show_bug.cgi?id=40807[40807] If you +specify no output directory, the iajc Ant task now defaults to using the +source directory, following ajc and javac. As a result, now you can use +ajc to compile JSP's in Tomcat. Thanks to Ron Bodkin for investigating +how to integrate ajc with Tomcat. + +== [#1.0.6]#1.0.6# + +This release contains mainly bug fixes for ajde and ajdoc. + +=== [#1.0.6compiler]#Compiler# + +We fixed a bug with switch statements, thanks largely to Jason Rimmer's +diligence in helping us isolate the problem. Also, to help Log4J parse +stack traces, we changed class file symbolic line references to use [] +instead of () for the virtual start lines of each file. + +=== [#1.0.6ajde]#AJDE# + +*AJDE Framework, AJBrowser, and AJDE for Forte/NetBeans* + +The memory use of the structure model has been streamlined in order to +reduce footprint when working with large systems. Error tolerance has +also been improved for dealing with a structure model that is out of +synch with resources on disk. + +==== AJDE for JBuilder + +JBuilder 7 is now supported. All known bugs have been fixed including: + +* http://aspectj.org/bugs/resolved?id=787[787] AJDE for JBuilder throws +exception given non-existent file +* http://aspectj.org/bugs/resolved?id=788[788] Label too small in error +message +* http://aspectj.org/bugs/resolved?id=789[789] Index-out-of-bounds +exception in JBuilder AJDE +* http://aspectj.org/bugs/resolved?id=792[792] Required libraries +disappear from JBuilder 6 +* http://aspectj.org/bugs/resolved?id=795[795] Unable to compile open +tools +* http://aspectj.org/bugs/resolved?id=802[802] AJDE loses current +(cursor) position in file when switching files + +In addition, thanks to user feedback that indicated trouble building +JBuilder OpenTools with AJDE/JBuilder, the OpenTool is now being built +with itself. + +=== [#1.0.6ajdoc]#Ajdoc# + +* Fixed http://aspectj.org/bugs/resolved?id=790[790] aspect code +comments suppressed by fix to bug 710 +* Known problems: http://aspectj.org/bugs/ajdoc + +''''' + +== [#1.0.5]#1.0.5# + +This release includes significant improvements to AspectJ Development +Environment (AJDE) support. The entire user interface has been revised +and streamlined. The AJDE features are more tightly integrated into +JBuilder and NetBeans/Forte support. JBuilder support now includes +graphical configuration file editing and an integrated AspectJ Browser +tool. + +* xref:#1.0.5compiler[Compiler] +* xref:#1.0.5ajde[AJDE] +* xref:#1.0.5ajdoc[Ajdoc] +* xref:#1.0.5anttasks[Ant tasks] + +=== [#1.0.5compiler]#Compiler# + +This was another compiler release primarily concerned with fixing corner +cases in the language implementation. Our handling of nested classes, +the assert statement, and cflow were the principal offenders this time. +Thanks to Nicholas Alex Leidenfrost and Patrick Chan for their clear and +concise bug reports on some of these issues. + +=== [#1.0.5ajde]#AJDE# + +==== This release includes significant improvements to AspectJ Development Environment (AJDE) support. All known bugs have been fixed, and the core framework quality has been significantly increased thanks to the adoption of a unit test suite. The following changes apply to all of the AJDE NetBeans/Forte, JBuilder, and the AspectJ Browser support. NetBeans/Forte and JBuilder-specific changes are listed below. + +* The entire user interface has been revised and streamlined. +* The structure view and browser have a new UI, and offer both a +file-based and global structure views. All views expose node ordering, +node filtering, and association filtering functionality. The global +views expose a package tree as well as the global inheritance and +crosscutting structure. +* Structure view navigation now has a history exposed by back/forward. +* The is a new build configuration management UI. +* The compiler preferences UI now includes access to all build options. +* Error messages have been improved, and the structure views include +annotations of nodes with errors and warnings. + +==== AJDE for JBuilder + +Integration into the JBuilder IDE is more streamlined. In addition: + +* The AspectJ Browser is included as a tool that replaces JBuilder's +"Project View" and can be used to navigate the global structure of your +system (including the crosscutting and inheritance structure). +* Inline structure annotations in the editor's gutter can now expose all +of the structure presented in the structure view, and can be used to +navigate in a similar way. Note that there are preferences for toggling +which of these appear. +* Building is better integrated and the JBuilder build toolbar is +removed when AJDE is enabled. +* Build configurations can be selected from the build button's menu. +* Execution is better integrated: instead of a separate "run" button +JBuilder's run and debug can be used. Note that for new projects you +will need to use the "AspectJ Runtime" library, which will be added to +your preferences automatically. +* A new graphical build configuration editor can be used by +double-clicking ".lst" files that have been added to the project. +* Error messages now match JBuilder's look-and-feel and behavior. +Seeking to column numbers now works in addition to line numbers. + +==== AJDE for Forte/NetBeans + +Integration into the NetBeans IDE is more streamlined. In addition: + +* NetBeans 3.3.2 and SunONE Studio 4 are supported. +* Multiple filesystems are supported. +* Default project build configurations (all project files) are now +supported. +* Build configurations can be selected in the tool bar. +* Regular NetBeans execution and debugging is supported. Note that you +have to add netbeans/lib/ext/aspectjrt.jar file to your project +configuration. +* Class files are generated beside source files (NetBeans/javac +default). There is currently no way to specify a target directory. + +==== AJBrowser + +* The browser now supports main class execution. Set the main class in +the options dialog, and make sure that both the Java executable is on +your path, and the class that you expect to execute on your classpath. +* The error messages UI has been improved. + +=== [#1.0.5ajdoc]#Ajdoc# + +Bug fixes: + +* http://aspectj.org/bugs/resolved?id=710[710 - compiler-generated +constructor shown with class comment] +* http://aspectj.org/bugs/resolved?id=712[712 - comments lost in aspect +docs for methods or constructors declared on other types.] +* http://aspectj.org/bugs/resolved?id=719[719 - poor support for @link, +@see tags] +* http://aspectj.org/bugs/resolved?id=742[742 - crash with @see tag] +* http://aspectj.org/bugs/resolved?id=751[751 - error loading doclet +resource] + +=== [#1.0.5anttasks]#Ant tasks# + +Bug fixes: + +* http://aspectj.org/bugs/resolved?id=730[730 - document all supported +ajc flags] + +''''' + +== [#1.0.4]#1.0.4# + +* xref:#1.0.4compiler[Compiler] +* xref:#1.0.4ajde[AJDE] +* xref:#1.0.4ajdoc[Ajdoc] +* xref:#1.0.4taskdefs[Ant taskdefs] +* xref:#1.0.4doc[Documentation] + +=== [#1.0.4compiler]#Compiler# + +* Over a dozen people independently reported a bug in error handling for +the wrong number number of arguments to `proceed`. This has been turned +into a nice error message. A number of other bug reports related to +around advice and proceed have also been fixed, including the ability to +change the bindings for `this` and `target` using proceed in around +advice. +* David Walend gets the _black thumb_ award for the most bug reports +submitted by a new user. His bug report on the behavior of after +returning advice led to some valuable clarifications of this part of the +language spec. +* A number of places where ajc didn't fully comply with the Java +Language Spec have been fixed in this release. Thanks to Neal Gafter for +reporting many of these. + +==== Incompatible changes + +Two potentially surprising incompatible changes have been made to ajc in +order to bring the compiler into compliance with the 1.0 language +design. These changes will be signalled by clear warning or error +messages at compile-time and will not cause any run-time surprises. We +expect most users to never notice these changes. + +* The obsolete class `org.aspectj.lang.MultipleAspectsBoundException` +has been removed from aspectjrt.jar. This class had not been used since +AspectJ-0.8 and should have been removed prior to the 1.0 release. It is +not documented as part of the 1.0 language spec. This change will cause +a compile-time type not found error in any code that refers to this +exception. +* The compiler was not correctly implementing the AspectJ-1.0 language +design for some uses of after returning advice. This compiler behavior +was fixed, and advice whose behavior might be changed by this bug fix +will be highlighted with a compiler warning. More information about some +of these changes can be found in the xref:porting.adoc#pre-1.0.4[porting +notes]. + +=== [#1.0.4ajde]#AJDE# + +This is the first release of AJDE support with significant external +contribution. A big thanks goes out to Phil Sager for porting the AJDE +for Forte/NetBeans support to NetBeans 3.3.1 and improving the +integration into NetBeans. + +==== AJDE for JBuilder + +* Updates +** This is a bug fix release only. + +==== AJDE for Forte/NetBeans + +* Updates +** NetBeans 3.3.1 is now supported in addition to NetBeans 3.2 and Forte +CE 3. +** Native NetBeans main class execution can now be used. After doing a +"Compile with AJC" browse to the main class in the "Filesystems" +Explorer, right-click the class and select "Execute". +** The debugger can now be used if the project main class is set +("Project" menu -> "Set Project Main Class..."). +** Numerous bugs have been fixed. +* Known limitations +** Breakpoint setting does not work in the debugger. +** In the "Filesystems" Explorer red Xs appear on files with AspectJ +source code. The "AspectJ" Explorer understands the structure of AspectJ +projects and should be used for navigating structure instead. + +==== AJDE for Emacs + +* This is a bug fix release only. + +=== [#1.0.4ajdoc]#Ajdoc# + +Ajdoc now runs under J2SE 1.4, but still requires the tools.jar from +J2SE 1.3 be on the classpath. + +=== [#1.0.4taskdefs]#Ant tasks# + +* Repackaged to fit into the AspectJ product directory - e.g., +`aspectj-ant.jar` moved to `lib` as expected by `examples/build.xml`. +* Fixed bugs, esp. http://aspectj.org/bugs/resolved?id=682[682]: Throw +BuildException if failonerror and ajdoc detects misconfiguration. + +=== [#1.0.4doc]#Documentation# + +Added a 1-page quick reference guide. Improved javadoc documentation for +the org.aspectj.lang package. + +''''' + +== [#1.0.3]#1.0.3# + +* xref:#1.0.3compiler[Compiler] +* xref:#1.0.3taskdefs[Ant taskdefs] + +=== [#1.0.3compiler]#Compiler# + +This release fixes a single significant bug in 1.0.2 where ajc could +generate unreachable code in `-usejavac` or `-preprocess` mode. This +would happen when around advice was placed on void methods whose body +consisted solely of a `while (true) {}` loop. We now properly handle the +flow-analysis for this case and generate code that is acceptable to +javac. Thanks to Rich Price for reporting this bug. + +=== [#1.0.3taskdefs]#Ant taskdefs# + +Added support to the Ajc taskdef for the -source 1.4 and -X options +generally. + +''''' + +== [#1.0.2]#1.0.2# + +This release is mainly about keeping up with the Joneses. To keep up +with SUN's release candidate for J2SE1.4, we now officially support the +new 1.4 assertions and running on the 1.4 VM. In honor of the public +review of JSR-45 Debugging Support for Other Languages we implement this +spec for AspectJ. We support Borland's recent release of JBuilder 6, and +since some of our users are starting to work on Mac OSX, AJDE now works +nicely on this platform. We also fixed almost all of the bugs you +reported in 1.0.1. + +* xref:#1.0.2compiler[Compiler] +* xref:#1.0.2ajde[AJDE] +* xref:#1.0.2ajdb[AJDB] + +=== [#1.0.2compiler]#Compiler# + +* Official support for `-source 1.4` option to compile new +http://java.sun.com/j2se/1.4/docs/guide/lang/assert.html[1.4 +assertions]. This makes ajc completely compatible with j2se-1.4. +* Implementation of http://jcp.org/jsr/detail/45.jsp[JSR-45 Debugging +Support for Other Languages] so that debuggers which correctly implement +this specification will be able to accurately debug any AspectJ program +at a source code level. We are not currently aware of any debuggers that +implement this so far, but expect that as j2se-1.4 becomes widely +available this will change. +* As proposed by Arno Schmidmeier and seconded by Nick Lesiecki, we now +have an experimental `-Xlint` option that will provide warnings when +type patterns used in pcds have no bindings. We are very interested in +feedback on the usefulness and suggested improvements for this feature. +* Several significant bugs in the implementation of around advice have +been fixed. These include issues with +http://aspectj.org/jitterbug/aspectj-bugs/resolved?id=632[dynamic +tests], with +http://aspectj.org/jitterbug/aspectj-bugs/resolved?id=620[complicated +local types in an around body], and with +http://aspectj.org/jitterbug/aspectj-bugs/resolved?id=636[capturing +proceed in a closure]. +* All but two +(http://aspectj.org/jitterbug/aspectj-bugs/compiler?id=626[1], +http://aspectj.org/jitterbug/aspectj-bugs/compiler?id=645[2]) verified +bugs in 1.0.1 have been fixed. The two outstanding bugs have relatively +easy work-arounds. Thanks as usual to everyone who submitted a bug +report. +* We no longer use the `SYNTHETIC` attribute to label declarations added +by the aspectj compiler. We were using this attribute in compliance with +http://java.sun.com/docs/books/vmspec/2nd-edition/html/ClassFile.doc.html#80128[the +JVM Specification]; however, we've found that many tools expect this +attribute to only be used for the narrow purpose of implementing Java's +inner classes and that using it for other synthetic members can confuse +them. This led to problems both +http://aspectj.org/jitterbug/aspectj-bugs/resolved?id=649[with javap] +and http://aspectj.org/jitterbug/aspectj-bugs/resolved?id=646[with +javac]. +* Changes required adding runtime classes, so please compile and run +using the latest `aspectjrt.jar` + +=== [#1.0.2ajde]#AJDE# + +This is a bug fix release only. + +* Thanks to Dave Yost and Matt Drance for submitting the AJDE patches +for Mac OSX (context popup menus and keyboard shortcuts did not work). +* Bugs in history navigation (back-forward buttons in the structure +view) have been fixed. +* "Declares" are now handled properly in the structure view. +* Other GUI and usability improvements have been made the AspectJ +Browser and core framework. + +==== AJDE for JBuilder + +* Support has been extended to JBuilder 6, and support for Enterprise +version features has been improved. +* Fixed bug causing inline source code annotations in the editor pane to +not be updated after a recompile. +* Keyboard shortcuts were fixed to work with Mac OSX. + +==== AJDE for Forte + +* Keyboard shortcuts were fixed to work with Mac OSX. + +==== [#1.0.2ajdb]#AJDB# + +Some minor bug fixes, but this is still early-access software. Please +try using another JPDA-compliant debugger. If it uses JDI correctly, +then it should navigate to line numbers when the classes are run under +J2SE1.4, based on the new JSR-45 debugging support described above. We +would appreciate any reports of success or failure. + +''''' + +== [#1.0.1]#1.0.1# + +* xref:#1.0.1compiler[Compiler] +* xref:#1.0.1ajde[AJDE] +* xref:#1.0.1ajdb[AJDB] + +=== [#1.0.1compiler]#Compiler# + +This release fixes a significant performance issue in the compiler, +reported by Rich Price, that could lead to extremely long compiles in +systems with many aspects and classes. Several other small bugs related +to reporting compilation errors have also been fixed, see +http://aspectj.org/jitterbug/aspectj-bugs/resolved?id=610[this bug +report] for an example. + +A new experimental flag has been added, `-XaddSafePrefix`, that will +cause the prefix `aspectj$` to be inserted in front of all methods +generated by ajc. This mode should be helpful when using aspectj with +tools that do reflection based on method names, such as EJB tools. +Thanks to Vincent Massol for pointing out the importance of this. It is +expected that this prefix will either become the default compiler +behavior in the future or a non-experimental flag will replace it. + +=== [#1.0.1ajde]#AJDE# + +Minor bug fixes, including: AJDE for JBuilder failed to preserve +application parameters from project settings when executing the +application. + +Source builds were cleaned up for JBuilder and Forte sources. + +=== [#1.0.1ajdb]#AJDB# + +Two bugs were reported and have been fixed in this release. (Note that +ajdb is still considered early-access software.) + +* bug 611: NullPointerException dumping non-primitive values +* bug 617: -X and -D options not passed to debug VM correctly + +== [#1.0.0]#1.0.0# + +* xref:#1.0.0language[Language] +* xref:#1.0.0compiler[Compiler] +* xref:#1.0.0ajde[AJDE] +* xref:#1.0.0ajdoc[AJDoc] +* xref:#1.0.0taskdefs[Ant taskdefs] + +== [#1.0.0language]#Language# + +There were no language changes for this release. + +== [#1.0.0compiler]#Compiler# + +Several minor bugs primarily in error handling were reported and have +been fixed in this release. The two most serious bugs are described +below: + +* Niall Smart and Stephan Schmidt reported related bugs (variants of +which are also produced by other compilers) that caused verify errors +when dealing with nested try-finally and synchronized statements. These +are now fixed. More details are available +http://aspectj.org/jitterbug/aspectj-bugs/resolved?id=601[here] and +http://aspectj.org/jitterbug/aspectj-bugs/resolved?id=595[here] +* Jan Hannemann submitted a +http://aspectj.org/jitterbug/aspectj-bugs/resolved?id=600[succint and +clear bug report] for a difficult intermittant bug. The bug led to the +compiler sometimes generating illegal code when introduced methods on a +class overrode introduced methods on an interface implemented by that +class. This is now fixed. + +== [#1.0.0ajde]#AJDE# + +Numerous user interface refinements were made to the browser and core +AJDE functionality. Error handling and reporting has been improved. All +of the AJDE tools now support the ".aj" file extension. + +=== AJDE for JBuilder + +* The AspectJ Browser now uses JBuilder's icons and distinguishes nodes +by visibility. +* Project-setting VM parameters are now supported by the "AJDE Run" +button. + +=== AJDE for Forte + +* The AspectJ Browser now uses Forte's icons and distinguishes nodes by +visibility + +=== AJBrowser + +* Documentation for the browser is now available at +http://aspectj.org/docs + +=== Emacs Support: aspectj-mode and AJDEE + +* Improved updating of annotations during editing. +* Pop-up jump menu now placed (with mouse pointer) near cursor. +* [AJDEE only] Improved filtering of legal code completions. + +=== [#1.0.0ajdoc]#AJDoc# + +* Runs only in J2SE 1.3 - not 1.2 or 1.4. You can document 1.x-reliant +programs by using the options to compile using 1.x libraries. +* Disabled some non-functioning options, documented as `unsupported` in +the syntax message. + +=== [#1.0.0taskdefs]#Ant taskdefs# + +* Fork is not supported in the AJDoc taskdef + +== [#1.0rc3]#1.0rc3# + +== [#1.0rc3language]#Language# + +There have been several minor clarifications/changes to the language. + +* Thanks to Robin Green for suggesting that we could relax the rules for +inheriting multiple concrete members in order to allow those unambiguous +cases where one member has already overridden the other. +http://aspectj.org/pipermail/users/2001/001289.html[More details...] +* Ron Bodkin encouraged us to examine the details of privileged aspects +more closely. This led to several small improvements and clarifications +to this language feature. +http://aspectj.org/pipermail/users/2001/001258.html[More details...] + +== [#1.0rc3compiler]#Compiler# + +This release saw several changes to the compiler in order to work-around +known bugs in different JVMs, or to otherwise mimic the behavior of +javac rather than necessarily following the Java Language Specification. + +* Hanson Char reported a bug where ajc's correctly generated bytecodes +for some references to interface fields result in verify errors on +certain JVMs. While this is a known bug in those JVMs, we've modified +ajc to be bug compatible with all the other Java compilers out there to +work-around this JVM bug. +http://aspectj.org/jitterbug/aspectj-bugs/resolved?id=551[More +details...] +* Frank Hunleth discovered a similar bug where ajc's correct bytecodes +could lead to essentially random method dispath due to a bad bug in the +1.3.0 JVM from Sun. Even though this bug was fixed in the 1.3.1 and +1.2.2 JVMs, we have introduced the appropriate work-around in ajc's code +generation. +http://aspectj.org/jitterbug/aspectj-bugs/resolved?id=580[More +details...] +* Thomas Haug (as well as several other members of his group) reported a +problem with name binding where ajc was behaving differently than javac. +This problem was resolved to come from a class created by an obfuscator +that conflicted with his package names. The JLS doesn't clearly specify +which of these two behaviors is correct. Nevertheless, ajc has been +changed to treat packages more like javac does in order to minimize this +sort of problem in the future. +http://aspectj.org/jitterbug/aspectj-bugs/resolved?id=574[More +details...] +* Several "real" bugs in ajc were also reported and fixed. Toby Allsopp +gets credit for reporting two of them. The most interesting of these +bugs to me was his report that we just didn't support qualified +anonymous inner constructors. This is a part of the Java language that +ajc has never supported over its almost 3 year history. We'd just +noticed this ourselves when running the jacks compiler test suite from +the jikes group, and had added the feature days before getting our first +bug report for it not being there. + +== [#1.0rc3ajde]#AJDE# + +* The structure view has been improved. +* Multiple user-configurable views are supported. +* Structure tree filtering and ordering has been added. +* A split tree mode has been added to permit the navigation of multiple +views on the same structure. +* The view can also be toggled between a file-based and a system-based +mode which determines whether the root of the structure tree is the +current file or the project root. +* The signatures of tree nodes have been improved and several new node +associations are now navigable. +* A depth slider for controlling tree-expansion has been added. + +=== AJDE for JBuilder + +* Changes: +* Inline annotations support have been improved and made consistent with +the structure tree (annotations only show up for intra-declaration +structure). +* The current structure view persists across IDE launches. +* An enabled AJDE no longer slows down JBuilder shutdown. + +=== AJDE for Forte + +* Execution remembers main class. +* The bug causing an error during a "Mode" and "Explorer" switch has +been fixed. + +=== AJBrowser + +* AJBrowser is currently an undocumented demonstration application. To +use it type: ajbrowser ... +* Multiple source locations can be shown by selecting multiple nodes and +right-clicking to select the "Display Sources" command. + +=== Emacs Support: aspectj-mode and AJDEE + +* Numerous jump-menu improvements, including operation of pop-ups. +* For AJDEE, compatibility with JDEE 2.2.9beta4. Also, fixes in +completion, ajdoc launch, and speedbar. + +=== [#1.0rc3ajdoc]#AJDoc# + +Some of the more obvious NullPointerException bugs in Ajdoc were fixed, +but Ajdoc does not implement all the functionality of Javadoc and has +some bugs: + +* Split indexes do not work correctly +* Inner classes are not listed in indexes +* Synthetic methods are documented +* There is no package frame even when packages are specified on the +command line +* -group option is not implemented +* -use targets are not all calculated correctly +* Exception information may not be printed for the @throws tag +* Verbose output should go to stderr, not stdout +* Extra links are generated (should be unlinked text) + +Further, Ajdoc has not been testing on variants of the J2SE (it uses +javadoc classes). + +=== [#1.0rc3taskdefs]#Ant taskdefs# + +The Ajc taskdef was updated to support the new compiler options and the +.aj extension, and some NullPointerException bugs were fixed (thanks to +Vincent Massol for a bug report listing the line number of the fix). The +AJDoc cannot be run repeatedly in a single Ant run, and has trouble +loading the doclet unless the libraries are installed in +$\{ant.home}/lib. + +''''' + +== [#1.0rc2]#1.0rc2# + +* xref:#1.0rc2language[Language] +* xref:#1.0rc2compiler[Compiler] +* xref:#1.0rc2ajde[AJDE] + +== [#1.0rc2language]#Language# + +There are no language changes in this release. This is a bug fix release +only. + +== [#1.0rc2compiler]#Compiler# + +A bug in handling inner type names that conflict with enclosing type +names was fixed. Many error messages were improved. + +== [#1.0rc2ajde]#AJDE# + +* This is a bug fix release only. + +=== AJDE for JBuilder + +* Changes: +** Fixed bug causing the output path to be ignored and .class files to +be generated into the JBuilder install's "bin" directory. +** Fixed bugs in Browser listener causing NullPointerExceptions to be +thrown if no node editor was present. +** Fixed bug permitting "-bcg" option to be passed to the compiler. +** Fixed bug preventing ajc from compiling all of the project source +files when automatic package discovery was on (JBuilder Proffessional +and Enterprise editions). +** If the "-preprocess" flag is used resulting source files will be +placed in the project's "Working directory". +* Limitations: +** "Automatic package discovery" mode is not supported in this release. +** The debugger has not seen much use and it's stability and performance +is limited. + +=== AJDE for Forte + +* Changes: +** Moved the "AspectJ" menu into the "Tools" menu in order to make it +less intrusive. +** Added a "ctrl-alt-shift-F9" keyboard compile shortcut. +* Limitations: +** Known bug: "Mode" switching is not supported in this version--you +must do all of your AspectJ work in the "Editing" mode. If you switch +modes the IDE has to be restarted for the AspectJ window to show again. +Switching to a different tab in the ProjectExplorer has the same effect. +** The debugger has not seen much use and it's stability and performance +is limited. + +=== AJBrowser + +* Changes: +** ... +* Limitations: +** AJBrowser is currently an undocumented demonstration application. To +use it type: + +> ajbrowser ... + +=== Emacs Support: aspectj-mode and AJDEE + +This release now properly displays annotations for call sites and +introductions. Robustness has been improved in several dimensions, +including performance at startup. The compile menu now recomputes +properly when changing directories. + +''''' + +== [#1.0rc1]#1.0rc1# + +* xref:#1.0rc1language[Language] +* xref:#1.0rc1compiler[Compiler] +* xref:#1.0rc1ajde[AJDE] + +== [#1.0rc1language]#Language# + +Some of the details of the specification for perthis and pertarget have +changed. These changes make these language constructs implementable on +current JVMs without memory leaks (this wasn't true of the previous +version). Most people will probably not notice these changes, but the +correct semantics are described in link:progguide/semantics.html[the +semantics section of the programming guide]. + +In a related change, aspects are not allowed to implement either the +`java.io.Serializable` or the `java.lang.Cloneable` interface. It is +unclear what the correct behavior of a system should be when an aspect +is serialized or cloned, and rather than make an arbitrary choice right +now we've chosen to leave the most room to design them right in a future +release. + +== [#1.0rc1compiler]#Compiler# + +ajc now directly generates .class files without using javac as a +back-end. This should result in improved compiler performance, better +error messages and better stack-traces and debugging info in those +.class files. -preprocess mode is still available for those who want to +generate legal Java source code and a new -usejavac mode is available if +you have a requirement to continue to use javac as a back-end. + +ajc now officially supports source files with the .aj extension. We plan +to extend this support to the rest of our tools as time permits. + +This release of ajc includes support for the "-source 1.4" option that +enables the new 'assert' keyword in jdk1.4. This option only works +correctly when compiling against the jdk1.4 libraries. In addition, this +release of ajc will run under SUN's jdk1.4beta2. However, we still +strongly recommend that most users use the non-beta jdk1.3. + +== [#1.0rc1ajde]#AJDE# + +* The structure view can now be configured (using the "Options" dialog) +to display different kinds of associations between program elements that +appear in the tree. +* Structure view history navigation has been added. +* When navigating links the structure view will stay synchronized with +the editor. + +=== AJDE for JBuilder + +* Changes: +** Inline structural navigation annotations appear in the gutter of the +editor and can be used to navigate associations such as advice and +introduction. +* Limitations: +** "Automatic package discovery" mode is not supported in this release. +** The debugger has not seen much use and it's stability and performance +is limited. + +=== AJDE for Forte + +* Changes: +** Support for Forte 3 and Netbeans 3.2 has been added. +** The module is now installed by default on the first use without +having to go to the IDE options to enable it. +* Limitations: +** Known bug: "Mode" switching is not supported in this version--you +must do all of your AspectJ work in the "Editing" mode. If you switch +modes the IDE has to be restarted for the AspectJ window to show again. +Switching to a different tab in the ProjectExplorer has the same effect. +** The debugger has not seen much use and it's stability and performance +is limited. + +=== AJBrowser + +* Changes: +** Build configuration file editor added. +* Limitations: +** AJBrowser is currently an undocumented demonstration application. To +use it type: + +> ajbrowser ... + +=== Aspectj-mode and AJDEE: AspectJ support in Emacs + +This release of AspectJ support for Emacs includes corrections to the +documentation and the appearance of annotations and jumps in the editing +view. Also, advice are now shown on non-declarations, when appropriate, +such as call advice. The internal event model has been revised to reduce +computational overhead. + +''''' + +== [#1.0beta1]#1.0beta1# + +* xref:#1.0beta1language[Language] +* xref:#1.0beta1compiler[Compiler] +* xref:#1.0beta1ajbrowser[AJBrowser] +* xref:#1.0beta1ajde[AJDE] + +== [#1.0beta1language]#Language# + +There is one language change since 1.0alpha1. The static modifier is no +longer needed or allowed on pointcut declarations. Name binding for +pointcut declarations works like class methods now. Thanks to Robin +Green for encouraging us to look at this one last time. + +The current implementation of perthis/pertarget has the possibility of +memory leaks (thanks to Arno Schmidmeier for pointing this out). The +design of this part of the language will almost certainly see some +changes in the next release to address issues of implementability on the +JVM as well as related issues. + +== [#1.0beta1compiler]#Compiler# + +The ajc compiler should now catch all errors in source code and you +should no longer see errors coming from files in 'ajworkingdir'. Please +report any errors in 'ajworkingdir' as bugs. + +All reported bugs in 1.0alpha1 have been fixed. Thanks to everyone for +your bug reports. Most notably, the 'if' pcd that was added in 1.0alpha1 +should work correctly in this release. Thanks to Morgan Deters for a +very thorough bug report on this broken feature days after the 1.0alpha1 +release. + +== [#1.0beta1ajbrowser]#AJBrowser# + +* Support for executing classes has been added. +* .lst can now be passed as arguments on the command line. +* Compiler options can be set. +* Know limitations: +** In order to execute classes they must be available on the classpath +that the browser is launched with. + +== [#1.0beta1ajde]#AJDE# + +* The performance and UI of the structure tree has been improved. +* Compilation now runs in a separate thread and a progress monitor is +updated during the compile. +* The structure view now persists across IDE launches. +* Limitations: +** If an error occurs in the javac pass it will not display properly in +the error messages pane. To view the error you have check the output of +the console that the IDE was launched from. No more errors should be +passed to javac, so please report this behavior and the corresponding +error message as a bug. + +=== AJDE for JBuilder + +* Known bugs have been fixed. +* Classpath separator character is no longer hardcoded. +* Keyboard shortcuts for compilation (ctrl-F11) and execution (ctrl-F12) +have been added. +* Limitations: +** The debugger has not seen much use and it's stability and performance +is limited. + +=== AJDE for Forte + +* Known bugs have been fixed. +* Limitations: +** "Mode" switching is not supported in this version--you must do all of +your AspectJ work in the "Editing" mode. If you switch modes the IDE has +to be restarted for the AspectJ window to show again. +** There are no keyboard compile/execute shortcuts. +** The debugger has not seen much use and it's stability and performance +is limited. + +=== Aspectj-mode and AJDEE: AspectJ support in Emacs + +AspectJ Development Environment for Emacs has been split into two +pieces, aspectj-mode (an extension of java-mode), and AJDEE (an +extension of JDE). Additionally, a switch, -emacssym, has been added to +ajc that generates AspectJ declarations information directly, thus +beanshell is no longer required for use of these modes. + +''''' + +== [#1.0alpha1]#1.0alpha1# + +This is the first alpha release of the 1.0 language and tools. There +have been many changes in the language, and many improvements to the +tools. We wish to thank our users for putting up with the high +volatility of AspectJ in the push to 1.0. + +* xref:#1.0alpha1language[Language] +* xref:#1.0alpha1compiler[Compiler] +* xref:#1.0alpha1documentation[Documentation] +* xref:#1.0alpha1ajdoc[AJDoc] +* xref:#1.0alpha1ant[Ant] +* xref:#1.0alpha1ajbrowser[AJBrowser] +* xref:#1.0alpha1ajde[AJDE] + +=== [#1.0alpha1language]#Language# + +There have been many changes to make the 1.0 language both simpler and +more powerful. User feedback has driven most of these design changes. +Each email we've received either making a suggestion or just asking a +question about a confusing part of the language has played a part in +shaping this design. We'd like to thank all of our users for their +contributions. + +While we don't have room to thank all of our users by name, we'd like to +specifically mention a few people for their high-quality sustained +contributions to the users@aspectj.org mailing list as well as through +their feature requests and bug reports. Robin Green (who'll be very +happy to see `declare error`), Stefan Hanenberg (who should appreciate +the '+' wildcard in type patterns), and Rich Price (who suggested final +pointcuts, more flexible dominates, and many other improvements). + +Note that entries into the xref:porting.adoc[porting notes] for this +release are linked from the various language changes. + +==== Pointcuts + +Perhaps the least interesting -- but most pervasive -- change is that +the names of the single-kinded pointcut designators (the ones that pick +out only one kind of join point) + +____ +calls executions gets sets handlers initializations +staticinitializations +____ + +have been xref:porting.adoc#1.0a1-plural-to-singular[changed] to be +singular rather than plural nouns + +____ +call execution get set handler initialization staticinitialization +____ + +Although a side benefit is that the names are one character shorter, the +real benefit is that their combination with the `&&` and `||` operators +now reads much more naturally. No longer does "and" mean "or" and "or" +mean "and". + +You'll notice that `receptions` doesn't appear on the table as being +shortened to `reception`. That's because call and reception join points +have been merged, and the `receptions` pointcut declaration has been +xref:porting.adoc#1.0a1-remove-receptions[eliminated]. Now, `call` join +points describe the action of making a call, including both the caller +and callee. Eliminating reception join points makes AspectJ much simpler +to understand (reception join points were a commonly misunderstood +feature) without giving up expressive power. + +We have xref:porting.adoc#1.0a1-fixing-state-access[changed the +mechanism for accessing state] at join points, which has the benefit of +making our treatment of signatures +xref:porting.adoc#1.0a1-no-subs-in-sigs[cleaner] and easier to read. As +a part of this, the `instanceof` pointcut designator has now been +xref:porting.adoc#1.0a1-fixing-instanceof[split into two different +pointcut designators], `this` and `target`, corresponding to a join +point's currently executing object and target object, respectively. + +The new `args` pointcut adds expressive power to the language by +allowing you to capture join points based on the actual type of an +argument, rather than the declared type of its formal. So even though +the `HashSet.removeAll` method takes a `Collection` as an argument, you +can write advice that only runs when it is actually passed a `HashSet` +object. + +AspectJ's notion of object construction and initialization, a +complicated process in Java, has been clarified. This affects some uses +of the xref:porting.adoc#1.0a1-initializations[initializations pointcut] +and xref:porting.adoc#1.0a1-constructor-calls[constructor calls] +pointcut. + +The little-used pointcuts xref:porting.adoc#1.0a1-hasaspect[`hasaspect`] +and xref:porting.adoc#1.0a1-withinall[`withinall`] have been removed. + +The `returns` keyword is xref:porting.adoc#1.0a1-user-defined-returns[no +longer necessary] for user-defined pointcuts. + +Pointcuts may now be declared `static`, and +xref:porting.adoc#1.0a1-static-pointcuts[only static pointcuts] may be +declared in classes and referred to with qualified references (such as +`MyAspect.move()`). + +Non-abstract pointcuts may now be declared `final`. + +We have finally added an extremely general pointcut, +`if(BooleanExpression)`, that picks out join points programatically. + +==== Type patterns + +Our treatment of xref:porting.adoc#1.0a1-new-wildcards[* and ..] in type +patterns is cleaner. + +Type patterns now have the ability to include array types, and there is +a new wildcard, +, to pick out all subtypes of a given type. Previously, +the subtypes operator was only allowed in introduction, and was +xref:porting.adoc#1.0a1-subtypes-to-plus[spelled differently]. + +==== Advice + +Around advice is treated much more like a method, with a +xref:porting.adoc#1.0a1-around-returns[return value] and an optional +xref:porting.adoc#1.0a1-around-throws[throws clause]. + +The advice precedence rules have been +xref:porting.adoc#1.0a1-advice-precedence[changed]. Now, for example, a +piece of after advice that appears lexically later than another piece of +after advice will run later, as well. Previously, the relationship was +the other way around, which caused no small amount of confusion. + +After returning advice has lost a +xref:porting.adoc#1.0a1-after-returning[useless set of parentheses] when +not using the return value. + +The `thisStaticJoinPoint` reflective object has been +xref:porting.adoc#1.0a1-this-static-join-point[renamed], and the +`thisJoinPoint` object hierarchy has been +xref:porting.adoc#1.0a1-this-join-point[simplified]. + +==== Introduction and static crosscutting + +On the static side of the language, introduction hasn't changed, but +there is now a new keyword, `declare`, that is used to declare various +statically-crosscutting properties. One of these properties is +subtyping, so we've +xref:porting.adoc#1.0a1-plus-implements-extends[gotten rid of] the ugly +keywords `+implements` and `+extends`. + +We have provided two new forms, `declare error` and `declare warning`, +for the often-asked-for property of compile-time error detection based +on crosscutting properties. + +AspectJ's interaction with checked exceptions is now firmly on the side +of static crosscutting, since Java treats such exceptions at +compile-time. A new form, `declare soft`, can be used to "soften" +checked exceptions into an unchecked form. This may affect some uses of +xref:porting.adoc#1.0a1-now-use-soft[around advice] that previously +mucked with the exception checking system. + +==== Aspects + +The "of each" modifiers have been +xref:porting.adoc#1.0a1-aspects[renamed]. Apart from the spelling, the +main interesting difference is the splitting up of `of eachobject` into +two different modifiers, parallel with the split of `instanceof` into +`this` and `target`. + +The `dominates` keyword now takes a type pattern, rather than a type. +This allows an aspect A, for example, to declare that its advice should +dominate the advice of another aspect B as well as its subtypes, with +the new + subtypes operator: `aspect A dominates B+`. + +=== [#1.0alpha1compiler]#Compiler# + +The most important change in the compiler is that it supports the new +language. In addition, all reported bugs in the last release have been +fixed. Thanks for your bug reports. + +The compiler also gets a new `-encoding` flag in this release for +handling source files that are not in standard US-ASCII format. Thanks +to Nakamura Tadashi for both suggesting this feature and for submitting +a nice patch to implement it. + +==== Known Limitations + +The previous compiler's limitations regarding join points that occurred +in anonymous classes have all been eliminated. Unfortunately, +eliminating this restriction has resulted in preprocessed source code +that is less readable than in previous releases. More care will be taken +in the next release to mitigate this effect. + +Many semantic errors are not caught by ajc but fall through to javac. +Moreover, some errors regarding the initialization of final fields might +never show up when using ajc. This will be fixed shortly. + +=== [#1.0alpha1documentation]#Documentation# + +Although we spent much of our time this release cycle updating the +documentation to the new language rather than improving its content, we +did make some structural improvements. The old Primer has been split +into a Programming Guide, covering the language, and a Development +Environment Guide, covering the develompent tools. In addition, +printable versions of both guides (in PDF) are finally included in the +documentation package. + +=== [#1.0alpha1ajdoc]#Ajdoc# + +Ajdoc was rewritten to conform with the language changes and provide +support for other AspectJ/Java compilers. Our doclet is used by default +creating AspectJ-specific documentation, or Sun's standard doclet can be +used by passing the '-standard' flag to Ajdoc to produce regular Javadoc +documentation (excluding AspectJ-specifics). + +=== [#1.0alpha1ant]#Ant# + +An Ajdoc task is now available. The Ajc ant task was improved to be +completely back-compatible with the Javac task. + +=== [#1.0alpha1ajbrowser]#AJBrowser# + +The "AspectJ Browser" is a new standalone source code browsing +application. It will let you compile ".lst" files, view the structure +for those files and navigate the corresponding source code. + +=== [#1.0alpha1ajde]#AJDE# + +==== AJDE for JBuilder + +===== Installation + +* Use the installer to place the "ajdeForJBuilder.jar" and +"aspectjrt.jar" in to JBuilder's lib/ext directory. + +===== Key Improvements + +* The "AspectJ Structure View" replaces JBuilder's structure view +instead of being launched in a separate window. +* AJDE can be toggled on/off with the "AJ" button--when it is turned off +all of the menus, resources, and event listeners that it uses will be +removed. +* Projects no longer require the manual adding of the "aspectjrt.jar" +libarary. + +===== Known Bugs & Limitations + +* There is no compiler progress dialog--the way to tell if the compile +is finished is to watch the "status" area of the main window. +* There are no keyboard compile/execute shortcuts. +* The structure view is not persistent between IDE launches--you must +compile to view the structure for a program. +* The debugger has not seen much use and it's stability and performance +is limited. +* There is no ajdoc tool support. +* Linux testing has been very limited. + +==== AJDE for Forte + +===== Installation + +* Use the installer to place the "ajdeForForte.jar" in Forte's modules +directory and "aspectjrt.jar" in to Forte's lib/ext directory. +* In the "Tools" menu select "Global Options" +* Right-click the "Modules" item and select "New Module from File..." +* Find the ajdeForForte.jar in the directory that you installed into +(e.g. c:\forte4j\modules) and select it. + +===== Key Improvements + +* AJDE can be toggled on/off with the "AJ" button--when it is turned off +all of the menus, resources, and event listeners that it uses will be +removed. +* The AJDE functionality is now contained within it's own toolbar and +menu. + +===== Known Bugs & Limitations + +* "Mode" switching is not supported in this version--you must do all of +your AspectJ work in the "Editing" mode. If you switch modes the IDE has +to be restarted for the AspectJ window to show again. +* There is no compiler progress dialog--the way to tell if the compile +is finished is to watch the "status" area of the main window. +* There are no keyboard compile/execute shortcuts. +* The structure view is not persistent between IDE launches--you must +compile to view the structure for a program. +* The debugger has not seen much use and it's stability and performance +is limited. +* There is no ajdoc tool support. +* Linux testing has been very limited. + +==== AJDE for Emacs + +AspectJ-mode now includes a toggle in the AspectJ menu that disables its +intrusive functions, enabling easy switching between Java and AspectJ +projects. See the README and CHANGES files in the distribution for +additional details. + +AJDEE is now compatible with JDEE 2.2.7.1, JDEE 2.2.8beta4, and speedbar +0.14alpha. It a toggle in the AspectJ menu that disables its intrusive +functions, enabling easy switching between Java and AspectJ projects. +See the README and CHANGES files in the distribution for additional +details. + +''''' diff --git a/docs/dist/doc/examples/spacewar/README.adoc b/docs/dist/doc/examples/spacewar/README.adoc new file mode 100644 index 000000000..624dd0ffc --- /dev/null +++ b/docs/dist/doc/examples/spacewar/README.adoc @@ -0,0 +1,54 @@ +© Copyright 1997-2001 Xerox Corporation. All rights reserved. + +*Last updated*: January 10, 2001 + + + +== [#5]#Exploring the Spacewar Example# + +The code in this directory is an implementation of the classic video +game Spacewar. + +The Spacewar game is intended to provide a modest-sized example of a +program that uses aspects. The code for this example is evolving, as we +add new features to AspectJ and come up with a better understanding of +how to use the features. + +In order to compile and run this example, make sure to have the latest +version of AspectJ correctly installed. If you're not sure you do, try +the helloworld example first by following the instructions in +xref:../doc/primer/default.html[Primer] section Getting Started. + +=== [#5.1]#Compiling Spacewar# + +* Change to the `examples` directory. +* Type `ajc -argfile spacewar/demo.lst` to compile the system. + +=== [#5.2]#Running Spacewar# + +* In the examples directory, type `java spacewar.Game` + +When the game starts up you will see two different displays. These are +the two built-in display aspects of the game. In each you will see a +single white ship and two red ships. The white ship is yours to control; +the red ships are an enemy robots. Your ship is controlled with the four +arrow keys to turn, thrust and stop; the spacebar fires. As you play, +the game will be displayed in both windows. + +When running on a 1.4 or later VM, click in the main panel to give it +focus so that your keystrokes are recognized. + +You can quit the game with ctl-Q. + +=== [#5.3]#Exploring the Code# + +There is one other built-in configurations for the Spacewar game. Try it +by typing `ajc @spacewar\debug.lst`. This compiles in an elaborate +debugging aspect for the game. + +We recommend you explore the Spacewar source code and look at the +aspects that it uses. You will find several of them, of different scales +and different degrees of cross-cutting. Remember that these represent +our evolving understanding of how to use AspectJ to implement Spacewar. +If you believe we should be doing something differently, then please let +us know. diff --git a/docs/dist/doc/examples/spacewar/README.html b/docs/dist/doc/examples/spacewar/README.html deleted file mode 100644 index a9ec265b4..000000000 --- a/docs/dist/doc/examples/spacewar/README.html +++ /dev/null @@ -1,82 +0,0 @@ - - - - - - -Space War - - - - -

© Copyright 1997-2001 Xerox Corporation. All rights -reserved.

- -

Last updated: January 10, 2001

- -

 

- - - -

Exploring the Spacewar Example

- -

The code in this directory is an implementation of the -classic video game Spacewar.

- -

The Spacewar game is intended to provide a modest-sized example of -a program that uses aspects. The code for this example is evolving, -as we add new features to AspectJ and come up with a better -understanding of how to use the features.

- -

In order to compile and run this example, make sure to have the latest -version of AspectJ correctly installed. If you're not sure you do, try the -helloworld example first by following the instructions in Primer -section Getting Started.

- -

Compiling Spacewar

- -
    -
  • Change to the examples directory.
    • - -
  • Type ajc -argfile spacewar/demo.lst to compile the - system.
    • -
- -

Running Spacewar

- -
    -
  • In the examples directory, type java spacewar.Game
    • -
- -

When the game starts up you will see two different displays. These -are the two built-in display aspects of the game. In each you will -see a single white ship and two red ships. The white ship is yours -to control; the red ships are an enemy robots. Your ship is controlled -with the four arrow keys to turn, thrust and stop; the spacebar -fires. As you play, the game will be displayed in both windows.

- -

When running on a 1.4 or later VM, click in the main panel to give - it focus so that your keystrokes are recognized.

- -

You can quit the game with ctl-Q.

- -

Exploring the Code

- -

There is one other built-in configurations for the Spacewar game. -Try it by typing ajc @spacewar\debug.lst. This -compiles in an elaborate debugging aspect for the game. - -

- -

We recommend you explore the Spacewar source code and look at the -aspects that it uses. You will find several of them, of different -scales and different degrees of cross-cutting. Remember that these -represent our evolving understanding of how to use AspectJ to -implement Spacewar. If you believe we should be doing something -differently, then please let us know. -

- - - - - diff --git a/docs/dist/doc/index.adoc b/docs/dist/doc/index.adoc new file mode 100644 index 000000000..cfde98826 --- /dev/null +++ b/docs/dist/doc/index.adoc @@ -0,0 +1,231 @@ +[#top]## + +== AspectJ Documentation and Resources + +AspectJ ^[.small]#tm#^ is a seamless aspect-oriented extension to +Java^[.small]#tm#^. The compiler and development tools are available +under an open-source license, require Java 1.3 to run, and produce code +that runs in JDK 1.1 and later VM's. For the latest materials, see +http://eclipse.org/aspectj. Not all of these materials have been updated +for AspectJ 5. + +[cols=",",] +|=== +|+++Section+++ |+++Contents+++ + +|xref:#documentation[docs] |link:faq.html[FAQ], link:quick5.pdf[Quick +Reference (AspectJ 5)], link:quick.pdf[Quick Reference (1.2.1)], +link:adk15notebook/index.html[AspectJ 5 Developer's Notebook], +link:progguide/index.html[programming], +link:devguide/index.html[development] and +link:pdguide/index.html[problem diagnosis] guides, +link:runtime-api/index.html[API] and link:examples/[example code]. + +|xref:#distributions[distributions] +|http://eclipse.org/aspectj[AspectJ]; development environment support +for http://eclipse.org/ajdt[Eclipse] and +https://jdeveloperaop.dev.java.net/[JDeveloper]. + +|xref:#resources[resources] |http://aosd.net[aosd.net]; +http://eclipse.org/aspectj[AspectJ project] the bug +http://bugs.eclipse.org/bugs[db], and mailing lists for +mailto:aspectj-users@eclipse.org[users] and +mailto:aspectj-dev@eclipse.org[developers]. + +|xref:#paths[paths] |for those new to AspectJ +|=== + +[#documentation]## + +=== AspectJ documentation + +[width="100%",cols="50%,50%",options="header",] +|=== +|Documentation |Description +|link:quick5.pdf[AspectJ 5 Quick Reference] |This is a four-page quick +reference for the AspectJ 5 language. + +|link:quick.pdf[AspectJ Quick Reference] |This is a two-page quick +reference for the AspectJ language. + +|link:adk15notebook/index.html[AspectJ 5 Developer's Notebook] +(printable link:adk15notebook/printable.html[html]) |This describes the +changes to the AspectJ language and tools introduced in the AspectJ 5 +Development Kit. These changes are additive, and are not yet reflected +in the programming guide or quick reference. + +|link:progguide/index.html[Programming Guide] (printable +link:progguide/printable.html[html]) |This introduces AOP and the +AspectJ language. link:progguide/starting.html[Getting Started] +describes basic semantics, and shows development- and production-time +applications. link:progguide/language.html[The AspectJ Language] +describes join points, pointcuts, advice, and introduction, all features +new to AOP. link:progguide/examples.html[Examples] walks you through the +examples included with the documentation, and there are two short +chapters on useful link:progguide/idioms.html[Idioms] and a few +link:progguide/pitfalls.html[Pitfalls] The appendices have reference +information: the link:progguide/quick.html[Quick Reference] summarizes +AspectJ syntax, the link:progguide/semantics.html[Language Semantics] +best describes AspectJ usage, and +link:progguide/implementation.html[Implementation Notes] describes how +the current version is limited to code the compiler controls. + +|link:devguide/index.html[Development Environment Guide] + +(printable link:devguide/printable.html[html]) |This is a guide to +link:devguide/ajc-ref.html[ajc], the command-line compiler; +link:devguide/ajbrowser.html[ajbrowser], the stand-alone GUI for +compiling and viewing crosscutting structure; and the +link:devguide/antTasks.html[Ant tasks] for building AspectJ programs. + +|link:pdguide/index.html[Problem Diagnosis Guide] + +(printable link:pdguide/printable.html[html]) |This has a guide to the +various features available such as messages and trace to help you both +solve problems with you own programs and report bugs to the AspectJ +team. + +|link:runtime-api/index.html[AspectJ API] |API documentation for AspectJ +runtime classes. JoinPoint shows the state automatically available at +each join point. See also the link:weaver-api/index.html[Weaver API] + +|link:faq.html[FAQ] |Frequently-asked questions about the AspectJ +language, tools, and project. + +|README's |Changes and porting guide for AspectJ +link:README-197.html[1.9.7], link:README-196.html[1.9.6], +link:README-195.html[1.9.5], link:README-194.html[1.9.4], +link:README-193.html[1.9.3], link:README-192.html[1.9.2], +link:README-191.html[1.9.1], link:README-190.html[1.9.0], +link:README-1811.html[1.8.11], link:README-1810.html[1.8.10], +link:README-189.html[1.8.9], link:README-188.html[1.8.8], +link:README-187.html[1.8.7], link:README-186.html[1.8.6], +link:README-185.html[1.8.5], link:README-184.html[1.8.4], +link:README-183.html[1.8.3], link:README-182.html[1.8.2], +link:README-181.html[1.8.1], link:README-180.html[1.8.0], +link:README-174.html[1.7.4], link:README-173.html[1.7.3], +link:README-172.html[1.7.2], link:README-171.html[1.7.1], +link:README-170.html[1.7.0], link:README-1612.html[1.6.12], +link:README-1611.html[1.6.11], link:README-1610.html[1.6.10], +link:README-169.html[1.6.9], link:README-168.html[1.6.8], +link:README-167.html[1.6.7], link:README-166.html[1.6.6], +link:README-165.html[1.6.5], link:README-164.html[1.6.4], +link:README-163.html[1.6.3], link:README-162.html[1.6.2], +link:README-161.html[1.6.1], link:README-160.html[1.6.0], +link:README-154.html[1.5.4], link:README-153.html[1.5.3], +link:README-152.html[1.5.2], link:README-151.html[1.5.1], +link:README-150.html[1.5.0], link:README-121.html[1.2.1], +link:README-12.html[1.2.0], link:README-11.html[1.1], and +xref:porting.adoc[1.0]. + +|link:changes.html[Changes] |Changes between the latest releases. + +|link:examples/[Examples] |AspectJ code to demonstrate some language +features and implement JavaBean properties, the Observer pattern, a +tracing library, and a game application where aspects handle display +updating. +|=== + +[#distributions]## + +=== AspectJ distributions + +[cols=",",options="header",] +|=== +|Distributions |Description +|http://eclipse.org/aspectj[AspectJ] |The AspectJ distribution contains +binaries for the compiler, structure browser, and Ant taskdefs, as well +as the documentation and examples. + +|http://eclipse.org/aspectj[AspectJ] source code |Source code for +AspectJ is available under the open-source +https://www.eclipse.org/org/documents/epl-2.0/EPL-2.0.txt[Eclipse Public +License v 2.0] license from the Git repositories for the AspectJ +project. See the faq.html#q:buildingsource[FAQ entry]. + +|http://eclipse.org/ajdt[AspectJ for Eclipse] |AspectJ Development +Environment support for Eclipse is available under Eclipse Public +License v 1.0 from the eclipse.org project site http://eclipse.org/ajdt + +|https://jdeveloperaop.dev.java.net/[Support for the JDeveloper IDE] +|Support for programming in AspectJ using the JDeveloper IDE is +available under the Apache Software License from the java.net project +site https://jdeveloperaop.dev.java.net/ +|=== + +[#resources]## + +=== Other AspectJ resources + +[cols=",",options="header",] +|=== +|Resources |Description +|Mail lists |AspectJ users discuss tips and best practices for writing +AspectJ programs on aspectj-users@eclipse.org. AspectJ developers +discuss issues with developing the AspectJ tools on +aspectj-dev@eclipse.org. To get occasional emails about AspectJ releases +and relevant events, subscribe to aspectj-announce@eclipse.org. To view +list archives or subscribe to the list, go to +http://eclipse.org/aspectj[the AspectJ home page]. To find archived +emails, use the Eclipse site +http://www.eclipse.org/search/search.cgi[search page]. + +|http://bugs.eclipse.org/bugs[Bug database] |Use the Eclipse project's +Bugzilla database to view and submit bugs against the AspectJ product +components +http://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&component=Compiler[Compiler] +(for the AspectJ compiler, ajc) +http://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&component=IDE[IDE] +(for AJBrowser and AJDE bugs), +http://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&component=Ant[Ant] +(for the Ant tasks), and +http://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&component=Docs[Docs] +(for the documentation). Bugs all users should know about are +http://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&keywords=info[flagged +with the "info" keyword]. See the faq.html#q:ajcbugs[FAQ entry] for +instructions on submitting compiler bugs. + +|http://aosd.net - the AOSD web site |This site has discussion and +announcements related to aspect-oriented software development (AOSD) in +general. Use announce@aosd.net to get and publish notices about AOSD +workshops, conferences, and technology releases. Use discuss@aosd.net +for general AOSD discussions. +|=== + +[#paths]## + +=== Suggested paths for those new to AspectJ + +To learn the AspectJ language, read the +link:progguide/index.html[Programming Guide], keeping the +link:progguide/semantics.html[Semantics appendix] nearby as the best +reference for AspectJ usage. Focus initially on the join point model and +pointcuts, concepts AOP adds to OOP. To read about how the +link:examples/[examples] work, see the +link:progguide/examples.html[Examples] section in the +link:progguide/index.html[Programming Guide]. View and navigate the +crosscutting structure using http://eclipse.org/ajdt[AJDT]; if you can't +use Eclipse, try the `ajbrowser` structure viewer, as described in the +link:devguide/ajbrowser.html[AspectJ Browser] section of the +link:devguide/index.html[Development Environment Guide]. + +To start using AspectJ with your own code, modify the example aspects to +apply to your classes. As you learn, use the compiler's `-Xlint` flags +to catch some common mistakes. (Understand that the +link:progguide/implementation.html[current implementation] is limited to +code the compiler controls.) + +To plan how to adopt AspectJ into a project, read the +link:progguide/index.html[Programming Guide] on development- and +production-time aspects and the link:faq.html[FAQ] entries for +faq.html#q:startUsingAJ[How should I start using AspectJ?], +link:faq.html#adoption[Deciding to adopt AspectJ], the Development tools +sections (faq.html#q:integrateWithDevTools[one], +link:faq.html#devtools[two], link:faq.html#ltw[Load-time weaving] ), and +faq.html#q:opensource[AspectJ as open-source]. + +Enjoy the language! + +The AspectJ Team + +''''' + +[.small]#xref:#top[Top]# diff --git a/docs/dist/doc/porting.adoc b/docs/dist/doc/porting.adoc new file mode 100644 index 000000000..809f85b4f --- /dev/null +++ b/docs/dist/doc/porting.adoc @@ -0,0 +1,1868 @@ +[.small]#© Copyright 1998-2002 Palo Alto Research Center Incorporated, +2003-2004 Contributors. All rights reserved.# + +== AspectJ Porting Notes + +* xref:#pre-1.2[Pre-1.2 code] +* xref:#pre-1.1[Pre-1.1 code] +* xref:#pre-1.0.4[Pre-1.0.4 code] +* xref:#pre-1.0rc1[Pre-1.0rc1 code] +* xref:#pre-1.0beta1[Pre-1.0beta1 code] +* xref:#pre-1.0alpha1[Pre-1.0alpha1 code] +* xref:#pre08b3[Pre-0.8beta3 code] +* xref:#pre08b1[Pre-0.8beta1 code] +* xref:#pre07b11[Pre-0.7beta11 code] +* xref:#pre07b10[Pre-0.7beta10 code] + +=== [#pre-1.2]#Porting pre-1.2 code to AspectJ 1.2# + +README-12.html contains a discussion of the changes between 1.1 and 1.2. +The key points are: + +*The default AspectJ compiler compliance level is now 1.4* (whereas in +previous releases the default compliance level was 1.3). This has a +number of implications: + +* class files generated by the compiler are now JRE v1.2 and upwards +compatible. (At compliance level 1.3, AspectJ generated class files that +were compatible with JRE 1.1 also). +* `call` pointcuts may match more join points than in the same program +compiled at compliance level 1.3. + +The AspectJ compiler can be restored to 1.3 compliance settings by +specifying the "-1.3" option on the command-line. + +The following example program illustrates the differences in join point +matching with the `call` pointcut designator between 1.4 and 1.3 +compliance levels. + +.... +01 class A { +02 public void doIt() {...}; +03 } +04 +05 class B extends A { +06 public void doThisToo() {...}; +07 } +08 +09 +10 public class CallsAandB { +11 +12 public static void main(String[] args) { +13 B b = new B(); +14 A bInDisguise = new B(); +15 +16 b.doIt(); // AspectJ 1.2 matches here +17 bInDisguise.doIt(); // this is never matched +18 } +19 +20 } +21 +22 aspect CallPCDMatchingExample { +23 +24 before() : call(* B.doIt(..)) { +25 System.out.println("About to call B.doIt(...)"); +26 } +27 +28 } +.... + +When this program is compiled with AspectJ 1.2 using the default +compiler options, it will produce one line of output when it is +executed: + +`About to call B.doIt(...)` + +The same program compiled under AspectJ 1.1 (or using AspectJ 1.2 with +the -1.3 flag specified) does not produce any output when it is run. + +The reason for the additional call pcd match is that prior to compliance +level 1.4, Java compilers produced bytecodes that call A.doIt() (the +defining type of the method), rather than B.doIt() (the declared type in +the program text). The generated call to A.doIt() is not matched by the +call pcd used in the before advice. At compliance level 1.4, the +bytecodes retain the declared type of the receiver in the program +source, generating a call to B.doIt(), which _is_ matched by the call +pcd. + +This is a good example of why the recommended style is to use +`call(* doIt(..)) && target(B)`, which always matches based on the +actual type of the receiver. + +*New warnings emitted by the compiler for unmatched call pcds.* Because +users have found the static type matching used for a type pattern +specified in a `call` pcd confusing (as evidenced by the example above), +AspectJ 1.2 has a new Xlint warning which is enable by default. The +compiler will now produce a warning whenever a call pointcut designator +does not match at a join point, and a user may have expected it to. +Compiling the above program using AspectJ 1.2 produces the following +compiler output: + +.... + +CallsAandB.java:24 warning does not match because declaring type is A, if match desired use target(B) [Xlint:unmatchedSuperTypeInCall] +before() : call(* B.doIt(..)) { + ^^^^^^^^^^^^^^^ + + see also: CallsAandB.java:17 + + +1 warning + +.... + +The warning is telling us that the call pointcut associated with the +before advice on line 24 of the source file does not match at a join +point where the user may have expected it to. The source location +corresponding to the unmatched join point is indicated by the "see also" +line - in this case line 17 of the source file. At line 17 we find a +call to `bInDisguise.doIt()`. Since the static type of `bInDisguise` is +`A`, this call will never be matched. The warning also tells us a +possible solution if we intended the pointcut to match at this join +point: use `call(* doIt(..) && target(B)`. + +If you find warnings of this kind coming out when you use the AspectJ +1.2 compiler, the recommended fix is to switch to using the `target` +designator in place of a type pattern in the `call` pointcut expression. +Note that there is no loss of runtime efficiency here - runtime tests +are only added in the cases where it cannot be determined at compile +time whether the type of the receiver will match the type specified in +the `target` expression. Note that `target` cannot be used in `declare` +statements. + +*Use of non-statically determinable pointcut expressions in declare +statements* has always been forbidden, but prior to 1.2 the AspectJ +compiler did not raise an error if they were used. The AspectJ Language +Semantics appendix states that `cflow, cflowbelow, this, target, args` +and `if` pointcut designators cannot be used directly or indirectly +(through a user-defined pointcut) inside of a `declare` statment. When +moving code from 1.1 to 1.2, additional errors may be raised due to the +stricter policing of this rule. The solution is to recode the declare +statement avoiding pointcut expressions that may require a run-time +test. + +*Interface constructors no longer supported*. Declaring a constructor on +an interface is now (correctly) prohibited, and there will no longer be +a constructor-execution join point for the interface. To initialize a +field declared on an interface, use initialization, e.g., + +.... +int I.i; +after(I i) returning: initialization(I) && this(i) { i.i = 2; } +.... + +To pick out the constructor-execution for any implementation of I, try + +.... +execution(I+.new(..)) +.... + +For more information, see bug +https://bugs.eclipse.org/bugs/show_bug.cgi?id=49295[49295]. + +*Declaring a static method on an interface* is now (correctly) +prohibited. One workaround is to define a static method on the aspect +instead. For more information, see bug +https://bugs.eclipse.org/bugs/show_bug.cgi?id=47754[47754]. + +*Watch for problems due to incompatible BCEL versions.* AspectJ 1.2 +includes a different version of BCEL than AspectJ 1.1. If you have the +older version of BCEL available earlier on your classpath than the +version included in the 1.2 aspectjtools.jar then you will see errors +like: + +.... +C:\work\test\TestAspect.aj error Internal compiler error +java.lang.NoSuchMethodError: org.apache.bcel.generic.InstructionFactory. +createNewArray(Lorg/apache/bcel/generic/Type;S)Lorg/apache/bcel/generic/Instruction; +.... + +This typically happens because the old version of BCEL has been included +as a standard extension in your JVM configuration. Ensure you have +removed it from jre/lib/ext under your JDK installation. + +For more information, see bugs including +https://bugs.eclipse.org/bugs/show_bug.cgi?id=60389[60389], +https://bugs.eclipse.org/bugs/show_bug.cgi?id=59921[59921]. + +=== [#pre-1.1]#Porting pre-1.1 code to AspectJ 1.1# + +README-11.html contains a discussion of the language changes from 1.0 to +1.1. The high points: + +The `call(..)` pointcut designator is now implemented only at the call +site; by contrast, the AspectJ 1.0 compiler could also implement it on +the callee side. So in 1.0 if you compiled a pointcut using `call(..)` +but only passed the compiler the code for the target of the call, the +pointcut could be implemented. This is not true for 1.1. To fix this, +use `execution(..)` in place of `call(..)`, or include all calling +clients in the compile. (link:README-11.html#NO_CALLEE_SIDE_CALL[more +info]) + +Type-patterns are no longer permitted for the defining type of +inter-type declarations. Replace the pattern with a type. In many cases, +you can declare members on an interface type, and then declare that the +types picked out by the type-pattern implement have the interface as +their parent. (link:README-11.html#SINGLE_INTERCLASS_TARGET[more info]) + +Type-patterns are no longer permitted when specifying `declare soft`. +Replace the pattern with a literal type. + +Wildcards patterns (`foo..*`) are no longer permitted for `this()`, +`target()`, or `args()`. Replace the pattern with a literal type or with +a subtype wildcard (`Type+`). +(link:README-11.html#INSTANCEOF_ON_WILD[more info]) + +Conflicts will be reported for no-argument constructors generated by +compilers when no constructor is defined for a class. That means the +following code will compile in 1.0 but not in 1.1: + +.... +class C {} +aspect A { + C.new() {} // permitted in 1.0; conflict in 1.1 +} +.... + +One fix is to declare a non-conflicting constructor by adding arguments +(or defining a constructor in the target class); a better fix might be +to do the work of the declared constructor in advice on the +initialization join point for the object. +(link:README-11.html#DEFAULT_CONSTRUCTOR_CONFLICT[more info]) + +The pointcut designators `within()` and `withincode()` will not pick out +code within the lexical extent of method-local and anonymous inner types +(because these are not represented as such in bytecode form). Because +`within` forms specify staticly-determinable pointcuts, they might be +used in declare error or declare warning statements, which might produce +different results. (link:README-11.html#WITHIN_MEMBER_TYPES[more info]) + +The compiler will report an error that the form +`aspect {name} dominates {list}...` is no longer supported. It has been +replaced by a new declare statement: + +.... +declare precedence : {name} {list}... +.... + +(link:README-11.html#ASPECT_PRECEDENCE[more info]) + +The field set join point now has a return type of `void`. Compiling +programs using around advice on these join points might cause errors +unless the return type of the around advice and the result of any +proceed() call is `Object` or `void`. +(link:README-11.html#VOID_FIELD_SET[more info]) + +The compiler cannot implement after or around advice for the handler PCD +because the end of exception handlers is ambiguous in bytecode. Try to +use before advice. (link:README-11.html#AFTER_HANDLER[more info]) + +=== [#pre-1.0.4]#Porting pre-1.0.4 code# + +In versions of AspectJ prior to 1.0.4, the compiler was not correctly +implementing the AspectJ-1.0 language design for some uses of after +returning advice. + +The main change that was made was of after returning advice for +constructor execution join points. Previously, this advice was legal: + +.... +after() returning (Foo f): execution(Foo.new(..)) { ... } +.... + +However, it has always been a part of the 1.0 language design (and of +Java's language design) that constructors themselves (as opposed to +constructor calls) do not return the value of the new object. Rather, +`this` is bound to the new object, and the constructor behaves like a +void method. With that in mind, any code like the above should be +conveted to the form. + +.... +after(Foo f) returning: this(f) && execution(Foo.new(..)) { ... } +.... + +In compilers prior to 1.0.4, the following advice could pick out join +points + +.... +after() returning (String s): call(void foo()) { ... } +.... + +This is no longer picked out. This pattern was most commonly used in +highly polymorphic contexts, such as + +.... +after() returning (String s): call(* foo()) { ... } +.... + +If you want to capture all calls, binding null objects for those that +would otherwise have no value, you must use the `Object` type. + +.... +after() returning (Object o): call(* foo()) { ... } +.... + +Uses of both of these forms are highleted with compiler warnings in the +1.0.4 compiler. + +''''' + +=== [#pre-1.0rc1]#Porting pre-1.0rc1 code# + +Aspects can no longer be declared to implement the `Serializable` or +`Cloneable` interfaces. If you previously used serializable or cloneable +aspects, you should refactor your code to keep the state you need to +serialize or clone in objects associated with the aspects. + +''''' + +=== [#pre-1.0beta1]#Porting pre-1.0beta1 code# + +The `static` modifier is no longer allowed on pointcut declarations +anywhere. Porting is simple; just remove the static declarations when +you find them. + +Also, though the `returns` modifier on pointcuts has not been part of +the language since 1.0alpha1, the compiler still accepted them until +now. If you used this feature, now is the right time to remove the +`returns` modifier when the compiler complains about it. + +''''' + +=== [#pre-1.0alpha1]#Porting pre-1.0alpha1 code# + +The release of AspectJ 1.0alpha1 involved sweeping cleanups of the +language to bring it to 1.0 status. + +* xref:#1.0a1-pointcuts[Pointcuts] +* xref:#1.0a1-type-patterns[Type patterns] +* xref:#1.0a1-advice[Advice] +* xref:#1.0a1-introduction-and-static[Introduction and static +crosscutting] +* xref:#1.0a1-aspects[Aspects] + +==== [#1.0a1-pointcuts]#Pointcuts# + +===== [#1.0a1-plural-to-singular]#Removing the "s" from pointcuts# + +One of the most pervasive changes in porting code written before +1.0alpha1 is the change in some of the pointcut names from plural to +singular, that is, they lose an "s". In one sense, making this change in +your programs is easy: just go through and whever you see uses of the +pointcuts + +____ +calls executions gets sets handlers initializations +staticinitializations +____ + +Just take off the final "s", to make one of + +____ +call execution get set handler initialization staticinitialization +____ + +Often, there will be other changes you should make for each of these +pointcuts, but as for the name, just take off the "s". + +One risk you will have when doing this is creating name conflicts. If, +for example, you named a parameter of a pointcut "set", you should (for +your own sanity -- the compiler doesn't require it) rename it in the +rewritten pointcut. + +.... +pointcut sort(Collection set): calls(void addAll(set)); +==> +pointcut sort(Collection mySet): call(void addAll(mySet)); +.... + +While converting to use singular nouns for the primitive pointcuts, you +may also want to remove the "s" from your user-defined pointcuts. + +.... +pointcut publicCalls(): calls(public * *(..)); +==> +pointcut publicCall(): call(public * *(..)); +.... + +Of course, your naming conventions are your own, but throughout these +porting notes we will be making these changes in our example ports. + +===== [#1.0a1-remove-receptions]#Removing the receptions pointcut# + +Perhaps the largest semantic change in the 1.0 language is the removal +of receptions join points. They have been merged with call join points +in AspectJ 1.0, so now a call join point doesn't represent the +"caller-side" of a call, but the call itself, both caller and receiver. + +Changing code that used the `receptions` pointcut should be fairly +straightforward, depending on whether the pointcut exposed state or not. + +====== Not exposing state + +Receptions pointcuts that did not expose state can simply be replaced by +the new `call` and `target` pointcuts: + +.... +receptions(void Foo.m()) +==> +target(Foo) && call(void m()) +.... + +====== Exposing state + +Some receptions pointcuts exposed the receiving object by replacing the +receiving type with a pointcut formal. These PCDs should be rewritten to +use the new `target` pointcut to expose the receiving object. + +.... +pointcut fooCallees(Foo f): receptions(void f.m()); +==> +pointcut fooCallee(Foo f): target(f) && call(void m()); +.... + +Like xref:#1.0a1-fixing-state-access[other pointcuts], receptions +pointcuts that exposed one or more arguments should be rewritten to use +the `args` pointcut: + +.... +pointcut intPassers(int i, int j): receptions(void Foo.m(i, j)); +==> +pointcut intPasser(int i, int j): + args(i, j) && target(Foo) && call(void m(int, int)); +.... + +====== Constructor receptions + +There are two issues with constructor receptions in particular. + +Like xref:#1.0a1-constructor-calls[constructor calls], constructor +receptions pointcuts had a dynamic character, in that +`receptions(C.new())` would capture constructions of not only C classes, +but also of classes that extended C. + +If you want this behaviour, then you need to use the new subtypes +operator, +, on the type name in question. So, + +.... +receptions(C.new()) +==> +call(C+.new()) +.... + +Also like xref:#1.0a1-constructor-calls[constructor calls], constructor +receptions allowed access to the constructed object in the same way as +any other object. Since the only advice possible on constructor +receptions join points was `after returning` advice, the object was +always guaranteed to be there. But since constructor call join points +allow all kinds of advice it may be that the object isn't constructed +yet (say, in before or around advice). This is a benefit, in that it +allows caching constructed objects + +.... +aspect Singleton { + private C theC = null; + + C around(): call(C.new(..)) { + if (c == null) theC = proceed(); + return theC; + } +} +.... + +but it does require some rewriting. The new object can be accessed as +the return value in after returning advice. So, + +.... +after(Point p) returning (): receptions(p.new(int, int)) { ... } +==> +after() returning (Point p): call(Point+.new(int, int)) { ... } +.... + +===== [#1.0a1-fixing-state-access]#Fixing state access# + +In previous versions of AspectJ, state such as the currently executing +object or a particular argument of a method call could be accessed from +the signatures of many pointcuts, leading to difficult-to-read forms. In +AspectJ 1.0, all state accesses now use only three pointcuts + +____ +args this target +____ + +which pick out argument values, the currently executing object, and the +target object of a method call or field operation, respectively. + +====== Using args + +Any time you have a pointcut that has a signature where one of the +arguments was a pointcut or advice formal, just replace that formal with +its type and add an `args` pointcut. + +.... +pointcut intPassers(int i, int j): calls(void Foo.m(i, j)); +==> +pointcut intPasser(int i, int j): args(i, j) && call(void Foo.m(int, int)); +.... + +.... +pointcut stringPassers(String s): receptions(void Foo.m(s, ..)); +==> +pointcut stringPasser(String s): args(s, ..) && call(void Foo.m(String, ..)); +.... + +====== Rewriting calls + +If a calls pointcut exposed the the receiving object, such as + +.... +pointcut fooCallees(Foo f): calls(void f.m()); +.... + +then the new version should use the `target` pointcut to get at that +object + +.... +pointcut fooCallee(Foo f): target(f) && call(void Foo.m()); +.... + +AspectJ's calls pointcut previously allowed the new object to be +exposed, even though it may not have been constructed yet. AspectJ 1.0 +no longer allows this; you can access the new instance only in after +returning advice, when it is guaranteed that the object was successfully +constructed. So instead of using the `target` pointcut to expose the +value, you should use the normal `after returning` mechanism: + +.... +after(Point p) returning (): calls(p.new(int, int)) { ... } +==> +after() returning (Point p): call(Point+.new(int, int)) { ... } +.... + +====== Rewriting gets and sets + +Exposing the target object of a `gets` or `sets` pointcut should be done +the same way it was for `calls` pointcuts, with the new `target` +pointcut. + +.... +before(Frame f): gets(Color f.color) { ... } +==> +before(Frame f): target(f) && get(Color Frame.color) { ... } +.... + +.... +before(Frame f): sets(Color f.color) { ... } +==> +before(Frame f): target(f) && set(Color Frame.color) { ... } +.... + +In addition, the clumsy syntax for getting the old value of the field +has been eliminated. For before advice, the port is simple; just access +the field yourself in the body. Depending on the rest of your system, +you may need to restrict the advice from the aspect body to eliminiate +the circularity. + +.... +aspect A { + before(Frame f, Color c): gets(Color f.color)[c] { ... } +} +==> +aspect A { + before(Frame f): + target(f) && get(Color Frame.color) && !within(A) { + Color c = f.color; + ... + } +} +.... + +The same can be done for `around` advice. However, the only way to port +after advice that needs the old value is to convert it to around advice. + +.... +aspect A { + after(Frame f, Color c) returning (): gets(Color f.color)[c] { ... } +} +==> +aspect A { + void around(Frame f): + target(f) && get(Color Frame.color) && !within(A) { + Color c = f.color; + proceed(f); + ... + } +} +.... + +When porting `sets` pointcuts, the new value of a field is still +available, but not the way it was previously. Instead of using the +square bracket syntax, we use an `args` pointcut. All set join points +are assumed to have exactly one argument, which holds the new value. So, + +.... +after(Color newColor): sets(Color Frame.color)[][newColor] { ... } +==> +after(Color newColor): args(newColor) && set(Color Frame.color) { ... } +.... + +Also, if the field was declared private, in order to get at its old +value the aspect must be declared `privileged`. + +====== Rewriting handlers + +The value of the exception at an exception handler join point is now +accessed through the `args` pointcut; all exception handler join points +are treated as having exactly one argument, the exception value. So, + +.... +before(NotFoundException e): handlers(e) { ... } +==> +before(NotFoundException e): args(e) && handler(NotFoundException) { ... } +.... + +====== Rewriting within + +The `within` pointcut was not typically used to export context. Though +it was accidentally possible to do so in versions of AspectJ before 1.0, +it often didn't do what users expected it to. This loophole has now been +closed, and within can only take type patterns, not pointcut or advice +formals. A use of the `this` pointcut will capture what previous +implementations did: + +.... +pointcut usesFoo(Foo f): within(f); +==> +pointcut usesFoo(Foo f): this(f) && within(Foo); +.... + +===== [#1.0a1-no-subs-in-sigs]#Understanding signatures# + +Now that we have `this`, `target`, and `args` pointcuts, all of our +signatures are composed of just types, names, and wildcards; there are +no more parameters. + +Also, now that we have the `+` wildcard to pick out +xref:#1.0a1-subtypes-to-plus[subtypes], we can make signature matching +much more uniform. + +Previously, some signatures matched based on subtypes, some based on +instanceof, and some exactly. Now, we have made all signatures match +exactly. + +What does this mean for your program? Well, it means that you may have +to add `+` to some of your signatures, depending on what you meant them +to match. + +For example, the pointcut + +.... +calls(void m(Object)) +.... + +previously picked out all method calls to a method named m that took one +argument, which was a subtype of Object. Now, however, it will only pick +out method calls to methods that are defined to take exactly the type +Object, which may be a lot fewer join points. If you want the old +behaviour, simply convert to + +.... +call(void m(Object+)) +.... + +===== [#1.0a1-fixing-instanceof]#Removing the instanceof pointcut# + +The intanceof pointcut has been split into two different pointcuts, +`this` and `target`. + +Typically, the instanceof pointcut would only exist in a compound +pointcut, composed (with `&&`) with another pointcut. If the other +pointcut was a `receptions` pointcut, then `instanceof` should be +converted to `target` (and `receptions` converted to `call`). So, + +.... +pointcut stateChanges(Subject s): + instanceof(s) && receptions(void Button.click()); +==> +pointcut stateChange(Subject s): + target(s) && call(void Button.click()); +.... + +In all other cases, `instanceof` referred to the currently executing +object, and so should be converted into `this` + +.... +before(Point p): instanceof(p) && executions(* makePolar(..)) { ... } +==> +before(Point p): this(p) && execution(* makePolar(..)) { ... } +.... + +.... +pointcut setup(Client c): instanceof(c) && calls(Remote Naming.lookup(String)); +==> +pointcut setup(Client c): this(c) && calls(Remote Naming.lookup(String)); +.... + +===== [#1.0a1-initializations]#Rewriting the initializations pointcut# + +Object initialization join points are now more complicated, and more +true to Java's execution model. Now they bracket all of the +initialization that a class can do, after the return of its super +constructor call (before which no initialization can happen). Previous +versions of AspectJ had object initialization join points that only +included initialization that was made in dynamic initializers and +fields. + +The old behaviour can be recovered with a simple rewrite. + +.... +initializations(A) +==> +initialization(A.new(..)) && !execution(A.new(..)) +.... + +===== [#1.0a1-constructor-calls]#Understanding constructor calls# + +Previously, constructor call join points were matched by subtypes, so +`calls(Foo.new())` would match both calls to create new `Foo` objects, +and new `SubFoo` objects. The new `call` pointcut designator matches +types exactly, so if you want the old behaviour, you should write +`call(Foo+.new())`. + +Similarly, constructor execution join points were matched by subtypes. +So the old `executions(Foo.new())` is now represented by +`execution(Foo+.new())`. + +In both of these cases, think before using the + operator; it may be +that you didn't intend subtype matching in the first place. + +===== [#1.0a1-hasaspect]#Removing the hasaspect pointcut# + +The `hasaspect` pointcut is no longer defined, but you can get the same +behaviour using the new `if` pointcut. + +If the aspect whose presense you are checking for was defined +`of eachcflow`, `of eachcflowbelow`, or, more unlikely, `of eachJVM()`, +then the conversion is simple: + +.... +hasaspect(A) +==> +if(A.hasAspect()) +.... + +If the aspect was defined `of eachobject`, then you will have to expose +the current object in your pointcut or advice parameters: + +.... +pointcut cut(): hasaspect(A) ... ; +==> +pointcut cut(Object o): this(o) && if(A.hasAspect(o)) ... ; +or +pointcut cut(Object o): target(o) && if(A.hasAspect(o)) ... ; +.... + +If you were using the `hasaspect` pointcut to expose the state of the +aspect, then you can get the same state by using `A.aspectOf()` in the +body of the advice. For example, if the aspect A were defined +`of eachcflow`, then + +.... +before(A myA): hasaspect(myA) { + myA.checkStatus(); +} +==> +before(): if(A.hasAspect()) { + A myA = A.aspectOf(); + myA.checkStatus(); +} +.... + +===== [#1.0a1-withinall]#Removing the withinall pointcut# + +The withinall poinctut is no longer defined. You can use a combination +of within and the xref:#1.0a1-subtypes-to-plus[new subtypes operator], ++, instead. You'll save two characters and be using a simpler and more +orthogonal language. + +.... +withinall(Foo) +==> +within(Foo+) +.... + +===== [#1.0a1-user-defined-returns]#Removing returns modifier from pointcuts# + +The returns keyword is no longer necessary for user-defined pointcuts. +Simply remove it when you find it. + +.... +pointcut publicIntCalls() returns int: calls(public int *(..)); +==> +pointcut publicIntCall(): call(public int *(..)); +.... + +===== [#1.0a1-static-pointcuts]#Making some pointcuts static# + +In Java, only static members may be accessed by their declaring type +name, like the static method `Math.max()` can be accessed. + +Pointcuts now have that property too. Pointcuts may be declared to be +static, in which case they can be accessed like `MyAspect.move()`, or +they can be left non-static, in which case they can be overridden by a +subaspect. + +In addition, while pointcuts can still be defined in classes, only +`static` pointcuts can be defined in classes. + +Porting should be straightforward; just make all your pointcuts in +classes `static`, and make any pointcut with a qualified reference +static. + +==== [#1.0a1-type-patterns]#Type patterns# + +===== [#1.0a1-new-wildcards]#Understanding * and .. in type patterns# + +Previous versions of AspectJ treated * and .. too cleverly in type +patterns, placing restrictions based on what is a package and what is a +type, and basing their meanings on the definition of a package +hierarchy. + +In AspectJ 1.0, both of these wildcards are defined simply, and +textually: + +* The * wildcard alone matches all types. +* The * wildcard in a pattern matches zero or more characters, but will +not match "." +* The .. wildcard matches any sequence of characters that begins and +ends with "." + +That's it. + +This change won't affect most programs, but it will make understanding +programs easier. There is one ugly idiom, however, that this change +disposes of. If your program includes the type pattern `*..*`, which +used to match all types, you can replace it with the much simpler *. + +.... +pointcut unaryVoidMethods(): call(void *(*..*)); +==> +pointcut unaryVoidMethod(): call(void *(*)); +.... + +===== [#1.0a1-subtypes-to-plus]#Fixing subtypes in introduction# + +The new + operator is used to normalize the many places you want to use +subtypes of some types. + +In introduction forms, you will need to replace `subtypes(TypePattern)` +type patterns with the new subtype operator, +. In the case where you +wrote `subtypes(Foo)`, i.e., the subtypes of a single type, simply +replace this with `Foo+`. Otherwise, use the + operator as appropriate +in `TypePattern`. + +.... +public void (subtypes(Target0 || Target1)).accept(Visitor v) { + v.visit(this); +} +==> +public void (Target0+ || Target1+).accept(Visitor v) { + v.visit(this); +} +.... + +==== [#1.0a1-advice]#Advice# + +===== [#1.0a1-around-returns]#Moving the return type of around# + +The returns keyword is no longer used for around advice. Instead, the +return type is declared as it is for methods. So, + +.... +around(Point p) returns void: setters(p) { ... } +==> +void around(Point p): setter(p) { ... } +.... + +===== [#1.0a1-around-throws]#Adding a throws clause to around# + +Around advice must now declare the checked exceptions it throws with a +`throws` clause, much like a method. + +.... +char around(char c) throws java.io.CharConversionException: converter(c) { + char result; + try { result = proceed(); } + catch (Exception e) { + throw new java.io.CharConversionException(); + } + if (result == 0) throw new java.io.CharConversionException(); + return result; +} +.... + +===== [#1.0a1-advice-precedence]#Understanding advice precedence# + +In previous versions of AspectJ, advice precedence within an aspect was +simple: if a piece of advice appeared before another piece, it was more +precedent. This made perfect sense for `before` and `around` advice, but +was the cause of confusion (even among the AspectJ designers, more than +once) for `after` advice, as it seemed backward. + +In addition, advice was ordered by kind, in that around advice always +surrounded before and after advice. + +AspectJ 1.0 has changed this; precedence for `after` advice is inverted, +and advice is no longer ordered by kind. + +This won't matter to you unless you write pieces of advice in the same +aspect that apply to the same join point. + +If you do, here's what to think about: If you're looking at two pieces +of advice and want to know which has precedence, if either is `after` +advice, then the second one has precedence. Otherwise, the first does. + +This allows interesting advice interaction. In the following advice, for +example, the `after throwing` advice will catch the exception thrown by +the `before` advice + +.... +aspect A { + before(): call(void main(..)) { + throw new RuntimeException(); + } + after() throwing(RuntimeException e): call(void main(..)) { + System.err.println("caught you!"); + } +} +.... + +But reversing the order will give the `before` advice more precedence, +making its exception uncatchable by the `after throwing` advice + +.... +aspect A { + after() throwing(RuntimeException e): call(void main(..)) { + System.err.println("missed you!"); + } + before(): call(void main(..)) { + throw new RuntimeException(); + } +} +.... + +Advice in _different_ aspects is ordered by the normal aspect precedence +rules of subtyping and the `dominates` modifier. + +===== [#1.0a1-after-returning]#Fixing after returning# + +If you use after returning advice and do not need to expose the return +value, you no longer need to write an empty set of parentheses to +indicate that fact. So, + +.... +after(Formals) returning (): Pointcut { ... } +==> +after(Formals) returning: Pointcut { ... } +.... + +The same syntax is now available for after throwing advice, in case you +do not care what `Throwable` is thrown. + +.... +after(Formals) throwing: Pointcut { ... } +.... + +===== [#1.0a1-this-static-join-point]#Renaming thisStaticJoinPoint# + +`thisStaticJoinPoint` has been renamed `thisJoinPointStaticPart`, to +reflect that it is now exactly the static part of `thisJoinPoint`: It +will return the same object as `thisJoinPoint.getStaticPart()`. + +===== [#1.0a1-this-join-point]#Converting access to thisJoinPoint# + +The `JoinPoint` object hierarchy has been folded into a single class, +`org.aspectj.lang.JoinPoint`. A common pattern in logging, for example, +was + +.... +before() executions(* myMethod()) { + ExecutionJoinPoint jp = (ExecutionJoinPoint)thisJoinPoint; + CodeSignature jp = (CodeSignature)jp.getSignature(); + System.err.println(jp.getParameters()); + System.err.println(jp.getParameterNames()); +} +.... + +While there is still a rich hierarchy for signatures, there is only one +`JoinPoint` type, so this can be rewritten as: + +.... +before() executions(* myMethod()) { + JoinPoint jp = thisJoinPoint; + CodeSignature jp = (CodeSignature)jp.getSignature(); + System.err.println(jp.getArgs()); + System.err.println(jp.getParameterNames()); +} +.... + +Some of the method names of `JoinPoint` have been reorganized, as well. + +==== [#1.0a1-introduction-and-static]#Introduction and static crosscutting# + +===== [#1.0a1-plus-implements-extends]#Removing +implements and +extends# + +The keywords `+implements` and `+extends` no longer exist. Instead, +AspectJ uses the `declare` form for exactly the same functionality. + +.... +Point +implements Serializable; +=> +declare parents: Point implements Serializable; +.... + +.... +MyButton +extends ButtonAdaptor; +=> +declare parents: MyButton extends ButtonAdaptor; +.... + +===== [#1.0a1-now-use-soft]#Using declare soft# + +Around advice advice no longer effects the static exception checking of +Java. This means that the following code previously compiled: + +.... +class C { + void noExceptionDeclared() { + exceptionDeclared(); + } + void exceptionDeclared() throws IOException {} +} +aspect A { + around(): call(void C.exceptionDeclared()) { + try { proceed(); } + catch (IOException e) {} + } +} +.... + +even though the class C is not compilable on its own (because +noExceptionDeclared actually throws an Exception). + +AspectJ now firmly places everything that affects the type system of +Java, including the declared-exception checking system, into the space +of introduction and declare. So, in order to state that the call to +exceptionDeclared() will not, actually, throw an exception, we now +"soften" that exception, that is, take it out of the space of declared +exceptions. + +.... +declare soft: ExceptionType: Pointcut; +.... + +The pointcuts allowed here are limited; you cannot use pointcuts that +would require runtime information. But picking out method calls is just +fine. So in order to make the above example work, one new declaration is +needed: + +.... +declare soft: IOException: + call(void C.exceptionDeclared()) && + withincode(void noExceptionDeclared()); +.... + +==== [#1.0a1-aspects]#Aspects# + +The syntax of "of each" modifiers has changed. For `of eachcflow` and +`of eachcflowbelow`, you can simply replace "of each" with "per". So, + +.... +aspect A of eachcflow(...) { ... } +==> +aspect A percflow(...) { ... } +.... + +If you have any aspects defined `of eachJVM()`, then you should either +remove that declaration entirely (because this is the default +behaviour), or replace the `of eachJVM()` declaration with an +`issingleton` declaration. + +.... +aspect of eachJVM() { ... } +==> +aspect A { ... } +or +aspect A issingleton { ... } +.... + +The `of eachobject(Pointcut)` modifier has been split into two different +forms, `of perthis(Pointcut)` and `of pertarget(Pointcut)`. Which one +you replace with depends on the `Pointcut` you use. + +If you use a pointcut that picked out reception join points, then use +`pertarget`, and rewrite the pointcut to pick out call join points. So + +.... +aspect Shadow + of eachobject(receptions(void Point.setX(int)) || + receptions(void Point.setY(int))) { + ... +} +==> +aspect Shadow pertarget(call(void Point.setX(int)) || + call(void Point.setY(int))) { + ... +} +.... + +Otherwise, in most cases, use `perthis`. When you convert, remember the +meaning of each of these modifiers. `perthis(Pointcut)` indicates that +an instance of the aspect should be associated with every object that is +`this` at each of the join points picked out by `Pointcut`, while +`pertarget(Pointcut)` associates with every object that is the target +object at such join points. + +''''' + +=== [#pre08b3]#Porting pre-0.8beta3 code# + +* xref:#cflowTerminology[Changing cflow terminology] +* xref:#abstractPointcuts[Overriding abstract pointcuts] +* xref:#recursiveAdvice[Limiting recursive advice] + +The following changes are only required when porting code written prior +to the 0.8beta3 release of AspectJ. + +==== [#cflowTerminology]#Changing cflow terminology# + +Changing pre-0.8beta3 code that uses AspectJ's control-flow-based +features only requires rewriting occurrences of `eachcflowroot`, +`cflow`, and `cflowtop`. No editing of other aspect code is necessary. + +===== eachcflowroot + +The aspect modifier "`of eachcflowroot(Pointcut)`" should now be written +more as "`percflow(Pointcut)`". + +===== cflow + +In previous versions of AspectJ, the pointcut `cflow(Pointcut)` picked +out all join points in the cflow below the join points of `Pointcut`. +That is, it did not include the join points of `Pointcut`, only the join +points in their control flow. + +As of version 0.8beta3, `cflowbelow(Pointcut)` has that behavior. +`cflow(Pointcut)` includes the join points of `Pointcut`. + +In many cases, you may not care whether the points of `Pointcut` are +included or not, and so can safely leave `cflow(Pointcut)` pointcut +designators alone. However, if you use the idiom + +[source,codeindent] +---- +Pointcut && ! cflow(Pointcut) +---- + +to capture the non-recursive entries to a particular pointcut, you will +definitely want to rewrite that as + +[source,codeindent] +---- +Pointcut && ! cflowbelow(Pointcut) +---- + +===== cflowtop + +The primitive pointcut designator `cflowtop(Pointcut)` has been removed +from the language, as it is expressible with `cflow` or `cflowbelow`. +All uses of `cflowtop(Pointcut)` can be rewritten as: + +[source,codeindent] +---- +cflowbelow(Pointcut && ! cflowbelow(Pointcut)) +---- + +Though in most cases the following is sufficient + +[source,codeindent] +---- +cflow(Pointcut && ! cflowbelow(Pointcut)) +---- + +==== [#abstractPointcuts]#Overriding abstract pointcuts# + +In previous versions of AspectJ, a concrete aspect would implicitly +override all of its abstract pointcuts with an empty pointcut. AspectJ +0.8beta3 enforces the restriction that a concrete aspect may not have +any abstract pointcuts. Thus the following extension: + +[source,codeindent] +---- +abstract aspect A { + abstract pointcut pc(); +} + +aspect B {} +---- + +will no longer compile. + +Adding the new empty pointcut designator + +[source,codeindent] +---- +pointcut Id(); +---- + +in the declaration of the concrete aspect fixes this problem. + +[source,codeindent] +---- +abstract aspect A { + abstract pointcut pc(); +} + +aspect B { + pointcut pc(); +} +---- + +==== [#recursiveAdvice]#Limiting recursive advice# + +Previously, the compiler silently refrained from applying a piece of +advice to join points within its own advice body. So, for example, in + +[source,codeindent] +---- +class C { + static int i; +} + +aspect A { + before(): gets(int C.i) { + System.err.println("C.i was " + C.i) + } +} +---- + +The advice would trace all references of the static field `C.i` except +those in the body of the before. + +The compiler has now removed this special case, and so running the above +example will now cause a `StackOverflowException` to be thrown. + +Most cases of this error can be fixed by correctly specifying the +desired pointcut: In the above example, the intention is clearly not to +trace _all_ references of `C.i`, just those outside the aspect. + +[source,codeindent] +---- +class C { + static int i; +} + +aspect A { + before(): get(int C.i) && ! within(A) { + System.err.println("C.i was " + C.i) + } +} +---- + +In a very few cases, you may want the advice to be applicable to other +code in the aspect, but not in the particular piece of advice. In such +cases, you can pull the body of the advice into a method and restrict +away from that method (and away from calls to that method): + +[source,codeindent] +---- +class C { + static int i; +} + +aspect A { + public static int getCi() { + return C.i; // will be traced + } + + before(): get(int C.i) && + ! withincode(void A.traceCi()) + ! call(void A.traceCi()) { + traceCi(); + } + private void traceCi() { + System.err.println("C.i was " + C.i) // will not be traced + } +} +---- + +''''' + +=== [#pre08b1]#Porting pre-0.8beta1 code# + +* xref:#introSyntax[Rewriting introductions] +* xref:#staticAdvice[Removing static advice] +* xref:#aspect-aspect[Fixing aspect-aspect inheritance] +* xref:#usingPrivateIntroduction[Using private introduction] + +The following changes are only required when porting code written prior +to the 0.8beta1 release of AspectJ. + +==== [#introSyntax]#Rewriting introductions# + +===== Syntax + +The syntax of introduction has changed. Porting most programs should +require some simple editing. Anywhere you have an introduction block + +[source,codeindent] +---- +introduction GTN { + ... +} +---- + +simply move the `GTN` down into the introduction declarations and remove +the block. + +For method introduction, place the `GTN` in front of the method name, +For field introduction, place the `GTN` in front of the field name, and +for constructor introduction, place the `GTN` in front of the `new` +identifier. + +[source,codeindent] +---- +introduction Foo { + public void doStuff() { this.doStuffLater(); } + public int calorieCount = 3; + public new(int x) { super(); calorieCount = x; } +} + +==> + +public void Foo.doStuff() { this.doStuffLater(); } +public int Foo.calorieCount= 3; +public Foo.new(int x) { super(); calorieCount = x; } +---- + +For implements and extends introduction, move the `GTN` in front of the +new identifiers `implements` or `extends`, and place that in a +`declare parents` form. + +[source,codeindent] +---- +introduction Foo { + implements Comparable; + extends Goo; +} + +==> + +declare parents: Foo implements Comparable; +declare parents: Foo extends Goo; +---- + +In all cases, if the `GTN` is just a type name, it can be moved down on +its own. However, if the `GTN` uses any of `&&`, `||`, and `!`, it must +be parenthesized. + +[source,codeindent] +---- +introduction subtypes(Foo) && !Goo { + int x; +} + +==> + +int (Foo+ && !Goo).x; +---- + +===== Access + +If you had an introduction that was referring to private or protected +members of the target class, this will no longer work. You will either +need to modify your code to avoid this accessibility issue, or you will +need to use the `privileged` modifier on the aspect that contains the +introduction. + +[source,codeindent] +---- +class Counter { + private int count = 2; +} + +aspect ExposeCountersPrivates { + introduction Counter { + public int getCount() { return count; } + } +} + +==> +// in 0.8, only privileged aspects can expose a class's privates +privileged aspect ExposeCountersPrivates { + public int Counter.getCount() { return count; } +} +---- + +If you have introduced private or package-protected members, you will +probably have to re-write some code. Most previous uses of introducing +privates can be improved by using private introduction instead. + +[source,codeindent] +---- +class C { +} + +aspect AddCounter { + introduction C { + private int count; + public int getCount() { return count; } + } +} + +==> +aspect AddCounter { + private int Counter.count; + public int Counter.getCount() { return count; } +} +---- + +There is one case that we know of where the inability to perform the +introduction of private members makes 0.7 code difficult to port to 0.8. +If you were using the introduction of a `private void writeObject(..)` +or a `private void readObject(..)` method to interact with Java's +serialization API, you will need to come up with an alternative design. +Using some combination of `Externalizable`, `writeReplace(..)` and/or +`readResolve(..)` methods should allow you to port your code. If you +find this isn't the case, we'd like to hear about it. + +If you were introducing either a protected member or a package-private +member onto a class in order to override a protected member that was +inherited from a superclass, you will have to make this introduction +public. + +==== [#staticAdvice]#Removing static advice# + +Static advice has been removed from the language. Now, every piece of +advice is non-static, meaning that it will run in the context of an +aspect instance. + +If you have an aspect that only contains static advice, has no "of" +clause or is declared "of eachJVM()", and is not extended by another +aspect, simply remove the keyword "static" from all pieces of advice, +and make sure the aspect is not defined with the "abstract" modifier. + +[source,codeindent] +---- +aspect Tracing { + static before(): executions(* *(..)) { + System.out.println("Got Here! " + thisJoinPoint); + } +} + +==> + +aspect Tracing { + before(): execution(* *(..)) { + System.out.println("Got Here! " + thisJoinPoint); + } +} +---- + +Otherwise, if you have an aspect contains both static and non-static +advice, is extended, or is "of eachObject(...)" or "of +eachcflowroot(...)", you should group your static advice together and +put it in a new aspect, possibly even an inner aspect. + +[source,codeindent] +---- +aspect ComplexTracing of eachobject(cflow(executions(void Main.main(..)))) { + static before(): executions(* *(..)) { + System.out.println("Got Here! " + thisJoinPoint); + } + static after(): executions(* *(..)) { + System.out.println("Returned! " + thisJoinPoint); + } + + // some other dynamic advice, fields, etc +} + +==> + +aspect ComplexTracing of eachobject(cflow(executions(void Main.main(..)))) { + static aspect AlwaysTracing { + before(): execution(* *(..)) { + System.out.println("Got Here! " + thisJoinPoint); + } + after(): execution(* *(..)) { + System.out.println("Returned! " + thisJoinPoint); + } + } + + // some other dynamic advice, fields, etc +} +---- + +==== [#aspect-aspect]#Fixing aspect-aspect inheritance# + +Aspects can now only extend abstract aspects. This restriction may cause +some redesign of aspect hierarchies. You will probably find that for the +majority of your code the most serious change this requires is to add an +explicit `abstract` modifier to a super-aspect that was already +implicitly abstract. + +[source,codeindent] +---- +aspect BaseTracing { + abstract pointcut traced(); + before(): traced() { + System.out.println("Got Here! " + thisJoinPoint); + } +} + +==> + +// make this abstract aspect explicitly abstract +abstract aspect BaseTracing { + ... +} +---- + +This change has also affected the `getAspect` static method. Now, +`getAspect` is only defined on non-abstract aspects. Previously, you +could call `getAspect` on an abstract superaspect and (sometimes) get an +instance of a subaspect back. + +This pattern was used in the Spacewar example in the AspectJ +distribution. We had the class hierarchy + +.... + SpaceObject (abstract) + |- Ship + |- Bullet + |- EnergyPellet +.... + +And the aspect hierarchy + +.... + SpaceObjectDA (abstract) + |- ShipDA of eachobject(instanceof(Ship)) + |- BulletDA of eachobject(instanceof(Ship)) + |- EnergyPacketDA of eachobject(instanceof(Ship)) +.... + +And we would call `SpaceObjectDA.getAspect(SpaceObject)` to access the +aspect associated with a ship, bullet, or energy pellet. This pattern +depended on the `SpaceObjectDA` aspect hierarchy exactly mirroring the +`SpaceObject` hierarchy, and being maintained that way. + +A better way to implement this kind of design aspect is to use private +introduction, a new feature of AspectJ. + +==== [#usingPrivateIntroduction]#Using private introduction# + +A common pattern for AspectJ programs that need to associate some state +with every object of a particular type has been to use aspects that are +defined `of eachobject(instanceof(...))`. A prime example of this was +the `BoundPoint` aspect of the bean example: which needed to associate +each point with a `PropertyChangeSupport` object. + +[source,codeindent] +---- +aspect BoundPoint of eachobject(instanceof(Point)) { + + java.beans.PropertyChangeSupport support = null; + + after() returning(Point p): receptions(p.new(..)){ + support = new PropertyChangeSupport(myPoint); + } + + around(Point p) returns void: receptions(void p.set*(*)) { + // code that uses support + } +} +---- + +In the new version of AspectJ, a better way of accomplishing many of +these state association is to use privately introduced fields. Instead +of creating an aspect instance for every `Point` object, store the +`PropertyChagneSupport` object in the `Point` objects themselves. + +[source,codeindent] +---- +aspect BoundPoint { + private PropertyChangeSupport Point.support = new PropertyChangeSupport(this); + + void around(Point p): setters(p) { + // code that uses p.support + } +} +---- + +Just as in the past, the PropertyChangeSupport object is not accessable +to anyone but the aspect, but now less mechanism is needed. + +There are times when changing aspects that are defined +`of eachobject(instanceof(...))` may not be reasonable. If the aspect +instance is stored or passed to other methods, then having a real +`of eachobject(instanceof(...))`, now written `perthis(this(...))`, +association may capture the crosscutting concern best. + +''''' + +=== [#pre07b11]#Porting pre-0.7beta11 code# + +* xref:#twoArgumentCalls[Removing two-argument calls] +* xref:#adviceInClasses[Removing advice from Class declarations] + +The following changes are only required when porting code written prior +to the 0.7beta11 release of AspectJ. + +==== [#twoArgumentCalls]#Removing two-argument calls# + +In AspectJ 0.7beta11, the two-argument `calls` primitive pointcut +designator was deprecated. Removing these designators will require +different cases depending on what the original pointcut did. + +===== Calls to static methods + +For pointcuts denoting calls to particular static methods, such as + +____ +.... +calls(String, static String valueOf(int)) // deprecated +.... +____ + +the transformation is easy. Simply make the desired signature explicit. +Instead of catching all calls to any static method that happens to have +the signature `String valueOf(int)`, catch calls to that exact method +defined in the String class. + +____ +.... +call(static String String.valueOf(int)) +.... +____ + +Pointcuts denoting calls to classes of static methods can also be +rewritten with these rules. For example, + +____ +.... +calls(my.package.*, static * get*(..)) // deprecated +.... +____ + +should now be written + +____ +.... +call(static * my.package.*.get*(..)) +.... +____ + +===== Calls to non-static methods + +Many pointcuts denoting calls to non-static methods can be fixed the +same way that those pointcuts denoting calls to static methods are +fixed. So, + +____ +.... +calls(Thread, int getPriority()) // deprecated +.... +____ + +which denotes all calls to nullary int methods named `getPriority` when +the called object is an instance of the `Thread` type, can almost always +be rewritten + +____ +.... +call(int Thread.getPriority()) +.... +____ + +which denotes all calls to the nullary int `Thread.getPriority()` +method. + +Expanding the signature picks out slightly different join points than +the original two-argument form. This won't matter for most programs, but +in some cases the differences may be noticable. In particular, the +expanded-signature form only picks out those calls where the called +object is statically typed to `Thread` when its `int getPriority()` +method is called. If you want to capture calls to the +`int Thread.getPriority()` method, regardless of how the called object +is statically typed, you shoud use the different translation: + +____ +.... +call(int getPriority()) && target(Thread) +.... +____ + +This will capture all call join points of methods with signature +`int Thread.getPriority()`. + +It will also denote any join points if the Thread type does not define +(possibly abstractly) some `int getPriority()` method, though. + +==== [#adviceInClasses]#Removing advice from Class declarations# + +The simplest way to remove an advice declaration from a class is to +simply define the advice declaration in an inner aspect. So, instead of + +____ +.... +class C { + static before(): executions(C.new()) { ... } // deprecated +} +.... +____ + +write + +____ +.... +class C { + static aspect ConstructionProtocol { + static before(): executions(C.new()) { ... } + } +} +.... +____ + +If your advice doesn't refer to any inner classes or interfaces of C, +you can move the inner aspect out of the class entirely. + +____ +.... +class C { ... } + +aspect ConstructionProtocol { + static before(): execution(C.new()) { ... } +} +.... +____ + +Your code will be clearer if you consider the purpose of each piece of +advice when you make this change. It may be that some of the advice +naturally belongs to another aspect, perhaps already existing. Or it may +be that some pieces of advice in a class are associated to one concern +and some to another; in which case more than aspect would be +appropriate. + +''''' + +=== [#pre07b10]#Porting pre-0.7beta10 code# + +* xref:#joinPoints[Changing access to thisJoinPoint] + +The following changes are only required when porting code written prior +to the 0.7beta10 release of AspectJ. + +==== [#joinPoints]#Changing access to thisJoinPoint# + +In AspectJ 0.7beta10, access to the reflective object `thisJoinPoint` +substantially changed. The two parts of this change were the elimination +of the `runNext()` static method, and the use of an interface hierarchy +represent the join point object. + +===== [#proceed]#`thisJoinPoint.runNext()` to `proceed()`# + +The elimination of the `runNext()` static method requires almost no +porting work. An automatic replacement of the string + +____ +`thisJoinPoint.runNext` +____ + +with the string + +____ +`proceed` +____ + +will do the job. However, if any around advice used the identifier +"`proceed`" as a formal parameter or local variable, it must be renamed, +and if any aspect used it as a field, then references to the field in +around advice should be made explicit (prefixing the reference with the +aspect name or "`this`", depending on whether the field is static or +not). + +===== [#thisJoinPoint]#Using `thisJoinPoint`# + +While access to reflective information through `thisJoinPoint` is more +powerful and regular through its interface hierarchy, the previous uses +must be rewritten. Changing your code will likely require manual +editing, but in doing so your code should get simpler and cleaner. + +Many existing uses of the fields on join points can be re-written to use +one of: + +* `thisJoinPoint.toString()` +* `thisJoinPoint.toShortString()` +* `thisJoinPoint.toLongString()` +* `thisJoinPoint.getSignature().toString()` +* `thisJoinPoint.getSignature().toShortString()` +* `thisJoinPoint.getSignature().toLongString()` + +For example: + +____ +.... +System.out.println(thisJoinPoint.className + "." + + thisJoinPoint.methodName) +.... +____ + +can be replaced with + +____ +`System.out.println(thisJoinPoint)` +____ + +or + +____ +`System.out.println(thisJoinPoint.getSignature().toShortString())` +____ + +with comparable behavior. + +Accesses to the parameters field of join points should be changed as +follows. A field access like: + +____ +`thisJoinPoint.parameters` +____ + +must be changed to: + +* `thisJoinPoint.getArgs()` + +Accesses to the methodName and className fields of join points that are +not suitable for replacement with a toString method, should be changed +as follows. Field accesses like: + +* `thisJoinPoint.className` +* `thisJoinPoint.methodName` + +must be changed to: + +* `thisJoinPoint.getSignature().getDeclaringType().getName()` +* `thisJoinPoint.getSignature().getName()` + +Accessses to the parameterNames and parameterTypes fields of join +points, that are not suitable for conversion to one of the toString() +methods should be changed as follows. Field access like: + +* `thisJoinPoint.parameterNames` +* `thisJoinPoint.parameterTypes` + +must be changed to: + +* `((CodeSignature)thisJoinPoint.getSignature()).getParameterNames()` +* `((CodeSignature)thisJoinPoint.getSignature()).getParameterTypes()` diff --git a/docs/faq/faq.adoc b/docs/faq/faq.adoc new file mode 100644 index 000000000..288870f40 --- /dev/null +++ b/docs/faq/faq.adoc @@ -0,0 +1,3455 @@ += AspectJ FAQ + +_Copyright (c) 1997-2001 Xerox Corporation, 2002 Palo Alto Research +Center, Incorporated, 2003-2006 Contributors. All rights reserved._ + +_Last updated November 3, 2006_ + +For a list of recently-updated FAQ entries, see #q:faqchanges[Q:What has +changed since the last FAQ version?] + +== Overview + +*Q:* What is AspectJ? + +*A:* AspectJ(tm) is a simple and practical extension to the Java(tm) +programming language that adds to Java aspect-oriented programming (AOP) +capabilities. AOP allows developers to reap the benefits of modularity +for concerns that cut across the natural units of modularity. In +object-oriented programs like Java, the natural unit of modularity is +the class. In AspectJ, aspects modularize concerns that affect more than +one class. + +You compile your program using the AspectJ compiler (perhaps using the +supported development environments) and then run it, supplying a small +(< 100K) runtime library. + +The AspectJ technologies include a compiler (`ajc`), a debugger +(`ajdb`), a documentation generator (`ajdoc`), a program structure +browser (`ajbrowser`), and integration with Eclipse, Sun-ONE/Netbeans, +GNU Emacs/XEmacs, JBuilder, and Ant. + +*Q:* What are the benefits of using AspectJ? + +*A:* AspectJ can be used to improve the modularity of software systems. + +Using ordinary Java, it can be difficult to modularize design concerns +such as + +* system-wide error-handling +* contract enforcement +* distribution concerns +* feature variations +* context-sensitive behavior +* persistence +* testing + +The code for these concerns tends to be spread out across the system. +Because these concerns won't stay inside of any one module boundary, we +say that they _crosscut_ the system's modularity. + +AspectJ adds constructs to Java that enable the modular implementation +of crosscutting concerns. This ability is particularly valuable because +crosscutting concerns tend to be both complex and poorly localized, +making them hard to deal with. + +*Q:* Can AspectJ work with any Java program? + +*A:* AspectJ has been designed as a _compatible_ extension to Java. By +compatible, we mean + +[cols=",",] +|=== +|_upward compatible_ |All legal Java programs are legal AspectJ +programs. + +|_platform compatible_ |All legal AspectJ programs run on standard Java +virtual machines. + +|_tool compatible_ |Existing tools can be extended to work with AspectJ. + +|_programmer compatible_ |Programming in AspectJ feels natural to Java +programmers. +|=== + +The AspectJ tools run on any Java 2 Platform compatible platform. The +AspectJ compiler produces classes that run on any Java 1.1 (or later) +compatible platform. + +*Q:* How is AspectJ licensed? + +*A:* Since AspectJ 1.9.7, source code and documentation is available +under the +https://www.eclipse.org/org/documents/epl-2.0/EPL-2.0.txt[Eclipse Public +License v 2.0]. + +AspectJ 1.5.2 through 1.9.6 source code and documentation is available +under the http://www.eclipse.org/org/documents/epl-v10.php[Eclipse +Public License v 1.0]. + +AspectJ 1.1 through 1.5.1 source code and documentation is available +under the http://eclipse.org/legal/cpl-v10.html[Common Public License +1.0]. + +The AspectJ 1.0 tools are open-source software available under the +http://www.opensource.org/licenses/mozilla1.1[Mozilla Public License +1.1]. That documentation is available under a separate license that +precludes for-profit or commercial redistribution. + +The runtime jar aspectjrt.jar and its distribution are also covered by +the https://www.eclipse.org/org/documents/epl-2.0/EPL-2.0.txt[Eclipse +Public License]. + +For answers to common licensing questions, see the +http://www.eclipse.org/legal/eplfaq.php[Eclipse Public License FAQ]. + +*Q:* What is the AspectJ Project? + +*A:* AspectJ is based on over ten years of research at +http://www.parc.xerox.com[Xerox Palo Alto Research Center] as funded by +Xerox, a U.S. Government grant (NISTATP), and a DARPA contract. + +It has evolved through open-source releases to a strong user community +and now operates as an open source project at http://eclipse.org/aspectj +The AspectJ team works closely with the community to ensure AspectJ +continues to evolve as an effective aspect-oriented programming language +and tool set. + +The latest release is 1.2 which can be downloaded from the +http://eclipse.org/aspectj[AspectJ project page], including sources as +described #q:buildingsource[Q:How do I get and compile the source code +for AspectJ?]. Development is focused on supporting applications, +improving quality and performance, enhancing integration with IDE's, and +building the next generations of the language. + +[[quickstart]] +== Quick Start + +*Q:* What Java versions does AspectJ require and support? + +*A:* The AspectJ compiler produces programs for any released version of +the Java platform (jdk1.1 and later). When running, your program classes +must be able to reach classes in the small (< 100K) runtime library +(aspectjrt.jar) from the distribution. The tools themselves require J2SE +1.3 or later to run, but the compiler can produce classes for any +1.1-compliant version of the Java platform. + +*Q:* How do I download and install AspectJ? + +*A:* From AspectJ's http://eclipse.org/aspectj[web page] , download the +AspectJ distribution. The `jar` file is installed by executing + +.... +java -jar jar file name + +.... + +Do *not* try to extract the `jar` file contents and then attempt to +execute `java org.aspectj.tools.Main`. (A `NoClassDefFoundError` +exception will be thrown.) The AspectJ distribution is not designed to +be installed this way. Use the `java -jar` form shown above. + +To uninstall, remove the files the installer wrote in your file system. +In most cases, you can delete the top-level install directory (and all +contained files), after you remove any new or updated files you want to +keep. On Windows, no registry settings were added or changed, so nothing +needs to be undone. Do not install over prior versions, which might have +different files. Delete the prior version first. + +*Q:* How should I start using AspectJ? + +*A:* Many users adopt AspectJ in stages, first using it to understand +and validate their systems (relying on it only in development) and then +using it to implement crosscutting concerns in production systems. +AspectJ has been designed to make each step discrete and beneficial. + +In order of increasing reliance, you may use AspectJ: + +* *In the development process* Use AspectJ to trace or log interesting +information. You can do this by adding simple AspectJ code that performs +logging or tracing. This kind of addition may be removed ("unplugged") +for the final build since it does not implement a design requirement; +the functionality of the system is unaffected by the aspect. +* *As an ancillary part of your system* Use AspectJ to more completely +and accurately test the system. Add sophisticated code that can check +contracts, provide debugging support, or implement test strategies. Like +pure development aspects, this code may also be unplugged from +production builds. However, the same code can often be helpful in +diagnosing failures in deployed production systems, so you may design +the functionality to be deployed but disabled, and enable it when +debugging. +* *As an essential part of your system* Use AspectJ to modularize +crosscutting concerns in your system by design. This uses AspectJ to +implement logic integral to a system and is delivered in production +builds. + +This adoption sequence works well in practice and has been followed by +many projects. + +*Q:* How does AspectJ integrate with existing Java development tools? + +*A:* AspectJ products are designed to make it easy to integrate AspectJ +into an existing development process. Each release includes Ant tasks +for building programs, the AspectJ Development Environment (AJDE) for +writing aspects inside popular IDE's, and command-line tools for +compiling and documenting Java and AspectJ code. + +AspectJ provides replacements for standard Java tools: + +* `ajc`, the AspectJ compiler, runs on any Java 2 compatible platform, +and produces classes that run on any Java 1.1 (or later) compatible +platform. +* `ajdoc` produces API documentation like javadoc, with additional +crosscutting links. For example, it shows advice affecting a particular +method or all code affected by a given aspect. At present, `ajdoc` is +only supported in AspectJ 1.0. + +For debugging, AspectJ supports JSR-45, which provides a mechanism for +debugging .class files that have multiple source files. Debugger clients +and VM's are beginning to support this; see Sun's J2SE 1.4.1 VM and jdb +debugger and recent versions of JBuilder. + +The AspectJ Development Environment (AJDE) enables programmers to view +and navigate the crosscutting structures in their programs, integrated +with existing support in popular Java IDE's for viewing and navigating +object-oriented structures. For many programmers this provides a deeper +understanding of how aspects work to modularize their concerns and +permits them to extend some of their development practices without +having to abandon their existing tools. + +AJDE is a set of API's providing the basis for the following development +tool integrations: + +* Eclipse (version 2.0) in the Eclipse AspectJ Development Tools project +http://eclipse.org/ajdt +* Emacs (GNU version 20.3) and XEmacs (version 21.1 on Unix and 21.4 on +Windows), in the SourceForge AspectJ for Emacs project +http://aspectj4emacs.sourceforge.net +* JBuilder (versions 4 through 7) from Borland in the SourceForge +AspectJ for JBuilder project http://aspectj4jbuildr.sourceforge.net +* Netbeans up to 3.4 (and Sun Microsystems' Forte for Java (versions 2 +and 3), Sun/One) in the SourceForge AspectJ for NetBeans project +http://aspectj4netbean.sourceforge.net + +The common functionality of AJDE is also available in the stand-alone +source code browser `ajbrowser`, included in the tools distribution. + +Finally, as mentioned above, AspectJ also supports building with Ant by +providing task interfaces to the ajc and ajdoc tools. + +[[typicalprograms]] +== Typical AspectJ programs + +*Q:* Are aspects always optional or non-functional parts of a program? + +*A:* No. Although AspectJ can be used in a way that allows AspectJ code +to be removed for the final build, aspect-oriented code is not _always_ +optional or non-functional. Consider what AOP really does: it makes the +modules in a program correspond to modules in the design. In any given +design, some modules are optional, and some are not. + +The examples directory included in the AspectJ distribution contains +some examples of the use aspects that are not optional. Without aspects, + +[cols=",",] +|=== +|*bean* |Point objects would not be JavaBeans. +|*introduction* |Point objects would not be cloneable, comparable or +serializable. +|*spacewar* |Nothing would be displayed. +|*telecom* |No calls would be billed. +|=== + +*Q:* What is the difference between development and production aspects? + +*A:* Production aspects are delivered with the finished product, while +development aspects are used during the development process. Often +production aspects are also used during development. + +*Q:* What are some common development aspects? + +*A:* Aspects for logging, tracing, debugging, profiling or performance +monitoring, or testing. + +*Q:* What are some common production aspects? + +*A:* Aspects for performance monitoring and diagnostic systems, display +updating or notifications generally, security, context passing, and +error handling. + +[[concepts]] +== Basic AOP and AspectJ Concepts + +*Q:* What are scattering, tangling, and crosscutting? + +*A:* "Scattering" is when similar code is distributed throughout many +program modules. This differs from a component being used by many other +components since it involves the risk of misuse at each point and of +inconsistencies across all points. Changes to the implementation may +require finding and editing all affected code. + +"Tangling" is when two or more concerns are implemented in the same body +of code or component, making it more difficult to understand. Changes to +one implementation may cause unintended changes to other tangled +concerns. + +"Crosscutting" is how to characterize a concern than spans multiple +units of OO modularity - classes and objects. Crosscutting concerns +resist modularization using normal OO constructs, but aspect-oriented +programs can modularize crosscutting concerns. + +*Q:* What are join points? + +*A:* Join points are well-defined points in the execution of a program. +Not every execution point is a join point: only those points that can be +used in a disciplined and principled manner are. So, in AspectJ, the +execution of a method call is a join point, but "the execution of the +expression at line 37 in file Foo.java" is not. + +The rationale for restricting join points is similar to the rationale +for restricting access to memory (pointers) or restricting control flow +expressions (`goto`) in Java: programs are easier to understand, +maintain and extend without the full power of the feature. + +AspectJ join points include reading or writing a field; calling or +executing an exception handler, method or constructor. + +*Q:* What is a pointcut? + +*A:* A pointcut picks out #q:joinpoints[ join points ]. These join +points are described by the pointcut declaration. Pointcuts can be +defined in classes or in aspects, and can be named or be anonymous. + +*Q:* What is advice? + +*A:* Advice is code that executes at each #q:joinpoints[join point] +picked out by a #q:pointcut[pointcut]. There are three kinds of advice: +before advice, around advice and after advice. As their names suggest, +before advice runs before the join point executes; around advice +executes before and after the join point; and after advice executes +after the join point. The power of advice comes from the advice being +able to access values in the execution context of a pointcut. + +*Q:* What are inter-type declarations? + +*A:* AspectJ enables you to declare members and supertypes of another +class in an aspect, subject to Java's type-safety and access rules. +These are visible to other classes only if you declare them as +accessible. You can also declare compile-time errors and warnings based +on pointcuts. + +*Q:* What is an aspect? + +*A:* Aspects are a new class-like language element that has been added +to Java by AspectJ. Aspects are how developers encapsulate concerns that +cut across classes, the natural unit of modularity in Java. + +Aspects are similar to classes because... + +* aspects have type +* aspects can extend classes and other aspects +* aspects can be abstract or concrete +* non-abstract aspects can be instantiated +* aspects can have static and non-static state and behavior +* aspects can have fields, methods, and types as members +* the members of non-privileged aspects follow the same accessibility +rules as those of classes + +Aspects are different than classes because... + +* aspects can additionally include as members pointcuts, advice, and +inter-type declarations; +* aspects can be qualified by specifying the context in which the +non-static state is available +* aspects can't be used interchangeably with classes +* aspects don't have constructors or finalizers, and they cannot be +created with the new operator; they are automatically available as +needed. +* privileged aspects can access private members of other types + +[[whyaop]] +== Why AOP? + +*Q:* Are crosscutting concerns induced by flaws in parts of the system +design, programming language, operating system, etc. Or is there +something more fundamental going on? + +*A:* AOP's fundamental assumption is that in any sufficiently complex +system, there will inherently be some crosscutting concerns. + +So, while there are some cases where you could re-factor a system to +make a concern no longer be crosscutting, the AOP idea is that there are +many cases where that is not possible, or where doing so would damage +the code in other ways. + +*Q:* Does it really make sense to define aspects in terms of +crosscutting? + +*A:* Yes. + +The short summary is that it is right to define AOP in terms of +crosscutting, because well-written AOP programs have clear crosscutting +structure. It would be a mistake to define AOP in terms of "cleaning up +tangling and scattering", because that isn't particular to AOP, and past +programming language innovations also do that, as will future +developments. + +(Slides for a long talk on this topic were once available at +http://www.cs.ubc.ca/~gregor/vinst-2-17-01.zip.) + +*Q:* Is AOP restricted to domain-specific applications? + +*A:* No. Some implementations of AOP are domain-specific, but AspectJ +was specifically designed to be general-purpose. + +*Q:* Why do I need AOP if I can use interceptors (or JVMPI or ref +lection)? + +*A:* There are many mechanisms people use now to implement some +crosscutting concerns. But they don't have a way to express the actual +structure of the program so you (and your tools) can reason about it. +Using a language enables you to express the crosscutting in first-class +constructs. You can not only avoid the maintenance problems and +structural requirements of some other mechanisms, but also combine forms +of crosscutting so that all the mechanisms for a particular concern are +one piece of code. + +[[related]] +== Related Technology + +*Q:* How does AspectJ compare to other new forms of programming? + +*A:* There are many recent proposals for programming languages that +provide control over crosscutting concerns. Aspect-oriented programming +is an overall framework into which many of these approaches fit. AspectJ +is one particular instance of AOP, distinguished by the fact that it was +designed from the ground up to be compatible with Java. + +For more alternatives for aspect-oriented programming, see +http://aosd.net. + +*Q:* How do you compare the features of AspectJ with reflective systems? + +*A:* Reflective and aspect-oriented languages have an important +similarity: both provide programming support for dealing with +crosscutting concerns. In this sense reflective systems proved that +independent programming of crosscutting concerns is possible. + +But the control that reflection provides tends to be low-level and +extremely powerful. In contrast, AspectJ provides more carefully +controlled power, drawing on the rules learned from object-oriented +development to encourage a clean and understandable program structure. + +*Q:* How do AspectJ features compare with those of mixin-based +inheritance? + +*A:* Some features of AspectJ, such as introduction, are related to +_mixin-based inheritance_. But, in order to support crosscutting, a core +goal for AspectJ, AspectJ goes beyond mixin-based inheritance. + +Firstly, an aspect imposes behavior on a class, rather than a class +requesting behavior from an aspect. An aspect can modify a class without +needing to edit that class. This property is sometimes called _reverse +inheritance_. + +Secondly, a single aspect can affect multiple classes in different ways. +A single paint aspect can add different paint methods to all the classes +that know how to paint, unlike mixin classes. + +So mixin-based inheritance doesn't have the reverse inheritance +property, and mixins affect every class that mixes them in the same. If +I want to do something like SubjectObserverProtocol, I need two mixins, +SubjectPartofSubjectObserverProtocol and ObserverPartof... In AspectJ, +both halves of the protocol can be captured in a single aspect. + +*Q:* How does AspectJ compare with more dynamic AOP? + +*A:* Some AOP techniques are presented as "dynamic" because the weaving +occurs when classes are loaded, because aspects can be configured in a +separate XML file before launch, or because some advice depends on +runtime reflection. They are said to be more flexible than AspectJ. + +This is a misconception. First, the AspectJ 1.1 weaver has always +supported weaving at compile-time or class-load-time. Weaving at +compile-time reduces application launch and running time, and it helps +IDE's offer support for tracking down weaving errors and understanding +the impact of aspects on a system. On the other hand, weaving at +load-time simplifies build and deployment. Before AspectJ 1.2, the user +had to write a class loader that used the weaver API to weave at load +time; since 1.2, AspectJ comes with a command-line launcher to support +weaving at class-load-time without any other changes to a build +configuration. In AspectJ 5, we expect to get a similar level of support +as AspectWerkz, and to exploit the class bytecode weaving hook available +in Java 5 VM's. + +Second, AspectJ programs, like Java programs generally, can be written +to support any level of XML configuration or to depend on runtime +reflection. There are some benefits to using AspectJ; e.g., the +proceed() form within around advice simplifies a lot of the work that +otherwise would go into writing a generalized interceptor, without +introducing many of the runtime errors that can result from +interceptors. For AspectJ examples of configurable or +reflection-dependent programs, see the sample code linked off the +AspectJ documentation page or the examples discussed on the mailing +list, e.g., +http://dev.eclipse.org/mhonarc/lists/aspectj-users/msg02151.html[Incremental +and runtime weaving support?]. + +*Q:* What is the relationship between AOP and XP (extreme programming +AKA agile methods)? + +*A:* From a question on the user list: + +.... +> Anyone know the connections between AOP and Extreme Programming? +> I am really confused. It seems AOP is a programming paradigm, which +> is the next level of abstraction of OOP. Extreme Programming, however, +> this is a lightweight software development process. One of the common +> motivations of AOP and XP is designed to adopt to the requirement +> changes, so that it can save the cost of software development. + +.... + +This is Raymond Lee's answer: + +You're not really that confused. AOP and XP are orthogonal concepts, +although AOP can be used to help accomplish XP goals. One of the goals +of XP is to respond to changing requirements. Another is to reduce the +overall cost of development. These are not necessarily the same thing. + +One of the principles of XP that contribute to meeting those goals is to +maintain clean, simple designs. One of the criteria for clean, simple +designs is to factor out duplication from the code. Benefits of removing +duplication include the code being easier to understand, better +modularity of the design, lower costs of code changes, less chance of +conflicting changes when practicing collective code ownership, etc. + +Different types of duplication lend themselves to being addressed by +different design paradigms and language features. Duplicate snippets of +code can be factored out into methods. Duplicate methods can be factored +out to common classes, or pushed up to base classes. Duplicate patterns +of methods and their use can be factored out to mechanisms of classes +and methods (i.e. instantiations of design patterns). + +AOP addresses a type of duplication that is very difficult to handle in +the other common paradigms, namely cross-cutting concerns. By factoring +out duplicate cross-cutting code into aspects, the target code becomes +simpler and cleaner, and the cross-cutting code becomes more centralized +and modular. + +So, AOP as a paradigm, and the associated tools, gives an XPer, or +anyone wanting to remove duplication from the code base, a powerful way +to remove a form of duplication not easily addressed until now. + +*Q:* Will you support C#? + +*A:* Not at this time. Although the resemblances between C# and Java +means it would probably be a fairly straightforward matter to take the +AspectJ language design and produce AspectC#, our current focus is only +on supporting effective uses of AspectJ. + +[[adoption]] +== Deciding to adopt AspectJ + +*Q:* Is it safe to use AspectJ in my product plans? + +*A:* You may use AspectJ in your product or project with little risk. +Several factors play a role in reducing the risk of adopting this new +technology: + +* AspectJ is an _addition_ to Java, and can be introduced into a project +in a way that limits risk. See #q:startUsingAJ[Q: How should I start +using AspectJ?] for some suggestions on how to do this. +* The AspectJ compiler accepts standard Java as input and produces +standard Java bytecode as output. In 1.0, an optional mode produces +standard Java source code which may then be compiled with any compliant +Java compiler (e.g. Sun's `javac` compiler or IBM's `jikes` compiler). +In 1.1, an optional mode accepts standard Java bytecode from any +compliant Java compiler and weaves in the aspects to produce new +bytecode. +* AspectJ is available under a non-proprietary, open source license, the +https://www.eclipse.org/org/documents/epl-2.0/EPL-2.0.txt[Eclipse Public +License v 2.0]. AspectJ will continue to evolve and be available, +regardless of the fate of any particular organization involved with +AspectJ. +* Removing AspectJ from your program is not difficult, although you will +lose the flexibility and economy that AspectJ provided. +* A number of significant open-source projects and industry products use +AspectJ successfully. One list is kept on +http://www.aosd.net/wiki/index.php?title=FAQ[the AOSD FAQ], and more +appear on the mailing lists (search for, e.g., "AspectJ in real world", +as described in #q:searchingsite[Q:How can I search the email archives +or the web site?]). + +*Q:* What is the effect of using AspectJ on the source code size of +programs? + +*A:* Using aspects reduces, as a side effect, the number of source lines +in a program. However, the major benefit of using aspects comes from +_improving_ the modularity of a program, not because the program is +smaller. Aspects gather into a module concerns that would otherwise be +scattered across or duplicated in multiple classes. + +*Q:* Does AspectJ add any performance overhead? + +*A:* The issue of performance overhead is an important one. It is also +quite subtle, since knowing what to measure is at least as important as +knowing how to measure it, and neither is always apparent. + +We aim for the performance of our implementation of AspectJ to be on par +with the same functionality hand-coded in Java. Anything significantly +less should be considered a bug. + +There is currently no benchmark suite for AOP languages in general or +for AspectJ in particular. It is probably too early to develop such a +suite because AspectJ needs more maturation of the language and the +coding styles first. Coding styles really drive the development of the +benchmark suites since they suggest what is important to measure. + +Though we cannot show it without a benchmark suite, we believe that code +generated by AspectJ has negligible performance overhead. Inter-type +member and parent introductions should have very little overhead, and +advice should only have some indirection which could be optimized away +by modern VM's. + +The `ajc` compiler will use static typing information to only insert the +advice and dynamic pointcut tests that are absolutely necessary. Unless +you use 'thisJoinPoint' or 'if', the main dynamic checks will be +'instanceof' checks which are generally quite fast. These checks will +only be inserted when they can not be inferred from the static type +information. + +When measuring performance, write AspectJ code fragments and compare +them to the performance of the corresponding code written without +AspectJ. For example, don't compare a method with before/after advice +that grabs a lock to just the method. That would be comparing apples and +oranges. Also be sure to watch out for JIT effects that come from empty +method bodies and the like. Our experience is that they can be quite +misleading in understanding what you've measured. + +*Q:* I've heard that AspectJ leads to modularity violations. Does it? + +*A:* Well I haven't yet seen a language in which you can't write bad +code! + +But seriously, most AspectJ users find that just like when they learned +OO, it takes a while to really get the hang of it. They tend to start in +the usual way, by copying canonical examples and experimenting with +variations on them. + +But users also find that rather than being dangerous, AspectJ helps them +write code that is more clear and has better encapsulation -- once they +understand the kind of modularity AspectJ supports. There are several +good papers that talk about this (see below), but here's a basic point +to keep in mind: when properly used, AspectJ makes it possible program +in a modular way, something that would otherwise be spread throughout +the code. Consider the following code, adapted from the AspectJ +tutorial: + +.... +aspect PublicErrorLogging { + Log log = new Log(); + + pointcut publicInterface(Object o): + call(public * com.xerox.*.*(..)) && target(o); + + after(Object o) throwing (Error e): publicInterface(o) { + log.write(o, e); + } +} + +.... + +The effect of this code is to ensure that whenever any public method of +an interface or class in the `com.xerox` package throws an error, that +error is logged before being thrown to its caller. + +Of course in the alternative implementation a large number of methods +have a try/catch around their body. + +The AspectJ implementation of this crosscutting concern is clearly +modular, whereas the other implementation is not. As a result, if you +want to change it, its easier in the AspectJ implementation. For +example, if you also want to pass the name of the method, or its +arguments to `log.write`, you only have to edit one place in the AspectJ +code. + +This is just a short example, but I hope it shows how what happens with +AOP and AspectJ is that the usual benefits of modularity are achieved +for crosscutting concerns, and that leads to better code, not more +dangerous code. + +One paper someone else just reminded me of that talks some more about +this is: +http://www.cs.ubc.ca/~kdvolder/Workshops/OOPSLA2001/submissions/12-nordberg.pdf + +*Q:* Why does AspectJ permit aspects to access and add members of +another type? Isn't that violating OO encapsulation? + +*A:* In the spirit of Smalltalk, we have decided to give more power to +the language in order to let the user community experiment and discover +what is right. To date this has proven to be a successful strategy +because it has permitted the construction of many useful aspects that +crosscut the internal state of an object, and as such need access the +its private members. However, we are not discounting that some sort of +restrictions are useful, rather, we are seeking input from the community +in order to decide on what these restrictions should be. + +In that light, our position on encapsulation is : + +* we respect Java's visibility rules +* we also provide open-classes, a mature OO technology +* we provide "privileged" access if you really need it. + +Introducing parents or members to classes is a well-studied OO technique +known as open classes. + +Open classes have been used in many languages prior to AspectJ, +including CLOS, Python, Smalltalk, Objective-C, and others. Building +from Java, introduction in AspectJ provides better name hygiene and +access control than prior languages. Introduced code obeys all of Java's +normal accessibility rules for its lexical location in the aspect that +it is introduced from. Such code can not even see, much less access, +private members of the class it is introduced into. Further, +introductions can be declared private to the aspect, so they are not +visible to other clients of the class. + +Privileged aspects do permit access to private members of another class. +They are a response to the very few cases where developers genuinely +need such access (typically for testing purposes where it access is +necessary), but it would be more risky to open access by putting the +aspect in the same package, adding test code, or changing access in the +target class. We recommend using privileged aspects only as necessary, +and believe that marking them "privileged" makes any potential misuse +apparent. + +*Q:* Can I use AspectJ with J2EE? + +*A:* Consider the component types in J2EE: + +* Servlet: AspectJ works well within servlets +* JSP: It is possible to use AspectJ to affect code in JSPs by +precompiling them into Java sources and compiling these with ajc. This +can be used, e.g., to customize displays by turning on and off custom +JSP taglibs. The mapping from a given jsp source to java package and +class name is not standardized, which means doing this imposes +dependencies on specific container versions. +* EJB: AspectJ supports a wide variety of aspects for EJBs. It can be +used for logging, tracing, debugging, error handling by layers, +correlated method-level interception (e.g., chargebacks), metering, +fine-grained transactions, etc. Indeed, it can be used to enforce +adherence to coding restrictions within an EJB (e.g., not using java.io, +creating a class loader, or listening on sockets) using `declare error`. + +The basic limitations are that there is no built-in support for writing +J2EE analogs for AspectJ extensions to Java, like distributed aspects, +distributed cflow, or managing state between invocations. These don't +prevent one from using AspectJ to do useful intra-container +implementation, nor need they prevent one from building distributed +support, state management, and inter-component implementations that +leverage AspectJ. It just takes some work. In more detail: + +All AspectJ implementations may define "code the implementation +controls". The AspectJ 1.0 implementation defines this as the files +passed to the compiler (AspectJ 1.1 will also support bytecode weaving). + +Some advice on EJB operations will generate methods that confuse ejb +compilers. To avoid this problem, you can use the -XaddSafePrefix flag +when compiling with ajc. + +EJB components may be invoked remotely, and containers may passivate and +pool EJB's. Servlets have similar limitations, and in both cases the +lifespan of the defining class loader is implementation-dependent +(though it must span the operation of a particular request). + +Being limited by lifecycle and namespace, the AspectJ 1.0 implementation +supports aspects that operate through non-remote invocations during the +lifetime of the namespace for a particular deployment unit compiled in +its entirety by the ajc compiler. This means AspectJ supports common +aspects only within a single local runtime namespace (usually +implemented as a class loader hierarchy). + +Further, AspectJ recognizes language-level join points (object +initialization, method calls, etc.), not their EJB analogs (ejb find or +create methods...). These lead to the following consequences: + +* Issingleton aspects (the default) are limited to the lifetime of the +defining class loader, which in some implementations may not span +multiple invocations of the same application or EJB component. +* EJB lifecycles are different from object lifecycles, so perthis and +pertarget aspects will make little sense. They do not work in the +current implementation, which uses synchronized methods to ensure a +correct association in threaded environments (EJB's may not have +synchronized methods). +* Percflow or percflowbelow aspects are restricted to a chain of +non-remote invocations. While EJB 2.0 permits declaring an interface +local, this information is not available to the AspectJ compiler today. +For same reasons as stated above fore perthis, these will not work even +in the EJB container. +* Evaluation of cflow or cflowbelow pointcuts will be valid only with +respect to a chain of non-remote invocations. + +In addition, any AspectJ code should respect EJB operations: + +* The EJB container accesses EJB component fields directly, i.e., in +code outside the control of the compiler. There is no join point for +these accesses, and hence no way to write a pointcut to advise that +access. +* The EJB container may pool EJB components, so any initialization join +points may run once per component constructed, not once per component +initialized for purposes of a client call. +* The EJB container is permitted to change class loaders, even between +invocations of a particular EJB component (by passivating and activating +with a new class loader). In this case, instances of singleton aspects +will not operate over multiple invocations of the component, or that +static initialization join point recur for a given class as it is +re-loaded. This behavior depends on the container implementation. + +*Q:* Can I use AspectJ with Generic Java? + +*A:* We plan to support Generics when Java 1.5 is available. + +But at this time, unfortunately not. The two compilers are just not at +all compatible. In an ideal world, there would be a wonderful Open +Source extensible compiler framework for Java that both GJ and AspectJ +would be built on top of, and they would seamlessly interoperate along +with all other extensions to Java that you might be interested in, but +that's not the case (yet?). + +However, on 09 October 2000, the Java Community Process approved a +proposal to add generic types to Java that is largely based on GJ (JSR +14). A draft specification was submitted for public review, which closed +on 01 August 2001, and a prototype implementation has been released by +Sun. + +We are committed to moving very rapidly to add support for generic types +in AspectJ when generic types become part of the Java language +specification. Everyone on the AspectJ team is looking forward to this, +because we too would really like to be able to write code that includes +both aspects and generic types. + +*Q:* Can I use AspectJ with J2ME? + +*A:* The J2ME platform has several different components. The diagram +below shows how the different profiles build on top of the two +configurations CDC (Connected Device Configuration) and CLDC (Connected +Limited Device Configuration): + +.... + -------------- + | Personal | + -------------- -------- + | Foundation | | MIDP | + ------------------ ------------------ + | CDC | | CLDC | +------------------------------------------ +| Java | +------------------------------------------ + +.... + +Which configuration you have dictates the restrictions when running +AspectJ compiled programs. + +If you're running with a profile which sits on top of CDC then there are +not, as far as we are aware, any restrictions when running AspectJ +compiled code on this flavour of J2ME. + +If you're running with a profile sitting on top of CLDC 1.1 you are +currently unable to use the `thisJoinPoint, + thisJoinPointStaticPart` and ` + thisEnclosingJoinPointStaticPart` variables, the `cflow` and +`cflowbelow` pointcuts and the `percflow` and ` + percflowbelow` perClauses. + +Finally, if you're running with a profile which sits on top of CLDC 1.0 +you have all the restrictions of CLDC 1.1. There may be further +restrictions due to the lack of types corresponding to the primitive +types (e.g. Integer.TYPE), however, at the time of writing we have been +unable to do any extensive testing on this. + +Note that the aspectj runtime jar is now (as of AspectJ5) quite large +but only a small subset is required for executing code in J2ME +environments. We plan to ship a second aspectjrt.jar built for the J2ME +environment at some point. + +For more discussion and to raise any issues you have with AspectJ and +J2ME, refer to +https://bugs.eclipse.org/bugs/show_bug.cgi?id=92933[bugzilla entry +92933]. + +*Q:* Are you working to put AOP into Java? It seems that every AOP +toolset currently uses proprietary mechanisms to describe point-cuts, +etc. + +*A:* We are working on standardization, but it's a question of +timing/ripeness (imagine going from thousands of users to millions). +(See #q:standardization[Q:What are your plans to make AspectJ a general +feature of Java supported by Sun and the other key-players in the Java +Industry?].) We believe AspectJ addresses this question in the best way +possible now: + +* It's open-source. Rather than being proprietary or controlled by a +vendor, it's available for anybody to use and build upon, forever. +* AspectJ is not a set of mechanisms, it's a language. It is currently +implemented using certain techniques, but there's nothing that prevents +it from being implemented with other techniques. That means users can +adopt the language with confidence that implementations will get better. +* There is no engineering need to change Java. The AspectJ language uses +the join point model already in Java, so there is no need to extend the +programming model. Our implementation produces valid Java bytecode, +which runs in any compliant J2SE VM and supports standard debuggers for +those VM's that support JSR-45 (debugging support for +multi-language/multi-file sources). This is a huge benefit to Sun since +Sun must be extremely cautious about extensions to the language or VM; +before adopting AOP, Sun should demand the kind of actual-proof that +AspectJ implementations offer. +* On the issue of "proprietary mechanisms to describe pointcuts, etc.": +Any AOP has to have some language to describe pointcuts and the like +("pointcuts" of course being the AspectJ term). Users would like to have +one language (to avoid having to learn or transform between many +languages) and the choice of multiple implementations (tailored for a +configuration, subject to competitive pressure, etc.). That's what +AspectJ offers. +* That said, we believe the AspectJ extensions to Java could form the +basis for bringing AOP to Java; when that happens, there will be +engineering opportunities to make the implementation and tool support +better. + +*Q:* What kind of support is available? + +*A:* The mailing lists provide the primary support for everyone in the +community (See #q:mailingLists[Q: What mailing lists are there?]). To +request commercial support, tutorials, or presentations, use the +developer mailing list, `aspectj-dev@eclipse.org`. + +To find out about known issues, see the +link:progguide/implementation.html[AspectJ Programming Guide Appendix, +"Implementation Notes"] and the AspectJ bugs in the database at +http://bugs.eclipse.org/bugs (using the product `AspectJ`). Here are +direct links to +http://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&component=Compiler&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED[view +open compiler bugs], +http://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ[view all +Aspectj bugs (open or closed)], or +http://bugs.eclipse.org/bugs/enter_bug.cgi?product=AspectJ[add new +bugs]. + +*Q:* What mailing lists are there? + +*A:* The AspectJ users mailing list (`aspectj-users@eclipse.org`) +provides an informal network of AspectJ language users who can answer +usage questions about AspectJ programs and the AspectJ tools. This is +the place to ask how to code something in AspectJ or how to write Ant or +shell scripts to invoke the tools. + +The AspectJ developers mailing list (`aspectj-dev@eclipse.org`) provides +an informal network of AspectJ technology experts who aim to understand +the technology behind AspectJ. The committers to the AspectJ project use +this list for open technical and planning discussions. Developers can +answer questions about what's possible and about integrating AspectJ +technology with other technologies. + +For both mailing lists, only subscribed members may post messages. To +subscribe, visit the http://eclipse.org/aspectj[AspectJ web site]. + +There you can also subscribe to `aspectj-announce@eclipse.org`, a +low-traffic list containing only announcements about significant AspectJ +events and product releases. To get on a similar list for +aspect-oriented software development generally, see http://aosd.net. + +[[compiler]] +== Using the AspectJ compiler + +*Q:* Do I have to use the AspectJ compiler? + +*A:* The AspectJ compiler or weaver is required at some point, but many +people can use AspectJ without changing their build or deployment +process significantly. For aspects that are not required to compile, you +can use the AspectJ binary weaver, run at build-time or class-load-time. +You can write aspects using the original code style (which must be +compiled with the AspectJ compiler) or using the annotation style new in +AspectJ 5 (which may be compiled with Javac or the AspectJ compiler). + +For more information, see #q:codeversusannotationstyles[Q:Should I use +code- or annotation-style aspects?]. + +*Q:* What files do I need to include when compiling AspectJ programs? + +*A:* You need to specify to the compiler the files that contain your +aspects and the files that contain the types affected by your aspects. +See #q:knowWhenAspectsAffectClasses[Q: How do I know which aspects +affect a class when looking at that class's source code?]. The AspectJ +compiler will not search the source path for types that may be affected +(unlike Javac and Jikes). In AspectJ 1.0, ajc requires all code to be in +source form; in AspectJ 1.1, Java and AspectJ code may be in either +source or binary form. + +In some cases you should compile your entire system all at once. If this +is too slow, then you can try to make reasonable divisions between sets +of source files whose aspects do not interact to achieve a shorter +compile cycle (particularly for development aspects). If you have +aspects that apply to different modules, you can try compiling them into +a binary form and using them to weave each module. However, if you get +any problems or if you wish to run tests or do a release, you should +recompile the entire system. + +For more information, see the link:devguide/index.html[Development +Environment Guide] link:devguide/ajc-ref.html[Reference for ajc]. + +*Q:* I have to list many files in the command line to compile with +`ajc`. Is there any other way to provide the file names to `ajc`? + +*A:* Yes, use the argfile option to ajc. List source files in a +line-delimited text file and direct ajc to that file using `-argfile` or +`@`: + +.... +ajc @sources.lst +ajc -argfile sources.lst + +.... + +Another way in AspectJ 1.1 is to use the `-sourceroots` options, which +reads all source files in a given set of directories: + +.... +ajc -sourceroots "src;testsrc" + +.... + +For more information, see the link:devguide/index.html[Development +Environment Guide] link:devguide/ajc-ref.html[Reference for ajc]. + +*Q:* What Java virtual machine (JVM) do I use to run the AspectJ +compiler? + +*A:* Use the latest, greatest, fastest JVM you can get your hands on for +your platform. The compiler's performance is dependent on the +performance of the JVM it is running on, so the faster a JVM you can +find to run it on, the shorter your compile times will be. At a minimum +you need to use a Java 2 or later JVM to run the compiler (J2SE 1.3 for +AspectJ 1.1). We realize that this constraint can be a problem for users +who don't currently have a Java 2 JVM available. We're sorry for the +inconvenience, but we had to make the hard decision that the advantages +of being able to rely on Java 2 were worth the cost of losing a number +of developers who are working on platforms without Java 2 support. Here +is a list of starting places where you might find support for your +system. + +* http://java.sun.com/j2se/[Java 2 Platform, Standard Edition] +* http://www-106.ibm.com/developerworks/java/jdk/[developerWorks : Java +technology : Tools and products - Developer kits] +* http://www-124.ibm.com/developerworks/oss/jikes/[developerWorks : Open +Source - Jikes Project] +* http://java.sun.com/cgi-bin/java-ports.cgi[Java Platform Ports] + +The requirement of Java 2 support is only for _running_ the AspectJ +compiler. The AspectJ compiler can be used to build programs that will +run on Java 1.1 (or probably even on Java 1.0) systems. This means that +it can build programs that will run on Macintosh, FreeBSD, and applets +that will run in Internet Explorer and Netscape Navigator that are still +not yet Java 2 compliant. + +*Q:* How can I use `ajc` to compile programs for a JVM that is different +from the one used to run it? + +*A:* `ajc` can be used to develop programs that are targeted at the Java +1.1 platform, even though the `ajc` compiler won't run on that platform. +Here's an example of using `ajc` in this sort of cross-compilation mode +(assuming a Windows platform with all the default installation +directories): + +.... +ajc -target 1.1 -bootclasspath c:\jdk1.1.7\lib\classes.zip \ + -classpath c:\aspectj1.0\lib\aspectjrt.jar -extdirs "" \ + -argfile jdk11system.lst + +.... + +This same technique can be used if you want to run `ajc` on a JDK 1.3 +JVM (highly recommended) but need to generate code for JDK 1.2. That +would look something like: + +.... +ajc -bootclasspath c:\jdk1.2\jre\lib\rt.jar \ + -classpath c:\aspectj1.0\lib\aspectjrt.jar \ + -extdirs c:\jdk1.2\jre\lib\ext + -argfile jdk12system.lst + +.... + +*Q:* Does the `ajc` compiler support the `assert` keyword in Java 1.4? + +*A:* Yes. As with `Javac`, use the `-source 1.4` option as described in +the link:devguide/index.html[Development Environment Guide] +link:devguide/ajc-ref.html[Reference for ajc]. + +*Q:* Does the `ajc` compiler support generics and the other new language +features of Java 5? + +*A:* Yes. As with `Javac`, use the `-1.5` option as described in the +link:devguide/index.html[Development Environment Guide] +link:devguide/ajc-ref.html[Reference for ajc]. + +*Q:* Will aspects work with different versions of the compiler/weaver +and runtime? + +*A:* Yes. Both `ajc` and `aspectjrt.jar` should work with versions of +aspect code and libraries back to AspectJ 1.2.1. Any aspects should be +deployed with the same version of `aspectjrt.jar` they were compiled +with. For more information, see the link:devguide/index.html[Development +Environment Guide] link:devguide/ajc-ref.html[Reference for ajc] and +link:devguide/deployment.html[Deployment notes] section on +link:devguide/versionCompatibility.html[Version compatibility]. + +*Q:* Are there any issues using AspectJ with the Microsoft JVM? + +*A:* Since AspectJ requires Java 2 or later, it will not run on the +Microsoft JVM, which does not support Java 2. + +*Q:* Does `ajc` rely on `javac` for generating Java bytecode (`.class`) +files? + +*A:* No. Some previous versions of AspectJ had this requirement. In +AspectJ 1.0, `javac` can still be used as `ajc` back end by using the +`-usejavac` flag. You can also run `ajc` in preprocessor mode to +generate Java source (`.java`) files to be compiled using `javac` or +another java compiler. Neither option is supported in AspectJ 1.1. + +*Q:* I noticed the AspectJ compiler doesn't use a parser generator. Why +is that? + +*A:* In AspectJ 1.0, the PARSER for ajc is written by hand. This choice +was made with full awareness of the generator tools out there. (Jim had +for example used the excellent javacc tool for building the parser for +JPython (now Jython)). One of the reasons that AspectJ uses a +hand-written parser is that using javacc taught Jim about the LL-k +design for parsers (pioneered by antlr). As opposed to the state-machine +parsers produced by yacc, these parsers are very readable and writable +by humans. + +Antlr and javacc did not really suit the project: + +* Antlr's support for unicode in the lexer is still immature and this +makes using it with Java challenging. This was an even bigger issue 3 +years ago when we started on the Java implementation of ajc. +* While javacc is freely available, it is not Open Source. Depending on +a closed-source tool to build an Open Source compiler would reduce some +of the transparency and control of open-source. + +There were also several things that were easier to implement with a +hand-written parser than with any of the exiting tools. + +* Semi-keywords -- it's important to us that "every legal Java program +is also a legal AspectJ program." This wouldn't be true if we made +'before' and 'call' full keywords in AspectJ. It is easier to support +these sorts of semi-keywords with a hand-written parser. (Note: +ajc-1.0.x handles 'aspect' and 'pointcut' slightly specially which can +break a few unusual pure Java programs. This is a compiler limitation +that will be fixed in a future release.) +* Deprecated syntax warnings -- the syntax of AspectJ changed many times +from version 0.2 to the 1.0 release. It was easier to provide helpful +warning messages for these changes with our hand-written parser. +* Grammar modularity -- We like being able to have AspectJParser extend +JavaParser. +* Part of the grammar for AspectJ is extremely hard for existing tools +to capture. This is the type pattern syntax, i.e. "com.xerox..*.*(..)". +The sort of case that gives standard parser generators fits is something +like "*1.f(..)" which no one would ever write, but which must be +supported for a consistent language. ++ +In AspectJ 1.1, the parser was written as it is for the underlying +Eclipse compiler, with some hand-coding of the sort that avoids adding +keywords to the language. + +*Q:* How does incremental mode work? + +*A:* In incremental mode, ajc minimizes the files that need to be +recompiled after another file has changed. In Java, only the changed +files need to be recompiled, but in AspectJ, other files might also need +to be recompiled or re-woven. + +Depending on what is modified, we may need to re-weave code. If you +change a pointcut and save it, we currently have to check everywhere in +case a new match is occurring or an old match is no longer correct. + However, if you simply change the body of an advice in an aspect, there +is (usually) no need to reweave as the affected classes call the advice +and the advice (by design) maintains its name in the recompiled aspect. + +If you make a change to a class (as opposed to an aspect) and save it, +we usually can get away with merely having to compile that class then +weave the existing aspects with it - rather than doing a full recompile +of the entire system. + +There are a lot of possible optimizations to the algorithms we use, by +performing more complete analysis of the change made to a file that will +enable us to know more accurately whether we need to reweave and if we +do then what we need to reweave - we just haven't gotten around to +implementing them yet. + +[[devtools]] +== Integrating AspectJ into your development environment + +*Q:* How do I know which aspects affect a class when looking at that +class's source code? + +*A:* When you are working with the IDE support, you can get an +understanding of which aspects affect any class. This enables AspectJ +programmers to get the benefits of modularizing crosscutting concerns +while still having immediate access to what aspects affect a class. + +For example, the link:devguide/index.html[Development Environment Guide] +link:devguide/ajbrowser.html[ajbrowser section]. shows that you can list +or navigate between method and advice affecting that method and between +a type and declarations in an aspect on that type. (The IDE support may +have more features than `ajbrowser`, depending on the IDE. See +#q:integrateWithDevTools[Q: How well does AspectJ integrate with +existing Java development tools?] for more information on which Java +development environments are supported.) + +When you are looking at documentation for AspectJ 1.0 programs, `ajdoc` +will provide links from aspects and advice to the affected code, but it +provides less information than the IDE support because it only parses +declarations. + +When you are compiling your program, pointcuts that are +statically-determinable can be used in declare statements to identify +the code picked out by the pointcut. (A pointcut is statically +determinable if it only uses the pointcut designators `within`, +`withincode`, `execution`, `call`, `get`, `set`, `initialiation`, and +`staticinitialiation`.) The compiler will list the static code points +which will be affected by any advice specifying the same pointcut. For +example, the following will print a warning whereever some code in class +Bar gets a field value from Foo: + +.... +declare warning: get(* Foo.*) && within(Bar) + : "reading Foo state from Bar"; + +.... + +When you are running your program, you can trace advice as it executes. +This enables you to identify advice on join points picked out +dynamically, which cannot be reflected precisely by IDE support. For a +related tracing question, see #q:seeingjoinpoints[Q:I don't understand +what join points exist. How can I see them?] + +*Q:* What kind of IDE support is available for developing AspectJ +programs? + +*A:* See #q:integrateWithDevTools[Q: How well does AspectJ integrate +with existing Java development tools?] + +*Q:* What plans are there to support my IDE? + +*A:* The AspectJ team directly provided components for JBuilder, Forte, +and Emacs and supported the open-source AspectJ plugin project at +http://eclipse.org/ajdt which uses the AJDE API support for IDE's. +Supporting new IDE's is a matter of building on the AJDE API's, mostly +likely adopting one of the existing open-source IDE extensions as a +design template. Here are the IDE's where we know people have expressed +interest, so interested developer may want to join with others in their +developer communities to build the integration. + +* IDEA/IntelliJ has an enthusiastic community and the developers are +working on an extensibility API - http://intellij.com +* jEdit comes from a very active open-source community. +* Oracle JDeveloper is supported at https://jdeveloperaop.dev.java.net/. +* Some have suggested Codeguide from Omnicore +http://www.omnicore.com[http://www.omnicore.com/] + +For questions on AJDE, join the developer's list +`aspectj-dev@eclipse.org`. For questions on the current IDE +integrations, contact those projects. + +*Q:* Can I port AJDE support to my development environment? + +*A:* Yes. The core AJDE API is extensible and the source code is +available for download. Start by studying the sources for the existing +IDE support linked off the AspectJ site http://eclipse.org/aspectj. + +*Q:* I want the aspects for development builds but remove them for +production builds. How can I set up the build system so they are +unpluggable? And so I use `javac` in my production build? + +*A:* If you are using development-time-only aspects - aspects that only +exist when you are developing the code, not when you ship it - you can +use implement a hybrid build process by listing the production source +files into a javac-compliant argfile, and the development source files +in another ajc argfiles: + +.... +-- file "production.lst": +One.java +two/Three.java +... + +-- file "tracing.lst": +trace/Library.java +Trace.java + +-- file "development.lst": +@production.lst +@tracing.lst + +.... + +Then your development build can use `ajc`: + +.... +ajc @development.lst + +.... + +And your development build can use `ajc` or `javac` or `jikes`: + +.... +jikes @production.lst + +.... + +*Q:* We compile module jars and then assemble them. Can we continue this +with AspectJ? + +*A:* Aspects apply to everything in a namespace, as if everything is +compiled together. Sometimes you can break the build down into separate +steps without breaking this model, but we haven't stated exactly where +it could break because it depends on the interactions between all types. +You can try the approaches below, but remember to rebuild everything in +one go if there are problems. + +The simplest scenario is when the aspects apply to all modules and the +modules compile without the aspects. In that case, weaving in the +aspects is just the final assembly step for the build. + +Next is the case where the aspects make changes to a common library that +are visible to other clients, which themselves are otherwise unaffected +by the aspects. In this case, the common library can be built using ajc, +and used on the classpath for the module builds: + +.... +ajc -outjar common.jar -sourceroots "aspectj-src:src" ... +cd ../otherProject +javac -classpath "../common/common.jar:${aspectjrt.jar}" {src} +.... + +Combining these last two, there's the case where a common set of aspects +should affect two or more modules that are in a dependency relationship +to one another. It should work to reuse the aspects in binary form for +each compile, in dependency order: + +.... +ajc -outjar common-aspects.jar + -sourceroots "aspectj-src" ... + +ajc -outjar common.jar + -sourceroots "src" + -aspectpath common-aspects.jar ... + +cd ../module1 +ajc -outjar module1.jar + -sourceroots "src" + -classpath common.jar + -aspectpath ../common-aspects.jar ... + +cd ../module2 +ajc -outjar module2.jar + -sourceroots "src" + -classpath "common.jar;../module1.jar" + -aspectpath ../common-aspects.jar ... +.... + +If two modules are visibly affected by aspects and mutually-dependent, +the only thing to do is compile them together. + +It's safest to assume that all aspects can affect all types in a +namespace; using build boundaries to effect crosscutting limits causes a +dangerous dependency on the build process and might cause problems. + +*Q:* We use modules and would like to use incremental compilation. Is +that possible? + +*A:* Just incrementally-compile the whole system. Specify to ajc the +modules as multiple source roots (or input jars if you are weaving +libraries). + +In Eclipse's AJDT, you can create a top-level project with symbolic +links out to the sources: + +.... +app-assembly/ +{link common/aspects} +{link common/src} +{link module1/src} +... +.... + +Then everything is part of one huge incremental compile. Also, you can +close this master project and work the others using the Java compiler or +AJDT. + +The links make incremental development possible without affecting the +modularized Ant builds. (Our practice runs along those lines.) + +[[notes]] +== Programming notes and tips + +*Q:* Is it possible to change methods by introducing keywords (like +`synchronized`), adding parameters, or changing the "throws" clause? + +*A:* AspectJ does not enable you to change the signature of a method, +but you can (by express declaration) work around some limits imposed by +the signature. You can convert a checked exception to unchecked using +`declare soft`, privileged aspects have access to private methods, and +you can use a percflow aspect to ferry additional state to a callee +without changing intervening signatures. For more details, see +link:progguide/index.html[The AspectJ Programming Guide]. In the case of +`synchronized`, we have what we consider a better solution that uses +around advice instead of introduction. This solution is described in +http://aspectj.org/pipermail/users/2000/000534.html[this thread (no +longer available)] on the AspectJ users list, with some +http://aspectj.org/pipermail/users/2000/000536.html[additional comments +(no longer available)] . + +*Q:* I don't understand what join points exist. How can I see them? + +*A:* You can trace them using using an aspect. For example, you can +start logging at a particular method call and see what join points occur +after the call and before it returns. + +Here's some code Jim Hugunin wrote to trace join points and posted to +the users list. To reuse the aspect, define a subaspect and implement +the pointcuts, for example: + +.... +aspect JoinPointSampleAspect extends aj.TraceJoinPoints { + protected pointcut entry() : + execution(static void JoinPointSample.main(String[])); + protected pointcut exit() : + call(static void JoinPointSampleAspect.exit()); + + public static void main (String[] args) { + JoinPointSample.main(args); + JoinPointSampleAspect.exit(); + } + public static void exit() {} +} + +class JoinPointSample { + public static void main(String[] args) {} +} + +.... + +Here's the aspect: + +.... +/* TraceJoinPoints.java */ + +package aj; + +import org.aspectj.lang.*; +import org.aspectj.lang.reflect.*; +import java.io.*; + +public abstract aspect TraceJoinPoints { + protected abstract pointcut entry(); + protected pointcut exit(): call(* java..*.*(..)); + // this line is for AspectJ 1.1; for 1.0, use "dominates" + declare precedence : TraceJoinPoints, *; + final pointcut start(): entry() && !cflowbelow(entry()); + + final pointcut trace(): + cflow(entry()) && !cflowbelow(exit()) && !within(TraceJoinPoints+); + + before(): start() { makeLogStream(); } + + before(): trace() { logEnter(thisJoinPointStaticPart); } + after(): trace() { logExit(thisJoinPointStaticPart); } + + after(): start() { closeLogStream(); } + + //------------ added + /** + * Emit a message in the log, e.g., + * 
TraceJoinPoints tjp = TraceJoinPoints.aspectOf();
+     * if (null != tjp) tjp.message("Hello, World!");
+ */ + public void message(String s) { + out.println("" + prepareMessage(s) + ""); + } + public void message(String sink, String s) { + if (null == sink) { + message(s); + } else { + out.println("" + prepareMessage(s) + ""); + } + } + protected String prepareMessage(String s) { return s; } // XXX implement + + //--------- end of added + + PrintStream out; + int logs = 0; + protected void makeLogStream() { + try { + out = new PrintStream(new FileOutputStream("log" + logs++ + ".xml")); + } catch (IOException ioe) { + out = System.err; + } + } + + protected void closeLogStream() { + out.close(); + } + + + int depth = 0; + boolean terminal = false; + protected void logEnter(JoinPoint.StaticPart jp) { + if (terminal) out.println(">"); + indent(depth); + out.print("<" + jp.getKind()); + writeSig(jp); + writePos(jp); + + depth += 1; + terminal = true; + } + + void writeSig(JoinPoint.StaticPart jp) { + out.print(" sig="); + out.print(quoteXml(jp.getSignature().toShortString())); + } + + void writePos(JoinPoint.StaticPart jp) { + SourceLocation loc = jp.getSourceLocation(); + if (loc == null) return; + + out.print(" pos="); + out.print(quoteXml(loc.getFileName() + + ":" + loc.getLine() + + ":" + loc.getColumn())); + } + + String quoteXml(String s) { + return "\"" + s.replace('<', '_').replace('>', '_') + "\""; + } + + protected void logExit(JoinPoint.StaticPart jp) { + depth -= 1; + if (terminal) { + out.println("/>"); + } else { + indent(depth); + out.println(""); + } + terminal = false; + } + + void indent(int i) { + while (i-- > 0) out.print(" "); + } +} +.... + +Note that if you are using AspectJ 1.0, the line starting with +`declare precedence` would be removed, and the aspect declaration would +look like `aspect TraceMyJoinPoints dominates *`. + +*Q:* What is the difference between call and execution join points? + +*A:* Briefly, there are two interesting times when a constructor or +method is run. Those times are when it is called, and when it actually +executes. + +The main difference is that a call join point happens outside of the +target object (for non-static methods) or class (for static methods and +constructors), and that an execution join point happens inside the +object or class. This means that the `within` and `withincode` pointcuts +pick them out differently: A call join point is picked out within the +caller, while an execution join point is picked out where it is actually +defined. + +A call join point is the ``outermost'' join point for a particular call. +Once a call join point proceeds, then a number of different things +happen. For non-static methods, for example, method dispatch happens, +which will cause one method execution join point -- perhaps more, if +there are super calls. For constructors, the super constructor is +called, and fields are initialized, and then various constructor +execution join points will occur. + +A call join point matches only the ``external'' calls of a method or +constructor, based on a signature, and it does not pick out calls made +with `super`, or `this` constructor calls. + +Here's more detail: + +Consider method execution in Java as (1) the initial call from this +object to some method on the target object with a particular signature; +and (2) the execution of the actual code in the particular method +dispatched in the target object. The call join point starts with the +initial call and ends when control returns to the call (by return or +perhaps thrown exception). The execution join point starts with the +method body and ends when the body completes (again by return or +throwing an exception), so the execution join point always happens +within the bounds of the corresponding call join point. You can see this +if you use the join-point tracing aspect in see #q:seeingjoinpoints[Q:I +don't understand what join points exist. How can I see them?]. + +As you would expect, the context differs in advice on pointcuts picking +out execution and call join points; for call, `this` refers to the +caller, whereas for execution `this` refers to the called (executing) +object. + +There are some subtle interactions with other AspectJ semantics. First, +the meaning of the signature in the `execution()` and `call()` pointcut +designators (PCD's) differ: the call type depends upon the type of the +reference making the call, while the execution type depends on the +enclosing class. Second, you may choose one over another if you cannot +bring all your sources within the code the compiler controls (described +in the link:progguide/semantics.html[appendix] to the +`Programming Guide`). For example, to trace calls into a method from +classes which are outside the code the compiler controls at compile +time, then using `execution()` will work while using `call()`may not. +Finally, since `super` invocations are not considered method calls, to +trace `super.foo()` would require using `execution`. + +Because of differences in the way AspectJ 1.0 and 1.1 are implemented, +in 1.0 you should use the `call()` pointcut designator unless you have a +good reason to use `execution()`; in AspectJ 1.1, the reverse is true. + +*Q:* What is the difference between cflow and cflowbelow? + +*A:* Both pick out all the join points in the control flow of the +specified join points. They differ only in that the `cflowbelow()` +pointcut designator does not pick out the join points specified, while +`cflow()` does. + +*Q:* How do I say that I want the topmost entrypoint in a recursive +call? How about the most-recent prior entrypoint? + +*A:* This is best seen by way of example. Given a recursive call to +`int factorial(int)` you can print the arguments for (a) the current and +most-recent recursive call or (b) the current and original recursive +call: + +.... +aspect LogFactorial { + pointcut f(int i) : call(int factorial(int)) && args(i); + + // most-recent + before(int i, final int j) : f(i) && cflowbelow(f(j)) { + System.err.println(i + "-" + j); + } + + // original + before(int i, final int j) : f(i) + && cflowbelow(cflow(f(j)) && !cflowbelow(f(int))) { + System.err.println(i + "@" + j); + } +} + +.... + +*Q:* What is the difference between constructor call, constructor +execution, initialization, and static initialization join points? + +*A:* Static initialization pertains to initialization of a class or +interface type. Constructor call and execution are akin to method call, +and initialization generalizes this and picks out the first constructor +called. + +Their relations are best demonstrated by tracing the join points. Below +is the class Test which implements an interface and extends a class +along with a trace of the join points below and including the +constructor call obtained using `TraceJointPoints.java` from +#q:seeingjoinpoints[Q:I don't understand what join points exist. How can +I see them?]. + +.... +public class Init { + public static void main (String[] args) { + new Test(); + end(); + } + static void end() {} +} +class Super {} +interface I {} +class Test extends Super implements I { + Test() {} +} +.... + +For a program compiled with AspectJ 1.0, the result is this: + +.... + + + + + + + + + + + + + + + + +.... + +Ordinarily, using a `call` pointcut designator is best because the call +join point surrounds the others, but in the case of constructors there +is no target object for the call (because it has not been constructed +yet), so you might prefer to use the `initialization` pointcut +designator. + +*Q:* How do I work with an object right when it is created? + +*A:* You can advise some form of constructor join point. Constructors +are tricky in Java, and that's exposed in AspectJ. Here are some rules +of thumb: + +* If you want the join point on the "outside" of object creation, use +after returning from call to the constructor: ++ +.... +after() returning (Foo newlyCreatedObject): call(Foo.new(..)) { ... } + +.... ++ +You might be tempted to use "this" or "target" to expose the new object, +but remember that if you're on the "outside" of object creation, the +object itself might not be created yet... it only exists "on the way +out", when you return the object. +* If you want the join point inside a particular constructor, use: ++ +.... +after(Foo newlyCreatedObject) returning: this(newlyCreatedObject) && execution(Foo.new(..)) { ... } + +.... ++ +Remember, though, that if you use "before" advice here, the body of the +constructor will not have run, and so the object may be somewhat +uninitialized. +* In the rare case that there are all sorts of constructors for the +object that call each other with `this(...)` and you want exactly one +join point for each initialization of `Foo`, regardless of the path of +constructors it takes, then use: ++ +.... +after(Foo f) returning: this(f) && initialization(Foo.new(..)) { ... } + +.... + +*Q:* I want advice to run at two join points, but it doesn't run at all. +What gives? + +*A:* This usually reflects both a conceptual error and a programming +mistake. Most likely you want to do something like "run the advice for +all public and private calls," and the code looks something like this: + +.... +within(com.xerox.printing..*) && call(public * *(..)) && call(private * *(..)) + +.... + +But a pointcut is evaluated at *each* join point. The expression above +would never pick out any call join point, because no method signature +has both public and private access. In a pointcut, `pc1() && pc2()` +means both must be true at a given join point for advice to run at that +join point. The correct pointcut would use `||` as follows: + +.... +within(com.xerox.printing..*) && (call(public * *(..)) || call(private * *(..))) + +.... + +Then the advice will run at the join point. + +*Q:* How do I refer to a static field when my advice crosscuts multiple +classes? + +*A:* There is no way in advice to refer to the type of the code +executing in a static context except by specification. This makes it +impossible to refer to static members using runtime information. + +However, AspectJ can determine the class for something in the join point +context, which you can use as a per-class key. Then you can actually +declare an instance field to contain the per-class value (see the next +question). This comes at the cost of an extra reference, but the field +can be final. + +*Q:* I would like to reuse a type pattern, e.g., to write advice that is +limited to a certain set of classes. Do I have to retype it each time? + +*A:* No. You can declare that all the types implement an interface you +define, and then use the interface type in your program. For example: + +.... +/** + * Example of using an interface to represent a type pattern. + * sub-aspects use declare parents to add to traced types, e.g., + * declare parents: com.mycompany.whatever..* implements Marked; + */ +abstract aspect MarkerExample { + /** marker interface for types that we want to trace */ + interface Marked {} + + /** calls to an instance of Marked not from an instance of Marked */ + pointcut dynamicCallsIn(): call(* *(..)) && target(Marked) && !this(Marked); + + /** calls to methods defined by a subtype of Marked + * that don't come from the body of a subtype of Marked + */ + pointcut staticCallsIn(): call(* Marked+.*(..)) && !within(Marked+); + + /** print dynamic calls */ + before(): dynamicCallsIn() { System.out.println("before " + thisJoinPoint); } +} + +aspect MyMarker extends MarkerExample { + declare parents: com.mycompany.whatever..* implements Marked; +} + +.... + +*Q:* Where do I find example programs and how-to's? + +*A:* There are a number of places to find sample code and instructions +for using AspectJ with other programming tools. + +[arabic] +. The AspectJ release includes examples in its `doc` directory. +. There is a community repository of sample code and tutorials in the +AspectJ CVS tree `docs` module `sandbox` directory. These are extracted +and published (online only) +http://dev.eclipse.org/viewcvs/indextech.cgi/~checkout~/aspectj-home/sample-code.html[here] +. +. The `teaching` directory of the `docs` module contains public +materials the AspectJ committers use for presentations, some of which +include example code. To access CVS, see #q:buildingsource[Q:How do I +get and compile the source code for AspectJ?]. +. The archives for the user and developer mailing lists contain many +good examples. To search the archives, see #q:searchingsite[Q:How can I +search the email archives or the web site?]. + +This code can vary in quality. Code that we publish or include with +AspectJ is generally correct. However, code found in our CVS tree might +not have been tested thoroughly, and code from the mailing lists might +be untested or use older versions of the language. + +*Q:* Are aspect libraries available? + +*A:* Some libraries are distributed in the release under the examples +folder in the distribution. These are "libraries" in the sense that they +are reusable, but they are delivered in source form. Similarly, some of +the sample code is reusable; for that, see #q:exampleprograms[Q:Where do +I find example programs and how-to's?]. If you develop such a library +and want to make it available to other users, feel to send it to the +users mailing list `aspectj-users@eclipse.org`. + +In AspectJ 1.1, ajc supports binary aspects, so you can distribute +aspect libraries without distributing the source. For more information, +see the `-aspectpath` option in the link:devguide/ajc-ref.html[Reference +for ajc]. + +*Q:* How does `ajc` interact with the `serialVersionUID`? + +*A:* The current version of `ajc` can change the `serialVersionUID` of +generated `.class` files as a result of weaving in advice. This is an +important fact that developers using both aspects and serialization +should be aware of. It is likely that a future version of the compiler +will be better behaved regarding the `serialVersionUID`. + +However, changes to the `serialVersionUID` attribute are typically only +important when using serialization for the long-term persistence of +objects. Using standard Java serialization for long-term persistence has +a number of drawbacks and many developers already use alternative +solutions. For one possibly standard solution, see +http://jcp.org/jsr/detail/057.jsp[Long-Term Persistence for JavaBeans +Specification] . + +*Q:* How can I use AspectJ with applets? + +*A:* Just include the aspectjrt.jar as a required archive. For example, +here is the HTML code for an HTML editor applet that contains some +debugging aspects: + +.... + + + + + + +.... + +The above markup has worked reliably with the Java Plugin (included in +the JRE 1.4.x) in IE 6, Mozilla 1.1 (Win32), and Mozilla 1.0.1 (Red Hat +Linux 8.0). The following link describes how to configure +Mozilla/Netscape 6.x/7.x to use the Java Plugin from a JRE/SDK +installation: http://java.sun.com/j2se/1.4.1/manual_install_linux.html. +(Thanks to Chris Bartling for this answer.) + +*Q:* How can I specify types for advice that captures primitives, void, +etc.? + +*A:* In some cases, AspectJ allows conversion from values of primitive +types to Object, so that highly polymorphic advice may be written. This +works if an advice parameter or the return type for around is typed to +Object. So: + +.... +class Test { + static int i; + public static void main(String[] args) { + i = 37; + } +} + +aspect TraceSet { + before(Object val): set(* Test.*) && args(val) { + System.err.println(val); + System.err.println(val.class); + } +} + +.... + +will print out + +.... +37 +java.lang.Integer + +.... + +For more information, see the Programming Guide +link:progguide/semantics-pointcuts.html[semantics section "Context +Exposure"] . + +*Q:* How do I detect which version I am running? + +*A:* The `ajc` compiler emits the version when passed the `-version` +flag as an argument. + +To programmatically detect the version of the AspectJ runtime while +running under Java 1.4 or later, get the version from the package: + +.... +Package lang = org.aspectj.lang.JoinPoint.class.getPackage(); +String version = lang.getImplementationVersion(); + +.... + +When running under Java 1.3 or earlier, read the manifest directly. For +example code, see the source for +`AjBuildManager.checkRtJar(AjBuildConfig)` in the +`org.aspectj.ajdt.internal.core.builder` package of the +`org.aspectj.ajdt.core` module, available as described in +#q:buildingsource[Q:How do I get and compile the source code for +AspectJ?]. + +Note that the version of AspectJ for the tools in `aspectjtools.jar` is +in `org.aspectj.bridge.Version`. + +*Q:* How do I write synchronized advice? + +*A:* The only modifier advice can take is `strictfp`. However, you can +enclose the body of the advice in a synchronized clause: + +.... +before() : pc() { + synchronized (this) { + // advice code here + } +} + +.... + +It should not be necessary to synchronize a percflow aspect, but you +might do this for perthis, pertarget, or issingleton (default) aspects. +To serialize advice in multiple aspects, synchronize on a lock object +available (only) to the aspects. + +[[problems]] +== Common Problems + +*Q:* When I run, I get a `StackOverflowError` (or a long stack trace or +no output whatsoever) + +*A:* Most likely this is a case of infinite recursion, where advice is +advising itself. It presents as a `StackOverflowError` or silence as the +VM exhausts itself in the recursion. + +Of course, infinite recursion is possible in Java: + +.... +public class Main { + public static void main(String[] args) { + try { + main(args); + } finally { + main(args); + } + } +} + +.... + +If you compile and run this program, and it will fail silently, trying +to process the finally clause even after throwing the +StackOverflowError. + +Here's a similar AspectJ program where the recursion is not so obvious: + +.... +aspect A { + after(): call(* *(..)) { System.out.println("after " + thisJoinPoint); } +} + +.... + +This re-invokes itself because it advises any call. It invokes itself +even after an exception is thrown, since `after` advice, like a finally +clause, runs even after exceptions are thrown. You can fix this by +following two practices: + +In AspectJ 1.1, the String concatenation operator (+) is advised in its +StringBuffer form, so if your advise uses String + in a way that is +picked out by your pointcut, you will get infinite recursion. + +{empty}(1) Use `after returning` to advise normal completions or +`after throwing` to advise abrupt completions. If you use `after` or +`after throwing`, write the advice with the same care you would a +finally clause, understanding that it may run after some failure. + +{empty}(2) Avoid writing advice that advises itself. One simple way to +do so is to exclude the code within the current aspect: + +.... +aspect A { + after() returning: !within(A) && call(* *(..)) { + System.out.println("after " + thisJoinPoint); + } +} + +.... + +A better way is often to re-write the pointcut. If the advice is +advising itself accidentally, that's a sign that the pointcut is not +saying what you mean. + +.... +aspect A { + pointcut withinTargetClasses() : within(A+) || within(B+); + after() returning: withinTargetClasses() && call(* *(..)) { + System.out.println("after " + thisJoinPoint); + } +} + +.... + +*Q:* I've declared a field on every class in my package; how do I use it +in advice? + +.... +aspect A { + boolean com.xerox..*.dirtyFlag; + after (Object target) returning + : target(target) && call(* com.xerox..*.set*(..)) { + target.dirtyFlag = true; // compile fails here + } +} + +.... + +*A:* You need a type to refer to any member, field or method. It's +generally better to introduce onto an interface and declare classes to +implement the interface, which permits you to use the interface type in +advice formals. + +.... +aspect A { + interface TrackingSets {} + boolean TrackingSets.dirtyFlag; + declare parents : com.xerox..* implements TrackingSets; + + after (TrackingSets target) returning + : target(target) && call(* com.xerox..*.set*(..)) { + target.dirtyFlag = true; + } +} + +.... + +*Q:* The AspectJ compiler aborts with an OutOfMemoryError when compiling +many classes. How can I fix this? + +*A:* `ajc` can use more memory than a javac compile of the corresponding +pure-java sources when aspects are added to the mix. You'll need to +increase the memory available. + +The command `ajc` is actually a script that launches a Java virtual +machine with the correct classpath. You should make a copy of this +script, rename it, and then edit it. Change the -Xmx option, size of +memory allocation pool (heap). You might try `-Xmx128M` or even +`-Xmx256M`. + +When running under Ant, give Ant more memory or use the `fork` option +together with the `Xmaxmem` option. + +When running under an IDE, look to the documentation for the IDE to +determine how to increase available memory. + +In either case, doing incremental compilations can hold on to more +memory than a one-shot compile process, as the compiler trades space for +time in recompiles. + +*Q:* Why do I get a message that my class is already defined? + +*A:* Most commonly, a source file was specified twice on the command +line (e.g., directly and by a *.java entry in a .lst file). However, +sometimes you have defined a class in two files in the same package, and +you need to rename the class or change its scope. You should get this +message from any Java compiler. + +*Q:* `ajc` recompiles all files every time. How can I make it recompile +only the files that have changed? + +*A:* `ajc` 1.0 does not support incremental compilation, but since 1.1 +`ajc` does when passed the `-incremental` option. It may still recompile +files that have not changed, if they could be affected by aspects in +particular ways, but the files compiled should be fewer and result in +faster compiles. Further, the 1.1 release supports binary weaving, so +you need not recompile if you already have .class files. + +*Q:* `ajc` is using the wrong JVM. How do I fix it? + +*A:* The easiest way to fix this is to re-install `ajc` (using the same +`.class` or `.exe` file that you originally downloaded) and this time +make sure to tell it to use the desired JDK (typically the JDK versions +1.2 or 1.3 from Sun). + +If you are familiar with DOS batch files or shell programming, you could +also fix this by simply editing the `bin\ajc.bat` or `bin/ajc` script. + +*Q:* My IDE is trying to parse AspectJ files which makes my project +unusable. What can I do? + +*A:* When working with an unsupported IDE that objects to the syntax of +AspectJ source files (and, e.g., automatically gathers them in a source +tree as Java files based on the .java extension), you can use the .aj +extension for your AspectJ files. The ajc compiler accepts both .java +and .aj files, and you can set up your build scripts to include the +correct list of source files. (You will have to find another editor for +editing AspectJ files; you can use the ajbrowser to view edit your +AspectJ files and navigate the crosscutting structure.) + +*Q:* I used to be able to compile my program in my IDE, but when I use +AJDE, I run out of memory (or it goes really slow). + +*A:* The ajc compiler does more analysis than (e.g.,) javac, and AJDE +may in some IDE's hold a copy of the structure tree until the next tree +is available from the compile process. Both mean that you may need extra +memory to compile the same program. However, increasing available memory +to the point that you are swapping to disk can slow the process +considerably. + +If you are having problems and would like to find the optimal memory +allocation, iteratively decrease the amount of memory available until +AJDE or ajc signals out-of-memory errors, and then increase that amount +by 5-10%. + +To increase memory for the ajc compiler, see #q:ajcoom[Q:The AspectJ +compiler aborts with an OutOfMemoryError when compiling many classes. +How can I fix this?]. For your IDE, do something similar or follow the +provider's instructions. For example, to increase memory in JBuilder, +edit the `jbuilderX/bin/jbuilder.config` file to have an entry like: + +.... +vmparam -Xmx384m +.... + +If it turns out that your project is too big to use with AJDE, your IDE +may nonetheless support external commands or Ant build processes, which +run outside the IDE memory space. For a JBuilder Ant plugin, some people +have directed us to http://antrunner.sourceforge.net[]. + +*Q:* When I run, I get a `NoAspectBoundException` or a ClassNotFound +message for `NoAspectBoundException`. + +*A:* This happens when an aspect is not associated with an object that +is being advised. We have seen this happen two ways: + +* You get a ClassNotFound message for `NoAspectBoundException` when +loading a class affected by aspects if `aspectjrt.jar` classes are not +on the runtime classpath. To fix this, put the classes on the classpath. +* You can get a `NoAspectBoundException` when there is a cycle in aspect +initialization or static initialization, most commonly when an aspect +advises its own initializer. To fix this, first find the class that +fails to load by running java in debug mode or looking at the +`NoAspectBoundException` trace, and then fix the offending (probably +unintended) dependency. Most often, it comes from a pointcut like +`staticinitialization(com.company..*)` or `within(com.company..*)`, +which can include any aspects in the same subpackages. You can avoid +advising most join points associated with the aspect `TheAspect` by +adding `&& !within(TheAspect)` to your pointcut. + +*Q:* My stack traces don't make sense. What gives? + +*A:* In 1.0, unless you are using the `ajdb` debugger, stack traces may +have synthetic methods in the stack, and the line numbers may not track +your source code. The link:devguide/index.html[Development Environment +Guide] discusses how to interpret stack at the end of the +link:devguide/ajc-ref.html[Reference for ajc]. + +In 1.1, line numbers should work correctly. The only difference from a +normal stack might be the addition of extra stack frames for call-backs. + +*Q:* My advice is not running (or running twice), and I don't know why. + +*A:* When advice is not running, there is probably a problem in the +pointcut. Sometimes users specify pointcuts that do not mean what they +intend - most often when they misspell a type name. Run the compiler in +`-Xlint` mode, which will flag some likely mistakes, like the type name. +If that does not work, and your pointcut is staticly-determinable, use a +declare statement to identify affected code. (For more information, see +#q:knowWhenAspectsAffectClasses[Q: How do I know which aspects affect a +class when looking at that class's source code?].) If that does not work +and your pointcut is dynamically determined, see if your join points are +executing at all by using TraceJoinPoints.java from +#q:seeingjoinpoints[Q:I don't understand what join points exist. How can +I see them?]. + +When advice is running more than it should, either (1) your advice is in +an abstract aspect and the pointcut picks out the same join point for +more than one concrete instantiation of the aspect, or (2) your pointcut +picks out more join points than you intend. + +In the case of advice in abstract aspects, the advice will run once for +each concrete instance of the aspect. If the pointcut for that advice +picks out the same join point for two concrete aspects, then the correct +behavior is for the advice to run the advice twice at that join point. + +To see if your pointcut picks out the join points you intend, you can +use IDE support, logging, or declare-warnings. If you are using IDE +support, you should be able to trace back from the pointcut or advice to +the join points which can be statically determined to be affected. +Without IDE support, you can write declare-warning statements to +identify code affected by staticly- determinable pointcuts. To identify +advised dynamic join points, you can try using `TraceJoinPoints.java` as +above, or update the advice to print the source location of the join +point. Doing any of these should show if the advice applies to code that +you did not expect. + +If you've done this and convinced yourself it's not working, it may be a +bug. See #q:bugreports[Q:How do I submit a bug report?]. + +*Q:* My advice runs for each overridden method! + +*A:* Most likely you are advising the method execution join point and +specifying the defining signature. Since all overriding methods share +this signature, the advice runs for each method executed. (This happens, +e.g., when one method invokes the same method in the superclass using +`super.{method}(..)`). This is the correct behavior. + +To avoid this, use the `call(..)` pointcut designator, or use +`!cflow(..)` to pick out only the initial method-execution. + +*Q:* I don't understand when thisEnclosingJoinPointStaticPart is +available. + +*A:* `thisEnclosingJoinPointStaticPart` is a special variable available +in the context of advice to refer to the join point, if any, lexically +enclosing the current join point: + +.thisEnclosingJoinPointStaticPart +[cols=",",] +|=== +|One of these... |will be tEJSP for each of these: + +|constructor-execution, method-execution, advice execution, +initialization, pre-initialization, static initialization +|constructor-call, method-call, handler, field-set, field-get +|=== + +Expressions in the body of handlers have the same +`thisEnclosingJoinPointStaticPart` as the handler itself. + +*Q:* I declared a member on a class with package access, but other +classes in the package cannot see it. + +*A:* When declaring parents on other types from an aspect, package +access only applies to code the implementation controls. For AspectJ +1.0, that is the set of files passed to the compiler. That means other +classes not compiled with the aspect will not be able to access the +aspect-declared members even if they are in the same package. The only +way for classes outside the control of the implementation to access +aspect-declared members is to declare them public. + +*Q:* I declared a member on a interface, but javac does not see it. + +*A:* You have to compile all the top-level implementating classes of the +interface using `ajc`. From an email by Jim Hugunin on the requirements +for AspectJ 1.1 to implement members declared by an aspect on an +interface: + +If you introduce non-static fields or non-abstract methods on an +interface from an aspect, then all of the top-most implementors of that +interface must be woven by that same aspect. (A class C is a top-most +implementor of an interface I if C implements I and the superclass of C +does not implement I.) + +*Q:* `ajc` 1.0 complains that it can't find `javac`. What's wrong? + +*A:* `ajc` 1.0 does not try to locate `javac` in your path: it uses the +`javac` classes directly. In JDK 1.2 and 1.3 these classes are found in +`tools.jar` (in the `lib` directory of the JDK distribution), which must +be on your classpath to make `ajc` work with `javac`. Inspect the java +command that launches ajc to make sure that `tools.jar` is on the +classpath for ajc; the -classpath option only applies to the sources +compiled. + +*Q:* I'm running under 1.4, but `ajdoc` asks for 1.3 (or throws +IllegalAccessError for HtmlWriter.configuration) + +*A:* The 1.0 implementation of `ajdoc` uses specific javadoc classes in +the J2SE 1.3 tools.jar. We are working on addressing this limitation, +but in the interim it is best to run ajdoc under 1.3. + +When running from the command-line scripts, edit the scripts directly to +put the 1.3 tools.jar first on the classpath. (The installer does not +know about this limitation of ajdoc.) + +When running from Ant, users often have tools.jar in $\{ant.classpath} +(to make javac, et al work). That makes it impossible to run the ajdoc +taskdef (which does not currently support forking), so you'll need to +run a separate ant process, either from the command-line or via Ant's +exec task (the Ant task will propagate the classpath). If the wrong +tools.jar is not on the ant classpath, then it should work to put the +1.3 tools.jar in the taskdef classpath. + +*Q:* I set up different files to my compiles to change what the aspects +see, but now I don't understand how the aspects are working. + +*A:* It is a bad practice to use the compilation unit to control +crosscutting. Aspects and pointcuts especially should be written to +specify crosscutting precisely. Aspects will behave the same when you +add files if you initially included all files affected by your aspects. +If you use the compilation unit, then your code will behave differently +in AspectJ implementations that do not limit themselves to specified +files. + +*Q:* I'm reading the code generated by `ajc` 1.0 in `-preprocess` mode, +and it seems like it would not work (or "like it works this way"). + +*A:* The generated code can be difficult for a human to read and +understand. The compiler uses implementation techniques which might not +be apparent. To determine if the code is behaving correctly, you should +write and run a program that attempts to provoke the error you suspect. +Similarly, you should not rely on invariants you infer from the +generated code (especially naming conventions for generated members). +Please rely only on the semantics stated in the appendix of the AspectJ +link:progguide/index.html[Programming Guide]. + +*Q:* I've heard AspectJ can generate or inject code into my code. Is +this true? + +*A:* This is a misconception spawned from the early implementation. + +AspectJ does not "inject" or "generate" code. In AspectJ the pointcut +constructs allow the programmer to identify join points, and the advice +constructs define additional code to run at those join points. + +So the semantic model of advice is like the semantic model of a method +-- it says "when any of these things happen, do this". + +People who worked with earlier versions of AspectJ, in which ajc was +very explicitly a pre-processor, sometimes thought of AspectJ as +injecting code. But that was an artifact of the implementation, not the +underlying language semantics. + +This distinction is important for two reasons. One is that thinking +about it this way will make more sense at the implementation continues +to evolve towards load-time or runtime weaving. The other is that it +makes it much easier to understand the semantics of advice on cflow +pointcuts. + +*Q:* Why can't AspectJ pick out local variables (or array elements or +...)? + +*A:* Users have sometimes wanted AspectJ to pick out many more join +points, including + +* method-local field access +* array-element access +* loop iteration +* method parameter evaluation + +Most of these have turned out not to make sense, for a variety of +reasons: + +* it is not a commonly-understood unit for Java programmers +* there are very few use-cases for advice on the join point +* a seemingly-insignificant change to the underlying program causes a +change in the join point +* pointcuts can't really distinguish the join point in question +* the join point would differ too much for different implementations of +AspectJ, or would only be implementable in one way + +We prefer to be very conservative in the join point model for the +language, so a new join point would have to be useful, sensible, and +implementable. The most promising of the new join points proposed are +for exception throws clauses and for synchronized blocks. + +*Q:* Why doesn't AspectJ pick out reflective calls? The pointcut +`call(void run())` won't pick out a call using reflection, like +`((Method)run).invoke(null, args)`. + +*A:* The pointcut `execution(void run())` will work. The call pointcut +doesn't work because `Method.invoke(..)` is the Java method-call, and +AspectJ cannot delve into the Java reflection library to implement call +semantics. To advise a reflective call (e.g., because the compiler does +not control the code for the method execution), test the context for +`invoke(..)`. Here's a pointcut that tests only if the method name is +correct: + +.... +aspect A { + pointcut runReflectiveCall(Method run) : target(run) && + call(Object Method.invoke(..)) && if("run".equals(run.getName())); + before() : runReflectiveCall(Method) { + System.out.println("before reflective call " + thisJoinPoint); + } +} + +.... + +*Q:* What are the bugs now most affecting users? + +*A:* The bugs affecting the semantics of the language are marked with +the "info" keyword. Find them with the query +http://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&keywords=info + +*Q:* What extra memory is required at runtime? + +*A:* When running classes produced by the AspectJ weaver or compiler, +there are no significant hidden uses of memory. As would be expected, +each aspect is instantiated. The per-object aspects (like `pertarget` or +`perthis`) in some implementations use a map to link aspects and the +associated object. When using `cflow`-related pointcuts, a `ThreadLocal` +is used to track control flow for each affected thread. + +Of course, the size and code in an aspect can require memory. Aside from +normal Java practices, take care with join point references. When +referencing the static part of a join point (e.g., +`thisJoinPointStaticPart`), only one object is created. However, if you +reference the join point itself (e.g., `thisJoinPoint`), then one +`JoinPoint` object will be created for each join point running advice. + +Aspect instances will be garbage collected just like regular objects +after there are no more strong references to them. For the default +aspect instantiation model, `issingleton`, the aspect class retains a +reference to the singleton instance, in order to implement +`static {AspectClass} aspectOf()`, so singleton instances will not be +garbage collected until the class is. For long-running or +memory-critical programs, consider using weak references in singleton +aspects for state that should be garbage collected. + +Finally, when using load-time weaving, the weaver can require memory in +its own right. Because the class loader never can know when it is done +loading classes, the weaver can hold on to the aspects required to weave +for some time. There are strategies for minimizing this (with different +trade-off's), so the time and memory required for load-time weaving will +vary as load-time weaving evolves. + +*Q:* I get a VerifyError when running CGLIB generated code that has been +woven by AspectJ. Why is this? + +*A:* When weaving after advice into any piece of code, the AspectJ +strategy is to make all exit points from that code jump to a single exit +point that executes the advice before returning. There is a verifier +rule in the JVM specification that specifies that all routes to a jump +destination must have the same height stack when they get there, +regardless of the route taken to get there through the bytecode. The +CGLIB generated code has different stack heights at the various exit +points. This is not a problem with the CGLIB generated code, it is +perfectly valid - it is just unusual and the AspectJ weaving strategy +causes the verify error to trigger when it makes all exits jump to a +single destination. + +AspectJ could cope with this and instead implement after advice by +calling the advice and returning at each exit point. However, it is +unlikely that the user actually meant to weave the CGLIB generated code +in the first place - and so usually the right thing to do is to exclude +CGLIB generate code from the weaving process by appropriate use of the +exclude element in the aop.xml. A typical clause in the aop.xml might +look as follows: + +.... + + + + +.... + +[[aj11]] +== AspectJ 1.1 and eclipse.org + +*Q:* Why did the AspectJ project move to eclipse.org? + +*A:* From the message sent to users: + +AspectJ has come a long way -- the language has stabilized; there are a +rapidly growing number of commercial users; the 1.1 release is imminent +and will include byte-code weaving and incremental compilation; and the +tool support is now well integrated with several major IDEs. + +This growth of the community and the technology means that the original +research and prototype development of AspectJ is complete. As such it is +time for ongoing development and support of AspectJ to move outside of +PARC. This has already started to happen; the Eclipse AJDT plug-in and +the several books in preparation are examples. + +To encourage the growth of the AspectJ technology and community, PARC is +transferring AspectJ to an openly-developed eclipse.org project. This +project will include documentation, web site, mailing lists, bug +database, and sources for the compiler. The command-line AspectJ +compiler is still the primary tool produced by this project, in addition +to APIs that support integration with a variety of IDEs. The Eclipse +plug-in will remain at eclipse.org, while the NetBeans, JBuilder and +Emacs support will move to SourceForge.net projects. We look forward to +your involvement with and contribution to those projects. + +We see Eclipse as an excellent new home for core AspectJ technology +development -- it is an active community of Open Source development and +innovation in the Java space. Once development moves to Eclipse.org, +others will be able to contribute more easily. + +*Q:* Do I have to download Eclipse to use AspectJ? + +*A:* No. The AspectJ tools download is completely self-contained and +does not require that you work in Eclipse. For information on IDE +support, see #q:integrateWithDevTools[Q: How well does AspectJ integrate +with existing Java development tools?]. + +*Q:* What are the relationships between AspectJ, JDT, Eclipse, AJDT, and +IDE support generally? + +*A:* Eclipse is a software platform. + +JDT is an eclipse project to support Java development. JDT has a Java +compiler. + +AspectJ 1.1 is built on Eclipse/JDT's Java compiler but is distributed +standalone and can run standalone. With the AspectJ distribution, you +can compile and run AspectJ programs and use the AspectJ structure +browser. + +AJDT is an eclipse project to integrate AspectJ into Eclipse/JDT so you +can use Eclipse to develop AspectJ programs. AJDT aims to support the +full Eclipse experience - searching, compiler-error tasks, etc. AJDT +will use the AspectJ Development Environment (AJDE) API's for creating +IDE integrations, as well as hooking in to the model underlying the Java +compiler. + +Similarly, Sourceforge has projects integrating AspectJ into other +development environments using the AJDE API's: +http://aspectj4emacs.sourceforge.net[AspectJ for Emacs], +http://aspectj4jbuildr.sourceforge.net[AspectJ for JBuilder], and +http://aspectj4netbean.sourceforge.net[AspectJ for NetBeans]. + +This is the right level of separation/integration. AspectJ is available +standalone, leverages an existing open-source compliant Java compiler, +and supports external projects doing IDE integrations in Eclipse, Emacs, +JBuilder, and NetBeans through a common API, AJDE. + +[[AspectJ5]] +== AspectJ 5 and Java 5 + +*Q:* What are the new features of AspectJ 5? + +*A:* All the new features are documented in the +link:adk15notebook/index.html[AspectJ 5 Developer's Notebook] and the +link:devguide/index.html[AspectJ Development Environment Guide]. To +summarize: + +* Java 5 support: as an extension to Java, AspectJ supports all the new +language features of Java 5, including generics (parameterized types), +autoboxing, covariant return types, enhanced for-loops, enums, varargs, +and of course annotations. +* Java 5 extensions: the AspectJ language has been extended to make use +of Java 5 language features. +** Generic aspects: an abstract aspect can be declared with a generic +type parameter which can be used in pointcuts and when declaring members +on the aspect (but not when declaring members on other types). +** Annotations: pointcuts can now pick out join points based on the +associated annotations, annotation values can be bound in the same way +that other context variables are bound at the join point, and +annotations may be declared on other types in an aspect. +* Annotation-style aspects: AspectJ 5 integrates AspectWerkz-style +aspects declared in annotations. This permits aspects to be written and +compiled in pure-java code and woven using build-time or load-time +weaving with the AspectJ weaver. (The original AspectJ language aspects +are distinguished as "code-style" aspects.) +* AspectWerkz load-time weaving: Load-time weaving is greatly improved +for all versions of Java, and now supports an XML configuration file +which can declare concrete aspects. This means developers can deploy +binary abstract aspects that deployers configure using only XML. +* pertypewithin instantiation model: aspects may now be instantiated on +a per-class basis. +* Reflection and runtime support: AspectJ 5 supports reflection on +aspects using the Aspect class, and also support runtime evaluation of +pointcuts using a pointcut parser. + +*Q:* Should I use code- or annotation-style aspects? + +*A:* To use AspectJ, you can use the original code-style aspects or the +annotation-style aspects new in AspectJ 5. + +The original code-style is a small extension of the Java language +designed to express crosscutting as clearly as possible in ways familiar +to most Java programmers. To use the original code-style aspects, +compile them with the AspectJ compiler or weave pre-compiled binary +aspects using the AspectJ binary (.class) weaver, either at build-time +or at class-load-time. Code-style aspects have excellent IDE support, +allowing you to navigate to and from affected source code. + +Annotation-style aspects are written (not surprisingly) using +annotations. They use the subset of the AspectJ language that works when +aspects are woven after the code is compiled. The source files are +compiled with Javac, which simply saves the annotations in the .class +files. The resulting .class files must be woven using the AspectJ +weaver, which reads the annotations from the .class file and uses them +to define aspects. Annotation-style aspects have the benefit of being +compilable by Javac, but you can't use the full AspectJ language, and +you don't enjoy the same level of IDE support for viewing crosscutting +structure. + +*Q:* What's new about the load-time weaving support in AspectJ 5? + +*A:* While the AspectJ weaver could be used at load-time in previous +releases, the AspectJ 5 release supports much better integration with +the Java 5 VM and the BEA JRocket JVM. It also supports an XML file for +configuration that allows deployers to declare concrete aspects using +only XML. This means aspect developers can write abstract aspects, and +deployers need only configure `aop.xml` and run using the AspectJ weaver +in Java 5. For example, to run Java 5 VM with load-time weaving, + +.... +java -javaagent:aspectjweaver.jar -classpath "aspects.jar:${CLASSPATH}" .. +.... + +To declare a concrete aspect, add a a concrete-aspect XML entity to +`META-INF/aop.xml`. This example extends a tracing aspect to apply to +every type in the application: + +.... + + + +.... + +For more information, see the link:devguide/index.html[AspectJ +Development Environment Guide]. + +[[Technology]] +== Understanding AspectJ Technology + +*Q:* Do I need to know how the compiler or weaver works? + +*A:* Writing AspectJ programs only requires understanding the +link:progguide/index.html[Programming Guide]. However, current +implementations do not control everything in a system, so AspectJ +program semantics may be limited to code the implementation controls. +For our implementation, these limitations are stated in +link:progguide/implementation.html[Programming Guide Appendix: +Implementation Notes]. Aside from understanding the use and limitations +of the implementation, there is no need to understand the underlying +technology when writing AspectJ programs. + +The technology that implements AspectJ interests some academic +researchers and some developers who want new features or new ways to +weave. These extensions are not discussed in the documentation. Some are +being developed already, others are on the drawing board (or perhaps +were left off long ago), and still others haven't been considered. If +you are interested in a certain extension, check the bug database for +feature requests and the mailing list archives for any past discussions. +Then email the list to see if it's been considered. For more +information, see xref:#Developers[AspectJ Project Development]. + +*Q:* How does the compiler/weaver work? Are there any white papers? + +*A:* There are currently no documents describing this process in detail. +You can compile programs and inspect the generated source or bytecode, +or view the source code (see xref:#Developers[AspectJ Project +Development]). We hope to write papers on the bytecode weaving model +used in AspectJ-1.1 if we can find the time. Erik Hilsdale and Jim +Hugunin did draft a paper for AOSD 2004, now available on Jim's web +site: http://hugunin.net/papers.html Jim summarized advice weaving in +the AspectJ 1.1 implementation in the +http://dev.eclipse.org/mhonarc/lists/aspectj-dev/msg00519.html[following +mailing-list reply]: + +Each piece of advice in an aspect is associated with a pointcut. This +pointcut is stored in an attribute on the methods corresponding to each +piece of advice. Before weaving, all of these pieces of advice are +gathered into one large list. + +Each .class file is woven independently. A .class file is woven by the +following steps: + +* Collect all of the joinpoint shadows in the .class file. For every +dynamic joinpoint in the AspectJ language model, there is a +corresponding static shadow of that joinpoint in the bytecode. For +example, every method call joinpoint has an INVOKE bytecode as its +static shadow. Some joinpoints (such as initialization) have much more +complicated static shadows. +* Each piece of advice is matched to each static shadow. There are three +results possible from this match. +** Never matches, in which case nothing is done to the shadow +** Always matches, in which case the advice is woven into this joinpoint +shadow +** Sometimes matches, in which case the advice is woven into the shadow +along with the minimal dynamic tests to determine if any particular +joinpoint in the actual running program matches the advice. The simplest +example of sometimes matches is when the pointcut uses if(test()). +* If any advice matched any static shadows in the .class file, then the +transformed .class file is written out, otherwise it is left unchanged. + +See `BcelClassWeaver` and `BcelShadow` in the `org.aspectj.weaver.bcel` +package for the two primary classes involved in this process. + +Note: This explanation ignores the implementations of inter-type +declarations completely. It also ignores performance optimizations such +as fast-match or pipelining that speed up the process. + +*Q:* How do I get load-time weaving to work in my chosen application +server? + +*A:* You have two choices based on how wide you want the weaving to take +effect: application-server wide and application-specific weaving. You +choose between the two by loading aspect artifacts--aspects, associated +types, and aop.xml--through the right classloader. The aop.xml must be +in the META-INF directory on the classpath for the chosen classloader. +In either case, you modify the startup script to specify the +-javaagent:path-to/aspectjweaver.jar option to the Java virtual machine. +Note that it is not essential that all the artifacts be placed in a +single jar. + +For application-server wide weaving, you make aspect artifacts +accessible to the server's classloader. Typically, you achieve such +access by putting these artifacts in the server's lib directory. For +example, for Tomcat, you will place the aspect artifacts in the +TOMCAT_HOME/lib directory. + +For application-specific weaving, you make aspect artifacts accessible +to application classloader by bundling them along with application's +classes. For example, for a web application, you will place the aspect +artifacts in the MY_APP/WEB-INF/lib and/or MY_APP/WEB-INF/classes +directory. + +We recommend that you start with application-specific weaving. Note that +you have an additional option if your application is based on the Spring +framework. If you deploy in one of the supported web servers or +application servers, you can avoid modifications to the startup script. +Please see +http://static.springframework.org/spring/docs/2.5.x/reference/aop.html#aop-aj-ltw-spring +for more details. + +*Q:* Does AspectJ use reflection at runtime? + +*A:* The only time that reflection is used during run-time is when the +special thisJoinPoint object is used to discover reflective information +about the join point. If you don't use thisJoinPoint then no reflection +will be used. + +*Q:* What about load-time weaving? Can I weave aspects at runtime? + +*A:* Since the 1.1 release, AspectJ can weave binary aspects into +classes in bytecode form. Hooked up to a class loader, this can weave +class bytecodes after they are read in, before the class is defined by +the VM. (This means load-time weaving only works were aspects are not +required to compile the pure-java classes. If the aspects are required, +then the Java classes have to be compiled with the aspects using the +AspectJ compiler.) The AspectJ 1.2 release had the +WeavingURLClassLoader, and the 1.2.1 release introduced the aj.bat +script for Java 1.4. The AspectJ 5 release introduces much better +support for load-time weaving, including declaring concrete aspects in +XML files and integrating with Java 5 and BEA JRocket JVM's. See +#q:aspectj5ltw[Q:What's new about the load-time weaving support in +AspectJ 5?]. + +Some have asked about only weaving particular classes specified at +run-time. Aspects should work across an entire namespace, and problems +will likely result from weaving some classes but not others. Also, it's +confusing to specify crosscutting both in the aspect and in the list of +runtime classes; the crosscutting specification should be in the aspect +itself, where it can be processed by tools. + +And just to state the obvious: do not use bytecode weaving, at load-time +or otherwise, to modify .class files protected by license, without +permission from the licensor. + +[[Developers]] +== AspectJ Project Development + +*Q:* I'm interested in the code implementing AspectJ. + +*A:* Most people do not need to see the code for AspectJ; they can +download the binary distribution for documentation and tools for writing +AspectJ programs. + +For people who want to know how the AspectJ technology works, the source +code is the best resource, until we write some proper white papers (see +#q:implementation[Q:Do I need to know how the compiler works?]). To get +and compile the Java source code for the AspectJ distribution, see +#q:buildingsource[Q:How do I get and compile the source code for +AspectJ?]. + +Bear in mind when looking at the code that there are many ways to +implement the AspectJ language, and the code inspected might be an +initial version of a new architecture (e.g., bytecode weaving). + +*Q:* How can I get involved with developing the AspectJ project? + +*A:* For those who want to contribute to the project, here's a general +list of ways to do so, in no particular order: + +* Participate effectively in the mailing lists. The quality of the +mailing lists makes a huge difference in the ability of new and +experienced AspectJ users to write good code. For guidance on effective +participation, see #q:talktousers[Q:How do I communicate with other +AspectJ users?] and #q:writingbugsandemails[Q:How should I write email +queries?]. Also, the time that experienced users take in answering +emails can directly translate to time developers can use (instead) for +fixing bugs or adding features. +* Write bugs. Good bugs, especially with test cases, are always +appreciated. We especially like proposals for new `XLint` messages, +since they are sometimes easy to implement and help users learn AspectJ, +and for other implementable features grounded in a compelling use-case. +* Write test cases for compiler bugs without test cases. Compiler bugs +without test cases are much less likely to be fixed; until they are +rendered in code, they might be user mistakes, and they might duplicate +another bug or actually cover many bugs. ++ +Find them by searching open compiler bugs and picking out any which do +not have test case attachments or a comment that a test case has been +written. Here is a query for open compiler bugs: +http://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&component=Compiler&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED ++ +For how to write test cases, see #q:harnesstestcases[Q:How should I +submit test cases for bugs?]. +* Write patches to fix bugs. If you particularly need a bug to be fixed, +or if you're interested in learning about the system, then get the +source code and try to fix the bug. Most likely you'll want to email +aspectj-dev@eclipse.org to declare your intentions and the approach you +propose (based on having looked at the code). Mailing the list gives +those experienced with the code a chance to guide you away from +pitfalls. To submit the patch, attach it to the bug. (When creating +patches, do so on a per-module basis; that means if fixing the bug +involves changes to three modules, submit three patches.) +* Write patches for other reasons. Often documentation needs to be +fixed, or there may be a small new feature you'd like to see. You can +just do it and then submit it as a patch to a bug you create. As with +bugs, in some cases you might want to declare your intentions on the +mailing list to avoid wasting time on something that's been fixed but +not committed or on an approach that will be fruitless. + +*Q:* How do I get and compile the source code for AspectJ? + +*A:* AspectJ 1.0 source code is available in an archive available with +the 1.0 downloads. It contains instructions for building from sources. + +AspectJ 1.1+ source code is available through CVS using the CVS Root +`dev.eclipse.org:/cvsroot/technology`. For more information on accessing +the CVS tree at eclipse.org, see the documentation from +http://eclipse.org. Find specific instructions in the AspectJ tree at +http://dev.eclipse.org/viewcvs/index.cgi/~checkout~/org.aspectj/modules/build/readme-build-and-test-aspectj.html?rev=HEAD&content-type=text/html&cvsroot=Technology_Project[org.aspectj/modules/build/readme-build-and-test-aspectj.html]. +If you would like to use Ant to checkout the sources, build the +distribution, and test everything, see +http://dev.eclipse.org/viewcvs/index.cgi/~checkout~/org.aspectj/modules/build/release/build.xml?rev=HEAD&content-type=text/xml&cvsroot=Technology_Project[org.aspectj/modules/build/release/build.xml]. + +To check out the source code in Eclipse go to +(`File > new > Other > CVS > Checkout Projects from CVS`). You'll need +about 125 MB of space for the source and build. Host: `dev.eclipse.org`, +Repository Path: `/cvsroot/technology`, user name: `anonymous`, +password: (your email address), connection type: `pserver`, default +port. Then select the individual modules you want to check out (you +probably want all of them bar aspectj-attic and java5) and click Next +and choose to check out the modules you selected as Java projects. Once +thats done each module you checked out should show up as a project in +the package explorer. If you have problems after this point you can view +the build instructions that come with AspectJ by going in the package +explorer to: `build > readme-build-and-test-aspectj.html`. + +To get the modules to build you have to set some classpath variables +(`Window > Preferences > Java > Build Path > Classpath Variables`): + +* Name: `JAVA_HOME`, Value: (wherever your Java JDK is installed) +* Name: `JRE14_LIB`, Value: (wherever your Java 4 Runtime is +installed)`\jre\lib\rt.jar` +* Name: `JRE15_LIB`, Value: (wherever your Java 5 Runtime is +installed)`\jre\lib\rt.jar` +* Name: `ASPECTJRT_LIB`, Value: (wherever your workspace +is)`\lib\aspectj\lib\aspectjrt.jar`. To find out where your workspace is +go to `File > Switch Workspace`. + +The `org.aspectj.lib` project is an AspectJ project so you also have to +have AJDT installed. For the latest AJDT release and download +instructions visit the http://www.eclipse.org/ajdt/downloads/[AJDT +Downloads] page. + +When you've added the variables click OK to do a full rebuild, then run +the tests by going in the Package Explorer to: +`run-all-junit-tests > testsrc > (default package) > RunTheseBeforeYouCommitTests.java` +and running this as a JUnit test (right click and select +`Run As > JUnit Test`). Don't worry about any errors that appear in the +console output, just check that there are no failures in the JUnit view +(`Window > Show View > Other > Java > JUnit`). If that finishes with no +Failures and a full green bar you have the AspectJ compiler source and +it's building and testing properly. + +Further details: + +You can check out the entire modules directory and build using the Ant +build script `modules/build/build.xml`. All required libraries are +included in `modules/lib/`, (including Ant 1.5.1 in `modules/lib/ant`). +If you are using Eclipse, you can check out any `modules/` subdirectory +as an eclipse Java project. Depending on what you are trying to build, +you need not check out all modules; as of this writing, here are the +modules to get for building the specific parts of AspectJ: + +* For any builds: build, lib +* For the documentation: docs +* For the compiler: bridge, util, testing-util, weaver, asm, +org.eclipse.jdt.core, org.aspectj.ajdt.core, and runtime. +* For ajbrowser: the compiler modules, plus ajbrowser, ajdoc, taskdefs, +and ajde. +* For the AspectJ distribution, the ajbrowser modules, plus aspectj5rt +and org.aspectj.lib. +* For the test harness (or to run the release build scripts and tests): +the ajbrowser modules, plus testing, testing-client, and +testing-drivers. +* To run the test suite: the test harness modules, plus tests. + +Note that module interdependencies are recorded only in the eclipse +`modules/{module}/.classpath + ` files and may change, so the list above may not be correct +when you read it. + +*Q:* How do I build AspectJ and integrate it into AJDT? + +*A:* To build AspectJ, first get the source tree as described in +#q:buildingsource[Q:How do I get and compile the source code for +AspectJ?]. Once you have a development environment set up, copy the +`build/sample-local.properties` file to `build/local.properties` and +within this file point the `java14.home` and `java15.home` to the +corresponding places on your machine. + +To build AspectJ on the command line: + +* Open a command prompt +* Navigate to the `build` directory within your AspectJ workspace (to +find out where your workspace is go to `File > + Switch Workspace` within Eclipse). +* Run `ant clean` to remove the files from previously built AspectJ +versions. +* Run `ant` to build AspectJ. The built files are created in +`your_eclipse_installation_directory/aspectj_development_workspace/aj-build`. + +To import a locally built AspectJ into AJDT first follow the +instructions on http://www.eclipse.org/ajdt/faq.php#q:develop[How do I +setup an AJDT development environment in Eclipse?] for setting up an +AJDT development environment and running the correctness tests. Then: + +* Create a file `aspectjlib.properties` within the `org.aspectj.ajde` +project and add the following two lines ++ +.... +aspectj.lib.dir=C:/eclipse/aspectj-workspace/aj-build/dist/tools/lib +aspectj.doc.dir=C:/eclipse/aspectj-workspace/aj-build/dist/ide/eclipse/org.aspectj.ajde.doc/doc + +.... ++ +making sure to change the path to correspond to your set up. +* Run the `build.xml` file in `org.aspectj.ajde` with the `plugin jars` +target: +** Right click on the `build.xml` file in the `org.aspectj.ajde` plugin +** Select `Run As > Ant build...` +** In the resultant dialog navigate to the `Targets` tab +** Ensure `plugin jars` is the only selected target +** Click `Run` +* Refresh the `org.aspectj.ajde, org.aspectj.runtime` and +`org.aspectj.weaver` plugins. + +*Q:* Where do I find developer documentation on building and testing +AspectJ source code? + +*A:* Find the developer documentation in HTML files in the CVS tree, +inside the `build` and `testing` modules (i.e., in +`org.aspectj/modules/build/...`). Most pertinant: + +* `../build/readme-build-and-test-aspectj.html` describes how to build +the AspectJ distribution in Eclipse and in Ant. +* `../build/readme-docs-module.html` describes the AspectJ documentation +sources and how to build the documentation using Ant. +* `../build/readme-tests-module.html` describes the all the tests in the +`tests` module. +* `../build/readme-writing-compiler-tests.html` describes how to write +compiler tests that can be run by the AspectJ test harness. +* `../build/readme-testing-drivers-module.html` describes the test +harness used to run the compiler tests in the `tests` module. +* `../build/readme-testing-drivers-module.html` describes the test +harness used to run the compiler tests in the `testing` module. + +*Q:* How should I submit test cases for bugs? + +*A:* You can attach files to a bug after it has been created. The code +of course should replicate the actual behavior described in the bug when +run on the target version. If you have a single source file, you can +attach it directly, describing in the comments the expected result +(e.g., error on line 14, or successful compile/run). The most helpful +form for describing the test scenario and the expected results are the +test definitions described next. + +For more complex bugs requiring many files, create a zip file of a +directory containing all the files and an XML test definition file. The +XML test definition file contains specifications for how to compile, +recompile, or run the test sources. Complete documentation is available +in the CVS tree at `tests/readme-writing-compiler-tests.html` but here +is a sample file with some example definitions, preceded by comments +showing the directory layout of the files referred to in the test +definitions. + +.... + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +.... + +*Q:* I'd like to run my test case. How do I get the test harness? + +*A:* The test harness is not distributed. To build it, get the source +tree as described in #q:buildingsource[Q:How do I get and compile the +source code for AspectJ?] and then build the `build-testing-drivers` +target: + +.... +cd build +../lib/ant/bin/ant -f build.xml build-testing-drivers + +.... + +This produces `../aj-build/jars/testing-drivers-all.jar` which you can +run as described in `tests/readme-tests-module.html`. + +*Q:* BCEL is used by AspectJ but it's not actively developed. Will you +change? + +*A:* The AspectJ bytecode weaver has used BCEL for bytecode manipulation +since its first release. We have upgraded it extensively, to improve +performance, support Java 5, etc. The BCEL developers have not +incorporated our patches, so we continue to maintain our own version. +Ours has been optimized for the AspectJ weaver and battle-hardened over +years of development and use. At some point in the future, the AspectJ +weaver might be restructured to make it easy to see whether another +bytecode package offers the same stability, functionality, and +performance, but for now we prefer using something that we know works +well. + +In the AspectJ 5 release, the weaver has been restructured to use +reflection where possible. Otherwise, it continues to use BCEL, but does +not hold BCEL structures in memory after our evaluation completes. + +[[help]] +== Getting Help + +*Q:* How do I find out more about AspectJ? + +*A:* Visit the AspectJ project web site: http://eclipse.org/aspectj. + +*Q:* How do I submit a bug report? + +*A:* You can submit a bug from +http://bugs.eclipse.org/bugs/enter_bug.cgi?product=AspectJ . If it seems +to be a bug in the compiler, please attach a small test case (source +code) to reproduce the problem. For more information on writing compiler +test cases, see #q:ajcbugs[Q:How do I write bugs for the AspectJ +compiler?]. If you are unable to submit a test case, consider submitting +traces, ajcore files, and/or .class dump files, as described in the +link:pdguide/index.html[AspectJ Problem Diagnosis Guide]. + +*Q:* How do I communicate with other AspectJ users? + +*A:* You can reach other AspectJ users by using the aspectj-users +mailing list. You can subscribe to the list or view the list archives +from the AspectJ home page http://eclipse.org/aspectj . + +*Q:* How can I search the email archives or the web site? + +*A:* It is very effective to do a google search of the form, +http://www.google.com/search?q=site:eclipse.org+cflowbelow , and you can +use the eclipse.org search at http://www.eclipse.org/search/search.cgi . +You can also check the old archives available for download from the +AspectJ home page http://eclipse.org/aspectj . + +*Q:* How should I write email queries? + +*A:* Here's the general form of a good email: + +[arabic] +. Describe the big picture of what you are trying to do... +. Describe what you think it takes, in AspectJ terms (concepts, syntax, +and semantics) from the link:progguide/index.html[Programming Guide]... +. Show the AspectJ code you are using, what output it produces when run, +and what output you expect... + +The big picture helps others redirect you to other approaches. Using +AspectJ terms helps others correct mistakes in thinking about the +problem (the most common being to confuse join points and pointcuts). +The code is key to clarifying your question and getting a good response. +On the mail list, someone can reply by fixing your code. In bugs, the +developers can reproduce the problem immediately and start analyzing the +fix. The code should not be incomplete; it should run (or fail) as-is, +without additional libraries or source files. + +For the mail lists, we try to follow the conventions for open-source +discussions that help avoid "the tragedy of the commons." For example +conventions, see http://jakarta.apache.org/site/mail.html and +http://www.tuxedo.org/%7Eesr/faqs/smart-questions.html . + +*Q:* How do I write bugs for IDE support? + +*A:* Bugs appearing in the IDE's may apply to the affected IDE or to the +compiler. Compiler stack traces in IDE message windows are prefixed +"Internal Compiler Error" and should be written up as compiler bugs. If +you are unsure, try redoing the compile from the command line. + +Bug report for the IDE extensions go to their respective projects, +listed in #q:integrateWithDevTools[Q: How well does AspectJ integrate +with existing Java development tools?] (including bug reports for the +AJDE Eclipse support, which you can submit at +http://bugs.eclipse.org/bugs/enter_bug.cgi?product=AJDT ). + +Bug reports on ajbrowser should have version information for both Java +and AspectJ, and (most importantly) clear steps for reproducing the bug. +You may submit ajbrowser bugs against the IDE component of AspectJ via +the web form http://bugs.eclipse.org/bugs/enter_bug.cgi?product=AspectJ +. + +One of the benefits of open-source is that you can find and fix the bug +for yourself; when you submit the fix back to us, we can validate the +fix for you and incorporate it into the next release. You can submit a +patch by attaching it to the bug. + +*Q:* How do I write bugs for the AspectJ compiler? + +*A:* The best compiler bug report is a reproducible test case, +standalone code that demonstrates the problem. Sometimes with aspects, a +test case requires several files, if not some way to capture the +behavior. Here's how we recommend submitting test cases: + +[arabic] +. Write the test case so that when the compiler bug is fixed, the test +completes normally without output (e.g., expected compiler errors are +issued, or classes produced run correctly). This usually means writing +one or more source files. +. In the bug report, briefly summarize the bug. If it is not obvious, be +sure to specify the expected output/behavior (e.g., compiler error on +line 32) and, if the compile should complete, the main class to run. +. Submit the bugs via the web form +http://bugs.eclipse.org/bugs/enter_bug.cgi?product=AspectJ . +. Attach the test case to the bug. The test case may be a single file or +it may be multiple files in a single zip archive, of the form discussed +in #q:harnesstestcases[Q:How should I submit test cases for bugs?]. + +*Q:* Can you recommend reading or teaching material for AspectJ? + +*A:* The documentation available in the distribution is the best source +for language and usage questions. You can also find selected AspectJ +papers and presentations on the +http://www.parc.com/groups/csl/projects/aspectj/index.html[PARC AspectJ +page]. For links to Aspect-oriented programming materials in general, +see http://aosd.net. + +*Q:* Where can our group get consulting and support? + +*A:* The best thing to to is join and email the +`aspectj-dev@eclipse.org` mailing list. + +*Q:* What has changed since the last FAQ version? + +*A:* Entries changed recently: + +* #q:license[Q:How is AspectJ licensed?] +* #q:productplans[Q:Is it safe to use AspectJ in my product plans??] +* #q:whitepapers[Q:How does the compiler/weaver work? Are there any +white papers?] +* #q:bugreports[Q:How do I submit a bug report?] + +[[project]] +== About the AspectJ Project + +*Q:* What does the fact that AspectJ is an Open Source Project mean to +me? + +*A:* Open source protects your interest in a correct, long-lived, +up-to-date, and widely-accepted implementation of AspectJ. + +* With the source code, you control your own destiny in perpetuity. You +can continue to use the implementation and update it as necessary to fix +bugs and add things you need. +* Because the code is available to all, anyone can find and fix bugs. +There is no need to hope for it to be fixed in the next product release. +Those who encounter the bugs are motivated to fix them, and there are +more eyeballs on the code than in closed-source, so the quality tends to +be high. This can be particularly true for the AspectJ community, which +tends to be highly skilled. +* The same is true of new features or behavior, so the implementation +should be up-to-date. This is important as the field of AOP develops, to +capture the latest solutions. +* For a programming language which forms the basis of an entire solution +stack, open source facilitates the kind of adoption -- tool integrations +and significant projects -- that develop and prove the technology for +wider adoption. This limits delays caused by waiting for the completion +of standards process or promulgation by industry leaders, and also +provides the proofs necessary for such adoption. + +*Q:* What are your plans to make AspectJ a general feature of Java +supported by Sun and the other key players in the Java Industry? + +*A:* Although we are committed to making AspectJ available to a wide +range of users, it is too early to decide on a strategy. Some options +include continuing AspectJ as a stand-alone product, integrating it into +IDEs, or possibly incorporating it into standard Java with Sun's +blessing. + +We currently focus on developing for the 1.1 implementation which +improves AspectJ in key areas: rapid incremental compilation, bytecode +weaving, and IDE integration. + +Through all of this our goal is to make AspectJ integrate as seamlessly +as possible with the Java programming language. The AspectJ language +design is becoming more integrated, the compiler is becoming faster and +more integrated, the IDE extensions are becoming more integrated. All of +this is designed to help users really use AspectJ and give us feedback +on it. + +As the system is improved and we work more closely with users, we will +be in good position to explore the best path for AspectJ in the long +term. + +*Q:* When will AspectJ work from class files? When will it work at +class-loading time? + +*A:* Bytecode weaving is in AspectJ 1.1. We believe it works as +described in an email to the users list by Jim Hugugin: + +The AspectJ language was designed to support weaving at many different +times: compile, load, or even run-time in the JVM. Weaving into +bytecodes at both compile and load-time will definitely be provided in a +future release. This will allow weaving at compile-time into libraries +for which source code is not available. It will also support +aspect-aware class loaders that can perform weaving at load time on +arbitrary classes. One advantage of a language like AspectJ, rather than +an explicit meta-tool like jiapi, is that it separates the specification +of a crosscutting concern from any particular implementation strategy +for weaving. + +...AspectJ provides a language that can cleanly capture crosscutting +concerns while preserving the static type checking, modularity, and +composability of Java. + +If you have an application for using aspects and bytecode, please let +the AspectJ team know of your requirements. We expect to have a +demonstration classloader available in the 1.1 release or soon +thereafter. + +*Q:* What are the differences between the current and previously +released versions of AspectJ? + +*A:* The AspectJ team aims to keep the implementation bug-free and +up-to-date with the Java language, to limit AspectJ language changes to +those that are carefully considered, compelling, and +backwards-compatible, and to deliver those language changes only in +significant releases (1.0, 1.1). + +[cols=",",] +|=== +|Version |Description + +|AspectJ 1.5 |Upgrade to support Java 5 language and much better +load-time weaving. See README-150.html for more details. + +|AspectJ 1.1 |A few language changes and clarifications; bytecode +weaving and incremental compilation. See README-11.html for more detail. + +|AspectJ 1.0 |Many language changes, fixes, cleanup and clarifications, +some significant. + +|AspectJ 0.8 |More cleanup of the syntax and semantics. + +|AspectJ 0.7 |Clean up of the semantics, 0.7 beta 4 is the first open +source release. + +|AspectJ 0.6 |Advice and crosscuts get explicit type signatures which +describe the values that are available to advice at a crosscut. + +|AspectJ 0.5 |Improved tool support: better Emacs environment support +and `ajdoc` to parallel `javadoc`. around advice is added, and the +`aspect` keyword is removed and replaced by the Java keyword class. + +|AspectJ 0.4 |Clear separation of crosscuts and crosscut actions makes +it possible to define extensible library aspects. + +|AspectJ 0.3 |First all Java implementation, also includes many small +language improvements. + +|AspectJ 0.2 |General-purpose support for crosscutting. Users could +program any kind of aspects, not just coordination. This release dropped +COOL. + +|AspectJ 0.1 |A single domain-specific aspect language, called COOL, for +programming coordination in multi-threaded programs. +|=== + +More details for 1.0 and earlier releases are available in changes.html. + +*Q:* What is the AspectJ development schedule? + +*A:* Below is a table describing the goals for the major releases. For +information about specific features, search the bug database for `RFE`'s +("requests for enhancement") by +http://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&bug_severity=enhancement[selecting +severity of "enhancement"]. Like many open-source projects, we don't +make or promise schedules, but we do follow a pattern of issuing preview +releases which can give observers an idea of when a particular release +might be available. + +.The AspectJ Development Schedule +[cols=",",] +|=== +|Version |Description + +|1.0 |Final syntax and semantic changes. Standalone structure browser. +Complete documentation. + +|1.1 |Faster incremental compilation, bytecode weaving, and a small +number of language changes. + +|1.2 |Faster weaving, -inpath option, better error messages, better +handling of binary input and resources during incremental compilation, +faster runtime + +|1.5 (AspectJ 5) |Support for Java 1.5, generic aspects, annotations, +etc. Integrates AspectWerkz-style load-time weaving. +|=== + +*Q:* Will AspectJ support Java 5? + +*A:* Yes. Java 5 is supported in AspectJ 5. + +AspectJ is a registered trademark of Palo Alto Research Center, +Incorporated (PARC), used with permission. Java and all Java-based marks +are trademarks or registered trademarks of Sun Microsystems, Inc. in the +United States and other countries. All other trademarks are the property +of their respective owners. diff --git a/docs/faq/faq.xml b/docs/faq/faq.xml index 2db3b008d..855859b64 100644 --- a/docs/faq/faq.xml +++ b/docs/faq/faq.xml @@ -1,4 +1,4 @@ - + @@ -1983,9 +1983,9 @@ ajc -bootclasspath c:\jdk1.2\jre\lib\rt.jar \ other files might also need to be recompiled or re-woven. Depending on what is modified, we may need to re-weave - code.  If you change a pointcut and save it, we currently have + code.  If you change a pointcut and save it, we currently have to check everywhere in case a new match is occurring or an old - match is no longer correct.  However, if you simply change + match is no longer correct.  However, if you simply change the body of an advice in an aspect, there is (usually) no need to reweave as the affected classes call the advice and the advice (by design) maintains its name in the recompiled diff --git a/docs/jdk15-packages.txt b/docs/jdk15-packages.txt deleted file mode 100644 index 48783362e..000000000 --- a/docs/jdk15-packages.txt +++ /dev/null @@ -1,166 +0,0 @@ -java.applet -java.awt -java.awt.color -java.awt.datatransfer -java.awt.dnd -java.awt.event -java.awt.font -java.awt.geom -java.awt.im -java.awt.im.spi -java.awt.image -java.awt.image.renderable -java.awt.print -java.beans -java.beans.beancontext -java.io -java.lang -java.lang.annotation -java.lang.instrument -java.lang.management -java.lang.ref -java.lang.reflect -java.math -java.net -java.nio -java.nio.channels -java.nio.channels.spi -java.nio.charset -java.nio.charset.spi -java.rmi -java.rmi.activation -java.rmi.dgc -java.rmi.registry -java.rmi.server -java.security -java.security.acl -java.security.cert -java.security.interfaces -java.security.spec -java.sql -java.text -java.util -java.util.concurrent -java.util.concurrent.atomic -java.util.concurrent.locks -java.util.jar -java.util.logging -java.util.prefs -java.util.regex -java.util.zip -javax.accessibility -javax.activity -javax.crypto -javax.crypto.interfaces -javax.crypto.spec -javax.imageio -javax.imageio.event -javax.imageio.metadata -javax.imageio.plugins.bmp -javax.imageio.plugins.jpeg -javax.imageio.spi -javax.imageio.stream -javax.management -javax.management.loading -javax.management.modelmbean -javax.management.monitor -javax.management.openmbean -javax.management.relation -javax.management.remote -javax.management.remote.rmi -javax.management.timer -javax.naming -javax.naming.directory -javax.naming.event -javax.naming.ldap -javax.naming.spi -javax.net -javax.net.ssl -javax.print -javax.print.attribute -javax.print.attribute.standard -javax.print.event -javax.rmi -javax.rmi.CORBA -javax.rmi.ssl -javax.security.auth -javax.security.auth.callback -javax.security.auth.kerberos -javax.security.auth.login -javax.security.auth.spi -javax.security.auth.x500 -javax.security.cert -javax.security.sasl -javax.sound.midi -javax.sound.midi.spi -javax.sound.sampled -javax.sound.sampled.spi -javax.sql -javax.sql.rowset -javax.sql.rowset.serial -javax.sql.rowset.spi -javax.swing -javax.swing.border -javax.swing.colorchooser -javax.swing.event -javax.swing.filechooser -javax.swing.plaf -javax.swing.plaf.basic -javax.swing.plaf.metal -javax.swing.plaf.multi -javax.swing.plaf.synth -javax.swing.table -javax.swing.text -javax.swing.text.html -javax.swing.text.html.parser -javax.swing.text.rtf -javax.swing.tree -javax.swing.undo -javax.transaction -javax.transaction.xa -javax.xml -javax.xml.datatype -javax.xml.namespace -javax.xml.parsers -javax.xml.transform -javax.xml.transform.dom -javax.xml.transform.sax -javax.xml.transform.stream -javax.xml.validation -javax.xml.xpath -org.ietf.jgss -org.omg.CORBA -org.omg.CORBA.DynAnyPackage -org.omg.CORBA.ORBPackage -org.omg.CORBA.TypeCodePackage -org.omg.CORBA.portable -org.omg.CORBA_2_3 -org.omg.CORBA_2_3.portable -org.omg.CosNaming -org.omg.CosNaming.NamingContextExtPackage -org.omg.CosNaming.NamingContextPackage -org.omg.Dynamic -org.omg.DynamicAny -org.omg.DynamicAny.DynAnyFactoryPackage -org.omg.DynamicAny.DynAnyPackage -org.omg.IOP -org.omg.IOP.CodecFactoryPackage -org.omg.IOP.CodecPackage -org.omg.Messaging -org.omg.PortableInterceptor -org.omg.PortableInterceptor.ORBInitInfoPackage -org.omg.PortableServer -org.omg.PortableServer.CurrentPackage -org.omg.PortableServer.POAManagerPackage -org.omg.PortableServer.POAPackage -org.omg.PortableServer.ServantLocatorPackage -org.omg.PortableServer.portable -org.omg.SendingContext -org.omg.stub.java.rmi -org.w3c.dom -org.w3c.dom.bootstrap -org.w3c.dom.events -org.w3c.dom.ls -org.xml.sax -org.xml.sax.ext -org.xml.sax.helpers diff --git a/docs/pdGuideDB/ajcore.adoc b/docs/pdGuideDB/ajcore.adoc new file mode 100644 index 000000000..a130309f9 --- /dev/null +++ b/docs/pdGuideDB/ajcore.adoc @@ -0,0 +1,161 @@ +[[ajcore]] +== AspectJ Core Files + +[[ajcore-introduction]] +=== Introduction + +When the compiler terminates abnormally, either because a particular +kind of message was issued or an exception was thrown, an AspectJ core +file will be produced. You will find it the working directory of the +compiler and it will have a name that contains the date and time that +the file was produced e.g. `ajcore.20060810.173655.626.txt`. The file +contains details of the problem such as the exception thrown as well as +information about the environment such as operating system and Java +version. When submitting a bug, include this file whenever it is +available. + +[[configuration]] +==== Configuring dump files + +By default AspectJ will only create an `ajcore` file when an unexpected +exception is thrown by the weaver or an `abort` message is issued. +However it is possible to disable this feature or enable files to be +produced under different circumstances. The table below lists the System +properties that can be used to configure `ajcore` files. + +[cols=",,",options="header",] +|=== +|Property |Default |Description +|`org.aspectj.weaver.Dump.exception` |`true` |Generate an `ajcore` files +when an exception thrown. + +|`org.aspectj.weaver.Dump.condition` |`abort` |Message kind for which to +generate `ajcore` e.g. `error`. + +|`org.aspectj.dump.directory` |`none` |The directory used for ajcore +files. +|=== + +[[ajcore-examples]] +==== AJCore File Examples + +Below is an extract from an `ajcore` file. You will see details of the +dump configuration as well as the exception (with stack trace) that is +the source of the problem and any messages issued by the compiler. Most +importantly the exact version of AspectJ is included. + +.... +---- AspectJ Properties --- +AspectJ Compiler DEVELOPMENT built on Tuesday Jul 25, 2006 at 13:00:09 GMT +---- Dump Properties --- +Dump file: ajcore.20060810.173655.626.txt +Dump reason: java.lang.NoClassDefFoundError +Dump on exception: true +Dump at exit condition: abort +---- Exception Information --- +java.lang.NoClassDefFoundError: org/apache/commons/logging/LogFactory + at org.aspectj.weaver.tools.CommonsTraceFactory.(CommonsTraceFactory.java:17) + at java.lang.Class.newInstance0(Native Method) + at java.lang.Class.newInstance(Class.java:232) + at org.aspectj.weaver.tools.TraceFactory.(TraceFactory.java:35) + at org.aspectj.weaver.World.(World.java:114) + at org.aspectj.ajdt.internal.core.builder.AjBuildManager.initBcelWorld(AjBuildManager.java:679) + at org.aspectj.ajdt.internal.core.builder.AjBuildManager.doBuild(AjBuildManager.java:224) + at org.aspectj.ajdt.internal.core.builder.AjBuildManager.batchBuild(AjBuildManager.java:164) + at org.aspectj.ajdt.ajc.AjdtCommand.doCommand(AjdtCommand.java:112) + at org.aspectj.ajdt.ajc.AjdtCommand.runCommand(AjdtCommand.java:60) + at org.aspectj.tools.ajc.Main.run(Main.java:367) + at org.aspectj.tools.ajc.Main.runMain(Main.java:246) + at org.aspectj.tools.ajc.Main.main(Main.java:86) +---- System Properties --- +java.runtime.name=Java(TM) 2 Runtime Environment, Standard Edition +sun.boot.library.path=C:\jdk1.3.1_16\jre\bin +java.vm.version=1.3.1_16-b06 +java.vm.vendor=Sun Microsystems Inc. +java.vendor.url=http://java.sun.com/ +path.separator=; +java.vm.name=Java HotSpot(TM) Client VM +file.encoding.pkg=sun.io +java.vm.specification.name=Java Virtual Machine Specification +user.dir=C:\workspaces\org.aspectj\org.aspectj.ant.tests +java.runtime.version=1.3.1_16-b06 +java.awt.graphicsenv=sun.awt.Win32GraphicsEnvironment +os.arch=x86 +java.io.tmpdir=C:\DOCUME~1\IBM_user\LOCALS~1\Temp\ +line.separator= + +java.vm.specification.vendor=Sun Microsystems Inc. +java.awt.fonts= +os.name=Windows XP +java.library.path=C:\jdk1.3.1_16\jre\bin;... +java.specification.name=Java Platform API Specification +java.class.version=47.0 +os.version=5.1 +user.home=C:\Documents and Settings\IBM_user +user.timezone=Europe/London +java.awt.printerjob=sun.awt.windows.WPrinterJob +file.encoding=Cp1252 +java.specification.version=1.3 +java.class.path=C:\workspaces\org.aspectj\aj-build\dist\tools\lib\aspectjtools.jar +user.name=IBM_user +java.vm.specification.version=1.0 +java.home=C:\jdk1.3.1_16\jre +user.language=en +java.specification.vendor=Sun Microsystems Inc. +awt.toolkit=sun.awt.windows.WToolkit +java.vm.info=mixed mode +java.version=1.3.1_16 +java.ext.dirs=C:\jdk1.3.1_16\jre\lib\ext +sun.boot.class.path=C:\jdk1.3.1_16\jre\lib\rt.jar;... +java.vendor=Sun Microsystems Inc. +file.separator=\ +java.vendor.url.bug=http://java.sun.com/cgi-bin/bugreport.cgi +sun.io.unicode.encoding=UnicodeLittle +sun.cpu.endian=little +user.region=GB +sun.cpu.isalist=pentium i486 i386 +---- Command Line --- +-d +C:\workspaces\org.aspectj\org.aspectj.ant.tests\IncrementalAjcTaskTest-temp +-g:none +-deprecation +-noExit +-warn:-unusedImport +-nowarn +-XterminateAfterCompilation +-preserveAllLocals +-proceedOnError +-referenceInfo +-source +1.3 +-target +1.1 +-time +-verbose +-classpath +C:\workspaces\org.aspectj\org.aspectj.ant.tests\..\lib\test\aspectjrt.jar +-argfile +C:\workspaces\org.aspectj\taskdefs\testdata\default.lst +-messageHolder +org.aspectj.bridge.MessageHandler +---- Full Classpath --- +Empty +---- Compiler Messages --- +abort ABORT -- (NoClassDefFoundError) org/apache/commons/logging/LogFactory +org/apache/commons/logging/LogFactory +java.lang.NoClassDefFoundError: org/apache/commons/logging/LogFactory + at org.aspectj.weaver.tools.CommonsTraceFactory.(CommonsTraceFactory.java:17) + at java.lang.Class.newInstance0(Native Method) + at java.lang.Class.newInstance(Class.java:232) + at org.aspectj.weaver.tools.TraceFactory.(TraceFactory.java:35) + at org.aspectj.weaver.World.(World.java:114) + at org.aspectj.ajdt.internal.core.builder.AjBuildManager.initBcelWorld(AjBuildManager.java:679) + at org.aspectj.ajdt.internal.core.builder.AjBuildManager.doBuild(AjBuildManager.java:224) + at org.aspectj.ajdt.internal.core.builder.AjBuildManager.batchBuild(AjBuildManager.java:164) + at org.aspectj.ajdt.ajc.AjdtCommand.doCommand(AjdtCommand.java:112) + at org.aspectj.ajdt.ajc.AjdtCommand.runCommand(AjdtCommand.java:60) + at org.aspectj.tools.ajc.Main.run(Main.java:367) + at org.aspectj.tools.ajc.Main.runMain(Main.java:246) + at org.aspectj.tools.ajc.Main.main(Main.java:86) + +.... diff --git a/docs/pdGuideDB/ltwdump.adoc b/docs/pdGuideDB/ltwdump.adoc new file mode 100644 index 000000000..3f97fb2c1 --- /dev/null +++ b/docs/pdGuideDB/ltwdump.adoc @@ -0,0 +1,63 @@ +[[ltwdump]] +== Dumping classes during load-time weaving + +[[ltwdump-introduction]] +=== Introduction + +Very rarely problems may be encountered with classes that have been +load-time woven. Symptoms will include incorrect program function or a +Java exception such as `java.lang.VerifyError`. In these situations it's +most helpful to include the offending class in the bug report. When +using load-time weaving the woven classes are in memory only so to save +them to disk configure `META-INF/aop.xml` to dump the classes (by +default to an `_ajdump` subdirectory of the current working directory). +Also if the input class file is not available (e.g. it is a generated +proxy or has already been instrumented by another agent) you can +configure the weaver to dump the input classes as well. + +[[ltw-examples]] +==== Configuring bytecode dumping in load-time weaving + +For details of how to configure byte-code dumping, see the AspectJ +Development Environment Guide section on +xref:../devguide/ltw-configuration.html#configuring-load-time-weaving-with-aopxml-files[Configuring +Load-time Weaving]. Following is a simple example. + +[[ltwdump-examples]] +==== LTW Dump Examples + +The following `META-INF/aop.xml` will weave classes in the `com.foo` +package (and subpackages) but not CGLIB generated classes in the +`com.foo.bar` package (and subpackages). It will also ensure all woven +byte-code is dumped both before and after weaving. + +.... + + + + + + + + + + +.... + +You should see messages similar to this: + +.... +[WeavingURLClassLoader] info AspectJ Weaver Version 1.5.3 built on Thursday Oct 26, 2006 at 17:22:31 GMT +[WeavingURLClassLoader] info register classloader org.aspectj.weaver.loadtime.WeavingURLClassLoader +[WeavingURLClassLoader] info using configuration /C:/tempMETA-INF/aop.xml +[WeavingURLClassLoader] info register aspect ataspectj.EmptyAspect +[WeavingURLClassLoader] debug not weaving 'com.foo.bar.Test$$EnhancerByCGLIB$$12345' +[WeavingURLClassLoader] debug weaving 'com.foo.bar.Test' +.... + +On disk you would find the following files: + +.... +_ajdump/_before/com/foo/bar/Test.class +_ajdump/com/foo/bar/Test.class +.... diff --git a/docs/pdGuideDB/messages.adoc b/docs/pdGuideDB/messages.adoc new file mode 100644 index 000000000..087a78de4 --- /dev/null +++ b/docs/pdGuideDB/messages.adoc @@ -0,0 +1,199 @@ +== Messages + +[[messages-introduction]] +=== Introduction + +Messages point out potential problems in the input program; some are +clearly problems (errors), but many more may depend on what the +programmer intends. To keep the noise down the latter are treated as +warnings which can be ignored by the programmer or information which are +hidden. However, when investigating unexpected behavior it's helpful to +show them. This section describes how to configure messages, presents +some problem scenarios when compiling or doing load-time weaving, and +summarizes some of the more relevant messages. + +[[messages-introduction-config]] +==== Configuring Messages + +The compiler offers `-verbose`, `-warning`, and `-XLint` options when +invoked using the command-line, Ant, or embedded in an IDE. All options +are listed in the AspectJ Development Environment Guide sections for +xref:../devguide/ajc-ref.html[Ajc] and +xref:../devguide/antTasks-iajc.html[Ant Tasks]. The +xref:../devguide/ltw.html[Load-time Weaving] section describes how to +use XML configuration files and system properties to pass options to the +weaver. (You can also pass options to the weaver using system properties +in build- time weaving.) The `-verbose` option has the effect of +including messages level "info", which are normally ignored. Both +`warning` and `XLint` enable you to identify specific messages to emit, +but warning messages tend to be the same provided by the underlying +Eclipse JDT (Java) compiler, while XLint messages are emitted by the +AspectJ compiler or weaver. Obviously, during load-time weaving only +weaver messages will be emitted. Similarly, if aspects are compiled but +not woven, then only compiler messages will be emitted. However, the +usual case for the compiler/weaver working at build time is to emit both +compiler and weaver messages. + +The tables below list some options, System Properties (for LTW only) and +Java 5 annotations used to control AspectJ messages. The method of +configuration depends on your environment so please refer to the +relevant documentation for xref:../devguide/ajc-ref.html[ajc], +xref:../devguide/antTasks.html[Ant] or +xref:../devguide/ltw-configuration.html#weaver-options[LTW]. + +[cols=",",options="header",] +|=== +|Option |Description +|`-verbose` |Show informational messages including AspectJ version and +build date. + +|`-debug` |(Load-time weaving only). Show debugging messages such as +which classes are being woven or those that are excluded. (This is not +related to the compiler -g option to include debug information in the +output .class files.) + +|`-showWeaveInfo` |Show weaving messages. + +|`-Xlint` |Control level of lint messages. + +|`messageHolderClass`/ `-XmessageHolderClass:` |In Ant tasks and LTW +respectively specify the class to receive all messages. See +xref:../devguide/antTasks-iajc.html#antTasks-iajc-options[iajc task +options] or +xref:../devguide/ltw-configuration.html#weaver-options[Weaver Options]. +|=== + +[cols=",",options="header",] +|=== +|System Property |Description +|`aj.weaving.verbose` |Show informational messages including AspectJ +version and build date (same as `-verbose` option). + +|`org.aspectj.weaver.showWeaveInfo` |Show weaving messages (same as +`-showWeaveInfo` option). + +|`org.aspectj.weaving.messages` |Set this system property to enable +tracing of all compiler messages. See xref:#trace-configuration[???]. +|=== + +[cols=",",options="header",] +|=== +|Annotation |Description +|`@SuppressAjWarnings` |Include this is Java 5 code to suppress AspectJ +warnings associated with the next line of code. +|=== + +[[messages-scenarios]] +=== Message scenarios + +[[messages-scenarios-ct]] +==== Compile-time weaving scenarios + +[[messages-scenarios-ct-adviceNotWoven]] +===== Advice not woven + +This means that the pointcut for the advice did not match, and it should +be debugged as described in xref:#pointcuts[???]. + +[[messages-scenarios-ltw]] +==== Load-time weaving scenarios + +You can use `META-INF/aop.xml` to control which messages are produced +during LTW. The following example will produce basic informational +messages about the lifecyle of the weaver in addition to any warning or +error messages. + +.... + + + + +.... + +The messages indicate which `META-INF/aop.xml` configurations file(s) +are being used. Each message is also preceeded by the name of the +defining class loader associated with weaver. You can use this +information in a large system to distinguish between different +applications each of which will typically have its own class loader. + +.... +[AppClassLoader@92e78c] info AspectJ Weaver Version 1.5.3 built on Thursday Oct 26, 2006 at 17:22:31 GMT +[AppClassLoader@92e78c] info register classloader sun.misc.Launcher$AppClassLoader@92e78c +[AppClassLoader@92e78c] info using configuration /C:/temp/META-INF/aop.xml +[AppClassLoader@92e78c] info using configuration /C:/temp/META-INF/aop-ajc.xml +[AppClassLoader@92e78c] info register aspect ExceptionHandler +[AppClassLoader@92e78c] info processing reweavable type ExceptionHandler: ExceptionHandler.aj +.... + +[[messages-scenarios-ltw-adviceNotWoven]] +===== Advice not woven + +It is often difficult to determine, especially when using load-time +weaving (LTW), why advice has not been woven. Here is a quick guide to +the messages to look for. Firstly if you use the `-verbose` option you +should see the following message when your aspect is registered: + +.... +info register aspect MyAspect +.... + +Secondly if you use the `-debug` option you should see a message +indicating that you class is being woven: + +.... +debug weaving 'HelloWorld' +.... + +However this does not mean that advice has actually been woven into your +class; it says that the class has been passed to the weaver. To +determine whether your pointcuts match you can use the `-showWeaveInfo` +option which will cause a message to be issued each time a join point is +woven: + +.... +weaveinfo Join point 'method-execution(void HelloWorld.main(java.lang.String[]))' ... +.... + +If advice is woven at this join point you should get the corresponding +message. + +[[messages-xlint]] +=== Lint messages + +The table below lists some useful `-Xlint` messages. + +[cols=",,",options="header",] +|=== +|Message |Default |Description +|`aspectExcludedByConfiguration` |`ignore` |If an aspect is not being +woven, despite being registered, it could be that it has been excluded +by either an `include` or `exclude` element in the `aspects` section of +`META-INF/aop.xml`. Enable this message to determine whether an aspect +has been excluded. + +|`adviceDidNotMatch` |`warning` |Issued when advice did not potentially +affect any join points. This means the corresponding pointcut did not +match any join points in the program. This may be valid e.g., in library +aspects or code picking up error conditions, but often the programmer +simply made a mistake in the pointcut. The best approach is to debug the +pointcut. + +|`invalidAbsoluteTypeName` |`warning` |Issued when an exact type in a +pointcut does not match any type in the system. Note that this can +interact with the rules for resolving simple types, which permit +unqualified names if they are imported. + +|`typeNotExposedToWeaver` |`warning` |This means that a type which could +be affected by an aspect is not available for weaving. This happens when +a class on the classpath should be woven. + +|`runtimeExceptionNotSoftened` |`warning` |Before AspectJ 5, declare +soft used to soften runtime exceptions (unnecessarily). Since then, it +does not but does issue this warning in case the programmer did intend +for the exception to be wrapped. + +|`unmatchedSuperTypeInCall` |`warning` |Issued when a call pointcut +specifies a defining type which is not matched at the call site (where +the declared type of the reference is used, not the actual runtime +type). Most people should use 'target(Foo) && call(void foo())' instead. +|=== diff --git a/docs/pdGuideDB/pointcuts.adoc b/docs/pdGuideDB/pointcuts.adoc new file mode 100644 index 000000000..66e133e65 --- /dev/null +++ b/docs/pdGuideDB/pointcuts.adoc @@ -0,0 +1,113 @@ +[[pointcuts]] +== Debugging Pointcuts + +[[pointcuts-introduction]] +=== Introduction + +This section describes how to write and debug pointcuts using the usual +approach of iteration and decomposition. New users are often stumped +when their advice does not match. That means the pointcut doesn't match; +they rewrite the pointcut and it still doesn't match, with no new +information. This can be frustrating if each iteration involves +building, deploying, and testing a complex application. Learning to +break it down, particularly into parts that can be checked at +compile-time, can save a lot of time. + +[[pointcuts-debugging]] +=== Debugging pointcuts + +Go at it top-down and then bottom-up. Top-down, draft significant +aspects by first writing the comments to specify responsibilities. +Advice responsibility usually takes the form, "When X, do Y." Pointcut +responsibility for "When X" often takes the form, "When [join points] +[in locations] [are ...]". These []'s often translate to named pointcuts +(like `libraryCalls() && within(Client) && args(Context)`) which form a +semantic bridge to the plain-text meaning in a comment (e.g., `// when +the client passes only context into the library`). This gets you to a +point where you can debug the parts of the pointcut independently. + +Bottom up (to build each part), consider each primitive pointcut +designator (PCD), then the composition, and then any implicit +constraints: + +[arabic] +. What kinds of join points should it match? (constructor-call? +field-get?)? This translates to using the kinded pointcuts (`call(..)`, +`get(..)`, etc.). +. Are these restricted to being lexically within something? This +translates to using `within\{code}(..)`. If this is true, it should +always be used, to speed up weaving. +. What runtime constraints and context should be true and available at +each join point? This translates to `this()`, `target()`, `args()`, +`cflow\{below}()` and `if(..)`. +. Are there any advice or implementation limitations at issue? This +involves knowing the few constraints on AspectJ imposed by Java bytecode +as listed in the AspectJ Programming Guide section on +xref:../progguide/implementation.html[Implementation Notes]. + +It's much faster to iterate a pointcut at compile-time using declare +warning (even better, some errors are identified at parse-time in the +latest versions of AJDT). Start with the parts of the pointcut that are +staticly-determinable (i.e., they do not involve the runtime PCD's +listed above). If compiles themselves take too long because of all the +AspectJ weaving, then try to only include the debugging aspect with the +prototype pointcut, and limit the scope using `within(..)`. + +Some mistakes in primitive pointcuts: + +* `this(Foo) && execution(static * *(..))`: There is no `this` in a +static context, so `this()` or `target()` should not be used in a static +context or when targetting a static context (respectively). This happens +most often when you want to say things like "all calls to Foo from Bar" +and you only pick out calls to instance methods of Foo or you try to +pick out calls from static methods of Bar. +* `target(Foo) && call(new(..)`: This will never match. In +constructor-call join points, there is no target because the object has +not been created yet. +* `call(* Foo.*(..))`: `Foo` refers to the compile-time type of the +invoking reference, not the implementing class. In Java before 1.4, the +compile-time type was rendered as the defining type, not the reference +type; this was corrected in 1.4 (as shown when using ajc with the -1.4 +flag) Most people should use `target(Foo) && call(...)`. +* `execution(* Foo.bar(..))`: An execution join point for Foo is always +within Foo, so this won't pick out any overrides of bar(..). Use +`target(Foo) && execution(* bar(..))` for instance methods. +* `within(Foo)`: anonymous types are not known at weave-time to be +within the lexically-enclosing type (a limitation of Java bytecode). + +Some mistakes in composition: + +* `call(* foo(Bar, Foo)) && args(Foo)`: This will never match. The +parameters in `args(..)` are position-dependent, so `args(Foo)` only +picks out join points where there is only one argument possible, of type +Foo. Use the indeterminate-arguments operator '..' as needed, e.g., +`args(Foo, ..)`. +* `call(* foo()) && execution(* foo())`: This will never match. Each +pointcut must be true at each join point matched. For a union of +different kinds of join points (here, call or execution), use '||'. +E.g., to match both method-call and field-get join points, use `call(* +...) || get(...)`. + +Some mistakes in implicit advice constraints: + +* `after () returning (Foo foo) : ...`: after advice can bind the +returned object or exception thrown. That effectively acts like +`target()`, `this()`, or `args()` in restricting when the advice runs +based on the runtime type of the bound object, even though it is not +explicitly part of the pointcut. + +Some mistakes in implementation requirements: + +* `ajc` has to control the code for a join point in order to implement +the join point. This translates to an implicit `within(\{code under the +control of the compiler})` for all join points, with additional caveat +for some join points. Take exception handlers, for example: there is no +way to be sure from the bytecode where the original handler ends, so +`ajc` can't implement after advice on handler join points. (Since these +are on a per-join-point basis, they should be considered for each +corresponding primitive pointcut designator.) Unlike the mistakes with +the primitive PCDs above, the compiler will emit an error for these +caveats. +* `call(@SuperAnnotation Subclass.meth()`: Annotations are not inherited +by default, so e.g., if the pointcut specifies an annotation, then +subclass implementations of that method will not be matched. diff --git a/docs/pdGuideDB/trace.adoc b/docs/pdGuideDB/trace.adoc new file mode 100644 index 000000000..bfe20557e --- /dev/null +++ b/docs/pdGuideDB/trace.adoc @@ -0,0 +1,155 @@ +[[trace]] +== Tracing + +[[trace-introduction]] +=== Introduction + +The AspectJ developers have instrumented the compiler/weaver with many +"trace" messages for their own debugging use. These remain in the +production releases because tracing helps when it is hard to isolate the +problem in a test case. This sections describes how to enable tracing so +you can provide trace information on bug reports. + +The usual approach to opening a report on Bugzilla is to describe the +symptoms of the problem and attach a simple testcase. This allows the +AspectJ team to try and reproduce the problem in an attempt to fix it as +well as improve the test suite. Unfortunately it may not be possible to +produce such a testcase either because your program is too large or is +commercially sensitive. Alternatively the problem may relate to your +specific environment where AspectJ is being used and will not be +reproducible by the AspectJ team. In each of these situations you can +produce a trace of the compiler when the problem occurs instead. This +can then be attached to the bug report. + +[[trace-configuration]] +==== Configuring Tracing + +When available (Java 5 or later) AspectJ will use the +http://java.sun.com/j2se/1.5.0/docs/guide/logging/index.html[java.util.logging] +infrastructure configured using a `logging.properties` file. By default +only error and fatal events will be logged but less severe warnings as +well as fine-grained method entry and exit events can be obtained using +the appropriate configuration. All regular compiler messages can also be +logged through the infrastructure by setting the +`org.aspectj.weaving.messages` System property. + +If you are running the AspectJ compiler/weaver under JDK 1.4 or earlier, +AspectJ will use a simple built-in trace infrastructure that logs to +stderr. This is enabled by setting the +`org.aspectj.weaving.tracing.enabled` System property. You may also +override the default behaviour or provide your own trace implementation +using the `org.aspectj.weaving.tracing.factory` System property. + +The table below lists the System properties that can be used to +configure tracing. + +[cols=",",options="header",] +|=== +|Property |Description +|`org.aspectj.tracing.debug` a| +Enable simple debugging of the trace infrastructure itself. + +Default: `false`. + +|`org.aspectj.tracing.enabled` a| +Enable the built-in AspectJ trace infrastructure. + +Default: `false`. + +|`org.aspectj.tracing.factory` |Select trace infrastructure. Specify the +fully qualified class name of the +`org.aspectj.weaver.tools.TraceFactory` interface to use a custom +infrastructure. Specify a value of `default` to force AspectJ to use +it's built-in infrastructure. + +|`org.aspectj.tracing.messages` a| +Enable tracing of compiler messages. The kind of messages logged is +determined by the selected trace infrastructure not the message +configuration. + +Default: `false`. + +|=== + +[[trace-examples]] +==== Examples + +Using `-Dorg.aspectj.tracing.factory=default` to force AspectJ to use +its internal infrastructure, `-Dorg.aspectj.tracing.enabled=true` to +turn it on and `-Dorg.aspectj.tracing.messages=true` to include messages +running a simple HelloWorld with LTW will generate tracing to stderr. +Below is an extract from that trace with method arguments removed. You +will notice the millisecond time stamp, thread id and indication of +entry/exit/event or message type for each line of trace. + +.... +15:44:18.630 main > org.aspectj.weaver.loadtime.Aj. +15:44:18.660 main < org.aspectj.weaver.loadtime.Aj. +15:44:18.660 main > org.aspectj.weaver.loadtime.Aj.preProcess +15:44:18.660 main - org.aspectj.weaver.loadtime.Aj.preProcess +15:44:18.730 main > org.aspectj.weaver.loadtime.ClassLoaderWeavingAdaptor. +15:44:18.730 main < org.aspectj.weaver.loadtime.ClassLoaderWeavingAdaptor. +15:44:18.730 main > org.aspectj.weaver.loadtime.ClassLoaderWeavingAdaptor.initialize +15:44:18.821 main I [AppClassLoader@92e78c] info AspectJ Weaver Version DEVELOPMENT ... +15:44:18.821 main > org.aspectj.weaver.loadtime.ClassLoaderWeavingAdaptor.parseDefinitions +15:44:18.821 main I [AppClassLoader@92e78c] info register classloader ... +15:44:18.821 main - org.aspectj.weaver.loadtime.ClassLoaderWeavingAdaptor.parseDefinitions +15:44:18.841 main - org.aspectj.weaver.loadtime.ClassLoaderWeavingAdaptor.parseDefinitions +15:44:18.841 main I [AppClassLoader@92e78c] info using configuration ... +15:44:18.891 main < org.aspectj.weaver.loadtime.ClassLoaderWeavingAdaptor.parseDefinitions +15:44:19.021 main > org.aspectj.weaver.World$TypeMap. +15:44:19.021 main < org.aspectj.weaver.World$TypeMap. +15:44:19.021 main > org.aspectj.weaver.CrosscuttingMembersSet. +15:44:19.021 main < org.aspectj.weaver.CrosscuttingMembersSet. +15:44:19.021 main > org.aspectj.weaver.Lint. +15:44:19.021 main < org.aspectj.weaver.Lint. +15:44:19.021 main > org.aspectj.weaver.World. +15:44:19.111 main < org.aspectj.weaver.World. +15:44:19.201 main > org.aspectj.weaver.bcel.BcelWeaver. +15:44:19.201 main < org.aspectj.weaver.bcel.BcelWeaver. +15:44:19.201 main > org.aspectj.weaver.loadtime.ClassLoaderWeavingAdaptor.registerDefinitions +15:44:19.211 main > org.aspectj.weaver.bcel.BcelWeaver.setReweavableMode +15:44:19.351 main < org.aspectj.weaver.bcel.BcelWeaver.setReweavableMode +15:44:19.351 main > org.aspectj.weaver.loadtime.ClassLoaderWeavingAdaptor.registerAspects +15:44:19.351 main I [AppClassLoader@92e78c] info register aspect Aspect +15:44:19.351 main > org.aspectj.weaver.bcel.BcelWeaver.addLibraryAspect +15:44:19.501 main - org.aspectj.weaver.bcel.BcelWorld.lookupJavaClass +15:44:19.632 main > org.aspectj.weaver.CrosscuttingMembersSet.addOrReplaceAspect +15:44:19.792 main < org.aspectj.weaver.CrosscuttingMembersSet.addOrReplaceAspect +15:44:19.792 main < org.aspectj.weaver.bcel.BcelWeaver.addLibraryAspect +15:44:19.792 main < org.aspectj.weaver.loadtime.ClassLoaderWeavingAdaptor.registerAspects +15:44:19.792 main < org.aspectj.weaver.loadtime.ClassLoaderWeavingAdaptor.registerDefinitions +15:44:19.792 main > org.aspectj.weaver.bcel.BcelWeaver.prepareForWeave +15:44:19.822 main < org.aspectj.weaver.bcel.BcelWeaver.prepareForWeave +15:44:19.822 main > org.aspectj.weaver.loadtime.ClassLoaderWeavingAdaptor.weaveAndDefineConcete... +15:44:19.822 main < org.aspectj.weaver.loadtime.ClassLoaderWeavingAdaptor.weaveAndDefineConcete... +15:44:19.822 main < org.aspectj.weaver.loadtime.ClassLoaderWeavingAdaptor.initialize +15:44:19.822 main > org.aspectj.weaver.tools.WeavingAdaptor.weaveClass +... +.... + +Alternatively when running under Java 5 the `logging.properties` file +below could be used to configure Java Logging. The resulting file, just +containing trace for the `org.aspectj.weaver.loadtime` package, will be +written to `java0.log` in your `user.home` directory. + +.... +handlers= java.util.logging.FileHandler + +.level= INFO + +java.util.logging.FileHandler.pattern = %h/java%u.log +java.util.logging.FileHandler.count = 1 +java.util.logging.FileHandler.formatter = java.util.logging.SimpleFormatter +java.util.logging.FileHandler.level = FINER + +org.aspectj.weaver.loadtime.level = FINER +.... + +By setting the System property `-Dorg.aspectj.tracing.debug=true` you +should see a message confirming which trace infrastructure is being +used. + +.... +TraceFactory.instance=org.aspectj.weaver.tools.Jdk14TraceFactory@12dacd1 +.... diff --git a/docs/progGuideDB/examples.adoc b/docs/progGuideDB/examples.adoc new file mode 100644 index 000000000..fccd57eff --- /dev/null +++ b/docs/progGuideDB/examples.adoc @@ -0,0 +1,1876 @@ +== Examples + +[[examples-intro]] +=== Introduction + +This chapter consists entirely of examples of AspectJ use. + +The examples can be grouped into four categories: + +technique + +Examples which illustrate how to use one or more features of the +language. + +development + +Examples of using AspectJ during the development phase of a project. + +production + +Examples of using AspectJ to provide functionality in an application. + +reusable + +Examples of reuse of aspects and pointcuts. + +[[examples-howto]] +=== Obtaining, Compiling and Running the Examples + +The examples source code is part of the AspectJ distribution which may +be downloaded from the AspectJ project page ( +http://eclipse.org/aspectj[] ). + +Compiling most examples is straightforward. Go the `InstallDir/examples` +directory, and look for a `.lst` file in one of the example +subdirectories. Use the `-arglist` option to `ajc` to compile the +example. For instance, to compile the telecom example with billing, type + +.... +ajc -argfile telecom/billing.lst +.... + +To run the examples, your classpath must include the AspectJ run-time +Java archive (`aspectjrt.jar`). You may either set the `CLASSPATH` +environment variable or use the `-classpath` command line option to the +Java interpreter: + +.... +(In Unix use a : in the CLASSPATH) +java -classpath ".:InstallDir/lib/aspectjrt.jar" telecom.billingSimulation +.... + +.... +(In Windows use a ; in the CLASSPATH) +java -classpath ".;InstallDir/lib/aspectjrt.jar" telecom.billingSimulation +.... + +[[examples-basic]] +=== Basic Techniques + +This section presents two basic techniques of using AspectJ, one each +from the two fundamental ways of capturing crosscutting concerns: with +dynamic join points and advice, and with static introduction. Advice +changes an application's behavior. Introduction changes both an +application's behavior and its structure. + +The first example, xref:#examples-joinPoints[Join Points and ], is about +gathering and using information about the join point that has triggered +some advice. The second example, xref:#examples-roles[Roles and Views], +concerns a crosscutting view of an existing class hierarchy. + +[[examples-joinPoints]] +==== Join Points and `thisJoinPoint` + +(The code for this example is in `InstallDir/examples/tjp`.) + +A join point is some point in the execution of a program together with a +view into the execution context when that point occurs. Join points are +picked out by pointcuts. When a program reaches a join point, advice on +that join point may run in addition to (or instead of) the join point +itself. + +When using a pointcut that picks out join points of a single kind by +name, typicaly the the advice will know exactly what kind of join point +it is associated with. The pointcut may even publish context about the +join point. Here, for example, since the only join points picked out by +the pointcut are calls of a certain method, we can get the target value +and one of the argument values of the method calls directly. + +.... +before(Point p, int x): target(p) + && args(x) + && call(void setX(int)) { + if (!p.assertX(x)) { + System.out.println("Illegal value for x"); return; + } +} +.... + +But sometimes the shape of the join point is not so clear. For instance, +suppose a complex application is being debugged, and we want to trace +when any method of some class is executed. The pointcut + +.... +pointcut execsInProblemClass(): within(ProblemClass) + && execution(* *(..)); +.... + +will pick out each execution join point of every method defined within +`ProblemClass`. Since advice executes at each join point picked out by +the pointcut, we can reasonably ask which join point was reached. + +Information about the join point that was matched is available to advice +through the special variable `thisJoinPoint`, of type +xref:../api/org/aspectj/lang/JoinPoint.html[`org.aspectj.lang.JoinPoint`]. +Through this object we can access information such as + +* the kind of join point that was matched +* the source location of the code associated with the join point +* normal, short and long string representations of the current join +point +* the actual argument values of the join point +* the signature of the member associated with the join point +* the currently executing object +* the target object +* an object encapsulating the static information about the join point. +This is also available through the special variable ++ +thisJoinPointStaticPart ++ +. + +===== The `Demo` class + +The class `tjp.Demo` in `tjp/Demo.java` defines two methods `foo` and +`bar` with different parameter lists and return types. Both are called, +with suitable arguments, by `Demo`'s `go` method which was invoked from +within its `main` method. + +.... +public class Demo { + static Demo d; + + public static void main(String[] args){ + new Demo().go(); + } + + void go(){ + d = new Demo(); + d.foo(1,d); + System.out.println(d.bar(new Integer(3))); + } + + void foo(int i, Object o){ + System.out.println("Demo.foo(" + i + ", " + o + ")\n"); + } + + String bar (Integer j){ + System.out.println("Demo.bar(" + j + ")\n"); + return "Demo.bar(" + j + ")"; + } +} +.... + +===== The `GetInfo` aspect + +This aspect uses around advice to intercept the execution of methods +`foo` and `bar` in `Demo`, and prints out information garnered from +`thisJoinPoint` to the console. + +.... +aspect GetInfo { + + static final void println(String s){ System.out.println(s); } + + pointcut goCut(): cflow(this(Demo) && execution(void go())); + + pointcut demoExecs(): within(Demo) && execution(* *(..)); + + Object around(): demoExecs() && !execution(* go()) && goCut() { + println("Intercepted message: " + + thisJoinPointStaticPart.getSignature().getName()); + println("in class: " + + thisJoinPointStaticPart.getSignature().getDeclaringType().getName()); + printParameters(thisJoinPoint); + println("Running original method: \n" ); + Object result = proceed(); + println(" result: " + result ); + return result; + } + + static private void printParameters(JoinPoint jp) { + println("Arguments: " ); + Object[] args = jp.getArgs(); + String[] names = ((CodeSignature)jp.getSignature()).getParameterNames(); + Class[] types = ((CodeSignature)jp.getSignature()).getParameterTypes(); + for (int i = 0; i < args.length; i++) { + println(" " + i + ". " + names[i] + + " : " + types[i].getName() + + " = " + args[i]); + } + } +} +.... + +====== Defining the scope of a pointcut + +The pointcut `goCut` is defined as + +.... +cflow(this(Demo)) && execution(void go()) +.... + +so that only executions made in the control flow of `Demo.go` are +intercepted. The control flow from the method `go` includes the +execution of `go` itself, so the definition of the around advice +includes `!execution(* go())` to exclude it from the set of executions +advised. + +====== Printing the class and method name + +The name of the method and that method's defining class are available as +parts of the +xref:../api/org/aspectj/lang/Signature.html[org.aspectj.lang.Signature] +object returned by calling `getSignature()` on either `thisJoinPoint` or +`thisJoinPointStaticPart`. + +====== Printing the parameters + +The static portions of the parameter details, the name and types of the +parameters, can be accessed through the +xref:../api/org/aspectj/lang/reflect/CodeSignature.html[`org.aspectj.lang.reflect.CodeSignature`] +associated with the join point. All execution join points have code +signatures, so the cast to `CodeSignature` cannot fail. + +The dynamic portions of the parameter details, the actual values of the +parameters, are accessed directly from the execution join point object. + +[[examples-roles]] +==== Roles and Views + +(The code for this example is in `InstallDir/examples/introduction`.) + +Like advice, inter-type declarations are members of an aspect. They +declare members that act as if they were defined on another class. +Unlike advice, inter-type declarations affect not only the behavior of +the application, but also the structural relationship between an +application's classes. + +This is crucial: Publically affecting the class structure of an +application makes these modifications available to other components of +the application. + +Aspects can declare inter-type + +* fields +* methods +* constructors + +and can also declare that target types + +* implement new interfaces +* extend new classes + +This example provides three illustrations of the use of inter-type +declarations to encapsulate roles or views of a class. The class our +aspect will be dealing with, `Point`, is a simple class with rectangular +and polar coordinates. Our inter-type declarations will make the class +`Point`, in turn, cloneable, hashable, and comparable. These facilities +are provided by AspectJ without having to modify the code for the class +`Point`. + +===== The `Point` class + +The `Point` class defines geometric points whose interface includes +polar and rectangular coordinates, plus some simple operations to +relocate points. `Point`'s implementation has attributes for both its +polar and rectangular coordinates, plus flags to indicate which +currently reflect the position of the point. Some operations cause the +polar coordinates to be updated from the rectangular, and some have the +opposite effect. This implementation, which is in intended to give the +minimum number of conversions between coordinate systems, has the +property that not all the attributes stored in a `Point` object are +necessary to give a canonical representation such as might be used for +storing, comparing, cloning or making hash codes from points. Thus the +aspects, though simple, are not totally trivial. + +The diagram below gives an overview of the aspects and their interaction +with the class `Point`. + +image:aspects.gif[image] + +===== The `CloneablePoint` aspect + +This first aspect is responsible for `Point`'s implementation of the +`Cloneable` interface. It declares that `Point implements Cloneable` +with a `declare parents` form, and also publically declares a +specialized `Point`'s `clone()` method. In Java, all objects inherit the +method `clone` from the class `Object`, but an object is not cloneable +unless its class also implements the interface `Cloneable`. In addition, +classes frequently have requirements over and above the simple +bit-for-bit copying that `Object.clone` does. In our case, we want to +update a `Point`'s coordinate systems before we actually clone the +`Point`. So our aspect makes sure that `Point` overrides `Object.clone` +with a new method that does what we want. + +We also define a test `main` method in the aspect for convenience. + +.... +public aspect CloneablePoint { + + declare parents: Point implements Cloneable; + + public Object Point.clone() throws CloneNotSupportedException { + // we choose to bring all fields up to date before cloning. + makeRectangular(); + makePolar(); + return super.clone(); + } + + public static void main(String[] args){ + Point p1 = new Point(); + Point p2 = null; + + p1.setPolar(Math.PI, 1.0); + try { + p2 = (Point)p1.clone(); + } catch (CloneNotSupportedException e) {} + System.out.println("p1 =" + p1 ); + System.out.println("p2 =" + p2 ); + + p1.rotate(Math.PI / -2); + System.out.println("p1 =" + p1 ); + System.out.println("p2 =" + p2 ); + } +} +.... + +===== The `ComparablePoint` aspect + +`ComparablePoint` is responsible for `Point`'s implementation of the +`Comparable` interface. + +The interface `Comparable` defines the single method `compareTo` which +can be use to define a natural ordering relation among the objects of a +class that implement it. + +`ComparablePoint` uses `declare + parents` to declare that `Point implements + Comparable`, and also publically declares the appropriate +`compareTo(Object)` method: A `Point` `p1` is said to be less than +another `Point`` + p2` if `p1` is closer to the origin. + +We also define a test `main` method in the aspect for convenience. + +.... +public aspect ComparablePoint { + + declare parents: Point implements Comparable; + + public int Point.compareTo(Object o) { + return (int) (this.getRho() - ((Point)o).getRho()); + } + + public static void main(String[] args){ + Point p1 = new Point(); + Point p2 = new Point(); + + System.out.println("p1 =?= p2 :" + p1.compareTo(p2)); + + p1.setRectangular(2,5); + p2.setRectangular(2,5); + System.out.println("p1 =?= p2 :" + p1.compareTo(p2)); + + p2.setRectangular(3,6); + System.out.println("p1 =?= p2 :" + p1.compareTo(p2)); + + p1.setPolar(Math.PI, 4); + p2.setPolar(Math.PI, 4); + System.out.println("p1 =?= p2 :" + p1.compareTo(p2)); + + p1.rotate(Math.PI / 4.0); + System.out.println("p1 =?= p2 :" + p1.compareTo(p2)); + + p1.offset(1,1); + System.out.println("p1 =?= p2 :" + p1.compareTo(p2)); + } +} +.... + +===== The `HashablePoint` aspect + +Our third aspect is responsible for `Point`'s overriding of `Object`'s +`equals` and `hashCode` methods in order to make `Point`s hashable. + +The method `Object.hashCode` returns an integer, suitable for use as a +hash table key. It is not required that two objects which are not equal +(according to the `equals` method) return different integer results from +`hashCode` but it can improve performance when the integer is used as a +key into a data structure. However, any two objects which are equal must +return the same integer value from a call to `hashCode`. Since the +default implementation of `Object.equals` returns `true` only when two +objects are identical, we need to redefine both `equals` and `hashCode` +to work correctly with objects of type `Point`. For example, we want two +`Point` objects to test equal when they have the same `x` and `y` +values, or the same `rho` and `theta` values, not just when they refer +to the same object. We do this by overriding the methods `equals` and +`hashCode` in the class `Point`. + +So `HashablePoint` declares `Point`'s `hashCode` and `equals` methods, +using `Point`'s rectangular coordinates to generate a hash code and to +test for equality. The `x` and `y` coordinates are obtained using the +appropriate get methods, which ensure the rectangular coordinates are +up-to-date before returning their values. + +And again, we supply a `main` method in the aspect for testing. + +.... +public aspect HashablePoint { + + public int Point.hashCode() { + return (int) (getX() + getY() % Integer.MAX_VALUE); + } + + public boolean Point.equals(Object o) { + if (o == this) { return true; } + if (!(o instanceof Point)) { return false; } + Point other = (Point)o; + return (getX() == other.getX()) && (getY() == other.getY()); + } + + public static void main(String[] args) { + Hashtable h = new Hashtable(); + Point p1 = new Point(); + + p1.setRectangular(10, 10); + Point p2 = new Point(); + + p2.setRectangular(10, 10); + + System.out.println("p1 = " + p1); + System.out.println("p2 = " + p2); + System.out.println("p1.hashCode() = " + p1.hashCode()); + System.out.println("p2.hashCode() = " + p2.hashCode()); + + h.put(p1, "P1"); + System.out.println("Got: " + h.get(p2)); + } +} +.... + +[[examples-development]] +=== Development Aspects + +==== Tracing using aspects + +(The code for this example is in `InstallDir/examples/tracing`.) + +Writing a class that provides tracing functionality is easy: a couple of +functions, a boolean flag for turning tracing on and off, a choice for +an output stream, maybe some code for formatting the output -- these are +all elements that `Trace` classes have been known to have. `Trace` +classes may be highly sophisticated, too, if the task of tracing the +execution of a program demands it. + +But developing the support for tracing is just one part of the effort of +inserting tracing into a program, and, most likely, not the biggest +part. The other part of the effort is calling the tracing functions at +appropriate times. In large systems, this interaction with the tracing +support can be overwhelming. Plus, tracing is one of those things that +slows the system down, so these calls should often be pulled out of the +system before the product is shipped. For these reasons, it is not +unusual for developers to write ad-hoc scripting programs that rewrite +the source code by inserting/deleting trace calls before and after the +method bodies. + +AspectJ can be used for some of these tracing concerns in a less ad-hoc +way. Tracing can be seen as a concern that crosscuts the entire system +and as such is amenable to encapsulation in an aspect. In addition, it +is fairly independent of what the system is doing. Therefore tracing is +one of those kind of system aspects that can potentially be plugged in +and unplugged without any side-effects in the basic functionality of the +system. + +===== An Example Application + +Throughout this example we will use a simple application that contains +only four classes. The application is about shapes. The `TwoDShape` +class is the root of the shape hierarchy: + +.... +public abstract class TwoDShape { + protected double x, y; + protected TwoDShape(double x, double y) { + this.x = x; this.y = y; + } + public double getX() { return x; } + public double getY() { return y; } + public double distance(TwoDShape s) { + double dx = Math.abs(s.getX() - x); + double dy = Math.abs(s.getY() - y); + return Math.sqrt(dx*dx + dy*dy); + } + public abstract double perimeter(); + public abstract double area(); + public String toString() { + return (" @ (" + String.valueOf(x) + ", " + String.valueOf(y) + ") "); + } +} +.... + +`TwoDShape` has two subclasses, `Circle` and `Square`: + +.... +public class Circle extends TwoDShape { + protected double r; + public Circle(double x, double y, double r) { + super(x, y); this.r = r; + } + public Circle(double x, double y) { this( x, y, 1.0); } + public Circle(double r) { this(0.0, 0.0, r); } + public Circle() { this(0.0, 0.0, 1.0); } + public double perimeter() { + return 2 * Math.PI * r; + } + public double area() { + return Math.PI * r*r; + } + public String toString() { + return ("Circle radius = " + String.valueOf(r) + super.toString()); + } +} +.... + +.... +public class Square extends TwoDShape { + protected double s; // side + public Square(double x, double y, double s) { + super(x, y); this.s = s; + } + public Square(double x, double y) { this( x, y, 1.0); } + public Square(double s) { this(0.0, 0.0, s); } + public Square() { this(0.0, 0.0, 1.0); } + public double perimeter() { + return 4 * s; + } + public double area() { + return s*s; + } + public String toString() { + return ("Square side = " + String.valueOf(s) + super.toString()); + } +} +.... + +To run this application, compile the classes. You can do it with or +without ajc, the AspectJ compiler. If you've installed AspectJ, go to +the directory `InstallDir/examples` and type: + +.... +ajc -argfile tracing/notrace.lst +.... + +To run the program, type + +.... +java tracing.ExampleMain +.... + +(we don't need anything special on the classpath since this is pure Java +code). You should see the following output: + +.... +c1.perimeter() = 12.566370614359172 +c1.area() = 12.566370614359172 +s1.perimeter() = 4.0 +s1.area() = 1.0 +c2.distance(c1) = 4.242640687119285 +s1.distance(c1) = 2.23606797749979 +s1.toString(): Square side = 1.0 @ (1.0, 2.0) +.... + +===== Tracing - Version 1 + +In a first attempt to insert tracing in this application, we will start +by writing a `Trace` class that is exactly what we would write if we +didn't have aspects. The implementation is in `version1/Trace.java`. Its +public interface is: + +.... +public class Trace { + public static int TRACELEVEL = 0; + public static void initStream(PrintStream s) {...} + public static void traceEntry(String str) {...} + public static void traceExit(String str) {...} +} +.... + +If we didn't have AspectJ, we would have to insert calls to `traceEntry` +and `traceExit` in all methods and constructors we wanted to trace, and +to initialize `TRACELEVEL` and the stream. If we wanted to trace all the +methods and constructors in our example, that would amount to around 40 +calls, and we would hope we had not forgotten any method. But we can do +that more consistently and reliably with the following aspect (found in +`version1/TraceMyClasses.java`): + +.... +aspect TraceMyClasses { + pointcut myClass(): within(TwoDShape) || within(Circle) || within(Square); + pointcut myConstructor(): myClass() && execution(new(..)); + pointcut myMethod(): myClass() && execution(* *(..)); + + before (): myConstructor() { + Trace.traceEntry("" + thisJoinPointStaticPart.getSignature()); + } + after(): myConstructor() { + Trace.traceExit("" + thisJoinPointStaticPart.getSignature()); + } + + before (): myMethod() { + Trace.traceEntry("" + thisJoinPointStaticPart.getSignature()); + } + after(): myMethod() { + Trace.traceExit("" + thisJoinPointStaticPart.getSignature()); + } +} +.... + +This aspect performs the tracing calls at appropriate times. According +to this aspect, tracing is performed at the entrance and exit of every +method and constructor defined within the shape hierarchy. + +What is printed at before and after each of the traced join points is +the signature of the method executing. Since the signature is static +information, we can get it through `thisJoinPointStaticPart`. + +To run this version of tracing, go to the directory +`InstallDir/examples` and type: + +.... +ajc -argfile tracing/tracev1.lst +.... + +Running the main method of `tracing.version1.TraceMyClasses` should +produce the output: + +.... + --> tracing.TwoDShape(double, double) + <-- tracing.TwoDShape(double, double) + --> tracing.Circle(double, double, double) + <-- tracing.Circle(double, double, double) + --> tracing.TwoDShape(double, double) + <-- tracing.TwoDShape(double, double) + --> tracing.Circle(double, double, double) + <-- tracing.Circle(double, double, double) + --> tracing.Circle(double) + <-- tracing.Circle(double) + --> tracing.TwoDShape(double, double) + <-- tracing.TwoDShape(double, double) + --> tracing.Square(double, double, double) + <-- tracing.Square(double, double, double) + --> tracing.Square(double, double) + <-- tracing.Square(double, double) + --> double tracing.Circle.perimeter() + <-- double tracing.Circle.perimeter() +c1.perimeter() = 12.566370614359172 + --> double tracing.Circle.area() + <-- double tracing.Circle.area() +c1.area() = 12.566370614359172 + --> double tracing.Square.perimeter() + <-- double tracing.Square.perimeter() +s1.perimeter() = 4.0 + --> double tracing.Square.area() + <-- double tracing.Square.area() +s1.area() = 1.0 + --> double tracing.TwoDShape.distance(TwoDShape) + --> double tracing.TwoDShape.getX() + <-- double tracing.TwoDShape.getX() + --> double tracing.TwoDShape.getY() + <-- double tracing.TwoDShape.getY() + <-- double tracing.TwoDShape.distance(TwoDShape) +c2.distance(c1) = 4.242640687119285 + --> double tracing.TwoDShape.distance(TwoDShape) + --> double tracing.TwoDShape.getX() + <-- double tracing.TwoDShape.getX() + --> double tracing.TwoDShape.getY() + <-- double tracing.TwoDShape.getY() + <-- double tracing.TwoDShape.distance(TwoDShape) +s1.distance(c1) = 2.23606797749979 + --> String tracing.Square.toString() + --> String tracing.TwoDShape.toString() + <-- String tracing.TwoDShape.toString() + <-- String tracing.Square.toString() +s1.toString(): Square side = 1.0 @ (1.0, 2.0) +.... + +When `TraceMyClasses.java` is not provided to `ajc`, the aspect does not +have any affect on the system and the tracing is unplugged. + +===== Tracing - Version 2 + +Another way to accomplish the same thing would be to write a reusable +tracing aspect that can be used not only for these application classes, +but for any class. One way to do this is to merge the tracing +functionality of `Trace - version1` with the crosscutting support of +`TraceMyClasses - version1`. We end up with a `Trace` aspect (found in +`version2/Trace.java`) with the following public interface + +.... +abstract aspect Trace { + + public static int TRACELEVEL = 2; + public static void initStream(PrintStream s) {...} + protected static void traceEntry(String str) {...} + protected static void traceExit(String str) {...} + abstract pointcut myClass(); +} +.... + +In order to use it, we need to define our own subclass that knows about +our application classes, in `version2/TraceMyClasses.java`: + +.... +public aspect TraceMyClasses extends Trace { + pointcut myClass(): within(TwoDShape) || within(Circle) || within(Square); + + public static void main(String[] args) { + Trace.TRACELEVEL = 2; + Trace.initStream(System.err); + ExampleMain.main(args); + } +} +.... + +Notice that we've simply made the pointcut `classes`, that was an +abstract pointcut in the super-aspect, concrete. To run this version of +tracing, go to the directory `examples` and type: + +.... +ajc -argfile tracing/tracev2.lst +.... + +The file tracev2.lst lists the application classes as well as this +version of the files Trace.java and TraceMyClasses.java. Running the +main method of `tracing.version2.TraceMyClasses` should output exactly +the same trace information as that from version 1. + +The entire implementation of the new `Trace` class is: + +.... +abstract aspect Trace { + + // implementation part + + public static int TRACELEVEL = 2; + protected static PrintStream stream = System.err; + protected static int callDepth = 0; + + public static void initStream(PrintStream s) { + stream = s; + } + protected static void traceEntry(String str) { + if (TRACELEVEL == 0) return; + if (TRACELEVEL == 2) callDepth++; + printEntering(str); + } + protected static void traceExit(String str) { + if (TRACELEVEL == 0) return; + printExiting(str); + if (TRACELEVEL == 2) callDepth--; + } + private static void printEntering(String str) { + printIndent(); + stream.println("--> " + str); + } + private static void printExiting(String str) { + printIndent(); + stream.println("<-- " + str); + } + private static void printIndent() { + for (int i = 0; i < callDepth; i++) + stream.print(" "); + } + + // protocol part + + abstract pointcut myClass(); + + pointcut myConstructor(): myClass() && execution(new(..)); + pointcut myMethod(): myClass() && execution(* *(..)); + + before(): myConstructor() { + traceEntry("" + thisJoinPointStaticPart.getSignature()); + } + after(): myConstructor() { + traceExit("" + thisJoinPointStaticPart.getSignature()); + } + + before(): myMethod() { + traceEntry("" + thisJoinPointStaticPart.getSignature()); + } + after(): myMethod() { + traceExit("" + thisJoinPointStaticPart.getSignature()); + } +} +.... + +This version differs from version 1 in several subtle ways. The first +thing to notice is that this `Trace` class merges the functional part of +tracing with the crosscutting of the tracing calls. That is, in version +1, there was a sharp separation between the tracing support (the class +`Trace`) and the crosscutting usage of it (by the class +`TraceMyClasses`). In this version those two things are merged. That's +why the description of this class explicitly says that "Trace messages +are printed before and after constructors and methods are," which is +what we wanted in the first place. That is, the placement of the calls, +in this version, is established by the aspect class itself, leaving less +opportunity for misplacing calls. + +A consequence of this is that there is no need for providing +`traceEntry` and `traceExit` as public operations of this class. You can +see that they were classified as protected. They are supposed to be +internal implementation details of the advice. + +The key piece of this aspect is the abstract pointcut classes that +serves as the base for the definition of the pointcuts constructors and +methods. Even though `classes` is abstract, and therefore no concrete +classes are mentioned, we can put advice on it, as well as on the +pointcuts that are based on it. The idea is "we don't know exactly what +the pointcut will be, but when we do, here's what we want to do with +it." In some ways, abstract pointcuts are similar to abstract methods. +Abstract methods don't provide the implementation, but you know that the +concrete subclasses will, so you can invoke those methods. + +[[examples-production]] +=== Production Aspects + +==== A Bean Aspect + +(The code for this example is in `InstallDir/examples/bean`.) + +This example examines an aspect that makes Point objects into Java beans +with bound properties. + +Java beans are reusable software components that can be visually +manipulated in a builder tool. The requirements for an object to be a +bean are few. Beans must define a no-argument constructor and must be +either `Serializable` or `Externalizable`. Any properties of the object +that are to be treated as bean properties should be indicated by the +presence of appropriate `get` and `set` methods whose names are +`get`__property__ and `set `__property__ where _property_ is the name of +a field in the bean class. Some bean properties, known as bound +properties, fire events whenever their values change so that any +registered listeners (such as, other beans) will be informed of those +changes. Making a bound property involves keeping a list of registered +listeners, and creating and dispatching event objects in methods that +change the property values, such as set__property__ methods. + +`Point` is a simple class representing points with rectangular +coordinates. `Point` does not know anything about being a bean: there +are set methods for `x` and `y` but they do not fire events, and the +class is not serializable. Bound is an aspect that makes `Point` a +serializable class and makes its `get` and `set` methods support the +bound property protocol. + +===== The `Point` class + +The `Point` class is a very simple class with trivial getters and +setters, and a simple vector offset method. + +.... +class Point { + + protected int x = 0; + protected int y = 0; + + public int getX() { + return x; + } + + public int getY() { + return y; + } + + public void setRectangular(int newX, int newY) { + setX(newX); + setY(newY); + } + + public void setX(int newX) { + x = newX; + } + + public void setY(int newY) { + y = newY; + } + + public void offset(int deltaX, int deltaY) { + setRectangular(x + deltaX, y + deltaY); + } + + public String toString() { + return "(" + getX() + ", " + getY() + ")" ; + } +} +.... + +===== The `BoundPoint` aspect + +The `BoundPoint` aspect is responsible for `Point`'s "beanness". The +first thing it does is privately declare that each `Point` has a +`support` field that holds reference to an instance of +`PropertyChangeSupport`. + +.... +private PropertyChangeSupport Point.support = new PropertyChangeSupport(this); +.... + +The property change support object must be constructed with a reference +to the bean for which it is providing support, so it is initialized by +passing it `this`, an instance of `Point`. Since the `support` field is +private declared in the aspect, only the code in the aspect can refer to +it. + +The aspect also declares `Point`'s methods for registering and managing +listeners for property change events, which delegate the work to the +property change support object: + +.... +public void Point.addPropertyChangeListener(PropertyChangeListener listener){ + support.addPropertyChangeListener(listener); +} +public void Point.addPropertyChangeListener(String propertyName, + PropertyChangeListener listener){ + + support.addPropertyChangeListener(propertyName, listener); +} +public void Point.removePropertyChangeListener(String propertyName, + PropertyChangeListener listener) { + support.removePropertyChangeListener(propertyName, listener); +} +public void Point.removePropertyChangeListener(PropertyChangeListener listener) { + support.removePropertyChangeListener(listener); +} +public void Point.hasListeners(String propertyName) { + support.hasListeners(propertyName); +} +.... + +The aspect is also responsible for making sure `Point` implements the +`Serializable` interface: + +.... +declare parents: Point implements Serializable; +.... + +Implementing this interface in Java does not require any methods to be +implemented. Serialization for `Point` objects is provided by the +default serialization method. + +The `setters` pointcut picks out calls to the `Point`'s `set` methods: +any method whose name begins with "`set`" and takes one parameter. The +around advice on `setters()` stores the values of the `X` and `Y` +properties, calls the original `set` method and then fires the +appropriate property change event according to which set method was +called. + +.... +aspect BoundPoint { + private PropertyChangeSupport Point.support = new PropertyChangeSupport(this); + + public void Point.addPropertyChangeListener(PropertyChangeListener listener){ + support.addPropertyChangeListener(listener); + } + public void Point.addPropertyChangeListener(String propertyName, + PropertyChangeListener listener){ + + support.addPropertyChangeListener(propertyName, listener); + } + public void Point.removePropertyChangeListener(String propertyName, + PropertyChangeListener listener) { + support.removePropertyChangeListener(propertyName, listener); + } + public void Point.removePropertyChangeListener(PropertyChangeListener listener) { + support.removePropertyChangeListener(listener); + } + public void Point.hasListeners(String propertyName) { + support.hasListeners(propertyName); + } + + declare parents: Point implements Serializable; + + pointcut setter(Point p): call(void Point.set*(*)) && target(p); + + void around(Point p): setter(p) { + String propertyName = + thisJoinPointStaticPart.getSignature().getName().substring("set".length()); + int oldX = p.getX(); + int oldY = p.getY(); + proceed(p); + if (propertyName.equals("X")){ + firePropertyChange(p, propertyName, oldX, p.getX()); + } else { + firePropertyChange(p, propertyName, oldY, p.getY()); + } + } + + void firePropertyChange(Point p, + String property, + double oldval, + double newval) { + p.support.firePropertyChange(property, + new Double(oldval), + new Double(newval)); + } +} +.... + +===== The Test Program + +The test program registers itself as a property change listener to a +`Point` object that it creates and then performs simple manipulation of +that point: calling its set methods and the offset method. Then it +serializes the point and writes it to a file and then reads it back. The +result of saving and restoring the point is that a new point is created. + +.... +class Demo implements PropertyChangeListener { + + static final String fileName = "test.tmp"; + + public void propertyChange(PropertyChangeEvent e){ + System.out.println("Property " + e.getPropertyName() + " changed from " + + e.getOldValue() + " to " + e.getNewValue() ); + } + + public static void main(String[] args){ + Point p1 = new Point(); + p1.addPropertyChangeListener(new Demo()); + System.out.println("p1 =" + p1); + p1.setRectangular(5,2); + System.out.println("p1 =" + p1); + p1.setX( 6 ); + p1.setY( 3 ); + System.out.println("p1 =" + p1); + p1.offset(6,4); + System.out.println("p1 =" + p1); + save(p1, fileName); + Point p2 = (Point) restore(fileName); + System.out.println("Had: " + p1); + System.out.println("Got: " + p2); + } + ... +} +.... + +===== Compiling and Running the Example + +To compile and run this example, go to the examples directory and type: + +.... +ajc -argfile bean/files.lst +java bean.Demo +.... + +[[the-subject-observer-protocol]] +==== The Subject/Observer Protocol + +(The code for this example is in `InstallDir/examples/observer`.) + +This demo illustrates how the Subject/Observer design pattern can be +coded with aspects. + +The demo consists of the following: A colored label is a renderable +object that has a color that cycles through a set of colors, and a +number that records the number of cycles it has been through. A button +is an action item that records when it is clicked. + +With these two kinds of objects, we can build up a Subject/Observer +relationship in which colored labels observe the clicks of buttons; that +is, where colored labels are the observers and buttons are the subjects. + +The demo is designed and implemented using the Subject/Observer design +pattern. The remainder of this example explains the classes and aspects +of this demo, and tells you how to run it. + +===== Generic Components + +The generic parts of the protocol are the interfaces `Subject` and +`Observer`, and the abstract aspect `SubjectObserverProtocol`. The +`Subject` interface is simple, containing methods to add, remove, and +view `Observer` objects, and a method for getting data about state +changes: + +.... +interface Subject { + void addObserver(Observer obs); + void removeObserver(Observer obs); + Vector getObservers(); + Object getData(); +} +.... + +The `Observer` interface is just as simple, with methods to set and get +`Subject` objects, and a method to call when the subject gets updated. + +.... +interface Observer { + void setSubject(Subject s); + Subject getSubject(); + void update(); +} +.... + +The `SubjectObserverProtocol` aspect contains within it all of the +generic parts of the protocol, namely, how to fire the `Observer` +objects' update methods when some state changes in a subject. + +.... +abstract aspect SubjectObserverProtocol { + + abstract pointcut stateChanges(Subject s); + + after(Subject s): stateChanges(s) { + for (int i = 0; i < s.getObservers().size(); i++) { + ((Observer)s.getObservers().elementAt(i)).update(); + } + } + + private Vector Subject.observers = new Vector(); + public void Subject.addObserver(Observer obs) { + observers.addElement(obs); + obs.setSubject(this); + } + public void Subject.removeObserver(Observer obs) { + observers.removeElement(obs); + obs.setSubject(null); + } + public Vector Subject.getObservers() { return observers; } + + private Subject Observer.subject = null; + public void Observer.setSubject(Subject s) { subject = s; } + public Subject Observer.getSubject() { return subject; } + +} +.... + +Note that this aspect does three things. It define an abstract pointcut +that extending aspects can override. It defines advice that should run +after the join points of the pointcut. And it declares an inter-type +field and two inter-type methods so that each `Observer` can hold onto +its `Subject`. + +===== Application Classes + +`Button` objects extend `java.awt.Button`, and all they do is make sure +the `void click()` method is called whenever a button is clicked. + +.... +class Button extends java.awt.Button { + + static final Color defaultBackgroundColor = Color.gray; + static final Color defaultForegroundColor = Color.black; + static final String defaultText = "cycle color"; + + Button(Display display) { + super(); + setLabel(defaultText); + setBackground(defaultBackgroundColor); + setForeground(defaultForegroundColor); + addActionListener(new ActionListener() { + public void actionPerformed(ActionEvent e) { + Button.this.click(); + } + }); + display.addToFrame(this); + } + + public void click() {} + +} +.... + +Note that this class knows nothing about being a Subject. + +ColorLabel objects are labels that support the void colorCycle() method. +Again, they know nothing about being an observer. + +.... +class ColorLabel extends Label { + + ColorLabel(Display display) { + super(); + display.addToFrame(this); + } + + final static Color[] colors = {Color.red, Color.blue, + Color.green, Color.magenta}; + private int colorIndex = 0; + private int cycleCount = 0; + void colorCycle() { + cycleCount++; + colorIndex = (colorIndex + 1) % colors.length; + setBackground(colors[colorIndex]); + setText("" + cycleCount); + } +} +.... + +Finally, the `SubjectObserverProtocolImpl` implements the +subject/observer protocol, with `Button` objects as subjects and +`ColorLabel` objects as observers: + +.... +package observer; + +import java.util.Vector; + +aspect SubjectObserverProtocolImpl extends SubjectObserverProtocol { + + declare parents: Button implements Subject; + public Object Button.getData() { return this; } + + declare parents: ColorLabel implements Observer; + public void ColorLabel.update() { + colorCycle(); + } + + pointcut stateChanges(Subject s): + target(s) && + call(void Button.click()); + +} +.... + +It does this by assuring that `Button` and `ColorLabel` implement the +appropriate interfaces, declaring that they implement the methods +required by those interfaces, and providing a definition for the +abstract `stateChanges` pointcut. Now, every time a `Button` is clicked, +all `ColorLabel` objects observing that button will `colorCycle`. + +===== Compiling and Running + +`Demo` is the top class that starts this demo. It instantiates a two +buttons and three observers and links them together as subjects and +observers. So to run the demo, go to the `examples` directory and type: + +.... +ajc -argfile observer/files.lst +java observer.Demo +.... + +==== A Simple Telecom Simulation + +(The code for this example is in `InstallDir/examples/telecom`.) + +This example illustrates some ways that dependent concerns can be +encoded with aspects. It uses an example system comprising a simple +model of telephone connections to which timing and billing features are +added using aspects, where the billing feature depends upon the timing +feature. + +===== The Application + +The example application is a simple simulation of a telephony system in +which customers make, accept, merge and hang-up both local and long +distance calls. The application architecture is in three layers. + +* The basic objects provide basic functionality to simulate customers, +calls and connections (regular calls have one connection, conference +calls have more than one). +* The timing feature is concerned with timing the connections and +keeping the total connection time per customer. Aspects are used to add +a timer to each connection and to manage the total time per customer. +* The billing feature is concerned with charging customers for the calls +they make. Aspects are used to calculate a charge per connection and, +upon termination of a connection, to add the charge to the appropriate +customer's bill. The billing aspect builds upon the timing aspect: it +uses a pointcut defined in Timing and it uses the timers that are +associated with connections. + +The simulation of system has three configurations: basic, timing and +billing. Programs for the three configurations are in classes +`BasicSimulation`, `TimingSimulation` and `BillingSimulation`. These +share a common superclass `AbstractSimulation`, which defines the method +run with the simulation itself and the method wait used to simulate +elapsed time. + +===== The Basic Objects + +The telecom simulation comprises the classes `Customer`, `Call` and the +abstract class `Connection` with its two concrete subclasses `Local` and +`LongDistance`. Customers have a name and a numeric area code. They also +have methods for managing calls. Simple calls are made between one +customer (the caller) and another (the receiver), a `Connection` object +is used to connect them. Conference calls between more than two +customers will involve more than one connection. A customer may be +involved in many calls at one time. image:telecom.gif[image] + +===== The `Customer` class + +`Customer` has methods `call`, `pickup`, `hangup` and `merge` for +managing calls. + +.... +public class Customer { + + private String name; + private int areacode; + private Vector calls = new Vector(); + + protected void removeCall(Call c){ + calls.removeElement(c); + } + + protected void addCall(Call c){ + calls.addElement(c); + } + + public Customer(String name, int areacode) { + this.name = name; + this.areacode = areacode; + } + + public String toString() { + return name + "(" + areacode + ")"; + } + + public int getAreacode(){ + return areacode; + } + + public boolean localTo(Customer other){ + return areacode == other.areacode; + } + + public Call call(Customer receiver) { + Call call = new Call(this, receiver); + addCall(call); + return call; + } + + public void pickup(Call call) { + call.pickup(); + addCall(call); + } + + public void hangup(Call call) { + call.hangup(this); + removeCall(call); + } + + public void merge(Call call1, Call call2){ + call1.merge(call2); + removeCall(call2); + } + } +.... + +===== The `Call` class + +Calls are created with a caller and receiver who are customers. If the +caller and receiver have the same area code then the call can be +established with a `Local` connection (see below), otherwise a +`LongDistance` connection is required. A call comprises a number of +connections between customers. Initially there is only the connection +between the caller and receiver but additional connections can be added +if calls are merged to form conference calls. + +===== The `Connection` class + +The class `Connection` models the physical details of establishing a +connection between customers. It does this with a simple state machine +(connections are initially `PENDING`, then `COMPLETED` and finally +`DROPPED`). Messages are printed to the console so that the state of +connections can be observed. Connection is an abstract class with two +concrete subclasses: `Local` and `LongDistance`. + +.... +abstract class Connection { + + public static final int PENDING = 0; + public static final int COMPLETE = 1; + public static final int DROPPED = 2; + + Customer caller, receiver; + private int state = PENDING; + + Connection(Customer a, Customer b) { + this.caller = a; + this.receiver = b; + } + + public int getState(){ + return state; + } + + public Customer getCaller() { return caller; } + + public Customer getReceiver() { return receiver; } + + void complete() { + state = COMPLETE; + System.out.println("connection completed"); + } + + void drop() { + state = DROPPED; + System.out.println("connection dropped"); + } + + public boolean connects(Customer c){ + return (caller == c || receiver == c); + } + +} +.... + +===== The `Local` and `LongDistance` classes + +The two kinds of connections supported by our simulation are `Local` and +`LongDistance` connections. + +.... +class Local extends Connection { + Local(Customer a, Customer b) { + super(a, b); + System.out.println("[new local connection from " + + a + " to " + b + "]"); + } +} +.... + +.... +class LongDistance extends Connection { + LongDistance(Customer a, Customer b) { + super(a, b); + System.out.println("[new long distance connection from " + + a + " to " + b + "]"); + } +} +.... + +===== Compiling and Running the Basic Simulation + +The source files for the basic system are listed in the file +`basic.lst`. To build and run the basic system, in a shell window, type +these commands: + +.... +ajc -argfile telecom/basic.lst +java telecom.BasicSimulation +.... + +===== The Timing aspect + +The `Timing` aspect keeps track of total connection time for each +`Customer` by starting and stopping a timer associated with each +connection. It uses some helper classes: + +====== The `Timer` class + +A `Timer` object simply records the current time when it is started and +stopped, and returns their difference when asked for the elapsed time. +The aspect `TimerLog` (below) can be used to cause the start and stop +times to be printed to standard output. + +.... +class Timer { + long startTime, stopTime; + + public void start() { + startTime = System.currentTimeMillis(); + stopTime = startTime; + } + + public void stop() { + stopTime = System.currentTimeMillis(); + } + + public long getTime() { + return stopTime - startTime; + } +} +.... + +===== The `TimerLog` aspect + +The `TimerLog` aspect can be included in a build to get the timer to +announce when it is started and stopped. + +.... +public aspect TimerLog { + + after(Timer t): target(t) && call(* Timer.start()) { + System.err.println("Timer started: " + t.startTime); + } + + after(Timer t): target(t) && call(* Timer.stop()) { + System.err.println("Timer stopped: " + t.stopTime); + } +} +.... + +===== The `Timing` aspect + +The `Timing` aspect is declares an inter-type field `totalConnectTime` +for `Customer` to store the accumulated connection time per `Customer`. +It also declares that each `Connection` object has a timer. + +.... +public long Customer.totalConnectTime = 0; +private Timer Connection.timer = new Timer(); +.... + +Two pieces of after advice ensure that the timer is started when a +connection is completed and and stopped when it is dropped. The pointcut +`endTiming` is defined so that it can be used by the `Billing` aspect. + +.... +public aspect Timing { + + public long Customer.totalConnectTime = 0; + + public long getTotalConnectTime(Customer cust) { + return cust.totalConnectTime; + } + private Timer Connection.timer = new Timer(); + public Timer getTimer(Connection conn) { return conn.timer; } + + after (Connection c): target(c) && call(void Connection.complete()) { + getTimer(c).start(); + } + + pointcut endTiming(Connection c): target(c) && + call(void Connection.drop()); + + after(Connection c): endTiming(c) { + getTimer(c).stop(); + c.getCaller().totalConnectTime += getTimer(c).getTime(); + c.getReceiver().totalConnectTime += getTimer(c).getTime(); + } +} +.... + +===== The `Billing` aspect + +The Billing system adds billing functionality to the telecom application +on top of timing. + +The `Billing` aspect declares that each `Connection` has a `payer` +inter-type field to indicate who initiated the call and therefore who is +responsible to pay for it. It also declares the inter-type method +`callRate` of `Connection` so that local and long distance calls can be +charged differently. The call charge must be calculated after the timer +is stopped; the after advice on pointcut `Timing.endTiming` does this, +and `Billing` is declared to be more precedent than `Timing` to make +sure that this advice runs after `Timing`'s advice on the same join +point. Finally, it declares inter-type methods and fields for `Customer` +to handle the `totalCharge`. + +.... +public aspect Billing { + // precedence required to get advice on endtiming in the right order + declare precedence: Billing, Timing; + + public static final long LOCAL_RATE = 3; + public static final long LONG_DISTANCE_RATE = 10; + + public Customer Connection.payer; + public Customer getPayer(Connection conn) { return conn.payer; } + + after(Customer cust) returning (Connection conn): + args(cust, ..) && call(Connection+.new(..)) { + conn.payer = cust; + } + + public abstract long Connection.callRate(); + + public long LongDistance.callRate() { return LONG_DISTANCE_RATE; } + public long Local.callRate() { return LOCAL_RATE; } + + after(Connection conn): Timing.endTiming(conn) { + long time = Timing.aspectOf().getTimer(conn).getTime(); + long rate = conn.callRate(); + long cost = rate * time; + getPayer(conn).addCharge(cost); + } + + public long Customer.totalCharge = 0; + public long getTotalCharge(Customer cust) { return cust.totalCharge; } + + public void Customer.addCharge(long charge){ + totalCharge += charge; + } +} +.... + +===== Accessing the inter-type state + +Both the aspects `Timing` and `Billing` contain the definition of +operations that the rest of the system may want to access. For example, +when running the simulation with one or both aspects, we want to find +out how much time each customer spent on the telephone and how big their +bill is. That information is also stored in the classes, but they are +accessed through static methods of the aspects, since the state they +refer to is private to the aspect. + +Take a look at the file `TimingSimulation.java`. The most important +method of this class is the method `report(Customer)`, which is used in +the method run of the superclass `AbstractSimulation`. This method is +intended to print out the status of the customer, with respect to the +`Timing` feature. + +.... +protected void report(Customer c){ + Timing t = Timing.aspectOf(); + System.out.println(c + " spent " + t.getTotalConnectTime(c)); +} +.... + +===== Compiling and Running + +The files timing.lst and billing.lst contain file lists for the timing +and billing configurations. To build and run the application with only +the timing feature, go to the directory examples and type: + +.... +ajc -argfile telecom/timing.lst +java telecom.TimingSimulation +.... + +To build and run the application with the timing and billing features, +go to the directory examples and type: + +.... +ajc -argfile telecom/billing.lst +java telecom.BillingSimulation +.... + +===== Discussion + +There are some explicit dependencies between the aspects Billing and +Timing: + +* Billing is declared more precedent than Timing so that Billing's after +advice runs after that of Timing when they are on the same join point. +* Billing uses the pointcut Timing.endTiming. +* Billing needs access to the timer associated with a connection. + +[[examples-reusable]] +=== Reusable Aspects + +==== Tracing using Aspects, Revisited + +(The code for this example is in `InstallDir/examples/tracing`.) + +===== Tracing - Version 3 + +One advantage of not exposing the methods traceEntry and traceExit as +public operations is that we can easily change their interface without +any dramatic consequences in the rest of the code. + +Consider, again, the program without AspectJ. Suppose, for example, that +at some point later the requirements for tracing change, stating that +the trace messages should always include the string representation of +the object whose methods are being traced. This can be achieved in at +least two ways. One way is keep the interface of the methods +`traceEntry` and `traceExit` as it was before, + +.... +public static void traceEntry(String str); +public static void traceExit(String str); +.... + +In this case, the caller is responsible for ensuring that the string +representation of the object is part of the string given as argument. +So, calls must look like: + +.... +Trace.traceEntry("Square.distance in " + toString()); +.... + +Another way is to enforce the requirement with a second argument in the +trace operations, e.g. + +.... +public static void traceEntry(String str, Object obj); +public static void traceExit(String str, Object obj); +.... + +In this case, the caller is still responsible for sending the right +object, but at least there is some guarantees that some object will be +passed. The calls will look like: + +.... +Trace.traceEntry("Square.distance", this); +.... + +In either case, this change to the requirements of tracing will have +dramatic consequences in the rest of the code -- every call to the trace +operations traceEntry and traceExit must be changed! + +Here's another advantage of doing tracing with an aspect. We've already +seen that in version 2 `traceEntry` and `traceExit` are not publicly +exposed. So changing their interfaces, or the way they are used, has +only a small effect inside the `Trace` class. Here's a partial view at +the implementation of `Trace`, version 3. The differences with respect +to version 2 are stressed in the comments: + +.... +abstract aspect Trace { + + public static int TRACELEVEL = 0; + protected static PrintStream stream = null; + protected static int callDepth = 0; + + public static void initStream(PrintStream s) { + stream = s; + } + + protected static void traceEntry(String str, Object o) { + if (TRACELEVEL == 0) return; + if (TRACELEVEL == 2) callDepth++; + printEntering(str + ": " + o.toString()); + } + + protected static void traceExit(String str, Object o) { + if (TRACELEVEL == 0) return; + printExiting(str + ": " + o.toString()); + if (TRACELEVEL == 2) callDepth--; + } + + private static void printEntering(String str) { + printIndent(); + stream.println("Entering " + str); + } + + private static void printExiting(String str) { + printIndent(); + stream.println("Exiting " + str); + } + + private static void printIndent() { + for (int i = 0; i < callDepth; i++) + stream.print(" "); + } + + abstract pointcut myClass(Object obj); + + pointcut myConstructor(Object obj): myClass(obj) && execution(new(..)); + pointcut myMethod(Object obj): myClass(obj) && + execution(* *(..)) && !execution(String toString()); + + before(Object obj): myConstructor(obj) { + traceEntry("" + thisJoinPointStaticPart.getSignature(), obj); + } + after(Object obj): myConstructor(obj) { + traceExit("" + thisJoinPointStaticPart.getSignature(), obj); + } + + before(Object obj): myMethod(obj) { + traceEntry("" + thisJoinPointStaticPart.getSignature(), obj); + } + after(Object obj): myMethod(obj) { + traceExit("" + thisJoinPointStaticPart.getSignature(), obj); + } +} +.... + +As you can see, we decided to apply the first design by preserving the +interface of the methods `traceEntry` and `traceExit`. But it doesn't +matter - we could as easily have applied the second design (the code in +the directory `examples/tracing/version3` has the second design). The +point is that the effects of this change in the tracing requirements are +limited to the `Trace` aspect class. + +One implementation change worth noticing is the specification of the +pointcuts. They now expose the object. To maintain full consistency with +the behavior of version 2, we should have included tracing for static +methods, by defining another pointcut for static methods and advising +it. We leave that as an exercise. + +Moreover, we had to exclude the execution join point of the method +`toString` from the `methods` pointcut. The problem here is that +`toString` is being called from inside the advice. Therefore if we trace +it, we will end up in an infinite recursion of calls. This is a subtle +point, and one that you must be aware when writing advice. If the advice +calls back to the objects, there is always the possibility of recursion. +Keep that in mind! + +In fact, esimply excluding the execution join point may not be enough, +if there are calls to other traced methods within it -- in which case, +the restriction should be + +.... +&& !cflow(execution(String toString())) +.... + +excluding both the execution of toString methods and all join points +under that execution. + +In summary, to implement the change in the tracing requirements we had +to make a couple of changes in the implementation of the `Trace` aspect +class, including changing the specification of the pointcuts. That's +only natural. But the implementation changes were limited to this +aspect. Without aspects, we would have to change the implementation of +every application class. + +Finally, to run this version of tracing, go to the directory `examples` +and type: + +.... +ajc -argfile tracing/tracev3.lst +.... + +The file tracev3.lst lists the application classes as well as this +version of the files `Trace.java` and `TraceMyClasses.java`. To run the +program, type + +.... +java tracing.version3.TraceMyClasses +.... + +The output should be: + +.... + --> tracing.TwoDShape(double, double) + <-- tracing.TwoDShape(double, double) + --> tracing.Circle(double, double, double) + <-- tracing.Circle(double, double, double) + --> tracing.TwoDShape(double, double) + <-- tracing.TwoDShape(double, double) + --> tracing.Circle(double, double, double) + <-- tracing.Circle(double, double, double) + --> tracing.Circle(double) + <-- tracing.Circle(double) + --> tracing.TwoDShape(double, double) + <-- tracing.TwoDShape(double, double) + --> tracing.Square(double, double, double) + <-- tracing.Square(double, double, double) + --> tracing.Square(double, double) + <-- tracing.Square(double, double) + --> double tracing.Circle.perimeter() + <-- double tracing.Circle.perimeter() +c1.perimeter() = 12.566370614359172 + --> double tracing.Circle.area() + <-- double tracing.Circle.area() +c1.area() = 12.566370614359172 + --> double tracing.Square.perimeter() + <-- double tracing.Square.perimeter() +s1.perimeter() = 4.0 + --> double tracing.Square.area() + <-- double tracing.Square.area() +s1.area() = 1.0 + --> double tracing.TwoDShape.distance(TwoDShape) + --> double tracing.TwoDShape.getX() + <-- double tracing.TwoDShape.getX() + --> double tracing.TwoDShape.getY() + <-- double tracing.TwoDShape.getY() + <-- double tracing.TwoDShape.distance(TwoDShape) +c2.distance(c1) = 4.242640687119285 + --> double tracing.TwoDShape.distance(TwoDShape) + --> double tracing.TwoDShape.getX() + <-- double tracing.TwoDShape.getX() + --> double tracing.TwoDShape.getY() + <-- double tracing.TwoDShape.getY() + <-- double tracing.TwoDShape.distance(TwoDShape) +s1.distance(c1) = 2.23606797749979 + --> String tracing.Square.toString() + --> String tracing.TwoDShape.toString() + <-- String tracing.TwoDShape.toString() + <-- String tracing.Square.toString() +s1.toString(): Square side = 1.0 @ (1.0, 2.0) +.... diff --git a/docs/progGuideDB/examples.xml b/docs/progGuideDB/examples.xml index f0ce3808e..12fbe8ef2 100644 --- a/docs/progGuideDB/examples.xml +++ b/docs/progGuideDB/examples.xml @@ -778,7 +778,7 @@ s1.toString(): Square side = 1.0 @ (1.0, 2.0) - Tracing—Version 1 + Tracing - Version 1 In a first attempt to insert tracing in this application, we will @@ -918,15 +918,15 @@ s1.toString(): Square side = 1.0 @ (1.0, 2.0) - Tracing—Version 2 + Tracing - Version 2 Another way to accomplish the same thing would be to write a reusable tracing aspect that can be used not only for these application classes, but for any class. One way to do this is to merge the tracing functionality of - Trace—version1 with the crosscutting - support of TraceMyClasses—version1. We end + Trace - version1 with the crosscutting + support of TraceMyClasses - version1. We end up with a Trace aspect (found in version2/Trace.java) with the following public interface @@ -2180,7 +2180,7 @@ java telecom.BillingSimulation - Tracing—Version 3 + Tracing - Version 3 One advantage of not exposing the methods traceEntry and @@ -2314,7 +2314,7 @@ abstract aspect Trace { As you can see, we decided to apply the first design by preserving the interface of the methods traceEntry and - traceExit. But it doesn't matter—we could + traceExit. But it doesn't matter - we could as easily have applied the second design (the code in the directory examples/tracing/version3 has the second design). The point is that the effects of this change in the diff --git a/docs/progGuideDB/gettingstarted.adoc b/docs/progGuideDB/gettingstarted.adoc new file mode 100644 index 000000000..0930d2e44 --- /dev/null +++ b/docs/progGuideDB/gettingstarted.adoc @@ -0,0 +1,952 @@ +[[starting]] +== Getting Started with AspectJ + +[[starting-intro]] +=== Introduction + +Many software developers are attracted to the idea of aspect-oriented +programming (AOP) but unsure about how to begin using the technology. +They recognize the concept of crosscutting concerns, and know that they +have had problems with the implementation of such concerns in the past. +But there are many questions about how to adopt AOP into the development +process. Common questions include: + +* Can I use aspects in my existing code? +* What kinds of benefits can I expect to get from using aspects? +* How do I find aspects in my programs? +* How steep is the learning curve for AOP? +* What are the risks of using this new technology? + +This chapter addresses these questions in the context of AspectJ: a +general-purpose aspect-oriented extension to Java. A series of abridged +examples illustrate the kinds of aspects programmers may want to +implement using AspectJ and the benefits associated with doing so. +Readers who would like to understand the examples in more detail, or who +want to learn how to program examples like these, can find more complete +examples and supporting material linked from the https://www.eclipse.org/aspectj/:[AspectJ web site]. + +A significant risk in adopting any new technology is going too far too +fast. Concern about this risk causes many organizations to be +conservative about adopting new technology. To address this issue, the +examples in this chapter are grouped into three broad categories, with +aspects that are easier to adopt into existing development projects +coming earlier in this chapter. The next section, +xref:#starting-aspectj[Introduction to AspectJ], we present the core of +AspectJ's features, and in xref:#starting-development[Development +Aspects], we present aspects that facilitate tasks such as debugging, +testing and performance tuning of applications. And, in the section +following, xref:#starting-production[Production Aspects], we present +aspects that implement crosscutting functionality common in Java +applications. We will defer discussing a third category of aspects, +reusable aspects, until xref:#language[???]. + +These categories are informal, and this ordering is not the only way to +adopt AspectJ. Some developers may want to use a production aspect right +away. But our experience with current AspectJ users suggests that this +is one ordering that allows developers to get experience with (and +benefit from) AOP technology quickly, while also minimizing risk. + +[[starting-aspectj]] +=== Introduction to AspectJ + +This section presents a brief introduction to the features of AspectJ +used later in this chapter. These features are at the core of the +language, but this is by no means a complete overview of AspectJ. + +The features are presented using a simple figure editor system. A +`Figure` consists of a number of `FigureElements`, which can be either +`Point`s or `Line`s. The `Figure` class provides factory services. There +is also a `Display`. Most example programs later in this chapter are +based on this system as well. + +image:figureUML.gif[ UML for the `FigureEditor` example ] + +The motivation for AspectJ (and likewise for aspect-oriented +programming) is the realization that there are issues or concerns that +are not well captured by traditional programming methodologies. Consider +the problem of enforcing a security policy in some application. By its +nature, security cuts across many of the natural units of modularity of +the application. Moreover, the security policy must be uniformly applied +to any additions as the application evolves. And the security policy +that is being applied might itself evolve. Capturing concerns like a +security policy in a disciplined way is difficult and error-prone in a +traditional programming language. + +Concerns like security cut across the natural units of modularity. For +object-oriented programming languages, the natural unit of modularity is +the class. But in object-oriented programming languages, crosscutting +concerns are not easily turned into classes precisely because they cut +across classes, and so these aren't reusable, they can't be refined or +inherited, they are spread through out the program in an undisciplined +way, in short, they are difficult to work with. + +Aspect-oriented programming is a way of modularizing crosscutting +concerns much like object-oriented programming is a way of modularizing +common concerns. AspectJ is an implementation of aspect-oriented +programming for Java. + +AspectJ adds to Java just one new concept, a join point -- and that's +really just a name for an existing Java concept. It adds to Java only a +few new constructs: pointcuts, advice, inter-type declarations and +aspects. Pointcuts and advice dynamically affect program flow, +inter-type declarations statically affects a program's class hierarchy, +and aspects encapsulate these new constructs. + +A _join point_ is a well-defined point in the program flow. A _pointcut_ +picks out certain join points and values at those points. A piece of +_advice_ is code that is executed when a join point is reached. These +are the dynamic parts of AspectJ. + +AspectJ also has different kinds of _inter-type declarations_ that allow +the programmer to modify a program's static structure, namely, the +members of its classes and the relationship between classes. + +AspectJ's _aspect_ are the unit of modularity for crosscutting concerns. +They behave somewhat like Java classes, but may also include pointcuts, +advice and inter-type declarations. + +In the sections immediately following, we are first going to look at +join points and how they compose into pointcuts. Then we will look at +advice, the code which is run when a pointcut is reached. We will see +how to combine pointcuts and advice into aspects, AspectJ's reusable, +inheritable unit of modularity. Lastly, we will look at how to use +inter-type declarations to deal with crosscutting concerns of a +program's class structure. + +==== The Dynamic Join Point Model + +A critical element in the design of any aspect-oriented language is the +join point model. The join point model provides the common frame of +reference that makes it possible to define the dynamic structure of +crosscutting concerns. This chapter describes AspectJ's dynamic join +points, in which join points are certain well-defined points in the +execution of the program. + +AspectJ provides for many kinds of join points, but this chapter +discusses only one of them: method call join points. A method call join +point encompasses the actions of an object receiving a method call. It +includes all the actions that comprise a method call, starting after all +arguments are evaluated up to and including return (either normally or +by throwing an exception). + +Each method call at runtime is a different join point, even if it comes +from the same call expression in the program. Many other join points may +run while a method call join point is executing -- all the join points +that happen while executing the method body, and in those methods called +from the body. We say that these join points execute in the _dynamic +context_ of the original call join point. + +[[pointcuts-starting]] +==== Pointcuts + +In AspectJ, _pointcuts_ pick out certain join points in the program +flow. For example, the pointcut + +.... +call(void Point.setX(int)) +.... + +picks out each join point that is a call to a method that has the +signature `void Point.setX(int)` - that is, `Point`'s void `setX` method +with a single `int` parameter. + +A pointcut can be built out of other pointcuts with and, or, and not +(spelled `&&`, `||`, and `!`). For example: + +.... +call(void Point.setX(int)) || +call(void Point.setY(int)) +.... + +picks out each join point that is either a call to `setX` or a call to +`setY`. + +Pointcuts can identify join points from many different types - in other +words, they can crosscut types. For example, + +.... +call(void FigureElement.setXY(int,int)) || +call(void Point.setX(int)) || +call(void Point.setY(int)) || +call(void Line.setP1(Point)) || +call(void Line.setP2(Point)); +.... + +picks out each join point that is a call to one of five methods (the +first of which is an interface method, by the way). + +In our example system, this pointcut captures all the join points when a +`FigureElement` moves. While this is a useful way to specify this +crosscutting concern, it is a bit of a mouthful. So AspectJ allows +programmers to define their own named pointcuts with the `pointcut` +form. So the following declares a new, named pointcut: + +.... +pointcut move(): + call(void FigureElement.setXY(int,int)) || + call(void Point.setX(int)) || + call(void Point.setY(int)) || + call(void Line.setP1(Point)) || + call(void Line.setP2(Point)); +.... + +and whenever this definition is visible, the programmer can simply use +`move()` to capture this complicated pointcut. + +The previous pointcuts are all based on explicit enumeration of a set of +method signatures. We sometimes call this _name-based_ crosscutting. +AspectJ also provides mechanisms that enable specifying a pointcut in +terms of properties of methods other than their exact name. We call this +_property-based_ crosscutting. The simplest of these involve using +wildcards in certain fields of the method signature. For example, the +pointcut + +.... +call(void Figure.make*(..)) +.... + +picks out each join point that's a call to a void method defined on +`Figure` whose the name begins with "`make`" regardless of the method's +parameters. In our system, this picks out calls to the factory methods +`makePoint` and `makeLine`. The pointcut + +.... +call(public * Figure.* (..)) +.... + +picks out each call to `Figure`'s public methods. + +But wildcards aren't the only properties AspectJ supports. Another +pointcut, `cflow`, identifies join points based on whether they occur in +the dynamic context of other join points. So + +.... +cflow(move()) +.... + +picks out each join point that occurs in the dynamic context of the join +points picked out by `move()`, our named pointcut defined above. So this +picks out each join points that occurrs between when a move method is +called and when it returns (either normally or by throwing an +exception). + +[[advice-starting]] +==== Advice + +So pointcuts pick out join points. But they don't _do_ anything apart +from picking out join points. To actually implement crosscutting +behavior, we use advice. Advice brings together a pointcut (to pick out +join points) and a body of code (to run at each of those join points). + +AspectJ has several different kinds of advice. _Before advice_ runs as a +join point is reached, before the program proceeds with the join point. +For example, before advice on a method call join point runs before the +actual method starts running, just after the arguments to the method +call are evaluated. + +.... +before(): move() { + System.out.println("about to move"); +} +.... + +_After advice_ on a particular join point runs after the program +proceeds with that join point. For example, after advice on a method +call join point runs after the method body has run, just before before +control is returned to the caller. Because Java programs can leave a +join point 'normally' or by throwing an exception, there are three kinds +of after advice: `after returning`, `after + throwing`, and plain `after` (which runs after returning _or_ +throwing, like Java's `finally`). + +.... +after() returning: move() { + System.out.println("just successfully moved"); +} +.... + +_Around advice_ on a join point runs as the join point is reached, and +has explicit control over whether the program proceeds with the join +point. Around advice is not discussed in this section. + +===== Exposing Context in Pointcuts + +Pointcuts not only pick out join points, they can also expose part of +the execution context at their join points. Values exposed by a pointcut +can be used in the body of advice declarations. + +An advice declaration has a parameter list (like a method) that gives +names to all the pieces of context that it uses. For example, the after +advice + +.... +after(FigureElement fe, int x, int y) returning: + ...SomePointcut... { + ...SomeBody... +} +.... + +uses three pieces of exposed context, a `FigureElement` named fe, and +two `int`s named x and y. + +The body of the advice uses the names just like method parameters, so + +.... +after(FigureElement fe, int x, int y) returning: + ...SomePointcut... { + System.out.println(fe + " moved to (" + x + ", " + y + ")"); +} +.... + +The advice's pointcut publishes the values for the advice's arguments. +The three primitive pointcuts `this`, `target` and `args` are used to +publish these values. So now we can write the complete piece of advice: + +.... +after(FigureElement fe, int x, int y) returning: + call(void FigureElement.setXY(int, int)) + && target(fe) + && args(x, y) { + System.out.println(fe + " moved to (" + x + ", " + y + ")"); +} +.... + +The pointcut exposes three values from calls to `setXY`: the target +`FigureElement` -- which it publishes as `fe`, so it becomes the first +argument to the after advice -- and the two int arguments -- which it +publishes as `x` and `y`, so they become the second and third argument +to the after advice. + +So the advice prints the figure element that was moved and its new `x` +and `y` coordinates after each `setXY` method call. + +A named pointcut may have parameters like a piece of advice. When the +named pointcut is used (by advice, or in another named pointcut), it +publishes its context by name just like the `this`, `target` and `args` +pointcut. So another way to write the above advice is + +.... +pointcut setXY(FigureElement fe, int x, int y): + call(void FigureElement.setXY(int, int)) + && target(fe) + && args(x, y); + +after(FigureElement fe, int x, int y) returning: setXY(fe, x, y) { + System.out.println(fe + " moved to (" + x + ", " + y + ")."); +} +.... + +==== Inter-type declarations + +Inter-type declarations in AspectJ are declarations that cut across +classes and their hierarchies. They may declare members that cut across +multiple classes, or change the inheritance relationship between +classes. Unlike advice, which operates primarily dynamically, +introduction operates statically, at compile-time. + +Consider the problem of expressing a capability shared by some existing +classes that are already part of a class hierarchy, i.e. they already +extend a class. In Java, one creates an interface that captures this new +capability, and then adds to _each affected class_ a method that +implements this interface. + +AspectJ can express the concern in one place, by using inter-type +declarations. The aspect declares the methods and fields that are +necessary to implement the new capability, and associates the methods +and fields to the existing classes. + +Suppose we want to have `Screen` objects observe changes to `Point` +objects, where `Point` is an existing class. We can implement this by +writing an aspect declaring that the class Point `Point` has an instance +field, `observers`, that keeps track of the `Screen` objects that are +observing `Point`s. + +.... +aspect PointObserving { + private Vector Point.observers = new Vector(); + ... +} +.... + +The `observers` field is private, so only `PointObserving` can see it. +So observers are added or removed with the static methods `addObserver` +and `removeObserver` on the aspect. + +.... +aspect PointObserving { + private Vector Point.observers = new Vector(); + + public static void addObserver(Point p, Screen s) { + p.observers.add(s); + } + public static void removeObserver(Point p, Screen s) { + p.observers.remove(s); + } + ... +} +.... + +Along with this, we can define a pointcut `changes` that defines what we +want to observe, and the after advice defines what we want to do when we +observe a change. + +.... +aspect PointObserving { + private Vector Point.observers = new Vector(); + + public static void addObserver(Point p, Screen s) { + p.observers.add(s); + } + public static void removeObserver(Point p, Screen s) { + p.observers.remove(s); + } + + pointcut changes(Point p): target(p) && call(void Point.set*(int)); + + after(Point p): changes(p) { + Iterator iter = p.observers.iterator(); + while ( iter.hasNext() ) { + updateObserver(p, (Screen)iter.next()); + } + } + + static void updateObserver(Point p, Screen s) { + s.display(p); + } +} +.... + +Note that neither `Screen`'s nor `Point`'s code has to be modified, and +that all the changes needed to support this new capability are local to +this aspect. + +==== Aspects + +Aspects wrap up pointcuts, advice, and inter-type declarations in a a +modular unit of crosscutting implementation. It is defined very much +like a class, and can have methods, fields, and initializers in addition +to the crosscutting members. Because only aspects may include these +crosscutting members, the declaration of these effects is localized. + +Like classes, aspects may be instantiated, but AspectJ controls how that +instantiation happens -- so you can't use Java's `new` form to build new +aspect instances. By default, each aspect is a singleton, so one aspect +instance is created. This means that advice may use non-static fields of +the aspect, if it needs to keep state around: + +.... +aspect Logging { + OutputStream logStream = System.err; + + before(): move() { + logStream.println("about to move"); + } +} +.... + +Aspects may also have more complicated rules for instantiation, but +these will be described in a later chapter. + +[[starting-development]] +=== Development Aspects + +The next two sections present the use of aspects in increasingly +sophisticated ways. Development aspects are easily removed from +production builds. Production aspects are intended to be used in both +development and in production, but tend to affect only a few classes. + +This section presents examples of aspects that can be used during +development of Java applications. These aspects facilitate debugging, +testing and performance tuning work. The aspects define behavior that +ranges from simple tracing, to profiling, to testing of internal +consistency within the application. Using AspectJ makes it possible to +cleanly modularize this kind of functionality, thereby making it +possible to easily enable and disable the functionality when desired. + +==== Tracing + +This first example shows how to increase the visibility of the internal +workings of a program. It is a simple tracing aspect that prints a +message at specified method calls. In our figure editor example, one +such aspect might simply trace whenever points are drawn. + +.... +aspect SimpleTracing { + pointcut tracedCall(): + call(void FigureElement.draw(GraphicsContext)); + + before(): tracedCall() { + System.out.println("Entering: " + thisJoinPoint); + } +} +.... + +This code makes use of the `thisJoinPoint` special variable. Within all +advice bodies this variable is bound to an object that describes the +current join point. The effect of this code is to print a line like the +following every time a figure element receives a `draw` method call: + +.... +Entering: call(void FigureElement.draw(GraphicsContext)) +.... + +To understand the benefit of coding this with AspectJ consider changing +the set of method calls that are traced. With AspectJ, this just +requires editing the definition of the `tracedCalls` pointcut and +recompiling. The individual methods that are traced do not need to be +edited. + +When debugging, programmers often invest considerable effort in figuring +out a good set of trace points to use when looking for a particular kind +of problem. When debugging is complete or appears to be complete it is +frustrating to have to lose that investment by deleting trace statements +from the code. The alternative of just commenting them out makes the +code look bad, and can cause trace statements for one kind of debugging +to get confused with trace statements for another kind of debugging. + +With AspectJ it is easy to both preserve the work of designing a good +set of trace points and disable the tracing when it isn t being used. +This is done by writing an aspect specifically for that tracing mode, +and removing that aspect from the compilation when it is not needed. + +This ability to concisely implement and reuse debugging configurations +that have proven useful in the past is a direct result of AspectJ +modularizing a crosscutting design element the set of methods that are +appropriate to trace when looking for a given kind of information. + +==== Profiling and Logging + +Our second example shows you how to do some very specific profiling. +Although many sophisticated profiling tools are available, and these can +gather a variety of information and display the results in useful ways, +you may sometimes want to profile or log some very specific behavior. In +these cases, it is often possible to write a simple aspect similar to +the ones above to do the job. + +For example, the following aspect counts the number of calls to the +`rotate` method on a `Line` and the number of calls to the `set*` +methods of a `Point` that happen within the control flow of those calls +to `rotate`: + +.... +aspect SetsInRotateCounting { + int rotateCount = 0; + int setCount = 0; + + before(): call(void Line.rotate(double)) { + rotateCount++; + } + + before(): call(void Point.set*(int)) + && cflow(call(void Line.rotate(double))) { + setCount++; + } +} +.... + +In effect, this aspect allows the programmer to ask very specific +questions like + +____ +How many times is the + +rotate + +method defined on + +Line + +objects called? +____ + +and + +____ +How many times are methods defined on + +Point + +objects whose name begins with " + +set + +" called in fulfilling those rotate calls? +____ + +questions it may be difficult to express using standard profiling or +logging tools. + +[[pre-and-post-conditions]] +==== Pre- and Post-Conditions + +Many programmers use the "Design by Contract" style popularized by +Bertand Meyer in Object-Oriented Software Construction, 2/e. In this +style of programming, explicit pre-conditions test that callers of a +method call it properly and explicit post-conditions test that methods +properly do the work they are supposed to. + +AspectJ makes it possible to implement pre- and post-condition testing +in modular form. For example, this code + +.... +aspect PointBoundsChecking { + + pointcut setX(int x): + (call(void FigureElement.setXY(int, int)) && args(x, *)) + || (call(void Point.setX(int)) && args(x)); + + pointcut setY(int y): + (call(void FigureElement.setXY(int, int)) && args(*, y)) + || (call(void Point.setY(int)) && args(y)); + + before(int x): setX(x) { + if ( x < MIN_X || x > MAX_X ) + throw new IllegalArgumentException("x is out of bounds."); + } + + before(int y): setY(y) { + if ( y < MIN_Y || y > MAX_Y ) + throw new IllegalArgumentException("y is out of bounds."); + } +} +.... + +implements the bounds checking aspect of pre-condition testing for +operations that move points. Notice that the `setX` pointcut refers to +all the operations that can set a Point's `x` coordinate; this includes +the `setX` method, as well as half of the `setXY` method. In this sense +the `setX` pointcut can be seen as involving very fine-grained +crosscutting - it names the the `setX` method and half of the `setXY` +method. + +Even though pre- and post-condition testing aspects can often be used +only during testing, in some cases developers may wish to include them +in the production build as well. Again, because AspectJ makes it +possible to modularize these crosscutting concerns cleanly, it gives +developers good control over this decision. + +==== Contract Enforcement + +The property-based crosscutting mechanisms can be very useful in +defining more sophisticated contract enforcement. One very powerful use +of these mechanisms is to identify method calls that, in a correct +program, should not exist. For example, the following aspect enforces +the constraint that only the well-known factory methods can add an +element to the registry of figure elements. Enforcing this constraint +ensures that no figure element is added to the registry more than once. + +.... +aspect RegistrationProtection { + + pointcut register(): call(void Registry.register(FigureElement)); + + pointcut canRegister(): withincode(static * FigureElement.make*(..)); + + before(): register() && !canRegister() { + throw new IllegalAccessException("Illegal call " + thisJoinPoint); + } +} +.... + +This aspect uses the withincode primitive pointcut to denote all join +points that occur within the body of the factory methods on +`FigureElement` (the methods with names that begin with "`make`"). This +is a property-based pointcut because it identifies join points based not +on their signature, but rather on the property that they occur +specifically within the code of another method. The before advice +declaration effectively says signal an error for any calls to register +that are not within the factory methods. + +This advice throws a runtime exception at certain join points, but +AspectJ can do better. Using the `declare error` form, we can have the +_compiler_ signal the error. + +.... +aspect RegistrationProtection { + + pointcut register(): call(void Registry.register(FigureElement)); + pointcut canRegister(): withincode(static * FigureElement.make*(..)); + + declare error: register() && !canRegister(): "Illegal call" +} +.... + +When using this aspect, it is impossible for the compiler to compile +programs with these illegal calls. This early detection is not always +possible. In this case, since we depend only on static information (the +`withincode` pointcut picks out join points totally based on their code, +and the `call` pointcut here picks out join points statically). Other +enforcement, such as the precondition enforcement, above, does require +dynamic information such as the runtime value of parameters. + +==== Configuration Management + +Configuration management for aspects can be handled using a variety of +make-file like techniques. To work with optional aspects, the programmer +can simply define their make files to either include the aspect in the +call to the AspectJ compiler or not, as desired. + +Developers who want to be certain that no aspects are included in the +production build can do so by configuring their make files so that they +use a traditional Java compiler for production builds. To make it easy +to write such make files, the AspectJ compiler has a command-line +interface that is consistent with ordinary Java compilers. + +[[starting-production]] +=== Production Aspects + +This section presents examples of aspects that are inherently intended +to be included in the production builds of an application. Production +aspects tend to add functionality to an application rather than merely +adding more visibility of the internals of a program. Again, we begin +with name-based aspects and follow with property-based aspects. +Name-based production aspects tend to affect only a small number of +methods. For this reason, they are a good next step for projects +adopting AspectJ. But even though they tend to be small and simple, they +can often have a significant effect in terms of making the program +easier to understand and maintain. + +==== Change Monitoring + +The first example production aspect shows how one might implement some +simple functionality where it is problematic to try and do it +explicitly. It supports the code that refreshes the display. The role of +the aspect is to maintain a dirty bit indicating whether or not an +object has moved since the last time the display was refreshed. + +Implementing this functionality as an aspect is straightforward. The +`testAndClear` method is called by the display code to find out whether +a figure element has moved recently. This method returns the current +state of the dirty flag and resets it to false. The pointcut `move` +captures all the method calls that can move a figure element. The after +advice on `move` sets the dirty flag whenever an object moves. + +.... +aspect MoveTracking { + private static boolean dirty = false; + + public static boolean testAndClear() { + boolean result = dirty; + dirty = false; + return result; + } + + pointcut move(): + call(void FigureElement.setXY(int, int)) || + call(void Line.setP1(Point)) || + call(void Line.setP2(Point)) || + call(void Point.setX(int)) || + call(void Point.setY(int)); + + after() returning: move() { + dirty = true; + } +} +.... + +Even this simple example serves to illustrate some of the important +benefits of using AspectJ in production code. Consider implementing this +functionality with ordinary Java: there would likely be a helper class +that contained the `dirty` flag, the `testAndClear` method, as well as a +`setFlag` method. Each of the methods that could move a figure element +would include a call to the `setFlag` method. Those calls, or rather the +concept that those calls should happen at each move operation, are the +crosscutting concern in this case. + +The AspectJ implementation has several advantages over the standard +implementation: + +_The structure of the crosscutting concern is captured explicitly._ The +moves pointcut clearly states all the methods involved, so the +programmer reading the code sees not just individual calls to `setFlag`, +but instead sees the real structure of the code. The IDE support +included with AspectJ automatically reminds the programmer that this +aspect advises each of the methods involved. The IDE support also +provides commands to jump to the advice from the method and vice-versa. + +_Evolution is easier._ If, for example, the aspect needs to be revised +to record not just that some figure element moved, but rather to record +exactly which figure elements moved, the change would be entirely local +to the aspect. The pointcut would be updated to expose the object being +moved, and the advice would be updated to record that object. The paper +An Overview of AspectJ (available linked off of the AspectJ web site -- +http://eclipse.org/aspectj[]), presented at ECOOP 2001, presents a +detailed discussion of various ways this aspect could be expected to +evolve. + +_The functionality is easy to plug in and out._ Just as with development +aspects, production aspects may need to be removed from the system, +either because the functionality is no longer needed at all, or because +it is not needed in certain configurations of a system. Because the +functionality is modularized in a single aspect this is easy to do. + +_The implementation is more stable._ If, for example, the programmer +adds a subclass of `Line` that overrides the existing methods, this +advice in this aspect will still apply. In the ordinary Java +implementation the programmer would have to remember to add the call to +`setFlag` in the new overriding method. This benefit is often even more +compelling for property-based aspects (see the section +xref:#starting-production-consistentBehavior[Providing Consistent +Behavior]). + +==== Context Passing + +The crosscutting structure of context passing can be a significant +source of complexity in Java programs. Consider implementing +functionality that would allow a client of the figure editor (a program +client rather than a human) to set the color of any figure elements that +are created. Typically this requires passing a color, or a color +factory, from the client, down through the calls that lead to the figure +element factory. All programmers are familiar with the inconvenience of +adding a first argument to a number of methods just to pass this kind of +context information. + +Using AspectJ, this kind of context passing can be implemented in a +modular way. The following code adds after advice that runs only when +the factory methods of `Figure` are called in the control flow of a +method on a `ColorControllingClient`. + +.... +aspect ColorControl { + pointcut CCClientCflow(ColorControllingClient client): + cflow(call(* * (..)) && target(client)); + + pointcut make(): call(FigureElement Figure.make*(..)); + + after (ColorControllingClient c) returning (FigureElement fe): + make() && CCClientCflow(c) { + fe.setColor(c.colorFor(fe)); + } +} +.... + +This aspect affects only a small number of methods, but note that the +non-AOP implementation of this functionality might require editing many +more methods, specifically, all the methods in the control flow from the +client to the factory. This is a benefit common to many property-based +aspects while the aspect is short and affects only a modest number of +benefits, the complexity the aspect saves is potentially much larger. + +[[starting-production-consistentBehavior]] +==== Providing Consistent Behavior + +This example shows how a property-based aspect can be used to provide +consistent handling of functionality across a large set of operations. +This aspect ensures that all public methods of the `com.bigboxco` +package log any Errors they throw to their caller (in Java, an Error is +like an Exception, but it indicates that something really bad and +usually unrecoverable has happened). The `publicMethodCall` pointcut +captures the public method calls of the package, and the after advice +runs whenever one of those calls throws an Error. The advice logs that +Error and then the throw resumes. + +.... +aspect PublicErrorLogging { + Log log = new Log(); + + pointcut publicMethodCall(): + call(public * com.bigboxco.*.*(..)); + + after() throwing (Error e): publicMethodCall() { + log.write(e); + } +} +.... + +In some cases this aspect can log an exception twice. This happens if +code inside the `com.bigboxco` package itself calls a public method of +the package. In that case this code will log the error at both the +outermost call into the `com.bigboxco` package and the re-entrant call. +The `cflow` primitive pointcut can be used in a nice way to exclude +these re-entrant calls: + +.... +after() throwing (Error e): + publicMethodCall() && !cflow(publicMethodCall()) { + log.write(e); +} +.... + +The following aspect is taken from work on the AspectJ compiler. The +aspect advises about 35 methods in the `JavaParser` class. The +individual methods handle each of the different kinds of elements that +must be parsed. They have names like `parseMethodDec`, `parseThrows`, +and `parseExpr`. + +.... +aspect ContextFilling { + pointcut parse(JavaParser jp): + call(* JavaParser.parse*(..)) + && target(jp) + && !call(Stmt parseVarDec(boolean)); // var decs + // are tricky + + around(JavaParser jp) returns ASTObject: parse(jp) { + Token beginToken = jp.peekToken(); + ASTObject ret = proceed(jp); + if (ret != null) jp.addContext(ret, beginToken); + return ret; + } +} +.... + +This example exhibits a property found in many aspects with large +property-based pointcuts. In addition to a general property based +pattern `call(* JavaParser.parse*(..))` it includes an exception to the +pattern `!call(Stmt + parseVarDec(boolean))`. The exclusion of `parseVarDec` happens +because the parsing of variable declarations in Java is too complex to +fit with the clean pattern of the other `parse*` methods. Even with the +explicit exclusion this aspect is a clear expression of a clean +crosscutting modularity. Namely that all `parse*` methods that return +`ASTObjects`, except for `parseVarDec` share a common behavior for +establishing the parse context of their result. + +The process of writing an aspect with a large property-based pointcut, +and of developing the appropriate exceptions can clarify the structure +of the system. This is especially true, as in this case, when +refactoring existing code to use aspects. When we first looked at the +code for this aspect, we were able to use the IDE support provided in +AJDE for JBuilder to see what methods the aspect was advising compared +to our manual coding. We quickly discovered that there were a dozen +places where the aspect advice was in effect but we had not manually +inserted the required functionality. Two of these were bugs in our prior +non-AOP implementation of the parser. The other ten were needless +performance optimizations. So, here, refactoring the code to express the +crosscutting structure of the aspect explicitly made the code more +concise and eliminated latent bugs. + +[[starting-conclusion]] +=== Conclusion + +AspectJ is a simple and practical aspect-oriented extension to Java. +With just a few new constructs, AspectJ provides support for modular +implementation of a range of crosscutting concerns. + +Adoption of AspectJ into an existing Java development project can be a +straightforward and incremental task. One path is to begin by using only +development aspects, going on to using production aspects and then +reusable aspects after building up experience with AspectJ. Adoption can +follow other paths as well. For example, some developers will benefit +from using production aspects right away. Others may be able to write +clean reusable aspects almost right away. + +AspectJ enables both name-based and property based crosscutting. Aspects +that use name-based crosscutting tend to affect a small number of other +classes. But despite their small scale, they can often eliminate +significant complexity compared to an ordinary Java implementation. +Aspects that use property-based crosscutting can have small or large +scale. + +Using AspectJ results in clean well-modularized implementations of +crosscutting concerns. When written as an AspectJ aspect the structure +of a crosscutting concern is explicit and easy to understand. Aspects +are also highly modular, making it possible to develop plug-and-play +implementations of crosscutting functionality. + +AspectJ provides more functionality than was covered by this short +introduction. The next chapter, xref:#language[???], covers in detail +more of the features of the AspectJ language. The following chapter, +xref:#examples[???], then presents some carefully chosen examples that +show you how AspectJ might be used. We recommend that you read the next +two chapters carefully before deciding to adopt AspectJ into a project. diff --git a/docs/progGuideDB/gettingstarted.xml b/docs/progGuideDB/gettingstarted.xml index 7ddbe00dc..d21326c32 100644 --- a/docs/progGuideDB/gettingstarted.xml +++ b/docs/progGuideDB/gettingstarted.xml @@ -231,7 +231,7 @@ call(void Point.setX(int)) picks out each join point that is a call to a method that has the - signature void Point.setX(int) — that is, + signature void Point.setX(int) - that is, Point's void setX method with a single int parameter. @@ -253,8 +253,8 @@ call(void Point.setY(int)) - Pointcuts can identify join points from many different types - — in other words, they can crosscut types. For example, + Pointcuts can identify join points from many different types - + in other words, they can crosscut types. For example, @@ -856,7 +856,7 @@ aspect PointBoundsChecking { includes the setX method, as well as half of the setXY method. In this sense the setX pointcut can be seen as involving very - fine-grained crosscutting — it names the the + fine-grained crosscutting - it names the the setX method and half of the setXY method. diff --git a/docs/progGuideDB/idioms.adoc b/docs/progGuideDB/idioms.adoc new file mode 100644 index 000000000..9bc16c081 --- /dev/null +++ b/docs/progGuideDB/idioms.adoc @@ -0,0 +1,63 @@ +== Idioms + +[[idioms-intro]] +=== Introduction + +This chapter consists of very short snippets of AspectJ code, typically +pointcuts, that are particularly evocative or useful. This section is a +work in progress. + +Here's an example of how to enfore a rule that code in the java.sql +package can only be used from one particular package in your system. +This doesn't require any access to code in the java.sql package. + +.... +/* Any call to methods or constructors in java.sql */ +pointcut restrictedCall(): + call(* java.sql.*.*(..)) || call(java.sql.*.new(..)); + +/* Any code in my system not in the sqlAccess package */ +pointcut illegalSource(): + within(com.foo..*) && !within(com.foo.sqlAccess.*); + +declare error: restrictedCall() && illegalSource(): + "java.sql package can only be accessed from com.foo.sqlAccess"; +.... + +Any call to an instance of a subtype of AbstractFacade whose class is +not exactly equal to AbstractFacade: + +.... +pointcut nonAbstract(AbstractFacade af): + call(* *(..)) + && target(af) + && !if(af.getClass() == AbstractFacade.class); +.... + +If AbstractFacade is an abstract class or an interface, then every +instance must be of a subtype and you can replace this with: + +.... +pointcut nonAbstract(AbstractFacade af): + call(* *(..)) + && target(af); +.... + +Any call to a method which is defined by a subtype of AbstractFacade, +but which isn't defined by the type AbstractFacade itself: + +.... +pointcut callToUndefinedMethod(): + call(* AbstractFacade+.*(..)) + && !call(* AbstractFacade.*(..)); +.... + +The execution of a method that is defined in the source code for a type +that is a subtype of AbstractFacade but not in AbstractFacade itself: + +.... +pointcut executionOfUndefinedMethod(): + execution(* *(..)) + && within(AbstractFacade+) + && !within(AbstractFacade) +.... diff --git a/docs/progGuideDB/implementation.adoc b/docs/progGuideDB/implementation.adoc new file mode 100644 index 000000000..a34324d5f --- /dev/null +++ b/docs/progGuideDB/implementation.adoc @@ -0,0 +1,260 @@ +[[implementation]] +== Implementation Notes + +=== Compiler Notes + +The initial implementations of AspectJ have all been compiler-based +implementations. Certain elements of AspectJ's semantics are difficult +to implement without making modifications to the virtual machine, which +a compiler-based implementation cannot do. One way to deal with this +problem would be to specify only the behavior that is easiest to +implement. We have chosen a somewhat different approach, which is to +specify an ideal language semantics, as well as a clearly defined way in +which implementations are allowed to deviate from that semantics. This +makes it possible to develop conforming AspectJ implementations today, +while still making it clear what later, and presumably better, +implementations should do tomorrow. + +According to the AspectJ language semantics, the declaration + +.... +before(): get(int Point.x) { System.out.println("got x"); } +.... + +should advise all accesses of a field of type int and name x from +instances of type (or subtype of) Point. It should do this regardless of +whether all the source code performing the access was available at the +time the aspect containing this advice was compiled, whether changes +were made later, etc. + +But AspectJ implementations are permitted to deviate from this in a +well-defined way -- they are permitted to advise only accesses in _code +the implementation controls_. Each implementation is free within certain +bounds to provide its own definition of what it means to control code. + +In the current AspectJ compiler, ajc, control of the code means having +bytecode for any aspects and all the code they should affect available +during the compile. This means that if some class Client contains code +with the expression `new + Point().x` (which results in a field get join point at runtime), the +current AspectJ compiler will fail to advise that access unless +Client.java or Client.class is compiled as well. It also means that join +points associated with code in native methods (including their execution +join points) cannot be advised. + +Different join points have different requirements. Method and +constructor call join points can be advised only if ajc controls the +bytecode for the caller. Field reference or assignment join points can +be advised only if ajc controls the bytecode for the "caller", the code +actually making the reference or assignment. Initialization join points +can be advised only if ajc controls the bytecode of the type being +initialized, and execution join points can be advised only if ajc +controls the bytecode for the method or constructor body in question. +The end of an exception handler is underdetermined in bytecode, so ajc +will not implement after or around advice on handler join points. +Similarly, ajc cannot implement around advice on initialization or +preinitialization join points. In cases where ajc cannot implement +advice, it will emit a compile-time error noting this as a compiler +limitation. + +Aspects that are defined `perthis` or `pertarget` also have restrictions +based on control of the code. In particular, at a join point where the +bytecode for the currently executing object is not available, an aspect +defined `perthis` of that join point will not be associated. So aspects +defined `perthis(Object)` will not create aspect instances for every +object unless `Object`is part of the compile. Similar restrictions apply +to `pertarget` aspects. + +Inter-type declarations such as `declare parents` also have restrictions +based on control of the code. If the bytecode for the target of an +inter-type declaration is not available, then the inter-type declaration +is not made on that target. So, `declare parents : String implements + MyInterface` will not work for `java.lang.String` unless +`java.lang.String` is part of the compile. + +When declaring members on interfaces, the implementation must control +both the interface and the top-level implementors of that interface (the +classes that implement the interface but do not have a superclass that +implements the interface). You may weave these separately, but be aware +that you will get runtime exceptions if you run the affected top-level +classes without the interface as produced by the same ajc +implementation. Any intertype declaration of an abstract method on an +interface must be specified as public, you will get a compile time error +message indicating this is a compiler limitation if you do not specify +public. A non-abstract method declared on an interface can use any +access modifier except protected. Note that this is different to normal +Java rules where all members declared in an interface are implicitly +public. Finally, note that one cannot define static fields or methods on +interfaces. + +When declaring methods on target types, only methods declared public are +recognizable in the bytecode, so methods must be declared public to be +overridden in any subtype or to be called from code in a later compile +using the target type as a library. + +Other AspectJ implementations, indeed, future versions of ajc, may +define _code the implementation controls_ more liberally or +restrictively, so long as they comport with the Java language. For +example, the `call` pointcut does not pick out reflective calls to a +method implemented in +`java.lang.reflect.Method.invoke(Object, Object[])`. Some suggest that +the call "happens" and the call pointcut should pick it out, but the +AspectJ language shouldn't anticipate what happens in code outside the +control of the implementation, even when it is a a well-defined API in a +Java standard library. + +The important thing to remember is that core concepts of AspectJ, such +as the join point, are unchanged, regardless of which implementation is +used. During your development, you will have to be aware of the +limitations of the ajc compiler you're using, but these limitations +should not drive the design of your aspects. + +=== Bytecode Notes + +[[the-class-expression-and-string]] +==== The .class expression and String + + +The java language form `Foo.class` is implemented in bytecode with a +call to `Class.forName` guarded by an exception handler catching a +`ClassNotFoundException`. + +The java language + operator, when applied to String arguments, is +implemented in bytecode by calls to `StringBuffer.append`. + +In both of these cases, the current AspectJ compiler operates on the +bytecode implementation of these language features; in short, it +operates on what is really happening rather than what was written in +source code. This means that there may be call join points to +`Class.forName` or `StringBuffer.append` from programs that do not, at +first glance, appear to contain such calls: + +.... +class Test { + void main(String[] args) { + System.out.println(Test.class); // calls Class.forName + System.out.println(args[0] + args[1]); // calls StringBuffer.append + } +} +.... + +In short, the join point model of the current AspectJ compiler considers +these as valid join points. + +==== The Handler join point + +The end of exception handlers cannot reliably be found in Java bytecode. +Instead of removing the handler join point entirely, the current AspectJ +compiler restricts what can be done with the handler join point: + +* After and around advice cannot apply to handler join points. +* The control flow of a handler join point cannot be detected. + +The first of these is relatively straightforward. If any piece of after +advice (returning, throwing, or "finally") would normally apply to a +handler join point, it will not in code output by the current AspectJ +compiler. A compiler warning is generated whenever this is detected to +be the case. Before advice is allowed. + +The second is that the control flow of a handler join point is not +picked out. For example, the following pointcut + +.... +cflow(call(void foo()) || handler(java.io.IOException)) +.... + +will capture all join points in the control flow of a call to +`void foo()`, but it will _not_ capture those in the control flow of an +`IOException` handler. It is equivalent to `cflow(call(void foo()))`. In +general, `cflow(handler(Type))` will not pick out any join points, the +one exception to this is join points that occur during the execution of +any before advice on the handler. + +This does not restrict programs from placing before advice on handlers +inside _other_ control flows. This advice, for example, is perfectly +fine: + +.... +before(): handler(java.io.IOException) && cflow(void parse()) { + System.out.println("about to handle an exception while parsing"); +} +.... + +A source-code implementation of AspectJ (such as AspectJ 1.0.6) is able +to detect the endpoint of a handler join point, and as such will likely +have fewer such restrictions. + +==== Initializers and Inter-type Constructors + +The code for Java initializers, such as the assignment to the field d in + +.... +class C { + double d = Math.sqrt(2); +} +.... + +are considered part of constructors by the time AspectJ gets ahold of +bytecode. That is, the assignment of d to the square root of two happens +_inside_ the default constructor of C. + +Thus inter-type constructors will not necessarily run a target type's +initialization code. In particular, if the inter-type constructor calls +a super-constructor (as opposed to a `this` constructor), the target +type's initialization code will _not_ be run when that inter-type +constructor is called. + +.... +aspect A { + C.new(Object o) {} // implicitly calls super() + + public static void main(String[] args) { + System.out.println((new C() ).d); // prints 1.414... + System.out.println((new C(null)).d); // prints 0.0 +} +.... + +It is the job of an inter-type constructor to do all the required +initialization, or to delegate to a `this` constructor if necessary. + +=== Annotation-style Notes + +Writing aspects in annotation-style is subject to the same bytecode +limitations since the binary aspects take the same form and are woven in +the same way. However, the implementation differences (e.g., the +mechanism for implementing around advice) may be apparent at runtime. +See the documentation on annotation-style for more information. + +=== Summary of implementation requirements + +This summarizes the requirements of our implementation of AspectJ. For +more details, see the relevant sections of this guide. + +* The invoking code must be under the control of ajc for the following +join points: +** call join point +** get join point +** set join point +* The declaring/target code must be under the control of ajc for the +following join points and inter-type declarations: +** execution join point +** adviceexecution join point +** handler join point +** initialization join point +** preinitialiaztion join point +** staticinitialization join point +** perthis aspect +** pertarget aspect +** declare parents +** declare method or field (see interface caveats below) +* Implementation Caveats +** The initialization and preinitialization join points do not support +around advice +** The handler join point does not support... +*** after advice +*** around advice +*** cflow(handler(..)) +** Declaring members on an interface in an aspect affects only the +topmost implementing classes the implementation controls. +** cflow and cflowbelow pointcuts work within a single thread. +** Runtime `ClassCastException` may result from supplying a supertype of +the actual type as an argument to proceed(..) in around advice. diff --git a/docs/progGuideDB/language.adoc b/docs/progGuideDB/language.adoc new file mode 100644 index 000000000..44f17dcb5 --- /dev/null +++ b/docs/progGuideDB/language.adoc @@ -0,0 +1,910 @@ +[[language]] +== The AspectJ Language + +[[language-intro]] +=== Introduction + +The previous chapter, xref:#starting[???], was a brief overview of the +AspectJ language. You should read this chapter to understand AspectJ's +syntax and semantics. It covers the same material as the previous +chapter, but more completely and in much more detail. + +We will start out by looking at an example aspect that we'll build out +of a pointcut, an introduction, and two pieces of advice. This example +aspect will gives us something concrete to talk about. + +[[language-anatomy]] +=== The Anatomy of an Aspect + +This lesson explains the parts of AspectJ's aspects. By reading this +lesson you will have an overview of what's in an aspect and you will be +exposed to the new terminology introduced by AspectJ. + +==== An Example Aspect + +Here's an example of an aspect definition in AspectJ: + +.... + 1 aspect FaultHandler { + 2 + 3 private boolean Server.disabled = false; + 4 + 5 private void reportFault() { + 6 System.out.println("Failure! Please fix it."); + 7 } + 8 + 9 public static void fixServer(Server s) { +10 s.disabled = false; +11 } +12 +13 pointcut services(Server s): target(s) && call(public * *(..)); +14 +15 before(Server s): services(s) { +16 if (s.disabled) throw new DisabledException(); +17 } +18 +19 after(Server s) throwing (FaultException e): services(s) { +20 s.disabled = true; +21 reportFault(); +22 } +23 } +.... + +The `FaultHandler` consists of one inter-type field on `Server` (line +03), two methods (lines 05-07 and 09-11), one pointcut definition (line +13), and two pieces of advice (lines 15-17 and 19-22). + +This covers the basics of what aspects can contain. In general, aspects +consist of an association of other program entities, ordinary variables +and methods, pointcut definitions, inter-type declarations, and advice, +where advice may be before, after or around advice. The remainder of +this lesson focuses on those crosscut-related constructs. + +==== Pointcuts + +AspectJ's pointcut definitions give names to pointcuts. Pointcuts +themselves pick out join points, i.e. interesting points in the +execution of a program. These join points can be method or constructor +invocations and executions, the handling of exceptions, field +assignments and accesses, etc. Take, for example, the pointcut +definition in line 13: + +.... +pointcut services(Server s): target(s) && call(public * *(..)) +.... + +This pointcut, named `services`, picks out those points in the execution +of the program when `Server` objects have their public methods called. +It also allows anyone using the `services` pointcut to access the +`Server` object whose method is being called. + +The idea behind this pointcut in the `FaultHandler` aspect is that +fault-handling-related behavior must be triggered on the calls to public +methods. For example, the server may be unable to proceed with the +request because of some fault. The calls of those methods are, +therefore, interesting events for this aspect, in the sense that certain +fault-related things will happen when these events occur. + +Part of the context in which the events occur is exposed by the formal +parameters of the pointcut. In this case, that consists of objects of +type `Server`. That formal parameter is then being used on the right +hand side of the declaration in order to identify which events the +pointcut refers to. In this case, a pointcut picking out join points +where a Server is the target of some operation (target(s)) is being +composed (`&&`, meaning and) with a pointcut picking out call join +points (call(...)). The calls are identified by signatures that can +include wild cards. In this case, there are wild cards in the return +type position (first *), in the name position (second *) and in the +argument list position (..); the only concrete information is given by +the qualifier `public`. + +Pointcuts pick out arbitrarily large numbers of join points of a +program. But they pick out only a small number of _kinds_ of join +points. Those kinds of join points correspond to some of the most +important concepts in Java. Here is an incomplete list: method call, +method execution, exception handling, instantiation, constructor +execution, and field access. Each kind of join point can be picked out +by its own specialized pointcut that you will learn about in other parts +of this guide. + +==== Advice + +A piece of advice brings together a pointcut and a body of code to +define aspect implementation that runs at join points picked out by the +pointcut. For example, the advice in lines 15-17 specifies that the +following piece of code + +.... +{ + if (s.disabled) throw new DisabledException(); +} +.... + +is executed when instances of the `Server` class have their public +methods called, as specified by the pointcut `services`. More +specifically, it runs when those calls are made, just before the +corresponding methods are executed. + +The advice in lines 19-22 defines another piece of implementation that +is executed on the same pointcut: + +.... +{ + s.disabled = true; + reportFault(); +} +.... + +But this second method executes after those operations throw exception +of type `FaultException`. + +There are two other variations of after advice: upon successful return +and upon return, either successful or with an exception. There is also a +third kind of advice called around. You will see those in other parts of +this guide. + +[[language-joinPoints]] +=== Join Points and Pointcuts + +Consider the following Java class: + +.... +class Point { + private int x, y; + + Point(int x, int y) { this.x = x; this.y = y; } + + void setX(int x) { this.x = x; } + void setY(int y) { this.y = y; } + + int getX() { return x; } + int getY() { return y; } +} +.... + +In order to get an intuitive understanding of AspectJ's join points and +pointcuts, let's go back to some of the basic principles of Java. +Consider the following a method declaration in class Point: + +.... +void setX(int x) { this.x = x; } +.... + +This piece of program says that when method named `setX` with an `int` +argument called on an object of type `Point`, then the method body +`{ this.x = x; }` is executed. Similarly, the constructor of the class +states that when an object of type `Point` is instantiated through a +constructor with two `int` arguments, then the constructor body +`{ this.x = x; this.y = y; }` is executed. + +One pattern that emerges from these descriptions is + +____ +When something happens, then something gets executed. +____ + +In object-oriented programs, there are several kinds of "things that +happen" that are determined by the language. We call these the join +points of Java. Join points consist of things like method calls, method +executions, object instantiations, constructor executions, field +references and handler executions. (See the xref:#quick[???] for a +complete listing.) + +Pointcuts pick out these join points. For example, the pointcut + +.... +pointcut setter(): target(Point) && + (call(void setX(int)) || + call(void setY(int))); +.... + +picks out each call to `setX(int)` or `setY(int)` when called on an +instance of `Point`. Here's another example: + +.... +pointcut ioHandler(): within(MyClass) && handler(IOException); +.... + +This pointcut picks out each the join point when exceptions of type +`IOException` are handled inside the code defined by class `MyClass`. + +Pointcut definitions consist of a left-hand side and a right-hand side, +separated by a colon. The left-hand side consists of the pointcut name +and the pointcut parameters (i.e. the data available when the events +happen). The right-hand side consists of the pointcut itself. + +==== Some Example Pointcuts + +Here are examples of pointcuts picking out + +when a particular method body executes:: + `execution(void Point.setX(int))` +when a method is called:: + `call(void Point.setX(int))` +when an exception handler executes:: + `handler(ArrayOutOfBoundsException)` +when the object currently executing (i.e. `this`) is of type +`SomeType`:: + `this(SomeType)` +when the target object is of type `SomeType`:: + `target(SomeType)` +when the executing code belongs to class `MyClass`:: + `within(MyClass)` +when the join point is in the control flow of a call to a `Test`'s +no-argument `main` method:: + `cflow(call(void Test.main()))` + +Pointcuts compose through the operations `or` ("`||`"), `and` ("`&&`") +and `not` ("`!`"). + +* It is possible to use wildcards. So +[arabic] +. `execution(* *(..))` +. `call(* set(..))` ++ +means (1) the execution of any method regardless of return or parameter +types, and (2) the call to any method named `set` regardless of return +or parameter types -- in case of overloading there may be more than one +such `set` method; this pointcut picks out calls to all of them. +* You can select elements based on types. For example, +[arabic] +. `execution(int *())` +. `call(* setY(long))` +. `call(* Point.setY(int))` +. `call(*.new(int, int))` ++ +means (1) the execution of any method with no parameters that returns an +`int`, (2) the call to any `setY` method that takes a `long` as an +argument, regardless of return type or declaring type, (3) the call to +any of `Point`'s `setY` methods that take an `int` as an argument, +regardless of return type, and (4) the call to any classes' constructor, +so long as it takes exactly two `int`s as arguments. +* You can compose pointcuts. For example, +[arabic] +. `target(Point) && call(int *())` +. `call(* *(..)) && (within(Line) || within(Point))` +. `within(*) && execution(*.new(int))` +. ` + !this(Point) && call(int *(..)) + ` ++ +means (1) any call to an `int` method with no arguments on an instance +of `Point`, regardless of its name, (2) any call to any method where the +call is made from the code in `Point`'s or `Line`'s type declaration, +(3) the execution of any constructor taking exactly one `int` argument, +regardless of where the call is made from, and (4) any method call to an +`int` method when the executing object is any type except `Point`. +* You can select methods and constructors based on their modifiers and +on negations of modifiers. For example, you can say: +[arabic] +. `call(public * *(..))` +. `execution(!static * *(..))` +. ` execution(public !static * *(..))` ++ +which means (1) any call to a public method, (2) any execution of a +non-static method, and (3) any execution of a public, non-static method. +* Pointcuts can also deal with interfaces. For example, given the +interface ++ +.... +interface MyInterface { ... } +.... ++ +the pointcut `call(* MyInterface.*(..))` picks out any call to a method +in `MyInterface`'s signature -- that is, any method defined by +`MyInterface` or inherited by one of its a supertypes. + +[[call-vs-execution]] +==== call vs. execution + +When methods and constructors run, there are two interesting times +associated with them. That is when they are called, and when they +actually execute. + +AspectJ exposes these times as call and execution join points, +respectively, and allows them to be picked out specifically by `call` +and `execution` pointcuts. + +So what's the difference between these join points? Well, there are a +number of differences: + +Firstly, the lexical pointcut declarations `within` and `withincode` +match differently. At a call join point, the enclosing code is that of +the call site. This means that `call(void m()) + && withincode(void m())` will only capture directly recursive +calls, for example. At an execution join point, however, the program is +already executing the method, so the enclosing code is the method +itself: `execution(void m()) + && withincode(void m())` is the same as `execution(void m())`. + +Secondly, the call join point does not capture super calls to non-static +methods. This is because such super calls are different in Java, since +they don't behave via dynamic dispatch like other calls to non-static +methods. + +The rule of thumb is that if you want to pick a join point that runs +when an actual piece of code runs (as is often the case for tracing), +use `execution`, but if you want to pick one that runs when a particular +_signature_ is called (as is often the case for production aspects), use +`call`. + +==== Pointcut composition + +Pointcuts are put together with the operators and (spelled `&&`), or +(spelled `||`), and not (spelled `!`). This allows the creation of very +powerful pointcuts from the simple building blocks of primitive +pointcuts. This composition can be somewhat confusing when used with +primitive pointcuts like `cflow` and `cflowbelow`. Here's an example: + +`cflow(P)` picks out each join point in the control flow of the join +points picked out by

. So, pictorially: + +.... +P --------------------- + \ + \ cflow of P + \ +.... + +What does `cflow(P) && + cflow(Q)` pick out? Well, it picks out each join point that is +in both the control flow of

and in the control flow of . So... + +.... + P --------------------- + \ + \ cflow of P + \ + \ + \ +Q -------------\------- + \ \ + \ cflow of Q \ cflow(P) && cflow(Q) + \ \ +.... + +Note that

and might not have any join points in common... but +their control flows might have join points in common. + +But what does `cflow(P + && Q)` mean? Well, it means the control flow of those join +points that are both picked out by

and picked out by . + +.... +P && Q ------------------- + \ + \ cflow of (P && Q) + \ +.... + +and if there are _no_ join points that are both picked by

and picked +out by , then there's no chance that there are any join points in the +control flow of `(P && + Q)`. + +Here's some code that expresses this. + +.... +public class Test { + public static void main(String[] args) { + foo(); + } + static void foo() { + goo(); + } + static void goo() { + System.out.println("hi"); + } +} + +aspect A { + pointcut fooPC(): execution(void Test.foo()); + pointcut gooPC(): execution(void Test.goo()); + pointcut printPC(): call(void java.io.PrintStream.println(String)); + + before(): cflow(fooPC()) && cflow(gooPC()) && printPC() && !within(A) { + System.out.println("should occur"); + } + + before(): cflow(fooPC() && gooPC()) && printPC() && !within(A) { + System.out.println("should not occur"); + } +} +.... + +The `!within(A)` pointcut above is required to avoid the `printPC` +pointcut applying to the `System.out.println` call in the advice body. +If this was not present a recursive call would result as the pointcut +would apply to its own advice. (See xref:#pitfalls-infiniteLoops[???] +for more details.) + +==== Pointcut Parameters + +Consider again the first pointcut definition in this chapter: + +.... +pointcut setter(): target(Point) && + (call(void setX(int)) || + call(void setY(int))); +.... + +As we've seen, this pointcut picks out each call to `setX(int)` or +`setY(int)` methods where the target is an instance of `Point`. The +pointcut is given the name `setters` and no parameters on the left-hand +side. An empty parameter list means that none of the context from the +join points is published from this pointcut. But consider another +version of version of this pointcut definition: + +.... +pointcut setter(Point p): target(p) && + (call(void setX(int)) || + call(void setY(int))); +.... + +This version picks out exactly the same join points. But in this +version, the pointcut has one parameter of type `Point`. This means that +any advice that uses this pointcut has access to a `Point` from each +join point picked out by the pointcut. Inside the pointcut definition +this `Point` is named `p` is available, and according to the right-hand +side of the definition, that `Point p` comes from the `target` of each +matched join point. + +Here's another example that illustrates the flexible mechanism for +defining pointcut parameters: + +.... +pointcut testEquality(Point p): target(Point) && + args(p) && + call(boolean equals(Object)); +.... + +This pointcut also has a parameter of type `Point`. Similar to the +`setters` pointcut, this means that anyone using this pointcut has +access to a `Point` from each join point. But in this case, looking at +the right-hand side we find that the object named in the parameters is +not the target `Point` object that receives the call; it's the argument +(also of type `Point`) passed to the `equals` method when some other +`Point` is the target. If we wanted access to both `Point`s, then the +pointcut definition that would expose target `Point p1` and argument +`Point p2` would be + +.... +pointcut testEquality(Point p1, Point p2): target(p1) && + args(p2) && + call(boolean equals(Object)); +.... + +Let's look at another variation of the `setters` pointcut: + +.... +pointcut setter(Point p, int newval): target(p) && + args(newval) && + (call(void setX(int)) || + call(void setY(int))); +.... + +In this case, a `Point` object and an `int` value are exposed by the +named pointcut. Looking at the the right-hand side of the definition, we +find that the `Point` object is the target object, and the `int` value +is the called method's argument. + +The use of pointcut parameters is relatively flexible. The most +important rule is that all the pointcut parameters must be bound at +every join point picked out by the pointcut. So, for example, the +following pointcut definition will result in a compilation error: + +.... +pointcut badPointcut(Point p1, Point p2): + (target(p1) && call(void setX(int))) || + (target(p2) && call(void setY(int))); +.... + +because `p1` is only bound when calling `setX`, and `p2` is only bound +when calling `setY`, but the pointcut picks out all of these join points +and tries to bind both `p1` and `p2`. + +[[example]] +==== Example: `HandleLiveness` + +The example below consists of two object classes (plus an exception +class) and one aspect. Handle objects delegate their public, non-static +operations to their `Partner` objects. The aspect `HandleLiveness` +ensures that, before the delegations, the partner exists and is alive, +or else it throws an exception. + +.... +class Handle { + Partner partner = new Partner(); + + public void foo() { partner.foo(); } + public void bar(int x) { partner.bar(x); } + + public static void main(String[] args) { + Handle h1 = new Handle(); + h1.foo(); + h1.bar(2); + } +} + +class Partner { + boolean isAlive() { return true; } + void foo() { System.out.println("foo"); } + void bar(int x) { System.out.println("bar " + x); } +} + +aspect HandleLiveness { + before(Handle handle): target(handle) && call(public * *(..)) { + if ( handle.partner == null || !handle.partner.isAlive() ) { + throw new DeadPartnerException(); + } + } +} + +class DeadPartnerException extends RuntimeException {} +.... + +[[pointcut-best-practice]] +==== Writing good pointcuts + +During compilation, AspectJ processes pointcuts in order to try and +optimize matching performance. Examining code and determining if each +join point matches (statically or dynamically) a given pointcut is a +costly process. (A dynamic match means the match cannot be fully +determined from static analysis and a test will be placed in the code to +determine if there is an actual match when the code is running). On +first encountering a pointcut declaration, AspectJ will rewrite it into +an optimal form for the matching process. What does this mean? Basically +pointcuts are rewritten in DNF (Disjunctive Normal Form) and the +components of the pointcut are sorted such that those components that +are cheaper to evaluate are checked first. This means users do not have +to worry about understanding the performance of various pointcut +designators and may supply them in any order in their pointcut +declarations. + +However, AspectJ can only work with what it is told, and for optimal +performance of matching the user should think about what they are trying +to achieve and narrow the search space for matches as much as they can +in the definition. Basically there are three kinds of pointcut +designator: kinded, scoping and context: + +* Kinded designators are those which select a particular kind of join +point. For example: execution, get, set, call, handler +* Scoping designators are those which select a group of join points of +interest (of probably many kinds). For example: within, withincode +* Contextual designators are those that match (and optionally bind) +based on context. For example: this, target, @annotation + +A well written pointcut should try and include at least the first two +types (kinded and scoping), whilst the contextual designators may be +included if wishing to match based on join point context, or bind that +context for use in the advice. Supplying either just a kinded designator +or just a contextual designator will work but could affect weaving +performance (time and memory used) due to all the extra processing and +analysis. Scoping designators are very fast to match, they can very +quickly dismiss groups of join points that should not be further +processed - that is why a good pointcut should always include one if +possible. + +[[language-advice]] +=== Advice + +Advice defines pieces of aspect implementation that execute at +well-defined points in the execution of the program. Those points can be +given either by named pointcuts (like the ones you've seen above) or by +anonymous pointcuts. Here is an example of an advice on a named +pointcut: + +.... +pointcut setter(Point p1, int newval): target(p1) && args(newval) + (call(void setX(int) || + call(void setY(int))); + +before(Point p1, int newval): setter(p1, newval) { + System.out.println("About to set something in " + p1 + + " to the new value " + newval); +} +.... + +And here is exactly the same example, but using an anonymous pointcut: + +.... +before(Point p1, int newval): target(p1) && args(newval) + (call(void setX(int)) || + call(void setY(int))) { + System.out.println("About to set something in " + p1 + + " to the new value " + newval); +} +.... + +Here are examples of the different advice: + +This before advice runs just before the join points picked out by the +(anonymous) pointcut: + +.... +before(Point p, int x): target(p) && args(x) && call(void setX(int)) { + if (!p.assertX(x)) return; +} +.... + +This after advice runs just after each join point picked out by the +(anonymous) pointcut, regardless of whether it returns normally or +throws an exception: + +.... +after(Point p, int x): target(p) && args(x) && call(void setX(int)) { + if (!p.assertX(x)) throw new PostConditionViolation(); +} +.... + +This after returning advice runs just after each join point picked out +by the (anonymous) pointcut, but only if it returns normally. The return +value can be accessed, and is named `x` here. After the advice runs, the +return value is returned: + +.... +after(Point p) returning(int x): target(p) && call(int getX()) { + System.out.println("Returning int value " + x + " for p = " + p); +} +.... + +This after throwing advice runs just after each join point picked out by +the (anonymous) pointcut, but only when it throws an exception of type +`Exception`. Here the exception value can be accessed with the name `e`. +The advice re-raises the exception after it's done: + +.... +after() throwing(Exception e): target(Point) && call(void setX(int)) { + System.out.println(e); +} +.... + +This around advice traps the execution of the join point; it runs +_instead_ of the join point. The original action associated with the +join point can be invoked through the special `proceed` call: + +.... +void around(Point p, int x): target(p) + && args(x) + && call(void setX(int)) { + if (p.assertX(x)) proceed(p, x); + p.releaseResources(); +} +.... + +[[language-interType]] +=== Inter-type declarations + +Aspects can declare members (fields, methods, and constructors) that are +owned by other types. These are called inter-type members. Aspects can +also declare that other types implement new interfaces or extend a new +class. Here are examples of some such inter-type declarations: + +This declares that each `Server` has a `boolean` field named `disabled`, +initialized to `false`: + +.... +private boolean Server.disabled = false; +.... + +It is declared `private`, which means that it is private _to the +aspect_: only code in the aspect can see the field. And even if `Server` +has another private field named `disabled` (declared in `Server` or in +another aspect) there won't be a name collision, since no reference to +`disabled` will be ambiguous. + +This declares that each `Point` has an `int` method named `getX` with no +arguments that returns whatever `this.x` is: + +.... +public int Point.getX() { return this.x; } +.... + +Inside the body, `this` is the `Point` object currently executing. +Because the method is publically declared any code can call it, but if +there is some other `Point.getX()` declared there will be a compile-time +conflict. + +This publically declares a two-argument constructor for `Point`: + +.... +public Point.new(int x, int y) { this.x = x; this.y = y; } +.... + +This publicly declares that each `Point` has an `int` field named `x`, +initialized to zero: + +.... +public int Point.x = 0; +.... + +Because this is publically declared, it is an error if `Point` already +has a field named `x` (defined by `Point` or by another aspect). + +This declares that the `Point` class implements the `Comparable` +interface: + +.... +declare parents: Point implements Comparable; +.... + +Of course, this will be an error unless `Point` defines the methods +required by `Comparable`. + +This declares that the `Point` class extends the `GeometricObject` +class. + +.... +declare parents: Point extends GeometricObject; +.... + +An aspect can have several inter-type declarations. For example, the +following declarations + +.... +public String Point.name; +public void Point.setName(String name) { this.name = name; } +.... + +publicly declare that Point has both a String field `name` and a `void` +method `setName(String)` (which refers to the `name` field declared by +the aspect). + +An inter-type member can only have one target type, but often you may +wish to declare the same member on more than one type. This can be done +by using an inter-type member in combination with a private interface: + +.... +aspect A { + private interface HasName {} + declare parents: (Point || Line || Square) implements HasName; + + private String HasName.name; + public String HasName.getName() { return name; } +} +.... + +This declares a marker interface `HasName`, and also declares that any +type that is either `Point`, `Line`, or `Square` implements that +interface. It also privately declares that all `HasName` object have a +`String` field called `name`, and publically declares that all `HasName` +objects have a `String` method `getName()` (which refers to the +privately declared `name` field). + +As you can see from the above example, an aspect can declare that +interfaces have fields and methods, even non-constant fields and methods +with bodies. + +==== Inter-type Scope + +AspectJ allows private and package-protected (default) inter-type +declarations in addition to public inter-type declarations. Private +means private in relation to the aspect, not necessarily the target +type. So, if an aspect makes a private inter-type declaration of a field + +.... +private int Foo.x; +.... + +Then code in the aspect can refer to `Foo`'s `x` field, but nobody else +can. Similarly, if an aspect makes a package-protected introduction, + +.... + int Foo.x; +.... + +then everything in the aspect's package (which may or may not be `Foo`'s +package) can access `x`. + +==== Example: `PointAssertions` + +The example below consists of one class and one aspect. The aspect +privately declares the assertion methods of `Point`, `assertX` and +`assertY`. It also guards calls to `setX` and `setY` with calls to these +assertion methods. The assertion methods are declared privately because +other parts of the program (including the code in `Point`) have no +business accessing the assert methods. Only the code inside of the +aspect can call those methods. + +.... +class Point { + int x, y; + + public void setX(int x) { this.x = x; } + public void setY(int y) { this.y = y; } + + public static void main(String[] args) { + Point p = new Point(); + p.setX(3); p.setY(333); + } +} + +aspect PointAssertions { + + private boolean Point.assertX(int x) { + return (x <= 100 && x >= 0); + } + private boolean Point.assertY(int y) { + return (y <= 100 && y >= 0); + } + + before(Point p, int x): target(p) && args(x) && call(void setX(int)) { + if (!p.assertX(x)) { + System.out.println("Illegal value for x"); return; + } + } + before(Point p, int y): target(p) && args(y) && call(void setY(int)) { + if (!p.assertY(y)) { + System.out.println("Illegal value for y"); return; + } + } +} +.... + +[[language-thisJoinPoint]] +=== thisJoinPoint + +AspectJ provides a special reference variable, `thisJoinPoint`, that +contains reflective information about the current join point for the +advice to use. The `thisJoinPoint` variable can only be used in the +context of advice, just like `this` can only be used in the context of +non-static methods and variable initializers. In advice, `thisJoinPoint` +is an object of type +xref:../api/org/aspectj/lang/JoinPoint.html[`org.aspectj.lang.JoinPoint`]. + +One way to use it is simply to print it out. Like all Java objects, +`thisJoinPoint` has a `toString()` method that makes quick-and-dirty +tracing easy: + +.... +aspect TraceNonStaticMethods { + before(Point p): target(p) && call(* *(..)) { + System.out.println("Entering " + thisJoinPoint + " in " + p); + } +} +.... + +The type of `thisJoinPoint` includes a rich reflective class hierarchy +of signatures, and can be used to access both static and dynamic +information about join points such as the arguments of the join point: + +.... +thisJoinPoint.getArgs() +.... + +In addition, it holds an object consisting of all the static information +about the join point such as corresponding line number and static +signature: + +.... +thisJoinPoint.getStaticPart() +.... + +If you only need the static information about the join point, you may +access the static part of the join point directly with the special +variable `thisJoinPointStaticPart`. Using `thisJoinPointStaticPart` will +avoid the run-time creation of the join point object that may be +necessary when using `thisJoinPoint` directly. + +It is always the case that + +.... +thisJoinPointStaticPart == thisJoinPoint.getStaticPart() + +thisJoinPoint.getKind() == thisJoinPointStaticPart.getKind() +thisJoinPoint.getSignature() == thisJoinPointStaticPart.getSignature() +thisJoinPoint.getSourceLocation() == thisJoinPointStaticPart.getSourceLocation() +.... + +One more reflective variable is available: +`thisEnclosingJoinPointStaticPart`. This, like +`thisJoinPointStaticPart`, only holds the static part of a join point, +but it is not the current but the enclosing join point. So, for example, +it is possible to print out the calling source location (if available) +with + +.... + before() : execution (* *(..)) { + System.err.println(thisEnclosingJoinPointStaticPart.getSourceLocation()) + } +.... diff --git a/docs/progGuideDB/pitfalls.adoc b/docs/progGuideDB/pitfalls.adoc new file mode 100644 index 000000000..b1769ce26 --- /dev/null +++ b/docs/progGuideDB/pitfalls.adoc @@ -0,0 +1,86 @@ +== Pitfalls + +[[pitfalls-intro]] +=== Introduction + +This chapter consists of a few AspectJ programs that may lead to +surprising behavior and how to understand them. + +[[pitfalls-infiniteLoops]] +=== Infinite loops + +Here is a Java program with peculiar behavior + +.... +public class Main { + public static void main(String[] args) { + foo(); + System.out.println("done with call to foo"); + } + + static void foo() { + try { + foo(); + } finally { + foo(); + } + } +} +.... + +This program will never reach the println call, but when it aborts may +have no stack trace. + +This silence is caused by multiple StackOverflowExceptions. First the +infinite loop in the body of the method generates one, which the finally +clause tries to handle. But this finally clause also generates an +infinite loop which the current JVMs can't handle gracefully leading to +the completely silent abort. + +The following short aspect will also generate this behavior: + +.... +aspect A { + before(): call(* *(..)) { System.out.println("before"); } + after(): call(* *(..)) { System.out.println("after"); } +} +.... + +Why? Because the call to println is also a call matched by the pointcut +`call (* *(..))`. We get no output because we used simple after() +advice. If the aspect were changed to + +.... +aspect A { + before(): call(* *(..)) { System.out.println("before"); } + after() returning: call(* *(..)) { System.out.println("after"); } +} +.... + +Then at least a StackOverflowException with a stack trace would be seen. +In both cases, though, the overall problem is advice applying within its +own body. + +There's a simple idiom to use if you ever have a worry that your advice +might apply in this way. Just restrict the advice from occurring in join +points caused within the aspect. So: + +.... +aspect A { + before(): call(* *(..)) && !within(A) { System.out.println("before"); } + after() returning: call(* *(..)) && !within(A) { System.out.println("after"); } +} +.... + +Other solutions might be to more closely restrict the pointcut in other +ways, for example: + +.... +aspect A { + before(): call(* MyObject.*(..)) { System.out.println("before"); } + after() returning: call(* MyObject.*(..)) { System.out.println("after"); } +} +.... + +The moral of the story is that unrestricted generic pointcuts can pick +out more join points than intended. diff --git a/docs/progGuideDB/preface.adoc b/docs/progGuideDB/preface.adoc new file mode 100644 index 000000000..efeb18637 --- /dev/null +++ b/docs/progGuideDB/preface.adoc @@ -0,0 +1,35 @@ +== Preface + +This programming guide does three things. It + +* introduces the AspectJ language +* defines each of AspectJ's constructs and their semantics, and +* provides examples of their use. + +It includes appendices that give a reference to the syntax of AspectJ, a +more formal description of AspectJ's semantics, and a description of +notes about the AspectJ implementation. + +The first section, xref:gettingstarted.adoc[Getting Started with AspectJ], provides a gentle overview of +writing AspectJ programs. It also shows how one can introduce AspectJ +into an existing development effort in stages, reducing the associated +risk. You should read this section if this is your first exposure to +AspectJ and you want to get a sense of what AspectJ is all about. + +The second section, xref:language.adoc[The AspectJ Language], covers the features of the +language in more detail, using code snippets as examples. All the basics +of the language is covered, and after reading this section, you should +be able to use the language correctly. + +The next section, xref:examples.adoc[Examples], comprises a set of complete +programs that not only show the features being used, but also try to +illustrate recommended practice. You should read this section after you +are familiar with the elements of AspectJ. + +Finally, there are two short chapters, one on xref:idioms.adoc[Idioms] and one +on xref:pitfalls.adoc[Pitfalls]. + +The back matter contains several appendices that cover an +xref:quickreference.adoc[AspectJ Quick Reference], a more in depth coverage of +its xref:semantics.adoc[Language Semantics], and a description of the latitude enjoyed by +its xref:implementation.adoc[Implementation Notes]. diff --git a/docs/progGuideDB/progguide.adoc b/docs/progGuideDB/progguide.adoc new file mode 100644 index 000000000..2ca7c8a89 --- /dev/null +++ b/docs/progGuideDB/progguide.adoc @@ -0,0 +1,37 @@ += The AspectJ^TM^ Programming Guide + +:doctype: book + +_by the AspectJ Team_ + +_Copyright (c) 1998-2001 Xerox Corporation, 2002 Palo Alto Research Center, Incorporated, 2003-2005 Contributors. +All rights reserved._ + +This programming guide describes the AspectJ language. A companion guide describes the tools which are part of the +AspectJ development environment. + +* If you are completely new to AspectJ, please read the link:gettingstarted.adoc[getting started] chapter for a broad overview of AspectJ programming. +* If you are already familiar with AspectJ, but want a deeper understanding, you can learn more about the link:language.adoc[AspectJ language] and look at the examples in the chapter. +* If you want a more formal definition of AspectJ, please refer to the link:semantics.adoc[language semantics] section. + +//// +ATTENTION: Please do not remove blank lines in between 'include::' statements. Otherwise, section numbers in the +table of contents (TOC) can be wrong and the first section of each document missing completely. +//// +include::preface.adoc[] + +include::gettingstarted.adoc[] + +include::language.adoc[] + +include::examples.adoc[] + +include::idioms.adoc[] + +include::pitfalls.adoc[] + +include::quickreference.adoc[] + +include::semantics.adoc[] + +include::implementation.adoc[] diff --git a/docs/progGuideDB/progguide.html.xsl.adoc b/docs/progGuideDB/progguide.html.xsl.adoc new file mode 100644 index 000000000..8b1378917 --- /dev/null +++ b/docs/progGuideDB/progguide.html.xsl.adoc @@ -0,0 +1 @@ + diff --git a/docs/progGuideDB/quickreference.adoc b/docs/progGuideDB/quickreference.adoc new file mode 100644 index 000000000..01b152e31 --- /dev/null +++ b/docs/progGuideDB/quickreference.adoc @@ -0,0 +1,372 @@ +[[quick]] +== AspectJ Quick Reference + +[[quick-pointcuts]] +=== Pointcuts + +[cols=",",] +|=== +|*Methods and Constructors* | + +|`call(Signature)` |every call to any method or constructor matching + at the call site + +|`execution(Signature)` |every execution of any method or constructor +matching + +|*Fields* | + +|`get(Signature)` |every reference to any field matching + +|`set(Signature)` |every assignment to any field matching . +The assigned value can be exposed with an `args` pointcut + +|*Exception Handlers* | + +|`handler(TypePattern)` |every exception handler for any `Throwable` +type in . The exception value can be exposed with an `args` +pointcut + +|*Advice* | + +|`adviceexecution()` |every execution of any piece of advice + +|*Initialization* | + +|`staticinitialization(TypePattern)` |every execution of a static +initializer for any type in + +|`initialization(Signature)` |every initialization of an object when the +first constructor called in the type matches , encompassing +the return from the super constructor call to the return of the +first-called constructor + +|`preinitialization(Signature)` |every pre-initialization of an object +when the first constructor called in the type matches , +encompassing the entry of the first-called constructor to the call to +the super constructor + +|*Lexical* | + +|`within(TypePattern)` |every join point from code defined in a type in + + +|`withincode(Signature)` |every join point from code defined in a method +or constructor matching +|=== + +[[quick-typePatterns]] +=== Type Patterns + +A type pattern is one of + +[cols=",",] +|=== +| |all types in + +| |all types in , a pattern with a +. + +| |all types in , a pattern with one +or more []s. + +|`!TypePattern` |all types not in + +|`TypePattern0 + && TypePattern1` |all types in both and + + +|`TypePattern0 || TypePattern1` |all types in either or + + +|`( TypePattern )` |all types in +|=== + +where can either be a plain type name, the wildcard +`*` (indicating all types), or an identifier with embedded `*` and `..` +wildcards. + +An embedded `*` in an identifier matches any sequence of characters, but +does not match the package (or inner-type) separator ".". + +An embedded `..` in an identifier matches any sequence of characters +that starts and ends with the package (or inner-type) separator ".". + +[[quick-advice]] +=== Advice + +Each piece of advice is of the form + +____ +[ strictfp ] + +AdviceSpec + +[ throws + +TypeList + +] : + +Pointcut + +\{ + +Body + +} +____ + +where is one of + +`before( Formals ) `:: + runs before each join point +`after( Formals ) returning + [ ( Formal ) ] `:: + runs after each join point that returns normally. The optional formal + gives access to the returned value +`after( Formals ) throwing [ + ( Formal ) ] `:: + runs after each join point that throws a + + + Throwable + + + . If the optional formal is present, runs only after each join point + that throws a + + + Throwable + + + of the type of + + + Formal + + + , and + + + Formal + + + gives access to the + + + Throwable + + + exception value +`after( Formals ) `:: + runs after each join point regardless of whether it returns normally + or throws a + + + Throwable +`Type + around( Formals ) `:: + runs in place of each join point. The join point can be executed by + calling + + + proceed + + + , which takes the same number and types of arguments as the around + advice. + +Three special variables are available inside of advice bodies: + +`thisJoinPoint`:: + an object of type + + + org.aspectj.lang.JoinPoint + + + representing the join point at which the advice is executing. +`thisJoinPointStaticPart`:: + equivalent to + + + thisJoinPoint.getStaticPart() + + + , but may use fewer runtime resources. +`thisEnclosingJoinPointStaticPart`:: + the static part of the dynamically enclosing join point. + +[[quick-interType]] +=== Inter-type member declarations + +Each inter-type member is one of + +` + Modifiers ReturnType OnType . Id + ( Formals ) + [ throws TypeList ] + { Body } + `:: + a method on + + + OnType + + + . +` + abstract Modifiers ReturnType OnType . Id + ( Formals ) + [ throws TypeList ] ; + `:: + an abstract method on + + + OnType + + + . +` + Modifiers OnType . new + ( Formals ) + [ throws TypeList ] + { Body } + `:: + a constructor on + + + OnType + + + . +` + Modifiers Type OnType . Id + [ = Expression ] ; + `:: + a field on + + + OnType + + + . + +[[quick-other]] +=== Other declarations + +` + declare parents : + TypePattern extends + Type ; + `:: + the types in + + + TypePattern + + + extend + + + Type + + + . +` + declare parents : TypePattern + implements TypeList ; + `:: + the types in + + + TypePattern + + + implement the types in + + + TypeList + + + . +` + declare warning : Pointcut : + String ; + `:: + if any of the join points in + + + Pointcut + + + possibly exist in the program, the compiler emits the warning + + + String + + + . +` + declare error : Pointcut : + String ; + `:: + if any of the join points in + + + Pointcut + + + could possibly exist in the program, the compiler emits the error + + + String + + + . +` + declare soft : + Type : + Pointcut ; + `:: + any + + + Type + + + exception that gets thrown at any join point picked out by + + + Pointcut + + + is wrapped in + + + org.aspectj.lang.SoftException + + + . +` + declare precedence : + TypePatternList ; + `:: + at any join point where multiple pieces of advice apply, the advice + precedence at that join point is in + + + TypePatternList + + + order. + +[[quick-aspectAssociations]] +=== Aspects + +Each aspect is of the form + +____ +[ privileged ] + +Modifiers + +aspect + +Id + +[ extends + +Type + +] [ implements + +TypeList + +] [ + +PerClause + +] \{ + +Body + +} +____ + +where defines how the aspect is instantiated and associated +(`issingleton()` by default): + +[cols=",,",options="header",] +|=== +|PerClause |Description |Accessor +|[ `issingleton()` ] |One instance of the aspect is made. This is the +default. |`aspectOf()` at all join points + +|`perthis(Pointcut)` |An instance is associated with each object that is +the currently executing object at any join point in . +|`aspectOf(Object)` at all join points + +|`pertarget(Pointcut)` |An instance is associated with each object that +is the target object at any join point in . +|`aspectOf(Object)` at all join points + +|`percflow(Pointcut)` |The aspect is defined for each entrance to the +control flow of the join points defined by . |`aspectOf()` at +join points in `cflow(Pointcut)` + +|`percflowbelow(Pointcut)` |The aspect is defined for each entrance to +the control flow below the join points defined by . +|`aspectOf()` at join points in `cflowbelow(Pointcut)` +|=== diff --git a/docs/progGuideDB/semantics.adoc b/docs/progGuideDB/semantics.adoc new file mode 100644 index 000000000..5a3e7fb00 --- /dev/null +++ b/docs/progGuideDB/semantics.adoc @@ -0,0 +1,2618 @@ +[[semantics]] +== Language Semantics + +[[semantics-intro]] +=== Introduction + +AspectJ extends Java by overlaying a concept of join points onto the +existing Java semantics and adding a few new program elements to Java: + +A join point is a well-defined point in the execution of a program. +These include method and constructor calls, field accesses and others +described below. + +A pointcut picks out join points, and exposes some of the values in the +execution context of those join points. There are several primitive +pointcut designators, and others can be named and defined by the +`pointcut` declaration. + +A piece of advice is code that executes at each join point in a +pointcut. Advice has access to the values exposed by the pointcut. +Advice is defined by `before`, `after`, and `around` declarations. + +Inter-type declarations form AspectJ's static crosscutting features, +that is, is code that may change the type structure of a program, by +adding to or extending interfaces and classes with new fields, +constructors, or methods. Some inter-type declarations are defined +through an extension of usual method, field, and constructor +declarations, and other declarations are made with a new `declare` +keyword. + +An aspect is a crosscutting type that encapsulates pointcuts, advice, +and static crosscutting features. By type, we mean Java's notion: a +modular unit of code, with a well-defined interface, about which it is +possible to do reasoning at compile time. Aspects are defined by the +`aspect` declaration. + +[[semantics-joinPoints]] +=== Join Points + +While aspects define types that crosscut, the AspectJ system does not +allow completely arbitrary crosscutting. Rather, aspects define types +that cut across principled points in a program's execution. These +principled points are called join points. + +A join point is a well-defined point in the execution of a program. The +join points defined by AspectJ are: + +Method call:: + When a method is called, not including super calls of non-static + methods. +Method execution:: + When the body of code for an actual method executes. +Constructor call:: + When an object is built and that object's initial constructor is + called (i.e., not for "super" or "this" constructor calls). The object + being constructed is returned at a constructor call join point, so its + return type is considered to be the type of the object, and the object + itself may be accessed with + + + after returning + + + advice. +Constructor execution:: + When the body of code for an actual constructor executes, after its + this or super constructor call. The object being constructed is the + currently executing object, and so may be accessed with the + + + this + + + pointcut. The constructor execution join point for a constructor that + calls a super constructor also includes any non-static initializers of + enclosing class. No value is returned from a constructor execution + join point, so its return type is considered to be void. +Static initializer execution:: + When the static initializer for a class executes. No value is returned + from a static initializer execution join point, so its return type is + considered to be void. +Object pre-initialization:: + Before the object initialization code for a particular class runs. + This encompasses the time between the start of its first called + constructor and the start of its parent's constructor. Thus, the + execution of these join points encompass the join points of the + evaluation of the arguments of + + + this() + + + and + + + super() + + + constructor calls. No value is returned from an object + pre-initialization join point, so its return type is considered to be + void. +Object initialization:: + When the object initialization code for a particular class runs. This + encompasses the time between the return of its parent's constructor + and the return of its first called constructor. It includes all the + dynamic initializers and constructors used to create the object. The + object being constructed is the currently executing object, and so may + be accessed with the + + + this + + + pointcut. No value is returned from a constructor execution join + point, so its return type is considered to be void. +Field reference:: + When a non-constant field is referenced. [Note that references to + constant fields (static final fields bound to a constant string object + or primitive value) are not join points, since Java requires them to + be inlined.] +Field set:: + When a field is assigned to. Field set join points are considered to + have one argument, the value the field is being set to. No value is + returned from a field set join point, so its return type is considered + to be void. [Note that the initializations of constant fields (static + final fields where the initializer is a constant string object or + primitive value) are not join points, since Java requires their + references to be inlined.] +Handler execution:: + When an exception handler executes. Handler execution join points are + considered to have one argument, the exception being handled. No value + is returned from a field set join point, so its return type is + considered to be void. +Advice execution:: + When the body of code for a piece of advice executes. + +Each join point potentially has three pieces of state associated with +it: the currently executing object, the target object, and an object +array of arguments. These are exposed by the three state-exposing +pointcuts, `this`, `target`, and `args`, respectively. + +Informally, the currently executing object is the object that a `this` +expression would pick out at the join point. The target object is where +control or attention is transferred to by the join point. The arguments +are those values passed for that transfer of control or attention. + +[cols=",,,",options="header",] +|=== +|*Join Point* |*Current Object* |*Target Object* |*Arguments* +|Method Call |executing object* |target object** |method arguments + +|Method Execution |executing object* |executing object* |method +arguments + +|Constructor Call |executing object* |None |constructor arguments + +|Constructor Execution |executing object |executing object |constructor +arguments + +|Static initializer execution |None |None |None + +|Object pre-initialization |None |None |constructor arguments + +|Object initialization |executing object |executing object |constructor +arguments + +|Field reference |executing object* |target object** |None + +|Field assignment |executing object* |target object** |assigned value + +|Handler execution |executing object* |executing object* |caught +exception + +|Advice execution |executing aspect |executing aspect |advice arguments +|=== + +* There is no executing object in static contexts such as static method +bodies or static initializers. + +** There is no target object for join points associated with static +methods or fields. + +[[semantics-pointcuts]] +=== Pointcuts + +A pointcut is a program element that picks out join points and exposes +data from the execution context of those join points. Pointcuts are used +primarily by advice. They can be composed with boolean operators to +build up other pointcuts. The primitive pointcuts and combinators +provided by the language are: + +`call(MethodPattern)`:: + Picks out each method call join point whose signature matches + + + MethodPattern + + + . +`execution(MethodPattern)`:: + Picks out each method execution join point whose signature matches + + + MethodPattern + + + . +`get(FieldPattern)`:: + Picks out each field reference join point whose signature matches + + + FieldPattern + + + . [Note that references to constant fields (static final fields bound + to a constant string object or primitive value) are not join points, + since Java requires them to be inlined.] +`set(FieldPattern)`:: + Picks out each field set join point whose signature matches + + + FieldPattern + + + . [Note that the initializations of constant fields (static final + fields where the initializer is a constant string object or primitive + value) are not join points, since Java requires their references to be + inlined.] +`call(ConstructorPattern)`:: + Picks out each constructor call join point whose signature matches + + + ConstructorPattern + + + . +`execution(ConstructorPattern)`:: + Picks out each constructor execution join point whose signature + matches + + + ConstructorPattern + + + . +`initialization(ConstructorPattern)`:: + Picks out each object initialization join point whose signature + matches + + + ConstructorPattern + + + . +`preinitialization(ConstructorPattern)`:: + Picks out each object pre-initialization join point whose signature + matches + + + ConstructorPattern + + + . +`staticinitialization(TypePattern)`:: + Picks out each static initializer execution join point whose signature + matches + + + TypePattern + + + . +`handler(TypePattern)`:: + Picks out each exception handler join point whose signature matches + + + TypePattern + + + . +`adviceexecution()`:: + Picks out all advice execution join points. +`within(TypePattern)`:: + Picks out each join point where the executing code is defined in a + type matched by + + + TypePattern + + + . +`withincode(MethodPattern)`:: + Picks out each join point where the executing code is defined in a + method whose signature matches + + + MethodPattern + + + . +`withincode(ConstructorPattern)`:: + Picks out each join point where the executing code is defined in a + constructor whose signature matches + + + ConstructorPattern + + + . +`cflow(Pointcut)`:: + Picks out each join point in the control flow of any join point + + + P + + + picked out by + + + Pointcut + + + , including + + + P + + + itself. +`cflowbelow(Pointcut)`:: + Picks out each join point in the control flow of any join point + + + P + + + picked out by + + + Pointcut + + + , but not + + + P + + + itself. +`this(Type or Id)`:: + Picks out each join point where the currently executing object (the + object bound to + + + this + + + ) is an instance of + + + Type + + + , or of the type of the identifier + + + Id + + + (which must be bound in the enclosing advice or pointcut definition). + Will not match any join points from static contexts. +`target(Type or Id)`:: + Picks out each join point where the target object (the object on which + a call or field operation is applied to) is an instance of + + + Type + + + , or of the type of the identifier + + + Id + + + (which must be bound in the enclosing advice or pointcut definition). + Will not match any calls, gets, or sets of static members. +`args(Type or Id, ...)`:: + Picks out each join point where the arguments are instances of the + appropriate type (or type of the identifier if using that form). A + + + null + + + argument is matched iff the static type of the argument (declared + parameter type or field type) is the same as, or a subtype of, the + specified args type. +`PointcutId(TypePattern or Id, ...)`:: + Picks out each join point that is picked out by the user-defined + pointcut designator named by + + + PointcutId + + + . +`if(BooleanExpression)`:: + Picks out each join point where the boolean expression evaluates to + + + true + + + . The boolean expression used can only access static members, + parameters exposed by the enclosing pointcut or advice, and + + + thisJoinPoint + + + forms. In particular, it cannot call non-static methods on the aspect + or use return values or exceptions exposed by after advice. +`! Pointcut`:: + Picks out each join point that is not picked out by + + + Pointcut + + + . +`Pointcut0 && Pointcut1`:: + Picks out each join points that is picked out by both + + + Pointcut0 + + + and + + + Pointcut1 + + + . +`Pointcut0 || Pointcut1`:: + Picks out each join point that is picked out by either pointcuts. + + + Pointcut0 + + + or + + + Pointcut1 + + + . +`( Pointcut )`:: + Picks out each join points picked out by + + + Pointcut + + + . + +==== Pointcut definition + +Pointcuts are defined and named by the programmer with the `pointcut` +declaration. + +.... +pointcut publicIntCall(int i): + call(public * *(int)) && args(i); +.... + +A named pointcut may be defined in either a class or aspect, and is +treated as a member of the class or aspect where it is found. As a +member, it may have an access modifier such as `public` or `private`. + +.... +class C { + pointcut publicCall(int i): + call(public * *(int)) && args(i); +} + +class D { + pointcut myPublicCall(int i): + C.publicCall(i) && within(SomeType); +} +.... + +Pointcuts that are not final may be declared abstract, and defined +without a body. Abstract pointcuts may only be declared within abstract +aspects. + +.... +abstract aspect A { + abstract pointcut publicCall(int i); +} +.... + +In such a case, an extending aspect may override the abstract pointcut. + +.... +aspect B extends A { + pointcut publicCall(int i): call(public Foo.m(int)) && args(i); +} +.... + +For completeness, a pointcut with a declaration may be declared `final`. + +Though named pointcut declarations appear somewhat like method +declarations, and can be overridden in subaspects, they cannot be +overloaded. It is an error for two pointcuts to be named with the same +name in the same class or aspect declaration. + +The scope of a named pointcut is the enclosing class declaration. This +is different than the scope of other members; the scope of other members +is the enclosing class _body_. This means that the following code is +legal: + +.... +aspect B percflow(publicCall()) { + pointcut publicCall(): call(public Foo.m(int)); +} +.... + +==== Context exposure + +Pointcuts have an interface; they expose some parts of the execution +context of the join points they pick out. For example, the PublicIntCall +above exposes the first argument from the receptions of all public unary +integer methods. This context is exposed by providing typed formal +parameters to named pointcuts and advice, like the formal parameters of +a Java method. These formal parameters are bound by name matching. + +On the right-hand side of advice or pointcut declarations, in certain +pointcut designators, a Java identifier is allowed in place of a type or +collection of types. The pointcut designators that allow this are +`this`, `target`, and `args`. In all such cases, using an identifier +rather than a type does two things. First, it selects join points as +based on the type of the formal parameter. So the pointcut + +.... +pointcut intArg(int i): args(i); +.... + +picks out join points where an `int` (or a `byte`, `short`, or `char`; +anything assignable to an `int`) is being passed as an argument. Second, +though, it makes the value of that argument available to the enclosing +advice or pointcut. + +Values can be exposed from named pointcuts as well, so + +.... +pointcut publicCall(int x): call(public *.*(int)) && intArg(x); +pointcut intArg(int i): args(i); +.... + +is a legal way to pick out all calls to public methods accepting an int +argument, and exposing that argument. + +There is one special case for this kind of exposure. Exposing an +argument of type Object will also match primitive typed arguments, and +expose a "boxed" version of the primitive. So, + +.... +pointcut publicCall(): call(public *.*(..)) && args(Object); +.... + +will pick out all unary methods that take, as their only argument, +subtypes of Object (i.e., not primitive types like `int`), but + +.... +pointcut publicCall(Object o): call(public *.*(..)) && args(o); +.... + +will pick out all unary methods that take any argument: And if the +argument was an `int`, then the value passed to advice will be of type +`java.lang.Integer`. + +The "boxing" of the primitive value is based on the _original_ primitive +type. So in the following program + +.... +public class InstanceOf { + + public static void main(String[] args) { + doInt(5); + } + + static void doInt(int i) { } +} + +aspect IntToLong { + pointcut el(long l) : + execution(* doInt(..)) && args(l); + + before(Object o) : el(o) { + System.out.println(o.getClass()); + } +} +.... + +The pointcut will match and expose the integer argument, but it will +expose it as an `Integer`, not a `Long`. + +==== Primitive pointcuts + +===== Method-related pointcuts + +AspectJ provides two primitive pointcut designators designed to capture +method call and execution join points. + +* call( ++ +MethodPattern ++ +) +* execution( ++ +MethodPattern ++ +) + +===== Field-related pointcuts + +AspectJ provides two primitive pointcut designators designed to capture +field reference and set join points: + +* get( ++ +FieldPattern ++ +) +* set( ++ +FieldPattern ++ +) + +All set join points are treated as having one argument, the value the +field is being set to, so at a set join point, that value can be +accessed with an `args` pointcut. So an aspect guarding a static integer +variable x declared in type T might be written as + +.... +aspect GuardedX { + static final int MAX_CHANGE = 100; + before(int newval): set(static int T.x) && args(newval) { + if (Math.abs(newval - T.x) > MAX_CHANGE) + throw new RuntimeException(); + } +} +.... + +===== Object creation-related pointcuts + +AspectJ provides primitive pointcut designators designed to capture the +initializer execution join points of objects. + +* call( ++ +ConstructorPattern ++ +) +* execution( ++ +ConstructorPattern ++ +) +* initialization( ++ +ConstructorPattern ++ +) +* preinitialization( ++ +ConstructorPattern ++ +) + +===== Class initialization-related pointcuts + +AspectJ provides one primitive pointcut designator to pick out static +initializer execution join points. + +* staticinitialization( ++ +TypePattern ++ +) + +===== Exception handler execution-related pointcuts + +AspectJ provides one primitive pointcut designator to capture execution +of exception handlers: + +* handler( ++ +TypePattern ++ +) + +All handler join points are treated as having one argument, the value of +the exception being handled. That value can be accessed with an `args` +pointcut. So an aspect used to put `FooException` objects into some +normal form before they are handled could be written as + +.... +aspect NormalizeFooException { + before(FooException e): handler(FooException) && args(e) { + e.normalize(); + } +} +.... + +===== Advice execution-related pointcuts + +AspectJ provides one primitive pointcut designator to capture execution +of advice + +* adviceexecution() + +This can be used, for example, to filter out any join point in the +control flow of advice from a particular aspect. + +.... +aspect TraceStuff { + pointcut myAdvice(): adviceexecution() && within(TraceStuff); + + before(): call(* *(..)) && !cflow(myAdvice) { + // do something + } +} +.... + +===== State-based pointcuts + +Many concerns cut across the dynamic times when an object of a +particular type is executing, being operated on, or being passed around. +AspectJ provides primitive pointcuts that capture join points at these +times. These pointcuts use the dynamic types of their objects to pick +out join points. They may also be used to expose the objects used for +discrimination. + +* this( ++ +Type ++ +or ++ +Id ++ +) +* target( ++ +Type ++ +or ++ +Id ++ +) + +The `this` pointcut picks out each join point where the currently +executing object (the object bound to `this`) is an instance of a +particular type. The `target` pointcut picks out each join point where +the target object (the object on which a method is called or a field is +accessed) is an instance of a particular type. Note that `target` should +be understood to be the object the current join point is transfering +control to. This means that the target object is the same as the current +object at a method execution join point, for example, but may be +different at a method call join point. + +* args( ++ +Type ++ +or ++ +Id ++ +or "..", ...) + +The args pointcut picks out each join point where the arguments are +instances of some types. Each element in the comma-separated list is one +of four things. If it is a type name, then the argument in that position +must be an instance of that type. If it is an identifier, then that +identifier must be bound in the enclosing advice or pointcut +declaration, and so the argument in that position must be an instance of +the type of the identifier (or of any type if the identifier is typed to +Object). If it is the "*" wildcard, then any argument will match, and if +it is the special wildcard "..", then any number of arguments will +match, just like in signature patterns. So the pointcut + +.... +args(int, .., String) +.... + +will pick out all join points where the first argument is an `int` and +the last is a `String`. + +===== Control flow-based pointcuts + +Some concerns cut across the control flow of the program. The `cflow` +and `cflowbelow` primitive pointcut designators capture join points +based on control flow. + +* cflow( ++ +Pointcut ++ +) +* cflowbelow( ++ +Pointcut ++ +) + +The `cflow` pointcut picks out all join points that occur between entry +and exit of each join point

picked out by , including

+itself. Hence, it picks out the join points _in_ the control flow of the +join points picked out by . + +The `cflowbelow` pointcut picks out all join points that occur between +entry and exit of each join point

picked out by , but not +including

itself. Hence, it picks out the join points _below_ the +control flow of the join points picked out by . + +====== Context exposure from control flows + +The `cflow` and `cflowbelow` pointcuts may expose context state through +enclosed `this`, `target`, and `args` pointcuts. + +Anytime such state is accessed, it is accessed through the _most recent_ +control flow that matched. So the "current arg" that would be printed by +the following program is zero, even though it is in many control flows. + +.... +class Test { + public static void main(String[] args) { + fact(5); + } + static int fact(int x) { + if (x == 0) { + System.err.println("bottoming out"); + return 1; + } + else return x * fact(x - 1); + } +} + +aspect A { + pointcut entry(int i): call(int fact(int)) && args(i); + pointcut writing(): call(void println(String)) && ! within(A); + + before(int i): writing() && cflow(entry(i)) { + System.err.println("Current arg is " + i); + } +} +.... + +It is an error to expose such state through _negated_ control flow +pointcuts, such as within `! + cflowbelow(P)`. + +===== Program text-based pointcuts + +While many concerns cut across the runtime structure of the program, +some must deal with the lexical structure. AspectJ allows aspects to +pick out join points based on where their associated code is defined. + +* within( ++ +TypePattern ++ +) +* withincode( ++ +MethodPattern ++ +) +* withincode( ++ +ConstructorPattern ++ +) + +The `within` pointcut picks out each join point where the code executing +is defined in the declaration of one of the types in . This +includes the class initialization, object initialization, and method and +constructor execution join points for the type, as well as any join +points associated with the statements and expressions of the type. It +also includes any join points that are associated with code in a type's +nested types, and that type's default constructor, if there is one. + +The `withincode` pointcuts picks out each join point where the code +executing is defined in the declaration of a particular method or +constructor. This includes the method or constructor execution join +point as well as any join points associated with the statements and +expressions of the method or constructor. It also includes any join +points that are associated with code in a method or constructor's local +or anonymous types. + +===== Expression-based pointcuts + +* if( ++ +BooleanExpression ++ +) + +The if pointcut picks out join points based on a dynamic property. its +syntax takes an expression, which must evaluate to a boolean true or +false. Within this expression, the `thisJoinPoint` object is available. +So one (extremely inefficient) way of picking out all call join points +would be to use the pointcut + +.... +if(thisJoinPoint.getKind().equals("call")) +.... + +Note that the order of evaluation for pointcut expression components at +a join point is undefined. Writing `if` pointcuts that have side-effects +is considered bad style and may also lead to potentially confusing or +even changing behavior with regard to when or if the test code will run. + +==== Signatures + +One very important property of a join point is its signature, which is +used by many of AspectJ's pointcut designators to select particular join +points. + +===== Methods + +Join points associated with methods typically have method signatures, +consisting of a method name, parameter types, return type, the types of +the declared (checked) exceptions, and some type that the method could +be called on (below called the "qualifying type"). + +At a method call join point, the signature is a method signature whose +qualifying type is the static type used to _access_ the method. This +means that the signature for the join point created from the call +`((Integer)i).toString()` is different than that for the call +`((Object)i).toString()`, even if `i` is the same variable. + +At a method execution join point, the signature is a method signature +whose qualifying type is the declaring type of the method. + +===== Fields + +Join points associated with fields typically have field signatures, +consisting of a field name and a field type. A field reference join +point has such a signature, and no parameters. A field set join point +has such a signature, but has a has a single parameter whose type is the +same as the field type. + +===== Constructors + +Join points associated with constructors typically have constructor +signatures, consisting of a parameter types, the types of the declared +(checked) exceptions, and the declaring type. + +At a constructor call join point, the signature is the constructor +signature of the called constructor. At a constructor execution join +point, the signature is the constructor signature of the currently +executing constructor. + +At object initialization and pre-initialization join points, the +signature is the constructor signature for the constructor that started +this initialization: the first constructor entered during this type's +initialization of this object. + +===== Others + +At a handler execution join point, the signature is composed of the +exception type that the handler handles. + +At an advice execution join point, the signature is composed of the +aspect type, the parameter types of the advice, the return type (void +for all but around advice) and the types of the declared (checked) +exceptions. + +==== Matching + +The `withincode`, `call`, `execution`, `get`, and `set` primitive +pointcut designators all use signature patterns to determine the join +points they describe. A signature pattern is an abstract description of +one or more join-point signatures. Signature patterns are intended to +match very closely the same kind of things one would write when +declaring individual members and constructors. + +Method declarations in Java include method names, method parameters, +return types, modifiers like static or private, and throws clauses, +while constructor declarations omit the return type and replace the +method name with the class name. The start of a particular method +declaration, in class `Test`, for example, might be + +.... +class C { + public final void foo() throws ArrayOutOfBoundsException { ... } +} +.... + +In AspectJ, method signature patterns have all these, but most elements +can be replaced by wildcards. So + +.... +call(public final void C.foo() throws ArrayOutOfBoundsException) +.... + +picks out call join points to that method, and the pointcut + +.... +call(public final void *.*() throws ArrayOutOfBoundsException) +.... + +picks out all call join points to methods, regardless of their name name +or which class they are defined on, so long as they take no arguments, +return no value, are both `public` and `final`, and are declared to +throw `ArrayOutOfBounds` exceptions. + +The defining type name, if not present, defaults to *, so another way of +writing that pointcut would be + +.... +call(public final void *() throws ArrayOutOfBoundsException) +.... + +The wildcard `..` indicates zero or more parameters, so + +.... +execution(void m(..)) +.... + +picks out execution join points for void methods named `m`, of any +number of arguments, while + +.... +execution(void m(.., int)) +.... + +picks out execution join points for void methods named `m` whose last +parameter is of type `int`. + +The modifiers also form part of the signature pattern. If an AspectJ +signature pattern should match methods without a particular modifier, +such as all non-public methods, the appropriate modifier should be +negated with the `!` operator. So, + +.... +withincode(!public void foo()) +.... + +picks out all join points associated with code in null non-public void +methods named `foo`, while + +.... +withincode(void foo()) +.... + +picks out all join points associated with code in null void methods +named `foo`, regardless of access modifier. + +Method names may contain the * wildcard, indicating any number of +characters in the method name. So + +.... +call(int *()) +.... + +picks out all call join points to `int` methods regardless of name, but + +.... +call(int get*()) +.... + +picks out all call join points to `int` methods where the method name +starts with the characters "get". + +AspectJ uses the `new` keyword for constructor signature patterns rather +than using a particular class name. So the execution join points of +private null constructor of a class C defined to throw an +ArithmeticException can be picked out with + +.... +execution(private C.new() throws ArithmeticException) +.... + +===== Matching based on the declaring type + +The signature-matching pointcuts all specify a declaring type, but the +meaning varies slightly for each join point signature, in line with Java +semantics. + +When matching for pointcuts `withincode`, `get`, and `set`, the +declaring type is the class that contains the declaration. + +When matching method-call join points, the declaring type is the static +type used to access the method. A common mistake is to specify a +declaring type for the `call` pointcut that is a subtype of the +originally-declaring type. For example, given the class + +.... +class Service implements Runnable { + public void run() { ... } +} +.... + +the following pointcut + +.... +call(void Service.run()) +.... + +would fail to pick out the join point for the code + +.... +((Runnable) new Service()).run(); +.... + +Specifying the originally-declaring type is correct, but would pick out +any such call (here, calls to the `run()` method of any Runnable). In +this situation, consider instead picking out the target type: + +.... +call(void run()) && target(Service) +.... + +When matching method-execution join points, if the execution pointcut +method signature specifies a declaring type, the pointcut will only +match methods declared in that type, or methods that override methods +declared in or inherited by that type. So the pointcut + +.... +execution(public void Middle.*()) +.... + +picks out all method executions for public methods returning void and +having no arguments that are either declared in, or inherited by, +Middle, even if those methods are overridden in a subclass of Middle. So +the pointcut would pick out the method-execution join point for Sub.m() +in this code: + +.... +class Super { + protected void m() { ... } +} +class Middle extends Super { +} +class Sub extends Middle { + public void m() { ... } +} +.... + +===== Matching based on the throws clause + +Type patterns may be used to pick out methods and constructors based on +their throws clauses. This allows the following two kinds of extremely +wildcarded pointcuts: + +.... +pointcut throwsMathlike(): + // each call to a method with a throws clause containing at least + // one exception exception with "Math" in its name. + call(* *(..) throws *..*Math*); + +pointcut doesNotThrowMathlike(): + // each call to a method with a throws clause containing no + // exceptions with "Math" in its name. + call(* *(..) throws !*..*Math*); +.... + +A is a comma-separated list of +s, where + + ::: + [ ! ] + + + TypeNamePattern + +A matches the throws clause of any code member +signature. To match, each `ThrowsClausePatternItem` must match the +throws clause of the member in question. If any item doesn't match, then +the whole pattern doesn't match. + +If a ThrowsClausePatternItem begins with "!", then it matches a +particular throws clause if and only if _none_ of the types named in the +throws clause is matched by the `TypeNamePattern`. + +If a does not begin with "!", then it matches +a throws clause if and only if _any_ of the types named in the throws +clause is matched by the _TypeNamePattern_. + +The rule for "!" matching has one potentially surprising property, in +that these two pointcuts + +* call(* *(..) throws !IOException) +* call(* *(..) throws (!IOException)) + +will match differently on calls to + +____ +void m() throws RuntimeException, IOException \{} +____ + +[1] will NOT match the method m(), because method m's throws clause +declares that it throws IOException. [2] WILL match the method m(), +because method m's throws clause declares the it throws some exception +which does not match IOException, i.e. RuntimeException. + +==== Type patterns + +Type patterns are a way to pick out collections of types and use them in +places where you would otherwise use only one type. The rules for using +type patterns are simple. + +===== Exact type pattern + +First, all type names are also type patterns. So `Object`, +`java.util.HashMap`, `Map.Entry`, `int` are all type patterns. + +If a type pattern is an exact type - if it doesn't include a wildcard - +then the matching works just like normal type lookup in Java: + +* Patterns that have the same names as primitive types (like ++ +int ++ +) match those primitive types. +* Patterns that are qualified by package names (like ++ +java.util.HashMap ++ +) match types in other packages. +* Patterns that are not qualified (like ++ +HashMap ++ +) match types that are resolved by Java's normal scope rules. So, for +example, ++ +HashMap ++ +might match a package-level type in the same package or a type that have +been imported with java's ++ +import ++ +form. But it would not match ++ +java.util.HashMap ++ +unless the aspect were in ++ +java.util ++ +or the type had been imported. + +So exact type patterns match based on usual Java scope rules. + +===== Type name patterns + +There is a special type name, *, which is also a type pattern. * picks +out all types, including primitive types. So + +.... +call(void foo(*)) +.... + +picks out all call join points to void methods named foo, taking one +argument of any type. + +Type names that contain the two wildcards "*" and "`..`" are also type +patterns. The * wildcard matches zero or more characters characters +except for ".", so it can be used when types have a certain naming +convention. So + +.... +handler(java.util.*Map) +.... + +picks out the types java.util.Map and java.util.java.util.HashMap, among +others, and + +.... +handler(java.util.*) +.... + +picks out all types that start with "`java.util.`" and don't have any +more "."s, that is, the types in the `java.util` package, but not inner +types (such as java.util.Map.Entry). + +The "`..`" wildcard matches any sequence of characters that start and +end with a ".", so it can be used to pick out all types in any +subpackage, or all inner types. So + +.... +within(com.xerox..*) +.... + +picks out all join points where the code is in any declaration of a type +whose name begins with "`com.xerox.`". + +Type patterns with wildcards do not depend on Java's usual scope rules - +they match against all types available to the weaver, not just those +that are imported into an Aspect's declaring file. + +===== Subtype patterns + +It is possible to pick out all subtypes of a type (or a collection of +types) with the "+" wildcard. The "+" wildcard follows immediately a +type name pattern. So, while + +.... +call(Foo.new()) +.... + +picks out all constructor call join points where an instance of exactly +type Foo is constructed, + +.... +call(Foo+.new()) +.... + +picks out all constructor call join points where an instance of any +subtype of Foo (including Foo itself) is constructed, and the unlikely + +.... +call(*Handler+.new()) +.... + +picks out all constructor call join points where an instance of any +subtype of any type whose name ends in "Handler" is constructed. + +===== Array type patterns + +A type name pattern or subtype pattern can be followed by one or more +sets of square brackets to make array type patterns. So `Object[]` is an +array type pattern, and so is `com.xerox..*[][]`, and so is `Object+[]`. + +===== Type patterns + +Type patterns are built up out of type name patterns, subtype patterns, +and array type patterns, and constructed with boolean operators `&&`, +`||`, and `!`. So + +.... +staticinitialization(Foo || Bar) +.... + +picks out the static initializer execution join points of either Foo or +Bar, and + +.... +call((Foo+ && ! Foo).new(..)) +.... + +picks out the constructor call join points when a subtype of Foo, but +not Foo itself, is constructed. + +==== Pattern Summary + +Here is a summary of the pattern syntax used in AspectJ: + +.... +MethodPattern = + [ModifiersPattern] TypePattern + [TypePattern . ] IdPattern (TypePattern | ".." , ... ) + [ throws ThrowsPattern ] +ConstructorPattern = + [ModifiersPattern ] + [TypePattern . ] new (TypePattern | ".." , ...) + [ throws ThrowsPattern ] +FieldPattern = + [ModifiersPattern] TypePattern [TypePattern . ] IdPattern +ThrowsPattern = + [ ! ] TypePattern , ... +TypePattern = + IdPattern [ + ] [ [] ... ] + | ! TypePattern + | TypePattern && TypePattern + | TypePattern || TypePattern + | ( TypePattern ) +IdPattern = + Sequence of characters, possibly with special * and .. wildcards +ModifiersPattern = + [ ! ] JavaModifier ... +.... + +[[semantics-advice]] +=== Advice + +Each piece of advice is of the form + +____ +[ strictfp ] + +AdviceSpec + +[ throws + +TypeList + +] : + +Pointcut + +\{ + +Body + +} +____ + +where is one of + +* before( ++ +Formals ++ +) +* after( ++ +Formals ++ +) returning [ ( ++ +Formal ++ +) ] +* after( ++ +Formals ++ +) throwing [ ( ++ +Formal ++ +) ] +* after( ++ +Formals ++ +) +* Type ++ +around( ++ +Formals ++ +) + +and where refers to a variable binding like those used for +method parameters, of the form `Type` `Variable-Name`, and +refers to a comma-delimited list of . + +Advice defines crosscutting behavior. It is defined in terms of +pointcuts. The code of a piece of advice runs at every join point picked +out by its pointcut. Exactly how the code runs depends on the kind of +advice. + +AspectJ supports three kinds of advice. The kind of advice determines +how it interacts with the join points it is defined over. Thus AspectJ +divides advice into that which runs before its join points, that which +runs after its join points, and that which runs in place of (or +"around") its join points. + +While before advice is relatively unproblematic, there can be three +interpretations of after advice: After the execution of a join point +completes normally, after it throws an exception, or after it does +either one. AspectJ allows after advice for any of these situations. + +.... +aspect A { + pointcut publicCall(): call(public Object *(..)); + after() returning (Object o): publicCall() { + System.out.println("Returned normally with " + o); + } + after() throwing (Exception e): publicCall() { + System.out.println("Threw an exception: " + e); + } + after(): publicCall(){ + System.out.println("Returned or threw an Exception"); + } +} +.... + +After returning advice may not care about its returned object, in which +case it may be written + +.... +after() returning: call(public Object *(..)) { + System.out.println("Returned normally"); +} +.... + +If after returning does expose its returned object, then the type of the +parameter is considered to be an `instanceof`-like constraint on the +advice: it will run only when the return value is of the appropriate +type. + +A value is of the appropriate type if it would be assignable to a +variable of that type, in the Java sense. That is, a `byte` value is +assignable to a `short` parameter but not vice-versa, an `int` is +assignable to a `float` parameter, `boolean` values are only assignable +to `boolean` parameters, and reference types work by instanceof. + +There are two special cases: If the exposed value is typed to `Object`, +then the advice is not constrained by that type: the actual return value +is converted to an object type for the body of the advice: `int` values +are represented as `java.lang.Integer` objects, etc, and no value (from +void methods, for example) is represented as `null`. + +Secondly, the `null` value is assignable to a parameter `T` if the join +point _could_ return something of type `T`. + +Around advice runs in place of the join point it operates over, rather +than before or after it. Because around is allowed to return a value, it +must be declared with a return type, like a method. + +Thus, a simple use of around advice is to make a particular method +constant: + +.... +aspect A { + int around(): call(int C.foo()) { + return 3; + } +} +.... + +Within the body of around advice, though, the computation of the +original join point can be executed with the special syntax + +.... +proceed( ... ) +.... + +The proceed form takes as arguments the context exposed by the around's +pointcut, and returns whatever the around is declared to return. So the +following around advice will double the second argument to `foo` +whenever it is called, and then halve its result: + +.... +aspect A { + int around(int i): call(int C.foo(Object, int)) && args(i) { + int newi = proceed(i*2) + return newi/2; + } +} +.... + +If the return value of around advice is typed to `Object`, then the +result of proceed is converted to an object representation, even if it +is originally a primitive value. And when the advice returns an Object +value, that value is converted back to whatever representation it was +originally. So another way to write the doubling and halving advice is: + +.... +aspect A { + Object around(int i): call(int C.foo(Object, int)) && args(i) { + Integer newi = (Integer) proceed(i*2) + return new Integer(newi.intValue() / 2); + } +} +.... + +Any occurence of `proceed(..)` within the body of around advice is +treated as the special proceed form (even if the aspect defines a method +named `proceed`), unless a target other than the aspect instance is +specified as the recipient of the call. For example, in the following +program the first call to proceed will be treated as a method call to +the `ICanProceed` instance, whereas the second call to proceed is +treated as the special proceed form. + +.... +aspect A { + Object around(ICanProceed canProceed) : execution(* *(..)) && this(canProceed) { + canProceed.proceed(); // a method call + return proceed(canProceed); // the special proceed form + } + + private Object proceed(ICanProceed canProceed) { + // this method cannot be called from inside the body of around advice in + // the aspect + } +} +.... + +In all kinds of advice, the parameters of the advice behave exactly like +method parameters. In particular, assigning to any parameter affects +only the value of the parameter, not the value that it came from. This +means that + +.... +aspect A { + after() returning (int i): call(int C.foo()) { + i = i * 2; + } +} +.... + +will _not_ double the returned value of the advice. Rather, it will +double the local parameter. Changing the values of parameters or return +values of join points can be done by using around advice. + +With `proceed(..)` it is possible to change the values used by +less-precedent advice and the underlying join point by supplying +different values for the variables. For example, this aspect replaces +the string bound to `s` in the named pointcut `privateData`: + +.... +aspect A { + Object around(String s): MyPointcuts.privateData(s) { + return proceed("private data"); + } +} +.... + +If you replace an argument to `proceed(..)`, you can cause a +`ClassCastException` at runtime when the argument refers to a supertype +of the actual type and you do not supply a reference of the actual type. +In the following aspect, the around advice replaces the declared target +`List` with an `ArrayList`. This is valid code at compile-time since the +types match. + +.... +import java.util.*; + +aspect A { + Object around(List list): call(* List+.*()) && target(list) { + return proceed(new ArrayList()); + } +} +.... + +But imagine a simple program where the actual target is `LinkedList`. In +this case, the advice would cause a `ClassCastException` at runtime, and +`peek()` is not declared in `ArrayList`. + +.... +public class Test { + public static void main(String[] args) { + new LinkedList().peek(); + } +} +.... + +The `ClassCastException` can occur even in situations where it appears +to be unnecessary, e.g., if the program is changed to call `size()`, +declared in `List`: + +.... +public class Test { + public static void main(String[] args) { + new LinkedList().size(); + } +} +.... + +There will still be a `ClassCastException` because it is impossible to +prove that there won't be a runtime binary-compatible change in the +hierarchy of `LinkedList` or some other advice on the join point that +requires a `LinkedList`. + +==== Advice modifiers + +The `strictfp` modifier is the only modifier allowed on advice, and it +has the effect of making all floating-point expressions within the +advice be FP-strict. + +==== Advice and checked exceptions + +An advice declaration must include a `throws` clause listing the checked +exceptions the body may throw. This list of checked exceptions must be +compatible with each target join point of the advice, or an error is +signalled by the compiler. + +For example, in the following declarations: + +.... +import java.io.FileNotFoundException; + +class C { + int i; + + int getI() { return i; } +} + +aspect A { + before(): get(int C.i) { + throw new FileNotFoundException(); + } + before() throws FileNotFoundException: get(int C.i) { + throw new FileNotFoundException(); + } +} +.... + +both pieces of advice are illegal. The first because the body throws an +undeclared checked exception, and the second because field get join +points cannot throw `FileNotFoundException`s. + +The exceptions that each kind of join point in AspectJ may throw are: + +method call and execution:: + the checked exceptions declared by the target method's + + + throws + + + clause. +constructor call and execution:: + the checked exceptions declared by the target constructor's + + + throws + + + clause. +field get and set:: + no checked exceptions can be thrown from these join points. +exception handler execution:: + the exceptions that can be thrown by the target exception handler. +static initializer execution:: + no checked exceptions can be thrown from these join points. +pre-initialization and initialization:: + any exception that is in the throws clause of + + + all + + + constructors of the initialized class. +advice execution:: + any exception that is in the throws clause of the advice. + +==== Advice precedence + +Multiple pieces of advice may apply to the same join point. In such +cases, the resolution order of the advice is based on advice precedence. + +===== Determining precedence + +There are a number of rules that determine whether a particular piece of +advice has precedence over another when they advise the same join point. + +If the two pieces of advice are defined in different aspects, then there +are three cases: + +* If aspect A is matched earlier than aspect B in some ++ +declare precedence ++ +form, then all advice in concrete aspect A has precedence over all +advice in concrete aspect B when they are on the same join point. +* Otherwise, if aspect A is a subaspect of aspect B, then all advice +defined in A has precedence over all advice defined in B. So, unless +otherwise specified with ++ +declare precedence ++ +, advice in a subaspect has precedence over advice in a superaspect. +* Otherwise, if two pieces of advice are defined in two different +aspects, it is undefined which one has precedence. + +If the two pieces of advice are defined in the same aspect, then there +are two cases: + +* If either are ++ +after ++ +advice, then the one that appears later in the aspect has precedence +over the one that appears earlier. +* Otherwise, then the one that appears earlier in the aspect has +precedence over the one that appears later. + +These rules can lead to circularity, such as + +.... +aspect A { + before(): execution(void main(String[] args)) {} + after(): execution(void main(String[] args)) {} + before(): execution(void main(String[] args)) {} +} +.... + +such circularities will result in errors signalled by the compiler. + +===== Effects of precedence + +At a particular join point, advice is ordered by precedence. + +A piece of `around` advice controls whether advice of lower precedence +will run by calling `proceed`. The call to `proceed` will run the advice +with next precedence, or the computation under the join point if there +is no further advice. + +A piece of `before` advice can prevent advice of lower precedence from +running by throwing an exception. If it returns normally, however, then +the advice of the next precedence, or the computation under the join +pint if there is no further advice, will run. + +Running `after returning` advice will run the advice of next precedence, +or the computation under the join point if there is no further advice. +Then, if that computation returned normally, the body of the advice will +run. + +Running `after throwing` advice will run the advice of next precedence, +or the computation under the join point if there is no further advice. +Then, if that computation threw an exception of an appropriate type, the +body of the advice will run. + +Running `after` advice will run the advice of next precedence, or the +computation under the join point if there is no further advice. Then the +body of the advice will run. + +==== Reflective access to the join point + +Three special variables are visible within bodies of advice and within +`if()` pointcut expressions: `thisJoinPoint`, `thisJoinPointStaticPart`, +and `thisEnclosingJoinPointStaticPart`. Each is bound to an object that +encapsulates some of the context of the advice's current or enclosing +join point. These variables exist because some pointcuts may pick out +very large collections of join points. For example, the pointcut + +.... +pointcut publicCall(): call(public * *(..)); +.... + +picks out calls to many methods. Yet the body of advice over this +pointcut may wish to have access to the method name or parameters of a +particular join point. + +`thisJoinPoint` is bound to a complete join point object. + +`thisJoinPointStaticPart` is bound to a part of the join point object +that includes less information, but for which no memory allocation is +required on each execution of the advice. It is equivalent to +`thisJoinPoint.getStaticPart()`. + +`thisEnclosingJoinPointStaticPart` is bound to the static part of the +join point enclosing the current join point. Only the static part of +this enclosing join point is available through this mechanism. + +Standard Java reflection uses objects from the `java.lang.reflect` +hierarchy to build up its reflective objects. Similarly, AspectJ join +point objects have types in a type hierarchy. The type of objects bound +to `thisJoinPoint` is `org.aspectj.lang.JoinPoint`, while +`thisStaticJoinPoint` is bound to objects of interface type +`org.aspectj.lang.JoinPoint.StaticPart`. + +[[semantics-declare]] +=== Static crosscutting + +Advice declarations change the behavior of classes they crosscut, but do +not change their static type structure. For crosscutting concerns that +do operate over the static structure of type hierarchies, AspectJ +provides inter-type member declarations and other `declare` forms. + +==== Inter-type member declarations + +AspectJ allows the declaration of members by aspects that are associated +with other types. + +An inter-type method declaration looks like + +* [ ++ +Modifiers ++ +] ++ +Type ++ +OnType ++ +. ++ +Id ++ +( ++ +Formals ++ +) [ ++ +ThrowsClause ++ +] \{ ++ +Body ++ +} +* abstract [ ++ +Modifiers ++ +] ++ +Type ++ +OnType ++ +. ++ +Id ++ +( ++ +Formals ++ +) [ ++ +ThrowsClause ++ +] ; + +The effect of such a declaration is to make support the new +method. Even if is an interface. Even if the method is neither +public nor abstract. So the following is legal AspectJ code: + +.... +interface Iface {} + +aspect A { + private void Iface.m() { + System.err.println("I'm a private method on an interface"); + } + void worksOnI(Iface iface) { + // calling a private method on an interface + iface.m(); + } +} +.... + +An inter-type constructor declaration looks like + +* [ ++ +Modifiers ++ +] ++ +OnType ++ +. new ( ++ +Formals ++ +) [ ++ +ThrowsClause ++ +] \{ ++ +Body ++ +} + +The effect of such a declaration is to make support the new +constructor. It is an error for to be an interface. + +Inter-type declared constructors cannot be used to assign a value to a +final variable declared in . This limitation significantly +increases the ability to both understand and compile the class +and the declaring aspect separately. + +Note that in the Java language, classes that define no constructors have +an implicit no-argument constructor that just calls `super()`. This +means that attempting to declare a no-argument inter-type constructor on +such a class may result in a conflict, even though it _looks_ like no +constructor is defined. + +An inter-type field declaration looks like one of + +* [ ++ +Modifiers ++ +] ++ +Type ++ +OnType ++ +. ++ +Id ++ += ++ +Expression ++ +; +* [ ++ +Modifiers ++ +] ++ +Type ++ +OnType ++ +. ++ +Id ++ +; + +The effect of such a declaration is to make support the new +field. Even if is an interface. Even if the field is neither +public, nor static, nor final. + +The initializer, if any, of an inter-type field declaration runs before +the class-local initializers defined in its target class. + +Any occurrence of the identifier `this` in the body of an inter-type +constructor or method declaration, or in the initializer of an +inter-type field declaration, refers to the object rather than +to the aspect type; it is an error to access `this` in such a position +from a `static` inter-type member declaration. + +==== Access modifiers + +Inter-type member declarations may be public or private, or have default +(package-protected) visibility. AspectJ does not provide protected +inter-type members. + +The access modifier applies in relation to the aspect, not in relation +to the target type. So a private inter-type member is visible only from +code that is defined within the declaring aspect. A default-visibility +inter-type member is visible only from code that is defined within the +declaring aspect's package. + +Note that a declaring a private inter-type method (which AspectJ +supports) is very different from inserting a private method declaration +into another class. The former allows access only from the declaring +aspect, while the latter would allow access only from the target type. +Java serialization, for example, uses the presense of a private method +`void writeObject(ObjectOutputStream)` for the implementation of +`java.io.Serializable`. A private inter-type declaration of that method +would not fulfill this requirement, since it would be private to the +aspect, not private to the target type. + +The access modifier of abstract inter-type methods has one constraint: +It is illegal to declare an abstract non-public inter-type method on a +public interface. This is illegal because it would say that a public +interface has a constraint that only non-public implementors must +fulfill. This would not be compatible with Java's type system. + +==== Conflicts + +Inter-type declarations raise the possibility of conflicts among locally +declared members and inter-type members. For example, assuming +`otherPackage` is not the package containing the aspect `A`, the code + +.... +aspect A { + private Registry otherPackage.onType.r; + public void otherPackage.onType.register(Registry r) { + r.register(this); + this.r = r; + } +} +.... + +declares that `onType` in `otherPackage` has a field `r`. This field, +however, is only accessible from the code inside of aspect `A`. The +aspect also declares that `onType` has a method "`register`", but makes +this method accessible from everywhere. + +If `onType` already defines a private or package-protected field "`r`", +there is no conflict: The aspect cannot see such a field, and no code in +`otherPackage` can see the inter-type "`r`". + +If `onType` defines a public field "`r`", there is a conflict: The +expression + +.... +this.r = r +.... + +is an error, since it is ambiguous whether the private inter-type "`r`" +or the public locally-defined "`r`" should be used. + +If `onType` defines a method "`register(Registry)`" there is a conflict, +since it would be ambiguous to any code that could see such a defined +method which "`register(Registry)`" method was applicable. + +Conflicts are resolved as much as possible as per Java's conflict +resolution rules: + +* A subclass can inherit multiple ++ +fields ++ +from its superclasses, all with the same name and type. However, it is +an error to have an ambiguous ++ +reference ++ +to a field. +* A subclass can only inherit multiple ++ +methods ++ +with the same name and argument types from its superclasses if only zero +or one of them is concrete (i.e., all but one is abstract, or all are +abstract). + +Given a potential conflict between inter-type member declarations in +different aspects, if one aspect has precedence over the other its +declaration will take effect without any conflict notice from compiler. +This is true both when the precedence is declared explicitly with +`declare precedence` as well as when when sub-aspects implicitly have +precedence over their super-aspect. + +==== Extension and Implementation + +An aspect may change the inheritance hierarchy of a system by changing +the superclass of a type or adding a superinterface onto a type, with +the `declare parents` form. + +* declare parents: ++ +TypePattern ++ +extends ++ +Type ++ +; +* declare parents: ++ +TypePattern ++ +implements ++ +TypeList ++ +; + +For example, if an aspect wished to make a particular class runnable, it +might define appropriate inter-type `void + run()` method, but it should also declare that the class +fulfills the `Runnable` interface. In order to implement the methods in +the `Runnable` interface, the inter-type `run()` method must be public: + +.... +aspect A { + declare parents: SomeClass implements Runnable; + public void SomeClass.run() { ... } +} +.... + +==== Interfaces with members + +Through the use of inter-type members, interfaces may now carry +(non-public-static-final) fields and (non-public-abstract) methods that +classes can inherit. Conflicts may occur from ambiguously inheriting +members from a superclass and multiple superinterfaces. + +Because interfaces may carry non-static initializers, each interface +behaves as if it has a zero-argument constructor containing its +initializers. The order of super-interface instantiation is observable. +We fix this order with the following properties: A supertype is +initialized before a subtype, initialized code runs only once, and the +initializers for a type's superclass are run before the initializers for +its superinterfaces. Consider the following hierarchy where \{`Object`, +`C`, `D`, `E`} are classes, \{`M`, `N`, `O`, `P`, `Q`} are interfaces. + +.... + Object M O + \ / \ / + C N Q + \ / / + D P + \ / + E +.... + +when a new `E` is instantiated, the initializers run in this order: + +.... +Object M C O N D Q P E +.... + +==== Warnings and Errors + +An aspect may specify that a particular join point should never be +reached. + +* declare error: ++ +Pointcut ++ +: ++ +String ++ +; +* declare warning: ++ +Pointcut ++ +: ++ +String ++ +; + +If the compiler determines that a join point in could +possibly be reached, then it will signal either an error or warning, as +declared, using the for its message. + +==== Softened exceptions + +An aspect may specify that a particular kind of exception, if thrown at +a join point, should bypass Java's usual static exception checking +system and instead be thrown as a `org.aspectj.lang.SoftException`, +which is subtype of `RuntimeException` and thus does not need to be +declared. + +* declare soft: ++ +Type ++ +: ++ +Pointcut ++ +; + +For example, the aspect + +.... +aspect A { + declare soft: Exception: execution(void main(String[] args)); +} +.... + +Would, at the execution join point, catch any `Exception` and rethrow a +`org.aspectj.lang.SoftException` containing original exception. + +This is similar to what the following advice would do + +.... +aspect A { + void around() execution(void main(String[] args)) { + try { proceed(); } + catch (Exception e) { + throw new org.aspectj.lang.SoftException(e); + } + } +} +.... + +except, in addition to wrapping the exception, it also affects Java's +static exception checking mechanism. + +Like advice, the declare soft form has no effect in an abstract aspect +that is not extended by a concreate aspect. So the following code will +not compile unless it is compiled with an extending concrete aspect: + +.... +abstract aspect A { + abstract pointcut softeningPC(); + + before() : softeningPC() { + Class.forName("FooClass"); // error: uncaught ClassNotFoundException + } + + declare soft : ClassNotFoundException : call(* Class.*(..)); +} +.... + +[[advice-precedence-cross]] +==== Advice Precedence + +An aspect may declare a precedence relationship between concrete aspects +with the `declare precedence` form: + +* declare precedence : ++ +TypePatternList ++ +; + +This signifies that if any join point has advice from two concrete +aspects matched by some pattern in , then the +precedence of the advice will be the order of in the list. + +In , the wildcard "*" can appear at most once, and it +means "any type not matched by any other pattern in the list". + +For example, the constraints that (1) aspects that have Security as part +of their name should have precedence over all other aspects, and (2) the +Logging aspect (and any aspect that extends it) should have precedence +over all non-security aspects, can be expressed by: + +.... +declare precedence: *..*Security*, Logging+, *; +.... + +For another example, the CountEntry aspect might want to count the entry +to methods in the current package accepting a Type object as its first +argument. However, it should count all entries, even those that the +aspect DisallowNulls causes to throw exceptions. This can be +accomplished by stating that CountEntry has precedence over +DisallowNulls. This declaration could be in either aspect, or in +another, ordering aspect: + +.... +aspect Ordering { + declare precedence: CountEntry, DisallowNulls; +} +aspect DisallowNulls { + pointcut allTypeMethods(Type obj): call(* *(..)) && args(obj, ..); + before(Type obj): allTypeMethods(obj) { + if (obj == null) throw new RuntimeException(); + } +} +aspect CountEntry { + pointcut allTypeMethods(Type obj): call(* *(..)) && args(obj, ..); + static int count = 0; + before(): allTypeMethods(Type) { + count++; + } +} +.... + +===== Various cycles + +It is an error for any aspect to be matched by more than one TypePattern +in a single decare precedence, so: + +.... +declare precedence: A, B, A ; // error +.... + +However, multiple declare precedence forms may legally have this kind of +circularity. For example, each of these declare precedence is perfectly +legal: + +.... +declare precedence: B, A; +declare precedence: A, B; +.... + +And a system in which both constraints are active may also be legal, so +long as advice from A and B don't share a join point. So this is an +idiom that can be used to enforce that A and B are strongly independent. + +===== Applies to concrete aspects + +Consider the following library aspects: + +.... +abstract aspect Logging { + abstract pointcut logged(); + + before(): logged() { + System.err.println("thisJoinPoint: " + thisJoinPoint); + } +} + +abstract aspect MyProfiling { + abstract pointcut profiled(); + + Object around(): profiled() { + long beforeTime = System.currentTimeMillis(); + try { + return proceed(); + } finally { + long afterTime = System.currentTimeMillis(); + addToProfile(thisJoinPointStaticPart, + afterTime - beforeTime); + } + } + abstract void addToProfile( + org.aspectj.JoinPoint.StaticPart jp, + long elapsed); +} +.... + +In order to use either aspect, they must be extended with concrete +aspects, say, MyLogging and MyProfiling. Because advice only applies +from concrete aspects, the declare precedence form only matters when +declaring precedence with concrete aspects. So + +.... +declare precedence: Logging, Profiling; +.... + +has no effect, but both + +.... +declare precedence: MyLogging, MyProfiling; +declare precedence: Logging+, Profiling+; +.... + +are meaningful. + +==== Statically determinable pointcuts + +Pointcuts that appear inside of `declare` forms have certain +restrictions. Like other pointcuts, these pick out join points, but they +do so in a way that is statically determinable. + +Consequently, such pointcuts may not include, directly or indirectly +(through user-defined pointcut declarations) pointcuts that discriminate +based on dynamic (runtime) context. Therefore, such pointcuts may not be +defined in terms of + +* cflow +* cflowbelow +* this +* target +* args +* if + +all of which can discriminate on runtime information. + +[[semantics-aspects]] +=== Aspects + +An aspect is a crosscutting type defined by the `aspect` declaration. + +==== Aspect Declaration + +The `aspect` declaration is similar to the `class` declaration in that +it defines a type and an implementation for that type. It differs in a +number of ways: + +===== Aspect implementation can cut across other types + +In addition to normal Java class declarations such as methods and +fields, aspect declarations can include AspectJ declarations such as +advice, pointcuts, and inter-type declarations. Thus, aspects contain +implementation declarations that can can cut across other types +(including those defined by other aspect declarations). + +===== Aspects are not directly instantiated + +Aspects are not directly instantiated with a new expression, with +cloning, or with serialization. Aspects may have one constructor +definition, but if so it must be of a constructor taking no arguments +and throwing no checked exceptions. + +===== Nested aspects must be `static` + +Aspects may be defined either at the package level, or as a static +nested aspect -- that is, a static member of a class, interface, or +aspect. If it is not at the package level, the aspect _must_ be defined +with the static keyword. Local and anonymous aspects are not allowed. + +==== Aspect Extension + +To support abstraction and composition of crosscutting concerns, aspects +can be extended in much the same way that classes can. Aspect extension +adds some new rules, though. + +===== Aspects may extend classes and implement interfaces + +An aspect, abstract or concrete, may extend a class and may implement a +set of interfaces. Extending a class does not provide the ability to +instantiate the aspect with a new expression: The aspect may still only +define a null constructor. + +===== Classes may not extend aspects + +It is an error for a class to extend or implement an aspect. + +===== Aspects extending aspects + +Aspects may extend other aspects, in which case not only are fields and +methods inherited but so are pointcuts. However, aspects may only extend +abstract aspects. It is an error for a concrete aspect to extend another +concrete aspect. + +==== Aspect instantiation + +Unlike class expressions, aspects are not instantiated with `new` +expressions. Rather, aspect instances are automatically created to cut +across programs. A program can get a reference to an aspect instance +using the static method `aspectOf(..)`. + +Because advice only runs in the context of an aspect instance, aspect +instantiation indirectly controls when advice runs. + +The criteria used to determine how an aspect is instantiated is +inherited from its parent aspect. If the aspect has no parent aspect, +then by default the aspect is a singleton aspect. How an aspect is +instantiated controls the form of the `aspectOf(..)` method defined on +the concrete aspect class. + +===== Singleton Aspects + +* aspect ++ +Id ++ +\{ ... } +* aspect ++ +Id ++ +issingleton() \{ ... } + +By default (or by using the modifier `issingleton()`) an aspect has +exactly one instance that cuts across the entire program. That instance +is available at any time during program execution from the static method +`aspectOf()` automatically defined on all concrete aspects -- so, in the +above examples, `A.aspectOf()` will return A's instance. This aspect +instance is created as the aspect's classfile is loaded. + +Because the an instance of the aspect exists at all join points in the +running of a program (once its class is loaded), its advice will have a +chance to run at all such join points. + +(In actuality, one instance of the aspect A is made for each version of +the aspect A, so there will be one instantiation for each time A is +loaded by a different classloader.) + +===== Per-object aspects + +* aspect ++ +Id ++ +perthis( ++ +Pointcut ++ +) \{ ... } +* aspect ++ +Id ++ +pertarget( ++ +Pointcut ++ +) \{ ... } + +If an aspect A is defined `perthis(Pointcut)`, then one object of type A +is created for every object that is the executing object (i.e., "this") +at any of the join points picked out by . The advice defined +in A will run only at a join point where the currently executing object +has been associated with an instance of A. + +Similarly, if an aspect A is defined `pertarget(Pointcut)`, then one +object of type A is created for every object that is the target object +of the join points picked out by . The advice defined in A +will run only at a join point where the target object has been +associated with an instance of A. + +In either case, the static method call `A.aspectOf(Object)` can be used +to get the aspect instance (of type A) registered with the object. Each +aspect instance is created as early as possible, but not before reaching +a join point picked out by where there is no associated +aspect of type A. + +Both `perthis` and `pertarget` aspects may be affected by code the +AspectJ compiler controls, as discussed in the xref:#implementation[???] +appendix. + +===== Per-control-flow aspects + +* aspect ++ +Id ++ +percflow( ++ +Pointcut ++ +) \{ ... } +* aspect ++ +Id ++ +percflowbelow( ++ +Pointcut ++ +) \{ ... } + +If an aspect A is defined `percflow(Pointcut)` or +`percflowbelow(Pointcut)`, then one object of type A is created for each +flow of control of the join points picked out by , either as +the flow of control is entered, or below the flow of control, +respectively. The advice defined in A may run at any join point in or +under that control flow. During each such flow of control, the static +method `A.aspectOf()` will return an object of type A. An instance of +the aspect is created upon entry into each such control flow. + +===== Aspect instantiation and advice + +All advice runs in the context of an aspect instance, but it is possible +to write a piece of advice with a pointcut that picks out a join point +that must occur before asopect instantiation. For example: + +.... +public class Client +{ + public static void main(String[] args) { + Client c = new Client(); + } +} + +aspect Watchcall { + pointcut myConstructor(): execution(new(..)); + + before(): myConstructor() { + System.err.println("Entering Constructor"); + } +} +.... + +The before advice should run before the execution of all constructors in +the system. It must run in the context of an instance of the Watchcall +aspect. The only way to get such an instance is to have Watchcall's +default constructor execute. But before that executes, we need to run +the before advice... + +There is no general way to detect these kinds of circularities at +compile time. If advice runs before its aspect is instantiated, AspectJ +will throw a +xref:../api/org/aspectj/lang/NoAspectBoundException.html[`org.aspectj.lang.NoAspectBoundException`]. + +==== Aspect privilege + +* privileged aspect ++ +Id ++ +\{ ... } + +Code written in aspects is subject to the same access control rules as +Java code when referring to members of classes or aspects. So, for +example, code written in an aspect may not refer to members with default +(package-protected) visibility unless the aspect is defined in the same +package. + +While these restrictions are suitable for many aspects, there may be +some aspects in which advice or inter-type members needs to access +private or protected resources of other types. To allow this, aspects +may be declared `privileged`. Code in priviliged aspects has access to +all members, even private ones. + +.... +class C { + private int i = 0; + void incI(int x) { i = i+x; } +} +privileged aspect A { + static final int MAX = 1000; + before(int x, C c): call(void C.incI(int)) && target(c) && args(x) { + if (c.i+x > MAX) throw new RuntimeException(); + } +} +.... + +In this case, if A had not been declared privileged, the field reference +c.i would have resulted in an error signaled by the compiler. + +If a privileged aspect can access multiple versions of a particular +member, then those that it could see if it were not privileged take +precedence. For example, in the code + +.... +class C { + private int i = 0; + void foo() { } +} + +privileged aspect A { + private int C.i = 999; + before(C c): call(void C.foo()) target(c) { + System.out.println(c.i); + } +} +.... + +A's private inter-type field C.i, initially bound to 999, will be +referenced in the body of the advice in preference to C's privately +declared field, since the A would have access to its own inter-type +fields even if it were not privileged. + +Note that a privileged aspect can access private inter-type declarations +made by other aspects, since they are simply considered private members +of that other aspect. diff --git a/docs/readme-docs-module.adoc b/docs/readme-docs-module.adoc new file mode 100644 index 000000000..6eda74250 --- /dev/null +++ b/docs/readme-docs-module.adoc @@ -0,0 +1,117 @@ += AspectJ docs + +== Contents and build + +This module contains the sources for the documentation delivered with +the AspectJ distribution and for various internal, teaching, and online +works: + +* `devGuideDB`: DocBook sources for the AspectJ Development Environment Guide +* `progGuideDB`: DocBook sources for the AspectJ Programming Language Guide +* `faq`: DocBook sources for the AspectJ Frequently Asked Questions +* `sandbox`: a collection of sample AspectJ programs, tools built on the + AspectJ API's, script snippets, and instructional trails, all intended + to serve as sources for documentation. See xref:sandbox/readme-sandbox.adoc[]. +* `teaching`: Teaching materials, esp. for the AspectJ tutorials. +* `quick.doc`: The Microsoft Word source file for the .pdf Quick Reference + guides `dist/doc/quick.pdf` and `dist/doc/quickA4.pdf`. +* `build.xml`: Ant build script for the doc distribution +* `developer`: Docs for AspectJ developers + +*Build*: `build.xml` assembles a local distribution which is gathered +into the product distribution by the master build script, +`../build/build.xml`. Dependencies outside this directory: + +* `.xml` files refer to their docbook dtds using relative path, for the + moment `../../lib/docbook/...` +* When building docbook, uses `../lib/saxon` libraries. +* When building installer, using `../lib/build/build.jar` and the + `../build/installer-resources`. +* `dist/doc/quick.pdf` is generated manually from `quick.doc`. +* `../org.aspectj.lib` provides library sources for + `{AspectJ}/doc/aspectjlib`. + +When editing the build script and XML files, try to make only +substantive changes rather than reformatting, which produces illusory +changes. If you do reformat, do so programmatically (e.g., using +XMLBuddy plugin reformat command, with long lines wrapped and 80 +character lines). + +== Docbook notes + +#*TODO:* Remove this section after AsciiDoc conversion is complete# + +Documentation is written in docbook XML form, which is transformed to +HTML (single-page and multi-page forms) and, potentially, PDF. +Unfortunately, this means you need to use the tags which are not only +legal, but which work when transformed into all output formats, even if +it means working around bugs in the transform scripts. Following are +some notes on traps to avoid. + +=== Authoring support + +XMLBuddy has a free eclipse plugin that displays errors using problem +items and gutter annotations, but it gets confused by entity references. +So for devguide.xml, create a new file foo.xml and do a manual merge, +correct the files, and then scatter again (leo?). + +=== PDF transformation + +The transformation from docbook XML to formatting-objects (.fo) +to pdf is fairly weak. If you run the build.xml `test-pdf` task, +you'll see a number of debug messages, which unfortunately give no +clue as to the location of the problem. Problems noted in the output +(where DE == docbook element) + +* tables broken. +** DE `table` unsupported +** DE `informaltable` autolayout is not supported +* lineation/justification broken +* need things like page header/footer titles, page number, copyright +* Valid docbook elements not supported: +** superscript in title +* ... + +Sample debug messages: + +- `area contents overflows area in line` +- `table-layout=auto is not supported, using fixed!` +- `The element 'fo:table-and-caption' is not yet implemented.` + (So use docbook element (DE) `informaltable`, not DE `table`.) +- `No spaces to justify text in line` many times + +== Older notes + +=== Misc info for writing and building docbook + +* link tag linkend attribute takes an id +** xsl converts as needed during output +** do NOT use `ulink`; this will be converted to `""` + (but see param `citerefentry-link`: might enable this) + +* to use sensible names for the files produced, +** use an xsl wrapper to add/modify features +** set flag to use the id of the top-level element in the output + file as the filename. + + `xsl:param name="use.id.as.filename" select="1"` +** fyi, other related parameters: `html-ext`, `root-filename` +** In this example, the top-level element in the output file + is the `refentry`, so set ids which become the basename of the file: + ++ + refentry id="aspectj-mode" # in aspectj-mode.xml, produces aspecj-mode.html + refentry id="ajdee" # in ajdee.xml, produces ajdee.html + +** related parameters: `html-ext`, `root-filename` +** these tags did not work for me: `dbhtml filename="foo.htm"`, `dbhtml prefix="foo-"` + +== Resources + +- the dtd reference for docbook + http://www.oreilly.com/catalog/docbook/chapter/book/docbook.html +- the stylesheet reference for docbook xsl + http://docbook.sourceforge.net/projects/dsssl/doc/html.html + +== To Do + +- fyi, generate.reference.titlepage appears not to be respected. + tried to add if statement to html/refentry.xsl, but file still gen'd diff --git a/docs/readme-docs-module.html b/docs/readme-docs-module.html deleted file mode 100644 index 53451ec71..000000000 --- a/docs/readme-docs-module.html +++ /dev/null @@ -1,148 +0,0 @@ - -AspectJ docs - -

AspectJ docs

-

Contents and build

-

-This module contains the sources for the documentation -delivered with the AspectJ distribution and -for various internal, teaching, and online works: -

-
    -
  • devGuideDB: DocBook sources - for the AspectJ Development Environment Guide
    • - -
  • progGuideDB: DocBook sources - for the AspectJ Programming Language Guide
    • - -
  • faq: DocBook sources - for the AspectJ Frequently Asked Questions
    • - -
  • sandbox: a collection of sample - AspectJ programs, tools built on the AspectJ API's, - script snippets, and instructional trails, all intended - to serve as sources for documentation. - See - sandbox/readme-sandbox.html
    • - -
  • teaching: Teaching materials, esp. - for the AspectJ tutorials.
    • - -
  • quick.doc: The Microsoft Word - source file for the .pdf Quick Reference guides - dist/doc/quick.pdf and - dist/doc/quickA4.pdf.
    • - -
  • build.xml: Ant build script for - the doc distribution
    • - -
  • developer: Docs for AspectJ developers. - See the overview.html
    • -
- -

-Build: build.xml assembles a local -distribution which is gathered into the product distribution by -the master build script, -../build/build.xml. -Dependencies outside this directory: -

-
    -
  • .xml files refer to their docbook dtds using relative - path, for the moment ../../lib/docbook/... -
    • -
  • When building docbook, uses ../lib/saxon libraries. -
    • -
  • When building installer, using ../lib/build/build.jar - and the ../build/installer-resources. -
    • -
  • dist/doc/quick.pdf - is generated manually from quick.doc. -
    • -
  • ../org.aspectj.lib - provides library sources for {AspectJ}/doc/aspectjlib. -
    • -
-

-When editing the build script and XML files, try to make only substantive -changes rather than reformatting, which produces illusory changes. If you -do reformat, do so programmatically (e.g., using XMLBuddy plugin reformat -command, with long lines wrapped and 80 character lines). -

-

Docbook notes

-

-Documentation is written in docbook XML form, which is transformed to HTML -(single-page and multi-page forms) and, potentially, PDF. Unfortunately, -this means you need to use the tags which are not only legal, but which -work when transformed into all output formats, even if it means working -around bugs in the transform scripts. Following are some notes on traps -to avoid. -

-
----------------------------------------------- authoring support
-XMLBuddy has a free eclipse plugin that displays errors using problem
-items and gutter annotations, but it gets confused by entity references.
-So for devguide.xml, create a new file foo.xml and do a manual merge,
-correct the files, and then scatter again (leo?).
-
----------------------------------------------- PDF transformation
-The transformation from docbook XML to formatting-objects (.fo) 
-to pdf is fairly weak.  If you run the build.xml test-pdf task,
-you'll see a number of debug messages, which unfortunately give no
-clue as to the location of the problem.  Problems noted in the output
-(where DE == docbook element)
-
-- tables broken.  
-  - DE "table" unsupported 
-  - DE "informaltable" autolayout is not supported
-
-- lineation/justification broken
-
-- need things like page header/footer titles, page number, copyright
-- Valid docbook elements not supported:
-  - superscript in title
-  ...
-  
-sample debug messages:
-- "area contents overflows area in line"
-- "table-layout=auto is not supported, using fixed!"
-- "The element 'fo:table-and-caption' is not yet implemented."
-  (so use docbook element (DE) informaltable, not DE table)
-- many "No spaces to justify text in line"
-
----------------------------------------------- older notes
----- misc info for writing and building docbook
-- link tag linkend attribute takes an id 
-  - xsl converts as needed during output
-  - do NOT use ulink; this will be converted to ""
-    (but see param citerefentry-link: might enable this)
-
-- to use sensible names for the files produced, 
-  - use an xsl wrapper to add/modify features
-  - set flag to use the id of the top-level element in the output
-    file as the filename.  
-    xsl:param name="use.id.as.filename" select="1"
-  - fyi, other related parameters: html-ext, root-filename
-  - In this example, the top-level element in the output file
-    is the refentry, so set ids which become the basename of the file:
-    refentry id="aspectj-mode"          # in aspectj-mode.xml, produces aspecj-mode.html
-    refentry id="ajdee"                 # in ajdee.xml, produces ajdee.html
-
--- fyi
-- related parameters: 
-  html-ext, root-filename
-- these tags did not work for me:
- dbhtml filename="foo.htm"
- dbhtml prefix="foo-"
-
-- resources 
-  - the dtd reference for docbook
-    http://www.oreilly.com/catalog/docbook/chapter/book/docbook.html
-  - the stylesheet reference for docbook xsl
-    http://docbook.sourceforge.net/projects/dsssl/doc/html.html
-- todo
-  - fyi, generate.reference.titlepage appears not to be respected.
-    tried to add if statement to html/refentry.xsl, but file still gen'd
-
- - diff --git a/docs/sandbox/api-clients/readme.html b/docs/sandbox/api-clients/readme.html deleted file mode 100644 index e69de29bb..000000000 diff --git a/docs/sandbox/readme-sandbox.adoc b/docs/sandbox/readme-sandbox.adoc new file mode 100644 index 000000000..8d796128a --- /dev/null +++ b/docs/sandbox/readme-sandbox.adoc @@ -0,0 +1,163 @@ += AspectJ sandbox for sample code and instructions + +This directory is a place to put scraps that might end up in the AspectJ +documentation or on the web site: + +* sample code for AspectJ programs, +* sample code for extensions to AspectJ tools and API's, +* sample scripts for invoking AspectJ tools, and +* documentation trails showing how to do given tasks using AspectJ, + AJDT or various IDE or deployment environments. + +== General + +In the past, we found it tedious to keep and verify sample code used in +documentation because it involves copying the code from the +documentation into a form that can be tested (or vice versa). Further, +there are a lot of tips and sample code contributed on the mailing +lists, but they can be difficult to find when needed. This aims to be a +place where such contributions can be gathered, kept in good order, and +extracted for use in docs, without too much overhead. + +Code in the sandbox is kept in a running state; it's tested by running +the harness on the sandbox test suite file sandbox-test.xml or +sandbox-api-test.xml. To extract the code for documentation, we use a +tool that recognizes a sample within a source file if it has comments +signalling the start and end of the sample. Keeping sample code in sync +with the documentation and with the test suite specification only takes +a bit of care with formatting and comments. The rest of this document +tells how. + +== Documenting samples + +`org.aspectj.internal.tools.build.SampleGatherer` (in the build module) +extracts samples of the following form from any "source" file (currently +source, html, text, and shell scripts): + +.... +... some text, possibly including @author tags +{comment} START-SAMPLE [anchorName] [anchor title] {end-comment} +... sample code ... +{comment} END-SAMPLE [anchorName] {end-comment} +... more text ... +.... + +Each sample extracted consists of the code and associated attributes: +the source location, the anchor name and title, any text flagged with +XXX, and the author pulled from the closest-preceding `@author` tag. (If +there is no author, the AspectJ team is presumed.) `SampleGatherer` can +render the collected samples back out to HTML (todo: or DocBook) for +inclusion in the FAQ, the online samples, the Programming Guide, etc. An +editor might reorder or annotate the samples but the code should not be +edited to avoid introducing mistakes. + +To help keep the sample code in sync with the docs... + +* Use comments in the sample to explain the code, rather than describing +it in the documentation. +* Preformat samples to be included without modification in docs: +** Use 4 spaces rather than a tab for each indent. +** Keep lines short - 60 characters or less. +** In Java, code taken out of context of the defining type can be +indented only once in the source code, even though they might normally +be indented more. +** In AspectJ, indent advice pointcuts beyond the block code: ++ +.... +before() : call(!public * com.company.library..*.*(String,..)) + && within(Runnable+) { // indent once more than code + // code here +} +.... + +Where you put the sample code depends on how big it is and what it's +for. Any code intended as an extension to the AspectJ tools goes in the +link:api-clients[api-clients/] directory. Most code will instead be +samples of AspectJ programs. Subdirectories of this directory should be +the base directories of different source sets. The link:common[common/] +directory should work for most code snippets, but standalone, +self-consistent code belongs in its own directory, as do sets pertaining +to particular publications or tutorials. An example of this are the +sources for the "Test Inoculated" article in the +link:inoculated[inoculated/] directory. Finally, the +link:testsrc[testsrc/] directory is reserved for code used to test the +other code in the sandbox. There should be no samples under testsrc. + +== Testing samples + +We try to make sure that the samples we present to people actually work +by testing each kind differently: + +* Most Java and AspectJ programs are tested using sandbox-test.xml. +* API clients are tested using sandbox-api-test.xml, which requires +building `aspectjtools.jar`. +* Shell and Ant scripts should be run per instructions. +* HTML and text files must be manually reviewed. + +When adding Java or AspectJ code, add a corresponding test case in +sandbox-test.xml. This file has the same format as other harness test +suites; for more information, see +../../tests/readme-writing-compiler-tests.html. The test suite should +run and pass after new code is added and before samples are extracted. + +To keep Java/AspectJ code in sync with the tests: + +* The test title should be prefixed with the anchor name and have any +suffixes necessary for clarity and to make sure there are unique titles +for each test. E.g., for a sample with the anchor +"`language-initialization`", ++ +.... + + ... + +.... ++ +(Someday we'll be able to compare the test titles with the anchor names +to verify that the titles contain all the anchor names.) +* Avoid mixing compiler-error tests with ordinary code, so others can +reuse the target code in their samples. Most of the sample code should +compile. +* Any code that is supposed to trigger a compiler error should be tested +by verifying that the error message is produced, checking either or both +of the line number and the message text. E.g., ++ +.... + + +.... ++ +Where a test case refers to a line number, we have to keep the expected +message and the target code in sync. You can help with this by adding a +comment in the target code so people editing the code know not to fix or +move the code. E.g., ++ +.... +void spawn() { + new Thread(this, toString()).start(); // KEEP CE 15 declares-factory +} +.... ++ +Any good comment could work, but here are some optional conventions: +** Use "CE" or "CW" for compiler error or warning, respectively. +** Specify the line number, if one is expected. +** Specify the affected test title(s) or sample code anchor label to +make it easier to find the test that will break if the code is modified. +(The editor can also run the tests to find any broken ones.) + +If the code is broken (e.g., if it no longer works in the latest version +of AspectJ), then prefix SAMPLE with BROKEN in the tag: + +.... +{comment} START-BROKEN-SAMPLE ... +... sample code ... +{comment} END-BROKEN-SAMPLE ... +... more text ... +.... + +It will no longer be gathered, but can be fixed and reinstated. + +Happy coding! diff --git a/docs/sandbox/readme-sandbox.html b/docs/sandbox/readme-sandbox.html deleted file mode 100644 index e83539882..000000000 --- a/docs/sandbox/readme-sandbox.html +++ /dev/null @@ -1,228 +0,0 @@ - -README - AspectJ sandbox for sample code and instructions - -

README - AspectJ sandbox for sample code and instructions

-This directory is a place to put scraps that might end up in the -AspectJ documentation or on the web site: -
    -
  • sample code for AspectJ programs, -
    • -
  • sample code for extensions to AspectJ tools and API's, -
    • -
  • sample scripts for invoking AspectJ tools, and -
    • -
  • documentation trails showing how to do given tasks - using AspectJ, AJDT, or various IDE or deployment - environments. -
    • -
-In the past, we found it tedious to keep and verify -sample code used in documentation because it involves -copying the code from the documentation -into a form that can be tested (or vice versa). -Further, there are a lot of tips and sample code -contributed on the mailing lists, but they can be -difficult to find when needed. This aims to be -a place where such contributions can be gathered, -kept in good order, and extracted for use in docs, -without too much overhead. - -

-Code in the sandbox is kept in a running state; -it's tested by running the harness on the sandbox -test suite file - sandbox-test.xml -or - sandbox-api-test.xml. - -To extract the code for documentation, we use a tool -that recognizes -a sample within a source file if it has comments -signalling the start and end of the sample. -Keeping sample code in sync with the documentation -and with the test suite specification only takes -a bit of care with formatting and comments. -The rest of this document tells how. - -

Documenting samples

-

org.aspectj.internal.tools.build.SampleGatherer -(in the build module) extracts samples -of the following form from any "source" file -(currently source, html, text, and shell scripts): - -

-  ... some text, possibly including @author tags
-  {comment} START-SAMPLE [anchorName] [anchor title] {end-comment}
-  ... sample code ...
-  {comment} END-SAMPLE [anchorName] {end-comment}
-  ... more text ...
-
- -

-Each sample extracted consists of the code and associated -attributes: the source location, the anchor name -and title, any text flagged with XXX, -and the author pulled from the closest-preceding -@author tag. (If there is no author, -the AspectJ team is presumed.) - -SampleGatherer can render the collected -samples back out to HTML (todo: or DocBook) for -inclusion in the FAQ, the online -samples, the Programming Guide, etc. -An editor might reorder or annotate the samples -but the code should not be edited -to avoid introducing mistakes. - -

To help keep the sample code in sync with the docs... -

    -
  • Use comments in the sample to explain the code, - rather than describing it in the documentation. -
    • -
  • Preformat samples to be included without modification - in docs: -
      -
    • Use 4 spaces rather than a tab for each indent. -
      • -
    • Keep lines short - 60 characters or less. -
      • -
    • In Java, code taken out of context of the defining type - can be indented only once in the source code, - even though they might normally be indented more. -
      • -
    • In AspectJ, indent advice pointcuts beyond the block code: -
      -    before() : call(!public * com.company.library..*.*(String,..))
-           && within(Runnable+) { // indent once more than code
-        // code here
-    }
-
      -
      • -
    -
    • -
- -

-Where you put the sample code depends on how big it is -and what it's for. Any code intended as an extension to -the AspectJ tools goes in the api-clients/ -directory. -Most code will instead be samples of AspectJ programs. -Subdirectories of this directory should be the base directories of -different source sets. - -The common/ directory should work for -most code snippets, but standalone, self-consistent code -belongs in its own directory, -as do sets pertaining to particular publications or tutorials. -An example of this are the sources for the "Test Inoculated" -article in the inoculated/ directory. -Finally, the testsrc/ directory is reserved for -code used to test the other code in the sandbox. There should -be no samples under testsrc. - -

Testing samples

-We try to make sure that the samples we present to people -actually work by testing each kind differently: -
    -
  • Most Java and AspectJ programs are tested using - sandbox-test.xml. -
    • -
  • API clients are tested using - sandbox-api-test.xml, -which requires building aspectjtools.jar. -
    • -
  • Shell and Ant scripts should be run per instructions. -
    • -
  • HTML and text files must be manually reviewed. -
    • -
- -When adding Java or AspectJ code, add a corresponding test case -in sandbox-test.xml. -This file has the same format as other harness test suites; -for more information, -see -../../tests/readme-writing-compiler-tests.html. - -The test suite should run and pass after new code is added -and before samples are extracted. - -

To keep Java/AspectJ code in sync with the tests: -

    -
  • The test title should be prefixed with the anchor name and - have any suffixes necessary for clarity and to make sure - there are unique titles for each test. - E.g., for a sample with the anchor - "language-initialization", - 
    -    <ajc-test 
-        dir="common" 
-        title="language-initialization constructor-call example">
-        ...
-    </ajc-test> 
-
    - (Someday we'll be able to compare the test titles with - the anchor names to verify that the titles contain - all the anchor names.) -

    • -
  • Avoid mixing compiler-error tests with ordinary code, - so others can reuse the target code in their samples. - Most of the sample code should compile. -

    • -
  • Any code that is supposed to trigger a compiler error - should be tested by verifying that the error message - is produced, checking either or both of the line number - and the message text. E.g., -
    -    <compile files="declares/Declares.java, {others}"
-        <message kind="error" line="15" text="Factory"/>
-    </compile>
-
    - Where a test case refers to a line number, - we have to keep the expected message - and the target code in sync. - You can help with this by adding a comment in the target code - so people editing the code know not to fix - or move the code. E.g., -
    -    void spawn() {        
-        new Thread(this, toString()).start(); // KEEP CE 15 declares-factory
-    }
-
    - Any good comment could work, but here are some optional conventions: -

    -

      -
    • Use "CE" or "CW" for compiler error or warning, respectively. -

      • -
    • Specify the line number, if one is expected. -

      • -
    • Specify the affected test title(s) or sample code anchor label - to make it easier to find the test that will break if the - code is modified. (The editor can also run the tests - to find any broken ones.) -

      -

      • -
    -
    • -
- -If the code is broken (e.g., if it no longer works in the latest -version of AspectJ), then prefix SAMPLE with BROKEN in the tag: - -
-  {comment} START-BROKEN-SAMPLE ...
-  ... sample code ...
-  {comment} END-BROKEN-SAMPLE ...
-  ... more text ...
-
- -It will no longer be gathered, but can be fixed and reinstated. - -

-Happy coding! -

- - - - diff --git a/docs/sandbox/trails/debugging.adoc b/docs/sandbox/trails/debugging.adoc new file mode 100644 index 000000000..944c48a23 --- /dev/null +++ b/docs/sandbox/trails/debugging.adoc @@ -0,0 +1,40 @@ += Debugging AspectJ Programs + +_Last updated: 2003-11-26 by wisberg_ + +== Debugging AspectJ 1.0 Programs + +The AspectJ 1.0 compiler produces .class files that have the normal +source file attribute and line information as well as the information +specified by JSR-045 required to debug .class files composed of multiple +source files. This permits the compiler to inline advice code into the +.class files of the target classes; the advice code in the target class +can have source attributes that point back to the aspect file. + +Support for JSR-45 varies. At the time of this writing, Sun's VM +supports it, but not some others, which means that the Sun VM must be +used as the runtime VM. Because the VM does all the work of associating +the source line with the code being debugged, debuggers should be able +to operate normally with AspectJ 1.0 source files even if they weren't +written with that in mind, if they use the correct API's to the +debugger. Unfortunately, some debuggers take shortcuts based on the +default case of one file per class in order to avoid having the VM +calculate the file suffix or package prefix. These debuggers do not +support JSR-45 and thus AspectJ. + +== Debugging AspectJ 1.1 Programs + +The AspectJ 1.1 compiler usually implements advice as call-backs to the +aspect, which means that most AspectJ programs do not require JSR-45 +support in order to be debugged. However, it does do a limited amount of +advice inlining; to avoid this, use the `-XnoInline` flag. + +Because inlined advice can be more efficient, we plan to support JSR-45 +as soon as feasible. This will require upgrading the BCEL library we use +to pass around the correct source attributes. + +Sometimes debuggers correctly get the source line information, but fail +when they attempt to parse AspectJ source files expected to contain Java +code. For these it might be possible to step into AspectJ code, but not +to set breakpoints, or to work around the parse errors by using `.aj` +rather than `.java` as a file extension. diff --git a/docs/sandbox/trails/debugging.html b/docs/sandbox/trails/debugging.html deleted file mode 100644 index b49cc79d8..000000000 --- a/docs/sandbox/trails/debugging.html +++ /dev/null @@ -1,67 +0,0 @@ - -Debugging AspectJ Programs - - -

Debugging AspectJ Programs -

-

Debugging AspectJ 1.0 Programs -

- - - -The AspectJ 1.0 compiler produces .class files that have the -normal source file attribute and line information as well -as the information specified by JSR-045 required to debug -.class files composed of multiple source files. -This permits the compiler to inline advice code -into the .class files of the target classes; -the advice code in the target class can have source -attributes that point back to the aspect file. - -

-Support for JSR-45 varies. -At the time of this writing, Sun's VM supports it, -but not some others, which means that the Sun VM -must be used as the runtime VM. - -Because the VM does all the work of associating the -source line with the code being debugged, -debuggers should be able to operate normally with -AspectJ 1.0 source files even if they weren't written -with that in mind, if they use the correct -API's to the debugger. Unfortunately, some debuggers -take shortcuts based on the default case of one file -per class in order to avoid having the VM calculate -the file suffix or package prefix. These debuggers -do not support JSR-45 and thus AspectJ. - - - -

Debugging AspectJ 1.1 Programs -

- - -The AspectJ 1.1 compiler usually implements advice as -call-backs to the aspect, which means that most -AspectJ programs do not require JSR-45 support in -order to be debugged. However, it does do a limited -amount of advice inlining; to avoid this, use the --XnoInline flag. -

-Because inlined advice can be more efficient, we -plan to support JSR-45 as soon as feasible. -This will require upgrading the BCEL library we -use to pass around the correct source attributes. - -

-Sometimes debuggers correctly get the source line information, -but fail when they attempt to parse AspectJ source files -expected to contain Java code. For these it might be possible -to step into AspectJ code, but not to set breakpoints, or to -work around the parse errors by using .aj rather -than .java as a file extension. - - - - - diff --git a/docs/sandbox/trails/j2ee.adoc b/docs/sandbox/trails/j2ee.adoc new file mode 100644 index 000000000..2697175f0 --- /dev/null +++ b/docs/sandbox/trails/j2ee.adoc @@ -0,0 +1,58 @@ += Using AspectJ in servlets + +_Last updated: 2003-09-27 by wisberg_ + +This contains short notes on using AspectJ with various J2EE servers and +deployment tools. + +== Generally + +AspectJ programs work if run in the same namespace and with +aspectjrt.jar. Servlet runners and J2EE web containers should run +AspectJ programs fine if the classes and required libraries are deployed +as usual. As with any shared library, if more than one application is +using AspectJ, then the aspectjrt.jar should be deployed where it will +be loaded by a common classloader. The same is true of any shared +aspects. + +== Running AspectJ servlets in Tomcat 4.x + +In Tomcat, you can deploy application servlets in WAR's or in exploded +web directories and share code across applications. + +. Use `ajc` to compile the servlets, and deploy the classes as usual + into `{WebRoot}/WEB-INF/classes`. +. If your web applications or aspects do not interact, deploy + `aspectjrt.jar` into `{WebRoot}/WEB-INF/lib`. +. If your web applications or aspects might interact, deploy them to +`${CATALINA_BASE}/shared/lib`. + +Tomcat 4.x uses the Jasper engine based on Ant to compile JSP's. To set +up ajc as the compiler, do the following before starting Tomcat: + +. Put `aspectjtools.jar` in `${CATALINA_HOME}/common/lib` so that it can + be loaded by Jasper. + +. Update Jasper servlet parameters in `${CATALINA_HOME}/conf/web.xml` to + tell Ant to use `ajc` by setting the compiler property to the AspectJ + compiler adapter: ++ +.... + + jsp + org.apache.jasper.servlet.JspServlet + ... + + compiler + org.aspectj.tools.ant.taskdefs.Ajc11CompilerAdapter + +.... + +. The classpath is dynamically generated from the webapp deployment, so + `aspectjrt.jar` should be in `{webapp}/WEB-INF/lib` or some shared or + common directory supported by the server. + +. Alternatively, you can precompile JSP's using + xref:#j2ee-tomcat4-precompileJsp[this Ant script]. That involves + manually updating the `web.xml` file with the `Jasper`-generated servlet + mappings. diff --git a/docs/sandbox/trails/j2ee.html b/docs/sandbox/trails/j2ee.html deleted file mode 100644 index 804f43431..000000000 --- a/docs/sandbox/trails/j2ee.html +++ /dev/null @@ -1,82 +0,0 @@ - - - -This contains short notes on using AspectJ with various J2EE -servers and deployment tools. - - - -

Using AspectJ in servlets

-

Generally

- -AspectJ programs work if run in the same namespace and with aspectjrt.jar. -Servlet runners and J2EE web containers should run AspectJ programs fine -if the classes and required libraries are deployed as usual. - -As with any shared library, if more than one application is using AspectJ, -then the aspectjrt.jar should be deployed where it will be loaded by a -common classloader. The same is true of any shared aspects. - - - -

Running AspectJ servlets in Tomcat 4.x

- - -In Tomcat, you can deploy application servlets in WAR's -or in exploded web directories and share code across -applications. -
    -
  1. Use ajc to compile the servlets, - and deploy the classes as usual into - {WebRoot}/WEB-INF/classes. -
    2. - -
  2. If your web applications or aspects do not interact, deploy - aspectjrt.jar into - {WebRoot}/WEB-INF/lib. -
    3. -
  3. If your web applications or aspects might interact, deploy - them to ${CATALINA_BASE}/shared/lib. -
    4. -
- - - -Tomcat 4.x uses the Jasper engine based on Ant to compile JSP's. -To set up ajc as the compiler, do the following before starting Tomcat: -
    -
  1. Put aspectjtools.jar in -${CATALINA_HOME}/common/lib so that it can be loaded -by Jasper. -
    2. -
  2. Update Jasper servlet parameters in - ${CATALINA_HOME}/conf/web.xml to tell Ant to use - ajc by setting the compiler property to the - AspectJ compiler adapter: - 
    -    <servlet>
-        <servlet-name>jsp</servlet-name>
-        <servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class>
-        ...
-        <init-param>
-            <param-name>compiler</param-name>
-            <param-value>org.aspectj.tools.ant.taskdefs.Ajc11CompilerAdapter</param-value>
-        </init-param>
-
    -
    3. -
  3. The classpath is dynamically generated from the webapp deployment, -so aspectjrt.jar should be in -{webapp}/WEB-INF/lib or some shared or common -directory supported by the server. -
    4. - -
  4. Alternatively, you can precompile JSP's using -this Ant script. -That involves manually updating the web.xml file -with the Jasper-generated servlet mappings. -
    5. -
- - - - diff --git a/docs/sandbox/trails/links.adoc b/docs/sandbox/trails/links.adoc new file mode 100644 index 000000000..2dd9d6945 --- /dev/null +++ b/docs/sandbox/trails/links.adoc @@ -0,0 +1,39 @@ += Where to find AspectJ sample code + +_Last updated: 2004-04-19 by wisberg_ + +This contains links to other instances of AspectJ sample code. It +doesn't contain links to all articles that have AspectJ sample code, but +arguably it should. + +For a list of publications about AspectJ that might contain sample code, +see the publications link off the AspectJ web site at +http://eclipse.org/aspectj + +*"AspectJ in Action"* by Ramnivas Laddad has sample code including +four patterns: the worker object creation pattern, the exception +introduction pattern, the participant pattern, and the wormhole pattern. +Find the code at http://www.manning.com/laddad/. + +In the OOPSLA 2002 paper *"Design Pattern Implementation in Java and +AspectJ"*, Jan Hannemann and Gregor Kiczales discuss the implementation +in AspectJ of 23 of the traditional "gang of four" design patterns (from +the book "Design Patterns: elements of reusable object-oriented +software" by Gamma, Helm, Johnson, and Vlissides). Their paper and the +code for those patterns are available from +http://www.cs.ubc.ca/~jan/AODPs/. The code is also available from the +AspectJ web site as ubc-design-patterns.zip. The latest version is +checked into the CVS repository along with other sample code at +`org.aspectj/modules/docs/sandbox/ubc-design-patterns`. For instructions +on downloading code from the CVS repository, see the +doc/faq.html#q:buildingsource[FAQ entry "buildingsource"]. + +The https://atrack.dev.java.net/[*aTrack project*] aims to create an open +source bug tracking application that demonstrates use of Aspect-Oriented +Programming (AOP) with AspectJ. It uses AOP pragmatically to provide +systematic support for technical, middleware, and business concerns. + +The http://sourceforge.net/projects/cricketcage/[*CricketCage project*] +automatically creates JUnit TestCases for repeatable bugs and test +scenarios. Include Cricket Cage's AspectJ code to install a code +generator, then run the program to generate the TestCase. diff --git a/docs/sandbox/trails/links.html b/docs/sandbox/trails/links.html deleted file mode 100644 index a2990e751..000000000 --- a/docs/sandbox/trails/links.html +++ /dev/null @@ -1,90 +0,0 @@ - - ignore - - -This contains links to other instances of AspectJ sample code. -It doesn't contain links to all articles that have AspectJ -sample code, but arguably it should. - - - - - -

-For a list of publications about AspectJ that might contain -sample code, see the publications link off the AspectJ web site at - - http://eclipse.org/aspectj -

- -

- - - -AspectJ in Action by Ramnivas Laddad has sample code -including four patterns: -the worker object creation pattern, -the exception introduction pattern, -the participant pattern, -and the wormhole pattern. - -Find the code at - - http://www.manning.com/laddad/. -

- - -

- - - -In the OOPSLA 2002 paper - Design Pattern Implementation in Java and AspectJ -Jan Hannemann and Gregor Kiczales discuss the implementation in -AspectJ of 23 of the traditional "gang of four" design patterns -(from the book Design Patterns: elements of reusable object-oriented - software by Gamma, Helm, Johnson, and Vlissides). -Their paper and the code for those patterns are available from - - http://www.cs.ubc.ca/~jan/AODPs/ - . -The code is also available from the AspectJ web site - as ubc-design-patterns.zip. - The latest version is checked into the CVS repository along with - other sample code at - org.aspectj/modules/docs/sandbox/ubc-design-patterns. - For instructions on downloading code from the CVS repository, - see the FAQ entry "buildingsource". -

- - -

- - - -The aTrack project -aims to create an open source bug tracking application that -demonstrates use of Aspect-Oriented Programming (AOP) with AspectJ. -It uses AOP pragmatically to provide systematic support for -technical, middleware, and business concerns. -

- - -

- - -The -CricketCage project -automatically creates JUnit TestCases for repeatable bugs and test -scenarios. Include Cricket Cage's AspectJ code to install a code -generator, then run the program to generate the TestCase. - - -

- - diff --git a/docs/sandbox/trails/myeclipseide.adoc b/docs/sandbox/trails/myeclipseide.adoc new file mode 100644 index 000000000..b2eee0321 --- /dev/null +++ b/docs/sandbox/trails/myeclipseide.adoc @@ -0,0 +1,57 @@ += MyEclipseIde + +_Last updated: 2003-07-08 by wisberg_ + +MyEclipseIde (http://www.myeclipseide.com/[http://www.myeclipseide.com]) +aims to make it easy to develop J2EE applications using Eclipse. AJDT +(http://eclipse.org/ajdt) is an Eclipse plug-in that supports AspectJ. + +== Getting started + +* To install AJDT with MyEclipseIDE, direct the Eclipse update manager +to http://download.eclipse.org/technology/ajdt/dev/update, install the +plug-in, and follow any post-install instructions. +* To enable a project to use aspects, first select +`Convert to AspectJ project` from the project's context menu (select +project, right click). (XXX Bug: AJDT reverts perspective to Java; go +back to MyEclipseIDE) Note that you must convert each project; +converting the master J2EE project will not affect the child components +(XXX RFE: option to convert child if parent). +* To build, select the menu item `Project > Rebuild Project`. AJDT +creates `default.lst` which lists all source files and compiles them. +You can also recompile by clicking the AJDT build button. (XXX Bug: only +available in the Java perspective) +* To deploy, first add `aspectjrt.jar` to the project's library +directory. For servlets and JSP's, that is in `{Web Root}/WEB-INF/lib`. +For EJB's, it's XXX todo. Then deploy as usual for your application +server. +* If you are using AspectJ in more than one project, you might instead +deploy `aspectjrt.jar` whereever shared libraries belong for your +server. + +== Bugs in MyEclipseIDE + +. After refactoring to rename a servlet, have to manually update web.xml +. Silent failure when unable to delete a duplicate resource during +deployment. +. Annoyingly modal UI for deployment. Use a view. +. Need validation on saving Web.xml. E.g., servlet mapping names +validated with declared servlet names. +. Deployment dirty flag not working; not updated after editing web.xml +or rebuilding project. +. Apparantly false JSP error? using Sun page and template page, got: +"Fatal error - The markup in the document preceding the root element +must be well-formed." Error persisted even after replacing the entire +contents of the file with the template which worked by default. +. When using the exact template page, get no MyEclipseIDE error, but do +get compile errors in Tomcat. Using Javac, get compile-failed stack +trace with initial line number. Using ajc, just get stack trace. But +precompiling using Ant seems to work. +. Precompiling JSP's: +* MyEclipseIDE has a command to compile all JSP's, but I don't see +(where or how) the updated servlet mappings get into the deployed +web.xml. It would be great to get this working with AJDT. +* I adapted the Tomcat precompile script to use AspectJ's iajc. This +works fine, but like all Jasper2 solutions required the generated +servlet mappings be copied manually into the web.xml file. See +xref:#j2ee-tomcat4-precompileJsp[the Ant build script] diff --git a/docs/sandbox/trails/myeclipseide.html b/docs/sandbox/trails/myeclipseide.html deleted file mode 100644 index daff02e49..000000000 --- a/docs/sandbox/trails/myeclipseide.html +++ /dev/null @@ -1,87 +0,0 @@ - - - - - -MyEclipseIde -(http://www.myeclipseide.com) -aims to make it easy to develop J2EE applications using Eclipse. -AJDT -(http://eclipse.org/ajdt) -is an Eclipse plug-in that supports AspectJ. -
    -
  • To install AJDT with MyEclipseIDE, direct the Eclipse update manager to - - http://download.eclipse.org/technology/ajdt/dev/update, -install the plug-in, and follow any post-install instructions. -
    • - -
  • To enable a project to use aspects, first -select Convert to AspectJ project -from the project's context menu (select project, right click). -(XXX Bug: AJDT reverts perspective to Java; go back to MyEclipseIDE) -Note that you must convert each project; -converting the master J2EE project will not affect -the child components (XXX RFE: option to convert child if parent). -
    • - -
  • To build, select the menu item Project > Rebuild Project. -AJDT creates default.lst which lists all source files and -compiles them. -You can also recompile by clicking the AJDT build button. -(XXX Bug: only available in the Java perspective) -
    • - -
  • To deploy, first add aspectjrt.jar to the project's -library directory. -For servlets and JSP's, that is in {Web Root}/WEB-INF/lib. -For EJB's, it's XXX todo. -Then deploy as usual for your application server. -
    • -
  • If you are using AspectJ in more than one project, -you might instead deploy aspectjrt.jar -whereever shared libraries belong for your server. -
    • -
- - - - - -

Bugs in MyEclipseIDE

-
    -
  1. After refactoring to rename a servlet, have to manually update web.xml
    2. -
  2. Silent failure when unable to delete a duplicate resource during deployment.
    3. -
  3. Annoyingly modal UI for deployment. Use a view.
    4. -
  4. Need validation on saving Web.xml. E.g., servlet mapping names validated with declared servlet names.
    5. -
  5. Deployment dirty flag not working; not updated after editing web.xml or rebuilding project.
    6. -
  6. Apparantly false JSP error? using Sun page and template page, - got: - "Fatal error - The markup in the document preceding the root element - must be well-formed." - Error persisted even after replacing the entire contents of the file - with the template which worked by default. -
    7. -
  7. When using the exact template page, get no MyEclipseIDE error, - but do get compile errors in Tomcat. Using Javac, get compile-failed - stack trace with initial line number. Using ajc, just get stack trace. - But precompiling using Ant seems to work. -
    8. -
  8. Precompiling JSP's: -
      -
    • MyEclipseIDE has a command to compile all JSP's, but - I don't see (where or how) the updated servlet mappings - get into the deployed web.xml. - It would be great to get this working with AJDT. -
      • -
    • I adapted the Tomcat precompile script to use AspectJ's iajc. - This works fine, but like all Jasper2 solutions required the - generated servlet mappings be copied manually into the web.xml file. - See the Ant build script -
      • -
    -
    9. -
- - - \ No newline at end of file diff --git a/docs/sandbox/ubc-design-patterns/docs/readme.txt b/docs/sandbox/ubc-design-patterns/docs/readme.adoc similarity index 56% rename from docs/sandbox/ubc-design-patterns/docs/readme.txt rename to docs/sandbox/ubc-design-patterns/docs/readme.adoc index 8908cf8b6..f485a54f0 100644 --- a/docs/sandbox/ubc-design-patterns/docs/readme.txt +++ b/docs/sandbox/ubc-design-patterns/docs/readme.adoc @@ -1,55 +1,59 @@ -Implementations of GoF Design Patterns in Java and AspectJ -Code base documentation (April 2, 2004) += Implementations of GoF Design Patterns in Java and AspectJ +_Code base documentation (April 2, 2004)_ + +== Overview -Overview The goal was to provide parallel implementations in AspectJ and Java that allow for direct comparisons. It has to be noted that most patterns offer variability in the implementation approach. We choose the one that appeared to be the most general. Sometimes, the AspectJ version implements a slightly different (or additional) case(s). This is due to the fact that AJ sometimes allows for additional functionality. Please refer to the web page and our OOPSLA '02 paper for a detailed description of this work. -Example Setup -All pattern examples have a class called Main. This class is the driver for the particular example. The Main classes are extensively documented using ajdoc, describing the experimental setup and the assignment of roles to participants. In most cases, the differences between Java and AspectJ implementations are also mentioned. +== Example Setup + +All pattern examples have a class called `Main`. This class is the driver for the particular example. The Main classes are extensively documented using ajdoc, describing the experimental setup and the assignment of roles to participants. In most cases, the differences between Java and AspectJ implementations are also mentioned. + +== Documentation (ajdoc) -Documentation (ajdoc) -While all files are extensively documented using ajdoc (the AspectJ version of javadoc), ajdoc is not yet compatible with the later AspectJ releases, so it is currently not possible to generate HTML documents from it. This will be added when ajdoc is updated. +While all files are extensively documented using ajdoc (the AspectJ version of javadoc), ajdoc is not yet compatible with the later AspectJ releases, so it is currently not possible to generate HTML documents from it. This will be added when ajdoc is updated. Within the ajdoc documentation, we tried to separate type names used in our examples from role names (as presented in GoF). We show roles names in italics and actual type names in code font. -Questions, feedback, suggestions, etc. -The AODP web page is http://www.cs.ubc.ca/labs/spl/aodp.html -Please send all questions, feedback, and suggestions to Jan Hannemann (jan [AT] cs.ubc.ca). We are very much interested in improving our code. Please do not hesitate to drop us a line. +== Questions, feedback, suggestions, etc. +The AODP web page is http://www.cs.ubc.ca/labs/spl/aodp.html -=============================== +Please send all questions, feedback, and suggestions to Jan Hannemann (jan [AT] cs.ubc.ca). We are very much interested in improving our code. Please do not hesitate to drop us a line. +== Appendix -Appendix This appendix outlines how to compile and run the examples provided. DOS batch files exist that automate these tasks somewhat. Note that the batch files only work in Windows environments. The following is a list of tasks and a description of what commands accomplish them. For compiling, running and generating documentation, two options are given. The first one is using a provided script; the second is the standard command-line option (longer, but will work on all operation systems). +=== Using the Eclipse IDE -A1: Using the Eclipse IDE Setting up your system and running the examples -1. Install Eclipse (www.eclipse.org) and AJDT (www.eclipse.org/ajdt). Currently AJDT only works with release 2.1.X and not with version 3.0+ of Eclipse. Check the AJDT web page for more information and updates. + +1. Install https://www.eclipse.org[Eclipse] and https://www.eclipse.org/ajdt[AJDT]. Currently, AJDT only works with release 2.1.X and not with version 3.0+ of Eclipse. Check the AJDT web page for more information and updates. 2. Import the ZIP file with the AOP pattern examples into Eclipse 3. Compile & run -A2: Using other AspectJ-compatible IDEs -Note: the code base has not been tested with other IDEs. Chances are that this will work similar to the above, though. +=== Using other AspectJ-compatible IDEs +Note: The code base has not been tested with other IDEs. Chances are that this will work similar to the above, though. + +=== Using command-line compilation -A3: Using command-line compilation Setting up your system + 1. Install Java (version 1.4+) and AspectJ (version 1.1+) -2. Extract the ZIP file into a directory of your choice -3. Make sure your CLASSPATH contains the example's src directory +2. Extract the ZIP file into a directory of your choice +3. Make sure your `CLASSPATH` contains the example's src directory 4. Change to that directory Compile Java and AspectJ versions the design pattern examples. Choose one: -* Use the buildAllPatterns batch file (just call it from the examples root directory. Needs no arguments). -* ajc -d bin @src/allPatterns.lst -Run a compiled example (e.g. observer). Choose one: -* testPattern observer (this runs both Java and AspectJ versions) -* java ca.ubc.cs.spl.aspectPatterns.examples.observer.java.Main (for the Java version), -java ca.ubc.cs.spl.aspectPatterns.examples.observer.java.Main (for the AspectJ version) +* Use the `buildAllPatterns` batch file (just call it from the examples root directory. Needs no arguments). +* `ajc -d bin @src/allPatterns.lst` +Run a compiled example (e.g. Observer). Choose one: - April 2, 2004 +* Test pattern Observer (this runs both Java and AspectJ versions) +** `java ca.ubc.cs.spl.aspectPatterns.examples.observer.java.Main` for the Java version, +** `java ca.ubc.cs.spl.aspectPatterns.examples.observer.java.Main` for the AspectJ version diff --git a/docs/sandbox/ubc-design-patterns/docs/readme.pdf b/docs/sandbox/ubc-design-patterns/docs/readme.pdf deleted file mode 100644 index cde37b24bffd36935676da47cd4800bd867fa761..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 13954 zcmeHOc|4U{_m?3_rzE0?Ctb;S<_ReoBV`Opb#QPBM+Zp>QBf&Vqm)!vi9#C5&>*2m zhKiE7sYs|aQ2h3Ojz_5Oy}kE+KcC+pSD)S9&)RFPz4r8d*4q0y%9e)4nnW!Uf>Um8 zsjSA0M{qv4H4bmg@$zT$5WKM$%b#t?cICRU5uBbL z&d;C6W_jbrn{K~gU+U9hEb&!vz(BF1D0O4YKAR*)19FWaJLbyE`$|rdDpIAfd!z?8 zoz6{HEqhCvg2=8y67p^HH}tf1_Z1uMGa{N#nNfNmyZEb!$EVDvSvwn&8B=u2-Y&Xv zhG2RW3ZPyZ^r8ly1u6ua5l(^3G&}zQTk?E z#ncwjz|8yaY!`S1?K>=NlI~*|rg%N!hc7Byg6`gFk zsPb&c((`i50%kR*nZDb|nN}il*=K1(F`Diz?7l`%gN#!-?M&LEYZJV@93NbYkq)aq*jRJnjAKtmtR+!xk9uNy z<7Misi02)f&oms_Yd5JgX58&C0pXdFY0eTwGdn(s=}UD?e3L$wG0&xNw^zHXqhsCq zB!HHA1n%zBS zb2#bkqAQeCd0{IvW8Fz#U9`h0q#B~WavZb0oe-H7HMD(Que8@}xO0oWt#i4VT!TZA zwo7vT;Th?NXPkXf9`?4J;I4L3;zX;IrmuUL+wLp4J6S1bX${#S;inO|u05Lg6w_1< z^+iu=%GH<7SJ%KtKDWC$wPE}Y-7FrLXdUh5eKb)kGS88rWQj}LyCx88 zNh30R%(J?zgr{ZKC9CyT!%*-HH)x_vF`?J0Gj2eF_)&a!fAH zFtcq-thRu{JKKA)Y3=ud@ARgNzN|J8NRqxVZETa}t~pi64v%-{bIV1`Vk?W^1RCV4 zC%BHqi|mtE|6Ns6DPz)@5JaY|V8e;G&yo>MSG(71sv~b7FA~+N_>8=#Q1?y{5@N?c z{A{*NORp_Fv%-9K&D`zdr&O@Fb&=qyj|R0~QNi7P7wk(eYG;Zq zS-i$Y?}kyxp*j z$v*H`pivcsV#78Sxn>FVON}=$IQI$!>oQ-j&sx{2vs+Nd z3b9KOa#I?2^Jqz>sM6HiH3sEf({!_y#TIBiwG(pS`A9U{2pty5Q)Vx4{SxBiI=?9& zaeKF;eZZmn#Yb_8MVC5xK|M+K+=t2?Ivuztam!v3s`nsIKKqH+?-bf{CcRg@esiwv zj-c@#hs$!7UyaY(aJWs^KK_(yz7#9Gy!`X|iDcQA3w^8$QnrMrdnuH7G`U3?mb_~_ zywiAt|3}i2?V{!B?WLE^A2_TQ{Gz_BA17fbA8D2R+geL?%N1FxUzaXuNI58%F1@G2 za+lMC&vwB}o}H&> zRu0dYwHT-EE2bw|u>N(Ei16-hTwBVuRnHfo z+f4{r**iA&N|Io$n!xrOVi_M5j9Vvcm52-@uc&2=Gg7lK*`Xn@tSJz0rMkaSY_YQu zF|)xv_`!umkGBw;N)B&`$s-MHc%j~7JO3<$^H_1C&gH6&ckAl*soQ)JF+2CvE45^u zM!0GyU1K>*=WReolvKeRceM&Tz`L>UZbW&**Jw7A#EPQ#M&6uJ?Wm_dsO( z&Q2K_wY5_%IWJtaF6YT{L-G+$vj;D@IV7m-;lh_MMO7Z$yL#K?UPa+bHG%kmrNXa2 zOiE=H9!SmB`Gh|p`8+#hjAGGe!)ST!SorYGe(wc6NiAU) z7jKJG^-tUy_o{csE|CD^L~D;lNB>wRBDREgZ04d~m5TtzUz#59iM_O6qAPM!U({0J zfblvNn;MkD+3mL)>Lwx+j>~b`PuC${UD8Ggbe%XO)%V+v*4ViUU3ki(h4tW{PuFh5 zv3=YI-@l*)U)<>18Z9sh3|I}zlwogm+aO;yg12OOuyNpj9^1zsq4Hnw)@(m+0MC`} zhrqYLF&EUJ1p-2Y3<#hR5e8NyAw&XJCL=`H1j<4|h=c6FH^5u+xUM#Ae+2p!*3etP z8vwnaQ9lIrHBcI6IukIBaz03C8-K_7D7J6#X)u+9&c{4W`RFHa)DPV$$WU3ACDtnG zrF-Do0=!i1zL%C>n@?o?(RrzNHZ>qS8p#tE+GasZPhV_z*rw;*4WlEj+ihnP62{Ga z>@49Hn#;_+9JEA2nStkx;VL}CZ8#-yZPCKMRS{ZMa__tRubHyuUCiukCMT|yS9H`F zFC*gGIAOM#8n^t=73Y9}mU%Wh=E8nQq~AQI1}BvJs^l$*mUxy~ap{s*eu758n`M?8 zTbD^_M9`(IcKa#q@e}p(dls$IpW&~QUZ^c(y(+-hB<{s=^DilDrdt{IJ-ntFz13;X z?DONQbT!%(_CC{dt23~GPUODn= znsH!ZsBty#)YO;R7rE~r;+nOPQ|tkuIedjS0ND2iQ!{jSD9g zmiL>-Y{;pR%ZjMt-pW@KePOua5a$rr(=``=%BLzhK!+^no3iPwPPJBm&U;3;Qf`r3 zoQ@2mbx+o~ZN@RFoI9yLFK!D)OqbgpG~tbdycwl>Q*CW}3e9`Y{M)ljt0zn!NJ@`o z$eq8PrgNPzIs1S@+^&k|tHKSw`s|sJ<}$Q9%Ep}*GS*(Zejnp2O>}b%yLVDNxbWPg z)!q_yEmwR3>?eMBdN8eSYQlZ((5>5c>E99&v=5wqx8383%OAd{bmW54H7B+=KGKe} zC|a!E}SANmd8nw%cpb?F+DeIkXxcD2oXGOeIpv_a?Kj;yx= z5t`2=rY0_@r5i@C^(y5hvD_1L7NoCL7JPJIufgPk*M&V1 zD?TL9A8ty{F_3(C{M4Gj*2J=?hUXK@BSb%|9+8+Pc2&gPMfB&-nV+H=g9H=*{n)P+~dLd4i*vo9f)o^|eZ-My>M(GDPh+woCWA z*E!F}^UUPt?zk%17N%ktJl@tghn#eY-DRmyaeIBW+r^gsTczVs@%V0uhmliP%kG%t z!o2d>i{{WbkoBrHfv#275ED45>#b#a#yu;QfQ!3=cV9gF=25O{vU|kG=o8@*#rKyr zg^QTYF`b;WMaihM&RNuA66MwM?xwXQCBtR+9GsH!NIA-iX%`~vrcFIny-RDR^)}W1 z^5VM0YlR!?oVgo?1bRy)TQ@y#xoa5i5?3{jew?%}eV0VO)62G<>cTHtjF-5^Ut3VN zQA1cvWW`Oy{`q54VC25B4jDerDu3tNwYO}b3OT=8D?6b^U2SLUee(5v&p)Vd-{hfO zmGQ7y-m*Vy`N4|z`oej^ywk130M9S|VrR-&_nh+*8goU~PGrlh(ppiCzcSuR`F*~k z>_A1)0VyIuO}R((>DDpL+>5nOOpe-lT-A6h)w@6H9AmDvShgk==~A*(&avf)l?a@l zk=tRPJ6*3gx5?4$$O&1Cs1-psqgF`o?H+3+DYEVQA=+-ox%;KRNDIlgWFBaWvelKn zt&G!ubnWFC^}S_xUb_i@y)tLxgM&6_Sf15Im&hxv^nBVAJ1(C)b6zGyHsfkI;oz;? z(vzQEUv#@E`%F#llJn;?_XpVAViq5g4fLv+xv)7*pl6M<*2z}K8}jD}?VpwIa7567r2U8rrNIkC& z?0%`db^j4r$B+|!6Qiu$#xy7{{z!_^6u;qxeCf+HuwS|{x|1?vH#V_Cx)fFYo=?g$u_;bV}{_yV#~TSD>bevxl_E2%yu%UT}l&ES6HY- zXE*lY5{lCgztNf3#F(u8N;AR^zt3Oc3U|M2s5-MUFza};m5jo|^iPeFc2yIn#*56% zX%-;wJNUbywh*I zn(w93;^ov5`o8{IPN8DsRhhnWxt)Yh_>=9q2cOXHs!ZZ2lJG0uROotzNll3tQCu~9 z+UczxS4y8(=PFvVRr3|@xq9q7-Z3fQ)^E?ZUCLAG5xyH=x_8b6@71N(*@c|BIX5On zQ{VMSUOb{eJ6i4cP`~QFZ(RMWC!zRAd{%U!LV7uWBRTCPmt)n-sI`|_0x7*H( zombmtF$}76jRpk9=Ba*sr*0@2))A4aczxU2-x!^Sr{}8GR(%y@Zi$Fi5#QiYt-+ge zGN>sv^b9LgoGdlrVv7Iu*nNl3E+LqBo^Xx#V3}-AtXaQ1?%;=9A?wW>n4TeJH-qBc zqjlmd1||h0Y%O~1a!k;2-P=j8dY0OTI848GP&QvDaKQIk)EZ$=&-NrYT5zAhmj3Q$ zkM(%xM$aRW@15n33+cN?j?eu)qV#tsWYw(KRZ_J0>KcV@j6xEH@!$+Ed}vrhes`XaM}*DuqI znVU&+AD0StUN|)4;__Lh3Q;WHXHV^tF0Im;*$H&}6y$SIS7y)~x>@e59Ro%aqo#A$ z(?t8_7siOG3SJczi!Xj9%qC8!&z>5uXc4zw-)D)nh~DAfO0OG*ggmaSS~0NogN>+q zO}2*E{LW&d?x>TC-9EY-3UtnMUUKum_wE|%-$0*-L?Ti!cZ~?0EX)!5Z~1FK_R;Xh zRD?u?&KY`^^QZnAbkBzSYtYRbX(jX-ad?{m7k|{rwB-e`q4_xcVwN{>I*kc9`~sFA z8+9%5wj6J^-(q&4HP@Tv13f&RpTB`8i-(X&;OvPt_&}mkad>-1cXc` zBNPGyp%MsaVt{8loq-S;{5n{V*3l?K{7{YrcyO4|U*(V)CMr;ZB?^Ut;Fw^v=p+(C zqtVfXmWf1!N~NK6_zW!|GnjlnP{$Z7!#W(s2o=CG4KTn8n3$jitPJT;5wrsBGL4CL z3x_@cM%V>t5|%?c)~zA)0S_$0@xkhb#sCUHGtqty4km0JV}!~nU{Fc0A&^rkz*3+H zRR9ZEi;$5>7}NlzVFjN6ItU-o5dacsXQ2vA99E+302O2~Nl+S^_a(BQTSwB0z)nI0|H>0PP@06KI7Bm?=~+=!5GFrGq#J z3eW)!OVA1&HdCW>*jaRWfEk1x#u99Oc>1XVs1Po?(TcHWxNP`c0A^sLH#~=}4}ZqW z*s{R#p``$|eV4%4d`BC_hjYf^jeNjSFvrIO0o&9^-^Y)G5%@8rA=}TD$MN;&@(}tc z0D;fn1IRZ4z5+gWj7AGDmWLlgrtn!7Ea0vO=%5LwO_K!TPa+ZQ7IYl}11&gye!xBy zL;$z|85@7L_fmvT=9f&-(n5ch7splK$HR+_0Gu*l`I@ph9-jUPgGt2U9R?pL6dDe% z@8=4`X0!rY3m;&!@W`Bn4h50I1nsic^V?+7L7V#P1}&fvh%gWy40^wZ`o98EV9ifJ zRAT|x%k3ADluD%z%`!S*5KiIxz*Z`{1n6KN4Q>gT!}>p8JHyt=kRqUjiX~8wW0Jv! z0!tmPR%~fw`v&3ziV|ARF{Rzoo`O+&hd#C{!3ft^qd)Ig`uQJ_RE0~3kS;PX$> zluG%wboeOCSBN1g%uxl{T#e3$CK6p5V1}_A?F$_8!SoGI!EnGK8J^(6L!ZG?8QlV0 zMsUu4x}u=~2BE`qxEh8hz5<{L9U(9(BXSH*Vg2v~`37Zv4Ngb~sM=;`G5Zx>+N zPu)}Ccm51n`JMPhY^4lt9=HrJFBQ1?Blaqd4jk}*3awBHme9?_1TAB32iz}k1!K?H z@`u|Ou4Y&d7a+6{0RyH4WgOfyP!MiF6eK}T0WzosP&+CJ`VL!xWtc-o zjE?Ocj1C*X>V`HWw!JYy%w(9u1nZ$IM*?HOcjjB-)J_c-!*V08#IP+(>L994hntkQuS`B%=WCJ}((|I%G04M)}Quaf@C zUj<(FH&itMH%uHh4}|@H6H94e7XL}Y{S#p*`>%q3$Kc;}z~6+w2&Mdct>!-}DBAGA9x z+=o>|;Xc~xkXH)U&T#zv^+Qu|cJL$o#GLlOb8PxA2L21<|GvslKjQzv>-?9_Oo^ip zO;N(HgD3_Ue;VVXUf^|Ch(h3bdKnQ{b_Y^WeD1g5egO1_F2j|EdI9KqK>SmS_wR+=D3e+W{F3 z9FBp@95kk74xS7!L9_(Sr-M2g1;lksaHIf~LPZRq80I({^;_@`wPU7Hz=;bN(Cy^c4Edel0^ytA zNg@HEA-@yO&#>cAFf_v)Pwa;sPT<>5Lt_MQ%U!*#u`qdK8(z(a$) zU>xW`H{=7i04NRRp}>z(p*_;A z2l#t_>p4XqSOR+udWiOb@$DJX&{2WC8swoF@js?@3vdO$!I`7)%Hz7Q{1Gsf_B;;! zSq@c;fVczw;11S}8|a5DwpATA2k<96*c`x5fBmp;e)*GWzyg<_T#sP_>v?Q<8~`^m z4h-AiA3~#2$yCH0;nRpDCIAJr4)GbH(ZSW)C>q$@qiLYeBoGO~zhSZr_(|{x8i7Ki ze@6pvlJE4<2+$cADN84UZ91Ap1^_pT#-ISy8AT%yh~PQ}{tej&=Lu|+ku(M!oOO<( zF&W_9I+8{tfO#BEBND&2g+l$l4H6N&qeto^P$&QiN79Hy3Kcku@NdXw08#+VhiLvh z7RQUtLx0_6!`Z-w^NY9Ua{ZCP-*_$bapxkyc=&s-g@%ZeE}h1t(b#Mk28%_fkXa-* p8qJl-BD&C6L?(kpCF=b(2Z{xL{w$t9x~SmJBH)yjjg}bW{tr3laq9p8 diff --git a/docs/sandbox/ubc-design-patterns/patterns-readme.adoc b/docs/sandbox/ubc-design-patterns/patterns-readme.adoc new file mode 100644 index 000000000..501677747 --- /dev/null +++ b/docs/sandbox/ubc-design-patterns/patterns-readme.adoc @@ -0,0 +1,23 @@ +== AspectJ Patterns + +_Last updated: 2004-03-31 by wisberg_ + +This directory contains Java and AspectJ implementations of the patterns +described in the "Design Patterns" book by the so-called gang-of-four +(Gamma, Helm, Johnson, Vlissides). Jan Hannemann from UBC contributed +the code under the Mozilla Public License 1.0. For more details, see +xref:docs/readme.adoc[]. + +Build options + +* To build the code manually with ajc, use the corresponding build.lst + files, creating the aspect library first (to create lib.jar). +* Ajbrowser and the other IDE support does not support options like + sourceroots or -outjar in the .lst files, so you'll have to create new + .lst files if you want to build portions of the project in an IDE. +* To build with eclipse, there are .project and .classpath files, but + you will need to adjust the `aspectjrt.jar` entry after importing the + project. +* To build for testing, see patterns-test.xml. + +Enjoy! diff --git a/docs/sandbox/ubc-design-patterns/patterns-readme.html b/docs/sandbox/ubc-design-patterns/patterns-readme.html deleted file mode 100644 index 4230c97e3..000000000 --- a/docs/sandbox/ubc-design-patterns/patterns-readme.html +++ /dev/null @@ -1,40 +0,0 @@ - -AspectJ Patterns - - -

AspectJ Patterns

-

- This directory contains - Java and AspectJ implementations of the patterns described - in the "Design Patterns" book by the so-called gang-of-four - (Gamma, Helm, Johnson, Vlissides). - Jan Hannemann from UBC contributed the code - under the Mozilla Public License 1.0. - For more details, see docs/readme-1.1.txt - or docs/readme-1.1.pdf. -

-

- Build options -

    -
  • - To build the code manually with ajc, use the corresponding build.lst files, - creating the aspect library first (to create lib.jar). -
    • -
  • Ajbrowser and the other IDE support does not support options like sourceroots - or -outjar in the .lst files, so you'll have to create new .lst files if - you want to build portions of the project in an IDE.
    • -
  • - To build with eclipse, there are .project - and .classpath files, but you will need - to adjust the aspectjrt.jar entry after importing the project. -
    • -
  • - To build for testing, see patterns-test.xml. -
    • -
-

- Enjoy! -

- - - diff --git a/docs/teaching/exercises/plugins/index.adoc b/docs/teaching/exercises/plugins/index.adoc new file mode 100644 index 000000000..9fc0b8a80 --- /dev/null +++ b/docs/teaching/exercises/plugins/index.adoc @@ -0,0 +1,19 @@ +== Exercises plugin for the tutorial + +Download the appropriate version and unzip it in your eclipse\plugins +directory: + +[cols=",",] +|=== +|For Eclipse 3.0 with AJDT 1.1.12 +|http://dev.eclipse.org/viewcvs/index.cgi/~checkout~/org.aspectj/modules/docs/teaching/exercises/plugins/org.aspectj.tutorial.exercises_1.1.12.zip?rev=1.1&cvsroot=Technology_Project[org.aspectj.tutorial.exercises_1.1.12.zip] + +|For Eclipse 3.0 with AJDT 1.2.0M2 +|http://dev.eclipse.org/viewcvs/index.cgi/~checkout~/org.aspectj/modules/docs/teaching/exercises/plugins/org.aspectj.tutorial.exercises_1.2.0M2.zip?rev=1.1&cvsroot=Technology_Project[org.aspectj.tutorial.exercises_1.2.0M2.zip] + +|For Eclipse 3.0 with AJDT 1.2.0 latest dev build +|http://dev.eclipse.org/viewcvs/index.cgi/~checkout~/org.aspectj/modules/docs/teaching/exercises/plugins/org.aspectj.tutorial.exercises_1.2.0_301_Dev.zip?rev=1.1&cvsroot=Technology_Project[org.aspectj.tutorial.exercises_1.2.0_301_Dev.zip] + +|For Eclipse 3.1M5 with AJDT 1.2.0 latest dev build +|http://dev.eclipse.org/viewcvs/index.cgi/~checkout~/org.aspectj/modules/docs/teaching/exercises/plugins/org.aspectj.tutorial.exercises_1.2.0_31M5_Dev.zip?rev=1.1&cvsroot=Technology_Project[org.aspectj.tutorial.exercises_1.2.0_31M5_Dev.zip] +|=== -- 2.39.5