How to use

JoinRsp

in

org.jgroups.protocols.pbcast

protected void sendJoinRejectionMessage(Address dest, String error_msg) {
  if (dest == null)
    return;
  JoinRsp joinRes = new JoinRsp(error_msg); // specify the error message on the JoinRsp
  Message msg = new Message(dest).putHeader(GMS_ID, new GmsHeader(GmsHeader.JOIN_RSP)).setBuffer(
      GMS.marshal(joinRes));
  down_prot.down(msg);
}

protected boolean isJoinResponseValid(final JoinRsp rsp) {
  if(rsp.getFailReason() != null)
    throw new SecurityException(rsp.getFailReason());
  Digest tmp_digest=rsp.getDigest();
  if(tmp_digest == null || tmp_digest.capacity() == 0) {
    log.warn("%s: digest is empty: digest=%s", gms.local_addr, rsp.getDigest());
    return false;
  }
  if(!tmp_digest.contains(gms.local_addr)) {
    log.error("%s: digest in JOIN_RSP does not contain myself; join response: %s", gms.local_addr, rsp);
    return false;
  }
  if(rsp.getView() == null) {
    log.error("%s: JoinRsp has a null view, skipping it", gms.local_addr);
    return false;
  }
  return true;
}

/** In case we get a different JOIN_RSP from a previous JOIN_REQ sent by us (as a client), we simply apply the
 * new view if it is greater than ours
 *
 * @param join_rsp
 */
public void handleJoinResponse(JoinRsp join_rsp) {
  View v=join_rsp.getView();
  ViewId tmp_vid=v != null? v.getViewId() : null;
  ViewId my_view=gms.getViewId();
  if(tmp_vid != null && my_view != null && tmp_vid.compareToIDs(my_view) > 0) {
    Digest d=join_rsp.getDigest();
    gms.installView(v, d);
  }
}

protected void sendJoinResponses(JoinRsp jr, Collection<Address> joiners) {
  if(jr == null || joiners == null || joiners.isEmpty())
    return;
  Buffer marshalled_jr=marshal(jr);
  for(Address joiner: joiners) {
    log.trace("%s: sending join-rsp to %s: view=%s (%d mbrs)", local_addr, joiner, jr.getView(), jr.getView().size());
    sendJoinResponse(marshalled_jr, joiner);
  }
}

public int size() {
  int retval=Global.BYTE_SIZE *2; // type + merge_rejected
  retval+=Global.BYTE_SIZE; // presence view
  retval+=Global.BYTE_SIZE; // MergeView or View
  if(view != null)
    retval+=view.serializedSize();
  retval+=Util.size(mbr);
  retval+=Global.BYTE_SIZE; // presence of join_rsp
  if(join_rsp != null)
    retval+=join_rsp.serializedSize();
  retval+=Global.BYTE_SIZE; // presence for my_digest
  if(my_digest != null)
    retval+=my_digest.serializedSize();
  retval+=Global.BYTE_SIZE; // presence for merge_id
  if(merge_id != null)
    retval+=merge_id.serializedSize();
  return retval;
}

protected boolean installViewIfValidJoinRsp(final Promise<JoinRsp> join_promise, boolean block_for_rsp) {
  boolean success=false;
  JoinRsp rsp=null;
  try {
    if(join_promise.hasResult())
      rsp=join_promise.getResult(1, true);
    else if(block_for_rsp)
      rsp=join_promise.getResult(gms.join_timeout, true);
    return success=rsp != null && isJoinResponseValid(rsp) && installView(rsp.getView(), rsp.getDigest());
  }
  finally {
    if(success)
      gms.sendViewAck(rsp.getView().getCreator());
  }
}

protected void sendJoinResponses(JoinRsp jr, Collection<Address> joiners) {
  if(jr == null || joiners == null || joiners.isEmpty())
    return;
  Buffer marshalled_jr=marshal(jr);
  for(Address joiner: joiners) {
    log.trace("%s: sending join-rsp to %s: view=%s (%d mbrs)", local_addr, joiner, jr.getView(), jr.getView().size());
    sendJoinResponse(marshalled_jr, joiner);
  }
}

protected boolean isJoinResponseValid(final JoinRsp rsp) {
  if(rsp.getFailReason() != null)
    throw new SecurityException(rsp.getFailReason());
  Digest tmp_digest=rsp.getDigest();
  if(tmp_digest == null || tmp_digest.capacity() == 0) {
    log.warn("%s: digest is empty: digest=%s", gms.local_addr, rsp.getDigest());
    return false;
  }
  if(!tmp_digest.contains(gms.local_addr)) {
    log.error("%s: digest in JOIN_RSP does not contain myself; join response: %s", gms.local_addr, rsp);
    return false;
  }
  if(rsp.getView() == null) {
    log.error("%s: JoinRsp has a null view, skipping it", gms.local_addr);
    return false;
  }
  return true;
}

/** In case we get a different JOIN_RSP from a previous JOIN_REQ sent by us (as a client), we simply apply the
 * new view if it is greater than ours
 *
 * @param join_rsp
 */
public void handleJoinResponse(JoinRsp join_rsp) {
  View v=join_rsp.getView();
  ViewId tmp_vid=v != null? v.getViewId() : null;
  ViewId my_view=gms.getViewId();
  if(tmp_vid != null && my_view != null && tmp_vid.compareToIDs(my_view) > 0) {
    Digest d=join_rsp.getDigest();
    gms.installView(v, d);
  }
}

protected void sendJoinRejectionMessage(Address dest, String error_msg) {
  if(dest == null)
    return;
  JoinRsp joinRes=new JoinRsp(error_msg); // specify the error message on the JoinRsp
  Message msg = new Message(dest).putHeader(GMS_ID, new GMS.GmsHeader(GMS.GmsHeader.JOIN_RSP))
   .setBuffer(GMS.marshal(joinRes));
  if(this.authenticate_coord)
    msg.putHeader(this.id, new AuthHeader(this.auth_token));
  down_prot.down(msg);
}

/** In case we get a different JOIN_RSP from a previous JOIN_REQ sent by us (as a client), we simply apply the
 * new view if it is greater than ours
 *
 * @param join_rsp
 */
public void handleJoinResponse(JoinRsp join_rsp) {
  View v=join_rsp.getView();
  ViewId tmp_vid=v != null? v.getVid() : null;
  if(tmp_vid != null && gms.view_id != null && tmp_vid.compareTo(gms.view_id) > 0) {
    gms.installView(v);
  }
}

String failure=rsp.getFailReason();
if(failure != null)
  throw new SecurityException(failure);
MutableDigest tmp_digest=new MutableDigest(rsp.getDigest());
tmp_view=rsp.getView();
if(tmp_digest == null || tmp_view == null) {
  if(log.isErrorEnabled())

protected boolean installViewIfValidJoinRsp(final Promise<JoinRsp> join_promise, boolean block_for_rsp) {
  boolean success=false;
  JoinRsp rsp=null;
  try {
    if(join_promise.hasResult())
      rsp=join_promise.getResult(1, true);
    else if(block_for_rsp)
      rsp=join_promise.getResult(gms.join_timeout, true);
    return success=rsp != null && isJoinResponseValid(rsp) && installView(rsp.getView(), rsp.getDigest());
  }
  finally {
    if(success)
      gms.sendViewAck(rsp.getView().getCreator());
  }
}

Tuple<View,Digest> tuple=gms.getViewAndDigest();
if(tuple != null)
  gms.sendJoinResponse(new JoinRsp(tuple.getVal1(), tuple.getVal2()), mbr);
else
  log.warn("%s: did not find a digest matching view %s; dropping JOIN-RSP", gms.local_addr, gms.view);
  join_rsp=new JoinRsp(new_view, join_digest);
else
  log.warn("%s: digest does not match view (missing seqnos for %s); dropping JOIN-RSP",

/**
 * Used to create a failed JOIN_RSP message to pass back down the stack
 * @param joiner The Address of the requesting member
 * @param message The failure message to send back to the joiner
 * @return An Event containing a GmsHeader with a JoinRsp object
 */
private Event createFailureEvent(Address joiner, String message){
  Message msg = new Message(joiner, null, null);
  if(log.isDebugEnabled()){
    log.debug("Creating JoinRsp with failure message - " + message);
  }
  JoinRsp joinRes = new JoinRsp(message);
  //need to specify the error message on the JoinRsp object once it's been changed
  GMS.GmsHeader gmsHeader = new GMS.GmsHeader(GMS.GmsHeader.JOIN_RSP, joinRes);
  msg.putHeader(GMS.name, gmsHeader);
  if(log.isDebugEnabled()){
    log.debug("GMSHeader created for failure JOIN_RSP");
  }
  return new Event(Event.MSG, msg);
}

if(log.isWarnEnabled())
  log.warn(mbr + " already present; returning existing view " + gms.view);
JoinRsp join_rsp=new JoinRsp(new View(gms.view_id, gms.members.getMembers()), gms.getDigest());
sendJoinResponse(join_rsp, mbr);
it.remove();
    join_digest.add((Address)i.next(), 0, 0); // ... and add the new members. their first seqno will be 1
join_rsp=new JoinRsp(new_view, join_digest != null? join_digest.copy() : null);

protected void sendJoinRejectionMessage(Address dest, String error_msg) {
  if (dest == null)
    return;
  JoinRsp joinRes = new JoinRsp(error_msg); // specify the error message on the JoinRsp
  Message msg = new Message(dest).putHeader(GMS_ID, new GmsHeader(GmsHeader.JOIN_RSP)).setBuffer(
      GMS.marshal(joinRes));
  down_prot.down(msg);
}

protected void sendJoinRejectionMessage(Address dest, String error_msg) {
  if(dest == null)
    return;
  JoinRsp joinRes=new JoinRsp(error_msg); // specify the error message on the JoinRsp
  Message msg = new Message(dest).putHeader(GMS_ID, new GMS.GmsHeader(GMS.GmsHeader.JOIN_RSP))
   .setBuffer(GMS.marshal(joinRes));
  if(this.authenticate_coord)
    msg.putHeader(this.id, new AuthHeader(this.auth_token));
  down_prot.down(msg);
}

Tuple<View,Digest> tuple=gms.getViewAndDigest();
if(tuple != null)
  gms.sendJoinResponse(new JoinRsp(tuple.getVal1(), tuple.getVal2()), mbr);
else
  log.warn("%s: did not find a digest matching view %s; dropping JOIN-RSP", gms.local_addr, gms.view);
  join_rsp=new JoinRsp(new_view, join_digest);
else
  log.warn("%s: digest does not match view (missing seqnos for %s); dropping JOIN-RSP",