Java究竟怎么玩？

在任何一款桌面應用中，都難免會遇到讓用戶輸入文字或者特殊字符的情況發生，所以輸入法的支持與文本框組件的存在就變得必不可少。

由于Java具有桌面應用開發能力，它的圖形組件中也當然配備有文本框，因而無論是繼承自TextComponent的Text系組件抑或繼承自JTextComponent的JText系組件都提供了讓用戶輸入數據的功能。

現在的疑問是，雖然TextComponent與JTextComponent相類似，但兩者的父類卻并不同級。TextComponent直接繼承自Component，但Component已經是所有Java圖形組件的公共父類，JTextComponent的父類JComponent卻繼承自Container，而Container的父類才是Component。

為什么會這樣呢？如果JTextComponent直接繼承TextComponent難道不好嗎？沒錯，不好，或者說不能。除了Swing與AWT運行原理造成的差異與組件關系的統一性需求外，造成這樣情況的理由中還有一點至關重要，那就是不光JTextComponent不能，即便我們想在java.awt包外重載TextComponent也不能。原因在于，雖然TextComponent類并非final，但它的唯一構造函數卻是default的，這意味著即便不同包中的類繼承了它，也不能構造，根本無法重載。

更何況，就算可以重載的JTextComponent，也與TextComponent一樣存在著一些很麻煩的默認配置問題（就更不要說重載JTextField抑或TextField了）。最主要的是，用它們制作標準文本框固然游刃有余，但如果我們需要的文本框不那么標準，甚至需要某些“奇形怪狀”到只要求輸入文字，但根本就算不上文本框的組件時，那么它們勢必更加捉襟見肘。

那么，我們要怎樣才能滿足這種近乎于“變態”的要求呢？

很簡單，自己“畫”個文本框出來就好了，因為是“畫”的，所以想它怎樣，便是怎樣，因為是憑空繪制，也沒有利用現成Swing組件繪制時的不便。

所以能這樣做，就在于Java獲得輸入法支持的關鍵點不在TextComponent與JTextComponent，而是java.awt.im包下的相關組件，更具體地說，只要你實現了InputMethodListener與InputMethodRequests兩尊大神，那么所有Component都可以支持輸入法，又何必專情于TextComponent與JTextComponent？

閑話少說，現在我就直接用Canvas來“畫”個文本框，給大家瞧瞧。

TextCanvas.java

package org.test; import java.awt.Canvas; import java.awt.Color; import java.awt.Dimension; import java.awt.Font; import java.awt.FontMetrics; import java.awt.Frame; import java.awt.Graphics; import java.awt.Graphics2D; import java.awt.Point; import java.awt.Rectangle; import java.awt.Toolkit; import java.awt.event.FocusEvent; import java.awt.event.FocusListener; import java.awt.event.InputMethodEvent; import java.awt.event.InputMethodListener; import java.awt.event.KeyEvent; import java.awt.event.KeyListener; import java.awt.event.WindowAdapter; import java.awt.event.WindowEvent; import java.awt.font.FontRenderContext; import java.awt.font.TextAttribute; import java.awt.font.TextHitInfo; import java.awt.font.TextLayout; import java.awt.im.InputMethodRequests; import java.text.AttributedCharacterIterator; import java.text.AttributedString; import java.text.AttributedCharacterIterator.Attribute; import sun.awt.InputMethodSupport; /** * * Copyright 2009 * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the * License for the specific language governing permissions and limitations under * the License. * * @project loonframework * @author chenpeng * @email：ceponline@yahoo.com.cn * @version 0.1 */ public class TextCanvas extends Canvas implements KeyListener, FocusListener, InputMethodListener, InputMethodRequests { /** * */ private static final long serialVersionUID = 1L; // 空的字符信息迭代器 private static final AttributedCharacterIterator EMPTY_TEXT = (new AttributedString( "")).getIterator(); // 空的輸入法信息 private static final Attribute[] IM_ATTRIBUTES = { TextAttribute.INPUT_METHOD_HIGHLIGHT }; // 判定當前組件是否具有焦點 private transient boolean haveFocus; // 用戶已輸入數據緩存 private StringBuffer messageText = new StringBuffer(); // 文本布局器，用以限定輸入后顯示的具體位置 private transient TextLayout textLayout = null; // 判定是否驗證輸入法布局器 private transient boolean validTextLayout = false; // 文本顯示位置的坐標修正值 private static final int textOffset = 5; // 已輸入文本定位器 private Point textOrigin = new Point(0, 0); // 已輸入信息的字符串構成數據 private AttributedString composedTextString; // 已輸入信息的字符構成數據 private AttributedCharacterIterator composedText; // 插入符定位器，用以記載游標所在位置 private TextHitInfo caret = null; /** * 構造一個TextCanvas，用以通過純繪制的方式輸入文本信息 * */ public TextCanvas() { super(); this.setForeground(Color.black); this.setBackground(Color.white); this.setFontSize(12); this.setVisible(true); this.setEnabled(true); this.addInputMethodListener(this); this.addKeyListener(this); this.addFocusListener(this); try { Toolkit toolkit = Toolkit.getDefaultToolkit(); boolean shouldEnable = false; // 驗證當前環境是否支持輸入法調用 if (toolkit instanceof InputMethodSupport) { shouldEnable = ((InputMethodSupport) toolkit) .enableInputMethodsForTextComponent(); } enableInputMethods(shouldEnable); } catch (Exception e) { } } /** * 重載Component的輸入法調用接口，因為此類為InputMethodRequests的實現，所以返回this即可。 */ public InputMethodRequests getInputMethodRequests() { return this; } /** * 調正當前顯示的字體大小 * * @param size */ public void setFontSize(int size) { setFont(new Font("Dialog", Font.PLAIN, size)); textOrigin.x = 5; textOrigin.y = (textOffset + size); if (composedTextString != null) { composedTextString.addAttribute(TextAttribute.FONT, getFont()); } } /** * 返回用于顯示的輸入信息集 * * @return */ public AttributedCharacterIterator getDisplayText() { if (composedText == null) { return getDisplayTextToAttributedCharacterIterator(); } else { return EMPTY_TEXT; } } /** * 返回當前插入符所在位置 * * @return */ public TextHitInfo getCaret() { if (composedText == null) { return TextHitInfo.trailing(messageText.length() - 1); } else if (caret == null) { return null; } else { return caret.getOffsetHit(getCommittedTextLength()); } } /** * 觸發輸入法變更事件 */ public void inputMethodTextChanged(InputMethodEvent e) { int committedCharacterCount = e.getCommittedCharacterCount(); AttributedCharacterIterator text = e.getText(); composedText = null; char c; if (text != null) { // 需要復制的字符長度 int toCopy = committedCharacterCount; c = text.first(); while (toCopy-- > 0) { insertCharacter(c); c = text.next(); } if (text.getEndIndex() - (text.getBeginIndex() + committedCharacterCount) > 0) { composedTextString = new AttributedString(text, text .getBeginIndex() + committedCharacterCount, text.getEndIndex(), IM_ATTRIBUTES); composedTextString.addAttribute(TextAttribute.FONT, getFont()); composedText = composedTextString.getIterator(); } } e.consume(); invalidateTextLayout(); caret = e.getCaret(); repaint(); } /** * 修改插入符所在位置 */ public void caretPositionChanged(InputMethodEvent event) { caret = event.getCaret(); event.consume(); repaint(); } /** * 獲得指定定位符對應的文本顯示位置 */ public Rectangle getTextLocation(TextHitInfo offset) { Rectangle rectangle; if (offset == null) { rectangle = getCaretRectangle(); } else { TextHitInfo globalOffset = offset .getOffsetHit(getCommittedTextLength()); rectangle = getCaretRectangle(globalOffset); } Point location = getLocationOnScreen(); rectangle.translate(location.x, location.y); return rectangle; } /** * 獲得偏移指定坐標的插入符信息 */ public TextHitInfo getLocationOffset(int x, int y) { Point location = getLocationOnScreen(); Point textOrigin = getTextOrigin(); x -= location.x + textOrigin.x; y -= location.y + textOrigin.y; TextLayout textLayout = getTextLayout(); if (textLayout != null && textLayout.getBounds().contains(x, y)) { return textLayout.hitTestChar(x, y).getOffsetHit( -getCommittedTextLength()); } else { return null; } } public int getInsertPositionOffset() { return getCommittedTextLength(); } /** * 返回指定范圍內的字符信息迭代器 */ public AttributedCharacterIterator getCommittedText(int beginIndex, int endIndex, Attribute[] attributes) { return getMessageText(beginIndex, endIndex); } public AttributedCharacterIterator cancelLatestCommittedText( Attribute[] attributes) { return null; } public AttributedCharacterIterator getSelectedText(Attribute[] attributes) { return EMPTY_TEXT; } public synchronized void update(Graphics g) { paint(g); } /** * 繪制目標界面 */ public synchronized void paint(Graphics g) { g.setColor(getBackground()); Dimension size = getSize(); g.fillRect(0, 0, size.width, size.height); g.setColor(Color.black); g.drawRect(0, 0, size.width - 1, size.height - 1); if (haveFocus) { g.drawRect(1, 1, size.width - 3, size.height - 3); } g.setColor(getForeground()); TextLayout textLayout = getTextLayout(); if (textLayout != null) { textLayout.draw((Graphics2D) g, textOrigin.x, textOrigin.y); } Rectangle rectangle = getCaretRectangle(); if (haveFocus && rectangle != null) { g.setXORMode(getBackground()); g.fillRect(rectangle.x, rectangle.y, 1, rectangle.height); g.setPaintMode(); } } /** * 將messageText轉化為指定范圍內的字符信息迭代器 * * @param beginIndex * @param endIndex * @return */ public AttributedCharacterIterator getMessageText(int beginIndex, int endIndex) { AttributedString string = new AttributedString(messageText.toString()); return string.getIterator(null, beginIndex, endIndex); } /** * 返回已輸入的字符串信息長度 */ public int getCommittedTextLength() { return messageText.length(); } public AttributedCharacterIterator getDisplayTextToAttributedCharacterIterator() { AttributedString string = new AttributedString(messageText.toString()); if (messageText.length() > 0) { string.addAttribute(TextAttribute.FONT, getFont()); } return string.getIterator(); } /** * 返回當前文本布局器 * * @return */ public synchronized TextLayout getTextLayout() { if (!validTextLayout) { textLayout = null; AttributedCharacterIterator text = getDisplayText(); if (text.getEndIndex() > text.getBeginIndex()) { FontRenderContext context = ((Graphics2D) getGraphics()) .getFontRenderContext(); textLayout = new TextLayout(text, context); } } validTextLayout = true; return textLayout; } /** * 強制文本布局器驗證無效化 * */ public synchronized void invalidateTextLayout() { validTextLayout = false; } /** * 返回文本繪制點 * * @return */ public Point getTextOrigin() { return textOrigin; } /** * 返回對應插入點的矩形選框 * * @return */ public Rectangle getCaretRectangle() { TextHitInfo caret = getCaret(); if (caret == null) { return null; } return getCaretRectangle(caret); } /** * 返回對應插入點的矩形選框 * * @param caret * @return */ public Rectangle getCaretRectangle(TextHitInfo caret) { TextLayout textLayout = getTextLayout(); int caretLocation; if (textLayout != null) { caretLocation = Math.round(textLayout.getCaretInfo(caret)[0]); } else { caretLocation = 0; } FontMetrics metrics = getGraphics().getFontMetrics(); return new Rectangle(textOrigin.x + caretLocation, textOrigin.y - metrics.getAscent(), 0, metrics.getAscent() + metrics.getDescent()); } /** * 插入指定字符串 * * @param c */ public void insertCharacter(char c) { messageText.append(c); invalidateTextLayout(); } /** * 用戶輸入 */ public void keyTyped(KeyEvent event) { char keyChar = event.getKeyChar(); // 處理文字刪除 if (keyChar == '/b') { int len = messageText.length(); if (len > 0) { messageText.setLength(len - 1); invalidateTextLayout(); } } else { insertCharacter(keyChar); } event.consume(); repaint(); } public void keyPressed(KeyEvent event) { } public void keyReleased(KeyEvent event) { } public void focusGained(FocusEvent event) { haveFocus = true; repaint(); } public void focusLost(FocusEvent event) { haveFocus = false; repaint(); } public static void main(String[] args) { Frame frame = new Frame("繪制一個輸入框"); TextCanvas text = new TextCanvas(); frame.add(text); frame.addWindowListener(new WindowAdapter() { public void windowClosing(WindowEvent e) { System.exit(0); } }); frame.pack(); frame.setSize(300, 300); frame.setLocationRelativeTo(null); frame.setVisible(true); } }

運行效果如下圖：

怎么樣？這時你在TextCanvas中進行輸入操作，是不是與JTextField或TextField里相差無幾呢？——什么？你說就算“重復發明輪子”也應該有個限度，已經有JTextField與TextField了，你再寫一個有什么用？

嗯，您很聰明，單純的繪制文本框確實沒有任何意義，但是，如果有一系列直接通過AWT繪制的組件與其相呼應呢？——比如，偶在LGame-Simple中制作的那一系列UI組件……

那么事情，就會變成如下這個樣子。

怎么樣呢？如上圖所示，這是一個純繪制的界面，無論文本框的字體，大小，顏色乃至透明度，貼圖都可以隨性切換（甚至逆天的將兩個文本框疊在一起也可以）， 而這樣一個純繪制出的文本框能夠獲得輸入法支持，意味著什么呢？這意味著，一個相對于Swing能耗更少，效率更高的類Swing體系已經搭建成型了！(當然，相對的功能也更少，不過事無兩利嘛……)

PS:如上所述，LGame-Simple-0.2.5版Text系組件將獲得輸入法支持，中文或其它語言的輸入已經沒有任何問題。（此版預計同Android版LGame一道于12月中下旬發布……不過，那是理想狀態，事實上偶欠著的事情挺多，盡力看看……）

嗯，其實PS中的話才是最主要的……