Raible's Wiki: CheckLockTag

-       Raible's Wiki




    Raible Designs

Wiki Home

News

Recent Changes

AppFuse
Homepage

  -  Korean

  -  Chinese

  -  Italian

  -  Japanese

QuickStart Guide

  - Chinese
 
  - French

  - German

  - Italian

  - Korean

  - Portuguese

  - Spanish

  - Japanese


User Guide

  - Korean

  - Chinese
 

Tutorials

  -  Chinese

  -  German

  -  Italian

  -  Korean

  -  Portuguese

  -  Spanish


FAQ

  -  Korean


Latest Downloads

Other Applications
Struts Resume

Security Example

Struts Menu



    




    

    
         
        Set your name in

        UserPreferences
            
    





       
       
       
       




    

Referenced by

JSPWikiTags



    




   



   
   JSPWiki v2.2.33 
   



       
           

           

           
           
           


           Hide Menu
+            CheckLockTag
            



  
    Search Wiki:
    
    
  



         
         
            Your trail: 
         
      

      


      

      
         



      
          Difference between 
          current version 
          and 
          current version:
          

          
At line 1 added 41 lines.
Checks the existence of a [page lock].  A [page lock] is created when an user starts editing a page.  You can use this tag to warn the user, prevent the page from being modified (by removing the editor text area, for example), etc.

----

!Usage

<wiki:CheckLock mode="locked|unlocked|owned" id="<variable>">
;:''content''
</wiki:CheckLock>

!Parameters

;__mode__: If set to "locked", will include the content if the page has been locked.  If set to "owned", will include only if the page is locked by the current user.  Value "unlocked" includes if the page is not locked.
;__id__: The JSP variable named in this parameter will be set to an instance of ~PageLock class.

!Example
{{{
      <wiki:CheckLock mode="locked" id="lock">
         <P CLASS="locknote">User '<%=lock.getLocker()%>' has started to edit this page, but has not yet
         saved.  I won't stop you from editing this page anyway, BUT be aware that
         the other person might be quite annoyed.  It would be courteous to wait for his lock
         to expire or until he stops editing the page.  The lock expires in
         <%=lock.getTimeLeft()%> minutes.
         </P>
      </wiki:CheckLock>
}}}

!The ~PageLock class

The ~PageLock class has the following methods you can use:

;__public WikiPage getPage()__: Returns the current page.

;__public java.lang.String getLocker()__: Returns the user name as a string.

;__public java.util.Date getAcquisitionTime()__: Returns the timestamp when this lock was acquired (i.e. the user started to edit the page.

;__public java.util.Date getExpiryTime()__: Returns the timestamp when this lock expires (if the user has not saved or clicked "cancel")

;__public long getTimeLeft()__: A convinience method, which returns the remaining time to expiry in minutes.



          

      

      

      
      Back to CheckLockTag,
       or to the Page History.
       

      

      

      

      

      

      

      

      Show Menu
-CheckLockTag
+    Search Wiki:
 At line 1 added 41 lines.
+Checks the existence of a [page lock].  A [page lock] is created when an user starts editing a page.  You can use this tag to warn the user, prevent the page from being modified (by removing the editor text area, for example), etc.
+----
+!Usage
+<wiki:CheckLock mode="locked|unlocked|owned" id="<variable>">
+;:''content''
+</wiki:CheckLock>
+!Parameters
+;__mode__: If set to "locked", will include the content if the page has been locked.  If set to "owned", will include only if the page is locked by the current user.  Value "unlocked" includes if the page is not locked.
+;__id__: The JSP variable named in this parameter will be set to an instance of ~PageLock class.
+!Example
+{{{
+      <wiki:CheckLock mode="locked" id="lock">
+         <P CLASS="locknote">User '<%=lock.getLocker()%>' has started to edit this page, but has not yet
+         saved.  I won't stop you from editing this page anyway, BUT be aware that
+         the other person might be quite annoyed.  It would be courteous to wait for his lock
+         to expire or until he stops editing the page.  The lock expires in
+         <%=lock.getTimeLeft()%> minutes.
+         </P>
+      </wiki:CheckLock>
+}}}
+!The ~PageLock class
+The ~PageLock class has the following methods you can use:
+;__public WikiPage getPage()__: Returns the current page.
+;__public java.lang.String getLocker()__: Returns the user name as a string.
+;__public java.util.Date getAcquisitionTime()__: Returns the timestamp when this lock was acquired (i.e. the user started to edit the page.
+;__public java.util.Date getExpiryTime()__: Returns the timestamp when this lock expires (if the user has not saved or clicked "cancel")
+;__public long getTimeLeft()__: A convinience method, which returns the remaining time to expiry in minutes.