Skip to content

Commit f54e3fe

Browse files
committed
Validate Javadoc as part of the checks. (#396)
metafacture-biblio/src/main/java/org/metafacture/biblio/iso2709/RecordBuilder.java:398: warning - Tag @see: reference not found: AppendState#ID_FIELD metafacture-io/src/main/java/org/metafacture/io/ObjectWriter.java:56: warning - #STDOUT (referenced by @value tag) is an unknown reference. metafacture-monitoring/src/main/java/org/metafacture/monitoring/ObjectBatchLogger.java:68: warning - #DEFAULT_FORMAT (referenced by @value tag) is an unknown reference. metafacture-xml/src/main/java/org/metafacture/xml/GenericXmlHandler.java:62: warning - #RECORD_TAG_PROPERTY (referenced by @value tag) is an unknown reference. metafacture-xml/src/main/java/org/metafacture/xml/GenericXmlHandler.java:93: warning - DEFAULT_RECORD_TAG (referenced by @value tag) is an unknown reference. metamorph/src/main/java/org/metafacture/metamorph/functions/ISBN.java:101: warning - #ISBN10 (referenced by @value tag) is an unknown reference. metamorph/src/main/java/org/metafacture/metamorph/functions/ISBN.java:101: warning - #ISBN13 (referenced by @value tag) is an unknown reference. metamorph/src/main/java/org/metafacture/metamorph/functions/Unique.java:80: warning - #NAME (referenced by @value tag) is an unknown reference. metamorph/src/main/java/org/metafacture/metamorph/functions/Unique.java:80: warning - #VALUE (referenced by @value tag) is an unknown reference.
1 parent 8b74457 commit f54e3fe

File tree

7 files changed

+19
-13
lines changed

7 files changed

+19
-13
lines changed

build.gradle

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,7 @@ subprojects {
5858
apply plugin: 'checkstyle'
5959

6060
check.dependsOn(editorconfigCheck)
61+
check.dependsOn(javadoc)
6162

6263
sourceCompatibility = 1.8
6364
targetCompatibility = 1.8
@@ -81,6 +82,12 @@ subprojects {
8182
group 'build'
8283
}
8384

85+
javadoc {
86+
options {
87+
addBooleanOption 'Xwerror', true
88+
}
89+
}
90+
8491
artifacts {
8592
archives sourceJar
8693
archives javadocJar

metafacture-biblio/src/main/java/org/metafacture/biblio/iso2709/RecordBuilder.java

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -392,8 +392,6 @@ private void require7BitAscii(final char charCode) {
392392
/**
393393
* Resets the label, directory and the fields. Sets the "append state" to "id
394394
* field".
395-
*
396-
* @see AppendState#ID_FIELD
397395
*/
398396
public void reset() {
399397
label.reset();

metafacture-io/src/main/java/org/metafacture/io/ObjectWriter.java

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,8 @@
4040
@FluxCommand("write")
4141
public final class ObjectWriter<T> implements ConfigurableObjectWriter<T> {
4242

43-
private static final String STDOUT = "stdout";
43+
public static final String STDOUT = "stdout";
44+
4445
private static final List<String> ARGUMENTS = Collections.unmodifiableList(Arrays.asList(STDOUT, "PATH"));
4546

4647
private final ConfigurableObjectWriter<T> objectWriter;

metafacture-monitoring/src/main/java/org/metafacture/monitoring/ObjectBatchLogger.java

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -50,9 +50,9 @@ public final class ObjectBatchLogger<T> extends DefaultObjectPipe<T, ObjectRecei
5050
public static final long DEFAULT_BATCH_SIZE = 1000;
5151
public static final String BATCH_COUNT_VAR = "batches";
5252
public static final String BATCH_SIZE_VAR = "batchSize";
53+
public static final String DEFAULT_FORMAT = "records processed: ${totalRecords}";
5354

5455
private static final Logger LOG = LoggerFactory.getLogger(ObjectBatchLogger.class);
55-
private static final String DEFAULT_FORMAT = "records processed: ${totalRecords}";
5656

5757
private final Map<String, String> vars = new HashMap<String, String>();
5858
private final String format;
@@ -67,7 +67,6 @@ public final class ObjectBatchLogger<T> extends DefaultObjectPipe<T, ObjectRecei
6767
*/
6868
public ObjectBatchLogger() {
6969
this.format = DEFAULT_FORMAT;
70-
7170
}
7271

7372
public ObjectBatchLogger(final String format) {

metafacture-xml/src/main/java/org/metafacture/xml/GenericXmlHandler.java

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -40,12 +40,12 @@
4040
@FluxCommand("handle-generic-xml")
4141
public final class GenericXmlHandler extends DefaultXmlPipe<StreamReceiver> {
4242

43+
public static final String RECORD_TAG_PROPERTY = "org.culturegraph.metamorph.xml.recordtag";
44+
4345
public static final boolean EMIT_NAMESPACE = false;
4446

4547
private static final Pattern TABS = Pattern.compile("\t+");
4648

47-
private static final String RECORD_TAG_PROPERTY = "org.culturegraph.metamorph.xml.recordtag";
48-
4949
private String attributeMarker = DEFAULT_ATTRIBUTE_MARKER;
5050
private String recordTagName = DEFAULT_RECORD_TAG;
5151
private String valueTagName = DEFAULT_VALUE_TAG;
@@ -86,7 +86,7 @@ public GenericXmlHandler(final String recordTagName) {
8686
* This value may only be changed between records. If it is changed
8787
* while processing a record the behaviour of this module is undefined.
8888
* <p>
89-
* <strong>Default value: {@value DEFAULT_RECORD_TAG}</strong>
89+
* <strong>Default value: {@value org.metafacture.framework.helpers.DefaultXmlPipe#DEFAULT_RECORD_TAG}</strong>
9090
*
9191
* @param recordTagName the tag name which marks the start of a record.
9292
*/

metamorph/src/main/java/org/metafacture/metamorph/functions/ISBN.java

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,10 +28,11 @@
2828
*/
2929
public final class ISBN extends AbstractSimpleStatelessFunction {
3030

31+
public static final String ISBN10 = "isbn10";
32+
public static final String ISBN13 = "isbn13";
33+
3134
private static final String CHECK = "0123456789X0";
3235

33-
private static final String ISBN10 = "isbn10";
34-
private static final String ISBN13 = "isbn13";
3536
private static final Pattern ISBN_PATTERN = Pattern.compile("[\\dX]+");
3637
private static final Pattern DIRT_PATTERN = Pattern.compile("[\\.\\-]");
3738
private static final int ISBN10_SIZE = 10;

metamorph/src/main/java/org/metafacture/metamorph/functions/Unique.java

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -29,9 +29,9 @@
2929
*/
3030
public final class Unique extends AbstractStatefulFunction {
3131

32-
private static final String ENTITY = "entity";
33-
private static final String NAME = "name";
34-
private static final String VALUE = "value";
32+
public static final String ENTITY = "entity";
33+
public static final String NAME = "name";
34+
public static final String VALUE = "value";
3535

3636
private final Set<String> set = new HashSet<String>();
3737

0 commit comments

Comments
 (0)