Declarative wrapping

[langsamu]

Towards annotation-based declarative wrapping inspired by @acoburn.

[langsamu]

At the moment, in the test module, from these annotated wrapper interfaces

rdf-wrapping-java/declarative/test/src/main/java/com/inrupt/rdf/wrapping/declarative/test/X.java

Lines 27 to 35 in f15dd4d

	@Dataset
	public interface X {
	@Graph
	interface Y {
	@Resource
	interface Z {
	}
	}
	}

the following three implementation classes are generated during compilation in declarative/test/target/generated-sources/annotations/com/inrupt/rdf/wrapping/declarative/test.

1. Dataset

package com.inrupt.rdf.wrapping.declarative.test;

import javax.annotation.processing.Generated;

import org.apache.jena.sparql.core.DatasetGraph;
import org.apache.jena.sparql.core.DatasetImpl;

/**
 * Warning this class consists of generated code.
 */
@Generated(value = "com.inrupt.rdf.wrapping.declarative.processor.Processor", date = "2023-08-06T15:55:50.076240700Z")
public class X_$impl extends DatasetImpl implements com.inrupt.rdf.wrapping.declarative.test.X {
    protected X_$impl(final DatasetGraph original) {
        super(original);
    }
}

2. Graph

package com.inrupt.rdf.wrapping.declarative.test;

import javax.annotation.processing.Generated;

import org.apache.jena.graph.Graph;
import org.apache.jena.rdf.model.impl.ModelCom;

/**
 * Warning this class consists of generated code.
 */
@Generated(value = "com.inrupt.rdf.wrapping.declarative.processor.Processor", date = "2023-08-06T15:55:50.076240700Z")
public class X$Y_$impl extends ModelCom implements com.inrupt.rdf.wrapping.declarative.test.X.Y {
    protected X$Y_$impl(final Graph original) {
        super(original);
    }
}

3. Node

package com.inrupt.rdf.wrapping.declarative.test;

import com.inrupt.rdf.wrapping.jena.UriOrBlankFactory;
import com.inrupt.rdf.wrapping.jena.WrapperResource;

import javax.annotation.processing.Generated;

import org.apache.jena.enhanced.EnhGraph;
import org.apache.jena.enhanced.Implementation;
import org.apache.jena.graph.Node;

/**
 * Warning this class consists of generated code.
 */
@Generated(value = "com.inrupt.rdf.wrapping.declarative.processor.Processor", date = "2023-08-06T15:55:50.076240700Z")
public class X$Y$Z_$impl extends WrapperResource implements com.inrupt.rdf.wrapping.declarative.test.X.Y.Z {
    static final Implementation factory = new UriOrBlankFactory(X$Y$Z_$impl::new);

    protected X$Y$Z_$impl(final Node node, final EnhGraph graph) {
        super(node, graph);
    }
}

[acoburn]

Minor: package names in java are generally singular. For annotations, both Jackson and JSON-B use just annotation for their annotation libraries. So I would change annotations to just annotation.

Also, I would probably remove the declarative qualifier in the name, so just com.inrupt.rdf.wrapping.annotation

[langsamu]

Have now added wrap methods.

Generating with JDeparser instead of string manipultaion, which is lovely. It's how JBoss Logging Tools generate their implementations.