* @param value
* @param label
* a potentially distinct label
- * @return
+ * @return the link
*/
public static String getPhoneLink(String value, String label) {
StringBuilder builder = new StringBuilder();
* @param value
* @param label
* a potentially distinct label
- * @return
+ * @return the link
*/
public static String getMailLink(String value, String label) {
StringBuilder builder = new StringBuilder();
* UI Tree component that implements the Argeo abstraction of a
* {@link RepositoryFactory} that enable a user to "mount" various repositories
* in a single Tree like View. It is usually meant to be at the root of the UI
- * Tree and thus {@link getParent()} method will return null.
+ * Tree and thus {@link #getParent()} method will return null.
*
* The {@link RepositoryFactory} is injected at instantiation time and must be
* use get or register new {@link Repository} objects upon which a reference is
* @param viewer
* @param e1
* @param e2
- * @return
+ * @return the comparison
*/
@Override
public int compare(Viewer viewer, Object e1, Object e2) {
* @param viewer
* @param e1
* @param e2
- * @return
+ * @return the comparison
*/
@Override
public int compare(Viewer viewer, Object e1, Object e2) {
*
* @param node the node
* @param mixins the mixins
- * @return the created node
* @see Node#addMixin(String)
*/
public static void addMixin(Node node, String... mixins) {
* An attribute type MUST consistently parse a string to an object so that
* <code>parse(obj.toString()).equals(obj)</code> is verified.
* {@link #format(Object)} can be overridden to provide more efficient
- * implementations but the returned
- * <code>String<code> MUST be the same, that is <code>format(obj).equals(obj.toString())</code>
- * is verified.
+ * implementations but the returned <code>String</code> MUST be the same, that
+ * is <code>format(obj).equals(obj.toString())</code> is verified.
*/
public interface AttributeFormatter<T> {
/** Parses a String to a Java object. */
* The UUID v3 of http://www.w3.org/2000/xmlns/ within the standard DNS
* namespace, to be used as a base for the namespaces.
*
- * @see https://www.w3.org/TR/xml-names/#ns-decl
+ * @see "https://www.w3.org/TR/xml-names/#ns-decl"
*/
// uuidgen --md5 --namespace @dns --name http://www.w3.org/2000/xmlns/
// NOTE : must be declared before default namespaces
/**
* Minimal standard attribute types that MUST be supported. All related classes
* belong to java.base and can be implicitly derived form a given
- * <code>String<code>.
+ * <code>String</code>.
*/
public enum CrAttributeType {
BOOLEAN(Boolean.class, W3C_XML_SCHEMA_NS_URI, "boolean", new BooleanFormatter()), //
Objects.requireNonNull(value, "Cannot cast a null value");
if (String.class.isAssignableFrom(clss)) {
return Optional.of((T) value.toString());
- }
+ }
// Numbers
else if (Long.class.isAssignableFrom(clss)) {
if (value instanceof Long)
* Name for core concepts with the same semantics as defined in the WebDav
* standard and extensions.
*
- * @see http://www.webdav.org/specs/rfc4918.html
- * @see http://www.webdav.org/specs/rfc3744.html
+ * @see "http://www.webdav.org/specs/rfc4918.html"
+ * @see "http://www.webdav.org/specs/rfc3744.html"
*/
public enum DName implements QNamed
}
/**
- * If positive, only clock_hi is taken from the argument (range & 0x3F00), if
+ * If positive, only clock_hi is taken from the argument (range amp; 0x3F00), if
* negative, the full range of possible values is used.
*/
public void setCurrentClockSequenceRange(long range) {
/**
* Implementation of the basic RFC4122 algorithms.
*
- * @see https://datatracker.ietf.org/doc/html/rfc4122
+ * @see "https://datatracker.ietf.org/doc/html/rfc4122"
*/
public abstract class AbstractUuidFactory implements UuidFactory {
/**
* Force this node id to be identified as no MAC address.
*
- * @see https://datatracker.ietf.org/doc/html/rfc4122#section-4.5
+ * @see "https://datatracker.ietf.org/doc/html/rfc4122#section-4.5"
*/
protected static void forceToNoMacAddress(byte[] nodeId, int offset) {
assert nodeId != null && offset < nodeId.length;
}
/**
- * Always returns <code>true</true> since it is unknown from which values it was
+ * Always returns <code>true</code> since it is unknown from which values it was
* constructed..
*/
@Override
import java.util.Objects;
import java.util.Set;
import java.util.WeakHashMap;
+import java.util.concurrent.ForkJoinPool;
import java.util.concurrent.atomic.AtomicLong;
import org.argeo.api.uuid.UuidFactory.TimeUuidState;
* sequences. If that limit is reached, the clock sequence which has not be used
* for the most time is reallocated to the new thread. It is assumed that the
* context where time uUIDs will be generated will often be using thread pools
- * (e.g. {@link ForkJoinPool#commonPool(), http server, database access, etc.)
+ * (e.g. {@link ForkJoinPool#commonPool()}, http server, database access, etc.)
* and that such reallocation won't have to happen too often.
*/
public class ConcurrentTimeUuidState implements UuidFactory.TimeUuidState {
* A configurable implementation of an {@link AsyncUuidFactory}, which can be
* used as a base class for more optimised implementations.
*
- * @see https://datatracker.ietf.org/doc/html/rfc4122
+ * @see "https://datatracker.ietf.org/doc/html/rfc4122"
*/
public class ConcurrentUuidFactory extends AbstractAsyncUuidFactory implements TypedUuidFactory {
// private final static Logger logger = System.getLogger(ConcurrentUuidFactory.class.getName());
/**
* A variant 6 {@link UUID}.
*
- * @see https://datatracker.ietf.org/doc/html/rfc4122#section-4.1.1
+ * @see "https://datatracker.ietf.org/doc/html/rfc4122#section-4.1.1"
*/
public class GUID extends TypedUuid {
private static final long serialVersionUID = APM.SERIAL;
* <li>P: (1db31359-bdd8-5a0f-b672-30c247d582c5)</li>
* </ul>
*
- * @see https://docs.microsoft.com/en-us/dotnet/api/system.guid.tostring
+ * @see "https://docs.microsoft.com/en-us/dotnet/api/system.guid.tostring"
*/
public static String toString(UUID uuid, char format, boolean upperCase) {
String str;
* An {@link UUID} factory whose node id (for time based UUIDs) is the hardware
* MAC address as specified in RFC4122.
*
- * @see https://datatracker.ietf.org/doc/html/rfc4122.html#section-4.1.6
+ * @see "https://datatracker.ietf.org/doc/html/rfc4122.html#section-4.1.6"
*/
public class MacAddressUuidFactory extends ConcurrentUuidFactory {
public MacAddressUuidFactory() {
* {@link Supplier#get()} method MUST be a v4 UUID (random).
*
* @see UUID
- * @see https://datatracker.ietf.org/doc/html/rfc4122
+ * @see "https://datatracker.ietf.org/doc/html/rfc4122"
*/
public interface UuidFactory extends Supplier<UUID> {
* Whether this UUID is time based but was not generated from an IEEE 802
* address, as per Section 4.5 of RFC4122.
*
- * @see https://datatracker.ietf.org/doc/html/rfc4122#section-4.5
+ * @see "https://datatracker.ietf.org/doc/html/rfc4122#section-4.5"
*/
static boolean isTimeBasedWithMacAddress(UUID uuid) {
if (uuid.version() == 1) {
* The state of a time based UUID generator, as described and discussed in
* section 4.2.1 of RFC4122.
*
- * @see https://datatracker.ietf.org/doc/html/rfc4122#section-4.2.1
+ * @see "https://datatracker.ietf.org/doc/html/rfc4122#section-4.2.1"
*/
interface TimeUuidState {
/** Current node id and clock sequence for this thread. */
/**
* Workaround for killing Gogo shell by system shutdown.
*
- * @see https://issues.apache.org/jira/browse/FELIX-4208
+ * @see "https://issues.apache.org/jira/browse/FELIX-4208"
*/
class GogoShellKiller extends Thread {
/**
* Standard HTTP response status codes (including WebDav ones).
*
- * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Status
+ * @see "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status"
*/
public enum HttpStatus {
// Successful responses (200–299)
/**
* The status line, as defined by RFC2616.
*
- * @see https://www.rfc-editor.org/rfc/rfc2616#section-6.1
+ * @see "https://www.rfc-editor.org/rfc/rfc2616#section-6.1"
*/
public String getStatusLine(String httpVersion) {
return httpVersion + " " + code + " " + reasonPhrase;
/**
* An object that can be identified with an X.500 distinguished name.
*
- * @see https://tools.ietf.org/html/rfc1779
+ * @see "https://tools.ietf.org/html/rfc1779"
*/
public interface Distinguished {
/** The related distinguished name. */
/**
* {@link MouseListener#mouseDoubleClick(MouseEvent)} as a functional interface
* in order to use as a short lambda expression in UI code.
- * {@link MouseListener#mouseDownouseEvent)} and
+ * {@link MouseListener#mouseDown(MouseEvent)} and
* {@link MouseListener#mouseUp(MouseEvent)} do nothing by default.
*/
@FunctionalInterface