/*
* 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
* 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
* trunk/opends/resource/legal-notices/OpenDS.LICENSE. 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 2009 Sun Microsystems, Inc.
* Portions copyright 2013 ForgeRock AS.
*/
/**
* Message sent by a replication server to a directory server in reply to the
* ServerStartMsg.
*/
{
private int serverId;
private int windowSize;
/**
* Whether to continue using SSL to encrypt messages after the start
* messages have been exchanged.
*/
private boolean sslEncryption;
/**
* Threshold value used by the RS to determine if a DS must be put in
* degraded status because the number of pending changes for him has crossed
* this value. This field is only used by a DS.
*/
/**
* The weight affected to the replication server.
*/
/**
* Number of currently connected DS to the replication server.
*/
/**
* Create a ReplServerStartDSMsg.
*
* @param serverId replication server id
* @param serverURL replication server URL
* @param baseDn base DN for which the ReplServerStartDSMsg is created.
* @param windowSize The window size.
* @param serverState our ServerState for this baseDn.
* @param generationId The generationId for this server.
* @param sslEncryption Whether to continue using SSL to encrypt messages
* after the start messages have been exchanged.
* @param groupId The group id of the RS
* @param degradedStatusThreshold The degraded status threshold
* @param weight The weight affected to the replication server.
* @param connectedDSNumber Number of currently connected DS to the
* replication server.
*/
int windowSize,
long generationId,
boolean sslEncryption,
byte groupId,
int weight,
int connectedDSNumber)
{
else
this.windowSize = windowSize;
this.serverState = serverState;
this.sslEncryption = sslEncryption;
this.connectedDSNumber = connectedDSNumber;
}
/**
* Creates a new ReplServerStartDSMsg by decoding the provided byte array.
* @param in A byte array containing the encoded information for the
* ReplServerStartDSMsg
* @throws DataFormatException If the in does not contain a properly
* encoded ReplServerStartDSMsg.
*/
{
byte[] allowedPduTypes = new byte[1];
try
{
/* The ReplServerStartDSMsg payload is stored in the form :
* <baseDn><serverId><serverURL><windowSize><sslEncryption>
* <degradedStatusThreshold><weight><connectedDSNumber>
* <serverState>
*/
/* first bytes are the header */
int pos = headerLength;
/* read the dn
* first calculate the length then construct the string
*/
/*
* read the ServerId
*/
/*
* read the ServerURL
*/
/*
* read the window size
*/
/*
* read the sslEncryption setting
*/
/**
* read the degraded status threshold
*/
/*
* read the weight
*/
/*
* read the connected DS number
*/
// Read the ServerState
// Caution: ServerState MUST be the last field. Because ServerState can
// contain null character (string termination of serverid string ..) it
// cannot be decoded using getNextLength() like the other fields. The
// only way is to rely on the end of the input buffer : and that forces
// the ServerState to be the last. This should be changed and we want to
// have more than one ServerState field.
} catch (UnsupportedEncodingException e)
{
throw new DataFormatException("UTF-8 is not supported by this jvm.");
}
}
/**
* Get the Server Id.
* @return the server id
*/
public int getServerId()
{
return this.serverId;
}
/**
* Get the server URL.
* @return the server URL
*/
{
return this.serverURL;
}
/**
* Get the base DN from this ReplServerStartDSMsg.
*
* @return the base DN from this ReplServerStartDSMsg.
*/
{
return baseDn;
}
/**
* Get the serverState.
* @return Returns the serverState.
*/
{
return this.serverState;
}
/**
* {@inheritDoc}
*/
throws UnsupportedEncodingException
{
/* The ReplServerStartDSMsg is stored in the form :
* <operation type><baseDn><serverId><serverURL><windowSize><sslEncryption>
* <degradedStatusThreshold><weight><connectedDSNumber>
* <serverState>
*/
byte[] byteSSLEncryption =
byte[] byteDegradedStatusThreshold =
byte[] byteWeight =
byte[] byteConnectedDSNumber =
/* encode the header in a byte[] large enough */
int pos = headerLength;
/* put the baseDN and a terminating 0 */
/* put the ServerId */
/* put the ServerURL */
/* put the window size */
/* put the SSL Encryption setting */
/* put the degraded status threshold */
/* put the weight */
/* put the connected DS number */
/* put the ServerState */
return resultByteArray;
}
/**
* get the window size for the server that created this message.
*
* @return The window size for the server that created this message.
*/
public int getWindowSize()
{
return windowSize;
}
/**
* Get the SSL encryption value for the server that created the
* message.
*
* @return The SSL encryption value for the server that created the
* message.
*/
public boolean getSSLEncryption()
{
return sslEncryption;
}
/**
* Get the degraded status threshold value.
* @return The degraded status threshold value.
*/
public int getDegradedStatusThreshold()
{
return degradedStatusThreshold;
}
/**
* Set the degraded status threshold (For test purpose).
* @param degradedStatusThreshold The degraded status threshold to set.
*/
{
}
/**
* {@inheritDoc}
*/
{
return "ReplServerStartDSMsg content: " +
"\nprotocolVersion: " + protocolVersion +
"\ngenerationId: " + generationId +
"\nbaseDn: " + baseDn +
"\ngroupId: " + groupId +
"\nserverId: " + serverId +
"\nserverState: " + serverState +
"\nserverURL: " + serverURL +
"\nsslEncryption: " + sslEncryption +
"\ndegradedStatusThreshold: " + degradedStatusThreshold +
"\nwindowSize: " + windowSize +
"\nweight: " + weight +
"\nconnectedDSNumber: " + connectedDSNumber;
}
/**
* Gets the weight of the replication server.
* @return The weight of the replication server.
*/
public int getWeight()
{
return weight;
}
/**
* Gets the number of directory servers connected to the replication server.
* @return The number of directory servers connected to the replication
* server.
*/
public int getConnectedDSNumber()
{
return connectedDSNumber;
}
}