https://github.com/auties00/reified
Reified in Java 11 and upwards
https://github.com/auties00/reified
java java11 java17 kotlin reified
Last synced: 9 months ago
JSON representation
Reified in Java 11 and upwards
- Host: GitHub
- URL: https://github.com/auties00/reified
- Owner: Auties00
- Created: 2021-06-27T12:48:37.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-03-30T09:18:09.000Z (9 months ago)
- Last Synced: 2025-04-06T03:43:24.841Z (9 months ago)
- Topics: java, java11, java17, kotlin, reified
- Language: Java
- Homepage:
- Size: 222 KB
- Stars: 58
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Reified
Reified in Java 11 and upwards
### What is Reified
Reified is an Annotation for Java 11 and upwards inspired by the reified keyword in Kotlin.
Kotlin's approach requires the instruction to also be inlined, excluding as a result classes by design.
This library supports also classes instead as inlining is not needed.
Reified creates a local variable, or a parameter of type Class for each type parameter annotated.
The correct type is deduced and passed to the tree that owns the type variable
based on the enclosing statements(ex. return statements and variable declarations) and the type parameters of the invocation.
If a non annotated type parameter is needed to determine the type of annotated one, Reified will take care of automatically applying
the same process to said parameters to determine the first.
### How to install
#### Maven
```xml
com.github.auties00
reified
2.0
org.apache.maven.plugins
maven-compiler-plugin
3.8.1
com.github.auties00
reified
2.0
```
#### Gradle
```groovy
implementation 'com.github.auties00:reified:2.0'
annotationProcessor 'com.github.auties00:reified:2.0'
```
#### Plugins
In order to make linting work in your favourite IDE, a plugin is needed.
Most common IDEs:
1. IntelliJ - [IntelliJ Marketplace](https://plugins.jetbrains.com/plugin/17786-reified), [Source Code](https://github.com/Auties00/ReifiedIdeaPlugin)
2. Eclipse - Not yet
3. NetBeans - Not yet
### Example
With reified:
```java
class JsonUtils {
private static final ObjectMapper JACKSON = new ObjectMapper();
public static <@Reified T> T fromJson(String json){
try {
return JACKSON.readValue(json, T);
} catch (IOException exception) {
throw new UncheckedIOException(exception);
}
}
}
record ExampleObject(String name) {
public static ExampleObject fromJson(String json){
return JsonUtils.fromJson(json);
}
}
```
Without reified:
```java
import java.io.IOException;
import java.io.UncheckedIOException;
class JsonUtils {
private static final ObjectMapper JACKSON = new ObjectMapper();
public static T fromJson(String json, Class clazz) {
try {
return JACKSON.readValue(json, clazz);
} catch (IOException exception) {
throw new UncheckedIOException(exception);
}
}
}
record ExampleObject(String name) {
public static ExampleObject fromJson(String json) {
return JsonUtils.fromJson(json, ExampleObject.class);
}
}
```