Skip to content

Commit c294a1c

Browse files
adamretteradamretter
committed
[bugfix] Fix Javadoc errors and warnings
1 parent 3d5f338 commit c294a1c

File tree

13 files changed

+223
-23
lines changed

13 files changed

+223
-23
lines changed

‎exist-core/pom.xml‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -860,6 +860,7 @@
860860
<include>src/main/java/org/exist/protocolhandler/xmlrpc/XmlrpcUpload.java</include>
861861
<include>src/main/java/org/exist/repo/ClasspathHelper.java</include>
862862
<include>src/main/java/org/exist/repo/Deployment.java</include>
863+
<include>src/main/java/org/exist/repo/ExistRepository.java</include>
863864
<include>src/main/java/org/exist/scheduler/impl/QuartzSchedulerImpl.java</include>
864865
<include>src/main/java/org/exist/security/EffectiveSubject.java</include>
865866
<include>src/main/java/org/exist/security/SecurityManager.java</include>
@@ -1085,6 +1086,7 @@
10851086
<exclude>src/main/java/org/exist/protocolhandler/xmlrpc/XmlrpcUpload.java</exclude>
10861087
<exclude>src/main/java/org/exist/repo/ClasspathHelper.java</exclude>
10871088
<exclude>src/main/java/org/exist/repo/Deployment.java</exclude>
1089+
<exclude>src/main/java/org/exist/repo/ExistRepository.java</exclude>
10881090
<exclude>src/main/java/org/exist/scheduler/impl/QuartzSchedulerImpl.java</exclude>
10891091
<exclude>src/main/java/org/exist/security/EffectiveSubject.java</exclude>
10901092
<exclude>src/main/java/org/exist/security/SecurityManager.java</exclude>

‎exist-core/src/main/java/org/exist/dom/persistent/DocumentImpl.java‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -546,6 +546,10 @@ public void setLockToken(final LockToken token) {
546546
}
547547

548548
/**
549+
* Get the Document Type.
550+
*
551+
* @return the document type.
552+
*
549553
* @deprecated use {@link #getDoctype()}.
550554
*/
551555
@Deprecated

‎exist-core/src/main/java/org/exist/repo/ExistRepository.java‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,28 @@
11
/*
2+
* Elemental
3+
* Copyright (C) 2024, Evolved Binary Ltd
4+
*
5+
* [email protected]
6+
* https://www.evolvedbinary.com | https://www.elemental.xyz
7+
*
8+
* This library is free software; you can redistribute it and/or
9+
* modify it under the terms of the GNU Lesser General Public
10+
* License as published by the Free Software Foundation; version 2.1.
11+
*
12+
* This library is distributed in the hope that it will be useful,
13+
* but WITHOUT ANY WARRANTY; without even the implied warranty of
14+
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15+
* Lesser General Public License for more details.
16+
*
17+
* You should have received a copy of the GNU Lesser General Public
18+
* License along with this library; if not, write to the Free Software
19+
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20+
*
21+
* NOTE: Parts of this file contain code from 'The eXist-db Authors'.
22+
* The original license header is included below.
23+
*
24+
* =====================================================================
25+
*
226
* eXist-db Open Source Native XML Database
327
* Copyright (C) 2001 The eXist-db Authors
428
*
@@ -286,6 +310,8 @@ public Path resolveXQueryModule(final String namespace) throws XPathException {
286310
* @param xqueryPath the path to the xquery within the EXPath filesystem repo.
287311
*
288312
* @return the database source for the xquery, or null.
313+
*
314+
* @throws PermissionDeniedException if the caller is not authorized.
289315
*/
290316
public @Nullable org.exist.source.Source resolveStoredXQueryModuleFromDb(final DBBroker broker, final Path xqueryPath) throws PermissionDeniedException {
291317
if (!xqueryPath.startsWith(expathDir)) {

‎extensions/contentextraction/pom.xml‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -180,6 +180,7 @@
180180
<include>pom.xml</include>
181181
<include>src/test/resources-filtered/conf.xml</include>
182182
<include>src/test/resources/log4j2.xml</include>
183+
<include>src/main/java/org/exist/contentextraction/ContentReceiver.java</include>
183184
</includes>
184185
</licenseSet>
185186

@@ -192,6 +193,7 @@
192193
<exclude>pom.xml</exclude>
193194
<exclude>src/test/resources-filtered/conf.xml</exclude>
194195
<exclude>src/test/resources/log4j2.xml</exclude>
196+
<exclude>src/main/java/org/exist/contentextraction/ContentReceiver.java</exclude>
195197
<exclude>src/test/java/org/exist/contentextraction/xquery/Util.java</exclude>
196198
</excludes>
197199
</licenseSet>

‎extensions/contentextraction/src/main/java/org/exist/contentextraction/ContentReceiver.java‎

Lines changed: 31 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,28 @@
11
/*
2+
* Elemental
3+
* Copyright (C) 2024, Evolved Binary Ltd
4+
*
5+
* [email protected]
6+
* https://www.evolvedbinary.com | https://www.elemental.xyz
7+
*
8+
* This library is free software; you can redistribute it and/or
9+
* modify it under the terms of the GNU Lesser General Public
10+
* License as published by the Free Software Foundation; version 2.1.
11+
*
12+
* This library is distributed in the hope that it will be useful,
13+
* but WITHOUT ANY WARRANTY; without even the implied warranty of
14+
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15+
* Lesser General Public License for more details.
16+
*
17+
* You should have received a copy of the GNU Lesser General Public
18+
* License along with this library; if not, write to the Free Software
19+
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20+
*
21+
* NOTE: Parts of this file contain code from 'The eXist-db Authors'.
22+
* The original license header is included below.
23+
*
24+
* =====================================================================
25+
*
226
* eXist-db Open Source Native XML Database
327
* Copyright (C) 2001 The eXist-db Authors
428
*
@@ -66,12 +90,13 @@ public class ContentReceiver implements Receiver {
6690
private boolean sendDataToCB = false;
6791

6892
/**
69-
* Receiver constructor
70-
*
71-
* @param context The XQuery context
72-
* @param paths Paths that must be extracted from the TIKA XHTML document
73-
* @param ref Reference to callback function
74-
* @param userData Additional user supplied datas
93+
* Receiver constructor
94+
*
95+
* @param expression the calling expression.
96+
* @param context The XQuery context.
97+
* @param paths Paths that must be extracted from the TIKA XHTML document.
98+
* @param ref Reference to callback function.
99+
* @param userData Additional user supplied data.
75100
*/
76101
public ContentReceiver(final Expression expression, XQueryContext context, NodePath[] paths, FunctionReference ref, Sequence userData) {
77102
this.expression = expression;

‎extensions/modules/compression/pom.xml‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -162,6 +162,7 @@
162162
<include>pom.xml</include>
163163
<include>src/test/resources-filtered/conf.xml</include>
164164
<include>src/test/resources/log4j2.xml</include>
165+
<include>src/main/java/org/exist/xquery/modules/compression/EntryFunctions.java</include>
165166
</includes>
166167
</licenseSet>
167168

@@ -174,6 +175,7 @@
174175
<exclude>pom.xml</exclude>
175176
<exclude>src/test/resources-filtered/conf.xml</exclude>
176177
<exclude>src/test/resources/log4j2.xml</exclude>
178+
<exclude>src/main/java/org/exist/xquery/modules/compression/EntryFunctions.java</exclude>
177179
</excludes>
178180
</licenseSet>
179181

‎extensions/modules/compression/src/main/java/org/exist/xquery/modules/compression/EntryFunctions.java‎

Lines changed: 31 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,28 @@
11
/*
2+
* Elemental
3+
* Copyright (C) 2024, Evolved Binary Ltd
4+
*
5+
* [email protected]
6+
* https://www.evolvedbinary.com | https://www.elemental.xyz
7+
*
8+
* This library is free software; you can redistribute it and/or
9+
* modify it under the terms of the GNU Lesser General Public
10+
* License as published by the Free Software Foundation; version 2.1.
11+
*
12+
* This library is distributed in the hope that it will be useful,
13+
* but WITHOUT ANY WARRANTY; without even the implied warranty of
14+
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15+
* Lesser General Public License for more details.
16+
*
17+
* You should have received a copy of the GNU Lesser General Public
18+
* License along with this library; if not, write to the Free Software
19+
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20+
*
21+
* NOTE: Parts of this file contain code from 'The eXist-db Authors'.
22+
* The original license header is included below.
23+
*
24+
* =====================================================================
25+
*
226
* eXist-db Open Source Native XML Database
327
* Copyright (C) 2001 The eXist-db Authors
428
*
@@ -351,11 +375,14 @@ private enum DataType {
351375
}
352376

353377
/**
354-
* Convert path (URL, file path) to a File object.
378+
* Get a file path.
379+
*
380+
* @param path Path written as OS specific path or as URL.
381+
* @param expression the calling expression.
382+
*
383+
* @return a path to the file.
355384
*
356-
* @param path Path written as OS specific path or as URL
357-
* @return File object
358-
* @throws XPathException Thrown when the URL cannot be used.
385+
* @throws XPathException if the path is an invalid URI.
359386
*/
360387
public static Path getFile(final String path, final Expression expression) throws XPathException {
361388
if(path.startsWith("file:")){

‎extensions/modules/file/pom.xml‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -217,6 +217,8 @@
217217
<include>src/test/resources-filtered/conf.xml</include>
218218
<include>src/test/resources/log4j2.xml</include>
219219
<include>src/test/resources/standalone-webapp/WEB-INF/web.xml</include>
220+
<include>src/main/java/org/exist/xquery/modules/file/FileModuleHelper.java</include>
221+
<include>src/main/java/org/exist/xquery/modules/file/Sync.java</include>
220222
</includes>
221223
</licenseSet>
222224

@@ -230,6 +232,8 @@
230232
<exclude>src/test/resources-filtered/conf.xml</exclude>
231233
<exclude>src/test/resources/log4j2.xml</exclude>
232234
<exclude>src/test/resources/standalone-webapp/WEB-INF/web.xml</exclude>
235+
<exclude>src/main/java/org/exist/xquery/modules/file/FileModuleHelper.java</exclude>
236+
<exclude>src/main/java/org/exist/xquery/modules/file/Sync.java</exclude>
233237
</excludes>
234238
</licenseSet>
235239

‎extensions/modules/file/src/main/java/org/exist/xquery/modules/file/FileModuleHelper.java‎

Lines changed: 32 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,28 @@
11
/*
2+
* Elemental
3+
* Copyright (C) 2024, Evolved Binary Ltd
4+
*
5+
* [email protected]
6+
* https://www.evolvedbinary.com | https://www.elemental.xyz
7+
*
8+
* This library is free software; you can redistribute it and/or
9+
* modify it under the terms of the GNU Lesser General Public
10+
* License as published by the Free Software Foundation; version 2.1.
11+
*
12+
* This library is distributed in the hope that it will be useful,
13+
* but WITHOUT ANY WARRANTY; without even the implied warranty of
14+
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15+
* Lesser General Public License for more details.
16+
*
17+
* You should have received a copy of the GNU Lesser General Public
18+
* License along with this library; if not, write to the Free Software
19+
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20+
*
21+
* NOTE: Parts of this file contain code from 'The eXist-db Authors'.
22+
* The original license header is included below.
23+
*
24+
* =====================================================================
25+
*
226
* eXist-db Open Source Native XML Database
327
* Copyright (C) 2001 The eXist-db Authors
428
*
@@ -33,20 +57,21 @@
3357
*
3458
* @author <a href="mailto:[email protected]">Dannes Wessels</a>
3559
*/
36-
37-
3860
public class FileModuleHelper {
3961

4062
private FileModuleHelper() {
4163
// no instance
4264
}
4365

4466
/**
45-
* Convert path (URL, file path) to a File object.
46-
*
47-
* @param path Path written as OS specific path or as URL
48-
* @return File object
49-
* @throws XPathException Thrown when the URL cannot be used.
67+
* Get a file path.
68+
*
69+
* @param path Path written as OS specific path or as URL.
70+
* @param expression the calling expression.
71+
*
72+
* @return a path to the file.
73+
*
74+
* @throws XPathException if the path is an invalid URI.
5075
*/
5176
public static Path getFile(String path, final Expression expression) throws XPathException {
5277
if(path.startsWith("file:")){

‎extensions/modules/file/src/main/java/org/exist/xquery/modules/file/Sync.java‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,28 @@
11
/*
2+
* Elemental
3+
* Copyright (C) 2024, Evolved Binary Ltd
4+
*
5+
* [email protected]
6+
* https://www.evolvedbinary.com | https://www.elemental.xyz
7+
*
8+
* This library is free software; you can redistribute it and/or
9+
* modify it under the terms of the GNU Lesser General Public
10+
* License as published by the Free Software Foundation; version 2.1.
11+
*
12+
* This library is distributed in the hope that it will be useful,
13+
* but WITHOUT ANY WARRANTY; without even the implied warranty of
14+
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15+
* Lesser General Public License for more details.
16+
*
17+
* You should have received a copy of the GNU Lesser General Public
18+
* License along with this library; if not, write to the Free Software
19+
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20+
*
21+
* NOTE: Parts of this file contain code from 'The eXist-db Authors'.
22+
* The original license header is included below.
23+
*
24+
* =====================================================================
25+
*
226
* eXist-db Open Source Native XML Database
327
* Copyright (C) 2001 The eXist-db Authors
428
*
@@ -515,6 +539,11 @@ private static boolean isExcludedPath(final String rootTargetAbsPath, final Path
515539

516540
/**
517541
* Check if any of the patterns matches the path.
542+
*
543+
* @param patterns the patterns to match in the path.
544+
* @param path the path to search.
545+
*
546+
* @return true if any of the patterns match, false otherwise.
518547
*/
519548
public static boolean matchAny(final Iterable<String> patterns, final String path) {
520549
for (final String pattern : patterns) {

0 commit comments

Comments
 (0)