org.asteriskjava.live.internal.AsteriskQueueEntryImpl Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of asterisk-java Show documentation
The free Java library for Asterisk PBX integration.
There is a newer version: 3.41.0
package org.asteriskjava.live.internal;

import org.asteriskjava.live.AsteriskQueueEntry;
import org.asteriskjava.live.QueueEntryState;
import org.asteriskjava.lock.Locker.LockCloser;

import java.util.Date;

/**
 * Default implementation of the AsteriskQueueEntry interface.
 *
 * @author gmi
 */
class AsteriskQueueEntryImpl extends AbstractLiveObject implements AsteriskQueueEntry {
    private final AsteriskQueueImpl queue;
    private final AsteriskChannelImpl channel;
    private final Date dateJoined;

    private Date dateLeft;
    private QueueEntryState state;

    // the position as given by asterisk in the queue entry or join event.
    // we cannot work reliably with it because asterisk doesn't tell us when it
    // shifts the entries.
    private int reportedPosition;

    // The position of this entry in our representation of the queue. Will be
    // set
    // and maintained by the respective queue when the entry is
    // added/removed/shifted
    private int position = POSITION_UNDETERMINED;

    AsteriskQueueEntryImpl(AsteriskServerImpl server, AsteriskQueueImpl queue, AsteriskChannelImpl channel,
                           int reportedPosition, Date dateJoined) {
        super(server);
        this.queue = queue;
        this.channel = channel;
        this.dateJoined = dateJoined;
        this.state = QueueEntryState.JOINED;
        this.reportedPosition = reportedPosition;
    }

    public String getChannelName() {
        return channel.getName();
    }

    public AsteriskQueueImpl getQueue() {
        return queue;
    }

    public AsteriskChannelImpl getChannel() {
        return channel;
    }

    public Date getDateJoined() {
        return dateJoined;
    }

    public Date getDateLeft() {
        return dateLeft;
    }

    /**
     * Sets the status to {@link QueueEntryState#LEFT} and dateLeft to the given
     * date.
     *
     * @param dateLeft the date this member left the queue.
     */
    void left(Date dateLeft) {
        QueueEntryState oldState;
        try (LockCloser closer = this.withLock()) {
            oldState = this.state;
            this.dateLeft = dateLeft;
            this.state = QueueEntryState.LEFT;
        }
        firePropertyChange(PROPERTY_STATE, oldState, state);
    }

    public QueueEntryState getState() {
        return state;
    }

    /**
     * Gets the position as reported by Asterisk when the entry was created.
     * Currently we don't update this property as the entry shifts through the
     * queue, see getPosition() instead.
     *
     * @return the position of the entry in the respective queue, starting at 1
     */
    public int getReportedPosition() {
        return reportedPosition;
    }

    /**
     * Gets the position in the queue based on the queue's internal list 

     * As Asterisk doesn't send events when it shifts entries in the queue we'll
     * base our positions on our internal queue entries ordered list. It should
     * be coherent as entries are always added at the end of the queue and we
     * don't mind if it is different from asterisk's view as long as the
     * relative order stays the same. Most of the time the position will be the
     * same but right after asterisk removes an entry it could differ as the
     * shift occurs asynchronously in asterisk queues. As a consequence we might
     * have temporary holes in the asterisk numbering.
     *
     * @return the position of the entry in the respective queue, starting at 1
     */
    public int getPosition() {
        return position;
    }

    void setPosition(int position) {
        int oldPosition = this.position;
        this.position = position;
        firePropertyChange(PROPERTY_POSITION, oldPosition, position);
    }

    void setReportedPosition(int reportedPosition) {
        int oldPosition = this.reportedPosition;
        this.reportedPosition = reportedPosition;
        firePropertyChange(PROPERTY_REPORTED_POSITION, oldPosition, reportedPosition);
    }

    @Override
    public String toString() {
        StringBuilder sb;
        int systemHashcode;

        sb = new StringBuilder("AsteriskQueueEntry[");

        try (LockCloser closer = this.withLock()) {
            sb.append("dateJoined=").append(getDateJoined()).append(",");
            sb.append("postition=").append(getPosition()).append(",");
            sb.append("dateLeft=").append(getDateLeft()).append(",");
            systemHashcode = System.identityHashCode(this);
        }
        if (channel != null) {
            sb.append("channel=AsteriskChannel[");
            try (LockCloser closer = channel.withLock()) {
                sb.append("id='").append(channel.getId()).append("',");
                sb.append("name='").append(channel.getName()).append("'],");
            }
        } else {
            sb.append("channel=null,");
        }
        sb.append("systemHashcode=").append(systemHashcode);
        sb.append("]");

        return sb.toString();
    }
}