[
https://issues.apache.org/jira/browse/PIVOT-1027?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16736273#comment-16736273
]
Roger Whitcomb commented on PIVOT-1027:
---------------------------------------
More files updated:
Sending core\src\org\apache\pivot\collections\ArrayAdapter.java
Sending core\src\org\apache\pivot\xml\Element.java
Sending tutorials\src\org\apache\pivot\tutorials\explorer\tools\EventLogger.java
Sending tutorials\src\org\apache\pivot\tutorials\stocktracker\ValueMapping.java
Sending tutorials\src\org\apache\pivot\tutorials\stocktracker\VolumeMapping.java
Sending wtk\src\org\apache\pivot\wtk\Accordion.java
Sending wtk\src\org\apache\pivot\wtk\Alert.java
Sending wtk\src\org\apache\pivot\wtk\ApplicationContext.java
Sending wtk\src\org\apache\pivot\wtk\Border.java
Sending wtk\src\org\apache\pivot\wtk\CalendarButton.java
Sending wtk\src\org\apache\pivot\wtk\ColorChooserButton.java
Sending wtk\src\org\apache\pivot\wtk\Component.java
Sending wtk\src\org\apache\pivot\wtk\Container.java
Sending wtk\src\org\apache\pivot\wtk\Display.java
Sending wtk\src\org\apache\pivot\wtk\Expander.java
Sending wtk\src\org\apache\pivot\wtk\Form.java
Sending wtk\src\org\apache\pivot\wtk\Frame.java
Sending wtk\src\org\apache\pivot\wtk\GridPane.java
Sending wtk-terra\src\org\apache\pivot\wtk\skin\terra\TerraTabPaneSkin.java
Sending wtk-terra\src\org\apache\pivot\wtk\skin\terra\TerraTreeViewSkin.java
Transmitting file data ....................done
Committing transaction...
Committed revision 1850678.
> Add an @UnsupportedOperation annotation that can be used to mark methods that
> always throw UnsupportedOperationException when called
> ------------------------------------------------------------------------------------------------------------------------------------
>
> Key: PIVOT-1027
> URL: https://issues.apache.org/jira/browse/PIVOT-1027
> Project: Pivot
> Issue Type: Improvement
> Components: core
> Reporter: Roger Whitcomb
> Assignee: Roger Whitcomb
> Priority: Minor
>
> This can be used to annotate (primarily in Javadoc) those methods, presumable
> defined by an interface so they must be implemented, but which make no sense
> in the specific implementation. There are numerous examples, but a few
> should suffice:
> * NumericSpinnerData has a fixed range of values specified by the lower and
> upper bounds, so the "remove(...)", "clear()", "add(...)", or "update(...)"
> methods of the List<T> interface don't apply.
> * Various iterators backed by other lists (such as VisibleNodeIterator of
> TerraTreeViewSkin) doesn't support the "remove(...)" method for whatever
> reason, even though it is specified in the Iterator interface.
> * TabButton (part of TerraTabPaneSkin) is a subclass of Button, but many
> methods are unsupported because of its unique structure (such as
> "setTriState", "setButtonData", etc.)
> * ImageNode (one of the unique children of TextPane) always holds a single
> image, so the "insertRange" and "removeRange" methods make no sense.
> Note: this annotation does nothing, and is not retained at runtime, and
> really should be in the Java language (see
> [https://bugs.openjdk.java.net/browse/JDK-6447051] for instance), but it
> makes documentation of unsupported operations a bit clearer at no real cost.
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
