-
Notifications
You must be signed in to change notification settings - Fork 75
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* cgi to quarkus rules for jakarta classes * remove failing groovy tests
- Loading branch information
Showing
12 changed files
with
325 additions
and
25 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
178 changes: 178 additions & 0 deletions
178
rules/rules-reviewed/quarkus/java-ee/jakarta-cdi-to-quarkus.windup.groovy
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,178 @@ | ||
package quarkus.javaee | ||
|
||
import org.jboss.windup.ast.java.data.TypeReferenceLocation | ||
import org.jboss.windup.config.GraphRewrite | ||
import org.jboss.windup.config.Variables | ||
import org.jboss.windup.config.metadata.TechnologyReference | ||
import org.jboss.windup.config.operation.Iteration | ||
import org.jboss.windup.config.operation.iteration.AbstractIterationOperation | ||
import org.jboss.windup.config.query.Query | ||
import org.jboss.windup.config.query.QueryPropertyComparisonType | ||
import org.jboss.windup.graph.model.FileLocationModel | ||
import org.jboss.windup.graph.model.FileReferenceModel | ||
import org.jboss.windup.graph.model.ProjectModel | ||
import org.jboss.windup.graph.model.WindupVertexFrame | ||
import org.jboss.windup.graph.model.resource.FileModel | ||
import org.jboss.windup.reporting.category.IssueCategory | ||
import org.jboss.windup.reporting.category.IssueCategoryRegistry | ||
import org.jboss.windup.reporting.config.Hint | ||
import org.jboss.windup.reporting.config.Link | ||
import org.jboss.windup.rules.apps.java.condition.JavaClass | ||
import org.jboss.windup.rules.apps.java.condition.annotation.AnnotationTypeCondition | ||
import org.jboss.windup.rules.apps.java.scan.ast.annotations.JavaAnnotationTypeReferenceModel | ||
import org.jboss.windup.rules.apps.xml.condition.XmlFile | ||
import org.ocpsoft.rewrite.config.And | ||
import org.ocpsoft.rewrite.config.Or | ||
import org.ocpsoft.rewrite.context.EvaluationContext | ||
|
||
import java.util.stream.Collectors | ||
import java.util.stream.StreamSupport | ||
|
||
final IssueCategory potentialIssueCategory = new IssueCategoryRegistry().getByID(IssueCategoryRegistry.POTENTIAL) | ||
final Link guideLink = Link.to("Quarkus - Guides", "https://quarkus.io/guides/cdi-reference") | ||
final Link cdiSpecLink = Link.to("CDI 2.0 - Scopes: Default scope", "https://docs.jboss.org/cdi/spec/2.0/cdi-spec.html#default_scope") | ||
|
||
static boolean matchesProject(GraphRewrite event, FileLocationModel payload) { | ||
final Iterable<? extends WindupVertexFrame> previouslyFound = Optional.ofNullable(Variables.instance(event).findVariable("discard")).orElse(Collections.emptySet()) | ||
final Set<ProjectModel> projectModels = StreamSupport.stream(previouslyFound.spliterator(), false) | ||
.map { | ||
if (it instanceof FileReferenceModel) return ((FileReferenceModel) it).getFile().getProjectModel() | ||
else if (it instanceof FileModel) return ((FileModel) it).getProjectModel() | ||
else return null | ||
} | ||
.collect (Collectors.toSet()) | ||
final boolean matchesProject = projectModels.isEmpty() || projectModels.stream().anyMatch{payload.getFile().belongsToProject(it)} | ||
return matchesProject | ||
} | ||
|
||
ruleSet("jakarta-cdi-to-quarkus-groovy") | ||
.addSourceTechnology(new TechnologyReference("java-ee", null)) | ||
.addTargetTechnology(new TechnologyReference("quarkus", null)) | ||
// this rule si required for Windup to know about storing data related to the classes involved in the | ||
// `when` condition because useful later on in the `perform` step of the next rule | ||
.addRule() | ||
.when( | ||
Or.any( | ||
JavaClass.references("jakarta.enterprise.context.{scope}").at(TypeReferenceLocation.ANNOTATION).as("placeholder1"), | ||
JavaClass.references("jakarta.inject.Singleton").at(TypeReferenceLocation.ANNOTATION).as("placeholder2"), | ||
) | ||
) | ||
.where("scope").matches("(ApplicationScoped|ConversationScoped|Dependent|RequestScoped|SessionScoped)") | ||
.withId("jakarta-cdi-to-quarkus-groovy-00000") | ||
.addRule() | ||
.when( | ||
JavaClass.references("jakarta.inject.Inject").at(TypeReferenceLocation.ANNOTATION).as("main") | ||
) | ||
.perform( | ||
Iteration.over("main") | ||
.perform( | ||
new AbstractIterationOperation<JavaAnnotationTypeReferenceModel>() { | ||
public static final String FROM_FILES_IN_PROJECT = "filesInProject" | ||
public static final String INJECT_CLASS_DECLARATION = "injectClassDeclaration" | ||
|
||
void perform(GraphRewrite event, EvaluationContext context, JavaAnnotationTypeReferenceModel payload) { | ||
final String annotatedClass = payload.getAnnotatedType().getResolvedSourceSnippit() | ||
final boolean injectedClassHasScopeAnnotations = | ||
JavaClass.references(annotatedClass) | ||
.at(TypeReferenceLocation.TYPE) | ||
.annotationMatches(new AnnotationTypeCondition("jakarta.enterprise.context.(ApplicationScoped|ConversationScoped|Dependent|RequestScoped|SessionScoped)")) | ||
.as("discard") | ||
.evaluate(event, context) | ||
final boolean injectedClassHasSingletonAnnotations = | ||
JavaClass.references(annotatedClass) | ||
.at(TypeReferenceLocation.TYPE) | ||
.annotationMatches(new AnnotationTypeCondition("jakarta.inject.Singleton")) | ||
.as("discardAsWell") | ||
.evaluate(event, context) | ||
if (!injectedClassHasScopeAnnotations && !injectedClassHasSingletonAnnotations) { | ||
// first of all select only the file belonging to the same root project as the payload | ||
// to reduce (i.e. optimize) the number of files found from the second query | ||
final FileModel fileModel = payload.getFile() | ||
final String filePath = fileModel.getProjectModel().getRootFileModel().getPrettyPath() + "/" | ||
Query.fromType(FileModel.class).withProperty(FileModel.FILE_PATH, QueryPropertyComparisonType.CONTAINS_TOKEN, filePath).as(FROM_FILES_IN_PROJECT).evaluate(event, context) | ||
//Query.fromType(FileModel.class).withProperty(JavaClass.from | ||
JavaClass.from(FROM_FILES_IN_PROJECT).references(annotatedClass).at(TypeReferenceLocation.TYPE).as(INJECT_CLASS_DECLARATION).evaluate(event, context) | ||
Iteration.over(INJECT_CLASS_DECLARATION) | ||
.perform( | ||
((Hint) Hint.titled("Injected class is missing scope annotation") | ||
.withText(""" | ||
A class injected but missing an annotation to define its scope type is not going to be discovered from Quarkus. | ||
Consider adding the `@Dependent` scope which is the default scope for a bean which does not explicitly declare a scope type (ref. [CDI 2.0 - Scopes: Default scope](https://docs.jboss.org/cdi/spec/2.0/cdi-spec.html#default_scope)) | ||
""") | ||
.withIssueCategory(potentialIssueCategory) | ||
.with(guideLink) | ||
.with(cdiSpecLink) | ||
.withEffort(1)) | ||
) | ||
.endIteration() | ||
} | ||
} | ||
} | ||
) | ||
.endIteration() | ||
) | ||
.withId("jakarta-cdi-to-quarkus-groovy-00010") | ||
// suggest to replace cdi-api TRANSITIVE dependency if no Quarkus dependency has been already added and 'javax.enterprise.{packages}.{*}' package is used somewhere in the code | ||
.addRule() | ||
.when( | ||
And.all( | ||
JavaClass.references("jakarta.enterprise.{packages}.{*}").at(TypeReferenceLocation.ANNOTATION).as("discard"), | ||
XmlFile.matchesXpath("/m:project/m:dependencies[count(m:dependency/m:artifactId[contains(., 'cdi-api')]) = 0 and count(m:dependency/m:artifactId[contains(., 'quarkus-')]) = 0]") | ||
.inFile("pom.xml") | ||
.namespace("m", "http://maven.apache.org/POM/4.0.0") | ||
.as("dependencies-section") | ||
) | ||
) | ||
.perform( | ||
Iteration.over("dependencies-section").perform( | ||
new AbstractIterationOperation<FileLocationModel>() { | ||
void perform(GraphRewrite event, EvaluationContext context, FileLocationModel payload) { | ||
if (matchesProject(event, payload)) { | ||
((Hint) Hint.titled("Remove jakarta.enterprise:cdi-api transitive dependency") | ||
.withText(""" | ||
Transitive dependency `jakarta.enterprise:cdi-api` should be removed and the `io.quarkus:quarkus-arc` dependency added. | ||
""") | ||
.withIssueCategory(potentialIssueCategory) | ||
.with(guideLink) | ||
.withEffort(1) | ||
).performParameterized(event, context, payload) | ||
} | ||
} | ||
} | ||
) | ||
.endIteration() | ||
) | ||
.where("packages").matches("(context|event|inject|util)") | ||
.withId("jakarta-cdi-to-quarkus-groovy-00020") | ||
// suggest to replace javax.inject TRANSITIVE dependency if no Quarkus dependency has been already added and 'javax.inject' package is used somewhere in the code | ||
.addRule() | ||
.when( | ||
And.all( | ||
JavaClass.references("jakarta.inject.{*}").at(TypeReferenceLocation.ANNOTATION).as("discard"), | ||
XmlFile.matchesXpath("/m:project/m:dependencies[count(m:dependency/m:artifactId[contains(., 'jakarta.inject')]) = 0 and count(m:dependency/m:artifactId[contains(., 'quarkus-')]) = 0]") | ||
.inFile("pom.xml") | ||
.namespace("m", "http://maven.apache.org/POM/4.0.0") | ||
.as("dependencies-section") | ||
) | ||
) | ||
.perform( | ||
Iteration.over("dependencies-section").perform( | ||
new AbstractIterationOperation<FileLocationModel>() { | ||
void perform(GraphRewrite event, EvaluationContext context, FileLocationModel payload) { | ||
if (matchesProject(event, payload)) { | ||
((Hint) Hint.titled("Remove jakarta.inject:jakarta.inject transitive dependency") | ||
.withText(""" | ||
The application has a transitive `javax.inject:javax.inject` dependency because at least one Java class that imports from the `javax.inject` has been found. | ||
The direct dependency injecting `javax.inject:javax.inject` should be identified and replaced with the `io.quarkus:quarkus-arc` dependency. | ||
""") | ||
.withIssueCategory(potentialIssueCategory) | ||
.with(guideLink) | ||
.withEffort(1) | ||
).performParameterized(event, context, payload) | ||
} | ||
} | ||
} | ||
) | ||
.endIteration() | ||
) | ||
.withId("jakarta-cdi-to-quarkus-groovy-00030") |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
File renamed without changes.
3 changes: 1 addition & 2 deletions
3
...a-ee/tests/data-jakarta/HelloService.java → ...sts/data-jakarta/direct/HelloService.java
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
File renamed without changes.
File renamed without changes.
12 changes: 12 additions & 0 deletions
12
rules/rules-reviewed/quarkus/java-ee/tests/data-jakarta/transitive/HelloService.java
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,12 @@ | ||
package sample; | ||
|
||
import jakarta.enterprise.inject.Produces; | ||
|
||
|
||
public class HelloService { | ||
@Produces | ||
String createHelloMessage(String name) { | ||
return "Hello " + name + "!"; | ||
} | ||
|
||
} |
51 changes: 51 additions & 0 deletions
51
rules/rules-reviewed/quarkus/java-ee/tests/data-jakarta/transitive/HiWorld.java
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,51 @@ | ||
/* | ||
* JBoss, Home of Professional Open Source | ||
* Copyright 2015, Red Hat, Inc. and/or its affiliates, and individual | ||
* contributors by the @authors tag. See the copyright.txt in the | ||
* distribution for a full listing of individual contributors. | ||
* | ||
* Licensed under the Apache License, Version 2.0 (the "License"); | ||
* you may not use this file except in compliance with the License. | ||
* You may obtain a copy of the License at | ||
* http://www.apache.org/licenses/LICENSE-2.0 | ||
* Unless required by applicable law or agreed to in writing, software | ||
* distributed under the License is distributed on an "AS IS" BASIS, | ||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
* See the License for the specific language governing permissions and | ||
* limitations under the License. | ||
*/ | ||
package org.jboss.as.quickstarts.rshelloworld; | ||
|
||
import jakarta.inject.Inject; | ||
import jakarta.ws.rs.GET; | ||
import jakarta.ws.rs.Path; | ||
import jakarta.ws.rs.Produces; | ||
|
||
/** | ||
* A simple REST service which is able to say hello to someone using HelloService Please take a look at the web.xml where JAX-RS | ||
* is enabled | ||
* | ||
* @author [email protected] | ||
* | ||
*/ | ||
|
||
@Path("/") | ||
public class HiWorld { | ||
@Inject | ||
InjectedService helloService; | ||
|
||
@GET | ||
@Path("/json") | ||
@Produces({ "application/json" }) | ||
public String getHelloWorldJSON() { | ||
return "{\"result\":\"" + helloService.createHelloMessage("World") + "\"}"; | ||
} | ||
|
||
@GET | ||
@Path("/xml") | ||
@Produces({ "application/xml" }) | ||
public String getHelloWorldXML() { | ||
return "<xml><result>" + helloService.createHelloMessage("World") + "</result></xml>"; | ||
} | ||
|
||
} |
11 changes: 11 additions & 0 deletions
11
rules/rules-reviewed/quarkus/java-ee/tests/data-jakarta/transitive/InjectedService.java
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,11 @@ | ||
package sample; | ||
|
||
|
||
|
||
public class InjectedService { | ||
|
||
String createHelloMessage(String name) { | ||
return "Hello " + name + "!"; | ||
} | ||
|
||
} |
53 changes: 53 additions & 0 deletions
53
rules/rules-reviewed/quarkus/java-ee/tests/data-jakarta/transitive/pom.xml
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,53 @@ | ||
<?xml version="1.0" encoding="UTF-8"?> | ||
<!-- | ||
JBoss, Home of Professional Open Source | ||
Copyright 2015, Red Hat, Inc. and/or its affiliates, and individual | ||
contributors by the @authors tag. See the copyright.txt in the | ||
distribution for a full listing of individual contributors. | ||
Licensed under the Apache License, Version 2.0 (the "License"); | ||
you may not use this file except in compliance with the License. | ||
You may obtain a copy of the License at | ||
http://www.apache.org/licenses/LICENSE-2.0 | ||
Unless required by applicable law or agreed to in writing, software | ||
distributed under the License is distributed on an "AS IS" BASIS, | ||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
See the License for the specific language governing permissions and | ||
limitations under the License. | ||
--> | ||
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" | ||
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> | ||
<modelVersion>4.0.0</modelVersion> | ||
<parent> | ||
<groupId>org.jboss.eap.quickstarts</groupId> | ||
<artifactId>quickstart-parent</artifactId> | ||
<!-- | ||
Maintain separation between the artifact id and the version to help prevent | ||
merge conflicts between commits changing the GA and those changing the V. | ||
--> | ||
<version>7.2.0.GA</version> | ||
<relativePath>../pom.xml</relativePath> | ||
</parent> | ||
<artifactId>helloworld-rs</artifactId> | ||
<packaging>war</packaging> | ||
<name>Quickstart: helloworld-rs</name> | ||
<description>A simple Hello World project that uses JAX-RS</description> | ||
|
||
<licenses> | ||
<license> | ||
<name>Apache License, Version 2.0</name> | ||
<url>http://www.apache.org/licenses/LICENSE-2.0.html</url> | ||
<distribution>repo</distribution> | ||
</license> | ||
</licenses> | ||
|
||
|
||
<dependencies> | ||
<dependency> | ||
<groupId>jakarta.platform</groupId> | ||
<artifactId>jakarta.jakarta-api</artifactId> | ||
<version>8.0</version> | ||
<scope>provided</scope> | ||
</dependency> | ||
</dependencies> | ||
</project> |
Oops, something went wrong.