/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License, Version 1.0 only
* (the "License"). You may not use this file except in compliance
* with the License.
*
* You can obtain a copy of the license at legal-notices/CDDLv1_0.txt
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at legal-notices/CDDLv1_0.txt.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information:
* Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*
*
* Copyright 2006-2009 Sun Microsystems, Inc.
* Portions Copyright 2011-2014 ForgeRock AS
*/
/**
* This object is used to store a list of ServerState object, one by replication
* domain. Globally, it is the generalization of ServerState (that applies to
* one domain) to a list of domains.
* <p>
* MultiDomainServerState is also known as "cookie" and is used with the
* cookie-based changelog.
*/
{
/**
* The list of (domain service id, ServerState).
*/
/**
* Creates a new empty object.
*/
public MultiDomainServerState()
{
}
/**
* Create an object from a string representation.
* @param mdss The provided string representation of the state.
* @throws DirectoryException when the string has an invalid format
*/
{
}
/**
* Empty the object..
* After this call the object will be in the same state as if it
* was just created.
*/
public void clear()
{
}
/**
* Update the ServerState of the provided baseDN with the replication
* {@link CSN} provided.
*
* @param baseDN The provided baseDN.
* @param csn The provided CSN.
*
* @return a boolean indicating if the update was meaningful.
*/
{
{
return false;
}
if (serverState == null)
{
serverState = new ServerState();
if (existingSS != null)
{
}
}
}
/**
* Update the ServerState of the provided baseDN with the provided server
* state.
*
* @param baseDN
* The provided baseDN.
* @param serverState
* The provided serverState.
*/
{
{
}
}
/**
* Replace the ServerState of the provided baseDN with the provided server
* state. The provided server state will be owned by this instance, so care
* must be taken by calling code to duplicate it if needed.
*
* @param baseDN
* The provided baseDN.
* @param serverState
* The provided serverState.
*/
{
if (serverState == null)
{
throw new IllegalArgumentException("ServerState must not be null");
}
}
/**
* Update the current object with the provided multi domain server state.
*
* @param state
* The provided multi domain server state.
*/
{
{
}
}
/**
* Returns a snapshot of this object.
*
* @return an unmodifiable Map representing a snapshot of this object.
*/
{
{
return Collections.emptyMap();
}
{
if (!l.isEmpty())
{
}
}
}
/**
* Returns a string representation of this object.
*
* @return The string representation.
*/
{
{
{
}
}
}
/**
* Dump a string representation in the provided buffer.
* @param buffer The provided buffer.
*/
{
}
/**
* Tests if the state is empty.
*
* @return True if the state is empty.
*/
public boolean isEmpty()
{
}
/** {@inheritDoc} */
{
}
/**
* Returns the ServerState associated to the provided replication domain's
* baseDN.
*
* @param baseDN
* the replication domain's baseDN
* @return the associated ServerState
*/
{
}
/**
* Returns the CSN associated to the provided replication domain's baseDN and
* serverId.
*
* @param baseDN
* the replication domain's baseDN
* @param serverId
* the serverId
* @return the associated CSN
*/
{
{
}
return null;
}
/**
* Returns the oldest Pair<DN, CSN> held in current object, excluding
* the provided CSNs. Said otherwise, the value returned is the oldest
* Pair<DN, CSN> included in the current object, that is not part of the
* excludedCSNs.
*
* @param excludedCSNs
* the CSNs that cannot be returned
* @return the oldest Pair<DN, CSN> included in the current object that
* is not part of the excludedCSNs, or {@link Pair#EMPTY} if no such
* older CSN exists.
*/
{
{
{
{
}
}
}
return oldest;
}
{
}
/**
* Removes the mapping to the provided CSN if it is present in this
* MultiDomainServerState.
*
* @param baseDN
* the replication domain's baseDN
* @param expectedCSN
* the CSN to be removed
* @return true if the CSN could be removed, false otherwise.
*/
{
}
/**
* Test if this object equals the provided other object.
* @param other The other object with which we want to test equality.
* @return Returns True if this equals other, else return false.
*/
{
}
/**
* Test if this object covers the provided covered object.
* @param covered The provided object.
* @return true when this covers the provided object.
*/
{
{
{
return false;
}
}
return true;
}
/**
* Test if this object covers the provided CSN for the provided baseDN.
*
* @param baseDN
* The provided baseDN.
* @param csn
* The provided CSN.
* @return true when this object covers the provided CSN for the provided
* baseDN.
*/
{
}
/**
* Splits the provided generalizedServerState being a String with the
* following syntax: "domain1:state1;domain2:state2;..." to a Map of (domain
* DN, domain ServerState).
*
* @param multiDomainServerState
* the provided multi domain server state also known as cookie
* @exception DirectoryException
* when an error occurs
* @return the split state.
*/
{
{
try
{
// Split the provided multiDomainServerState into domains
{
// For each domain, split the CSNs by server
// and build a server state (SHOULD BE OPTIMIZED)
{
}
{
{
}
}
}
}
catch (DirectoryException de)
{
throw de;
}
catch (Exception e)
{
throw new DirectoryException(
"Exception raised: " + e),
e);
}
}
return startStates;
}
}