Interface Segregation Principle Code Generation Tool
JISEL 1.2 released:
- Added new annotations (@UnSeal, @Detach and @DetachAll) allowing to generate pre-java 17 “unsealed” interfaces during the Segregation process
- Existing Annotations on top of interfaces, methods or parameters are now replicated in the generated interfaces or classes
- Bug fixes and improvements
Code Migration to Java 17 using FROPOREC and JISEL - https://youtu.be/iML8EjMIDLc
Integrating Jisel with Spring: Segregation of a Spring Data JPA Repository - PDF
v1.2: UnSeal & Detach - https://youtu.be/HOssFTKPQRM
v1.1 Quick Intro - https://youtu.be/cbYdt8NRUaM
Project’s Pitch (v1.0) - https://youtu.be/nkbu6zxV3R0
If you are running a Maven project, add the latest release dependency to your pom.xml
<dependency>
<groupId>org.jisel</groupId>
<artifactId>jisel</artifactId>
<version>1.2</version>
</dependency>
You will also need to include the same dependency as an additional annotation processor in the Maven Compiler plugin of your project
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>${maven-compiler-plugin.version}</version>
<configuration>
<release>17</release>
<compilerArgs>-Xlint:unchecked</compilerArgs>
<annotationProcessorPaths>
<path>
<groupId>org.jisel</groupId>
<artifactId>jisel</artifactId>
<version>1.2</version>
</path>
</annotationProcessorPaths>
</configuration>
</plugin>
</plugins>
</build>
For other build tools, please check: Maven Central.
https://javadoc.io/doc/org.jisel/jisel/latest/jisel
public interface Sociable {
String STUDENT = "Student";
String WORKER = "Worker";
String ACTIVE_WORKER = "ActiveWorker";
@TopLevel
String startConversation() throws IllegalStateException;
@SealFor(STUDENT)
boolean attendClass(String fieldOfStudy) throws IllegalArgumentException;
@SealFor(STUDENT)
void askForHelpWhenNeeded();
@SealFor({WORKER, ACTIVE_WORKER})
boolean[] joinOfficeSocialGroups(String[] groups, int maximum);
@SealFor(ACTIVE_WORKER)
void leadOfficeSocialGroup(String groupName);
@SealFor(ACTIVE_WORKER)
double createNewOfficeSocialGroup(String groupName, List<String> starters) throws ArithmeticException;
}
Annotation to be applied on top of a class, interface or record, which is implementing or extending a sealed interface generated by Jisel.
Expects 2 arguments:
@AddTo(profiles = {STUDENT, WORKER}, largeInterface = Sociable.class)
public final class StudentWorkerHybrid implements SealedStudentSociable, SealedWorkerSociable {
@Override
public String startConversation() throws IllegalStateException {
return null;
}
@Override
public void askForHelpWhenNeeded() {
}
@Override
public boolean attendClass(String param0) throws IllegalArgumentException {
return false;
}
@Override
public boolean[] joinOfficeSocialGroups(String[] param0, int param1) {
return new boolean[0];
}
}
Annotation to be applied only on top of large interfaces to segregate.
Generates a classic pre-java 17 interfaces hierarchy, which is basically the Interface Segregation Principle applied without sealing the hierarchy.
The unsealed hierarchy interfaces are generated additionally to the sealed hierarchy generated files, and stored in the created unsealed sub-package. Each one of the generated interfaces follows the naming convention: <ProfileName><LargeInterfaceSimpleName> (<LargeInterfaceSimpleName> is the simplename of the large interface being segregated).
Note: This annotation will not work if @TopLevel is NOT used anywhere within the large interface.
@UnSeal
public interface Sociable {
String STUDENT = "Student";
@TopLevel
String startConversation() throws IllegalStateException;
@SealFor(STUDENT)
boolean attendClass(String fieldOfStudy) throws IllegalArgumentException;
...
}
Repeatable annotation to apply on top of a large interface being segregated.
Expects a mandatory profile attribute String value corresponding to one of the profiles provided using the @SealFor annotation.
Result will be the generation of an (unsealed) interface for the specified profile. The generated interface contains all abstract methods which have been tagged for the specified profile (through the use of @SealFor).
Also, as the generated interface is “detached” from the generated sealed hierarchy, no inheritance declaration clause (extends) is generated.
Flexibility is offered, allowing to choose a new name for the generated interface, specify which superInterfaces (along with generics) the generated interface should extend, and list qualified names of annotations (along with their attributes/values) to be added on top of the generated interface.
All generated detached interfaces are stored in the created detached sub-package.
Note: This annotation will not work if @TopLevel is NOT used anywhere within the large interface, or if the specified profile is none of the ones provided though the @SealFor annotation.
@Detach(
profile = ACTIVE_WORKER,
rename = ACTIVE_WORKER + "With2SuperInterfaces",
superInterfaces = {Processor.class, Drivable.class},
applyAnnotations = """
@java.lang.Deprecated
@java.lang.SuppressWarnings({"unchecked", "deprecation", "unused", "testing", "anotherTestValue"})
@javax.annotation.processing.SupportedOptions("")
@javax.annotation.processing.SupportedAnnotationTypes("type1")
"""
)
@Detach(profile = STUDENT, rename = "DeprecatedStudent", applyAnnotations = "@java.lang.Deprecated")
public interface Sociable {
String STUDENT = "Student";
String WORKER = "Worker";
String ACTIVE_WORKER = "ActiveWorker";
@TopLevel
String startConversation() throws IllegalStateException;
@SealFor(STUDENT)
boolean attendClass(String fieldOfStudy) throws IllegalArgumentException;
...
}
Annotation to apply on top of a large interface being segregated.
Result will be the generation of (unsealed) interfaces generated, each one corresponding to each profile provided through the use of the @SealFor annotation. Also, each generated interface contains all tagged abstract methods for each profile.
Does not provide as much flexibility as the @Detach annotation.
All generated detached interfaces are stored in the created detached.all sub-package.
Note: This annotation will not work if @TopLevel is NOT used anywhere within the large interface.
@DetachAll
public interface Sociable {
String STUDENT = "Student";
String WORKER = "Worker";
String ACTIVE_WORKER = "ActiveWorker";
@TopLevel
String startConversation() throws IllegalStateException;
@SealFor(STUDENT)
boolean attendClass(String fieldOfStudy) throws IllegalArgumentException;
...
}
https://github.com/mohamed-ashraf-bayor/jisel-annotation-client
https://github.com/mohamed-ashraf-bayor/jisel-integration-with-spring
Contribute to the project’s growth by reporting issues or making improvement suggestions here