// 獲取互斥鎖
public void acquire() throws Exception;
// 在給定的時(shí)間內(nèi)獲取互斥鎖
public boolean acquire(long time, TimeUnit unit) throws Exception;
// 釋放鎖處理
public void release() throws Exception;
// 如果此JVM中的線程獲取了互斥鎖，則返回true
boolean isAcquiredInThisProcess();

public class InterProcessMutex implements InterProcessLock, Revocable<InterProcessMutex> {
    // LockInternals是真正實(shí)現(xiàn)操作zookeeper的類，它內(nèi)部包含連接zookeeper客戶端的CuratorFramework
    // LockInternals的具體實(shí)現(xiàn)后面我會(huì)講到
    private final LockInternals internals;
  	// basePath是鎖的根結(jié)點(diǎn)，所有的臨時(shí)有序的節(jié)點(diǎn)都是basePath的子節(jié)點(diǎn)，
    private final String basePath;
    // 
    private final ConcurrentMap<Thread, LockData> threadData = Maps.newConcurrentMap();
	// LockData封裝了請(qǐng)求對(duì)應(yīng)的線程(owningThread)、鎖的重入的次數(shù)(lockCount)、線程對(duì)應(yīng)的臨時(shí)節(jié)點(diǎn)(lockPath)
    private static class LockData {
        final Thread owningThread;
        final String lockPath;
      	// 原子性的
        final AtomicInteger lockCount = new AtomicInteger(1);

        private LockData(Thread owningThread, String lockPath)
        {
            this.owningThread = owningThread;
            this.lockPath = lockPath;
        }
    }
  
    private static final String LOCK_NAME = "lock-";
    // 獲取互斥鎖，阻塞【InterProcessLock的實(shí)現(xiàn)】
    @Override
    public void acquire() throws Exception {
      	// 獲取鎖，一直等待
        if ( !internalLock(-1, null) ) {
            throw new IOException("Lost connection while trying to acquire lock: " + basePath);
        }
    }
    // 獲取互斥鎖，指定時(shí)間time【InterProcessLock的實(shí)現(xiàn)】
    @Override
    public boolean acquire(long time, TimeUnit unit) throws Exception {
        return internalLock(time, unit);
    }
    // 當(dāng)前線程是否占用鎖中【InterProcessLock的實(shí)現(xiàn)】
    @Override
    public boolean isAcquiredInThisProcess() {
        return (threadData.size() > 0);
    }
    //如果調(diào)用線程與獲取互斥鎖的線程相同，則執(zhí)行一次互斥鎖釋放。如果線程已多次調(diào)用acquire，當(dāng)此方法返回時(shí)，互斥鎖仍將保留 【InterProcessLock的實(shí)現(xiàn)】
    @Override
    public void release() throws Exception {
        Thread currentThread = Thread.currentThread(); //當(dāng)前線程
        LockData lockData = threadData.get(currentThread); //線程對(duì)應(yīng)的鎖信息
        if ( lockData == null ) {
            throw new IllegalMonitorStateException("You do not own the lock: " + basePath);
        }
      	// 因?yàn)楂@取到的鎖是可重入的，對(duì)lockCount進(jìn)行減1，lockCount=0時(shí)才是真正釋放鎖
        int newLockCount = lockData.lockCount.decrementAndGet();
        if ( newLockCount > 0 ) {
            return;
        }
        if ( newLockCount < 0 ) {
            throw new IllegalMonitorStateException("Lock count has gone negative for lock: " + basePath);
        }
        try {
          	// 到這里時(shí)lockCount=0,具體釋放鎖的操作交給LockInternals中的releaseLock方法實(shí)現(xiàn)
            internals.releaseLock(lockData.lockPath);
        }
        finally {
            threadData.remove(currentThread);
        }
    }
  	// 獲取basePath根結(jié)點(diǎn)下的所有臨時(shí)節(jié)點(diǎn)的有序集合
  	public Collection<String> getParticipantNodes() throws Exception {
        return LockInternals.getParticipantNodes(internals.getClient(), basePath, internals.getLockName(), internals.getDriver());
    }
    
  	boolean isOwnedByCurrentThread() {
        LockData lockData = threadData.get(Thread.currentThread());
        return (lockData != null) && (lockData.lockCount.get() > 0);
    }
  	protected String getLockPath() {
        LockData lockData = threadData.get(Thread.currentThread());
        return lockData != null ? lockData.lockPath : null;
    }
  	// acquire()中調(diào)用的internalLock()方法
  	private boolean internalLock(long time, TimeUnit unit) throws Exception {
        Thread currentThread = Thread.currentThread();
        LockData lockData = threadData.get(currentThread);
        if ( lockData != null ) {
            // 如果當(dāng)前線程已經(jīng)獲取到了鎖，那么將重入次數(shù)lockCount+1，返回true
            lockData.lockCount.incrementAndGet();
            return true;
        }
      	// attemptLock方法是獲取鎖的真正實(shí)現(xiàn)，lockPath是當(dāng)前線程成功在basePath下創(chuàng)建的節(jié)點(diǎn)，若lockPath不為空代表成功獲取到鎖
        String lockPath = internals.attemptLock(time, unit, getLockNodeBytes());
        if ( lockPath != null ) {
          	// lockPath封裝到當(dāng)前線程對(duì)應(yīng)的鎖信息中
            LockData newLockData = new LockData(currentThread, lockPath);
            threadData.put(currentThread, newLockData);
            return true;
        }
        return false;
    }
}

public class LockInternals {
    private final CuratorFramework                  client; // 連接zookeeper的客戶端
    private final String                            path;	// 等于basePath，InterProcessMutex中傳進(jìn)來(lái)的
    private final String                            basePath; // 根結(jié)點(diǎn)
    private final LockInternalsDriver               driver; // 操作zookeeper節(jié)點(diǎn)的driver
    private final String                            lockName; // "lock-"
    private final AtomicReference<RevocationSpec>   revocable = new AtomicReference<RevocationSpec>(null);
  
    private final CuratorWatcher                    revocableWatcher = new CuratorWatcher() {
        @Override
        public void process(WatchedEvent event) throws Exception {
            if ( event.getType() == Watcher.Event.EventType.NodeDataChanged ) {
                checkRevocableWatcher(event.getPath());
            }
        }
    };
    // 監(jiān)聽節(jié)點(diǎn)的監(jiān)聽器，若被監(jiān)聽的節(jié)點(diǎn)有動(dòng)靜，則喚醒 notifyFromWatcher()=>notifyAll();
   	private final Watcher watcher = new Watcher() {
        @Override
        public void process(WatchedEvent event) {
            notifyFromWatcher();
        }
    };
   	private volatile int    maxLeases;
  	// 獲取basePath的子節(jié)點(diǎn)，排序后的
  	public static List<String> getSortedChildren(CuratorFramework client, String basePath, final String lockName, final LockInternalsSorter sorter) throws Exception
    {
        List<String> children = client.getChildren().forPath(basePath);
        List<String> sortedList = Lists.newArrayList(children);
        Collections.sort
        (
            sortedList,
            new Comparator<String>()
            {
                @Override
                public int compare(String lhs, String rhs)
                {
                    return sorter.fixForSorting(lhs, lockName).compareTo(sorter.fixForSorting(rhs, lockName));
                }
            }
        );
        return sortedList;
    }
  	// 嘗試獲取鎖【internalLock=>attemptLock】
  	String attemptLock(long time, TimeUnit unit, byte[] lockNodeBytes) throws Exception
    {	// 開始時(shí)間
        final long      startMillis = System.currentTimeMillis(); 
      	// 記錄等待時(shí)間
        final Long      millisToWait = (unit != null) ? unit.toMillis(time) : null;
        final byte[]    localLockNodeBytes = (revocable.get() != null) ? new byte[0] : lockNodeBytes;
      	// 重試次數(shù)
        int             retryCount = 0;
      	// 當(dāng)前節(jié)點(diǎn)
        String          ourPath = null;
      	// 是否獲取到鎖的標(biāo)志
        boolean         hasTheLock = false;
      	// 是否放棄獲取到標(biāo)志
        boolean         isDone = false;
      	// 不停嘗試獲取
        while ( !isDone )
        {
            isDone = true;

            try
            {	// 創(chuàng)建當(dāng)前線程對(duì)應(yīng)的節(jié)點(diǎn)
                ourPath = driver.createsTheLock(client, path, localLockNodeBytes);
              	// internalLockLoop中獲取
                hasTheLock = internalLockLoop(startMillis, millisToWait, ourPath);
            }
            catch ( KeeperException.NoNodeException e )
            {	// 是否可再次嘗試
                if ( client.getZookeeperClient().getRetryPolicy().allowRetry(retryCount++, System.currentTimeMillis() - startMillis, RetryLoop.getDefaultRetrySleeper()) )
                {
                    isDone = false;
                }
                else
                {
                    throw e;
                }
            }
        }
		// 獲取到鎖后，返回當(dāng)前線程對(duì)應(yīng)創(chuàng)建的節(jié)點(diǎn)路徑
        if ( hasTheLock )
        {
            return ourPath;
        }

        return null;
    }
  	// 循環(huán)獲取【attemptLock=>internalLockLoop】
  	private boolean internalLockLoop(long startMillis, Long millisToWait, String ourPath) throws Exception
    {
        boolean     haveTheLock = false; // 是否擁有分布式鎖
        boolean     doDelete = false;	// 是否需要?jiǎng)h除當(dāng)前節(jié)點(diǎn)
        try
        {
            if ( revocable.get() != null )
            {
                client.getData().usingWatcher(revocableWatcher).forPath(ourPath);
            }
			// 循環(huán)嘗試獲取鎖
            while ( (client.getState() == CuratorFrameworkState.STARTED) && !haveTheLock )
            {	// 得到basePath下排序后的臨時(shí)子節(jié)點(diǎn)
                List<String>        children = getSortedChildren();
              	// 獲取之前創(chuàng)建的當(dāng)前線程對(duì)應(yīng)的子節(jié)點(diǎn)
                String              sequenceNodeName = ourPath.substring(basePath.length() + 1); // +1 to include the slash
				// 判斷是否獲取到鎖，沒(méi)有就返回監(jiān)聽路徑
                PredicateResults    predicateResults = driver.getsTheLock(client, children, sequenceNodeName, maxLeases);
              	// 成功獲取到
                if ( predicateResults.getsTheLock() )
                {
                    haveTheLock = true;
                }
                else
                {	// 沒(méi)有獲取到鎖，監(jiān)聽前一個(gè)臨時(shí)順序節(jié)點(diǎn)
                    String  previousSequencePath = basePath + "/" + predicateResults.getPathToWatch();

                    synchronized(this)
                    {
                        try 
                        {                           
					// 上一個(gè)臨時(shí)順序節(jié)點(diǎn)如果被刪除，會(huì)喚醒當(dāng)前線程繼續(xù)競(jìng)爭(zhēng)鎖  
                          client.getData().usingWatcher(watcher).forPath(previousSequencePath);
                            if ( millisToWait != null )
                            {
                                millisToWait -= (System.currentTimeMillis() - startMillis);
                                startMillis = System.currentTimeMillis();
                              	// 獲取鎖超時(shí)
                                if ( millisToWait <= 0 )
                                {
                                    doDelete = true;    // timed out - delete our node
                                    break;
                                }

                                wait(millisToWait);
                            }
                            else
                            {
                                wait();
                            }
                        }
                        catch ( KeeperException.NoNodeException e ) 
                        {
                            // it has been deleted (i.e. lock released). Try to acquire again
                        }
                    }
                }
            }
        }
        catch ( Exception e )
        {
            ThreadUtils.checkInterrupted(e);
            doDelete = true;
            throw e;
        }
        finally
        {
            if ( doDelete )
            {
              	// 因?yàn)楂@取鎖超時(shí)，所以刪除之前創(chuàng)建的臨時(shí)子節(jié)點(diǎn)
                deleteOurPath(ourPath);
            }
        }
        return haveTheLock;
    }
  
  	private void deleteOurPath(String ourPath) throws Exception {
        try
        {
          	// 刪除
            client.delete().guaranteed().forPath(ourPath);
        }
        catch ( KeeperException.NoNodeException e )
        {
            // ignore - already deleted (possibly expired session, etc.)
        }
    }
  
 }

	// 前面internalLockLoop方法中driver.getsTheLock執(zhí)行的方法
	@Override
    public PredicateResults getsTheLock(CuratorFramework client, List<String> children, String sequenceNodeName, int maxLeases) throws Exception
    {
    	// 獲取子節(jié)點(diǎn)在臨時(shí)順序節(jié)點(diǎn)列表中的位置
        int             ourIndex = children.indexOf(sequenceNodeName);
        // 檢驗(yàn)子節(jié)點(diǎn)在臨時(shí)順序節(jié)點(diǎn)列表中是否有效
        validateOurIndex(sequenceNodeName, ourIndex);
        // 若當(dāng)前子節(jié)點(diǎn)的位置<maxLeases，代表可獲取鎖【maxLeases默認(rèn)=1，若ourIndex=0，代筆自己位置最小】
        boolean         getsTheLock = ourIndex < maxLeases;
        // getsTheLock=true，則不需要監(jiān)聽前maxLeases的節(jié)點(diǎn)【maxLeases默認(rèn)=1，代表監(jiān)聽前面最靠近自己的節(jié)點(diǎn)】
        String          pathToWatch = getsTheLock ? null : children.get(ourIndex - maxLeases);

        return new PredicateResults(pathToWatch, getsTheLock);
    }