8352922: Refactor client classes javadoc to use @throws instead of @exception

Reviewed-by: prr
This commit is contained in:
Sergey Bylokhov 2025-04-12 23:36:27 +00:00
parent 04ad59de76
commit ed756b9700
10 changed files with 14 additions and 14 deletions

View File

@ -63,7 +63,7 @@ public class CodePointInputMethodDescriptor implements InputMethodDescriptor {
* Creates a new instance of the Code Point input method.
*
* @return a new instance of the Code Point input method
* @exception Exception any exception that may occur while creating the
* @throws Exception any exception that may occur while creating the
* input method instance
*/
public InputMethod createInputMethod() throws Exception {

View File

@ -49,7 +49,7 @@ public abstract class X11InputMethod extends X11InputMethodBase {
* Constructs an X11InputMethod instance. It initializes the XIM
* environment if it's not done yet.
*
* @exception AWTException if XOpenIM() failed.
* @throws AWTException if XOpenIM() failed.
*/
public X11InputMethod() throws AWTException {
super();

View File

@ -638,7 +638,7 @@ public class AquaTabbedPaneCopyFromBasicUI extends TabbedPaneUI implements Swing
* Returns the baseline for the specified tab.
*
* @param tab index of tab to get baseline for
* @exception IndexOutOfBoundsException if index is out of range
* @throws IndexOutOfBoundsException if index is out of range
* (index < 0 || index >= tab count)
* @return baseline or a value &lt; 0 indicating there is no reasonable
* baseline

View File

@ -101,7 +101,7 @@ public class CInputMethod extends InputMethodAdapter {
* method.
*
* @param context the input method context for this input method
* @exception NullPointerException if {@code context} is null
* @throws NullPointerException if {@code context} is null
*/
public void setInputMethodContext(InputMethodContext context) {
fIMContext = context;
@ -124,7 +124,7 @@ public class CInputMethod extends InputMethodAdapter {
*
* @param lang locale to input
* @return whether the specified locale is supported
* @exception NullPointerException if {@code locale} is null
* @throws NullPointerException if {@code locale} is null
*/
public boolean setLocale(Locale lang) {
return setLocale(lang, false);
@ -216,7 +216,7 @@ public class CInputMethod extends InputMethodAdapter {
* This method is called by {@link java.awt.im.InputContext#dispatchEvent InputContext.dispatchEvent}.
*
* @param event the event being dispatched to the input method
* @exception NullPointerException if {@code event} is null
* @throws NullPointerException if {@code event} is null
*/
public void dispatchEvent(final AWTEvent event) {
// No-op for Mac OS X.

View File

@ -101,7 +101,7 @@ public final class CPrinterJob extends RasterPrinterJob {
* selected by the user.
* @return {@code true} if the user does not cancel the dialog;
* {@code false} otherwise.
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* @throws HeadlessException if GraphicsEnvironment.isHeadless()
* returns true.
* @see java.awt.GraphicsEnvironment#isHeadless
*/
@ -143,7 +143,7 @@ public final class CPrinterJob extends RasterPrinterJob {
* is cancelled; a new {@code PageFormat} object
* containing the format indicated by the user if the
* dialog is acknowledged.
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* @throws HeadlessException if GraphicsEnvironment.isHeadless()
* returns true.
* @see java.awt.GraphicsEnvironment#isHeadless
* @since 1.2

View File

@ -45,7 +45,7 @@ public abstract class X11InputMethod extends X11InputMethodBase {
* Constructs an X11InputMethod instance. It initializes the XIM
* environment if it's not done yet.
*
* @exception AWTException if XOpenIM() failed.
* @throws AWTException if XOpenIM() failed.
*/
public X11InputMethod() throws AWTException {
super();

View File

@ -162,7 +162,7 @@ public abstract class X11InputMethodBase extends InputMethodAdapter {
* Constructs an X11InputMethod instance. It initializes the XIM
* environment if it's not done yet.
*
* @exception AWTException if XOpenIM() failed.
* @throws AWTException if XOpenIM() failed.
*/
public X11InputMethodBase() throws AWTException {
// supports only the locale in which the VM is started

View File

@ -232,7 +232,7 @@ public class XSettings {
/**
* Parses a particular x setting.
*
* @exception IndexOutOfBoundsException if there isn't enough
* @throws IndexOutOfBoundsException if there isn't enough
* data for a setting.
*/
private void updateOne(long currentSerial)

View File

@ -418,7 +418,7 @@ public final class WPrinterJob extends RasterPrinterJob
* is cancelled, or a new PageFormat object containing
* the format indicated by the user if the dialog is
* acknowledged
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* @throws HeadlessException if GraphicsEnvironment.isHeadless()
* returns true.
* @see java.awt.GraphicsEnvironment#isHeadless
* @since 1.2
@ -571,7 +571,7 @@ public final class WPrinterJob extends RasterPrinterJob
* print job interactively.
* @return false if the user cancels the dialog and
* true otherwise.
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* @throws HeadlessException if GraphicsEnvironment.isHeadless()
* returns true.
* @see java.awt.GraphicsEnvironment#isHeadless
*/

View File

@ -6531,7 +6531,7 @@ public final class AccessBridge {
*
* @return This component's locale. If this component does not have
* a locale, the locale of its parent is returned.
* @exception IllegalComponentStateException
* @throws IllegalComponentStateException
* If the Component does not have its own locale and has not yet
* been added to a containment hierarchy such that the locale can be
* determined from the containing parent.