JarCastingWhat is this fork for?
I wanted Jaci to work on the libgdx GWT backend, so here is a very ugly fix. Later on I will fix it up so it is non-instrusive using emulation. If you want to use this specifically for GWT backend, you must use 1.8.0 which fixes certain reflection methods in GWT.
What is Jaci?
Java Annotation Command Interface.
Jaci generates User Interfaces (CLI/GUI) from annotated methods, which can then be embedded into your application.
What is Jaci for?
Jaci is geared towards 2 things:
- Creating debug consoles - A debug console doesn't need to look pretty, it needs to be convenient to work with (at runtime) and convenient to add commands to (at dev time).
- Creating quick, throw-away prototype code - When you just need to quickly test some logic (or learn a new API), just write the logic, add annotations and let Jaci generate the UI.
Example
@CommandPath("example/simple")
public class Example {
private CommandOutput output;
@Command(description = "Does nothing, really.")
public void simpleCommand(@StringParam(value = "str1", accepts = {"a", "b", "c"}) String str1,
@StringParam(value = "str2", acceptsSupplier = "strSupplier", optional = true, defaultValue = "default") String str2,
@IntParam("int") int i,
@DoubleParam(value = "double", optional = true, defaultValueSupplier = "doubleSupplier") double d,
@BoolParam(value = "flag", optional = true) boolean flag) {
output.message("str1=%s, str2=%s, i=%d, d=%s, flag=%s", str1, str2, i, d, flag);
}
}
private String[] strSupplier() {
return new String[] {"d", "e", "f"};
}
private double doubleSupplier() {
return 3.5;
}
Let's explain what's going on here:
- Example defines a directory that has 1 command and is mounted at: 'example/simple'.
- There is a private, non-initialized CommandOutput parameter. CommandOutput is the way by which commands send output to the host application. When processing a class, Jaci will inject any fields of the type CommandOutput with an implementing instance.
- The single command that is defined in the class, 'simpleCommand' has 5 parameters:
- A mandatory string called
str1that only accepts the values {a,b,c}. - An optional string called
str2that only accepts the values {d,e,f} (supplied by a supplier method). If the parameter doesn't receive a value, it will have a value ofdefault. - A mandatory int called
int. - An optional double called
double. If the parameter doesn't receive a value, it will have a value of3.5(supplied by a supplier method). - An optional boolean called
flag.
- A mandatory string called
- The command then just sends the parameter values to the output. The string sent to the output will be formatted with String.format().
Here is how this looks on a LibGdx CLI implementation:
Full Documentation
See the Wiki for full documentation.
Binaries
The binaries depend on your choice of UI-platform:
- LibGdx CLI:
<dependency>
<groupId>com.unseenspace</groupId>
<artifactId>jaci-libgdx-cli</artifactId>
<version>0.2.1</version>
</dependency>
Change log
See Change Log
License
Copyright 2014 Yevgeny Krasik.
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.