Posted on 2008-04-22 20:31
guanminglin@gmail.com 閱讀(1932)
評論(6) 編輯 收藏 所屬分類:
NetBeans
今天試著翻譯了一點SwingApplicationFramework 的其中一個源代碼的注釋，感覺翻譯的不怎么樣（這是我第一次翻譯API）。現(xiàn)在把它貼出來，大家看看，希望大家能夠給點意見，批評指正一下，有什么翻譯不妥的地方盡管提出來，好讓我改進改進，先謝謝了！
下面是部分代碼注釋的翻譯：
package org.jdesktop.application;
import java.beans.PropertyChangeEvent;
import java.beans.PropertyChangeListener;
import java.beans.PropertyChangeSupport;
import javax.swing.SwingUtilities;
/**
*
* An encapsulation of the PropertyChangeSupport methods based on
* java.beans.PropertyChangeSupport.PropertyChangeListeners are fired
* on the event dispatching thread.
*中文翻譯：
*一個封裝的PropertyChangeSupport方法基于java.beans.PropertyChangeSupport
*當事件調(diào)度線程的時候PropertyChangeListeners將被激活
*
*
* <p>
* Note: this class is only public because the so-called "fix"
* for javadoc bug
* <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4780441">4780441</a>
* still fails to correctly document public methods inherited from a package
* private class.
* 中文：
* 提示：這個類只能是public 因為所謂的用來“fix”（修復(fù)）javadoc 的bug。
* <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4780441">4780441</a>
* 仍然不能得體的書寫 public 方法 繼承于私有類包
*/
public class AbstractBean {
private final PropertyChangeSupport pcs;
public AbstractBean() {
pcs = new EDTPropertyChangeSupport(this);
}
/**
* Add a PropertyChangeListener to the listener list.
* The listener is registered for all properties and its
* {@code propertyChange} method will run on the event dispatching
* thread.
* <p>
* If {@code listener} is null, no exception is thrown and no action
* is taken.
* 中文：
* 添加一個PropertyChangeListener到監(jiān)聽器列表中
* 監(jiān)聽器為所有的屬性都進行了注冊，并且他的{@code propertyChange} 方法將會在
* 事件調(diào)度線程的時候運行。
* <p>
* 如果{@code listener} 為空，則不會拋出異常，也不會有動作執(zhí)行（發(fā)生）
* @param listener the PropertyChangeListener to be added.
* 中文：PropertyChangeListener 將會被添加到監(jiān)聽器列表中。
* @see #removePropertyChangeListener 中文：移除PropertyChangeListener
* @see java.beans.PropertyChangeSupport#addPropertyChangeListener
*/
public void addPropertyChangeListener(PropertyChangeListener listener) {
pcs.addPropertyChangeListener(listener);
}
/**
* Remove a PropertyChangeListener from the listener list.
*
* <p>
* If {@code listener} is null, no exception is thrown and no action
* is taken.
*
* 從監(jiān)聽器列表中移除一個PropertyChangeListener
* 如果{@code listener} 為空，則不會拋出異常，也不會有動作執(zhí)行（發(fā)生）
*
* @param listener the PropertyChangeListener to be removed.
中文：PropertyChangeListener 將會被添加到監(jiān)聽器列表中
* @see #addPropertyChangeListener 中文：添加事件監(jiān)聽器
* @see java.beans.PropertyChangeSupport#removePropertyChangeListener
*/
public void removePropertyChangeListener(PropertyChangeListener listener) {
pcs.removePropertyChangeListener(listener);
}
/**
* Add a PropertyChangeListener for a specific property. The listener
* will be invoked only when a call on firePropertyChange names that
* specific property.
* The same listener object may be added more than once. For each
* property, the listener will be invoked the number of times it was added
* for that property.
* If <code>propertyName</code> or <code>listener</code> is null, no
* exception is thrown and no action is taken.
* 中文：為一個具體的屬性添加PropertyChangeListener（屬性變化監(jiān)聽器）。
* 這個監(jiān)聽器只會在特殊屬性被命名的時候被調(diào)用
* 同樣的監(jiān)聽器也許會被添加多次。對于不同的屬性，監(jiān)聽器將會被他所監(jiān)聽的屬性調(diào)用多次
* 如果<code>propertyName</code>或<code>listener</code>為空，則不會拋出異常，
* 也不會有動作被執(zhí)行（發(fā)生）
* @param propertyName The name of the property to listen on. 中文：被監(jiān)聽的屬性名字
* @param listener the PropertyChangeListener to be added 中文：PropertyChangeListener將會被添加
* @see java.beans.PropertyChangeSupport#addPropertyChangeListener(String, PropertyChangeListener)
*/
public void addPropertyChangeListener(String propertyName, PropertyChangeListener listener) {
pcs.addPropertyChangeListener(propertyName, listener);
}
/**
* Remove a PropertyChangeListener for a specific property.
* If <code>listener</code> was added more than once to the same event
* source for the specified property, it will be notified one less time
* after being removed.
* If <code>propertyName</code> is null, no exception is thrown and no
* action is taken.
* If <code>listener</code> is null, or was never added for the specified
* property, no exception is thrown and no action is taken.
*
中文：為具體的屬性移除一個PropertyChangeListener。如果<code>listener</code>
被多次的添加的同一個事件源中，它將會在移除的時候一次也不少的被通知到
如果<code>propertyName</code> 為空，則則不會拋出異常，
* 也不會有動作被執(zhí)行（發(fā)生）
如果<code>listener</code> 為空或者根本沒有被添加到特定的屬性中，則不會拋出異常，
* 也不會有動作被執(zhí)行（發(fā)生）
* @param propertyName The name of the property that was listened on. 中文：被監(jiān)聽的屬性名字
* @param listener The PropertyChangeListener to be removed PropertyChangeListener將被移除
* @see java.beans.PropertyChangeSupport#removePropertyChangeListener(String, PropertyChangeListener)
*/
public synchronized void removePropertyChangeListener(String propertyName, PropertyChangeListener listener) {
pcs.removePropertyChangeListener(propertyName, listener);
}
…………