com.mindoo.domino.jna.internal.structs.NotesDbReplicaInfoStruct Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of domino-jna Show documentation
Java project to access the HCL Domino C API using Java Native Access (JNA)
There is a newer version: 0.9.53
package com.mindoo.domino.jna.internal.structs;

import java.security.AccessController;
import java.security.PrivilegedAction;
import java.util.Arrays;
import java.util.List;

import com.mindoo.domino.jna.IAdaptable;
import com.mindoo.domino.jna.utils.NotesStringUtils;
import com.sun.jna.Pointer;
import com.sun.jna.Structure;

/**
 * This is the structure that identifies a replica database and stores the replication
 * options that affect how the Server's Replicator Task will manipulate the database.

 * 

 * Some replication Flags, CutoffInterval, and Cutoff members correspond to the edit
 * controls in the the Workstation's Replication Settings dialog box (in the
 * File, Database, Properties InfoBox).

 * 

 * The Replica ID is a {@link NotesTimeDateStruct} structure that contains the time/date
 * of the replica's creation, used to uniquely identify the database replicas
 * to each other.

 * 

 * This time/date is NOT normalized to Greenwich Mean Time (GMT), as keeping the local
 * time zone and daylight savings time settings will further ensure that it is a unique time/date.
 */
public class NotesDbReplicaInfoStruct extends BaseStructure implements IAdaptable {
	/**
	 * ID that is same for all replica files

	 * C type : TIMEDATE
	 */
	public NotesTimeDateStruct ID;
	/** Replication flags */
	public short Flags;
	/**
	 * Automatic Replication Cutoff

	 * Interval (Days)
	 */
	public short CutoffInterval;
	/**
	 * Replication cutoff date

	 * C type : TIMEDATE
	 */
	public NotesTimeDateStruct Cutoff;
	
	/**
	 * @deprecated only public to be used by JNA; use static newInstance method instead to run in AccessController.doPrivileged block
	 */
	public NotesDbReplicaInfoStruct() {
		super();
	}
	
	public static NotesDbReplicaInfoStruct newInstance() {
		return AccessController.doPrivileged(new PrivilegedAction() {

			@Override
			public NotesDbReplicaInfoStruct run() {
				return new NotesDbReplicaInfoStruct();
			}});
	}
	
	@Override
	public  T getAdapter(Class clazz) {
		if (clazz == NotesDbReplicaInfoStruct.class) {
			return (T) this;
		}
		else if (clazz == Pointer.class) {
			return (T) getPointer();
		}
		return null;
	}
	
	@Override
	protected List getFieldOrder() {
		return Arrays.asList("ID", "Flags", "CutoffInterval", "Cutoff");
	}
	
	/**
	 * @param ID ID that is same for all replica files

	 * C type : TIMEDATE

	 * @param Flags Replication flags

	 * @param CutoffInterval Automatic Replication Cutoff

	 * Interval (Days)

	 * @param Cutoff Replication cutoff date

	 * C type : TIMEDATE
	 * @deprecated only public to be used by JNA; use static newInstance method instead to run in AccessController.doPrivileged block
	 */
	public NotesDbReplicaInfoStruct(NotesTimeDateStruct ID, short Flags, short CutoffInterval, NotesTimeDateStruct Cutoff) {
		super();
		this.ID = ID;
		this.Flags = Flags;
		this.CutoffInterval = CutoffInterval;
		this.Cutoff = Cutoff;
	}
	
	public static NotesDbReplicaInfoStruct newInstance(final NotesTimeDateStruct ID, final short Flags, final short CutoffInterval, final NotesTimeDateStruct Cutoff) {
		return AccessController.doPrivileged(new PrivilegedAction() {

			@Override
			public NotesDbReplicaInfoStruct run() {
				return new NotesDbReplicaInfoStruct(ID, Flags, CutoffInterval, Cutoff);
			}});
	}
	
	/**
	 * @deprecated only public to be used by JNA; use static newInstance method instead to run in AccessController.doPrivileged block
	 * 
	 * @param peer pointer
	 */
	public NotesDbReplicaInfoStruct(Pointer peer) {
		super(peer);
	}
	
	public static NotesDbReplicaInfoStruct newInstance(final Pointer peer) {
		return AccessController.doPrivileged(new PrivilegedAction() {

			@Override
			public NotesDbReplicaInfoStruct run() {
				return new NotesDbReplicaInfoStruct(peer);
			}});
	}
	
	public static class ByReference extends NotesDbReplicaInfoStruct implements Structure.ByReference {
		
	};
	public static class ByValue extends NotesDbReplicaInfoStruct implements Structure.ByValue {
		
	};
	
	/**
	 * Returns the replica ID ({@link #ID}) as hex encoded string with 16 characters
	 * 
	 * @return replica id
	 */
	public String getReplicaID() {
		return NotesStringUtils.innardsToReplicaId(this.ID.Innards);
	}
	
	/**
	 * Method to set the replica ID ({@link #ID}) as hex encoded string with 16 characters
	 * 
	 * @param replicaId new replica id, either 16 characters of 8:8 format
	 */
	public void setReplicaID(String replicaId) {
		if (replicaId.contains(":"))
			replicaId = replicaId.replace(":", "");
		
		if (replicaId.length() != 16) {
			throw new IllegalArgumentException("Replica ID is expected to have 16 characters");
		}
		
		this.ID.Innards[1] = Integer.parseInt(replicaId.substring(0,8), 16);
		this.ID.Innards[0] = Integer.parseInt(replicaId.substring(8), 16);
		write();
	}
}