diff --git a/connector-framework-internal/src/main/java/org/identityconnectors/framework/impl/api/local/ObjectPool.java b/connector-framework-internal/src/main/java/org/identityconnectors/framework/impl/api/local/ObjectPool.java index 23b0f330..eae5a995 100644 --- a/connector-framework-internal/src/main/java/org/identityconnectors/framework/impl/api/local/ObjectPool.java +++ b/connector-framework-internal/src/main/java/org/identityconnectors/framework/impl/api/local/ObjectPool.java @@ -20,6 +20,7 @@ * "Portions Copyrighted [year] [name of copyright owner]" * ==================== * Portions Copyrighted 2010-2015 ForgeRock AS. + * Portions Copyright 2018 Wren Security. */ package org.identityconnectors.framework.impl.api.local; @@ -346,8 +347,8 @@ private PooledObject borrowIdleObject() throws InterruptedException { /** * Closes any idle objects in the pool. - *

- * Existing active objects will remain alive and be allowed to shutdown + * + *

Existing active objects will remain alive and be allowed to shutdown * gracefully, but no more objects will be allocated. */ public void shutdown() { diff --git a/connector-framework-internal/src/main/java/org/identityconnectors/framework/impl/api/local/ObjectPoolHandler.java b/connector-framework-internal/src/main/java/org/identityconnectors/framework/impl/api/local/ObjectPoolHandler.java index 1890340f..0a39c6c3 100644 --- a/connector-framework-internal/src/main/java/org/identityconnectors/framework/impl/api/local/ObjectPoolHandler.java +++ b/connector-framework-internal/src/main/java/org/identityconnectors/framework/impl/api/local/ObjectPoolHandler.java @@ -20,6 +20,7 @@ * "Portions Copyrighted [year] [name of copyright owner]" * ==================== * Portions Copyrighted 2010-2013 ForgeRock AS. + * Portions Copyright 2018 Wren Security. */ package org.identityconnectors.framework.impl.api.local; @@ -31,9 +32,9 @@ public interface ObjectPoolHandler { /** * Validates, copies and updates the original * {@code ObjectPoolConfiguration}. - *

- * This class can validate and if necessary it changes the {@code original} - * configuration. + * + *

This class can validate and if necessary it changes the + * {@code original} configuration. * * @param original * custom configured instance. @@ -43,8 +44,8 @@ public interface ObjectPoolHandler { /** * Makes a new instance of the pooled object. - *

- * This method is called whenever a new instance is needed. + * + *

This method is called whenever a new instance is needed. * * @return new instance of T. */ @@ -52,8 +53,8 @@ public interface ObjectPoolHandler { /** * Tests the borrowed object. - *

- * This method is invoked on head instances to make sure they can be + * + *

This method is invoked on head instances to make sure they can be * borrowed from the pool. * * @param object @@ -63,8 +64,8 @@ public interface ObjectPoolHandler { /** * Disposes the object. - *

- * This method is invoked on every instance when it is being "dropped" from + * + *

This method is invoked on every instance when it is being "dropped" from * the pool (whether due to the response from {@link #testObject(Object)}, * or for reasons specific to the pool implementation.) * @@ -75,8 +76,8 @@ public interface ObjectPoolHandler { /** * Releases any allocated resources. - *

- * Existing active objects will remain alive and be allowed to shutdown + * + *

Existing active objects will remain alive and be allowed to shutdown * gracefully, but no more objects will be allocated. */ public void shutdown(); diff --git a/connector-framework-internal/src/main/java/org/identityconnectors/framework/impl/api/local/operations/AuthenticationImpl.java b/connector-framework-internal/src/main/java/org/identityconnectors/framework/impl/api/local/operations/AuthenticationImpl.java index 152a5803..f7e3491e 100644 --- a/connector-framework-internal/src/main/java/org/identityconnectors/framework/impl/api/local/operations/AuthenticationImpl.java +++ b/connector-framework-internal/src/main/java/org/identityconnectors/framework/impl/api/local/operations/AuthenticationImpl.java @@ -3,6 +3,7 @@ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. * * Copyright 2008-2009 Sun Microsystems, Inc. All rights reserved. + * Portions Copyright 2018 Wren Security. * * The contents of this file are subject to the terms of the Common Development * and Distribution License("CDDL") (the "License"). You may not use this file @@ -44,8 +45,6 @@ public AuthenticationImpl(final ConnectorOperationalContext context, /** * Authenticate using the basic credentials. - * - * @see AuthenticationOpTests#authenticate(String, String) */ public Uid authenticate(final ObjectClass objectClass, final String username, final GuardedString password, diff --git a/connector-framework-internal/src/main/java/org/identityconnectors/framework/impl/api/local/operations/BatchImpl.java b/connector-framework-internal/src/main/java/org/identityconnectors/framework/impl/api/local/operations/BatchImpl.java index 07d364ec..f2257a8d 100644 --- a/connector-framework-internal/src/main/java/org/identityconnectors/framework/impl/api/local/operations/BatchImpl.java +++ b/connector-framework-internal/src/main/java/org/identityconnectors/framework/impl/api/local/operations/BatchImpl.java @@ -2,6 +2,7 @@ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. * * Copyright (c) 2015 ForgeRock AS. All rights reserved. + * Portions Copyright 2018 Wren Security. * * The contents of this file are subject to the terms * of the Common Development and Distribution License @@ -69,9 +70,6 @@ public BatchImpl(final ConnectorOperationalContext context, final Connector conn this.referenceCounter = referenceCounter; } - /** - * {@inherit} - */ public Subscription executeBatch(final List tasks, final Observer observer, final OperationOptions options) { if (tasks == null || tasks.size() == 0) { @@ -109,9 +107,6 @@ public Subscription executeBatch(final List tasks, final Observer observer, final OperationOptions options) { Assertions.nullCheck(batchToken, "batchToken"); diff --git a/connector-framework-internal/src/main/java/org/identityconnectors/framework/impl/api/remote/RemoteWrappedException.java b/connector-framework-internal/src/main/java/org/identityconnectors/framework/impl/api/remote/RemoteWrappedException.java index 64b09bd2..6a1353f9 100755 --- a/connector-framework-internal/src/main/java/org/identityconnectors/framework/impl/api/remote/RemoteWrappedException.java +++ b/connector-framework-internal/src/main/java/org/identityconnectors/framework/impl/api/remote/RemoteWrappedException.java @@ -2,6 +2,7 @@ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. * * Copyright (c) 2013 ForgeRock AS. All Rights Reserved + * Portions Copyright 2018 Wren Security. * * The contents of this file are subject to the terms * of the Common Development and Distribution License @@ -36,14 +37,11 @@ /** * RemoteWrappedException wraps every exception which are received from Remote * Connector Server. - *

- * This Exception is not allowed to use in Connectors!!! - *

* + *

This Exception is not allowed for use by Connectors * - * - * This type of exception is not allowed to be serialise because this exception - * represents any after deserialization. + *

This type of exception is not allowed to be serialise because this + * exception represents any after deserialization. * * This code example show how to get the remote stack trace and how to use the * same catches to handle the exceptions regardless its origin. @@ -64,7 +62,7 @@ * t.printStackTrace(); * } * } - * + * * * * @author Laszlo Hordos diff --git a/connector-framework-internal/src/main/java/org/identityconnectors/framework/impl/serializer/ObjectDecoder.java b/connector-framework-internal/src/main/java/org/identityconnectors/framework/impl/serializer/ObjectDecoder.java index a4713d39..d449c3bf 100644 --- a/connector-framework-internal/src/main/java/org/identityconnectors/framework/impl/serializer/ObjectDecoder.java +++ b/connector-framework-internal/src/main/java/org/identityconnectors/framework/impl/serializer/ObjectDecoder.java @@ -3,6 +3,7 @@ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. * * Copyright 2008-2009 Sun Microsystems, Inc. All rights reserved. + * Portions Copyright 2018 Wren Security. * * The contents of this file are subject to the terms of the Common Development * and Distribution License("CDDL") (the "License"). You may not use this file @@ -29,12 +30,16 @@ */ public interface ObjectDecoder { /** - * Reads an object using the appropriate serializer for that object - * @param fieldName A hint of the field name. Ignored for binary - * serialization. The subelement name for xml serialization - * @expectedType Ignored for binary serialization. For xml serialization, - * this must be specified if it was written in-line. - * @dflt The default value if there is no value. + * Reads an object using the appropriate serializer for that object. + * + * @param fieldName + * A hint of the field name. Ignored for binary serialization. The + * subelement name for xml serialization + * @param expectedType + * Ignored for binary serialization. For xml serialization, this must be + * specified if it was written in-line. + * @param dflt + * The default value if there is no value. */ public Object readObjectField(String fieldName, Class expectedType, @@ -42,57 +47,78 @@ public Object readObjectField(String fieldName, /** * Reads a boolean. - * @param fieldName A hint of the field name. Ignored for binary - * serialization. The attribute name for xml serialization - * @dflt The default value if there is no value. + * + * @param fieldName + * A hint of the field name. Ignored for binary serialization. The + * attribute name for xml serialization + * @param dflt + * The default value if there is no value. */ public boolean readBooleanField(String fieldName, boolean dflt); /** * Reads an int. - * @param fieldName A hint of the field name. Ignored for binary - * serialization. The attribute name for xml serialization - * @dflt The default value if there is no value. + * + * @param fieldName + * A hint of the field name. Ignored for binary serialization. The + * attribute name for xml serialization + * @param dflt + * The default value if there is no value. */ public int readIntField(String fieldName, int dflt); /** * Reads a long. - * @param fieldName A hint of the field name. Ignored for binary - * serialization. The attribute name for xml serialization - * @dflt The default value if there is no value. + * + * @param fieldName + * A hint of the field name. Ignored for binary serialization. The + * attribute name for xml serialization + * @param dflt + * The default value if there is no value. */ public long readLongField(String fieldName, long dflt); /** * Reads a float. - * @param fieldName A hint of the field name. Ignored for binary - * serialization. The attribute name for xml serialization - * @dflt The default value if there is no value. + * + * @param fieldName + * A hint of the field name. Ignored for binary serialization. The + * attribute name for xml serialization + * @param dflt + * The default value if there is no value. */ public float readFloatField(String fieldName, float dflt ); /** * Reads a Class. - * @param fieldName A hint of the field name. Ignored for binary - * serialization. The attribute name for xml serialization - * @dflt The default value if there is no value. + * + * @param fieldName + * A hint of the field name. Ignored for binary serialization. The + * attribute name for xml serialization + * @param dflt + * The default value if there is no value. */ public Class readClassField(String fieldName, Class dflt ); /** * Reads a String. - * @param fieldName A hint of the field name. Ignored for binary - * serialization. The attribute name for xml serialization - * @dflt The default value if there is no value. + * + * @param fieldName + * A hint of the field name. Ignored for binary serialization. The + * attribute name for xml serialization + * @param dflt + * The default value if there is no value. */ public String readStringField(String fieldName, String dflt ); /** * Reads a double. - * @param fieldName A hint of the field name. Ignored for binary - * serialization. The attribute name for xml serialization - * @dflt The default value if there is no value. + * + * @param fieldName + * A hint of the field name. Ignored for binary serialization. The + * attribute name for xml serialization + * @param dflt + * The default value if there is no value. */ public double readDoubleField(String fieldName, double dflt ); @@ -143,7 +169,6 @@ public Object readObjectField(String fieldName, /** * Returns the number of anonymous sub-objects. - * @return */ public int getNumSubObjects(); diff --git a/connector-framework-internal/src/main/java/org/identityconnectors/framework/server/ConnectorServer.java b/connector-framework-internal/src/main/java/org/identityconnectors/framework/server/ConnectorServer.java index 27420756..e4b498c3 100644 --- a/connector-framework-internal/src/main/java/org/identityconnectors/framework/server/ConnectorServer.java +++ b/connector-framework-internal/src/main/java/org/identityconnectors/framework/server/ConnectorServer.java @@ -3,6 +3,7 @@ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. * * Copyright 2008-2009 Sun Microsystems, Inc. All rights reserved. + * Portions Copyright 2018 Wren Security. * * The contents of this file are subject to the terms of the Common Development * and Distribution License("CDDL") (the "License"). You may not use this file @@ -355,8 +356,6 @@ public void setBundleParentClassLoader(final ClassLoader bundleParentClassLoader /** * Gets the time when the servers was started last time. - *

- * {@code System.currentTimeMillis()} * * @return last start dateTime in milliseconds */ diff --git a/connector-framework-osgi/src/main/java/org/forgerock/openicf/framework/impl/api/osgi/internal/OsgiConnectorInfoManagerImpl.java b/connector-framework-osgi/src/main/java/org/forgerock/openicf/framework/impl/api/osgi/internal/OsgiConnectorInfoManagerImpl.java index e1a4a0c5..fb45f150 100644 --- a/connector-framework-osgi/src/main/java/org/forgerock/openicf/framework/impl/api/osgi/internal/OsgiConnectorInfoManagerImpl.java +++ b/connector-framework-osgi/src/main/java/org/forgerock/openicf/framework/impl/api/osgi/internal/OsgiConnectorInfoManagerImpl.java @@ -2,6 +2,7 @@ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. * * Copyright (c) 2010-2013 ForgeRock AS. All rights reserved. + * Portions Copyright 2018 Wren Security. * * The contents of this file are subject to the terms * of the Common Development and Distribution License @@ -75,7 +76,6 @@ /** * The OSGi ConnectorInfoManager Implementation ... - *

* * @author Laszlo Hordos * @since 1.1 diff --git a/connector-framework-protobuf/src/main/java/org/forgerock/openicf/common/protobuf/package-info.java b/connector-framework-protobuf/src/main/java/org/forgerock/openicf/common/protobuf/package-info.java index 2d3a0192..0b0f100d 100644 --- a/connector-framework-protobuf/src/main/java/org/forgerock/openicf/common/protobuf/package-info.java +++ b/connector-framework-protobuf/src/main/java/org/forgerock/openicf/common/protobuf/package-info.java @@ -2,6 +2,7 @@ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. * * Copyright (c) 2015 ForgeRock AS. All rights reserved. + * Portions Copyright 2018 Wren Security. * * The contents of this file are subject to the terms * of the Common Development and Distribution License @@ -23,10 +24,11 @@ */ /** - * Provide the Google Protocol Buffer Messages required for the Remote OpenICF Server communication. - *

- * The messages are extracted for easy extensibility in the future. + * Provide the Google Protocol Buffer Messages required for the Remote OpenICF + * Server communication. + * + *

The messages are extracted for easy extensibility in the future. * * @since 1.5 */ -package org.forgerock.openicf.common.protobuf; \ No newline at end of file +package org.forgerock.openicf.common.protobuf; diff --git a/connector-framework-rpc/src/main/java/org/forgerock/openicf/common/rpc/LocalRequest.java b/connector-framework-rpc/src/main/java/org/forgerock/openicf/common/rpc/LocalRequest.java index 1de8fa8b..d6761d2c 100644 --- a/connector-framework-rpc/src/main/java/org/forgerock/openicf/common/rpc/LocalRequest.java +++ b/connector-framework-rpc/src/main/java/org/forgerock/openicf/common/rpc/LocalRequest.java @@ -2,6 +2,7 @@ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. * * Copyright (c) 2015 ForgeRock AS. All rights reserved. + * Portions Copyright 2018 Wren Security. * * The contents of this file are subject to the terms * of the Common Development and Distribution License @@ -29,10 +30,9 @@ /** * A LocalRequest represents a remotely requested procedure call locally. - *

- * The {@link RemoteRequest} and LocalRequest are the representation of the same - * call on caller and receiver side. * + *

The {@link RemoteRequest} and LocalRequest are the representation of the + * same call on caller and receiver side. */ public abstract class LocalRequest, H extends RemoteConnectionHolder, P extends RemoteConnectionContext> implements ResultHandler, ExceptionHandler { @@ -48,10 +48,12 @@ protected LocalRequest(final long requestId, final H socket) { } /** - * Check if this object was {@ref inconsistent}-ed and don't dispose. + * Check if this object was marked inconsistent and should not be disposed. * * @return 'true' when object is still active or 'false' when this can be * disposed. + * + * @see #inconsistent() */ public abstract boolean check(); diff --git a/connector-framework-rpc/src/main/java/org/forgerock/openicf/common/rpc/RemoteConnectionContext.java b/connector-framework-rpc/src/main/java/org/forgerock/openicf/common/rpc/RemoteConnectionContext.java index 3d6e489c..7409a819 100644 --- a/connector-framework-rpc/src/main/java/org/forgerock/openicf/common/rpc/RemoteConnectionContext.java +++ b/connector-framework-rpc/src/main/java/org/forgerock/openicf/common/rpc/RemoteConnectionContext.java @@ -2,6 +2,7 @@ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. * * Copyright (c) 2015 ForgeRock AS. All rights reserved. + * Portions Copyright 2018 Wren Security. * * The contents of this file are subject to the terms * of the Common Development and Distribution License @@ -28,8 +29,8 @@ * A RemoteConnectionContext is a custom context to provide application specific * information to create the * {@link org.forgerock.openicf.common.rpc.RemoteRequest}. - *

- * The {@link org.forgerock.openicf.common.rpc.RemoteRequest} may depends on + * + *

The {@link org.forgerock.openicf.common.rpc.RemoteRequest} may depends on * which {@link org.forgerock.openicf.common.rpc.RemoteConnectionGroup} * distributes the request. Instance of this class is provided to * {@link org.forgerock.openicf.common.rpc.RemoteRequestFactory} to produce the @@ -41,12 +42,10 @@ public interface RemoteConnectionContext - * Return the {@link org.forgerock.openicf.common.rpc.RemoteConnectionGroup} - * in which this instance belongs to. + * to which this instance belongs. * * @return the - * {@link org.forgerock.openicf.common.rpc.RemoteConnectionGroup} in + * {@link org.forgerock.openicf.common.rpc.RemoteConnectionGroup} to * which this instance belongs to. */ G getRemoteConnectionGroup(); diff --git a/connector-framework-rpc/src/main/java/org/forgerock/openicf/common/rpc/RemoteConnectionGroup.java b/connector-framework-rpc/src/main/java/org/forgerock/openicf/common/rpc/RemoteConnectionGroup.java index c536a3f3..ac671b92 100644 --- a/connector-framework-rpc/src/main/java/org/forgerock/openicf/common/rpc/RemoteConnectionGroup.java +++ b/connector-framework-rpc/src/main/java/org/forgerock/openicf/common/rpc/RemoteConnectionGroup.java @@ -2,6 +2,7 @@ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. * * Copyright (c) 2015 ForgeRock AS. All rights reserved. + * Portions Copyright 2018 Wren Security. * * The contents of this file are subject to the terms * of the Common Development and Distribution License @@ -38,12 +39,12 @@ /** * A RemoteConnectionGroups represent a remote pair of another instance of * RemoteConnectionGroups. - *

- * RemoteConnectionGroups holds the + * + *

RemoteConnectionGroups holds the * {@link org.forgerock.openicf.common.rpc.RemoteConnectionHolder} which are * connected to the remotely paired RemoteConnectionGroups. - *

- * The local instance of {@link RemoteConnectionGroup#remoteRequests} paired + * + *

The local instance of {@link RemoteConnectionGroup#remoteRequests} paired * with the remote instance of {@link RemoteConnectionGroup#localRequests}. * */ diff --git a/connector-framework-rpc/src/main/java/org/forgerock/openicf/common/rpc/RemoteConnectionHolder.java b/connector-framework-rpc/src/main/java/org/forgerock/openicf/common/rpc/RemoteConnectionHolder.java index 3d93e0e3..07e095cc 100644 --- a/connector-framework-rpc/src/main/java/org/forgerock/openicf/common/rpc/RemoteConnectionHolder.java +++ b/connector-framework-rpc/src/main/java/org/forgerock/openicf/common/rpc/RemoteConnectionHolder.java @@ -2,6 +2,7 @@ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. * * Copyright (c) 2015 ForgeRock AS. All rights reserved. + * Portions Copyright 2018 Wren Security. * * The contents of this file are subject to the terms * of the Common Development and Distribution License @@ -29,10 +30,10 @@ /** * A RemoteConnectionHolder is a wrapper class for the underlying communication * chanel. - *

- * The API is detached from the real underlying protocol and abstracted through - * this interface. The message transmitted via this implementation should - * trigger the appropriate method on + * + *

The API is detached from the real underlying protocol and abstracted + * through this interface. The message transmitted via this implementation + * should trigger the appropriate method on * {@link org.forgerock.openicf.common.rpc.MessageListener}. * */ diff --git a/connector-framework-rpc/src/main/java/org/forgerock/openicf/common/rpc/RemoteRequest.java b/connector-framework-rpc/src/main/java/org/forgerock/openicf/common/rpc/RemoteRequest.java index 4222675b..c875232b 100644 --- a/connector-framework-rpc/src/main/java/org/forgerock/openicf/common/rpc/RemoteRequest.java +++ b/connector-framework-rpc/src/main/java/org/forgerock/openicf/common/rpc/RemoteRequest.java @@ -2,6 +2,7 @@ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. * * Copyright (c) 2015 ForgeRock AS. All rights reserved. + * Portions Copyright 2018 Wren Security. * * The contents of this file are subject to the terms * of the Common Development and Distribution License @@ -36,9 +37,9 @@ /** * A RemoteRequest represents a locally requested procedure call executed * remotely. - *

- * The RemoteRequest and {@link LocalRequest} are the representation of the same - * call on caller and receiver side. + * + *

The RemoteRequest and {@link LocalRequest} are the representation of the + * same call on caller and receiver side. * */ public abstract class RemoteRequest, H extends RemoteConnectionHolder, P extends RemoteConnectionContext> { @@ -59,10 +60,12 @@ public RemoteRequest(P context, long requestId, } /** - * Check if this object was {@ref inconsistent}-ed and don't dispose. + * Check if this object was marked inconsistent and should not be disposed. * * @return 'true' when object is still active or 'false' when this can be * disposed. + * + * @see #inconsistent() */ public abstract boolean check(); diff --git a/connector-framework-rpc/src/main/java/org/forgerock/openicf/common/rpc/RequestDistributor.java b/connector-framework-rpc/src/main/java/org/forgerock/openicf/common/rpc/RequestDistributor.java index 26494a7d..82be6a00 100644 --- a/connector-framework-rpc/src/main/java/org/forgerock/openicf/common/rpc/RequestDistributor.java +++ b/connector-framework-rpc/src/main/java/org/forgerock/openicf/common/rpc/RequestDistributor.java @@ -2,6 +2,7 @@ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. * * Copyright (c) 2015 ForgeRock AS. All rights reserved. + * Portions Copyright 2018 Wren Security. * * The contents of this file are subject to the terms * of the Common Development and Distribution License @@ -28,17 +29,17 @@ * A RequestDistributor delivers the * {@link org.forgerock.openicf.common.rpc.RemoteRequest} to the connected * endpoint. - *

- * The {@link org.forgerock.openicf.common.rpc.RemoteRequestFactory} is used to - * create a {@link org.forgerock.openicf.common.rpc.RemoteConnectionContext} + * + *

The {@link org.forgerock.openicf.common.rpc.RemoteRequestFactory} is used + * to create a {@link org.forgerock.openicf.common.rpc.RemoteConnectionContext} * aware {@link org.forgerock.openicf.common.rpc.RemoteRequest} which will be * delivered. - *

- * The implementation may hold multiple transmission channels and try all to + * + *

The implementation may hold multiple transmission channels and try all to * deliver the message before if fails. - *

- * The failed delivery signaled with null empty to avoid the expensive Throw and - * Catch especially when many implementation are chained together. + * + *

The failed delivery signaled with null empty to avoid the expensive Throw + * and Catch especially when many implementation are chained together. * * @see org.forgerock.openicf.common.rpc.FailoverLoadBalancingAlgorithm * @see org.forgerock.openicf.common.rpc.RoundRobinLoadBalancingAlgorithm diff --git a/connector-framework-server/src/main/java/org/forgerock/openicf/framework/async/AsyncConnectorInfoManager.java b/connector-framework-server/src/main/java/org/forgerock/openicf/framework/async/AsyncConnectorInfoManager.java index 2aedba60..452c8ecb 100644 --- a/connector-framework-server/src/main/java/org/forgerock/openicf/framework/async/AsyncConnectorInfoManager.java +++ b/connector-framework-server/src/main/java/org/forgerock/openicf/framework/async/AsyncConnectorInfoManager.java @@ -2,6 +2,7 @@ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. * * Copyright (c) 2015 ForgeRock AS. All rights reserved. + * Portions Copyright 2018 Wren Security. * * The contents of this file are subject to the terms * of the Common Development and Distribution License @@ -41,7 +42,7 @@ public interface AsyncConnectorInfoManager extends ConnectorInfoManager { /** * Add a promise which will be fulfilled with the * {@link org.identityconnectors.framework.api.ConnectorInfo} for the given - * {@ConnectorKey}. + * {@link ConnectorKey}. * * Add a Promise which will be fulfilled immediately if the * {@link org.identityconnectors.framework.api.ConnectorInfo} is maintained @@ -55,7 +56,7 @@ public interface AsyncConnectorInfoManager extends ConnectorInfoManager { /** * Add a promise which will be fulfilled with the * {@link org.identityconnectors.framework.api.ConnectorInfo} for the given - * {@ConnectorKeyRange}. + * {@link ConnectorKeyRange}. * * Add a Promise which will be fulfilled immediately if the * {@link org.identityconnectors.framework.api.ConnectorInfo} is maintained diff --git a/connector-framework-server/src/main/java/org/forgerock/openicf/framework/osgi/internal/AsyncOsgiConnectorInfoManagerImpl.java b/connector-framework-server/src/main/java/org/forgerock/openicf/framework/osgi/internal/AsyncOsgiConnectorInfoManagerImpl.java index 8f30bb6c..06feea4d 100644 --- a/connector-framework-server/src/main/java/org/forgerock/openicf/framework/osgi/internal/AsyncOsgiConnectorInfoManagerImpl.java +++ b/connector-framework-server/src/main/java/org/forgerock/openicf/framework/osgi/internal/AsyncOsgiConnectorInfoManagerImpl.java @@ -2,6 +2,7 @@ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. * * Copyright (c) 2015 ForgeRock AS. All rights reserved. + * Portions Copyright 2018 Wren Security. * * The contents of this file are subject to the terms * of the Common Development and Distribution License @@ -65,7 +66,6 @@ /** * The OSGi ConnectorInfoManager Implementation ... - *

* * @author Laszlo Hordos * @since 1.1 diff --git a/connector-framework-server/src/main/java/org/forgerock/openicf/framework/remote/SecurityUtil.java b/connector-framework-server/src/main/java/org/forgerock/openicf/framework/remote/SecurityUtil.java index c60c8574..c050bcdc 100644 --- a/connector-framework-server/src/main/java/org/forgerock/openicf/framework/remote/SecurityUtil.java +++ b/connector-framework-server/src/main/java/org/forgerock/openicf/framework/remote/SecurityUtil.java @@ -2,6 +2,7 @@ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. * * Copyright (c) 2015 ForgeRock AS. All rights reserved. + * Portions Copyright 2018 Wren Security. * * The contents of this file are subject to the terms * of the Common Development and Distribution License @@ -113,8 +114,8 @@ public static KeyPair generateKeyPair() { /** * Load a class with a given name. - *

- * It will try to load the class in the following order: + * + *

It will try to load the class in the following order: *

*/ public final List translate(Filter filter) { if (filter == null) { diff --git a/connector-framework/src/main/java/org/identityconnectors/framework/spi/StatefulConfiguration.java b/connector-framework/src/main/java/org/identityconnectors/framework/spi/StatefulConfiguration.java index 82ad09e9..9d1e8fae 100755 --- a/connector-framework/src/main/java/org/identityconnectors/framework/spi/StatefulConfiguration.java +++ b/connector-framework/src/main/java/org/identityconnectors/framework/spi/StatefulConfiguration.java @@ -2,6 +2,7 @@ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. * * Copyright (c) 2013 ForgeRock AS. All Rights Reserved + * Portions Copyright 2018 Wren Security. * * The contents of this file are subject to the terms * of the Common Development and Distribution License @@ -27,8 +28,8 @@ /** * A Stateful Configuration interface extends the default {@link Configuration} * and makes the framework keep the same instance. - *

- * The default Configuration object instance is constructed every single time + * + *

The default Configuration object instance is constructed every single time * before the {@link Connector#init(Configuration)} is called. If the * configuration class implements this interface then the Framework keeps one * instance of Configuration and the {@link Connector#init(Configuration)} is @@ -39,12 +40,11 @@ * Connector developer must quarantine that the necessary resource * initialisation are thread-safe. * - *

- * If the connector implements the {@link PoolableConnector} then this + *

If the connector implements the {@link PoolableConnector} then this * configuration is kept in the - * {@link org.identityconnectors.framework.impl.api.local.ConnectorPoolManager} - * and when the - * {@link org.identityconnectors.framework.impl.api.local.ConnectorPoolManager#dispose()} + * {@code org.identityconnectors.framework.impl.api.local.ConnectorPoolManager} + * and when + * {@code ConnectorPoolManager.dispose()} * calls the {@link #release()} method. If the connector implements only the * {@link Connector} then this configuration is kept in the * {@link org.identityconnectors.framework.api.ConnectorFacade} and the diff --git a/connector-framework/src/main/java/org/identityconnectors/framework/spi/package-info.java b/connector-framework/src/main/java/org/identityconnectors/framework/spi/package-info.java index 0ca3bd5d..3d58325f 100644 --- a/connector-framework/src/main/java/org/identityconnectors/framework/spi/package-info.java +++ b/connector-framework/src/main/java/org/identityconnectors/framework/spi/package-info.java @@ -3,6 +3,7 @@ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. * * Copyright 2008-2009 Sun Microsystems, Inc. All rights reserved. + * Portions Copyright 2018 Wren Security. * * The contents of this file are subject to the terms of the Common Development * and Distribution License("CDDL") (the "License"). You may not use this file @@ -22,31 +23,44 @@ */ /** - * This is the "Service Provider Interface" package. The {@link org.identityconnectors.framework.spi.Connector} developer - * is responsible for implementing the following interfaces to build a {@link org.identityconnectors.framework.spi.Connector}. - *