Skip to content

Commit ae196ec

Browse files
committed
Preparing next build
1 parent f517e2d commit ae196ec

File tree

21 files changed

+31
-31
lines changed
  • net.tascalate.javaflow.agent.common
  • net.tascalate.javaflow.agent.core
  • net.tascalate.javaflow.agent.proxy
  • net.tascalate.javaflow.api-j09
  • net.tascalate.javaflow.api-j21
  • net.tascalate.javaflow.api-j25
  • net.tascalate.javaflow.api
  • net.tascalate.javaflow.providers.asm3
  • net.tascalate.javaflow.providers.asm4
  • net.tascalate.javaflow.providers.asm5
  • net.tascalate.javaflow.providers.asmx
  • net.tascalate.javaflow.providers.core
  • net.tascalate.javaflow.providers.proxy
  • net.tascalate.javaflow.spi
  • net.tascalate.javaflow.tools.ant
  • net.tascalate.javaflow.tools.gradle
  • net.tascalate.javaflow.tools.jar
  • net.tascalate.javaflow.tools.maven
  • net.tascalate.javaflow.tools.runtime

21 files changed

+31
-31
lines changed

README.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
[![Maven Central](https://img.shields.io/maven-central/v/net.tascalate.javaflow/net.tascalate.javaflow.parent.svg)](https://search.maven.org/artifact/net.tascalate.javaflow/net.tascalate.javaflow.parent/2.8.2/pom) [![GitHub release](https://img.shields.io/github/release/vsilaev/tascalate-javaflow.svg)](https://github.com/vsilaev/tascalate-javaflow/releases/tag/2.8.2) [![license](https://img.shields.io/github/license/vsilaev/tascalate-javaflow.svg)](http://www.apache.org/licenses/LICENSE-2.0.txt)
1+
[![Maven Central](https://img.shields.io/maven-central/v/net.tascalate.javaflow/net.tascalate.javaflow.parent.svg)](https://search.maven.org/artifact/net.tascalate.javaflow/net.tascalate.javaflow.parent/2.8.3/pom) [![GitHub release](https://img.shields.io/github/release/vsilaev/tascalate-javaflow.svg)](https://github.com/vsilaev/tascalate-javaflow/releases/tag/2.8.3) [![license](https://img.shields.io/github/license/vsilaev/tascalate-javaflow.svg)](http://www.apache.org/licenses/LICENSE-2.0.txt)
22

33
# IMPORTANT NOTICE FOR RELEASE 2.7.0!!!
44
- Agents & Tools projects were refactored to follow consisntent naming of classes and to avoid package name clashes
@@ -34,7 +34,7 @@ You have to add the following configuration to enable build-time instrumentation
3434
<dependency>
3535
<groupId>net.tascalate.javaflow</groupId>
3636
<artifactId>net.tascalate.javaflow.api</artifactId>
37-
<version>2.8.2</version>
37+
<version>2.8.3</version>
3838
</dependency>
3939
<!-- Add-on for Java 8 and above -->
4040
<dependency>
@@ -68,7 +68,7 @@ You have to add the following configuration to enable build-time instrumentation
6868
<plugin>
6969
<groupId>net.tascalate.javaflow</groupId>
7070
<artifactId>net.tascalate.javaflow.tools.maven</artifactId>
71-
<version>2.8.2</version>
71+
<version>2.8.3</version>
7272
<executions>
7373
<execution>
7474
<id>javaflow-enhance-main-classes</id>
@@ -90,7 +90,7 @@ You have to add the following configuration to enable build-time instrumentation
9090
</plugins>
9191
</build>
9292
```
93-
Note that if you are using continuations with Java 1.8 lambdas then you need to add [Tascalate JavaFlow instrumentation agent](https://github.com/vsilaev/tascalate-javaflow/releases/download/2.8.2/javaflow.instrument-continuations.jar) at run-time as command-line option, while lambda-related classes are generated by JVM on the fly and there is no other way to instrument them. If this is not an option, then you can de-sugar all lambdas with [RetroLambda](https://github.com/luontola/retrolambda) Maven plugin at build-time (RetroLambda output is supported by Tascalate JavaFlow 2.3.2 or higher).
93+
Note that if you are using continuations with Java 1.8 lambdas then you need to add [Tascalate JavaFlow instrumentation agent](https://github.com/vsilaev/tascalate-javaflow/releases/download/2.8.3/javaflow.instrument-continuations.jar) at run-time as command-line option, while lambda-related classes are generated by JVM on the fly and there is no other way to instrument them. If this is not an option, then you can de-sugar all lambdas with [RetroLambda](https://github.com/luontola/retrolambda) Maven plugin at build-time (RetroLambda output is supported by Tascalate JavaFlow 2.3.2 or higher).
9494

9595
Please refer to [pom.xml](https://github.com/vsilaev/tascalate-javaflow-examples/blob/master/net.tascalate.javaflow.examples.common/pom.xml) in examples project for typical Maven configuration.
9696

@@ -105,7 +105,7 @@ pluginManagement {
105105
resolutionStrategy {
106106
eachPlugin {
107107
if (requested.id.id == "continuations") {
108-
useModule("net.tascalate.javaflow:net.tascalate.javaflow.tools.gradle:2.8.2")
108+
useModule("net.tascalate.javaflow:net.tascalate.javaflow.tools.gradle:2.8.3")
109109
}
110110
}
111111
}
@@ -123,7 +123,7 @@ plugins {
123123
}
124124
...
125125
dependencies {
126-
implementation 'net.tascalate.javaflow:net.tascalate.javaflow.api:2.8.2'
126+
implementation 'net.tascalate.javaflow:net.tascalate.javaflow.api:2.8.3'
127127
}
128128
```
129129
With JDK versions 21..24 inclusive add the following configuration to use `ScopedValue` instead of `ThreadLocal` for continuation internals:
@@ -144,7 +144,7 @@ buildscript {
144144
}
145145
146146
dependencies {
147-
classpath 'net.tascalate.javaflow:net.tascalate.javaflow.tools.gradle:2.8.2'
147+
classpath 'net.tascalate.javaflow:net.tascalate.javaflow.tools.gradle:2.8.3'
148148
}
149149
}
150150
```
@@ -158,7 +158,7 @@ repositories {
158158
}
159159
160160
dependencies {
161-
implementation 'net.tascalate.javaflow:net.tascalate.javaflow.api:2.8.2'
161+
implementation 'net.tascalate.javaflow:net.tascalate.javaflow.api:2.8.3'
162162
}
163163
```
164164
With JDK versions 21..24 inclusive add the following configuration to use `ScopedValue` instead of `ThreadLocal` for continuation internals:
@@ -196,7 +196,7 @@ It's possibe to instrument compiled Java classes as below:
196196
You may download a complete [examples project setup](https://github.com/vsilaev/tascalate-javaflow-examples/releases/download/1.0.10/tascalate-javaflow-ant-project-setup1.zip) from [the latest release](https://github.com/vsilaev/tascalate-javaflow-examples/releases/tag/1.0.10) for complete configuration template. Please pay attention to <code>ant-lib</code> folder with Ant TaskDef and <code>lib</code> folders with compile-/runtime-dependencies.
197197

198198
# Java Instrumentation Agent (Runt-time Instrumentation)
199-
As an alternative to compile-time bytecode instrumentation, you MAY use [Tascalate JavaFlow Instrumentation Agent](https://github.com/vsilaev/tascalate-javaflow/releases/download/2.8.2/javaflow.instrument-continuations.jar) from [the latest release](https://github.com/vsilaev/tascalate-javaflow/releases/tag/2.8.2) to enable continuations support at class-loading time. Please note, that if you are using Java 8 and creating continuable lambda functions (either anonymous or/and as method references), and you don't replace them with tools like [RetroLambda](https://github.com/luontola/retrolambda) as mentioned above, then you SHOULD use this instrumentation agent always: as long as Java run-time generates implementation of functional interfaces on the fly there is no other option to instrument them. To enable Tascalate JavaFlow Instrumentation Agent please add the following arguments to Java command line:
199+
As an alternative to compile-time bytecode instrumentation, you MAY use [Tascalate JavaFlow Instrumentation Agent](https://github.com/vsilaev/tascalate-javaflow/releases/download/2.8.3/javaflow.instrument-continuations.jar) from [the latest release](https://github.com/vsilaev/tascalate-javaflow/releases/tag/2.8.3) to enable continuations support at class-loading time. Please note, that if you are using Java 8 and creating continuable lambda functions (either anonymous or/and as method references), and you don't replace them with tools like [RetroLambda](https://github.com/luontola/retrolambda) as mentioned above, then you SHOULD use this instrumentation agent always: as long as Java run-time generates implementation of functional interfaces on the fly there is no other option to instrument them. To enable Tascalate JavaFlow Instrumentation Agent please add the following arguments to Java command line:
200200
```bash
201201
java -javaagent:<path-to-jar>/javaflow.instrument-continuations.jar <rest-of arguments>
202202
```
@@ -205,15 +205,15 @@ The agent JAR file includes all necessary dependencies and requires no additiona
205205
Another useful application of the instrumentation agent is to apply it for debugging code within your IDE of choice. Just specify the "-javaagent" option listed above in your IDE debug/run configuration and you will be able to perform quick "debug-fix" loops without executing full project rebuild.
206206

207207
# Command-line tools
208-
It's possible to use a stand-alone command-line utility [JavaFlowRewriteJar.jar](https://github.com/vsilaev/tascalate-javaflow/releases/download/2.8.2/JavaFlowRewriteJar.jar) to instrument JAR archives containing continuable classes. Please use the following command:
208+
It's possible to use a stand-alone command-line utility [JavaFlowRewriteJar.jar](https://github.com/vsilaev/tascalate-javaflow/releases/download/2.8.3/JavaFlowRewriteJar.jar) to instrument JAR archives containing continuable classes. Please use the following command:
209209

210210
```bash
211211
java -jar JavaFlowRewriteJar.jar src1.jar dst1.jar src2.jar dst2.jar...
212212
```
213213
Note, that the source and the destination should be different files.
214214

215215
# CDI Support
216-
To work correctly in CDI environment continuable methods should be advised only by continuation-aware CDI proxies (interceptors, scope proxies, etc). Obviously, generation of these proxies is out of our control. Plus, major CDI containers (JBoss Weld and Apache OpenWebBeans) generates such proxies dynamically at run-time. Therefore if you plan to use Tascalate JavaFlow continuations with managed beans' methods then it's necessary to instrument CDI-specific proxies with [javaflow.instrument-proxies.jar](https://github.com/vsilaev/tascalate-javaflow/releases/download/2.8.2/javaflow.instrument-proxies.jar) Java Agent:
216+
To work correctly in CDI environment continuable methods should be advised only by continuation-aware CDI proxies (interceptors, scope proxies, etc). Obviously, generation of these proxies is out of our control. Plus, major CDI containers (JBoss Weld and Apache OpenWebBeans) generates such proxies dynamically at run-time. Therefore if you plan to use Tascalate JavaFlow continuations with managed beans' methods then it's necessary to instrument CDI-specific proxies with [javaflow.instrument-proxies.jar](https://github.com/vsilaev/tascalate-javaflow/releases/download/2.8.3/javaflow.instrument-proxies.jar) Java Agent:
217217
```bash
218218
java -javaagent:<path-to-jar>/javaflow.instrument-proxies.jar <rest-of arguments>
219219
```

net.tascalate.javaflow.agent.common/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<parent>
55
<groupId>net.tascalate.javaflow</groupId>
66
<artifactId>net.tascalate.javaflow.parent</artifactId>
7-
<version>2.8.2</version>
7+
<version>2.8.3</version>
88
<relativePath>../</relativePath>
99
</parent>
1010

net.tascalate.javaflow.agent.core/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<parent>
55
<groupId>net.tascalate.javaflow</groupId>
66
<artifactId>net.tascalate.javaflow.parent</artifactId>
7-
<version>2.8.2</version>
7+
<version>2.8.3</version>
88
<relativePath>../</relativePath>
99
</parent>
1010

net.tascalate.javaflow.agent.proxy/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<parent>
55
<groupId>net.tascalate.javaflow</groupId>
66
<artifactId>net.tascalate.javaflow.parent</artifactId>
7-
<version>2.8.2</version>
7+
<version>2.8.3</version>
88
<relativePath>../</relativePath>
99
</parent>
1010

net.tascalate.javaflow.api-j09/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<parent>
55
<groupId>net.tascalate.javaflow</groupId>
66
<artifactId>net.tascalate.javaflow.parent</artifactId>
7-
<version>2.8.2</version>
7+
<version>2.8.3</version>
88
<relativePath>../</relativePath>
99
</parent>
1010

net.tascalate.javaflow.api-j21/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<parent>
55
<groupId>net.tascalate.javaflow</groupId>
66
<artifactId>net.tascalate.javaflow.parent</artifactId>
7-
<version>2.8.2</version>
7+
<version>2.8.3</version>
88
<relativePath>../</relativePath>
99
</parent>
1010

net.tascalate.javaflow.api-j25/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<parent>
55
<groupId>net.tascalate.javaflow</groupId>
66
<artifactId>net.tascalate.javaflow.parent</artifactId>
7-
<version>2.8.2</version>
7+
<version>2.8.3</version>
88
<relativePath>../</relativePath>
99
</parent>
1010

net.tascalate.javaflow.api/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<parent>
55
<groupId>net.tascalate.javaflow</groupId>
66
<artifactId>net.tascalate.javaflow.parent</artifactId>
7-
<version>2.8.2</version>
7+
<version>2.8.3</version>
88
<relativePath>../</relativePath>
99
</parent>
1010

net.tascalate.javaflow.providers.asm3/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<parent>
55
<groupId>net.tascalate.javaflow</groupId>
66
<artifactId>net.tascalate.javaflow.parent</artifactId>
7-
<version>2.8.2</version>
7+
<version>2.8.3</version>
88
<relativePath>../</relativePath>
99
</parent>
1010

net.tascalate.javaflow.providers.asm4/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<parent>
55
<groupId>net.tascalate.javaflow</groupId>
66
<artifactId>net.tascalate.javaflow.parent</artifactId>
7-
<version>2.8.2</version>
7+
<version>2.8.3</version>
88
<relativePath>../</relativePath>
99
</parent>
1010

0 commit comments

Comments
 (0)