Java эксперт - Вклад участника [ru]

Java эксперт:Отказ от ответственности

2010-06-01T15:02:03Z

Admin: Новая страница: «JEXP.RU, Интернет-энциклопедия с открытым содержимым, является добровольным сообществом лич…»

JEXP.RU, Интернет-энциклопедия с открытым содержимым, является добровольным сообществом личностей и групп, создающих общее хранилище человеческих знаний. Её строение позволяет любому, кто имеет доступ к Интернету и браузер, изменять её содержание. Поэтому, пожалуйста, примите во внимание, что приведённые здесь сведения могут быть не проверенными профессионалами, обладающими знаниями в соответствующих областях, необходимыми для предоставления вам полной, точной или заслуживающей доверия информации о любом понятии в JEXP.RU.

Нельзя сказать, что в JEXP.RU не так уж много полезной и точной информации, однако вы должны сознавать, что JEXP.RU не может никаким способом гарантировать правильность приведённых в ней данных. Во время прочтения они могли быть только что изменены, испорчены, либо написаны тем, чьё мнение отличается от общепринятого в области знаний, интересующей вас.

Мы ищем пути проверки и отбора вызывающих наибольшее доверие версий статей, но мы не можем ничего гарантировать. Наше наибольшее достижение — это избранные участниками статьи, но даже они могли быть испорчены или искажены кем-то за несколько мгновений до прочтения вами.

Никто из авторов, участников, спонсоров, администраторов, операторов и лиц, как-либо ещё связанных с JEXP.RU, не несёт ответственность за появление неточной или ложной информации, а также за использование вами данных, содержащихся на этих веб-страницах либо найденных по ссылкам с них.
Пожалуйста, примите во внимание, что вся информация, находящаяся здесь, предоставлена свободно, как акт доброй воли, без заключения каких-либо договорённостей или договоров между вами и владельцами или пользователями данного сайта, владельцами серверов, на которых он размещён, авторами JEXP.RU, администраторами проекта, операторами либо кем-то ещё, любым образом связанными с этим или родственными ему проектами, которые [договора] могут стать предметом прямых претензий. Вам предоставляется ограниченное право копировать содержимое этого сайта — данное право не предусматривает и не подразумевает никакой договорной или иной ответственности за любую часть JEXP.RU или её агентов, участников, организаторов или других пользователей.

Любые торговые марки, знаки и названия товаров, служб и организаций, права на дизайн, авторские и смежные права, которые упоминаются, используются или цитируются в статьях, принадлежат их законным владельцам. Их использование здесь не даёт вам право на любое другое использование, кроме предусмотренного авторами статей JEXP.RU в соответствии со схемой лицензирования GFDL. Если не указано иное, JEXP.RU никак не связан с правообладателями, и поэтому JEXP.RU не может распоряжаться правами на использование материалов, защищённых авторским правом. Вы несёте ответственность за использование этих и подобных материалов.

Обратите внимание, что чтение, распространение или изменение информации, размещённой в JEXP.RU, может являться нарушением законов той страны, в которой вы просматриваете этот сайт. JEXP.RU не призывает к нарушению никаких законов. Законы вашей страны могут трактовать защиту свободы слова не так широко, как законы России — в этом случае JEXP.RU не несёт ответственности за любые потенциальные нарушения этих законов вами при создании ссылок на этот сайт или другом использовании любой содержащейся здесь информации.

Несмотря на то, что пользователи могут исправлять ошибки или убирать ошибочные суждения, они не обязаны этого делать. Поэтому вся информация предоставляется без гарантии полезности для любой цели либо пригодности к какому-либо использованию.

JEXP.RU не может нести ответственность за любой нанесённый ущерб, так как является добровольным сообществом, свободно организованным для создания открытых образовательных, культурных и информационных ресурсов. Информация предоставляется как акт доброй воли и не существует соглашения или акта о намерениях между вами и JEXP.RU относительно использования или изменения информации, не предусмотренного GNU Free Documentation License. Также никто в JEXP.RU не несёт ответственности за изменение, редактирование или удаление любой информации, добавленной вами в JEXP.RU или другие связанные с ней проекты.

Спасибо, что потратили своё время на чтение этой страницы. Желаем вам получить только приятные впечатления от пользования JEXP.RU.

Java эксперт:Авторское право

2010-06-01T14:55:27Z

Admin: Защищена страница «Java эксперт:Авторское право» ([edit=sysop] (бессрочно) [move=sysop] (бессрочно))

Java эксперт:Авторское право

2010-06-01T14:54:57Z

Java/2D Graphics GUI/Font

2010-06-01T14:33:40Z

Admin: Новая страница: «== A cache of the dynamically loaded fonts found in the fonts directory == <source lang="java"> /* * @(#)DemoFonts.java 1.17 06/08/29 * * Copyright (c) 2…»

== A cache of the dynamically loaded fonts found in the fonts directory ==

<source lang="java">
/*
* @(#)DemoFonts.java 1.17 06/08/29
*
* Copyright (c) 2006 Sun Microsystems, Inc. All Rights Reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* -Redistribution of source code must retain the above copyright notice, this
* list of conditions and the following disclaimer.
*
* -Redistribution in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* Neither the name of Sun Microsystems, Inc. or the names of contributors may
* be used to endorse or promote products derived from this software without
* specific prior written permission.
*
* This software is provided "AS IS," without a warranty of any kind. ALL
* EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING
* ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
* OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN MIDROSYSTEMS, INC. ("SUN")
* AND ITS LICENSORS SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE
* AS A RESULT OF USING, MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS
* DERIVATIVES. IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR ANY LOST
* REVENUE, PROFIT OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL,
* INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY
* OF LIABILITY, ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE,
* EVEN IF SUN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
*
* You acknowledge that this software is not designed, licensed or intended
* for use in the design, construction, operation or maintenance of any
* nuclear facility.
*/
/*
* @(#)DemoFonts.java 1.17 06/08/29
*/
import java.awt.Font;
import java.io.InputStream;
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;
/**
* A cache of the dynamically loaded fonts found in the fonts directory.
*/
public class DemoFonts {
// Prepare a static "cache" mapping font names to Font objects.
private static String[] names = { "A.ttf" };
private static Map<String, Font> cache = new ConcurrentHashMap<String, Font>(names.length);
static {
for (String name : names) {
cache.put(name, getFont(name));
}
}
public static Font getFont(String name) {
Font font = null;
if (cache != null) {
if ((font = cache.get(name)) != null) {
return font;
}
}
String fName = "/fonts/" + name;
try {
InputStream is = DemoFonts.class.getResourceAsStream(fName);
font = Font.createFont(Font.TRUETYPE_FONT, is);
} catch (Exception ex) {
ex.printStackTrace();
System.err.println(fName + " not loaded. Using serif font.");
font = new Font("serif", Font.PLAIN, 24);
}
return font;
}
}

</source>

== Create font from true type font ==

<source lang="java">
import java.awt.Font;
import java.io.File;
import java.io.FileInputStream;
import javax.swing.JFrame;
import javax.swing.JLabel;
public class Main {
public static void main(String[] args) throws Exception {
File f = new File("your.ttf");
FileInputStream in = new FileInputStream(f);
Font dynamicFont = Font.createFont(Font.TRUETYPE_FONT, in);
Font dynamicFont32Pt = dynamicFont.deriveFont(32f);
JLabel testLabel = new JLabel(dynamicFont.getName());
testLabel.setFont(dynamicFont32Pt);
JFrame frame = new JFrame("Font Loading Demo");
frame.getContentPane().add(testLabel);
frame.pack();
frame.setVisible(true);
}
}

</source>

== Display font in a grid ==

<source lang="java">
import java.awt.Font;
import java.awt.Graphics;
import javax.swing.JFrame;
import javax.swing.JPanel;
public class Main {
public static void main(String[] args) {
final int columnCount = 10;
final int side = 25;
final int[][] grid = new int[50][columnCount];
JPanel panel = new JPanel() {
public void paintComponent(Graphics g) {
Font font = new Font("WingDings", Font.PLAIN, 14);
g.setFont(font);
int off = 0;
for (int i = 0; i < 256 * 256; i++) {
if (font.canDisplay((char) i) == false) {
continue;
}
off++;
grid[off / columnCount][off % columnCount] = i;
int x = off % columnCount * side;
int y = (off / columnCount) * side + side;
g.drawString(Character.toString((char)i), x, y);
}
}
};
JFrame frame = new JFrame();
panel.setSize(300, 300);
frame.getContentPane().add(panel);
frame.setSize(300, 300);
frame.setVisible(true);
}
}

</source>

== Draw font inside a Rectangle ==

<source lang="java">
import java.awt.Font;
import java.awt.FontMetrics;
import java.awt.Graphics;
import javax.swing.JFrame;
import javax.swing.JPanel;
public class StringRectPaintPanel extends JPanel {
public void paint(Graphics g) {
g.setFont(new Font("",0,100));
FontMetrics fm = getFontMetrics(new Font("",0,100));
String s = "jexp";
int x = 5;
int y = 5;

for (int i = 0; i < s.length(); i++) {
char c = s.charAt(i);
int h = fm.getHeight();
int w = fm.charWidth(c);
g.drawRect(x, y, w, h);
g.drawString(String.valueOf(c), x, y + h);
x = x + w;
}
}
public static void main(String[] args) {
JFrame frame = new JFrame();
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
frame.setContentPane(new StringRectPaintPanel());
frame.setSize(500, 300);
frame.setVisible(true);
}
}

</source>

== Finds and displays available fonts ==

<source lang="java">
/*
* Copyright (c) Ian F. Darwin, http://www.darwinsys.ru/, 1996-2002.
* All rights reserved. Software written by Ian F. Darwin and others.
* $Id: LICENSE,v 1.8 2004/02/09 03:33:38 ian Exp $
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS""
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*
* Java, the Duke mascot, and all variants of Sun"s Java "steaming coffee
* cup" logo are trademarks of Sun Microsystems. Sun"s, and James Gosling"s,
* pioneering role in inventing and promulgating (and standardizing) the Java
* language and environment is gratefully acknowledged.
*
* The pioneering role of Dennis Ritchie and Bjarne Stroustrup, of AT&T, for
* inventing predecessor languages C and C++ is also gratefully acknowledged.
*/
import java.awt.Dimension;
import java.awt.Font;
import java.awt.Graphics;
import java.awt.GraphicsEnvironment;
import java.awt.Toolkit;
import javax.swing.JComponent;
import javax.swing.JFrame;
import javax.swing.JScrollPane;
/**
* Finds and displays available fonts
* <p>
* TODO: should be a JTable with the text name in one column and the demo in a
* JLabel in the other.
*
* @author Ian Darwin (original)
*/
public class FontDemo extends JComponent {
/** The list of Fonts */
protected String[] fontNames;
/** The fonts themselves */
protected Font[] fonts;
/** How much space between each name */
static final int YINCR = 20;
/**
* Construct a FontDemo -- Sets title and gets array of fonts on the system
*/
public FontDemo() {
Toolkit toolkit = Toolkit.getDefaultToolkit();
// For JDK 1.1: returns about 10 names (Serif, SansSerif, etc.)
// fontNames = toolkit.getFontList();
// For JDK 1.2: a much longer list; most of the names that come
// with your OS (e.g., Arial, Lucida, Lucida Bright, Lucida Sans...)
fontNames = GraphicsEnvironment.getLocalGraphicsEnvironment()
.getAvailableFontFamilyNames();
fonts = new Font[fontNames.length];
}
public Dimension getPreferredSize() {
return new Dimension(500, fontNames.length * YINCR);
}
/**
* Draws the font names in its font. Called by AWT when painting is needed
* Does lazy evaluation of Font creation, caching the results (without this,
* scrolling performance suffers even on a P3-750).
*/
public void paint(Graphics g) {
for (int i = 0; i < fontNames.length; i += 1) {
if (fonts[i] == null) {
fonts[i] = new Font(fontNames[i], Font.BOLD, 14);
}
g.setFont(fonts[i]);
int x = 20;
int y = 20 + (YINCR * i);
g.drawString(fontNames[i], x, y);
}
}
/** Simple main program to start it running */
public static void main(String[] args) {
JFrame f = new JFrame("Font Demo");
f.getContentPane().add(new JScrollPane(new FontDemo()));
f.setSize(600, 700);
f.setVisible(true);
f.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
}
}

</source>

== Font centered ==

<source lang="java">
import java.awt.Font;
import java.awt.Graphics;
import java.awt.Graphics2D;
import java.awt.RenderingHints;
import java.awt.font.FontRenderContext;
import java.awt.geom.Rectangle2D;
import javax.swing.JFrame;
import javax.swing.JPanel;
public class HorizontallyCenteredText extends JPanel {
public void paint(Graphics g) {
Graphics2D g2 = (Graphics2D) g;
g2.setRenderingHint(RenderingHints.KEY_ANTIALIASING,
RenderingHints.VALUE_ANTIALIAS_ON);
g2.setFont(new Font("Serif", Font.PLAIN, 48));
paintHorizontallyCenteredText(g2, "Java Source", 200, 75);
paintHorizontallyCenteredText(g2, "and", 200, 125);
paintHorizontallyCenteredText(g2, "Support", 200, 175);
}
protected void paintHorizontallyCenteredText(Graphics2D g2, String s,
float centerX, float baselineY) {
FontRenderContext frc = g2.getFontRenderContext();
Rectangle2D bounds = g2.getFont().getStringBounds(s, frc);
float width = (float) bounds.getWidth();
g2.drawString(s, centerX - width / 2, baselineY);
}
public static void main(String[] args) {
JFrame f = new JFrame();
f.getContentPane().add(new HorizontallyCenteredText());
f.setSize(450, 350);
f.show();
}
}

</source>

== FontDemo lists the system fonts and provides a sample of each one(Have some problems) ==

<source lang="java">
/*
* Copyright (c) Ian F. Darwin, http://www.darwinsys.ru/, 1996-2002.
* All rights reserved. Software written by Ian F. Darwin and others.
* $Id: LICENSE,v 1.8 2004/02/09 03:33:38 ian Exp $
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS""
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*
* Java, the Duke mascot, and all variants of Sun"s Java "steaming coffee
* cup" logo are trademarks of Sun Microsystems. Sun"s, and James Gosling"s,
* pioneering role in inventing and promulgating (and standardizing) the Java
* language and environment is gratefully acknowledged.
*
* The pioneering role of Dennis Ritchie and Bjarne Stroustrup, of AT&T, for
* inventing predecessor languages C and C++ is also gratefully acknowledged.
*/
////
import java.awt.BorderLayout;
import java.awt.Container;
import java.awt.Font;
import java.awt.GraphicsEnvironment;
import java.awt.GridLayout;
import java.awt.Label;
import javax.swing.JFrame;
import javax.swing.JLabel;
import javax.swing.JPanel;
/** FontDemo lists the system fonts and provides a sample of each one */
public class FontDemoLabel extends JFrame {
String fl[];
JPanel p;
public FontDemoLabel() {
super("Font Demo - Label");
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
Container cp = getContentPane();
// get font name list
fl = GraphicsEnvironment.getLocalGraphicsEnvironment()
.getAvailableFontFamilyNames();
// IGNORE the setLayout and North/South stuff...
// we will discuss it in a few pages!
cp.setLayout(new BorderLayout());
cp.add(BorderLayout.NORTH, new Label("Number of Fonts = " + fl.length,
Label.CENTER));
cp.add(BorderLayout.CENTER, p = new JPanel());
p.setLayout(new GridLayout(5, 0, 5, 5));
for (int i = 0; i < fl.length; i++) {
JLabel lab;
// The crux of the matter: for each font name,
// create a label using the name as the text,
// AND set the font to be the named font!
p.add(lab = new JLabel(fl[i]));
lab.setFont(new Font(fl[i], Font.ITALIC | Font.BOLD, 14));
}
pack();
}
public static void main(String[] av) {
new FontDemoLabel().setVisible(true);
}
}

</source>

== Font Derivation ==

<source lang="java">
import java.awt.Font;
import java.awt.Graphics;
import java.awt.Graphics2D;
import java.awt.RenderingHints;
import java.awt.font.TextAttribute;
import java.awt.geom.AffineTransform;
import java.util.Hashtable;
import javax.swing.JFrame;
import javax.swing.JPanel;
public class FontDerivation extends JPanel {
public void paint(Graphics g) {
Graphics2D g2 = (Graphics2D) g;
g2.setRenderingHint(RenderingHints.KEY_ANTIALIASING,
RenderingHints.VALUE_ANTIALIAS_ON);
// Create a 1-point font.
Font font = new Font("Serif", Font.PLAIN, 1);
float x = 20, y = 20;
Font font24 = font.deriveFont(24.0f);
g2.setFont(font24);
g2.drawString("font.deriveFont(24.0f)", x, y += 30);
Font font24italic = font24.deriveFont(Font.ITALIC);
g2.setFont(font24italic);
g2.drawString("font24.deriveFont(Font.ITALIC)", x, y += 30);
AffineTransform at = new AffineTransform();
at.shear(.2, 0);
Font font24shear = font24.deriveFont(at);
g2.setFont(font24shear);
g2.drawString("font24.deriveFont(at)", x, y += 30);
Hashtable attributes = new Hashtable();
attributes.put(TextAttribute.WEIGHT, TextAttribute.WEIGHT_BOLD);
Font font24bold = font24.deriveFont(attributes);
g2.setFont(font24bold);
g2.drawString("font24.deriveFont(attributes)", x, y += 30);
}
public static void main(String[] args) {
JFrame f = new JFrame();
f.getContentPane().add(new FontDerivation());
f.setSize(350, 250);
f.show();
}
}

</source>

== Font List ==

<source lang="java">
/*
* Copyright (c) 2000 David Flanagan. All rights reserved.
* This code is from the book Java Examples in a Nutshell, 2nd Edition.
* It is provided AS-IS, WITHOUT ANY WARRANTY either expressed or implied.
* You may study, use, and modify it for any non-commercial purpose.
* You may distribute it non-commercially as long as you retain this notice.
* For a commercial use license, or to purchase the book (recommended),
* visit http://www.davidflanagan.ru/javaexamples2.
*/
import java.awt.Font;
import java.awt.Graphics;
import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;
import javax.swing.JFrame;
import javax.swing.JPanel;
/**
* An applet that displays the standard fonts and styles available in Java 1.1
*/
public class FontList extends JPanel {
// The available font families
String[] families = { "Serif", // "TimesRoman" in Java 1.0
"SansSerif", // "Helvetica" in Java 1.0
"Monospaced" }; // "Courier" in Java 1.0
// The available font styles and names for each one
int[] styles = { Font.PLAIN, Font.ITALIC, Font.BOLD,
Font.ITALIC + Font.BOLD };
String[] stylenames = { "Plain", "Italic", "Bold", "Bold Italic" };
// Draw the applet.
public void paint(Graphics g) {
for (int f = 0; f < families.length; f++) { // for each family
for (int s = 0; s < styles.length; s++) { // for each style
Font font = new Font(families[f], styles[s], 18); // create font
g.setFont(font); // set font
String name = families[f] + " " + stylenames[s]; // create name
g.drawString(name, 20, (f * 4 + s + 1) * 20); // display name
}
}
}
public static void main(String[] a) {
JFrame f = new JFrame();
f.addWindowListener(new WindowAdapter() {
public void windowClosing(WindowEvent e) {
System.exit(0);
}
});
f.setContentPane(new FontList());
f.setSize(300,300);
f.setVisible(true);
}
}

</source>

== Font paint ==

<source lang="java">
import java.awt.Font;
import java.awt.Graphics;
import java.awt.Graphics2D;
import java.awt.RenderingHints;
import java.awt.font.FontRenderContext;
import java.awt.font.GlyphVector;
import javax.swing.JFrame;
import javax.swing.JPanel;
public class SimpleFont extends JPanel{
public void paint(Graphics g) {
Graphics2D g2 = (Graphics2D)g;
g2.setRenderingHint(RenderingHints.KEY_ANTIALIASING,
RenderingHints.VALUE_ANTIALIAS_ON);

String s = "Java Source and Support";
Font font = new Font("Serif", Font.PLAIN, 24);
FontRenderContext frc = g2.getFontRenderContext();
GlyphVector gv = font.createGlyphVector(frc, s);
g2.drawGlyphVector(gv, 40, 60);
}
public static void main(String[] args) {
JFrame f = new JFrame();
f.getContentPane().add(new SimpleFont());
f.setSize(350, 250);
f.show();
}
}

</source>

== Load font from ttf file ==

<source lang="java">
/*
* @(#)DemoFonts.java 1.17 06/08/29
*
* Copyright (c) 2006 Sun Microsystems, Inc. All Rights Reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* -Redistribution of source code must retain the above copyright notice, this
* list of conditions and the following disclaimer.
*
* -Redistribution in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* Neither the name of Sun Microsystems, Inc. or the names of contributors may
* be used to endorse or promote products derived from this software without
* specific prior written permission.
*
* This software is provided "AS IS," without a warranty of any kind. ALL
* EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING
* ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
* OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN MIDROSYSTEMS, INC. ("SUN")
* AND ITS LICENSORS SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE
* AS A RESULT OF USING, MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS
* DERIVATIVES. IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR ANY LOST
* REVENUE, PROFIT OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL,
* INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY
* OF LIABILITY, ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE,
* EVEN IF SUN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
*
* You acknowledge that this software is not designed, licensed or intended
* for use in the design, construction, operation or maintenance of any
* nuclear facility.
*/
/*
* @(#)DemoFonts.java 1.17 06/08/29
*/
import java.awt.Font;
import java.io.InputStream;
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;
/**
* A cache of the dynamically loaded fonts found in the fonts directory.
*/
public class DemoFonts {
// Prepare a static "cache" mapping font names to Font objects.
private static String[] names = { "A.ttf" };
private static Map<String, Font> cache = new ConcurrentHashMap<String, Font>(names.length);
static {
for (String name : names) {
cache.put(name, getFont(name));
}
}
public static Font getFont(String name) {
Font font = null;
if (cache != null) {
if ((font = cache.get(name)) != null) {
return font;
}
}
String fName = "/fonts/" + name;
try {
InputStream is = DemoFonts.class.getResourceAsStream(fName);
font = Font.createFont(Font.TRUETYPE_FONT, is);
} catch (Exception ex) {
ex.printStackTrace();
System.err.println(fName + " not loaded. Using serif font.");
font = new Font("serif", Font.PLAIN, 24);
}
return font;
}
}

</source>

== Obtain FontMetrics of different fonts ==

<source lang="java">
import java.awt.Font;
import java.awt.FontMetrics;
import java.awt.Graphics;
import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;
import javax.swing.JFrame;
public class Main extends JFrame {
public Main() {
super("Demonstrating FontMetrics");
setSize(510, 210);
setVisible(true);
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
}
public void paint(Graphics g) {
g.setFont(new Font("SansSerif", Font.BOLD, 12));
FontMetrics fm = g.getFontMetrics();
g.drawString("Current font: " + g.getFont(), 10, 40);
g.drawString("Ascent: " + fm.getAscent(), 10, 55);
g.drawString("Descent: " + fm.getDescent(), 10, 70);
g.drawString("Height: " + fm.getHeight(), 10, 85);
g.drawString("Leading: " + fm.getLeading(), 10, 100);
Font font = new Font("Serif", Font.ITALIC, 14);
fm = g.getFontMetrics(font);
g.setFont(font);
g.drawString("Current font: " + font, 10, 130);
g.drawString("Ascent: " + fm.getAscent(), 10, 145);
g.drawString("Descent: " + fm.getDescent(), 10, 160);
g.drawString("Height: " + fm.getHeight(), 10, 175);
g.drawString("Leading: " + fm.getLeading(), 10, 190);
}
public static void main(String args[]) {
Main app = new Main();
}
}

</source>

== Outline Font paint ==

<source lang="java">
import java.awt.BorderLayout;
import java.awt.Color;
import java.awt.Dimension;
import java.awt.Font;
import java.awt.Graphics;
import java.awt.Graphics2D;
import java.awt.Rectangle;
import java.awt.RenderingHints;
import java.awt.Shape;
import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;
import java.awt.font.FontRenderContext;
import java.awt.font.TextLayout;
import java.awt.geom.AffineTransform;
import java.net.URL;
import javax.swing.JApplet;
import javax.swing.JFrame;
import javax.swing.JPanel;
public class FontPaint extends JApplet {
public void init() {
FontPanel fontPanel = new FontPanel();
getContentPane().add(fontPanel, BorderLayout.CENTER);
}
public static void main(String[] args) {
FontPanel starPanel = new FontPanel();
JFrame f = new JFrame("Font");
f.addWindowListener(new WindowAdapter() {
public void windowClosing(WindowEvent e) {
System.exit(0);
}
});
f.getContentPane().add(starPanel, BorderLayout.CENTER);
f.setSize(new Dimension(550, 200));
f.setVisible(true);
}
}
class FontPanel extends JPanel {
public void paintComponent(Graphics g) {
super.paintComponent(g);
setBackground(Color.white);
int width = getSize().width;
int height = getSize().height;
Graphics2D g2 = (Graphics2D) g;
g2.setRenderingHint(RenderingHints.KEY_ANTIALIASING,
RenderingHints.VALUE_ANTIALIAS_ON);
g2.setRenderingHint(RenderingHints.KEY_RENDERING,
RenderingHints.VALUE_RENDER_QUALITY);
FontRenderContext frc = g2.getFontRenderContext();
Font f = new Font("Helvetica", 1, 60);
String s = new String("Java Source and Support.");
TextLayout textTl = new TextLayout(s, f, frc);
AffineTransform transform = new AffineTransform();
Shape outline = textTl.getOutline(null);
Rectangle outlineBounds = outline.getBounds();
transform = g2.getTransform();
transform.translate(width / 2 - (outlineBounds.width / 2), height / 2
+ (outlineBounds.height / 2));
g2.transform(transform);
g2.setColor(Color.blue);
g2.draw(outline);
g2.setClip(outline);
}
}

</source>

== Wrap string according to FontMetrics ==

<source lang="java">
import java.awt.FontMetrics;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Iterator;
import java.util.List;
/**
* Globally available utility classes, mostly for string manipulation.
*
* @author Jim Menard,
*/
public class StringUtils {
/**
* Returns an array of strings, one for each line in the string after it has
* been wrapped to fit lines of <var>maxWidth</var>. Lines end with any of
* cr, lf, or cr lf. A line ending at the end of the string will not output a
* further, empty string.
* <p>
* This code assumes <var>str</var> is not <code>null</code>.
*
* @param str
* the string to split
* @param fm
* needed for string width calculations
* @param maxWidth
* the max line width, in points
* @return a non-empty list of strings
*/
public static List wrap(String str, FontMetrics fm, int maxWidth) {
List lines = splitIntoLines(str);
if (lines.size() == 0)
return lines;
ArrayList strings = new ArrayList();
for (Iterator iter = lines.iterator(); iter.hasNext();)
wrapLineInto((String) iter.next(), strings, fm, maxWidth);
return strings;
}
/**
* Given a line of text and font metrics information, wrap the line and add
* the new line(s) to <var>list</var>.
*
* @param line
* a line of text
* @param list
* an output list of strings
* @param fm
* font metrics
* @param maxWidth
* maximum width of the line(s)
*/
public static void wrapLineInto(String line, List list, FontMetrics fm, int maxWidth) {
int len = line.length();
int width;
while (len > 0 && (width = fm.stringWidth(line)) > maxWidth) {
// Guess where to split the line. Look for the next space before
// or after the guess.
int guess = len * maxWidth / width;
String before = line.substring(0, guess).trim();
width = fm.stringWidth(before);
int pos;
if (width > maxWidth) // Too long
pos = findBreakBefore(line, guess);
else { // Too short or possibly just right
pos = findBreakAfter(line, guess);
if (pos != -1) { // Make sure this doesn"t make us too long
before = line.substring(0, pos).trim();
if (fm.stringWidth(before) > maxWidth)
pos = findBreakBefore(line, guess);
}
}
if (pos == -1)
pos = guess; // Split in the middle of the word
list.add(line.substring(0, pos).trim());
line = line.substring(pos).trim();
len = line.length();
}
if (len > 0)
list.add(line);
}
/**
* Returns the index of the first whitespace character or "-" in <var>line</var>
* that is at or before <var>start</var>. Returns -1 if no such character is
* found.
*
* @param line
* a string
* @param start
* where to star looking
*/
public static int findBreakBefore(String line, int start) {
for (int i = start; i >= 0; --i) {
char c = line.charAt(i);
if (Character.isWhitespace(c) || c == "-")
return i;
}
return -1;
}
/**
* Returns the index of the first whitespace character or "-" in <var>line</var>
* that is at or after <var>start</var>. Returns -1 if no such character is
* found.
*
* @param line
* a string
* @param start
* where to star looking
*/
public static int findBreakAfter(String line, int start) {
int len = line.length();
for (int i = start; i < len; ++i) {
char c = line.charAt(i);
if (Character.isWhitespace(c) || c == "-")
return i;
}
return -1;
}
/**
* Returns an array of strings, one for each line in the string. Lines end
* with any of cr, lf, or cr lf. A line ending at the end of the string will
* not output a further, empty string.
* <p>
* This code assumes <var>str</var> is not <code>null</code>.
*
* @param str
* the string to split
* @return a non-empty list of strings
*/
public static List splitIntoLines(String str) {
ArrayList strings = new ArrayList();
int len = str.length();
if (len == 0) {
strings.add("");
return strings;
}
int lineStart = 0;
for (int i = 0; i < len; ++i) {
char c = str.charAt(i);
if (c == "\r") {
int newlineLength = 1;
if ((i + 1) < len && str.charAt(i + 1) == "\n")
newlineLength = 2;
strings.add(str.substring(lineStart, i));
lineStart = i + newlineLength;
if (newlineLength == 2) // skip \n next time through loop
++i;
} else if (c == "\n") {
strings.add(str.substring(lineStart, i));
lineStart = i + 1;
}
}
if (lineStart < len)
strings.add(str.substring(lineStart));
return strings;
}
}

</source>

Java/2D Graphics GUI

2010-06-01T14:32:33Z

Admin:

* [[Java/2D Graphics GUI/Animation | Animation]]
* [[Java/2D Graphics GUI/AntiAliasing | AntiAliasing]]
* [[Java/2D Graphics GUI/Arc | Arc]]
* [[Java/2D Graphics GUI/Area Calculation | Area Calculation]]
* [[Java/2D Graphics GUI/BMP | BMP]]
* [[Java/2D Graphics GUI/Buffer Paint | Buffer Paint]]
* [[Java/2D Graphics GUI/BufferedImage | BufferedImage]]
* [[Java/2D Graphics GUI/Chart | Chart]]
* [[Java/2D Graphics GUI/Clip | Clip]]
* [[Java/2D Graphics GUI/Color | Color]]
* [[Java/2D Graphics GUI/Color Model | Color Model]]
* [[Java/2D Graphics GUI/Composite | Composite]]
* [[Java/2D Graphics GUI/Curve | Curve]]
* [[Java/2D Graphics GUI/FilteredImageSource | FilteredImageSource]]
* [[Java/2D Graphics GUI/Font | Font]]
* [[Java/2D Graphics GUI/Full Screen | Full Screen]]
* [[Java/2D Graphics GUI/GIF | GIF]]
* [[Java/2D Graphics GUI/Geometry | Geometry]]
* [[Java/2D Graphics GUI/Gradient Paint | Gradient Paint]]
* [[Java/2D Graphics GUI/Graphic Environment | Graphic Environment]]
* [[Java/2D Graphics GUI/Icon | Icon]]
* [[Java/2D Graphics GUI/Image | Image]]
* [[Java/2D Graphics GUI/Image Filter | Image Filter]]
* [[Java/2D Graphics GUI/Image IO | Image IO]]
* [[Java/2D Graphics GUI/ImageReader | ImageReader]]
* [[Java/2D Graphics GUI/ImageWriter | ImageWriter]]
* [[Java/2D Graphics GUI/JAI | JAI]]
* [[Java/2D Graphics GUI/JMF | JMF]]
* [[Java/2D Graphics GUI/JPEG | JPEG]]
* [[Java/2D Graphics GUI/Line | Line]]
* [[Java/2D Graphics GUI/Matrix | Matrix]]
* [[Java/2D Graphics GUI/Media | Media]]
* [[Java/2D Graphics GUI/MemoryImageSource | MemoryImageSource]]
* [[Java/2D Graphics GUI/PDF PostScript | PDF PostScript]]
* [[Java/2D Graphics GUI/PNG File | PNG File]]
* [[Java/2D Graphics GUI/Paint | Paint]]
* [[Java/2D Graphics GUI/Path | Path]]
* [[Java/2D Graphics GUI/Print | Print]]
* [[Java/2D Graphics GUI/Print Job | Print Job]]
* [[Java/2D Graphics GUI/Print Service | Print Service]]
* [[Java/2D Graphics GUI/Psd | Psd]]
* [[Java/2D Graphics GUI/RGBImageFilter | RGBImageFilter]]
* [[Java/2D Graphics GUI/Screen Capture | Screen Capture]]
* [[Java/2D Graphics GUI/Shape | Shape]]
* [[Java/2D Graphics GUI/Stroke | Stroke]]
* [[Java/2D Graphics GUI/Text | Text]]
* [[Java/2D Graphics GUI/Text Layout | Text Layout]]
* [[Java/2D Graphics GUI/TextAttribute | TextAttribute]]
* [[Java/2D Graphics GUI/Texture | Texture]]
* [[Java/2D Graphics GUI/Transform | Transform]]
* [[Java/2D Graphics GUI/Transparent | Transparent]]
* [[Java/2D Graphics GUI/XOR | XOR]]

MediaWiki:Sidebar

2010-06-01T10:35:42Z

Java/Swing Components/Font Chooser

2010-06-01T07:45:39Z

== A dialog allow selection and a font and its associated info. ==



<source lang="java">

/*
* Copyright (C) 2001-2004 Colin Bell
* colbell@users.sourceforge.net
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
import java.awt.BorderLayout;
import java.awt.Dialog;
import java.awt.Dimension;
import java.awt.Font;
import java.awt.Frame;
import java.awt.GraphicsEnvironment;
import java.awt.GridBagConstraints;
import java.awt.GridBagLayout;
import java.awt.Insets;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.io.Serializable;
import javax.swing.BorderFactory;
import javax.swing.JButton;
import javax.swing.JCheckBox;
import javax.swing.JComboBox;
import javax.swing.JDialog;
import javax.swing.JLabel;
import javax.swing.JPanel;
/**
* A dialog allow selection and a font and its associated info.
*
* @author
*/
public class FontChooser extends JDialog
{
private final boolean _selectStyles;
private JComboBox _fontNamesCmb;
private final JComboBox _fontSizesCmb = new JComboBox(new String[]
{ "8", "9", "10", "12", "14" });
private final JCheckBox _boldChk = new JCheckBox("Bold");
private final JCheckBox _italicChk = new JCheckBox("Italic");
private final JLabel _previewLbl = new JLabel("PreviewText");
private Font _font;
private ActionListener _previewUpdater;
/**
* Default ctor.
*/
public FontChooser()
{
this((Frame)null);
}
/**
* ctor specifying whether styles can be selected.
*
* @param selectStyles If <TT>true</TT> bold and italic checkboxes displayed.
*/
public FontChooser(boolean selectStyles)
{
this((Frame)null, selectStyles);
}
/**
* ctor specifying the parent frame.
*
* @param owner Parent frame.
*/
public FontChooser(Frame owner)
{
super(owner, "Font Chooser", true);
_selectStyles = true;
createUserInterface();
}
/**
* ctor specifying the parent frame and whether styles can be selected.
*
* @param owner Parent frame.
* @param selectStyles If <TT>true</TT> bold and italic checkboxes displayed.
*/
public FontChooser(Frame owner, boolean selectStyles)
{
super(owner, "Font Chooser", true);
_selectStyles = selectStyles;
createUserInterface();
}
/**
* ctor specifying the parent dialog.
*
* @param owner Parent frame.
*/
public FontChooser(Dialog owner)
{
super(owner, "Font Chooser", true);
_selectStyles = true;
createUserInterface();
}
/**
* ctor specifying the parent dialog and whether styles can be selected.
*
* @param owner Parent frame.
* @param selectStyles If <TT>true</TT> bold and italic checkboxes displayed.
*/
public FontChooser(Dialog owner, boolean selectStyles)
{
super(owner, "Font Chooser", true);
_selectStyles = selectStyles;
createUserInterface();
}
/**
* Component is being added to its parent.
*/
public void addNotify()
{
super.addNotify();
if (_previewUpdater == null)
{
_previewUpdater = new PreviewLabelUpdater();
_fontNamesCmb.addActionListener(_previewUpdater);
_fontSizesCmb.addActionListener(_previewUpdater);
_boldChk.addActionListener(_previewUpdater);
_italicChk.addActionListener(_previewUpdater);
}
}
/**
* Component is being removed from its parent.
*/
public void removeNotify()
{
super.removeNotify();
if (_previewUpdater != null)
{
_fontNamesCmb.removeActionListener(_previewUpdater);
_fontSizesCmb.removeActionListener(_previewUpdater);
_boldChk.removeActionListener(_previewUpdater);
_italicChk.removeActionListener(_previewUpdater);
_previewUpdater = null;
}
}
public Font showDialog()
{
return showDialog(null);
}
/**
* Show dialog defaulting to the passed font.
*
* @param font The font to default to.
*/
public Font showDialog(Font font)
{
if (font != null)
{
_fontNamesCmb.setSelectedItem(font.getName());
_fontSizesCmb.setSelectedItem("" + font.getSize());
_boldChk.setSelected(_selectStyles && font.isBold());
_italicChk.setSelected(_selectStyles && font.isItalic());
}
else
{
_fontNamesCmb.setSelectedIndex(0);
_fontSizesCmb.setSelectedIndex(0);
_boldChk.setSelected(false);
_italicChk.setSelected(false);
}
setupPreviewLabel();
setVisible(true);
return _font;
}
public Font getSelectedFont()
{
return _font;
}
protected void setupFontFromDialog()
{
int size = 12;
try
{
size = Integer.parseInt((String)_fontSizesCmb.getSelectedItem());
}
catch (Exception ignore)
{
// Ignore.
}
FontInfo fi = new FontInfo();
fi.setFamily((String)_fontNamesCmb.getSelectedItem());
fi.setSize(size);
fi.setIsBold(_boldChk.isSelected());
fi.setIsItalic(_italicChk.isSelected());
_font = fi.createFont();
}
private void createUserInterface()
{
final JPanel content = new JPanel(new GridBagLayout());
final GridBagConstraints gbc = new GridBagConstraints();
setContentPane(content);
content.setBorder(BorderFactory.createEmptyBorder(5, 5, 5, 5));
gbc.anchor = GridBagConstraints.WEST;
gbc.insets = new Insets(2, 2, 2, 2);
gbc.fill = GridBagConstraints.HORIZONTAL;
gbc.gridx = gbc.gridy = 0;
content.add(new JLabel("Font"), gbc);
++gbc.gridx;
content.add(new JLabel("Size"), gbc);
if (_selectStyles)
{
++gbc.gridx;
content.add(new JLabel("Style"), gbc);
}
++gbc.gridy;
gbc.gridx = 0;
_fontNamesCmb = new JComboBox(GraphicsEnvironment.getLocalGraphicsEnvironment().getAvailableFontFamilyNames());
content.add(_fontNamesCmb, gbc);
++gbc.gridx;
_fontSizesCmb.setEditable(true);
content.add(_fontSizesCmb, gbc);
if (_selectStyles)
{
++gbc.gridx;
content.add(_boldChk, gbc);
++gbc.gridy;
content.add(_italicChk, gbc);
}
gbc.gridx = 0;
++gbc.gridy;
gbc.gridwidth = GridBagConstraints.REMAINDER;
gbc.fill = GridBagConstraints.BOTH;
gbc.anchor = GridBagConstraints.CENTER;
content.add(createPreviewPanel(), gbc);
++gbc.gridy;
gbc.fill = GridBagConstraints.HORIZONTAL;
content.add(createButtonsPanel(), gbc);
pack();
setResizable(true);
}
private JPanel createPreviewPanel()
{
final JPanel pnl = new JPanel(new BorderLayout());
pnl.setBorder(BorderFactory.createTitledBorder("PreviewTitle"));
Dimension prefSize = _previewLbl.getPreferredSize();
prefSize.height = 50;
_previewLbl.setPreferredSize(prefSize);
pnl.add(_previewLbl, BorderLayout.CENTER);
setupPreviewLabel();
return pnl;
}
private JPanel createButtonsPanel()
{
JPanel pnl = new JPanel();
JButton okBtn = new JButton("OK");
okBtn.addActionListener(new ActionListener()
{
public void actionPerformed(ActionEvent evt)
{
setupFontFromDialog();
dispose();
}
});
JButton cancelBtn = new JButton("Cancel");
cancelBtn.addActionListener(new ActionListener()
{
public void actionPerformed(ActionEvent evt)
{
FontChooser.this._font = null;
dispose();
}
});
pnl.add(okBtn);
pnl.add(cancelBtn);
getRootPane().setDefaultButton(okBtn);
return pnl;
}
private void setupPreviewLabel()
{
setupFontFromDialog();
_previewLbl.setFont(_font);
}
private final class PreviewLabelUpdater implements ActionListener
{
public void actionPerformed(ActionEvent evt)
{
setupPreviewLabel();
}
}
}

/*
* Copyright (C) 2001-2003 Colin Bell
* colbell@users.sourceforge.net
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
class FontInfo implements Cloneable, Serializable
{
private static final long serialVersionUID = 1L;
public interface IPropertyNames
{
String FAMILY = "family";
String IS_BOLD = "isBold";
String IS_ITALIC = "isItalic";
String SIZE = "size";
}
private static String DEFAULT_FAMILY = "Monospaced";
private String _familyName;
private boolean _isBold;
private boolean _isItalic;
private int _size;
public FontInfo()
{
super();
setFamily(DEFAULT_FAMILY);
setSize(12);
}
public FontInfo(Font font)
{
super();
if (font == null)
{
throw new IllegalArgumentException("Null Font passed");
}
setFont(font);
}
/**
* Return a copy of this object.
*/
public Object clone()
{
try
{
return super.clone();
}
catch (CloneNotSupportedException ex)
{
throw new InternalError(ex.getMessage()); // Impossible.
}
}
public String getFamily()
{
return _familyName;
}
public void setFamily(String value)
{
_familyName = value != null ? value : DEFAULT_FAMILY;
}
public boolean isBold()
{
return _isBold;
}
public void setIsBold(boolean value)
{
_isBold = value;
}
public boolean isItalic()
{
return _isItalic;
}
public void setIsItalic(boolean value)
{
_isItalic = value;
}
public int getSize()
{
return _size;
}
public void setSize(int value)
{
_size = value;
}
public void setFont(Font font) throws IllegalArgumentException
{
if (font == null)
{
throw new IllegalArgumentException("Null Font passed");
}
_familyName = font.getFamily();
_isBold = font.isBold();
_isItalic = font.isItalic();
_size = font.getSize();
}
public boolean doesFontMatch(Font font)
{
if (font == null)
{
return false;
}
return font.getFamily().equals(_familyName)
&& font.getSize() == getSize()
&& font.getStyle() == generateStyle();
}
public int generateStyle()
{
int style = 0;
if (!_isBold && !_isItalic)
{
style = Font.PLAIN;
}
else
{
if (_isBold)
{
style |= Font.BOLD;
}
if (_isItalic)
{
style |= Font.ITALIC;
}
}
return style;
}
public Font createFont()
{
return new Font(_familyName, generateStyle(), _size);
}
// i18n ? What is this used for?
public String toString()
{
StringBuffer buf = new StringBuffer();
buf.append(_familyName).append(", " + _size);
if (_isBold)
{
buf.append(", bold");
}
if (_isItalic)
{
buf.append(", italic");
}
return buf.toString();
}
/**
* @see java.lang.Object#hashCode()
*/
@Override
public int hashCode() {
final int PRIME = 31;
int result = 1;
result = PRIME * result + ((_familyName == null) ? 0 : _familyName.hashCode());
result = PRIME * result + (_isBold ? 1231 : 1237);
result = PRIME * result + (_isItalic ? 1231 : 1237);
result = PRIME * result + _size;
return result;
}
/**
* @see java.lang.Object#equals(java.lang.Object)
*/
@Override
public boolean equals(Object obj) {
if (this == obj)
return true;
if (obj == null)
return false;
if (getClass() != obj.getClass())
return false;
final FontInfo other = (FontInfo) obj;
if (_familyName == null) {
if (other._familyName != null)
return false;
} else if (!_familyName.equals(other._familyName))
return false;
if (_isBold != other._isBold)
return false;
if (_isItalic != other._isItalic)
return false;
if (_size != other._size)
return false;
return true;
}
}

</source>



== FontChooser, adapted from NwFontChooserS by Noah Wairauch ==



<source lang="java">

/*BEGIN_COPYRIGHT_BLOCK
*
* Copyright (c) 2001-2008, JavaPLT group at Rice University (drjava@rice.edu)
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
* * Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
* * Neither the names of DrJava, the JavaPLT group, Rice University, nor the
* names of its contributors may be used to endorse or promote products
* derived from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
* PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
* LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
* This software is Open Source Initiative approved Open Source Software.
* Open Source Initative Approved is a trademark of the Open Source Initiative.
*
* This file is part of DrJava. Download the current version of this project
* from http://www.drjava.org/ or http://sourceforge.net/projects/drjava/
*
* END_COPYRIGHT_BLOCK*/

import javax.swing.*;
import javax.swing.event.ListSelectionEvent;
import javax.swing.event.ListSelectionListener;
import java.awt.*;
import java.awt.event.*;
/**
* FontChooser, adapted from NwFontChooserS by Noah Wairauch.
* (see http:///forum.java.sun.ru/thread.jsp?forum=57&thread=195067)
*
* @version $Id: FontChooser.java 4872 2009-04-06 21:37:28Z mgricken $
*/
public class FontChooser extends JDialog {
/** Available font styles.
*/
private static final String[] STYLES =
new String[] { "Plain", "Bold", "Italic", "Bold Italic" };
/** Available font sizes.
*/
private static final String[] SIZES =
new String[] { "3", "4", "5", "6", "7", "8", "9", "10", "11", "12",
"13", "14", "15", "16", "17", "18", "19", "20", "22",
"24", "27", "30", "34", "39", "45", "51", "60"};
// Lists to display
private NwList _styleList;
private NwList _fontList;
private NwList _sizeList;
// Swing elements
private JButton _okButton;
private JButton _cancelButton;
private JLabel _sampleText = new JLabel();
private boolean _clickedOK = false;
/** Constructs a new modal FontChooser for the given frame,
* using the specified font.
*/
private FontChooser(Frame parent, Font font) {
super(parent, true);
initAll();
if (font == null) font = _sampleText.getFont();
_fontList.setSelectedItem(font.getName());
_sizeList.setSelectedItem(font.getSize() + "");
_styleList.setSelectedItem(STYLES[font.getStyle()]);
//this.setResizable(false);
resize();
}
/** Method used to show the font chooser, and select a new font.
*
* @param parent The parent frame.
* @param title The title for this window.
* @param font The previously chosen font.
* @return the newly chosen font.
*/
public static Font showDialog(Frame parent, String title, Font font) {
FontChooser fd = new FontChooser(parent, font);
fd.setTitle(title);

fd.setVisible(true);
Font chosenFont = null;
if (fd.clickedOK()) {
chosenFont = fd.getFont();
}
fd.dispose();
return (chosenFont);
}
/** Shows the font chooser with a standard title ("Font Chooser").
*/
public static Font showDialog(Frame parent, Font font) {
return showDialog(parent, "Font Chooser", font);
}
private void initAll() {
getContentPane().setLayout(null);
setBounds(50, 50, 425, 400);
_sampleText = new JLabel();
addLists();
addButtons();
_sampleText.setForeground(Color.black);
getContentPane().add(_sampleText);
addWindowListener(new WindowAdapter() {
public void windowClosing(java.awt.event.WindowEvent e) {
setVisible(false);
}
});
addComponentListener(new ComponentAdapter() {
public void componentResized(ComponentEvent evt) {
resize();
}
});
}
private void resize() {
int w = getWidth();
int h = getHeight();
double wf = (double) w / 425;
int w2 = (int) (80 * wf);
int w3 = (int) (50 * wf);
if (w3 < 30) w3 = 30;
int w1 = w - w2 - w3 - 25;
_fontList.setBounds(5, 5, w1, h - 91);
_styleList.setBounds(w1 + 10, 5, w2, h - 91);
_sizeList.setBounds(w1 + w2 + 15, 5, w3, h - 91);
_sampleText.setBounds(10, h - 78, w - 20, 45);
_okButton.setBounds(w - 165, h - 55, 70, 20);
_cancelButton.setBounds(w - 81, h - 55, 70, 20);
validate();
}
private void addLists() {
_fontList = new NwList(GraphicsEnvironment.getLocalGraphicsEnvironment().getAvailableFontFamilyNames());
_styleList = new NwList(STYLES);
_sizeList = new NwList(SIZES);
getContentPane().add(_fontList);
getContentPane().add(_styleList);
getContentPane().add(_sizeList);
}
private void addButtons() {
_okButton = new JButton("OK");
_okButton.setMargin(new Insets(0, 0, 0, 0));
_cancelButton = new JButton("Cancel");
_cancelButton.setMargin(new Insets(0, 0, 0, 0));
_okButton.setFont(new Font(" ", 1, 11));
_cancelButton.setFont(new Font(" ", 1, 12));
getContentPane().add(_okButton);
getContentPane().add(_cancelButton);
_okButton.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
setVisible(false);
_clickedOK = true;
}
});
_cancelButton.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
setVisible(false);
_clickedOK = false;
}
});
}
private void showSample() {
int g = 0;
try { g = Integer.parseInt(_sizeList.getSelectedValue()); }
catch (NumberFormatException nfe) { /* do nothing */ }
String st = _styleList.getSelectedValue();
int s = Font.PLAIN;
if (st.equalsIgnoreCase("Bold")) s = Font.BOLD;
if (st.equalsIgnoreCase("Italic")) s = Font.ITALIC;
if (st.equalsIgnoreCase("Bold Italic")) s = Font.BOLD | Font.ITALIC;
_sampleText.setFont(new Font(_fontList.getSelectedValue(), s, g));
_sampleText.setText("The quick brown fox jumped over the lazy dog.");
_sampleText.setVerticalAlignment(SwingConstants.TOP);
}
/** Returns whether the user clicked OK when the dialog was closed. (If false, the user clicked cancel.) */
public boolean clickedOK() { return _clickedOK; }
/** Returns the currently selected Font. */
public Font getFont() { return _sampleText.getFont(); }
/** Private inner class for a list which displays a list of options in addition to a label indicating the currently
* selected item.
*/
public class NwList extends JPanel {
JList jl;
JScrollPane sp;
JLabel jt;
String si = " ";
public NwList(String[] values) {
setLayout(null);
jl = new JList(values);
sp = new JScrollPane(jl);
jt = new JLabel();
jt.setBackground(Color.white);
jt.setForeground(Color.black);
jt.setOpaque(true);
jt.setBorder(new JTextField().getBorder());
jt.setFont(getFont());
jl.addListSelectionListener(new ListSelectionListener() {
public void valueChanged(ListSelectionEvent e) {
jt.setText((String) jl.getSelectedValue());
si = (String) jl.getSelectedValue();
showSample();
}
});
add(sp);
add(jt);
}
public void setBounds(int x, int y, int w, int h) {
super.setBounds(x, y, w, h);
sp.setBounds(0, y + 16, w, h - 23);
sp.revalidate();
jt.setBounds(0, 0, w, 20);
}
public String getSelectedValue() { return (si); }
public void setSelectedItem(String s) { jl.setSelectedValue(s, true);}
}
}

</source>



== FontChooser by Noah w ==



<source lang="java">

/* This code was found posted on a forum without any copyright
* restrictions. It was written by someone named Noah W.
* That"s all I know */
/* I have modified the original code but claim no copyright on it of any kind */

/*
This file is part of BORG.
BORG is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
BORG is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with BORG; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Copyright 2003 by Mike Berger
*/

import java.awt.Color;
import java.awt.Font;
import java.awt.Frame;
import java.awt.GraphicsEnvironment;
import java.awt.Insets;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;
import java.util.Enumeration;
import javax.swing.JButton;
import javax.swing.JDialog;
import javax.swing.JLabel;
import javax.swing.JList;
import javax.swing.JPanel;
import javax.swing.JScrollPane;
import javax.swing.JTextField;
import javax.swing.UIManager;
import javax.swing.event.ListSelectionEvent;
import javax.swing.event.ListSelectionListener;
import javax.swing.plaf.FontUIResource;

//
// FontChooser by Noah w.
//
public class NwFontChooserS extends JDialog {
String[] styleList = new String[] { "Plain", "Bold", "Italic" };
String[] sizeList =
new String[] {
"3",
"4",
"5",
"6",
"7",
"8",
"9",
"10",
"11",
"12",
"13",
"14",
"15",
"16",
"17",
"18",
"19",
"20",
"22",
"24",
"27",
"30",
"34",
"39",
"45",
"51",
"60" };
NwList StyleList;
NwList FontList;
NwList SizeList;
static JLabel Sample = new JLabel();
boolean ob = false;

private NwFontChooserS(Frame parent, boolean modal, Font font) {
super(parent, modal);
initAll();
setTitle("Font Choosr");
if (font == null)
font = Sample.getFont();
FontList.setSelectedItem(font.getName());
SizeList.setSelectedItem(font.getSize() + "");
StyleList.setSelectedItem(styleList[font.getStyle()]);

}
public static Font showDialog(Frame parent, String s, Font font) {
NwFontChooserS fd = new NwFontChooserS(parent, true, font);
if (s != null)
fd.setTitle(s);
fd.setVisible(true);
Font fo = null;
if (fd.ob)
fo = Sample.getFont();
fd.dispose();
return (fo);
}
private void initAll() {
getContentPane().setLayout(null);
setBounds(50, 50, 450, 450);
addLists();
addButtons();
Sample.setBounds(10, 320, 415, 25);
Sample.setForeground(Color.black);
getContentPane().add(Sample);
addWindowListener(new WindowAdapter() {
public void windowClosing(WindowEvent e) {
setVisible(false);
}
});
}
private void addLists() {
FontList =
new NwList(
GraphicsEnvironment
.getLocalGraphicsEnvironment()
.getAvailableFontFamilyNames());
StyleList = new NwList(styleList);
SizeList = new NwList(sizeList);
FontList.setBounds(10, 10, 260, 295);
StyleList.setBounds(280, 10, 80, 295);
SizeList.setBounds(370, 10, 40, 295);
getContentPane().add(FontList);
getContentPane().add(StyleList);
getContentPane().add(SizeList);
}
private void addButtons() {
JButton ok = new JButton("OK");
ok.setMargin(new Insets(0, 0, 0, 0));
JButton ca = new JButton("Cancel");
ca.setMargin(new Insets(0, 0, 0, 0));
ok.setBounds(260, 350, 70, 20);
ok.setFont(new Font(" ", 1, 11));
ca.setBounds(340, 350, 70, 20);
ca.setFont(new Font(" ", 1, 12));
getContentPane().add(ok);
getContentPane().add(ca);
ok.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
setVisible(false);
ob = true;
}
});
ca.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
setVisible(false);
ob = false;
}
});
}
private void showSample() {
int g = 0;
try {
g = Integer.parseInt(SizeList.getSelectedValue());
}
catch (NumberFormatException nfe) {
}
String st = StyleList.getSelectedValue();
int s = Font.PLAIN;
if (st.equalsIgnoreCase("Bold"))
s = Font.BOLD;
if (st.equalsIgnoreCase("Italic"))
s = Font.ITALIC;
Sample.setFont(new Font(FontList.getSelectedValue(), s, g));
Sample.setText("The quick brown fox jumped over the lazy dog.");
}
//////////////////////////////////////////////////////////////////////
private class NwList extends JPanel {
JList jl;
JScrollPane sp;
JLabel jt;
String si = " ";

public NwList(String[] values) {
setLayout(null);
jl = new JList(values);
sp = new JScrollPane(jl);
jt = new JLabel();
jt.setBackground(Color.white);
jt.setForeground(Color.black);
jt.setOpaque(true);
jt.setBorder(new JTextField().getBorder());
jt.setFont(getFont());
jl.setBounds(0, 0, 100, 1000);
jl.setBackground(Color.white);
jl.addListSelectionListener(new ListSelectionListener() {
public void valueChanged(ListSelectionEvent e) {
jt.setText((String) jl.getSelectedValue());
si = (String) jl.getSelectedValue();
showSample();
}
});
add(sp);
add(jt);
}
public String getSelectedValue() {
return (si);
}
public void setSelectedItem(String s) {
jl.setSelectedValue(s, true);
}
public void setBounds(int x, int y, int w, int h) {
super.setBounds(x, y, w, h);
sp.setBounds(0, y + 12, w, h - 23);
sp.revalidate();
jt.setBounds(0, 0, w, 20);
}
}

static public String fontString(Font font) {
String fs = font.getFamily();
if( !font.isPlain() ) {
fs += "-";
if( font.isBold()) {
fs += "BOLD";
}
if( font.isItalic()) {
fs += "ITALIC";
}
}
fs += "-" + font.getSize();
return(fs);
}

static public void setDefaultFont(Font f ) {
FontUIResource fui = new FontUIResource(f);
Enumeration<Object> keys = UIManager.getDefaults().keys();
while (keys.hasMoreElements()) {
Object key = keys.nextElement();
Object value = UIManager.get(key);
if (value instanceof FontUIResource)
UIManager.put(key, fui);
}

}

public static void main(String args[]) {
Font font = null;
font = NwFontChooserS.showDialog(null, null, null);

System.out.println(fontString(font));
}
}

</source>



== Font Chooser extends javax.swing.JDialog ==



<source lang="java">

/*
Atlantida is an open source (GPL) multilingual dictionary written in Java.
It can translate words from one language to another and pronounce them.
Copyright (C) 2006 Sergey S. http://atla.revdanica.ru/
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/**
* FontChooser
* @author Janos Szatmary, Sergei S.
* @version 003
*/
/*
* http://forum.java.sun.ru/thread.jsp?forum=57&thread=124810
* For those who asked where"s the constructor, have in mind that the constructor provided
* is private. As the author of the code says, the use of this class is as
* follows (supposing we are in a Frame class):
* FontChooser.showDialog(this,"FontChooser",new Font("Dialog", 0, 12));
* This file originally writter by Janos Szatmary, then modifyed by Sergei S. for
* Atlantida Multilingual Dictionary http://atla.sf.net
*/

import java.awt.*;
import java.awt.event.*;
import java.util.*;
import javax.swing.*;

public class FontChooser extends javax.swing.JDialog
{
String[] styleList = new String[]
{ "Plain","Bold","Italic"};
String[] sizeList = new String[]
{ "2","4","6","8","10","12","14","16","18","20","22","24","30","36","48","72"};
String currentFont = null;
int currentStyle = -1;
int currentSize = -1;
public boolean ok = false;
/* ------------------------------------------------------------- */
private FontChooser(java.awt.Frame parent,boolean modal)
{
super (parent,modal);
initComponents();
setListValues(jFontList,GraphicsEnvironment.getLocalGraphicsEnvironment().getAvailableFontFamilyNames());
setListValues(jStyleList,styleList);
setListValues(jSizeList,sizeList);
setCurrentFont(jSample.getFont());
pack();
}
private FontChooser(java.awt.Frame parent,boolean modal,Font font)
{
this(parent,modal);
setCurrentFont(font);
}
/* ------------------------------------------------------------- */
private void setListValues(JList list,String[] values)
{
if(list.getModel() instanceof DefaultListModel)
{
DefaultListModel model = (DefaultListModel)
list.getModel();
model.removeAllElements();
for( String value : values )
{
model.addElement( value );
}
}
}
/* ------------------------------------------------------------- */
private void setSampleFont()
{
if(currentFont != null && currentStyle >= 0 && currentSize > 0)
{
jSample.setFont(new Font
(currentFont,currentStyle,currentSize));
}
}
private String styleToString(int style)
{
String str = "";
if((style&Font.BOLD) == Font.BOLD)
{
if(str.length() > 0)
{
str += ",";
}
str += "Bold";
}
if((style&Font.ITALIC) == Font.ITALIC)
{
if(str.length() > 0)
{
str += ",";
}
str += "Italic";
}
if( str.length() <= 0 )
{
str = "Plain";
}
return str;
}
/* ------------------------------------------------------------- */
public Font getCurrentFont()
{
return jSample.getFont();
}
/* ------------------------------------------------------------- */
public void setCurrentFont(Font font)
{
if(font==null)
{
font = jSample.getFont();
}
jFont.setText(font.getName());
jFontActionPerformed(null);
jStyle.setText(styleToString(font.getStyle()));
jStyleActionPerformed(null);
jSize.setText(Integer.toString(font.getSize()));
jSizeActionPerformed(null);
}

// Create font chooser dialog.
// If user selected a font (i.e. clicked OK button) - return the font that user has selected.
// If user didn"t click OK button - return "null".
public static Font showDialog( Frame parent, String title, Font font)
{
FontChooser dialog = new FontChooser(parent,true,font);
Point p1 = parent.getLocation();
Dimension d1 = parent.getSize();
Dimension d2 = dialog.getSize();
int x = p1.x+(d1.width-d2.width)/2;
int y = p1.y+(d1.height-d2.height)/2;
if(x < 0)
{
x = 0;
}
if(y < 0)
{
y = 0;
}
if(title!=null)
{
dialog.setTitle(title);
}
dialog.setLocation(x,y);
dialog.setVisible(true);
Font newfont = null;
if(dialog.ok)
{
newfont = dialog.getCurrentFont();
}
dialog.dispose();
return newfont;
}
/** This method is called from within the constructor to
* initialize the form.
* WARNING: Do NOT modify this code. The content of this method is
* always regenerated by the FormEditor.
*/
private void initComponents()
{
jPanel3 = new javax.swing.JPanel();
jFont = new javax.swing.JTextField();
jScrollPane1 = new javax.swing.JScrollPane();
jFontList = new javax.swing.JList();
jPanel4 = new javax.swing.JPanel();
jStyle = new javax.swing.JTextField();
jScrollPane2 = new javax.swing.JScrollPane();
jStyleList = new javax.swing.JList();
jPanel5 = new javax.swing.JPanel();
jSize = new javax.swing.JTextField();
jScrollPane3 = new javax.swing.JScrollPane();
jSizeList = new javax.swing.JList();
jPanel1 = new javax.swing.JPanel();
jScrollPane4 = new javax.swing.JScrollPane();
jSample = new javax.swing.JTextArea();
jButtons = new javax.swing.JPanel();
jOk = new javax.swing.JButton();
jCancel = new javax.swing.JButton();
jLabel6 = new javax.swing.JLabel();
getContentPane().setLayout(new java.awt.GridBagLayout());
java.awt.GridBagConstraints gridBagConstraints1;
setTitle("Font Chooser");
addWindowListener(new java.awt.event.WindowAdapter()
{
public void windowClosing(java.awt.event.WindowEvent evt)
{
closeDialog(evt);
}
}
);
jPanel3.setLayout(new java.awt.GridBagLayout());
java.awt.GridBagConstraints gridBagConstraints2;
jPanel3.setBorder(new javax.swing.border.TitledBorder(new javax.swing.border.EtchedBorder(), " Font "));
jFont.setColumns(24);
jFont.addActionListener(new java.awt.event.ActionListener()
{
public void actionPerformed(java.awt.event.ActionEvent evt)
{
jFontActionPerformed(evt);
}
}
);
gridBagConstraints2 = new java.awt.GridBagConstraints();
gridBagConstraints2.gridwidth = 0;
gridBagConstraints2.fill =
java.awt.GridBagConstraints.HORIZONTAL;
gridBagConstraints2.insets = new java.awt.Insets(0, 3, 0, 3);
gridBagConstraints2.anchor = java.awt.GridBagConstraints.NORTHWEST;
gridBagConstraints2.weightx = 1.0;
jPanel3.add(jFont, gridBagConstraints2);

jFontList.setModel(new DefaultListModel());
jFontList.setSelectionMode(javax.swing.ListSelectionModel.SINGLE_SELECTION);
jFontList.addListSelectionListener(new javax.swing.event.ListSelectionListener()
{
public void valueChanged(javax.swing.event.ListSelectionEvent evt)
{
jFontListValueChanged(evt);
}
}
);
jScrollPane1.setViewportView(jFontList);
gridBagConstraints2 = new java.awt.GridBagConstraints();
gridBagConstraints2.fill = java.awt.GridBagConstraints.BOTH;
gridBagConstraints2.insets = new java.awt.Insets(3, 3, 3, 3);
gridBagConstraints2.anchor = java.awt.GridBagConstraints.NORTHWEST;
gridBagConstraints2.weightx = 1.0;
gridBagConstraints2.weighty = 1.0;
jPanel3.add(jScrollPane1, gridBagConstraints2);

gridBagConstraints1 = new java.awt.GridBagConstraints();
gridBagConstraints1.fill = java.awt.GridBagConstraints.BOTH;
gridBagConstraints1.insets = new java.awt.Insets(5, 5, 0, 0);
gridBagConstraints1.weightx = 0.5;
gridBagConstraints1.weighty = 1.0;
getContentPane().add(jPanel3, gridBagConstraints1);

jPanel4.setLayout(new java.awt.GridBagLayout());
java.awt.GridBagConstraints gridBagConstraints3;
jPanel4.setBorder(new javax.swing.border.TitledBorder(new javax.swing.border.EtchedBorder(), " Style "));
jStyle.setColumns(18);
jStyle.addActionListener(new java.awt.event.ActionListener()
{
public void actionPerformed(java.awt.event.ActionEvent evt)
{
jStyleActionPerformed(evt);
}
}
);
gridBagConstraints3 = new java.awt.GridBagConstraints();
gridBagConstraints3.gridwidth = 0;
gridBagConstraints3.fill =
java.awt.GridBagConstraints.HORIZONTAL;
gridBagConstraints3.insets = new java.awt.Insets(0, 3, 0, 3);
gridBagConstraints3.anchor = java.awt.GridBagConstraints.NORTHWEST;
gridBagConstraints3.weightx = 1.0;
jPanel4.add(jStyle, gridBagConstraints3);
jStyleList.setModel(new DefaultListModel());
jStyleList.setVisibleRowCount(4);
jStyleList.addListSelectionListener(new javax.swing.event.ListSelectionListener()
{
public void valueChanged(javax.swing.event.ListSelectionEvent evt)
{
jStyleListValueChanged(evt);
}
}
);
jScrollPane2.setViewportView(jStyleList);
gridBagConstraints3 = new java.awt.GridBagConstraints();
gridBagConstraints3.fill = java.awt.GridBagConstraints.BOTH;
gridBagConstraints3.insets = new java.awt.Insets(3, 3, 3, 3);
gridBagConstraints3.anchor = java.awt.GridBagConstraints.NORTHWEST;
gridBagConstraints3.weightx = 0.5;
gridBagConstraints3.weighty = 1.0;
jPanel4.add(jScrollPane2, gridBagConstraints3);
gridBagConstraints1 = new java.awt.GridBagConstraints();
gridBagConstraints1.fill = java.awt.GridBagConstraints.BOTH;
gridBagConstraints1.insets = new java.awt.Insets(5, 5, 0, 0);
gridBagConstraints1.weightx = 0.375;
gridBagConstraints1.weighty = 1.0;
getContentPane().add(jPanel4, gridBagConstraints1);
jPanel5.setLayout(new java.awt.GridBagLayout());
java.awt.GridBagConstraints gridBagConstraints4;
jPanel5.setBorder(new javax.swing.border.TitledBorder(new javax.swing.border.EtchedBorder(), " Size "));
jSize.setColumns(6);
jSize.addActionListener(new
java.awt.event.ActionListener()
{
public void actionPerformed(java.awt.event.ActionEvent evt)
{
jSizeActionPerformed(evt);
}
}
);
gridBagConstraints4 = new java.awt.GridBagConstraints();
gridBagConstraints4.gridwidth = 0;
gridBagConstraints4.fill = java.awt.GridBagConstraints.HORIZONTAL;
gridBagConstraints4.insets = new java.awt.Insets(0, 3, 0, 3);
gridBagConstraints4.anchor = java.awt.GridBagConstraints.NORTHWEST;
gridBagConstraints4.weightx = 1.0;
jPanel5.add(jSize, gridBagConstraints4);
jSizeList.setModel(new DefaultListModel());
jSizeList.setVisibleRowCount(4);
jSizeList.setSelectionMode(javax.swing.ListSelectionModel.SINGLE_SELECTION);
jSizeList.addListSelectionListener(new javax.swing.event.ListSelectionListener()
{
public void valueChanged(javax.swing.event.ListSelectionEvent evt)
{
jSizeListValueChanged(evt);
}
}
);
jScrollPane3.setViewportView(jSizeList);
gridBagConstraints4 = new java.awt.GridBagConstraints();
gridBagConstraints4.fill = java.awt.GridBagConstraints.BOTH;
gridBagConstraints4.insets = new java.awt.Insets(3, 3, 3, 3);
gridBagConstraints4.anchor = java.awt.GridBagConstraints.NORTHWEST;
gridBagConstraints4.weightx = 0.25;
gridBagConstraints4.weighty = 1.0;
jPanel5.add(jScrollPane3, gridBagConstraints4);
gridBagConstraints1 = new java.awt.GridBagConstraints();
gridBagConstraints1.gridwidth = 0;
gridBagConstraints1.fill = java.awt.GridBagConstraints.BOTH;
gridBagConstraints1.insets = new java.awt.Insets(5, 5, 0, 5);
gridBagConstraints1.weightx = 0.125;
gridBagConstraints1.weighty = 1.0;
getContentPane().add(jPanel5, gridBagConstraints1);
jPanel1.setLayout(new java.awt.GridBagLayout());
java.awt.GridBagConstraints gridBagConstraints5;
jPanel1.setBorder(new javax.swing.border.TitledBorder(new javax.swing.border.EtchedBorder(), " Sample "));
jSample.setWrapStyleWord(true);
jSample.setLineWrap(true);
jSample.setColumns(20);
jSample.setRows(3);
jSample.setText("The quick brown fox jumped over the lazy dog.");
jScrollPane4.setViewportView(jSample);
gridBagConstraints5 = new java.awt.GridBagConstraints();
gridBagConstraints5.fill = java.awt.GridBagConstraints.BOTH;
gridBagConstraints5.insets = new java.awt.Insets(0, 3, 3, 3);
gridBagConstraints5.weightx = 1.0;
gridBagConstraints5.weighty = 1.0;
jPanel1.add(jScrollPane4, gridBagConstraints5);
gridBagConstraints1 = new java.awt.GridBagConstraints();
gridBagConstraints1.gridwidth = 0;
gridBagConstraints1.fill = java.awt.GridBagConstraints.BOTH;
gridBagConstraints1.insets = new java.awt.Insets(0, 5, 0, 5);
gridBagConstraints1.anchor = java.awt.GridBagConstraints.NORTHWEST;
gridBagConstraints1.weightx = 1.0;
getContentPane().add(jPanel1, gridBagConstraints1);
jButtons.setLayout(new java.awt.GridBagLayout());
java.awt.GridBagConstraints gridBagConstraints6;
jOk.setMnemonic(KeyEvent.VK_O);
jOk.setText("OK");
jOk.setRequestFocusEnabled(false);
jOk.addActionListener(new java.awt.event.ActionListener()
{
public void actionPerformed(java.awt.event.ActionEvent evt)
{
jOkActionPerformed(evt);
}
}
);
gridBagConstraints6 = new java.awt.GridBagConstraints();
gridBagConstraints6.insets = new java.awt.Insets(5, 5, 5, 0);
gridBagConstraints6.anchor = java.awt.GridBagConstraints.WEST;
jButtons.add(jOk, gridBagConstraints6);

jCancel.setMnemonic(KeyEvent.VK_C);
jCancel.setText("Cancel");
jCancel.setRequestFocusEnabled(false);
jCancel.addActionListener(new
java.awt.event.ActionListener()
{
public void actionPerformed(java.awt.event.ActionEvent evt)
{
jCancelActionPerformed(evt);
}
}
);
gridBagConstraints6 = new java.awt.GridBagConstraints();
gridBagConstraints6.gridwidth = 0;
gridBagConstraints6.insets = new java.awt.Insets(5, 5, 5, 5);
gridBagConstraints6.anchor = java.awt.GridBagConstraints.WEST;
gridBagConstraints6.weightx = 1.0;
jButtons.add(jCancel, gridBagConstraints6);
gridBagConstraints6 = new java.awt.GridBagConstraints();
gridBagConstraints6.weightx = 1.0;
jButtons.add(jLabel6, gridBagConstraints6);
gridBagConstraints1 = new java.awt.GridBagConstraints();
gridBagConstraints1.gridwidth = 0;
gridBagConstraints1.anchor = java.awt.GridBagConstraints.SOUTHWEST;
gridBagConstraints1.weightx = 1.0;
getContentPane().add(jButtons, gridBagConstraints1);
}
private void jCancelActionPerformed(java.awt.event.ActionEvent evt)
{
// Add your handling code here:
setVisible(false);
}
private void jOkActionPerformed (java.awt.event.ActionEvent evt)
{
// Add your handling code here:
ok = true;
setVisible(false);
}
private void jSizeActionPerformed (java.awt.event.ActionEvent evt)
{
// Add your handling code here:
int size = Integer.parseInt(jSize.getText());
if(size > 0)
{
currentSize = size;
setSampleFont();
}
}
private void jStyleActionPerformed (java.awt.event.ActionEvent evt)
{
// Add your handling code here:
StringTokenizer st = new StringTokenizer(jStyle.getText(),",");
int style = 0;
while(st.hasMoreTokens())
{
String str = st.nextToken().trim();
if(str.equalsIgnoreCase("Plain"))
{
style |= Font.PLAIN;
}
else
if(str.equalsIgnoreCase("Bold"))
{
style |= Font.BOLD;
}
else
if(str.equalsIgnoreCase("Italic"))
{
style |= Font.ITALIC;
}
}
if(style >= 0)
{
currentStyle = style;
setSampleFont();
}
}
private void jFontActionPerformed (java.awt.event.ActionEvent evt)
{
// Add your handling code here:
DefaultListModel model = (DefaultListModel)
jFontList.getModel();
if(model.indexOf(jFont.getText()) >= 0)
{
currentFont = jFont.getText();
setSampleFont();
}
}
private void jStyleListValueChanged(javax.swing.event.ListSelectionEvent evt)
{
// Add your handling code here:
String str = "";
Object[] values = jStyleList.getSelectedValues();
if(values.length > 0)
{
int j;
for(j=0; j < values.length; j++)
{
String s = (String) values[j];
if(s.equalsIgnoreCase("Plain"))
{
str = "Plain"; break;
}
if(str.length() > 0)
{
str += ",";
}
str += (String) values[j];
}
}
else
{
str = styleToString(currentStyle);
}
jStyle.setText(str);
jStyleActionPerformed(null);
}
private void jSizeListValueChanged(javax.swing.event.ListSelectionEvent evt)
{
// Add your handling code here:
String str = (String) jSizeList.getSelectedValue();
if(str==null || str.length() <= 0)
{
str = Integer.toString(currentSize);
}
jSize.setText(str);
jSizeActionPerformed(null);
}
private void jFontListValueChanged(javax.swing.event.ListSelectionEvent evt)
{
// Add your handling code here:
String str = (String) jFontList.getSelectedValue();
if(str==null || str.length() <= 0)
{
str = currentFont;
}
jFont.setText(str);
jFontActionPerformed(null);
}
/** Closes the dialog */
private void closeDialog(java.awt.event.WindowEvent evt)
{
setVisible (false);
}
// Variables declaration - do not modify
private javax.swing.JPanel jPanel3;
private javax.swing.JTextField jFont;
private javax.swing.JScrollPane jScrollPane1;
private javax.swing.JList jFontList;
private javax.swing.JPanel jPanel4;
private javax.swing.JTextField jStyle;
private javax.swing.JScrollPane jScrollPane2;
private javax.swing.JList jStyleList;
private javax.swing.JPanel jPanel5;
private javax.swing.JTextField jSize;
private javax.swing.JScrollPane jScrollPane3;
private javax.swing.JList jSizeList;
private javax.swing.JPanel jPanel1;
private javax.swing.JScrollPane jScrollPane4;
private javax.swing.JTextArea jSample;
private javax.swing.JPanel jButtons;
private javax.swing.JButton jOk;
private javax.swing.JButton jCancel;
private javax.swing.JLabel jLabel6;
// End of variables declaration
}

</source>



== Font Chooser Source Code ==

== Font dialog ==



<source lang="java">

/*
* JCommon : a free general purpose class library for the Java(tm) platform
*
*
* (C) Copyright 2000-2005, by Object Refinery Limited and Contributors.
*
* Project Info: http://www.jfree.org/jcommon/index.html
*
* This library is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation; either version 2.1 of the License, or
* (at your option) any later version.
*
* This library is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
* License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
* USA.
*
* [Java is a trademark or registered trademark of Sun Microsystems, Inc.
* in the United States and other countries.]
*
* ----------------------
* FontChooserDialog.java
* ----------------------
* (C) Copyright 2000-2004, by Object Refinery Limited.
*
* Original Author: David Gilbert (for Object Refinery Limited);
* Contributor(s): -;
*
* $Id: FontChooserDialog.java,v 1.5 2007/11/02 17:50:36 taqua Exp $
*
* Changes (from 26-Oct-2001)
* --------------------------
* 26-Oct-2001 : Changed package to com.jrefinery.ui.*;
* 14-Oct-2002 : Fixed errors reported by Checkstyle (DG);
*
*/
import java.awt.BorderLayout;
import java.awt.Dialog;
import java.awt.Font;
import java.awt.Frame;
import java.awt.GraphicsEnvironment;
import java.awt.GridLayout;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import javax.swing.BorderFactory;
import javax.swing.JButton;
import javax.swing.JCheckBox;
import javax.swing.JDialog;
import javax.swing.JList;
import javax.swing.JPanel;
import javax.swing.JScrollPane;
import javax.swing.JTextField;
import javax.swing.ListModel;
/**
* A dialog for choosing a font from the available system fonts.
*
* @author David Gilbert
*/
public class FontChooserDialog extends StandardDialog {
/** The panel within the dialog that contains the font selection controls. */
private FontChooserPanel fontChooserPanel;
/**
* Standard constructor - builds a font chooser dialog owned by another dialog.
*
* @param owner the dialog that "owns" this dialog.
* @param title the title for the dialog.
* @param modal a boolean that indicates whether or not the dialog is modal.
* @param font the initial font displayed.
*/
public FontChooserDialog(final Dialog owner, final String title, final boolean modal, final Font font) {
super(owner, title, modal);
setContentPane(createContent(font));
}
/**
* Standard constructor - builds a font chooser dialog owned by a frame.
*
* @param owner the frame that "owns" this dialog.
* @param title the title for the dialog.
* @param modal a boolean that indicates whether or not the dialog is modal.
* @param font the initial font displayed.
*/
public FontChooserDialog(final Frame owner, final String title, final boolean modal, final Font font) {
super(owner, title, modal);
setContentPane(createContent(font));
}
/**
* Returns the selected font.
*
* @return the font.
*/
public Font getSelectedFont() {
return this.fontChooserPanel.getSelectedFont();
}
/**
* Returns the panel that is the user interface.
*
* @param font the font.
*
* @return the panel.
*/
private JPanel createContent(Font font) {
final JPanel content = new JPanel(new BorderLayout());
content.setBorder(BorderFactory.createEmptyBorder(4, 4, 4, 4));
if (font == null) {
font = new Font("Dialog", 10, Font.PLAIN);
}
this.fontChooserPanel = new FontChooserPanel(font);
content.add(this.fontChooserPanel);
final JPanel buttons = createButtonPanel();
buttons.setBorder(BorderFactory.createEmptyBorder(4, 0, 0, 0));
content.add(buttons, BorderLayout.SOUTH);
return content;
}
}
/*
* JCommon : a free general purpose class library for the Java(tm) platform
* s
*
* (C) Copyright 2000-2008, by Object Refinery Limited and Contributors.
*
* Project Info: http://www.jfree.org/jcommon/index.html
*
* This library is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation; either version 2.1 of the License, or
* (at your option) any later version.
*
* This library is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
* License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
* USA.
*
* [Java is a trademark or registered trademark of Sun Microsystems, Inc.
* in the United States and other countries.]
*
* ---------------------
* FontChooserPanel.java
* ---------------------
* (C) Copyright 2000-2008, by Object Refinery Limited.
*
* Original Author: David Gilbert (for Object Refinery Limited);
* Contributor(s): Arnaud Lelievre;
*
* $Id: FontChooserPanel.java,v 1.6 2008/12/18 09:57:32 mungady Exp $
*
* Changes (from 26-Oct-2001)
* --------------------------
* 26-Oct-2001 : Changed package to com.jrefinery.ui.*;
* 14-Oct-2002 : Fixed errors reported by Checkstyle (DG);
* 08-Sep-2003 : Added internationalization via use of properties resourceBundle (RFE 690236) (AL);
* 21-Feb-2004 : The FontParameter of the constructor was never used (TM);
* 18-Dec-2008 : Use ResourceBundleWrapper - see JFreeChart patch 1607918 by
* Jess Thrysoee (DG);
*
*/
/**
* A panel for choosing a font from the available system fonts - still a bit of
* a hack at the moment, but good enough for demonstration applications.
*
* @author David Gilbert
*/
class FontChooserPanel extends JPanel {
/** The font sizes that can be selected. */
public static final String[] SIZES = {"9", "10", "11", "12", "14", "16",
"18", "20", "22", "24", "28", "36", "48", "72"};
/** The list of fonts. */
private JList fontlist;
/** The list of sizes. */
private JList sizelist;
/** The checkbox that indicates whether the font is bold. */
private JCheckBox bold;
/** The checkbox that indicates whether or not the font is italic. */
private JCheckBox italic;

/**
* Standard constructor - builds a FontChooserPanel initialised with the
* specified font.
*
* @param font the initial font to display.
*/
public FontChooserPanel(final Font font) {
final GraphicsEnvironment g
= GraphicsEnvironment.getLocalGraphicsEnvironment();
final String[] fonts = g.getAvailableFontFamilyNames();
setLayout(new BorderLayout());
final JPanel right = new JPanel(new BorderLayout());
final JPanel fontPanel = new JPanel(new BorderLayout());
fontPanel.setBorder(BorderFactory.createTitledBorder(
BorderFactory.createEtchedBorder(),
"Font"));
this.fontlist = new JList(fonts);
final JScrollPane fontpane = new JScrollPane(this.fontlist);
fontpane.setBorder(BorderFactory.createEtchedBorder());
fontPanel.add(fontpane);
add(fontPanel);
final JPanel sizePanel = new JPanel(new BorderLayout());
sizePanel.setBorder(BorderFactory.createTitledBorder(
BorderFactory.createEtchedBorder(),
"Size"));
this.sizelist = new JList(SIZES);
final JScrollPane sizepane = new JScrollPane(this.sizelist);
sizepane.setBorder(BorderFactory.createEtchedBorder());
sizePanel.add(sizepane);
final JPanel attributes = new JPanel(new GridLayout(1, 2));
this.bold = new JCheckBox("Bold");
this.italic = new JCheckBox("Italic");
attributes.add(this.bold);
attributes.add(this.italic);
attributes.setBorder(BorderFactory.createTitledBorder(
BorderFactory.createEtchedBorder(),
"Attributes"));
right.add(sizePanel, BorderLayout.CENTER);
right.add(attributes, BorderLayout.SOUTH);
add(right, BorderLayout.EAST);
setSelectedFont(font);
}
/**
* Returns a Font object representing the selection in the panel.
*
* @return the font.
*/
public Font getSelectedFont() {
return new Font(getSelectedName(), getSelectedStyle(),
getSelectedSize());
}
/**
* Returns the selected name.
*
* @return the name.
*/
public String getSelectedName() {
return (String) this.fontlist.getSelectedValue();
}
/**
* Returns the selected style.
*
* @return the style.
*/
public int getSelectedStyle() {
if (this.bold.isSelected() && this.italic.isSelected()) {
return Font.BOLD + Font.ITALIC;
}
if (this.bold.isSelected()) {
return Font.BOLD;
}
if (this.italic.isSelected()) {
return Font.ITALIC;
}
else {
return Font.PLAIN;
}
}
/**
* Returns the selected size.
*
* @return the size.
*/
public int getSelectedSize() {
final String selected = (String) this.sizelist.getSelectedValue();
if (selected != null) {
return Integer.parseInt(selected);
}
else {
return 10;
}
}
/**
* Initializes the contents of the dialog from the given font
* object.
*
* @param font the font from which to read the properties.
*/
public void setSelectedFont (final Font font) {
if (font == null) {
throw new NullPointerException();
}
this.bold.setSelected(font.isBold());
this.italic.setSelected(font.isItalic());
final String fontName = font.getName();
ListModel model = this.fontlist.getModel();
this.fontlist.clearSelection();
for (int i = 0; i < model.getSize(); i++) {
if (fontName.equals(model.getElementAt(i))) {
this.fontlist.setSelectedIndex(i);
break;
}
}
final String fontSize = String.valueOf(font.getSize());
model = this.sizelist.getModel();
this.sizelist.clearSelection();
for (int i = 0; i < model.getSize(); i++) {
if (fontSize.equals(model.getElementAt(i))) {
this.sizelist.setSelectedIndex(i);
break;
}
}
}
}
/*
* JCommon : a free general purpose class library for the Java(tm) platform
*
*
* (C) Copyright 2000-2008, by Object Refinery Limited and Contributors.
*
* Project Info: http://www.jfree.org/jcommon/index.html
*
* This library is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation; either version 2.1 of the License, or
* (at your option) any later version.
*
* This library is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
* License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
* USA.
*
* [Java is a trademark or registered trademark of Sun Microsystems, Inc.
* in the United States and other countries.]
*
* -------------------
* StandardDialog.java
* -------------------
* (C) Copyright 2000-2008, by Object Refinery Limited.
*
* Original Author: David Gilbert (for Object Refinery Limited);
* Contributor(s): Arnaud Lelievre;
*
* $Id: StandardDialog.java,v 1.7 2008/12/18 09:57:32 mungady Exp $
*
* Changes (from 26-Oct-2001)
* --------------------------
* 26-Oct-2001 : Changed package to com.jrefinery.ui.*;
* 08-Sep-2003 : Added internationalization via use of properties
* resourceBundle (RFE 690236) (AL);
* 18-Dec-2008 : Use ResourceBundleWrapper - see JFreeChart patch 1607918 by
* Jess Thrysoee (DG);
*
*/

/**
* The base class for standard dialogs.
*
* @author David Gilbert
*/
class StandardDialog extends JDialog implements ActionListener {
/** Flag that indicates whether or not the dialog was cancelled. */
private boolean cancelled;

/**
* Standard constructor - builds a dialog...
*
* @param owner the owner.
* @param title the title.
* @param modal modal?
*/
public StandardDialog(final Frame owner, final String title,
final boolean modal) {
super(owner, title, modal);
this.cancelled = false;
}
/**
* Standard constructor - builds a dialog...
*
* @param owner the owner.
* @param title the title.
* @param modal modal?
*/
public StandardDialog(final Dialog owner, final String title,
final boolean modal) {
super(owner, title, modal);
this.cancelled = false;
}
/**
* Returns a flag that indicates whether or not the dialog has been
* cancelled.
*
* @return boolean.
*/
public boolean isCancelled() {
return this.cancelled;
}
/**
* Handles clicks on the standard buttons.
*
* @param event the event.
*/
public void actionPerformed(final ActionEvent event) {
final String command = event.getActionCommand();
if (command.equals("helpButton")) {
// display help information
}
else if (command.equals("okButton")) {
this.cancelled = false;
setVisible(false);
}
else if (command.equals("cancelButton")) {
this.cancelled = true;
setVisible(false);
}
}
/**
* Builds and returns the user interface for the dialog. This method is
* shared among the constructors.
*
* @return the button panel.
*/
protected JPanel createButtonPanel() {
final L1R2ButtonPanel buttons = new L1R2ButtonPanel(
"Help",
"OK",
"Cancel");
final JButton helpButton = buttons.getLeftButton();
helpButton.setActionCommand("helpButton");
helpButton.addActionListener(this);
final JButton okButton = buttons.getRightButton1();
okButton.setActionCommand("okButton");
okButton.addActionListener(this);
final JButton cancelButton = buttons.getRightButton2();
cancelButton.setActionCommand("cancelButton");
cancelButton.addActionListener(this);
buttons.setBorder(BorderFactory.createEmptyBorder(4, 0, 0, 0));
return buttons;
}
}
/*
* JCommon : a free general purpose class library for the Java(tm) platform
*
*
* (C) Copyright 2000-2005, by Object Refinery Limited and Contributors.
*
* Project Info: http://www.jfree.org/jcommon/index.html
*
* This library is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation; either version 2.1 of the License, or
* (at your option) any later version.
*
* This library is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
* License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
* USA.
*
* [Java is a trademark or registered trademark of Sun Microsystems, Inc.
* in the United States and other countries.]
*
* --------------------
* L1R2ButtonPanel.java
* --------------------
* (C) Copyright 2000-2004, by Object Refinery Limited.
*
* Original Author: David Gilbert (for Object Refinery Limited);
* Contributor(s): -;
*
* $Id: L1R2ButtonPanel.java,v 1.4 2007/11/02 17:50:36 taqua Exp $
*
* Changes (from 26-Oct-2001)
* --------------------------
* 26-Oct-2001 : Changed package to com.jrefinery.ui.*;
* 26-Jun-2002 : Removed unnecessary import (DG);
* 14-Oct-2002 : Fixed errors reported by Checkstyle (DG);
*
*/

/**
* A "ready-made" panel that has one button on the left and two buttons on the right - nested
* panels and layout managers take care of resizing.
*
* @author David Gilbert
*/
class L1R2ButtonPanel extends JPanel {
/** The left button. */
private JButton left;
/** The first button on the right of the panel. */
private JButton right1;
/** The second button on the right of the panel. */
private JButton right2;
/**
* Standard constructor - creates a three button panel with the specified button labels.
*
* @param label1 the label for button 1.
* @param label2 the label for button 2.
* @param label3 the label for button 3.
*/
public L1R2ButtonPanel(final String label1, final String label2, final String label3) {
setLayout(new BorderLayout());
// create the pieces...
this.left = new JButton(label1);
final JPanel rightButtonPanel = new JPanel(new GridLayout(1, 2));
this.right1 = new JButton(label2);
this.right2 = new JButton(label3);
rightButtonPanel.add(this.right1);
rightButtonPanel.add(this.right2);
// ...and put them together
add(this.left, BorderLayout.WEST);
add(rightButtonPanel, BorderLayout.EAST);
}
/**
* Returns a reference to button 1, allowing the caller to set labels, action-listeners etc.
*
* @return the left button.
*/
public JButton getLeftButton() {
return this.left;
}
/**
* Returns a reference to button 2, allowing the caller to set labels, action-listeners etc.
*
* @return the right button 1.
*/
public JButton getRightButton1() {
return this.right1;
}
/**
* Returns a reference to button 3, allowing the caller to set labels, action-listeners etc.
*
* @return the right button 2.
*/
public JButton getRightButton2() {
return this.right2;
}
}
/*
* JCommon : a free general purpose class library for the Java(tm) platform
*
*
* (C) Copyright 2000-2008, by Object Refinery Limited and Contributors.
*
* Project Info: http://www.jfree.org/jcommon/index.html
*
* This library is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation; either version 2.1 of the License, or
* (at your option) any later version.
*
* This library is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
* License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
* USA.
*
* [Java is a trademark or registered trademark of Sun Microsystems, Inc.
* in the United States and other countries.]
*
* ---------------------
* FontDisplayField.java
* ---------------------
* (C) Copyright 2000-2008, by Object Refinery Limited.
*
* Original Author: David Gilbert (for Object Refinery Limited);
* Contributor(s): Arnaud Lelievre;
*
* $Id: FontDisplayField.java,v 1.6 2008/12/18 09:57:32 mungady Exp $
*
* Changes (from 26-Oct-2001)
* ----------------------------------
* 26-Oct-2001 : Changed package to com.jrefinery.ui.*;
* 14-Oct-2002 : Fixed errors reported by Checkstyle (DG);
* 08-Sep-2003 : Added internationalization via use of properties
* resourceBundle (RFE 690236) (AL);
* 18-Dec-2008 : Use ResourceBundleWrapper - see JFreeChart patch 1607918 by
* Jess Thrysoee (DG);
*
*/

/**
* A field for displaying a font selection. The display field itself is
* read-only, to the developer must provide another mechanism to allow the
* user to change the font.
*
* @author David Gilbert
*/
class FontDisplayField extends JTextField {
/** The current font. */
private Font displayFont;

/**
* Standard constructor - builds a FontDescriptionField initialised with
* the specified font.
*
* @param font the font.
*/
public FontDisplayField(final Font font) {
super("");
setDisplayFont(font);
setEnabled(false);
}
/**
* Returns the current font.
*
* @return the font.
*/
public Font getDisplayFont() {
return this.displayFont;
}
/**
* Sets the font.
*
* @param font the font.
*/
public void setDisplayFont(final Font font) {
this.displayFont = font;
setText(fontToString(this.displayFont));
}
/**
* Returns a string representation of the specified font.
*
* @param font the font.
*
* @return a string describing the font.
*/
private String fontToString(final Font font) {
if (font != null) {
return font.getFontName() + ", " + font.getSize();
}
else {
return "No Font Selected";
}
}
}

</source>



== Font Dialog from claribole ==



<source lang="java">

/* FILE: FontDialog.java
* DATE OF CREATION: Wed Jan 15 17:07:07 2002
* AUTHOR : Emmanuel Pietriga (emmanuel@w3.org)
* MODIF: Emmanuel Pietriga (emmanuel.pietriga@inria.fr)
* Copyright (c) Emmanuel Pietriga, 2002. All Rights Reserved
* Copyright (c) INRIA, 2008. All Rights Reserved
* Licensed under the GNU LGPL. For full terms see the file COPYING.
*
* $Id: FontDialog.java 1207 2008-08-13 16:03:07Z epietrig $
*/

import java.awt.Container;
import java.awt.Dialog;
import java.awt.FlowLayout;
import java.awt.Font;
import java.awt.Frame;
import java.awt.GridBagConstraints;
import java.awt.GridBagLayout;
import java.awt.Window;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.awt.event.ruponentAdapter;
import java.awt.event.ruponentEvent;
import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;
import java.util.StringTokenizer;
import javax.swing.JButton;
import javax.swing.JDialog;
import javax.swing.JList;
import javax.swing.JPanel;
import javax.swing.JScrollPane;
public class FontDialog extends JDialog implements ActionListener {
static final String ZVTM_FONT_CHOOSER = "ZVTM Font Chooser";
static String DEFAULT_FAMILY="Dialog";
static int DEFAULT_STYLE=Font.PLAIN;
static int DEFAULT_SIZE=10;
FontTracker ft;
JButton okBt,cancelBt;
JList familyList,styleList,sizeList;
String[] allFontFamilies=java.awt.GraphicsEnvironment.getLocalGraphicsEnvironment().getAvailableFontFamilyNames();
String[] allFontStyles={"Plain","Bold","Italic","BoldItalic"};
String[] allFontSizes={"4","6","8","10","12","14","16","18","20","24"};

/** Call a FontDialog window that will return the font selected in the window
*@param owner application frame that owns this Modal component
*/
public static Font getFontDialog(Frame owner){
FontTracker res=new FontTracker();
FontDialog fd=new FontDialog(res,owner);
fd.addWindowListener(new FontDialog.Closer());
fd.addComponentListener(new FontDialog.DisposeOnClose());
fd.setLocationRelativeTo(owner);
fd.setVisible(true); //blocks until the dialog is closed
return res.getFont();
}
/** Call a FontDialog window that will return the font selected in the window
*@param owner application dialog that owns this Modal component
*/
public static Font getFontDialog(Dialog owner){
FontTracker res=new FontTracker();
FontDialog fd=new FontDialog(res,owner);
fd.addWindowListener(new FontDialog.Closer());
fd.addComponentListener(new FontDialog.DisposeOnClose());
fd.setLocationRelativeTo(owner);
fd.setVisible(true); //blocks until the dialog is closed
return res.getFont();
}
/** Call a FontDialog window that will return the font selected in the window
*@param owner application frame that owns this Modal component
*@param f a font giving the default parameters with which the dialog should be initialized (family, size, style)
*/
public static Font getFontDialog(Frame owner,Font f){
if (f!=null){
DEFAULT_FAMILY=f.getFamily();
DEFAULT_STYLE=f.getStyle();
DEFAULT_SIZE=f.getSize();
}
FontTracker res=new FontTracker();
FontDialog fd=new FontDialog(res,owner);
fd.addWindowListener(new FontDialog.Closer());
fd.addComponentListener(new FontDialog.DisposeOnClose());
fd.setLocationRelativeTo(owner);
fd.setVisible(true); //blocks until the dialog is closed
return res.getFont();
}
/** Call a FontDialog window that will return the font selected in the window
*@param owner application dialog that owns this Modal component
*@param f a font giving the default parameters with which the dialog should be initialized (family, size, style)
*/
public static Font getFontDialog(Dialog owner,Font f){
if (f!=null){
DEFAULT_FAMILY=f.getFamily();
DEFAULT_STYLE=f.getStyle();
DEFAULT_SIZE=f.getSize();
}
FontTracker res=new FontTracker();
FontDialog fd=new FontDialog(res,owner);
fd.addWindowListener(new FontDialog.Closer());
fd.addComponentListener(new FontDialog.DisposeOnClose());
fd.setLocationRelativeTo(owner);
fd.setVisible(true); //blocks until the dialog is closed
return res.getFont();
}
/**
* Font.decode does not seem to work that well, or I don;t understand how it is supposed to work
* Anyway, this one does what I want (decodes family+" "+style+" "+size)
*/
public static Font decode(String fontSpec){
if (fontSpec!=null && fontSpec.length()>0){
StringTokenizer st=new StringTokenizer(fontSpec," ",false);
String[] tokens=new String[st.countTokens()];
if (tokens.length>=3){
int i=0;
while (st.hasMoreTokens()) {
tokens[i++]=st.nextToken();
}
String tokenizedFamily="";
for (int j=0;j<tokens.length-3;j++){
tokenizedFamily+=tokens[j]+" ";
}
tokenizedFamily+=tokens[tokens.length-3];
String family=tokenizedFamily;if (family==null){family=DEFAULT_FAMILY;}
String tokenizedStyle=tokens[tokens.length-2];
String tokenizedSize=tokens[tokens.length-1];
int style;
if (tokenizedStyle.equals("Bold")){style=Font.BOLD;}
else if (tokenizedStyle.equals("Italic")){style=Font.ITALIC;}
else if (tokenizedStyle.equals("BoldItalic")){style=Font.BOLD+Font.ITALIC;}
else {style=Font.PLAIN;}//"Plain"
int size;
try {
size=Integer.parseInt(tokenizedSize);
if (size<=0){size=DEFAULT_SIZE;}
}
catch (NumberFormatException ex){size=DEFAULT_SIZE;}
return new Font(family,style,size);
}
else {return new Font(DEFAULT_FAMILY,DEFAULT_STYLE,DEFAULT_SIZE);}
}
else {return new Font(DEFAULT_FAMILY,DEFAULT_STYLE,DEFAULT_SIZE);}
}
FontDialog(FontTracker ftt,Frame owner){
super(owner,ZVTM_FONT_CHOOSER,true);
setLocation(owner.getLocation());
ft=ftt;
initUI();
}
FontDialog(FontTracker ftt,Dialog owner){
super(owner,ZVTM_FONT_CHOOSER,true);
setLocation(owner.getLocation());
ft=ftt;
initUI();
}
void initUI(){//depending on selected item/default shape type
Container cp=this.getContentPane();
try {
okBt.removeActionListener(this);
cancelBt.removeActionListener(this);
}
catch (NullPointerException ex){/*all these might be null (for instance when poping up a GlyphFactory for the first time)*/}
cp.removeAll();
//main font panel
JPanel mainPanel=new JPanel();
GridBagLayout gridBag1=new GridBagLayout();
GridBagConstraints constraints1=new GridBagConstraints();
mainPanel.setLayout(gridBag1);
constraints1.fill=GridBagConstraints.BOTH;
constraints1.anchor=GridBagConstraints.CENTER;
familyList=new JList(allFontFamilies);
JScrollPane sp1=new JScrollPane(familyList);
buildConstraints(constraints1,0,0,1,1,30,100);
gridBag1.setConstraints(sp1,constraints1);
mainPanel.add(sp1);
styleList=new JList(allFontStyles);
JScrollPane sp2=new JScrollPane(styleList);
buildConstraints(constraints1,1,0,1,1,30,0);
gridBag1.setConstraints(sp2,constraints1);
mainPanel.add(sp2);
sizeList=new JList(allFontSizes);
JScrollPane sp3=new JScrollPane(sizeList);
buildConstraints(constraints1,2,0,1,1,25,0);
gridBag1.setConstraints(sp3,constraints1);
mainPanel.add(sp3);
//ok, cancel, reset buttons
JPanel btPanel=new JPanel();
btPanel.setLayout(new FlowLayout());
okBt=new JButton("OK");
okBt.addActionListener(this);
btPanel.add(okBt);
cancelBt=new JButton("Cancel");
cancelBt.addActionListener(this);
btPanel.add(cancelBt);
//main components
GridBagLayout gridBag=new GridBagLayout();
GridBagConstraints constraints=new GridBagConstraints();
cp.setLayout(gridBag);
constraints.fill=GridBagConstraints.BOTH;
constraints.anchor=GridBagConstraints.CENTER;
buildConstraints(constraints,0,0,1,1,100,99);
gridBag.setConstraints(mainPanel,constraints);
cp.add(mainPanel);
buildConstraints(constraints,0,1,1,1,100,1);
gridBag.setConstraints(btPanel,constraints);
cp.add(btPanel);
this.setSize(350,200);
this.setResizable(false);
familyList.setSelectedValue(DEFAULT_FAMILY,true);
if (DEFAULT_STYLE==Font.PLAIN){styleList.setSelectedValue("Plain",true);}
else if (DEFAULT_STYLE==Font.BOLD){styleList.setSelectedValue("Bold",true);}
else if (DEFAULT_STYLE==Font.ITALIC){styleList.setSelectedValue("Italic",true);}
else if (DEFAULT_STYLE==Font.BOLD+Font.ITALIC){styleList.setSelectedValue("BoldItalic",true);}
sizeList.setSelectedValue((new Integer(DEFAULT_SIZE)).toString(),true);
}
public void actionPerformed(ActionEvent e){
Object source=e.getSource();
if (source==okBt){
ft.setFont(getSelectedFont());
this.dispose();
}
else if (source==cancelBt){
ft.setFont(null);
this.dispose();
}
}

Font getSelectedFont(){
String family=(String)familyList.getSelectedValue();if (family==null){family=DEFAULT_FAMILY;}
String selectedStyle=(String)styleList.getSelectedValue();
int style;
if (selectedStyle.equals("Bold")){style=Font.BOLD;}
else if (selectedStyle.equals("Italic")){style=Font.ITALIC;}
else if (selectedStyle.equals("BoldItalic")){style=Font.BOLD+Font.ITALIC;}
else {style=Font.PLAIN;}//"Plain"
int size;
try {
String selectedSize=(String)sizeList.getSelectedValue();
size=Integer.parseInt(selectedSize);
if (size<=0){size=DEFAULT_SIZE;}
}
catch (NumberFormatException ex){size=DEFAULT_SIZE;}
return new Font(family,style,size);
}
static void buildConstraints(GridBagConstraints gbc, int gx,int gy,int gw,int gh,int wx,int wy){
gbc.gridx=gx;
gbc.gridy=gy;
gbc.gridwidth=gw;
gbc.gridheight=gh;
gbc.weightx=wx;
gbc.weighty=wy;
}

static class Closer extends WindowAdapter {
public void windowClosing(WindowEvent e) {
Window w = e.getWindow();
w.setVisible(false);
}
}
static class DisposeOnClose extends ComponentAdapter {
public void componentHidden(ComponentEvent e) {
Window w = (Window)e.getComponent();
w.dispose();
}
}
public static String getFontStyleName(int i){
if (i==java.awt.Font.BOLD){return "Bold";}
else if (i==java.awt.Font.ITALIC){return "Italic";}
else if (i==java.awt.Font.BOLD+java.awt.Font.ITALIC){return "BoldItalic";}
else {return "Plain";}
}
}
class FontTracker {
Font font;
public void setFont(Font f){
font=f;
}
public Font getFont() {
return font;
}
}

</source>



== Font Loader Dialog ==



<source lang="java">

/*
* FontLoaderDialog.java
*
* Created on November 13, 2006, 8:30 AM
*/

// Revised from jaspersoft designer
import java.lang.reflect.InvocationTargetException;
import javax.swing.SwingUtilities;
/**
*
* @author gtoffoli
*/
public class FontLoaderDialog extends javax.swing.JDialog {

/** Creates new form FontLoaderDialog */
public FontLoaderDialog(java.awt.Frame parent, boolean modal) {
super(parent, modal);
initComponents();
//applyI18n();
this.pack();

setLocationRelativeTo(null);
}

/** This method is called from within the constructor to
* initialize the form.
* WARNING: Do NOT modify this code. The content of this method is
* always regenerated by the Form Editor.
*/
// <editor-fold defaultstate="collapsed" desc="Generated Code">//GEN-BEGIN:initComponents
private void initComponents() {
java.awt.GridBagConstraints gridBagConstraints;
jLabelStatus = new javax.swing.JLabel();
setDefaultCloseOperation(javax.swing.WindowConstants.DISPOSE_ON_CLOSE);
getContentPane().setLayout(new java.awt.GridBagLayout());
jLabelStatus.setText("FontLoaderDialog.Label.LoadingStatus"); // NOI18N
jLabelStatus.setVerticalAlignment(javax.swing.SwingConstants.TOP);
jLabelStatus.setPreferredSize(new java.awt.Dimension(391, 51));
gridBagConstraints = new java.awt.GridBagConstraints();
gridBagConstraints.fill = java.awt.GridBagConstraints.BOTH;
gridBagConstraints.weightx = 1.0;
gridBagConstraints.weighty = 1.0;
gridBagConstraints.insets = new java.awt.Insets(4, 4, 4, 4);
getContentPane().add(jLabelStatus, gridBagConstraints);
pack();
}// </editor-fold>//GEN-END:initComponents

public void setStatus(String s)
{
jLabelStatus.setText(s);
}

public void fontsLoadingStatusUpdated(String statusMsg) {

final String s = statusMsg;
try {
SwingUtilities.invokeAndWait( new Runnable()
{
public void run()
{
setStatus(s);
}
}
);
} catch (InterruptedException ex) {
ex.printStackTrace();
} catch (InvocationTargetException ex) {
ex.printStackTrace();
}

}
public void fontsLoadingStarted() {

try {
SwingUtilities.invokeAndWait( new Runnable()
{
public void run()
{
setVisible(true);
}
}
);
} catch (InterruptedException ex) {
ex.printStackTrace();
} catch (InvocationTargetException ex) {
ex.printStackTrace();
}
}
public void fontsLoadingFinished() {
try {
SwingUtilities.invokeAndWait( new Runnable()
{
public void run()
{
setVisible(false);
}
}
);
} catch (InterruptedException ex) {
ex.printStackTrace();
} catch (InvocationTargetException ex) {
ex.printStackTrace();
}
}

// Variables declaration - do not modify//GEN-BEGIN:variables
private javax.swing.JLabel jLabelStatus;
// End of variables declaration//GEN-END:variables

// public void applyI18n(){
// // Start autogenerated code ----------------------
// jLabelStatus.setText(I18n.getString("fontLoaderDialog.labelStatus","Loading status"));
// // End autogenerated code ----------------------
// }
}

</source>



== JFont Chooser ==



<source lang="java">

// revised from greef ui
import java.awt.BorderLayout;
import java.awt.ruponent;
import java.awt.Container;
import java.awt.FlowLayout;
import java.awt.Font;
import java.awt.GraphicsEnvironment;
import java.awt.GridBagConstraints;
import java.awt.GridBagLayout;
import java.awt.HeadlessException;
import java.awt.Insets;
import java.awt.Window;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.awt.event.ruponentAdapter;
import java.awt.event.ruponentEvent;
import java.awt.event.KeyEvent;
import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;
import java.io.Serializable;
import javax.swing.AbstractAction;
import javax.swing.Action;
import javax.swing.ActionMap;
import javax.swing.InputMap;
import javax.swing.JButton;
import javax.swing.JCheckBox;
import javax.swing.JComponent;
import javax.swing.JDialog;
import javax.swing.JLabel;
import javax.swing.JList;
import javax.swing.JOptionPane;
import javax.swing.JPanel;
import javax.swing.JScrollPane;
import javax.swing.KeyStroke;
import javax.swing.ListSelectionModel;
import javax.swing.UIManager;
import javax.swing.event.ChangeEvent;
import javax.swing.event.ChangeListener;
import javax.swing.event.EventListenerList;
import javax.swing.event.ListSelectionEvent;
import javax.swing.event.ListSelectionListener;
/**
* <code>JFontChooser</code> provides a pane of controls designed to allow
* a user to manipulate and select a font.
*
* This class provides three levels of API:
* <ol>
* <li>A static convenience method which shows a modal font-chooser
* dialog and returns the font selected by the user.
* <li>A static convenience method for creating a font-chooser dialog
* where <code>ActionListeners</code> can be specified to be invoked when
* the user presses one of the dialog buttons.
* <li>The ability to create instances of <code>JFontChooser</code> panes
* directly (within any container). <code>PropertyChange</code> listeners
* can be added to detect when the current "font" property changes.
* </ol>
* <p>
*
* @author Adrian BER
*/
public class JFontChooser extends JComponent {
/** The list of possible font sizes. */
private static final Integer[] SIZES =
{8, 9, 10, 11, 12, 13, 14, 16, 18, 20, 24, 26, 28, 32, 36, 40, 48, 56, 64, 72};
/** The list of possible fonts. */
private static final String[] FONTS = GraphicsEnvironment.getLocalGraphicsEnvironment()
.getAvailableFontFamilyNames();

private FontSelectionModel selectionModel;
private JList fontList;
private JList sizeList;
private JCheckBox boldCheckBox;
private JCheckBox italicCheckBox;
private JLabel previewLabel;
/** The preview text, if null the font name will be the preview text. */
private String previewText;
/** Listener used to update the font of the selection model. */
private SelectionUpdater selectionUpdater = new SelectionUpdater();
/** Listener used to update the font in the components. This should be registered
* with the selection model. */
private LabelUpdater labelUpdater = new LabelUpdater();
/** True if the components are being updated and no event should be generated. */
private boolean updatingComponents = false;
/** Listener class used to update the font in the components. This should be registered
* with the selection model. */
private class LabelUpdater implements ChangeListener {
public void stateChanged(ChangeEvent e) {
updateComponents();
}
}
/** Listener class used to update the font of the preview label. */
private class SelectionUpdater implements ChangeListener, ListSelectionListener {
public void stateChanged(ChangeEvent e) {
if (!updatingComponents) {
setFont(buildFont());
}
}
public void valueChanged(ListSelectionEvent e) {
if (!updatingComponents) {
setFont(buildFont());
}
}
}
/**
* Shows a modal font-chooser dialog and blocks until the
* dialog is hidden. If the user presses the "OK" button, then
* this method hides/disposes the dialog and returns the selected color.
* If the user presses the "Cancel" button or closes the dialog without
* pressing "OK", then this method hides/disposes the dialog and returns
* <code>null</code>.
*
* @param component the parent <code>Component</code> for the dialog
* @param title the String containing the dialog"s title
* @return the selected font or <code>null</code> if the user opted out
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true.
* @see java.awt.GraphicsEnvironment#isHeadless
*/
public Font showDialog(Component component, String title) {
FontTracker ok = new FontTracker(this);
JDialog dialog = createDialog(component, title, true, ok, null);
dialog.addWindowListener(new FontChooserDialog.Closer());
dialog.addComponentListener(new FontChooserDialog.DisposeOnClose());
dialog.setVisible(true); // blocks until user brings dialog down...
return ok.getFont();
}

/**
* Creates and returns a new dialog containing the specified
* <code>ColorChooser</code> pane along with "OK", "Cancel", and "Reset"
* buttons. If the "OK" or "Cancel" buttons are pressed, the dialog is
* automatically hidden (but not disposed). If the "Reset"
* button is pressed, the color-chooser"s color will be reset to the
* font which was set the last time <code>show</code> was invoked on the
* dialog and the dialog will remain showing.
*
* @param c the parent component for the dialog
* @param title the title for the dialog
* @param modal a boolean. When true, the remainder of the program
* is inactive until the dialog is closed.
* @param okListener the ActionListener invoked when "OK" is pressed
* @param cancelListener the ActionListener invoked when "Cancel" is pressed
* @return a new dialog containing the font-chooser pane
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true.
* @see java.awt.GraphicsEnvironment#isHeadless
*/
public JDialog createDialog(Component c, String title, boolean modal,
ActionListener okListener, ActionListener cancelListener) {
return new FontChooserDialog(c, title, modal, this,
okListener, cancelListener);
}
/**
* Creates a color chooser pane with an initial font which is the same font
* as the default font for labels.
*/
public JFontChooser() {
this(new DefaultFontSelectionModel());
}
/**
* Creates a font chooser pane with the specified initial font.
*
* @param initialFont the initial font set in the chooser
*/
public JFontChooser(Font initialFont) {
this(new DefaultFontSelectionModel(initialFont));
}
/**
* Creates a font chooser pane with the specified
* <code>FontSelectionModel</code>.
*
* @param model the font selection model used by this component
*/
public JFontChooser(FontSelectionModel model) {
selectionModel = model;
init(model.getSelectedFont());
selectionModel.addChangeListener(labelUpdater);
}
private void init(Font font) {
setLayout(new GridBagLayout());
Insets ins = new Insets(2, 2, 2, 2);
fontList = new JList(FONTS);
fontList.setVisibleRowCount(10);
fontList.setSelectionMode(ListSelectionModel.SINGLE_SELECTION);
add(new JScrollPane(fontList), new GridBagConstraints(0, 0, 1, 1, 2, 2,
GridBagConstraints.CENTER, GridBagConstraints.BOTH,
ins, 0, 0));
sizeList = new JList(SIZES);
((JLabel)sizeList.getCellRenderer()).setHorizontalAlignment(JLabel.RIGHT);
sizeList.setVisibleRowCount(10);
sizeList.setSelectionMode(ListSelectionModel.SINGLE_SELECTION);
add(new JScrollPane(sizeList), new GridBagConstraints(1, 0, 1, 1, 1, 2,
GridBagConstraints.CENTER, GridBagConstraints.BOTH,
ins, 0, 0));
boldCheckBox = new JCheckBox("Bold");
add(boldCheckBox, new GridBagConstraints(0, 1, 2, 1, 1, 0,
GridBagConstraints.WEST, GridBagConstraints.NONE,
ins, 0, 0));
italicCheckBox = new JCheckBox("Italic");
add(italicCheckBox, new GridBagConstraints(0, 2, 2, 1, 1, 0,
GridBagConstraints.WEST, GridBagConstraints.NONE,
ins, 0, 0));
previewLabel = new JLabel("");
previewLabel.setHorizontalAlignment(JLabel.CENTER);
previewLabel.setVerticalAlignment(JLabel.CENTER);
add(new JScrollPane(previewLabel), new GridBagConstraints(0, 3, 2, 1, 1, 1,
GridBagConstraints.CENTER, GridBagConstraints.BOTH,
ins, 0, 0));
setFont(font == null ? previewLabel.getFont() : font);
fontList.addListSelectionListener(selectionUpdater);
sizeList.addListSelectionListener(selectionUpdater);
boldCheckBox.addChangeListener(selectionUpdater);
italicCheckBox.addChangeListener(selectionUpdater);
}
private Font buildFont() {
// Font labelFont = previewLabel.getFont();
String fontName = (String)fontList.getSelectedValue();
if (fontName == null) {
return null;
// fontName = labelFont.getName();
}
Integer sizeInt = (Integer)sizeList.getSelectedValue();
if (sizeInt == null) {
// size = labelFont.getSize();
return null;
}
// create the font
// // first create the font attributes
// HashMap map = new HashMap();
// map.put(TextAttribute.BACKGROUND, Color.white);
// map.put(TextAttribute.FAMILY, fontName);
// map.put(TextAttribute.FOREGROUND, Color.black);
// map.put(TextAttribute.SIZE , new Float(size));
// map.put(TextAttribute.UNDERLINE, italicCheckBox.isSelected() ? TextAttribute.UNDERLINE_LOW_ONE_PIXEL : TextAttribute.UNDERLINE_LOW_TWO_PIXEL);
// map.put(TextAttribute.STRIKETHROUGH, italicCheckBox.isSelected() ? TextAttribute.STRIKETHROUGH_ON : Boolean.FALSE);
// map.put(TextAttribute.WEIGHT, boldCheckBox.isSelected() ? TextAttribute.WEIGHT_BOLD : TextAttribute.WEIGHT_REGULAR);
// map.put(TextAttribute.POSTURE,
// italicCheckBox.isSelected() ? TextAttribute.POSTURE_OBLIQUE : TextAttribute.POSTURE_REGULAR);
//
// return new Font(map);
return new Font(fontName,
(italicCheckBox.isSelected() ? Font.ITALIC : Font.PLAIN)
| (boldCheckBox.isSelected() ? Font.BOLD : Font.PLAIN),
sizeInt);
}
/** Updates the font in the preview component according to the selected values. */
private void updateComponents() {
updatingComponents = true;
Font font = getFont();
fontList.setSelectedValue(font.getName(), true);
sizeList.setSelectedValue(font.getSize(), true);
boldCheckBox.setSelected(font.isBold());
italicCheckBox.setSelected(font.isItalic());
if (previewText == null) {
previewLabel.setText(font.getName());
}
// set the font and fire a property change
Font oldValue = previewLabel.getFont();
previewLabel.setFont(font);
firePropertyChange("font", oldValue, font);
updatingComponents = false;
}
/**
* Returns the data model that handles font selections.
*
* @return a FontSelectionModel object
*/
public FontSelectionModel getSelectionModel() {
return selectionModel;
}

/**
* Set the model containing the selected font.
*
* @param newModel the new FontSelectionModel object
*/
public void setSelectionModel(FontSelectionModel newModel ) {
FontSelectionModel oldModel = selectionModel;
selectionModel = newModel;
oldModel.removeChangeListener(labelUpdater);
newModel.addChangeListener(labelUpdater);
firePropertyChange("selectionModel", oldModel, newModel);
}
/**
* Gets the current font value from the font chooser.
*
* @return the current font value of the font chooser
*/
public Font getFont() {
return selectionModel.getSelectedFont();
}
/**
* Sets the current font of the font chooser to the specified font.
* The <code>ColorSelectionModel</code> will fire a <code>ChangeEvent</code>
* @param font the font to be set in the font chooser
* @see JComponent#addPropertyChangeListener
*/
public void setFont(Font font) {
selectionModel.setSelectedFont(font);
}
/** Returns the preview text displayed in the preview component.
* @return the preview text, if null the font name will be displayed
*/
public String getPreviewText() {
return previewText;
}
/** Sets the preview text displayed in the preview component.
* @param previewText the preview text, if null the font name will be displayed
*/
public void setPreviewText(String previewText) {
this.previewText = previewText;
previewLabel.setText("");
updateComponents();
}
}

/*
* Class which builds a font chooser dialog consisting of
* a JFontChooser with "Ok", "Cancel", and "Reset" buttons.
*
* Note: This needs to be fixed to deal with localization!
*/
class FontChooserDialog extends JDialog {
private Font initialFont;
private JFontChooser chooserPane;
public FontChooserDialog(Component c, String title, boolean modal,
JFontChooser chooserPane,
ActionListener okListener, ActionListener cancelListener) {
super(JOptionPane.getFrameForComponent(c), title, modal);
//setResizable(false);
String okString = UIManager.getString("ColorChooser.okText");
String cancelString = UIManager.getString("ColorChooser.cancelText");
String resetString = UIManager.getString("ColorChooser.resetText");
/*
* Create Lower button panel
*/
JPanel buttonPane = new JPanel();
buttonPane.setLayout(new FlowLayout(FlowLayout.CENTER));
JButton okButton = new JButton(okString);
getRootPane().setDefaultButton(okButton);
okButton.setActionCommand("OK");
if (okListener != null) {
okButton.addActionListener(okListener);
}
okButton.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
setVisible(false);
}
});
buttonPane.add(okButton);
JButton cancelButton = new JButton(cancelString);
// The following few lines are used to register esc to close the dialog
Action cancelKeyAction = new AbstractAction() {
public void actionPerformed(ActionEvent e) {
// todo make it in 1.3
// ActionListener[] listeners
// = ((AbstractButton) e.getSource()).getActionListeners();
// for (int i = 0; i < listeners.length; i++) {
// listeners[i].actionPerformed(e);
// }
}
};
KeyStroke cancelKeyStroke = KeyStroke.getKeyStroke((char) KeyEvent.VK_ESCAPE);
InputMap inputMap = cancelButton.getInputMap(JComponent.WHEN_IN_FOCUSED_WINDOW);
ActionMap actionMap = cancelButton.getActionMap();
if (inputMap != null && actionMap != null) {
inputMap.put(cancelKeyStroke, "cancel");
actionMap.put("cancel", cancelKeyAction);
}
// end esc handling
cancelButton.setActionCommand("cancel");
if (cancelListener != null) {
cancelButton.addActionListener(cancelListener);
}
cancelButton.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
setVisible(false);
}
});
buttonPane.add(cancelButton);
JButton resetButton = new JButton(resetString);
resetButton.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
reset();
}
});
int mnemonic = UIManager.getInt("ColorChooser.resetMnemonic");
if (mnemonic != -1) {
resetButton.setMnemonic(mnemonic);
}
buttonPane.add(resetButton);

// initialiase the content pane
this.chooserPane = chooserPane;
Container contentPane = getContentPane();
contentPane.setLayout(new BorderLayout());
contentPane.add(chooserPane, BorderLayout.CENTER);
contentPane.add(buttonPane, BorderLayout.SOUTH);
pack();
setLocationRelativeTo(c);
}
public void setVisible(boolean visible) {
if (visible)
initialFont = chooserPane.getFont();
super.setVisible(visible);
}
public void reset() {
chooserPane.setFont(initialFont);
}
static class Closer extends WindowAdapter implements Serializable {
public void windowClosing(WindowEvent e) {
Window w = e.getWindow();
w.setVisible(false);
}
}
static class DisposeOnClose extends ComponentAdapter implements Serializable {
public void componentHidden(ComponentEvent e) {
Window w = (Window) e.getComponent();
w.dispose();
}
}
}
class FontTracker implements ActionListener, Serializable {
JFontChooser chooser;
Font color;
public FontTracker(JFontChooser c) {
chooser = c;
}
public void actionPerformed(ActionEvent e) {
color = chooser.getFont();
}
public Font getFont() {
return color;
}
}

/**
* A generic implementation of <code>{@link FontSelectionModel}</code>.
*
* @author Adrian BER
*/
class DefaultFontSelectionModel implements FontSelectionModel {
/** The default selected font. */
private static final Font DEFAULT_INITIAL_FONT = new Font("Dialog", Font.PLAIN, 12);

/** The selected font. */
private Font selectedFont;
/** The change listeners notified by a change in this model. */
private EventListenerList listeners = new EventListenerList();
/**
* Creates a <code>DefaultFontSelectionModel</code> with the
* current font set to <code>Dialog, 12</code>. This is
* the default constructor.
*/
public DefaultFontSelectionModel() {
this(DEFAULT_INITIAL_FONT);
}
/**
* Creates a <code>DefaultFontSelectionModel</code> with the
* current font set to <code>font</code>, which should be
* non-<code>null</code>. Note that setting the font to
* <code>null</code> is undefined and may have unpredictable
* results.
*
* @param selectedFont the new <code>Font</code>
*/
public DefaultFontSelectionModel(Font selectedFont) {
if (selectedFont == null) {
selectedFont = DEFAULT_INITIAL_FONT;
}
this.selectedFont = selectedFont;
}
public Font getSelectedFont() {
return selectedFont;
}
public void setSelectedFont(Font selectedFont) {
if (selectedFont != null) {
this.selectedFont = selectedFont;
fireChangeListeners();
}
}
public void addChangeListener(ChangeListener listener) {
listeners.add(ChangeListener.class, listener);
}
public void removeChangeListener(ChangeListener listener) {
listeners.remove(ChangeListener.class, listener);
}
/** Fires the listeners registered with this model. */
protected void fireChangeListeners() {
ChangeEvent ev = new ChangeEvent(this);
Object[] l = listeners.getListeners(ChangeListener.class);
for (Object listener : l) {
((ChangeListener) listener).stateChanged(ev);
}
}
}

/**
* A model that supports selecting a <code>Font</code>.
*
* @author Adrian BER
*
* @see java.awt.Font
*/
interface FontSelectionModel {
/**
* Returns the selected <code>Font</code> which should be
* non-<code>null</code>.
*
* @return the selected <code>Font</code>
* @see #setSelectedFont
*/
Font getSelectedFont();
/**
* Sets the selected font to <code>font</code>.
* Note that setting the font to <code>null</code>
* is undefined and may have unpredictable results.
* This method fires a state changed event if it sets the
* current font to a new non-<code>null</code> font.
*
* @param font the new <code>Font</code>
* @see #getSelectedFont
* @see #addChangeListener
*/
void setSelectedFont(Font font);
/**
* Adds <code>listener</code> as a listener to changes in the model.
* @param listener the <code>ChangeListener</code> to be added
*/
void addChangeListener(ChangeListener listener);
/**
* Removes <code>listener</code> as a listener to changes in the model.
* @param listener the <code>ChangeListener</code> to be removed
*/
void removeChangeListener(ChangeListener listener);
}
//////////////////////////////
package com.greef.ui.font;
import com.greef.ui.UIUtilities;
import javax.swing.*;
import javax.swing.event.ChangeListener;
import javax.swing.event.ChangeEvent;
import javax.swing.event.DocumentListener;
import javax.swing.event.DocumentEvent;
import java.awt.*;
import java.awt.event.ActionListener;
import java.awt.event.ActionEvent;
/**
* @author Adrian BER (beradrian@yahoo.ru)
*/
public class JFontChooserDemo extends JPanel {
private static final Insets INSETS = new Insets(5, 5, 5, 5);
private JFontChooser fontChooser;
private JCheckBox defaultPreviewCheckBox;
private JTextField previewTextField;
private JLabel previewLabel;
private JTextArea codeTextArea;
public JFontChooserDemo() {
init();
}
private void init() {
setLayout(new GridBagLayout());
defaultPreviewCheckBox = new JCheckBox("Use font name as the preview text");
defaultPreviewCheckBox.addChangeListener(new ChangeListener() {
public void stateChanged(ChangeEvent e) {
boolean selected = defaultPreviewCheckBox.isSelected();
fontChooser.setPreviewText(selected ? null : previewTextField.getText());
previewLabel.setEnabled(!selected);
previewTextField.setEnabled(!selected);
updateCode();
}
});
add(defaultPreviewCheckBox, new GridBagConstraints(0, 0, 2, 1, 0, 0, GridBagConstraints.WEST,
GridBagConstraints.NONE, INSETS, 0, 0));
previewLabel = new JLabel("Preview text:");
add(previewLabel, new GridBagConstraints(0, 1, 1, 1, 0, 0, GridBagConstraints.EAST,
GridBagConstraints.NONE, INSETS, 0, 0));
previewTextField = new JTextField();
previewTextField.getDocument().addDocumentListener(new DocumentListener() {
private void changePreviewText() {
fontChooser.setPreviewText(previewTextField.getText());
updateCode();
}
public void insertUpdate(DocumentEvent e) {
changePreviewText();
}
public void removeUpdate(DocumentEvent e) {
changePreviewText();
}
public void changedUpdate(DocumentEvent e) {
changePreviewText();
}
});
add(previewTextField, new GridBagConstraints(1, 1, 1, 1, 1, 0, GridBagConstraints.WEST,
GridBagConstraints.HORIZONTAL, INSETS, 0, 0));
JButton testButton = new JButton("Test");
testButton.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
Font font = fontChooser.showDialog(JFontChooserDemo.this, "Choose a font");
JOptionPane.showMessageDialog(JFontChooserDemo.this, font == null ? "You canceled the dialog."
: "You have selected " + font.getName() + ", " + font.getSize()
+ (font.isBold() ? ", Bold" : "") + (font.isItalic() ? ", Italic" : ""));
}
});
add(testButton, new GridBagConstraints(0, 2, 2, 1, 1, 0, GridBagConstraints.NORTHEAST,
GridBagConstraints.NONE, INSETS, 0, 0));
codeTextArea = new JTextArea(5, 30);
codeTextArea.setOpaque(false);
codeTextArea.setEditable(false);
codeTextArea.setBorder(BorderFactory.createTitledBorder("Code"));
add(codeTextArea, new GridBagConstraints(0, 3, 2, 1, 1, 1, GridBagConstraints.CENTER,
GridBagConstraints.BOTH, INSETS, 0, 0));
setFontChooser(new JFontChooser());
}
private void setFontChooser(JFontChooser fontChooser) {
this.fontChooser = fontChooser;
String previewText = fontChooser.getPreviewText();
defaultPreviewCheckBox.setSelected(previewText == null);
previewTextField.setText(previewText);
updateCode();
}
private void updateCode() {
codeTextArea.setText("JFontChooser fontChooser = new JFontChooser();\n"
+ (defaultPreviewCheckBox.isSelected() ? "" : "fontChooser.setPreviewText(\""
+ previewTextField.getText() + "\");\n")
+ "Font font = fontChooser.showDialog(invokerComponent, \"Choose a font\");\n"
+ "System.out.println(font == null ? \"You have canceled the dialog.\" : \"You have selected \" + font);");
}
public void updateUI() {
super.updateUI();
if (fontChooser != null)
SwingUtilities.updateComponentTreeUI(fontChooser);
}
}

</source>



== JFreeChart: Font Dialog ==

== Word like special font chooser ==



<source lang="java">

/*
* @(#)Font2DTest.java 1.28 05/11/17
*
* Copyright (c) 2006 Sun Microsystems, Inc. All Rights Reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* -Redistribution of source code must retain the above copyright notice, this
* list of conditions and the following disclaimer.
*
* -Redistribution in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* Neither the name of Sun Microsystems, Inc. or the names of contributors may
* be used to endorse or promote products derived from this software without
* specific prior written permission.
*
* This software is provided "AS IS," without a warranty of any kind. ALL
* EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING
* ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
* OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN MIDROSYSTEMS, INC. ("SUN")
* AND ITS LICENSORS SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE
* AS A RESULT OF USING, MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS
* DERIVATIVES. IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR ANY LOST
* REVENUE, PROFIT OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL,
* INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY
* OF LIABILITY, ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE,
* EVEN IF SUN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
*
* You acknowledge that this software is not designed, licensed or intended
* for use in the design, construction, operation or maintenance of any
* nuclear facility.
*/
/*
* @(#)Font2DTest.java 1.28 05/11/17
*/
import static java.awt.RenderingHints.KEY_ANTIALIASING;
import static java.awt.RenderingHints.KEY_FRACTIONALMETRICS;
import static java.awt.RenderingHints.KEY_TEXT_ANTIALIASING;
import static java.awt.RenderingHints.KEY_TEXT_LCD_CONTRAST;
import static java.awt.RenderingHints.VALUE_ANTIALIAS_OFF;
import static java.awt.RenderingHints.VALUE_ANTIALIAS_ON;
import static java.awt.RenderingHints.VALUE_FRACTIONALMETRICS_DEFAULT;
import static java.awt.RenderingHints.VALUE_FRACTIONALMETRICS_OFF;
import static java.awt.RenderingHints.VALUE_FRACTIONALMETRICS_ON;
import static java.awt.RenderingHints.VALUE_TEXT_ANTIALIAS_DEFAULT;
import static java.awt.RenderingHints.VALUE_TEXT_ANTIALIAS_GASP;
import static java.awt.RenderingHints.VALUE_TEXT_ANTIALIAS_LCD_HBGR;
import static java.awt.RenderingHints.VALUE_TEXT_ANTIALIAS_LCD_HRGB;
import static java.awt.RenderingHints.VALUE_TEXT_ANTIALIAS_LCD_VBGR;
import static java.awt.RenderingHints.VALUE_TEXT_ANTIALIAS_LCD_VRGB;
import static java.awt.RenderingHints.VALUE_TEXT_ANTIALIAS_OFF;
import static java.awt.RenderingHints.VALUE_TEXT_ANTIALIAS_ON;
import java.awt.BorderLayout;
import java.awt.Color;
import java.awt.ruponent;
import java.awt.Container;
import java.awt.Cursor;
import java.awt.Dimension;
import java.awt.Font;
import java.awt.FontMetrics;
import java.awt.Graphics;
import java.awt.Graphics2D;
import java.awt.GraphicsConfiguration;
import java.awt.GraphicsEnvironment;
import java.awt.GridBagConstraints;
import java.awt.GridBagLayout;
import java.awt.GridLayout;
import java.awt.Insets;
import java.awt.Point;
import java.awt.RenderingHints;
import java.awt.Toolkit;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.awt.event.AdjustmentEvent;
import java.awt.event.AdjustmentListener;
import java.awt.event.ruponentAdapter;
import java.awt.event.ruponentEvent;
import java.awt.event.ItemEvent;
import java.awt.event.ItemListener;
import java.awt.event.MouseEvent;
import java.awt.event.MouseListener;
import java.awt.event.MouseMotionListener;
import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;
import java.awt.font.FontRenderContext;
import java.awt.font.GlyphVector;
import java.awt.font.LineBreakMeasurer;
import java.awt.font.TextLayout;
import java.awt.geom.AffineTransform;
import java.awt.geom.NoninvertibleTransformException;
import java.awt.geom.Rectangle2D;
import java.awt.image.BufferedImage;
import java.awt.print.PageFormat;
import java.awt.print.Printable;
import java.awt.print.PrinterJob;
import java.io.BufferedInputStream;
import java.io.BufferedOutputStream;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.text.AttributedString;
import java.util.BitSet;
import java.util.EnumSet;
import java.util.StringTokenizer;
import java.util.Vector;
import javax.imageio.ImageIO;
import javax.swing.ButtonGroup;
import javax.swing.DefaultListCellRenderer;
import javax.swing.ImageIcon;
import javax.swing.JButton;
import javax.swing.JCheckBoxMenuItem;
import javax.swing.JComboBox;
import javax.swing.JComponent;
import javax.swing.JDialog;
import javax.swing.JFileChooser;
import javax.swing.JFrame;
import javax.swing.JLabel;
import javax.swing.JList;
import javax.swing.JMenu;
import javax.swing.JMenuBar;
import javax.swing.JMenuItem;
import javax.swing.JPanel;
import javax.swing.JRadioButton;
import javax.swing.JScrollBar;
import javax.swing.JScrollPane;
import javax.swing.JSlider;
import javax.swing.JTextArea;
import javax.swing.JTextField;
import javax.swing.JWindow;
import javax.swing.UIManager;
import javax.swing.event.ChangeEvent;
import javax.swing.event.ChangeListener;
/**
* Font2DTest.java
*
* @version
* @(#)Font2DTest.java 1.2 00/08/22
* @author Shinsuke Fukuda
* @author Ankit Patel [Conversion to Swing - 01/07/30]
*/
// / Main Font2DTest Class
public final class Font2DTest extends JPanel implements ActionListener, ItemListener,
ChangeListener {
// / JFrame that will contain Font2DTest
private final JFrame parent;
// / FontPanel class that will contain all graphical output
private final FontPanel fp;
// / RangeMenu class that contains info about the unicode ranges
private final RangeMenu rm;
// / Other menus to set parameters for text drawing
private final ChoiceV2 fontMenu;
private final JTextField sizeField;
private final ChoiceV2 styleMenu;
private final ChoiceV2 textMenu;
private int currentTextChoice = 0;
private final ChoiceV2 transformMenu;
private final ChoiceV2 transformMenuG2;
private final ChoiceV2 methodsMenu;
private final JComboBox antiAliasMenu;
private final JComboBox fracMetricsMenu;
private final JSlider contrastSlider;
// / CheckboxMenuItems
private CheckboxMenuItemV2 displayGridCBMI;
private CheckboxMenuItemV2 force16ColsCBMI;
private CheckboxMenuItemV2 showFontInfoCBMI;
// / JDialog boxes
private JDialog userTextDialog;
private JTextArea userTextArea;
private JDialog printDialog;
private JDialog fontInfoDialog;
private LabelV2 fontInfos[] = new LabelV2[2];
private JFileChooser filePromptDialog = null;
private ButtonGroup printCBGroup;
private JRadioButton printModeCBs[] = new JRadioButton[3];
// / Status bar
private final LabelV2 statusBar;
private int fontStyles[] = { Font.PLAIN, Font.BOLD, Font.ITALIC, Font.BOLD | Font.ITALIC };
// / Text filename
private String tFileName;
// Enabled or disabled status of canDisplay check
private static boolean canDisplayCheck = true;
// / Initialize GUI variables and its layouts
public Font2DTest(JFrame f, boolean isApplet) {
parent = f;
rm = new RangeMenu(this, parent);
fp = new FontPanel(this, parent);
statusBar = new LabelV2("");
fontMenu = new ChoiceV2(this, canDisplayCheck);
sizeField = new JTextField("12", 3);
sizeField.addActionListener(this);
styleMenu = new ChoiceV2(this);
textMenu = new ChoiceV2(); // listener added later
transformMenu = new ChoiceV2(this);
transformMenuG2 = new ChoiceV2(this);
methodsMenu = new ChoiceV2(this);
antiAliasMenu = new JComboBox(EnumSet.allOf(FontPanel.AAValues.class).toArray());
antiAliasMenu.addActionListener(this);
fracMetricsMenu = new JComboBox(EnumSet.allOf(FontPanel.FMValues.class).toArray());
fracMetricsMenu.addActionListener(this);
contrastSlider = new JSlider(JSlider.HORIZONTAL, 100, 250, FontPanel.getDefaultLCDContrast()
.intValue());
contrastSlider.setEnabled(false);
contrastSlider.setMajorTickSpacing(20);
contrastSlider.setMinorTickSpacing(10);
contrastSlider.setPaintTicks(true);
contrastSlider.setPaintLabels(true);
contrastSlider.addChangeListener(this);
setupPanel();
setupMenu(isApplet);
setupDialog(isApplet);
if (canDisplayCheck) {
fireRangeChanged();
}
}
// / Set up the main interface panel
private void setupPanel() {
GridBagLayout gbl = new GridBagLayout();
GridBagConstraints gbc = new GridBagConstraints();
gbc.fill = GridBagConstraints.HORIZONTAL;
gbc.weightx = 1;
gbc.insets = new Insets(2, 0, 2, 2);
this.setLayout(gbl);
addLabeledComponentToGBL("Font: ", fontMenu, gbl, gbc, this);
addLabeledComponentToGBL("Size: ", sizeField, gbl, gbc, this);
gbc.gridwidth = GridBagConstraints.REMAINDER;
addLabeledComponentToGBL("Font Transform:", transformMenu, gbl, gbc, this);
gbc.gridwidth = 1;
addLabeledComponentToGBL("Range: ", rm, gbl, gbc, this);
addLabeledComponentToGBL("Style: ", styleMenu, gbl, gbc, this);
gbc.gridwidth = GridBagConstraints.REMAINDER;
addLabeledComponentToGBL("Graphics Transform: ", transformMenuG2, gbl, gbc, this);
gbc.gridwidth = 1;
gbc.anchor = GridBagConstraints.WEST;
addLabeledComponentToGBL("Method: ", methodsMenu, gbl, gbc, this);
addLabeledComponentToGBL("", null, gbl, gbc, this);
gbc.anchor = GridBagConstraints.EAST;
gbc.gridwidth = GridBagConstraints.REMAINDER;
addLabeledComponentToGBL("Text to use:", textMenu, gbl, gbc, this);
gbc.weightx = 1;
gbc.gridwidth = 1;
gbc.fill = GridBagConstraints.HORIZONTAL;
gbc.anchor = GridBagConstraints.WEST;
addLabeledComponentToGBL("LCD contrast: ", contrastSlider, gbl, gbc, this);
gbc.gridwidth = 1;
gbc.fill = GridBagConstraints.NONE;
addLabeledComponentToGBL("Antialiasing: ", antiAliasMenu, gbl, gbc, this);
gbc.anchor = GridBagConstraints.EAST;
gbc.gridwidth = GridBagConstraints.REMAINDER;
addLabeledComponentToGBL("Fractional metrics: ", fracMetricsMenu, gbl, gbc, this);
gbc.weightx = 1;
gbc.weighty = 1;
gbc.anchor = GridBagConstraints.WEST;
gbc.insets = new Insets(2, 0, 0, 2);
gbc.fill = GridBagConstraints.BOTH;
gbl.setConstraints(fp, gbc);
this.add(fp);
gbc.weighty = 0;
gbc.insets = new Insets(0, 2, 0, 0);
gbl.setConstraints(statusBar, gbc);
this.add(statusBar);
}
// / Adds a component to a container with a label to its left in GridBagLayout
private void addLabeledComponentToGBL(String name, JComponent c, GridBagLayout gbl,
GridBagConstraints gbc, Container target) {
LabelV2 l = new LabelV2(name);
GridBagConstraints gbcLabel = (GridBagConstraints) gbc.clone();
gbcLabel.insets = new Insets(2, 2, 2, 0);
gbcLabel.gridwidth = 1;
gbcLabel.weightx = 0;
if (c == null)
c = new JLabel("");
gbl.setConstraints(l, gbcLabel);
target.add(l);
gbl.setConstraints(c, gbc);
target.add(c);
}
// / Sets up menu entries
private void setupMenu(boolean isApplet) {
JMenu fileMenu = new JMenu("File");
JMenu optionMenu = new JMenu("Option");
fileMenu.add(new MenuItemV2("Save Selected Options...", this));
fileMenu.add(new MenuItemV2("Load Options...", this));
fileMenu.addSeparator();
fileMenu.add(new MenuItemV2("Save as PNG...", this));
fileMenu.add(new MenuItemV2("Load PNG File to Compare...", this));
fileMenu.add(new MenuItemV2("Page Setup...", this));
fileMenu.add(new MenuItemV2("Print...", this));
fileMenu.addSeparator();
if (!isApplet)
fileMenu.add(new MenuItemV2("Exit", this));
else
fileMenu.add(new MenuItemV2("Close", this));
displayGridCBMI = new CheckboxMenuItemV2("Display Grid", true, this);
force16ColsCBMI = new CheckboxMenuItemV2("Force 16 Columns", false, this);
showFontInfoCBMI = new CheckboxMenuItemV2("Display Font Info", false, this);
optionMenu.add(displayGridCBMI);
optionMenu.add(force16ColsCBMI);
optionMenu.add(showFontInfoCBMI);
JMenuBar mb = parent.getJMenuBar();
if (mb == null)
mb = new JMenuBar();
mb.add(fileMenu);
mb.add(optionMenu);
parent.setJMenuBar(mb);
String fontList[] = GraphicsEnvironment.getLocalGraphicsEnvironment()
.getAvailableFontFamilyNames();
for (int i = 0; i < fontList.length; i++)
fontMenu.addItem(fontList[i]);
fontMenu.setSelectedItem("Dialog");
styleMenu.addItem("Plain");
styleMenu.addItem("Bold");
styleMenu.addItem("Italic");
styleMenu.addItem("Bold Italic");
transformMenu.addItem("None");
transformMenu.addItem("Scale");
transformMenu.addItem("Shear");
transformMenu.addItem("Rotate");
transformMenuG2.addItem("None");
transformMenuG2.addItem("Scale");
transformMenuG2.addItem("Shear");
transformMenuG2.addItem("Rotate");
methodsMenu.addItem("drawString");
methodsMenu.addItem("drawChars");
methodsMenu.addItem("drawBytes");
methodsMenu.addItem("drawGlyphVector");
methodsMenu.addItem("TextLayout.draw");
methodsMenu.addItem("GlyphVector.getOutline + draw");
methodsMenu.addItem("TextLayout.getOutline + draw");
textMenu.addItem("Unicode Range");
textMenu.addItem("All Glyphs");
textMenu.addItem("User Text");
textMenu.addItem("Text File");
textMenu.addActionListener(this); // listener added later so unneeded events
// not thrown
}
// / Sets up the all dialogs used in Font2DTest...
private void setupDialog(boolean isApplet) {
if (!isApplet)
filePromptDialog = new JFileChooser();
else
filePromptDialog = null;
// / Prepare user text dialog...
userTextDialog = new JDialog(parent, "User Text", false);
JPanel dialogTopPanel = new JPanel();
JPanel dialogBottomPanel = new JPanel();
LabelV2 message1 = new LabelV2("Enter text below and then press update");
LabelV2 message2 = new LabelV2("(Unicode char can be denoted by \\uXXXX)");
LabelV2 message3 = new LabelV2("(Supplementary chars can be denoted by \\UXXXXXX)");
userTextArea = new JTextArea("Java2D!");
ButtonV2 bUpdate = new ButtonV2("Update", this);
userTextArea.setFont(new Font("dialog", Font.PLAIN, 12));
dialogTopPanel.setLayout(new GridLayout(3, 1));
dialogTopPanel.add(message1);
dialogTopPanel.add(message2);
dialogTopPanel.add(message3);
dialogBottomPanel.add(bUpdate);
// ABP
JScrollPane userTextAreaSP = new JScrollPane(userTextArea);
userTextAreaSP.setPreferredSize(new Dimension(300, 100));
userTextDialog.getContentPane().setLayout(new BorderLayout());
userTextDialog.getContentPane().add("North", dialogTopPanel);
userTextDialog.getContentPane().add("Center", userTextAreaSP);
userTextDialog.getContentPane().add("South", dialogBottomPanel);
userTextDialog.pack();
userTextDialog.addWindowListener(new WindowAdapter() {
public void windowClosing(WindowEvent e) {
userTextDialog.hide();
}
});
// / Prepare printing dialog...
printCBGroup = new ButtonGroup();
printModeCBs[fp.ONE_PAGE] = new JRadioButton(
"Print one page from currently displayed character/line", true);
printModeCBs[fp.CUR_RANGE] = new JRadioButton(
"Print all characters in currently selected range", false);
printModeCBs[fp.ALL_TEXT] = new JRadioButton("Print all lines of text", false);
LabelV2 l = new LabelV2(
"Note: Page range in native \"Print\" dialog will not affect the result");
JPanel buttonPanel = new JPanel();
printModeCBs[fp.ALL_TEXT].setEnabled(false);
buttonPanel.add(new ButtonV2("Print", this));
buttonPanel.add(new ButtonV2("Cancel", this));
printDialog = new JDialog(parent, "Print...", true);
printDialog.setResizable(false);
printDialog.addWindowListener(new WindowAdapter() {
public void windowClosing(WindowEvent e) {
printDialog.hide();
}
});
printDialog.getContentPane().setLayout(new GridLayout(printModeCBs.length + 2, 1));
printDialog.getContentPane().add(l);
for (int i = 0; i < printModeCBs.length; i++) {
printCBGroup.add(printModeCBs[i]);
printDialog.getContentPane().add(printModeCBs[i]);
}
printDialog.getContentPane().add(buttonPanel);
printDialog.pack();
// / Prepare font information dialog...
fontInfoDialog = new JDialog(parent, "Font info", false);
fontInfoDialog.setResizable(false);
fontInfoDialog.addWindowListener(new WindowAdapter() {
public void windowClosing(WindowEvent e) {
fontInfoDialog.hide();
showFontInfoCBMI.setState(false);
}
});
JPanel fontInfoPanel = new JPanel();
fontInfoPanel.setLayout(new GridLayout(fontInfos.length, 1));
for (int i = 0; i < fontInfos.length; i++) {
fontInfos[i] = new LabelV2("");
fontInfoPanel.add(fontInfos[i]);
}
fontInfoDialog.getContentPane().add(fontInfoPanel);
// / Move the location of the dialog...
userTextDialog.setLocation(200, 300);
fontInfoDialog.setLocation(0, 400);
}
// / RangeMenu object signals using this function
// / when Unicode range has been changed and text needs to be redrawn
public void fireRangeChanged() {
int range[] = rm.getSelectedRange();
fp.setTextToDraw(fp.RANGE_TEXT, range, null, null);
if (canDisplayCheck) {
setupFontList(range[0], range[1]);
}
if (showFontInfoCBMI.getState())
fireUpdateFontInfo();
}
// / Changes the message on the status bar
public void fireChangeStatus(String message, boolean error) {
// / If this is not ran as an applet, use own status bar,
// / Otherwise, use the appletviewer/browser"s status bar
statusBar.setText(message);
if (error)
fp.showingError = true;
else
fp.showingError = false;
}
// / Updates the information about the selected font
public void fireUpdateFontInfo() {
if (showFontInfoCBMI.getState()) {
String infos[] = fp.getFontInfo();
for (int i = 0; i < fontInfos.length; i++)
fontInfos[i].setText(infos[i]);
fontInfoDialog.pack();
}
}
private void setupFontList(int rangeStart, int rangeEnd) {
int listCount = fontMenu.getItemCount();
int size = 16;
try {
size = Float.valueOf(sizeField.getText()).intValue();
} catch (Exception e) {
System.out.println("Invalid font size in the size textField. Using default value of 16");
}
int style = fontStyles[styleMenu.getSelectedIndex()];
Font f;
for (int i = 0; i < listCount; i++) {
String fontName = (String) fontMenu.getItemAt(i);
f = new Font(fontName, style, size);
if ((rm.getSelectedIndex() != RangeMenu.SURROGATES_AREA_INDEX)
&& canDisplayRange(f, rangeStart, rangeEnd)) {
fontMenu.setBit(i, true);
} else {
fontMenu.setBit(i, false);
}
}
fontMenu.repaint();
}
protected boolean canDisplayRange(Font font, int rangeStart, int rangeEnd) {
for (int i = rangeStart; i < rangeEnd; i++) {
if (font.canDisplay(i)) {
return true;
}
}
return false;
}
// / Displays a file load/save dialog and returns the specified file
private String promptFile(boolean isSave, String initFileName) {
int retVal;
String str;
// / ABP
if (filePromptDialog == null)
return null;
if (isSave) {
filePromptDialog.setDialogType(JFileChooser.SAVE_DIALOG);
filePromptDialog.setDialogTitle("Save...");
str = "Save";
} else {
filePromptDialog.setDialogType(JFileChooser.OPEN_DIALOG);
filePromptDialog.setDialogTitle("Load...");
str = "Load";
}
if (initFileName != null)
filePromptDialog.setSelectedFile(new File(initFileName));
retVal = filePromptDialog.showDialog(this, str);
if (retVal == JFileChooser.APPROVE_OPTION) {
File file = filePromptDialog.getSelectedFile();
String fileName = file.getAbsolutePath();
if (fileName != null) {
return fileName;
}
}
return null;
}
// / Converts user text into arrays of String, delimited at newline character
// / Also replaces any valid escape sequence with appropriate unicode
// character
// / Support \\UXXXXXX notation for surrogates
private String[] parseUserText(String orig) {
int length = orig.length();
StringTokenizer perLine = new StringTokenizer(orig, "\n");
String textLines[] = new String[perLine.countTokens()];
int lineNumber = 0;
while (perLine.hasMoreElements()) {
StringBuffer converted = new StringBuffer();
String oneLine = perLine.nextToken();
int lineLength = oneLine.length();
int prevEscapeEnd = 0;
int nextEscape = -1;
do {
int nextBMPEscape = oneLine.indexOf("\\u", prevEscapeEnd);
int nextSupEscape = oneLine.indexOf("\\U", prevEscapeEnd);
nextEscape = (nextBMPEscape < 0) ? ((nextSupEscape < 0) ? -1 : nextSupEscape)
: ((nextSupEscape < 0) ? nextBMPEscape : Math.min(nextBMPEscape, nextSupEscape));
if (nextEscape != -1) {
if (prevEscapeEnd < nextEscape)
converted.append(oneLine.substring(prevEscapeEnd, nextEscape));
prevEscapeEnd = nextEscape + (nextEscape == nextBMPEscape ? 6 : 8);
try {
String hex = oneLine.substring(nextEscape + 2, prevEscapeEnd);
if (nextEscape == nextBMPEscape) {
converted.append((char) Integer.parseInt(hex, 16));
} else {
converted.append(new String(Character.toChars(Integer.parseInt(hex, 16))));
}
} catch (Exception e) {
int copyLimit = Math.min(lineLength, prevEscapeEnd);
converted.append(oneLine.substring(nextEscape, copyLimit));
}
}
} while (nextEscape != -1);
if (prevEscapeEnd < lineLength)
converted.append(oneLine.substring(prevEscapeEnd, lineLength));
textLines[lineNumber++] = converted.toString();
}
return textLines;
}
// / Reads the text from specified file, detecting UTF-16 encoding
// / Then breaks the text into String array, delimited at every line break
private void readTextFile(String fileName) {
try {
String fileText, textLines[];
BufferedInputStream bis = new BufferedInputStream(new FileInputStream(fileName));
int numBytes = bis.available();
if (numBytes == 0) {
throw new Exception("Text file " + fileName + " is empty");
}
byte byteData[] = new byte[numBytes];
bis.read(byteData, 0, numBytes);
bis.close();
// / If byte mark is found, then use UTF-16 encoding to convert bytes...
if (numBytes >= 2
&& ((byteData[0] == (byte) 0xFF && byteData[1] == (byte) 0xFE) || (byteData[0] == (byte) 0xFE && byteData[1] == (byte) 0xFF)))
fileText = new String(byteData, "UTF-16");
// / Otherwise, use system default encoding
else
fileText = new String(byteData);
int length = fileText.length();
StringTokenizer perLine = new StringTokenizer(fileText, "\n");
// / Determine "Return Char" used in this file
// / This simply finds first occurrence of CR, CR+LF or LF...
for (int i = 0; i < length; i++) {
char iTh = fileText.charAt(i);
if (iTh == "\r") {
if (i < length - 1 && fileText.charAt(i + 1) == "\n")
perLine = new StringTokenizer(fileText, "\r\n");
else
perLine = new StringTokenizer(fileText, "\r");
break;
} else if (iTh == "\n")
// / Use the one already created
break;
}
int lineNumber = 0, numLines = perLine.countTokens();
textLines = new String[numLines];
while (perLine.hasMoreElements()) {
String oneLine = perLine.nextToken();
if (oneLine == null)
// / To make LineBreakMeasurer to return a valid TextLayout
// / on an empty line, simply feed it a space char...
oneLine = " ";
textLines[lineNumber++] = oneLine;
}
fp.setTextToDraw(fp.FILE_TEXT, null, null, textLines);
rm.setEnabled(false);
methodsMenu.setEnabled(false);
} catch (Exception ex) {
fireChangeStatus("ERROR: Failed to Read Text File; See Stack Trace", true);
ex.printStackTrace();
}
}
// / Returns a String storing current configuration
private void writeCurrentOptions(String fileName) {
try {
String curOptions = fp.getCurrentOptions();
BufferedOutputStream bos = new BufferedOutputStream(new FileOutputStream(fileName));
// / Prepend title and the option that is only obtainable here
int range[] = rm.getSelectedRange();
String completeOptions = ("Font2DTest Option File\n" + displayGridCBMI.getState() + "\n"
+ force16ColsCBMI.getState() + "\n" + showFontInfoCBMI.getState() + "\n"
+ rm.getSelectedItem() + "\n" + range[0] + "\n" + range[1] + "\n" + curOptions + tFileName);
byte toBeWritten[] = completeOptions.getBytes("UTF-16");
bos.write(toBeWritten, 0, toBeWritten.length);
bos.close();
} catch (Exception ex) {
fireChangeStatus("ERROR: Failed to Save Options File; See Stack Trace", true);
ex.printStackTrace();
}
}
// / Updates GUI visibility/status after some parameters have changed
private void updateGUI() {
int selectedText = textMenu.getSelectedIndex();
// / Set the visibility of User Text dialog
if (selectedText == fp.USER_TEXT)
userTextDialog.show();
else
userTextDialog.hide();
// / Change the visibility/status/availability of Print JDialog buttons
printModeCBs[fp.ONE_PAGE].setSelected(true);
if (selectedText == fp.FILE_TEXT || selectedText == fp.USER_TEXT) {
// / ABP
// / update methodsMenu to show that TextLayout.draw is being used
// / when we are in FILE_TEXT mode
if (selectedText == fp.FILE_TEXT)
methodsMenu.setSelectedItem("TextLayout.draw");
methodsMenu.setEnabled(selectedText == fp.USER_TEXT);
printModeCBs[fp.CUR_RANGE].setEnabled(false);
printModeCBs[fp.ALL_TEXT].setEnabled(true);
} else {
// / ABP
// / update methodsMenu to show that drawGlyph is being used
// / when we are in ALL_GLYPHS mode
if (selectedText == fp.ALL_GLYPHS)
methodsMenu.setSelectedItem("drawGlyphVector");
methodsMenu.setEnabled(selectedText == fp.RANGE_TEXT);
printModeCBs[fp.CUR_RANGE].setEnabled(true);
printModeCBs[fp.ALL_TEXT].setEnabled(false);
}
// / Modify RangeMenu and fontInfo label availabilty
if (selectedText == fp.RANGE_TEXT) {
fontInfos[1].setVisible(true);
rm.setEnabled(true);
} else {
fontInfos[1].setVisible(false);
rm.setEnabled(false);
}
}
// / Loads saved options and applies them
private void loadOptions(String fileName) {
try {
BufferedInputStream bis = new BufferedInputStream(new FileInputStream(fileName));
int numBytes = bis.available();
byte byteData[] = new byte[numBytes];
bis.read(byteData, 0, numBytes);
bis.close();
if (numBytes < 2 || (byteData[0] != (byte) 0xFE || byteData[1] != (byte) 0xFF))
throw new Exception("Not a Font2DTest options file");
String options = new String(byteData, "UTF-16");
StringTokenizer perLine = new StringTokenizer(options, "\n");
String title = perLine.nextToken();
if (!title.equals("Font2DTest Option File"))
throw new Exception("Not a Font2DTest options file");
// / Parse all options
boolean displayGridOpt = Boolean.parseBoolean(perLine.nextToken());
boolean force16ColsOpt = Boolean.parseBoolean(perLine.nextToken());
boolean showFontInfoOpt = Boolean.parseBoolean(perLine.nextToken());
String rangeNameOpt = perLine.nextToken();
int rangeStartOpt = Integer.parseInt(perLine.nextToken());
int rangeEndOpt = Integer.parseInt(perLine.nextToken());
String fontNameOpt = perLine.nextToken();
float fontSizeOpt = Float.parseFloat(perLine.nextToken());
int fontStyleOpt = Integer.parseInt(perLine.nextToken());
int fontTransformOpt = Integer.parseInt(perLine.nextToken());
int g2TransformOpt = Integer.parseInt(perLine.nextToken());
int textToUseOpt = Integer.parseInt(perLine.nextToken());
int drawMethodOpt = Integer.parseInt(perLine.nextToken());
int antialiasOpt = Integer.parseInt(perLine.nextToken());
int fractionalOpt = Integer.parseInt(perLine.nextToken());
int lcdContrast = Integer.parseInt(perLine.nextToken());
String userTextOpt[] = { "Java2D!" }, dialogEntry = "Java2D!";
if (textToUseOpt == fp.USER_TEXT) {
int numLines = perLine.countTokens(), lineNumber = 0;
if (numLines != 0) {
userTextOpt = new String[numLines];
dialogEntry = "";
for (; perLine.hasMoreElements(); lineNumber++) {
userTextOpt[lineNumber] = perLine.nextToken();
dialogEntry += userTextOpt[lineNumber] + "\n";
}
}
}
// / Reset GUIs
displayGridCBMI.setState(displayGridOpt);
force16ColsCBMI.setState(force16ColsOpt);
showFontInfoCBMI.setState(showFontInfoOpt);
rm.setSelectedRange(rangeNameOpt, rangeStartOpt, rangeEndOpt);
fontMenu.setSelectedItem(fontNameOpt);
sizeField.setText(String.valueOf(fontSizeOpt));
styleMenu.setSelectedIndex(fontStyleOpt);
transformMenu.setSelectedIndex(fontTransformOpt);
transformMenuG2.setSelectedIndex(g2TransformOpt);
textMenu.setSelectedIndex(textToUseOpt);
methodsMenu.setSelectedIndex(drawMethodOpt);
antiAliasMenu.setSelectedIndex(antialiasOpt);
fracMetricsMenu.setSelectedIndex(fractionalOpt);
contrastSlider.setValue(lcdContrast);
userTextArea.setText(dialogEntry);
updateGUI();
if (textToUseOpt == fp.FILE_TEXT) {
tFileName = perLine.nextToken();
readTextFile(tFileName);
}
// / Reset option variables and repaint
fp.loadOptions(displayGridOpt, force16ColsOpt, rangeStartOpt, rangeEndOpt, fontNameOpt,
fontSizeOpt, fontStyleOpt, fontTransformOpt, g2TransformOpt, textToUseOpt, drawMethodOpt,
antialiasOpt, fractionalOpt, lcdContrast, userTextOpt);
if (showFontInfoOpt) {
fireUpdateFontInfo();
fontInfoDialog.show();
} else
fontInfoDialog.hide();
} catch (Exception ex) {
fireChangeStatus("ERROR: Failed to Load Options File; See Stack Trace", true);
ex.printStackTrace();
}
}
// / Loads a previously saved image
private void loadComparisonPNG(String fileName) {
try {
BufferedImage image = javax.imageio.ImageIO.read(new File(fileName));
JFrame f = new JFrame("Comparison PNG");
ImagePanel ip = new ImagePanel(image);
f.setResizable(false);
f.getContentPane().add(ip);
f.addWindowListener(new WindowAdapter() {
public void windowClosing(WindowEvent e) {
((JFrame) e.getSource()).dispose();
}
});
f.pack();
f.show();
} catch (Exception ex) {
fireChangeStatus("ERROR: Failed to Load PNG File; See Stack Trace", true);
ex.printStackTrace();
}
}
// / Interface functions...
// / ActionListener interface function
// / Responds to JMenuItem, JTextField and JButton actions
public void actionPerformed(ActionEvent e) {
Object source = e.getSource();
if (source instanceof JMenuItem) {
JMenuItem mi = (JMenuItem) source;
String itemName = mi.getText();
if (itemName.equals("Save Selected Options...")) {
String fileName = promptFile(true, "options.txt");
if (fileName != null)
writeCurrentOptions(fileName);
} else if (itemName.equals("Load Options...")) {
String fileName = promptFile(false, "options.txt");
if (fileName != null)
loadOptions(fileName);
} else if (itemName.equals("Save as PNG...")) {
String fileName = promptFile(true, fontMenu.getSelectedItem() + ".png");
if (fileName != null)
fp.doSavePNG(fileName);
} else if (itemName.equals("Load PNG File to Compare...")) {
String fileName = promptFile(false, null);
if (fileName != null)
loadComparisonPNG(fileName);
} else if (itemName.equals("Page Setup..."))
fp.doPageSetup();
else if (itemName.equals("Print..."))
printDialog.show();
else if (itemName.equals("Close"))
parent.dispose();
else if (itemName.equals("Exit"))
System.exit(0);
}
else if (source instanceof JTextField) {
JTextField tf = (JTextField) source;
float sz = 12f;
try {
sz = Float.parseFloat(sizeField.getText());
if (sz < 1f || sz > 120f) {
sz = 12f;
sizeField.setText("12");
}
} catch (Exception se) {
sizeField.setText("12");
}
if (tf == sizeField)
fp.setFontParams(fontMenu.getSelectedItem(), sz, styleMenu.getSelectedIndex(),
transformMenu.getSelectedIndex());
}
else if (source instanceof JButton) {
String itemName = ((JButton) source).getText();
// / Print dialog buttons...
if (itemName.equals("Print")) {
for (int i = 0; i < printModeCBs.length; i++)
if (printModeCBs[i].isSelected()) {
printDialog.hide();
fp.doPrint(i);
}
} else if (itemName.equals("Cancel"))
printDialog.hide();
// / Update button from Usert Text JDialog...
else if (itemName.equals("Update"))
fp.setTextToDraw(fp.USER_TEXT, null, parseUserText(userTextArea.getText()), null);
} else if (source instanceof JComboBox) {
JComboBox c = (JComboBox) source;
// / RangeMenu handles actions by itself and then calls fireRangeChanged,
// / so it is not listed or handled here
if (c == fontMenu || c == styleMenu || c == transformMenu) {
float sz = 12f;
try {
sz = Float.parseFloat(sizeField.getText());
if (sz < 1f || sz > 120f) {
sz = 12f;
sizeField.setText("12");
}
} catch (Exception se) {
sizeField.setText("12");
}
fp.setFontParams(fontMenu.getSelectedItem(), sz, styleMenu.getSelectedIndex(),
transformMenu.getSelectedIndex());
} else if (c == methodsMenu)
fp.setDrawMethod(methodsMenu.getSelectedIndex());
else if (c == textMenu) {
if (canDisplayCheck) {
fireRangeChanged();
}
int selected = textMenu.getSelectedIndex();
if (selected == fp.RANGE_TEXT)
fp.setTextToDraw(fp.RANGE_TEXT, rm.getSelectedRange(), null, null);
else if (selected == fp.USER_TEXT)
fp.setTextToDraw(fp.USER_TEXT, null, parseUserText(userTextArea.getText()), null);
else if (selected == fp.FILE_TEXT) {
String fileName = promptFile(false, null);
if (fileName != null) {
tFileName = fileName;
readTextFile(fileName);
} else {
// / User cancelled selection; reset to previous choice
c.setSelectedIndex(currentTextChoice);
return;
}
} else if (selected == fp.ALL_GLYPHS)
fp.setTextToDraw(fp.ALL_GLYPHS, null, null, null);
updateGUI();
currentTextChoice = selected;
} else if (c == transformMenuG2) {
fp.setTransformG2(transformMenuG2.getSelectedIndex());
} else if (c == antiAliasMenu || c == fracMetricsMenu) {
if (c == antiAliasMenu) {
boolean enabled = FontPanel.AAValues.isLCDMode(antiAliasMenu.getSelectedItem());
contrastSlider.setEnabled(enabled);
}
fp.setRenderingHints(antiAliasMenu.getSelectedItem(), fracMetricsMenu.getSelectedItem(),
contrastSlider.getValue());
}
}
}
public void stateChanged(ChangeEvent e) {
Object source = e.getSource();
if (source instanceof JSlider) {
fp.setRenderingHints(antiAliasMenu.getSelectedItem(), fracMetricsMenu.getSelectedItem(),
contrastSlider.getValue());
}
}
// / ItemListener interface function
// / Responds to JCheckBoxMenuItem, JComboBox and JCheckBox actions
public void itemStateChanged(ItemEvent e) {
Object source = e.getSource();
if (source instanceof JCheckBoxMenuItem) {
JCheckBoxMenuItem cbmi = (JCheckBoxMenuItem) source;
if (cbmi == displayGridCBMI)
fp.setGridDisplay(displayGridCBMI.getState());
else if (cbmi == force16ColsCBMI)
fp.setForce16Columns(force16ColsCBMI.getState());
else if (cbmi == showFontInfoCBMI) {
if (showFontInfoCBMI.getState()) {
fireUpdateFontInfo();
fontInfoDialog.show();
} else
fontInfoDialog.hide();
}
}
}
private static void printUsage() {
String usage = "Usage: java -jar Font2DTest.jar [options]\n" + "\nwhere options include:\n"
+ " -dcdc | -disablecandisplaycheck disable canDisplay check for font\n"
+ " -? | -help print this help message\n" + "\nExample :\n"
+ " To disable canDisplay check on font for ranges\n"
+ " java -jar Font2DTest.jar -dcdc";
System.out.println(usage);
System.exit(0);
}
// / Main function
public static void main(String argv[]) {
if (argv.length > 0) {
if (argv[0].equalsIgnoreCase("-disablecandisplaycheck") || argv[0].equalsIgnoreCase("-dcdc")) {
canDisplayCheck = false;
} else {
printUsage();
}
}
UIManager.put("swing.boldMetal", Boolean.FALSE);
final JFrame f = new JFrame("Font2DTest");
final Font2DTest f2dt = new Font2DTest(f, false);
f.addWindowListener(new WindowAdapter() {
public void windowOpening(WindowEvent e) {
f2dt.repaint();
}
public void windowClosing(WindowEvent e) {
System.exit(0);
}
});
f.getContentPane().add(f2dt);
f.pack();
f.show();
}
// / Inner class definitions...
// / Class to display just an image file
// / Used to show the comparison PNG image
private final class ImagePanel extends JPanel {
private final BufferedImage bi;
public ImagePanel(BufferedImage image) {
bi = image;
}
public Dimension getPreferredSize() {
return new Dimension(bi.getWidth(), bi.getHeight());
}
public void paintComponent(Graphics g) {
g.drawImage(bi, 0, 0, this);
}
}
// / Classes made to avoid repetitive calls... (being lazy)
private final class ButtonV2 extends JButton {
public ButtonV2(String name, ActionListener al) {
super(name);
this.addActionListener(al);
}
}
private final class ChoiceV2 extends JComboBox {
private BitSet bitSet = null;
public ChoiceV2() {
;
}
public ChoiceV2(ActionListener al) {
super();
this.addActionListener(al);
}
public ChoiceV2(ActionListener al, boolean fontChoice) {
this(al);
if (fontChoice) {
// Register this component in ToolTipManager
setToolTipText("");
bitSet = new BitSet();
setRenderer(new ChoiceV2Renderer(this));
}
}
public String getToolTipText() {
int index = this.getSelectedIndex();
String fontName = (String) this.getSelectedItem();
if (fontName != null && (textMenu.getSelectedIndex() == fp.RANGE_TEXT)) {
if (getBit(index)) {
return "Font \"" + fontName + "\" can display some characters in \""
+ rm.getSelectedItem() + "\" range";
} else {
return "Font \"" + fontName + "\" cannot display any characters in \""
+ rm.getSelectedItem() + "\" range";
}
}
return super.getToolTipText();
}
public void setBit(int bitIndex, boolean value) {
bitSet.set(bitIndex, value);
}
public boolean getBit(int bitIndex) {
return bitSet.get(bitIndex);
}
}
private final class ChoiceV2Renderer extends DefaultListCellRenderer {
private ImageIcon yesImage, blankImage;
private ChoiceV2 choice = null;
public ChoiceV2Renderer(ChoiceV2 choice) {
try {
yesImage = new ImageIcon(getClass().getResource("yes.gif"));
blankImage = new ImageIcon(getClass().getResource("blank.gif"));
} catch (Exception exception) {
System.out.println("Exception : " + exception);
}
this.choice = choice;
}
public Component getListCellRendererComponent(JList list, Object value, int index,
boolean isSelected, boolean cellHasFocus) {
if (textMenu.getSelectedIndex() == fp.RANGE_TEXT) {
super.getListCellRendererComponent(list, value, index, isSelected, cellHasFocus);
// For JComboBox if index is -1, its rendering the selected index.
if (index == -1) {
index = choice.getSelectedIndex();
}
if (choice.getBit(index)) {
setIcon(yesImage);
} else {
setIcon(blankImage);
}
} else {
super.getListCellRendererComponent(list, value, index, isSelected, cellHasFocus);
setIcon(blankImage);
}
return this;
}
}
private final class LabelV2 extends JLabel {
public LabelV2(String name) {
super(name);
}
}
private final class MenuItemV2 extends JMenuItem {
public MenuItemV2(String name, ActionListener al) {
super(name);
this.addActionListener(al);
}
}
private final class CheckboxMenuItemV2 extends JCheckBoxMenuItem {
public CheckboxMenuItemV2(String name, boolean b, ItemListener il) {
super(name, b);
this.addItemListener(il);
}
}
}
/*
* @(#)FontPanel.java 1.20 05/11/17
*
* Copyright (c) 2006 Sun Microsystems, Inc. All Rights Reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* -Redistribution of source code must retain the above copyright notice, this
* list of conditions and the following disclaimer.
*
* -Redistribution in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* Neither the name of Sun Microsystems, Inc. or the names of contributors may
* be used to endorse or promote products derived from this software without
* specific prior written permission.
*
* This software is provided "AS IS," without a warranty of any kind. ALL
* EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY
* IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR
* NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN MIDROSYSTEMS, INC. ("SUN") AND ITS
* LICENSORS SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A
* RESULT OF USING, MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES.
* IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT
* OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR
* PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY,
* ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE, EVEN IF SUN HAS
* BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
*
* You acknowledge that this software is not designed, licensed or intended for
* use in the design, construction, operation or maintenance of any nuclear
* facility.
*/
/*
* @(#)FontPanel.java 1.20 05/11/17
*/
/**
* FontPanel.java
*
* @version
* @(#)FontPanel.java 1.1 00/08/22
* @author Shinsuke Fukuda
* @author Ankit Patel [Conversion to Swing - 01/07/30]
*/
// / This panel is combination of the text drawing area of Font2DTest
// / and the custom controlled scroll bar
final class FontPanel extends JPanel implements AdjustmentListener {
// / Drawing Option Constants
private final String STYLES[] = { "plain", "bold", "italic", "bold italic" };
private final int NONE = 0;
private final int SCALE = 1;
private final int SHEAR = 2;
private final int ROTATE = 3;
private final String TRANSFORMS[] = { "with no transforms", "with scaling", "with Shearing",
"with rotation" };
private final int DRAW_STRING = 0;
private final int DRAW_CHARS = 1;
private final int DRAW_BYTES = 2;
private final int DRAW_GLYPHV = 3;
private final int TL_DRAW = 4;
private final int GV_OUTLINE = 5;
private final int TL_OUTLINE = 6;
private final String METHODS[] = { "drawString", "drawChars", "drawBytes", "drawGlyphVector",
"TextLayout.draw", "GlyphVector.getOutline", "TextLayout.getOutline" };
public final int RANGE_TEXT = 0;
public final int ALL_GLYPHS = 1;
public final int USER_TEXT = 2;
public final int FILE_TEXT = 3;
private final String MS_OPENING[] = { " Unicode ", " Glyph Code ", " lines ", " lines " };
private final String MS_CLOSING[] = { "", "", " of User Text ",
" of LineBreakMeasurer-reformatted Text " };
// / General Graphics Variable
private final JScrollBar verticalBar;
private final FontCanvas fc;
private boolean updateBackBuffer = true;
private boolean updateFontMetrics = true;
private boolean updateFont = true;
private boolean force16Cols = false;
public boolean showingError = false;
private int g2Transform = NONE; // / ABP
// / Printing constants and variables
public final int ONE_PAGE = 0;
public final int CUR_RANGE = 1;
public final int ALL_TEXT = 2;
private int printMode = ONE_PAGE;
private PageFormat page = null;
private PrinterJob printer = null;
// / Text drawing variables
private String fontName = "Dialog";
private float fontSize = 12;
private int fontStyle = Font.PLAIN;
private int fontTransform = NONE;
private Font testFont = null;
private Object antiAliasType = VALUE_TEXT_ANTIALIAS_DEFAULT;
private Object fractionalMetricsType = VALUE_FRACTIONALMETRICS_DEFAULT;
private Object lcdContrast = getDefaultLCDContrast();
private int drawMethod = DRAW_STRING;
private int textToUse = RANGE_TEXT;
private String userText[] = null;
private String fileText[] = null;
private int drawRange[] = { 0x0000, 0x007f };
private String fontInfos[] = new String[2];
private boolean showGrid = true;
// / Parent Font2DTest panel
private final Font2DTest f2dt;
private final JFrame parent;
public FontPanel(Font2DTest demo, JFrame f) {
f2dt = demo;
parent = f;
verticalBar = new JScrollBar(JScrollBar.VERTICAL);
fc = new FontCanvas();
this.setLayout(new BorderLayout());
this.add("Center", fc);
this.add("East", verticalBar);
verticalBar.addAdjustmentListener(this);
this.addComponentListener(new ComponentAdapter() {
public void componentResized(ComponentEvent e) {
updateBackBuffer = true;
updateFontMetrics = true;
}
});
// / Initialize font and its infos
testFont = new Font(fontName, fontStyle, (int) fontSize);
if ((float) ((int) fontSize) != fontSize) {
testFont = testFont.deriveFont(fontSize);
}
updateFontInfo();
}
public Dimension getPreferredSize() {
return new Dimension(600, 200);
}
// / Functions called by the main programs to set the various parameters
public void setTransformG2(int transform) {
g2Transform = transform;
updateBackBuffer = true;
updateFontMetrics = true;
fc.repaint();
}
// / convenience fcn to create AffineTransform of appropriate type
private AffineTransform getAffineTransform(int transform) {
// / ABP
AffineTransform at = new AffineTransform();
switch (transform) {
case SCALE:
at.setToScale(1.5f, 1.5f);
break;
case ROTATE:
at.setToRotation(Math.PI / 6);
break;
case SHEAR:
at.setToShear(0.4f, 0);
break;
case NONE:
break;
default:
// System.err.println( "Illegal G2 Transform Arg: " + transform);
break;
}
return at;
}
public void setFontParams(Object obj, float size, int style, int transform) {
setFontParams((String) obj, size, style, transform);
}
public void setFontParams(String name, float size, int style, int transform) {
boolean fontModified = false;
if (!name.equals(fontName) || style != fontStyle)
fontModified = true;
fontName = name;
fontSize = size;
fontStyle = style;
fontTransform = transform;
// / Recreate the font as specified
testFont = new Font(fontName, fontStyle, (int) fontSize);
if ((float) ((int) fontSize) != fontSize) {
testFont = testFont.deriveFont(fontSize);
}
if (fontTransform != NONE) {
AffineTransform at = getAffineTransform(fontTransform);
testFont = testFont.deriveFont(at);
}
updateBackBuffer = true;
updateFontMetrics = true;
fc.repaint();
if (fontModified) {
// / Tell main panel to update the font info
updateFontInfo();
f2dt.fireUpdateFontInfo();
}
}
public void setRenderingHints(Object aa, Object fm, Object contrast) {
antiAliasType = ((AAValues) aa).getHint();
fractionalMetricsType = ((FMValues) fm).getHint();
lcdContrast = contrast;
updateBackBuffer = true;
updateFontMetrics = true;
fc.repaint();
}
public void setDrawMethod(int i) {
drawMethod = i;
updateBackBuffer = true;
fc.repaint();
}
public void setTextToDraw(int i, int range[], String textSet[], String fileData[]) {
textToUse = i;
if (textToUse == RANGE_TEXT)
drawRange = range;
else if (textToUse == ALL_GLYPHS)
drawMethod = DRAW_GLYPHV;
else if (textToUse == USER_TEXT)
userText = textSet;
else if (textToUse == FILE_TEXT) {
fileText = fileData;
drawMethod = TL_DRAW;
}
updateBackBuffer = true;
updateFontMetrics = true;
fc.repaint();
updateFontInfo();
}
public void setGridDisplay(boolean b) {
showGrid = b;
updateBackBuffer = true;
fc.repaint();
}
public void setForce16Columns(boolean b) {
force16Cols = b;
updateBackBuffer = true;
updateFontMetrics = true;
fc.repaint();
}
// / Prints out the text display area
public void doPrint(int i) {
if (printer == null) {
printer = PrinterJob.getPrinterJob();
page = printer.defaultPage();
}
printMode = i;
printer.setPrintable(fc, page);
if (printer.printDialog()) {
try {
printer.print();
} catch (Exception e) {
f2dt.fireChangeStatus("ERROR: Printing Failed; See Stack Trace", true);
}
}
}
// / Displays the page setup dialog and updates PageFormat info
public void doPageSetup() {
if (printer == null) {
printer = PrinterJob.getPrinterJob();
page = printer.defaultPage();
}
page = printer.pageDialog(page);
}
// / Obtains the information about selected font
private void updateFontInfo() {
int numGlyphs = 0, numCharsInRange = drawRange[1] - drawRange[0] + 1;
fontInfos[0] = "Font Face Name: " + testFont.getFontName();
fontInfos[1] = "Glyphs in This Range: ";
if (textToUse == RANGE_TEXT) {
for (int i = drawRange[0]; i < drawRange[1]; i++)
if (testFont.canDisplay(i))
numGlyphs++;
fontInfos[1] = fontInfos[1] + numGlyphs + " / " + numCharsInRange;
} else
fontInfos[1] = null;
}
// / Accessor for the font information
public String[] getFontInfo() {
return fontInfos;
}
// / Collects the currectly set options and returns them as string
public String getCurrentOptions() {
// / Create a new String to store the options
// / The array will contain all 8 setting (font name, size...) and
// / character range or user text data used (no file text data)
int userTextSize = 0;
String options;
options = (fontName + "\n" + fontSize + "\n" + fontStyle + "\n" + fontTransform + "\n"
+ g2Transform + "\n" + textToUse + "\n" + drawMethod + "\n"
+ AAValues.getHintVal(antiAliasType) + "\n" + FMValues.getHintVal(fractionalMetricsType)
+ "\n" + lcdContrast + "\n");
if (textToUse == USER_TEXT)
for (int i = 0; i < userText.length; i++)
options += (userText[i] + "\n");
return options;
}
// / Reload all options and refreshes the canvas
public void loadOptions(boolean grid, boolean force16, int start, int end, String name,
float size, int style, int transform, int g2transform, int text, int method, int aa, int fm,
int contrast, String user[]) {
int range[] = { start, end };
// / Since repaint call has a low priority, these functions will finish
// / before the actual repainting is done
setGridDisplay(grid);
setForce16Columns(force16);
// previous call to readTextFile has already set the text to draw
if (textToUse != FILE_TEXT) {
setTextToDraw(text, range, user, null);
}
setFontParams(name, size, style, transform);
setTransformG2(g2transform); // ABP
setDrawMethod(method);
setRenderingHints(AAValues.getValue(aa), FMValues.getValue(fm), new Integer(contrast));
}
// / Writes the current screen to PNG file
public void doSavePNG(String fileName) {
fc.writePNG(fileName);
}
// / When scrolled using the scroll bar, update the backbuffer
public void adjustmentValueChanged(AdjustmentEvent e) {
updateBackBuffer = true;
fc.repaint();
}
public void paintComponent(Graphics g) {
// Windows does not repaint correctly, after
// a zoom. Thus, we need to force the canvas
// to repaint, but only once. After the first repaint,
// everything stabilizes. [ABP]
fc.repaint();
}
// / Inner class definition...
// / Inner panel that holds the actual drawing area and its routines
private class FontCanvas extends JPanel implements MouseListener, MouseMotionListener, Printable {
// / Number of characters that will fit across and down this canvas
private int numCharAcross, numCharDown;
// / First and last character/line that will be drawn
// / Limit is the end of range/text where no more draw will be done
private int drawStart, drawEnd, drawLimit;
// / FontMetrics variables
// / Here, gridWidth is equivalent to maxAdvance (slightly bigger though)
// / and gridHeight is equivalent to lineHeight
private int maxAscent, maxDescent, gridWidth = 0, gridHeight = 0;
// / Offset from the top left edge of the canvas where the draw will start
private int canvasInset_X = 5, canvasInset_Y = 5;
// / Offscreen buffer of this canvas
private BufferedImage backBuffer = null;
// / LineBreak"ed TextLayout vector
private Vector lineBreakTLs = null;
// / Whether the current draw command requested is for printing
private boolean isPrinting = false;
// / Other printing infos
private int lastPage, printPageNumber, currentlyShownChar = 0;
private final int PR_OFFSET = 10;
private final int PR_TITLE_LINEHEIGHT = 30;
// / Information about zooming (used with range text draw)
private final JWindow zoomWindow;
private BufferedImage zoomImage = null;
private int mouseOverCharX = -1, mouseOverCharY = -1;
private int currMouseOverChar = -1, prevZoomChar = -1;
private float ZOOM = 2.0f;
private boolean nowZooming = false;
private boolean firstTime = true;
// ABP
// / Status bar message backup
private String backupStatusString = null;
// / Error constants
private final String ERRORS[] = {
"ERROR: drawBytes cannot handle characters beyond 0x00FF. Select different range or draw methods.",
"ERROR: Cannot fit text with the current font size. Resize the window or use smaller font size.",
"ERROR: Cannot print with the current font size. Use smaller font size.", };
private final int DRAW_BYTES_ERROR = 0;
private final int CANT_FIT_DRAW = 1;
private final int CANT_FIT_PRINT = 2;
// / Other variables
private final Cursor blankCursor;
public FontCanvas() {
this.addMouseListener(this);
this.addMouseMotionListener(this);
this.setForeground(Color.black);
this.setBackground(Color.white);
// / Creates an invisble pointer by giving it bogus image
// / Possibly find a workaround for this...
Toolkit tk = Toolkit.getDefaultToolkit();
byte bogus[] = { (byte) 0 };
blankCursor = tk.createCustomCursor(tk.createImage(bogus), new Point(0, 0), "");
zoomWindow = new JWindow(parent) {
public void paint(Graphics g) {
g.drawImage(zoomImage, 0, 0, zoomWindow);
}
};
zoomWindow.setCursor(blankCursor);
zoomWindow.pack();
}
public boolean firstTime() {
return firstTime;
}
public void refresh() {
firstTime = false;
updateBackBuffer = true;
repaint();
}
// / Sets the font, hints, according to the set parameters
private void setParams(Graphics2D g2) {
g2.setFont(testFont);
g2.setRenderingHint(KEY_TEXT_ANTIALIASING, antiAliasType);
g2.setRenderingHint(KEY_FRACTIONALMETRICS, fractionalMetricsType);
g2.setRenderingHint(KEY_TEXT_LCD_CONTRAST, lcdContrast);
/*
* I am preserving a somewhat dubious behaviour of this program. Outline
* text would be drawn anti-aliased by setting the graphics anti-aliasing
* hint if the text anti-aliasing hint was set. The dubious element here
* is that people simply using this program may think this is built-in
* behaviour but its not - at least not when the app explictly draws
* outline text. This becomes more dubious in cases such as "GASP" where
* the size at which text is AA"ed is not something you can easily
* calculate, so mimicing that behaviour isn"t going to be easy. So I
* precisely preserve the behaviour : this is done only if the AA value is
* "ON". Its not applied in the other cases.
*/
if (antiAliasType == VALUE_TEXT_ANTIALIAS_ON
&& (drawMethod == TL_OUTLINE || drawMethod == GV_OUTLINE)) {
g2.setRenderingHint(KEY_ANTIALIASING, VALUE_ANTIALIAS_ON);
} else {
g2.setRenderingHint(KEY_ANTIALIASING, VALUE_ANTIALIAS_OFF);
}
}
// / Draws the grid (Used for unicode/glyph range drawing)
private void drawGrid(Graphics2D g2) {
int totalGridWidth = numCharAcross * gridWidth;
int totalGridHeight = numCharDown * gridHeight;
g2.setColor(Color.black);
for (int i = 0; i < numCharDown + 1; i++)
g2.drawLine(canvasInset_X, i * gridHeight + canvasInset_Y, canvasInset_X + totalGridWidth,
i * gridHeight + canvasInset_Y);
for (int i = 0; i < numCharAcross + 1; i++)
g2.drawLine(i * gridWidth + canvasInset_X, canvasInset_Y, i * gridWidth + canvasInset_X,
canvasInset_Y + totalGridHeight);
}
// / Draws one character at time onto the canvas according to
// / the method requested (Used for RANGE_TEXT and ALL_GLYPHS)
public void modeSpecificDrawChar(Graphics2D g2, int charCode, int baseX, int baseY) {
GlyphVector gv;
int oneGlyph[] = { charCode };
char charArray[] = Character.toChars(charCode);
FontRenderContext frc = g2.getFontRenderContext();
AffineTransform oldTX = g2.getTransform();
// / Create GlyphVector to measure the exact visual advance
// / Using that number, adjust the position of the character drawn
if (textToUse == ALL_GLYPHS)
gv = testFont.createGlyphVector(frc, oneGlyph);
else
gv = testFont.createGlyphVector(frc, charArray);
Rectangle2D r2d2 = gv.getPixelBounds(frc, 0, 0);
int shiftedX = baseX;
// getPixelBounds returns a result in device space.
// we need to convert back to user space to be able to
// calculate the shift as baseX is in user space.
try {
double pt[] = new double[4];
pt[0] = r2d2.getX();
pt[1] = r2d2.getY();
pt[2] = r2d2.getX() + r2d2.getWidth();
pt[3] = r2d2.getY() + r2d2.getHeight();
oldTX.inverseTransform(pt, 0, pt, 0, 2);
shiftedX = baseX - (int) (pt[2] / 2 + pt[0]);
} catch (NoninvertibleTransformException e) {
}
// / ABP - keep track of old tform, restore it later
g2.translate(shiftedX, baseY);
g2.transform(getAffineTransform(g2Transform));
if (textToUse == ALL_GLYPHS)
g2.drawGlyphVector(gv, 0f, 0f);
else {
if (testFont.canDisplay(charCode))
g2.setColor(Color.black);
else {
g2.setColor(Color.lightGray);
}
switch (drawMethod) {
case DRAW_STRING:
g2.drawString(new String(charArray), 0, 0);
break;
case DRAW_CHARS:
g2.drawChars(charArray, 0, 1, 0, 0);
break;
case DRAW_BYTES:
if (charCode > 0xff)
throw new CannotDrawException(DRAW_BYTES_ERROR);
byte oneByte[] = { (byte) charCode };
g2.drawBytes(oneByte, 0, 1, 0, 0);
break;
case DRAW_GLYPHV:
g2.drawGlyphVector(gv, 0f, 0f);
break;
case TL_DRAW:
TextLayout tl = new TextLayout(new String(charArray), testFont, frc);
tl.draw(g2, 0f, 0f);
break;
case GV_OUTLINE:
r2d2 = gv.getVisualBounds();
shiftedX = baseX - (int) (r2d2.getWidth() / 2 + r2d2.getX());
g2.draw(gv.getOutline(0f, 0f));
break;
case TL_OUTLINE:
r2d2 = gv.getVisualBounds();
shiftedX = baseX - (int) (r2d2.getWidth() / 2 + r2d2.getX());
TextLayout tlo = new TextLayout(new String(charArray), testFont, g2
.getFontRenderContext());
g2.draw(tlo.getOutline(null));
}
}
// / ABP - restore old tform
g2.setTransform(oldTX);
}
// Java2D!\\U01d586\\U01d587\\U01d588
// / Draws one line of text at given position
private void modeSpecificDrawLine(Graphics2D g2, String line, int baseX, int baseY) {
// / ABP - keep track of old tform, restore it later
AffineTransform oldTx = null;
oldTx = g2.getTransform();
g2.translate(baseX, baseY);
g2.transform(getAffineTransform(g2Transform));
switch (drawMethod) {
case DRAW_STRING:
g2.drawString(line, 0, 0);
break;
case DRAW_CHARS:
g2.drawChars(line.toCharArray(), 0, line.length(), 0, 0);
break;
case DRAW_BYTES:
try {
byte lineBytes[] = line.getBytes("ISO-8859-1");
g2.drawBytes(lineBytes, 0, lineBytes.length, 0, 0);
} catch (Exception e) {
e.printStackTrace();
}
break;
case DRAW_GLYPHV:
GlyphVector gv = testFont.createGlyphVector(g2.getFontRenderContext(), line);
g2.drawGlyphVector(gv, (float) 0, (float) 0);
break;
case TL_DRAW:
TextLayout tl = new TextLayout(line, testFont, g2.getFontRenderContext());
tl.draw(g2, (float) 0, (float) 0);
break;
case GV_OUTLINE:
GlyphVector gvo = testFont.createGlyphVector(g2.getFontRenderContext(), line);
g2.draw(gvo.getOutline((float) 0, (float) 0));
break;
case TL_OUTLINE:
TextLayout tlo = new TextLayout(line, testFont, g2.getFontRenderContext());
AffineTransform at = new AffineTransform();
g2.draw(tlo.getOutline(at));
}
// / ABP - restore old tform
g2.setTransform(oldTx);
}
// / Draws one line of text at given position
private void tlDrawLine(Graphics2D g2, TextLayout tl, float baseX, float baseY) {
// / ABP - keep track of old tform, restore it later
AffineTransform oldTx = null;
oldTx = g2.getTransform();
g2.translate(baseX, baseY);
g2.transform(getAffineTransform(g2Transform));
tl.draw(g2, (float) 0, (float) 0);
// / ABP - restore old tform
g2.setTransform(oldTx);
}
// / If textToUse is set to range drawing, then convert
// / int to hex string and prepends 0s to make it length 4
// / Otherwise line number was fed; simply return number + 1 converted to
// String
// / (This is because first line is 1, not 0)
private String modeSpecificNumStr(int i) {
if (textToUse == USER_TEXT || textToUse == FILE_TEXT)
return String.valueOf(i + 1);
StringBuffer s = new StringBuffer(Integer.toHexString(i));
while (s.length() < 4)
s.insert(0, "0");
return s.toString().toUpperCase();
}
// / Resets the scrollbar to display correct range of text currently on
// screen
// / (This scrollbar is not part of a "ScrollPane". It merely simulates its
// effect by
// / indicating the necessary area to be drawn within the panel.
// / By doing this, it prevents creating gigantic panel when large text
// range,
// / i.e. CJK Ideographs, is requested)
private void resetScrollbar(int oldValue) {
int totalNumRows = 1, numCharToDisplay;
if (textToUse == RANGE_TEXT || textToUse == ALL_GLYPHS) {
if (textToUse == RANGE_TEXT)
numCharToDisplay = drawRange[1] - drawRange[0];
else
// / textToUse == ALL_GLYPHS
numCharToDisplay = testFont.getNumGlyphs();
totalNumRows = numCharToDisplay / numCharAcross;
if (numCharToDisplay % numCharAcross != 0)
totalNumRows++;
if (oldValue / numCharAcross > totalNumRows)
oldValue = 0;
verticalBar.setValues(oldValue / numCharAcross, numCharDown, 0, totalNumRows);
} else {
if (textToUse == USER_TEXT)
totalNumRows = userText.length;
else
// / textToUse == FILE_TEXT;
totalNumRows = lineBreakTLs.size();
verticalBar.setValues(oldValue, numCharDown, 0, totalNumRows);
}
if (totalNumRows <= numCharDown && drawStart == 0) {
verticalBar.setEnabled(false);
} else {
verticalBar.setEnabled(true);
}
}
// / Calculates the font"s metrics that will be used for draw
private void calcFontMetrics(Graphics2D g2d, int w, int h) {
FontMetrics fm;
Graphics2D g2 = (Graphics2D) g2d.create();
// / ABP
if (g2Transform != NONE && textToUse != FILE_TEXT) {
g2.setFont(g2.getFont().deriveFont(getAffineTransform(g2Transform)));
fm = g2.getFontMetrics();
} else {
fm = g2.getFontMetrics();
}
maxAscent = fm.getMaxAscent();
maxDescent = fm.getMaxDescent();
if (maxAscent == 0)
maxAscent = 10;
if (maxDescent == 0)
maxDescent = 5;
if (textToUse == RANGE_TEXT || textToUse == ALL_GLYPHS) {
// / Give slight extra room for each character
maxAscent += 3;
maxDescent += 3;
gridWidth = fm.getMaxAdvance() + 6;
gridHeight = maxAscent + maxDescent;
if (force16Cols)
numCharAcross = 16;
else
numCharAcross = (w - 10) / gridWidth;
numCharDown = (h - 10) / gridHeight;
canvasInset_X = (w - numCharAcross * gridWidth) / 2;
canvasInset_Y = (h - numCharDown * gridHeight) / 2;
if (numCharDown == 0 || numCharAcross == 0)
throw new CannotDrawException(isPrinting ? CANT_FIT_PRINT : CANT_FIT_DRAW);
if (!isPrinting)
resetScrollbar(verticalBar.getValue() * numCharAcross);
} else {
maxDescent += fm.getLeading();
canvasInset_X = 5;
canvasInset_Y = 5;
// / gridWidth and numCharAcross will not be used in this mode...
gridHeight = maxAscent + maxDescent;
numCharDown = (h - canvasInset_Y * 2) / gridHeight;
if (numCharDown == 0)
throw new CannotDrawException(isPrinting ? CANT_FIT_PRINT : CANT_FIT_DRAW);
// / If this is text loaded from file, prepares the LineBreak"ed
// / text layout at this point
if (textToUse == FILE_TEXT) {
if (!isPrinting)
f2dt.fireChangeStatus("LineBreaking Text... Please Wait", false);
lineBreakTLs = new Vector();
for (int i = 0; i < fileText.length; i++) {
AttributedString as = new AttributedString(fileText[i], g2.getFont().getAttributes());
LineBreakMeasurer lbm = new LineBreakMeasurer(as.getIterator(), g2
.getFontRenderContext());
while (lbm.getPosition() < fileText[i].length())
lineBreakTLs.add(lbm.nextLayout((float) w));
}
}
if (!isPrinting)
resetScrollbar(verticalBar.getValue());
}
}
// / Calculates the amount of text that will be displayed on screen
private void calcTextRange() {
String displaying = null;
if (textToUse == RANGE_TEXT || textToUse == ALL_GLYPHS) {
if (isPrinting)
if (printMode == ONE_PAGE)
drawStart = currentlyShownChar;
else
// / printMode == CUR_RANGE
drawStart = numCharAcross * numCharDown * printPageNumber;
else
drawStart = verticalBar.getValue() * numCharAcross;
if (textToUse == RANGE_TEXT) {
drawStart += drawRange[0];
drawLimit = drawRange[1];
} else
drawLimit = testFont.getNumGlyphs();
drawEnd = drawStart + numCharAcross * numCharDown - 1;
if (drawEnd >= drawLimit)
drawEnd = drawLimit;
} else {
if (isPrinting)
if (printMode == ONE_PAGE)
drawStart = currentlyShownChar;
else
// / printMode == ALL_TEXT
drawStart = numCharDown * printPageNumber;
else {
drawStart = verticalBar.getValue();
}
drawEnd = drawStart + numCharDown - 1;
if (textToUse == USER_TEXT)
drawLimit = userText.length - 1;
else
drawLimit = lineBreakTLs.size() - 1;
if (drawEnd >= drawLimit)
drawEnd = drawLimit;
}
// ABP
if (drawStart > drawEnd) {
drawStart = 0;
verticalBar.setValue(drawStart);
}
// / Change the status bar if not printing...
if (!isPrinting) {
backupStatusString = ("Displaying" + MS_OPENING[textToUse] + modeSpecificNumStr(drawStart)
+ " to " + modeSpecificNumStr(drawEnd) + MS_CLOSING[textToUse]);
f2dt.fireChangeStatus(backupStatusString, false);
}
}
// / Draws text according to the parameters set by Font2DTest GUI
private void drawText(Graphics g, int w, int h) {
Graphics2D g2;
// / Create back buffer when not printing, and its Graphics2D
// / Then set drawing parameters for that Graphics2D object
if (isPrinting)
g2 = (Graphics2D) g;
else {
backBuffer = (BufferedImage) this.createImage(w, h);
g2 = backBuffer.createGraphics();
g2.setColor(Color.white);
g2.fillRect(0, 0, w, h);
g2.setColor(Color.black);
}
// / sets font, RenderingHints.
setParams(g2);
// / If flag is set, recalculate fontMetrics and reset the scrollbar
if (updateFontMetrics || isPrinting) {
// / NOTE: re-calculates in case G2 transform
// / is something other than NONE
calcFontMetrics(g2, w, h);
updateFontMetrics = false;
}
// / Calculate the amount of text that can be drawn...
calcTextRange();
// / Draw according to the set "Text to Use" mode
if (textToUse == RANGE_TEXT || textToUse == ALL_GLYPHS) {
int charToDraw = drawStart;
if (showGrid)
drawGrid(g2);
if (!isPrinting)
g.drawImage(backBuffer, 0, 0, this);
for (int i = 0; i < numCharDown && charToDraw <= drawEnd; i++) {
for (int j = 0; j < numCharAcross && charToDraw <= drawEnd; j++, charToDraw++) {
int gridLocX = j * gridWidth + canvasInset_X;
int gridLocY = i * gridHeight + canvasInset_Y;
modeSpecificDrawChar(g2, charToDraw, gridLocX + gridWidth / 2, gridLocY + maxAscent);
// if ( !isPrinting ) {
// g.setClip( gridLocX, gridLocY, gridWidth + 1, gridHeight + 1 );
// g.drawImage( backBuffer, 0, 0, this );
// }
}
}
} else if (textToUse == USER_TEXT) {
g2.drawRect(0, 0, w - 1, h - 1);
if (!isPrinting)
g.drawImage(backBuffer, 0, 0, this);
for (int i = drawStart; i <= drawEnd; i++) {
int lineStartX = canvasInset_Y;
int lineStartY = (i - drawStart) * gridHeight + maxAscent;
modeSpecificDrawLine(g2, userText[i], lineStartX, lineStartY);
}
} else {
float xPos, yPos = (float) canvasInset_Y;
g2.drawRect(0, 0, w - 1, h - 1);
if (!isPrinting)
g.drawImage(backBuffer, 0, 0, this);
for (int i = drawStart; i <= drawEnd; i++) {
TextLayout oneLine = (TextLayout) lineBreakTLs.elementAt(i);
xPos = oneLine.isLeftToRight() ? canvasInset_X
: ((float) w - oneLine.getAdvance() - canvasInset_X);
float fmData[] = { 0, oneLine.getAscent(), 0, oneLine.getDescent(), 0,
oneLine.getLeading() };
if (g2Transform != NONE) {
AffineTransform at = getAffineTransform(g2Transform);
at.transform(fmData, 0, fmData, 0, 3);
}
// yPos += oneLine.getAscent();
yPos += fmData[1]; // ascent
// oneLine.draw( g2, xPos, yPos );
tlDrawLine(g2, oneLine, xPos, yPos);
// yPos += oneLine.getDescent() + oneLine.getLeading();
yPos += fmData[3] + fmData[5]; // descent + leading
}
}
if (!isPrinting)
g.drawImage(backBuffer, 0, 0, this);
g2.dispose();
}
// / Component paintComponent function...
// / Draws/Refreshes canvas according to flag(s) set by other functions
public void paintComponent(Graphics g) {
if (updateBackBuffer) {
Dimension d = this.getSize();
isPrinting = false;
try {
drawText(g, d.width, d.height);
} catch (CannotDrawException e) {
f2dt.fireChangeStatus(ERRORS[e.id], true);
super.paintComponent(g);
return;
}
} else {
// / Screen refresh
g.drawImage(backBuffer, 0, 0, this);
}
showingError = false;
updateBackBuffer = false;
}
// / Printable interface function
// / Component print function...
public int print(Graphics g, PageFormat pf, int pageIndex) {
if (pageIndex == 0) {
// / Reset the last page index to max...
lastPage = Integer.MAX_VALUE;
currentlyShownChar = verticalBar.getValue() * numCharAcross;
}
if (printMode == ONE_PAGE) {
if (pageIndex > 0)
return NO_SUCH_PAGE;
} else {
if (pageIndex > lastPage)
return NO_SUCH_PAGE;
}
int pageWidth = (int) pf.getImageableWidth();
int pageHeight = (int) pf.getImageableHeight();
// / Back up metrics and other drawing info before printing modifies it
int backupDrawStart = drawStart, backupDrawEnd = drawEnd;
int backupNumCharAcross = numCharAcross, backupNumCharDown = numCharDown;
Vector backupLineBreakTLs = null;
if (textToUse == FILE_TEXT)
backupLineBreakTLs = (Vector) lineBreakTLs.clone();
printPageNumber = pageIndex;
isPrinting = true;
// / Push the actual draw area 60 down to allow info to be printed
g.translate((int) pf.getImageableX(), (int) pf.getImageableY() + 60);
try {
drawText(g, pageWidth, pageHeight - 60);
} catch (CannotDrawException e) {
f2dt.fireChangeStatus(ERRORS[e.id], true);
return NO_SUCH_PAGE;
}
// / Draw information about what is being printed
String hints = (" with antialias " + antiAliasType + "and" + " fractional metrics "
+ fractionalMetricsType + " and lcd contrast = " + lcdContrast);
String infoLine1 = ("Printing" + MS_OPENING[textToUse] + modeSpecificNumStr(drawStart)
+ " to " + modeSpecificNumStr(drawEnd) + MS_CLOSING[textToUse]);
String infoLine2 = ("With " + fontName + " " + STYLES[fontStyle] + " at " + fontSize
+ " point size " + TRANSFORMS[fontTransform]);
String infoLine3 = "Using " + METHODS[drawMethod] + hints;
String infoLine4 = "Page: " + (pageIndex + 1);
g.setFont(new Font("dialog", Font.PLAIN, 12));
g.setColor(Color.black);
g.translate(0, -60);
g.drawString(infoLine1, 15, 10);
g.drawString(infoLine2, 15, 22);
g.drawString(infoLine3, 15, 34);
g.drawString(infoLine4, 15, 46);
if (drawEnd == drawLimit)
// / This indicates that the draw will be completed with this page
lastPage = pageIndex;
// / Restore the changed values back...
// / This is important for JScrollBar settings and LineBreak"ed TLs
drawStart = backupDrawStart;
drawEnd = backupDrawEnd;
numCharAcross = backupNumCharAcross;
numCharDown = backupNumCharDown;
if (textToUse == FILE_TEXT)
lineBreakTLs = backupLineBreakTLs;
return PAGE_EXISTS;
}
// / Ouputs the current canvas into a given PNG file
public void writePNG(String fileName) {
try {
ImageIO.write(backBuffer, "png", new java.io.File(fileName));
} catch (Exception e) {
f2dt.fireChangeStatus("ERROR: Failed to Save PNG image; See stack trace", true);
e.printStackTrace();
}
}
// / Figures out whether a character at the pointer location is valid
// / And if so, updates mouse location informations, as well as
// / the information on the status bar
private boolean checkMouseLoc(MouseEvent e) {
if (gridWidth != 0 && gridHeight != 0)
if (textToUse == RANGE_TEXT || textToUse == ALL_GLYPHS) {
int charLocX = (e.getX() - canvasInset_X) / gridWidth;
int charLocY = (e.getY() - canvasInset_Y) / gridHeight;
// / Check to make sure the mouse click location is within drawn area
if (charLocX >= 0 && charLocY >= 0 && charLocX < numCharAcross && charLocY < numCharDown) {
int mouseOverChar = charLocX + (verticalBar.getValue() + charLocY) * numCharAcross;
if (textToUse == RANGE_TEXT)
mouseOverChar += drawRange[0];
if (mouseOverChar > drawEnd)
return false;
mouseOverCharX = charLocX;
mouseOverCharY = charLocY;
currMouseOverChar = mouseOverChar;
// / Update status bar
f2dt.fireChangeStatus("Pointing to" + MS_OPENING[textToUse]
+ modeSpecificNumStr(mouseOverChar), false);
return true;
}
}
return false;
}
// / Shows (updates) the character zoom window
public void showZoomed() {
GlyphVector gv;
Font backup = testFont;
Point canvasLoc = this.getLocationOnScreen();
// / Calculate the zoom area"s location and size...
int dialogOffsetX = (int) (gridWidth * (ZOOM - 1) / 2);
int dialogOffsetY = (int) (gridHeight * (ZOOM - 1) / 2);
int zoomAreaX = mouseOverCharX * gridWidth + canvasInset_X - dialogOffsetX;
int zoomAreaY = mouseOverCharY * gridHeight + canvasInset_Y - dialogOffsetY;
int zoomAreaWidth = (int) (gridWidth * ZOOM);
int zoomAreaHeight = (int) (gridHeight * ZOOM);
// / Position and set size of zoom window as needed
zoomWindow.setLocation(canvasLoc.x + zoomAreaX, canvasLoc.y + zoomAreaY);
if (!nowZooming) {
if (zoomWindow.getWarningString() != null)
// / If this is not opened as a "secure" window,
// / it has a banner below the zoom dialog which makes it look really
// BAD
// / So enlarge it by a bit
zoomWindow.setSize(zoomAreaWidth + 1, zoomAreaHeight + 20);
else
zoomWindow.setSize(zoomAreaWidth + 1, zoomAreaHeight + 1);
}
// / Prepare zoomed image
zoomImage = (BufferedImage) zoomWindow.createImage(zoomAreaWidth + 1, zoomAreaHeight + 1);
Graphics2D g2 = (Graphics2D) zoomImage.getGraphics();
testFont = testFont.deriveFont(fontSize * ZOOM);
setParams(g2);
g2.setColor(Color.white);
g2.fillRect(0, 0, zoomAreaWidth, zoomAreaHeight);
g2.setColor(Color.black);
g2.drawRect(0, 0, zoomAreaWidth, zoomAreaHeight);
modeSpecificDrawChar(g2, currMouseOverChar, zoomAreaWidth / 2, (int) (maxAscent * ZOOM));
g2.dispose();
if (!nowZooming)
zoomWindow.show();
// / This is sort of redundant... since there is a paint function
// / inside zoomWindow definition that does the drawImage.
// / (I should be able to call just repaint() here)
// / However, for some reason, that paint function fails to respond
// / from second time and on; So I have to force the paint here...
zoomWindow.getGraphics().drawImage(zoomImage, 0, 0, this);
nowZooming = true;
prevZoomChar = currMouseOverChar;
testFont = backup;
// Windows does not repaint correctly, after
// a zoom. Thus, we need to force the canvas
// to repaint, but only once. After the first repaint,
// everything stabilizes. [ABP]
if (firstTime()) {
refresh();
}
}
// / Listener Functions
// / MouseListener interface function
// / Zooms a character when mouse is pressed above it
public void mousePressed(MouseEvent e) {
if (!showingError) {
if (checkMouseLoc(e)) {
showZoomed();
this.setCursor(blankCursor);
}
}
}
// / MouseListener interface function
// / Redraws the area that was drawn over by zoomed character
public void mouseReleased(MouseEvent e) {
if (textToUse == RANGE_TEXT || textToUse == ALL_GLYPHS) {
if (nowZooming)
zoomWindow.hide();
nowZooming = false;
}
this.setCursor(Cursor.getDefaultCursor());
}
// / MouseListener interface function
// / Resets the status bar to display range instead of a specific character
public void mouseExited(MouseEvent e) {
if (!showingError && !nowZooming)
f2dt.fireChangeStatus(backupStatusString, false);
}
// / MouseMotionListener interface function
// / Adjusts the status bar message when mouse moves over a character
public void mouseMoved(MouseEvent e) {
if (!showingError) {
if (!checkMouseLoc(e))
f2dt.fireChangeStatus(backupStatusString, false);
}
}
// / MouseMotionListener interface function
// / Scrolls the zoomed character when mouse is dragged
public void mouseDragged(MouseEvent e) {
if (!showingError)
if (nowZooming) {
if (checkMouseLoc(e) && currMouseOverChar != prevZoomChar)
showZoomed();
}
}
// / Empty function to comply with interface requirement
public void mouseClicked(MouseEvent e) {
}
public void mouseEntered(MouseEvent e) {
}
}
private final class CannotDrawException extends RuntimeException {
// / Error ID
public final int id;
public CannotDrawException(int i) {
id = i;
}
}
enum FMValues {
FMDEFAULT("DEFAULT", VALUE_FRACTIONALMETRICS_DEFAULT), FMOFF("OFF", VALUE_FRACTIONALMETRICS_OFF), FMON(
"ON", VALUE_FRACTIONALMETRICS_ON);
private String name;
private Object hint;
private static FMValues[] valArray;
FMValues(String s, Object o) {
name = s;
hint = o;
}
public String toString() {
return name;
}
public Object getHint() {
return hint;
}
public static Object getValue(int ordinal) {
if (valArray == null) {
valArray = (FMValues[]) EnumSet.allOf(FMValues.class).toArray(new FMValues[0]);
}
for (int i = 0; i < valArray.length; i++) {
if (valArray[i].ordinal() == ordinal) {
return valArray[i];
}
}
return valArray[0];
}
private static FMValues[] getArray() {
if (valArray == null) {
valArray = (FMValues[]) EnumSet.allOf(FMValues.class).toArray(new FMValues[0]);
}
return valArray;
}
public static int getHintVal(Object hint) {
getArray();
for (int i = 0; i < valArray.length; i++) {
if (valArray[i].getHint() == hint) {
return i;
}
}
return 0;
}
}
enum AAValues {
AADEFAULT("DEFAULT", VALUE_TEXT_ANTIALIAS_DEFAULT), AAOFF("OFF", VALUE_TEXT_ANTIALIAS_OFF), AAON(
"ON", VALUE_TEXT_ANTIALIAS_ON), AAGASP("GASP", VALUE_TEXT_ANTIALIAS_GASP), AALCDHRGB(
"LCD_HRGB", VALUE_TEXT_ANTIALIAS_LCD_HRGB), AALCDHBGR("LCD_HBGR",
VALUE_TEXT_ANTIALIAS_LCD_HBGR), AALCDVRGB("LCD_VRGB", VALUE_TEXT_ANTIALIAS_LCD_VRGB), AALCDVBGR(
"LCD_VBGR", VALUE_TEXT_ANTIALIAS_LCD_VBGR);
private String name;
private Object hint;
private static AAValues[] valArray;
AAValues(String s, Object o) {
name = s;
hint = o;
}
public String toString() {
return name;
}
public Object getHint() {
return hint;
}
public static boolean isLCDMode(Object o) {
return (o instanceof AAValues && ((AAValues) o).ordinal() >= AALCDHRGB.ordinal());
}
public static Object getValue(int ordinal) {
if (valArray == null) {
valArray = (AAValues[]) EnumSet.allOf(AAValues.class).toArray(new AAValues[0]);
}
for (int i = 0; i < valArray.length; i++) {
if (valArray[i].ordinal() == ordinal) {
return valArray[i];
}
}
return valArray[0];
}
private static AAValues[] getArray() {
if (valArray == null) {
Object[] oa = EnumSet.allOf(AAValues.class).toArray(new AAValues[0]);
valArray = (AAValues[]) (EnumSet.allOf(AAValues.class).toArray(new AAValues[0]));
}
return valArray;
}
public static int getHintVal(Object hint) {
getArray();
for (int i = 0; i < valArray.length; i++) {
if (valArray[i].getHint() == hint) {
return i;
}
}
return 0;
}
}
private static Integer defaultContrast;
static Integer getDefaultLCDContrast() {
if (defaultContrast == null) {
GraphicsConfiguration gc = GraphicsEnvironment.getLocalGraphicsEnvironment()
.getDefaultScreenDevice().getDefaultConfiguration();
Graphics2D g2d = (Graphics2D) (gc.createCompatibleImage(1, 1).getGraphics());
defaultContrast = (Integer) g2d.getRenderingHint(RenderingHints.KEY_TEXT_LCD_CONTRAST);
}
return defaultContrast;
}
}
/*
* @(#)RangeMenu.java 1.18 05/11/17
*
* Copyright (c) 2006 Sun Microsystems, Inc. All Rights Reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* -Redistribution of source code must retain the above copyright notice, this
* list of conditions and the following disclaimer.
*
* -Redistribution in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* Neither the name of Sun Microsystems, Inc. or the names of contributors may
* be used to endorse or promote products derived from this software without
* specific prior written permission.
*
* This software is provided "AS IS," without a warranty of any kind. ALL
* EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY
* IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR
* NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN MIDROSYSTEMS, INC. ("SUN") AND ITS
* LICENSORS SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A
* RESULT OF USING, MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES.
* IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT
* OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR
* PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY,
* ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE, EVEN IF SUN HAS
* BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
*
* You acknowledge that this software is not designed, licensed or intended for
* use in the design, construction, operation or maintenance of any nuclear
* facility.
*/
/*
* @(#)RangeMenu.java 1.18 05/11/17
*/
/**
* RangeMenu.java
*
* @version
* @(#)RangeMenu.java 1.1 00/08/22
* @author Shinsuke Fukuda
* @author Ankit Patel [Conversion to Swing - 01/07/30]
*/
// / Custom made choice menu that holds data for unicode range
final class RangeMenu extends JComboBox implements ActionListener {
// / Painfully extracted from java.lang.Character.UnicodeBlock. Arrrgh!
// / Unicode 3.0 data.
private final int[][] UNICODE_RANGES = { { 0x000000, 0x00007f }, // /
// BASIC_LATIN
{ 0x000080, 0x0000ff }, // / LATIN_1_SUPPLEMENT
{ 0x000100, 0x00017f }, // / LATIN_EXTENDED_A
{ 0x000180, 0x00024f }, // / LATIN_EXTENDED_B
{ 0x000250, 0x0002af }, // / IPA_EXTENSIONS
{ 0x0002b0, 0x0002ff }, // / SPACING_MODIFIER_LETTERS
{ 0x000300, 0x00036f }, // / COMBINING_DIACRITICAL_MARKS
{ 0x000370, 0x0003ff }, // / GREEK
{ 0x000400, 0x0004ff }, // / CYRILLIC
{ 0x000500, 0x00052f }, // / CYRILLIC_SUPPLEMENTARY
{ 0x000530, 0x00058f }, // / ARMENIAN
{ 0x000590, 0x0005ff }, // / HEBREW
{ 0x000600, 0x0006ff }, // / ARABIC
{ 0x000700, 0x00074f }, // / SYRIAC
{ 0x000780, 0x0007bf }, // / THAANA
{ 0x000900, 0x00097f }, // / DEVANAGARI
{ 0x000980, 0x0009ff }, // / BENGALI
{ 0x000a00, 0x000a7f }, // / GURMUKHI
{ 0x000a80, 0x000aff }, // / GUJARATI
{ 0x000b00, 0x000b7f }, // / ORIYA
{ 0x000b80, 0x000bff }, // / TAMIL
{ 0x000c00, 0x000c7f }, // / TELUGU
{ 0x000c80, 0x000cff }, // / KANNADA
{ 0x000d00, 0x000d7f }, // / MALAYALAM
{ 0x000d80, 0x000dff }, // / SINHALA
{ 0x000e00, 0x000e7f }, // / THAI
{ 0x000e80, 0x000eff }, // / LAO
{ 0x000f00, 0x000fff }, // / TIBETAN
{ 0x001000, 0x00109f }, // / MYANMAR
{ 0x0010a0, 0x0010ff }, // / GEORGIAN
{ 0x001100, 0x0011ff }, // / HANGUL_JAMO
{ 0x001200, 0x00137f }, // / ETHIOPIC
{ 0x0013a0, 0x0013ff }, // / CHEROKEE
{ 0x001400, 0x00167f }, // / UNIFIED_CANADIAN_ABORIGINAL_SYLLABICS
{ 0x001680, 0x00169f }, // / OGHAM
{ 0x0016a0, 0x0016ff }, // / RUNIC
{ 0x001700, 0x00171f }, // / TAGALOG
{ 0x001720, 0x00173f }, // / HANUNOO
{ 0x001740, 0x00175f }, // / BUHID
{ 0x001760, 0x00177f }, // / TAGBANWA
{ 0x001780, 0x0017ff }, // / KHMER
{ 0x001800, 0x0018af }, // / MONGOLIAN
{ 0x001900, 0x00194f }, // / LIMBU
{ 0x001950, 0x00197f }, // / TAI_LE
{ 0x0019e0, 0x0019ff }, // / KHMER_SYMBOLS
{ 0x001d00, 0x001d7f }, // / PHONETIC_EXTENSIONS
{ 0x001e00, 0x001eff }, // / LATIN_EXTENDED_ADDITIONAL
{ 0x001f00, 0x001fff }, // / GREEK_EXTENDED
{ 0x002000, 0x00206f }, // / GENERAL_PUNCTUATION
{ 0x002070, 0x00209f }, // / SUPERSCRIPTS_AND_SUBSCRIPTS
{ 0x0020a0, 0x0020cf }, // / CURRENCY_SYMBOLS
{ 0x0020d0, 0x0020ff }, // / COMBINING_MARKS_FOR_SYMBOLS
{ 0x002100, 0x00214f }, // / LETTERLIKE_SYMBOLS
{ 0x002150, 0x00218f }, // / NUMBER_FORMS
{ 0x002190, 0x0021ff }, // / ARROWS
{ 0x002200, 0x0022ff }, // / MATHEMATICAL_OPERATORS
{ 0x002300, 0x0023ff }, // / MISCELLANEOUS_TECHNICAL
{ 0x002400, 0x00243f }, // / CONTROL_PICTURES
{ 0x002440, 0x00245f }, // / OPTICAL_CHARACTER_RECOGNITION
{ 0x002460, 0x0024ff }, // / ENCLOSED_ALPHANUMERICS
{ 0x002500, 0x00257f }, // / BOX_DRAWING
{ 0x002580, 0x00259f }, // / BLOCK_ELEMENTS
{ 0x0025a0, 0x0025ff }, // / GEOMETRIC_SHAPES
{ 0x002600, 0x0026ff }, // / MISCELLANEOUS_SYMBOLS
{ 0x002700, 0x0027bf }, // / DINGBATS
{ 0x0027c0, 0x0027ef }, // / MISCELLANEOUS_MATHEMATICAL_SYMBOLS_A
{ 0x0027f0, 0x0027ff }, // / SUPPLEMENTAL_ARROWS_A
{ 0x002800, 0x0028ff }, // / BRAILLE_PATTERNS
{ 0x002900, 0x00297f }, // / SUPPLEMENTAL_ARROWS_B
{ 0x002980, 0x0029ff }, // / MISCELLANEOUS_MATHEMATICAL_SYMBOLS_B
{ 0x002a00, 0x002aff }, // / SUPPLEMENTAL_MATHEMATICAL_OPERATORS
{ 0x002b00, 0x002bff }, // / MISCELLANEOUS_SYMBOLS_AND_ARROWS
{ 0x002e80, 0x002eff }, // / CJK_RADICALS_SUPPLEMENT
{ 0x002f00, 0x002fdf }, // / KANGXI_RADICALS
{ 0x002ff0, 0x002fff }, // / IDEOGRAPHIC_DESCRIPTION_CHARACTERS
{ 0x003000, 0x00303f }, // / CJK_SYMBOLS_AND_PUNCTUATION
{ 0x003040, 0x00309f }, // / HIRAGANA
{ 0x0030a0, 0x0030ff }, // / KATAKANA
{ 0x003100, 0x00312f }, // / BOPOMOFO
{ 0x003130, 0x00318f }, // / HANGUL_COMPATIBILITY_JAMO
{ 0x003190, 0x00319f }, // / KANBUN
{ 0x0031a0, 0x0031bf }, // / BOPOMOFO_EXTENDED
{ 0x0031f0, 0x0031ff }, // / KATAKANA_PHONETIC_EXTENSIONS
{ 0x003200, 0x0032ff }, // / ENCLOSED_CJK_LETTERS_AND_MONTHS
{ 0x003300, 0x0033ff }, // / CJK_COMPATIBILITY
{ 0x003400, 0x004dbf }, // / CJK_UNIFIED_IDEOGRAPHS_EXTENSION_A
{ 0x004dc0, 0x004dff }, // / YIJING_HEXAGRAM_SYMBOLS
{ 0x004e00, 0x009fff }, // / CJK_UNIFIED_IDEOGRAPHS
{ 0x00a000, 0x00a48f }, // / YI_SYLLABLES
{ 0x00a490, 0x00a4cf }, // / YI_RADICALS
{ 0x00ac00, 0x00d7af }, // / HANGUL_SYLLABLES
{ 0x00d800, 0x00dfff }, // / SURROGATES_AREA
{ 0x00e000, 0x00f8ff }, // / PRIVATE_USE_AREA
{ 0x00f900, 0x00faff }, // / CJK_COMPATIBILITY_IDEOGRAPHS
{ 0x00fb00, 0x00fb4f }, // / ALPHABETIC_PRESENTATION_FORMS
{ 0x00fb50, 0x00fdff }, // / ARABIC_PRESENTATION_FORMS_A
{ 0x00fe00, 0x00fe0f }, // / VARIATION_SELECTORS
{ 0x00fe20, 0x00fe2f }, // / COMBINING_HALF_MARKS
{ 0x00fe30, 0x00fe4f }, // / CJK_COMPATIBILITY_FORMS
{ 0x00fe50, 0x00fe6f }, // / SMALL_FORM_VARIANTS
{ 0x00fe70, 0x00feff }, // / ARABIC_PRESENTATION_FORMS_B
{ 0x00ff00, 0x00ffef }, // / HALFWIDTH_AND_FULLWIDTH_FORMS
{ 0x00fff0, 0x00ffff }, // / SPECIALS
{ 0x010000, 0x01007f }, // / LINEAR_B_SYLLABARY
{ 0x010080, 0x0100ff }, // / LINEAR_B_IDEOGRAMS
{ 0x010100, 0x01013f }, // / AEGEAN_NUMBERS
{ 0x010300, 0x01032f }, // / OLD_ITALIC
{ 0x010330, 0x01034f }, // / GOTHIC
{ 0x010380, 0x01039f }, // / UGARITIC
{ 0x010400, 0x01044f }, // / DESERET
{ 0x010450, 0x01047f }, // / SHAVIAN
{ 0x010480, 0x0104af }, // / OSMANYA
{ 0x010800, 0x01083f }, // / CYPRIOT_SYLLABARY
{ 0x01d000, 0x01d0ff }, // / BYZANTINE_MUSICAL_SYMBOLS
{ 0x01d100, 0x01d1ff }, // / MUSICAL_SYMBOLS
{ 0x01d300, 0x01d35f }, // / TAI_XUAN_JING_SYMBOLS
{ 0x01d400, 0x01d7ff }, // / MATHEMATICAL_ALPHANUMERIC_SYMBOLS
{ 0x020000, 0x02a6df }, // / CJK_UNIFIED_IDEOGRAPHS_EXTENSION_B
{ 0x02f800, 0x02fa1f }, // / CJK_COMPATIBILITY_IDEOGRAPHS_SUPPLEMENT
{ 0x0e0000, 0x0e007f }, // / TAGS
{ 0x0e0100, 0x0e01ef }, // / VARIATION_SELECTORS_SUPPLEMENT
{ 0x0f0000, 0x0fffff }, // / SUPPLEMENTARY_PRIVATE_USE_AREA_A
{ 0x100000, 0x10ffff }, // / SUPPLEMENTARY_PRIVATE_USE_AREA_B
{ 0x000000, 0x00007f }, // / OTHER [USER DEFINED RANGE]
};
private final String[] UNICODE_RANGE_NAMES = { "Basic Latin", "Latin-1 Supplement",
"Latin Extended-A", "Latin Extended-B", "IPA Extensions", "Spacing Modifier Letters",
"Combining Diacritical Marks", "Greek", "Cyrillic", "Cyrillic Supplement", "Armenian",
"Hebrew", "Arabic", "Syriac", "Thaana", "Devanagari", "Bengali", "Gurmukhi", "Gujarati",
"Oriya", "Tamil", "Telugu", "Kannada", "Malayalam", "Sinhala", "Thai", "Lao", "Tibetan",
"Myanmar", "Georgian", "Hangul Jamo", "Ethiopic", "Cherokee",
"Unified Canadian Aboriginal Syllabics", "Ogham", "Runic", "Tagalog", "Hanunoo", "Buhid",
"Tagbanwa", "Khmer", "Mongolian", "Limbu", "Tai Le", "Khmer Symbols", "Phonetic Extensions",
"Latin Extended Additional", "Greek Extended", "General Punctuation",
"Superscripts and Subscripts", "Currency Symbols", "Combining Marks for Symbols",
"Letterlike Symbols", "Number Forms", "Arrows", "Mathematical Operators",
"Miscellaneous Technical", "Control Pictures", "Optical Character Recognition",
"Enclosed Alphanumerics", "Box Drawing", "Block Elements", "Geometric Shapes",
"Miscellaneous Symbols", "Dingbats", "Miscellaneous Mathematical Symbols-A",
"Supplemental Arrows-A", "Braille Patterns", "Supplemental Arrows-B",
"Miscellaneous Mathematical Symbols-B", "Supplemental Mathematical Operators",
"Miscellaneous Symbols and Arrows", "CJK Radicals Supplement", "Kangxi Radicals",
"Ideographic Description Characters", "CJK Symbols and Punctuation", "Hiragana", "Katakana",
"Bopomofo", "Hangul Compatibility Jamo", "Kanbun", "Bopomofo Extended",
"Katakana Phonetic Extensions", "Enclosed CJK Letters and Months", "CJK Compatibility",
"CJK Unified Ideographs Extension A", "Yijing Hexagram Symbols", "CJK Unified Ideographs",
"Yi Syllables", "Yi Radicals", "Hangul Syllables", "Surrogates Area", // High
// Surrogates,
// High
// Private
// Use
// Surrogates,
// Low
// Surrogates
"Private Use Area", "CJK Compatibility Ideographs", "Alphabetic Presentation Forms",
"Arabic Presentation Forms-A", "Variation Selectors", "Combining Half Marks",
"CJK Compatibility Forms", "Small Form Variants", "Arabic Presentation Forms-B",
"Halfwidth and Fullwidth Forms", "Specials", "Linear B Syllabary", "Linear B Ideograms",
"Aegean Numbers", "Old Italic", "Gothic", "Ugaritic", "Deseret", "Shavian", "Osmanya",
"Cypriot Syllabary", "Byzantine Musical Symbols", "Musical Symbols", "Tai Xuan Jing Symbols",
"Mathematical Alphanumeric Symbols", "CJK Unified Ideographs Extension B",
"CJK Compatibility Ideographs Supplement", "Tags", "Variation Selectors Supplement",
"Supplementary Private Use Area-A", "Supplementary Private Use Area-B", "Custom...", };
private boolean useCustomRange = false;
private int[] customRange = { 0x0000, 0x007f };
// / Custom range dialog variables
private final JDialog customRangeDialog;
private final JTextField customRangeStart = new JTextField("0000", 4);
private final JTextField customRangeEnd = new JTextField("007F", 4);
private final int CUSTOM_RANGE_INDEX = UNICODE_RANGE_NAMES.length - 1;
// / Parent Font2DTest Object holder
private final Font2DTest parent;
public static final int SURROGATES_AREA_INDEX = 91;
public RangeMenu(Font2DTest demo, JFrame f) {
super();
parent = demo;
for (int i = 0; i < UNICODE_RANGE_NAMES.length; i++)
addItem(UNICODE_RANGE_NAMES[i]);
setSelectedIndex(0);
addActionListener(this);
// / Set up custom range dialog...
customRangeDialog = new JDialog(f, "Custom Unicode Range", true);
customRangeDialog.setResizable(false);
JPanel dialogTop = new JPanel();
JPanel dialogBottom = new JPanel();
JButton okButton = new JButton("OK");
JLabel from = new JLabel("From:");
JLabel to = new JLabel("To:");
Font labelFont = new Font("dialog", Font.BOLD, 12);
from.setFont(labelFont);
to.setFont(labelFont);
okButton.setFont(labelFont);
dialogTop.add(from);
dialogTop.add(customRangeStart);
dialogTop.add(to);
dialogTop.add(customRangeEnd);
dialogBottom.add(okButton);
okButton.addActionListener(this);
customRangeDialog.getContentPane().setLayout(new BorderLayout());
customRangeDialog.getContentPane().add("North", dialogTop);
customRangeDialog.getContentPane().add("South", dialogBottom);
customRangeDialog.pack();
}
// / Return the range that is currently selected
public int[] getSelectedRange() {
if (useCustomRange) {
int startIndex, endIndex;
String startText, endText;
String empty = "";
try {
startText = customRangeStart.getText().trim();
endText = customRangeEnd.getText().trim();
if (startText.equals(empty) && !endText.equals(empty)) {
endIndex = Integer.parseInt(endText, 16);
startIndex = endIndex - 7 * 25;
} else if (!startText.equals(empty) && endText.equals(empty)) {
startIndex = Integer.parseInt(startText, 16);
endIndex = startIndex + 7 * 25;
} else {
startIndex = Integer.parseInt(customRangeStart.getText(), 16);
endIndex = Integer.parseInt(customRangeEnd.getText(), 16);
}
} catch (Exception e) {
// / Error in parsing the hex number ---
// / Reset the range to what it was before and return that
customRangeStart.setText(Integer.toString(customRange[0], 16));
customRangeEnd.setText(Integer.toString(customRange[1], 16));
return customRange;
}
if (startIndex < 0)
startIndex = 0;
if (endIndex > 0xffff)
endIndex = 0xffff;
if (startIndex > endIndex)
startIndex = endIndex;
customRange[0] = startIndex;
customRange[1] = endIndex;
return customRange;
} else
return UNICODE_RANGES[getSelectedIndex()];
}
// / Function used by loadOptions in Font2DTest main panel
// / to reset setting and range selection
public void setSelectedRange(String name, int start, int end) {
setSelectedItem(name);
customRange[0] = start;
customRange[1] = end;
parent.fireRangeChanged();
}
// / ActionListener interface function
// / ABP
// / moved JComboBox event code into this fcn from
// / itemStateChanged() method. Part of change to Swing.
public void actionPerformed(ActionEvent e) {
Object source = e.getSource();
if (source instanceof JComboBox) {
String rangeName = (String) ((JComboBox) source).getSelectedItem();
if (rangeName.equals("Custom...")) {
useCustomRange = true;
customRangeDialog.setLocationRelativeTo(parent);
customRangeDialog.show();
} else {
useCustomRange = false;
}
parent.fireRangeChanged();
} else if (source instanceof JButton) {
// / Since it is only "OK" button that sends any action here...
customRangeDialog.hide();
}
}
}

</source>

Java/Swing Components

2010-06-01T07:45:15Z

Admin:

Java/Swing Components

2010-06-01T07:44:04Z

Admin:

* [[Java/Swing Components/Action Framework | Action Framework]]
* [[Java/Swing Components/Animation | Animation]]
* [[Java/Swing Components/Border | Border]]
* [[Java/Swing Components/Button | Button]]
* [[Java/Swing Components/Button Bar | Button Bar]]
* [[Java/Swing Components/Calculator | Calculator]]
* [[Java/Swing Components/Calendar | Calendar]]
* [[Java/Swing Components/Chart | Chart]]
* [[Java/Swing Components/Clock | Clock]]
* [[Java/Swing Components/Color Chooser | Color Chooser]]
* [[Java/Swing Components/ComboBox | ComboBox]]
* [[Java/Swing Components/Data Binding | Data Binding]]
* [[Java/Swing Components/Data Binding Master Slave | Data Binding Master Slave]]
* [[Java/Swing Components/Data Binding Value Types | Data Binding Value Types]]
* [[Java/Swing Components/Data Validation | Data Validation]]
* [[Java/Swing Components/Dialog | Dialog]]
* [[Java/Swing Components/Dir Chooser | Dir Chooser]]
* [[Java/Swing Components/Dockable | Dockable]]
* [[Java/Swing Components/Dual List | Dual List]]
* [[Java/Swing Components/Email Client | Email Client]]
* [[Java/Swing Components/Event Schedular | Event Schedular]]
* [[Java/Swing Components/Font Chooser | Font Chooser]]
* [[Java/Swing Components/FormLayout | FormLayout]]
* [[Java/Swing Components/GlassPane | GlassPane]]
* [[Java/Swing Components/Grid Table | Grid Table]]
* [[Java/Swing Components/Item Chooser | Item Chooser]]
* [[Java/Swing Components/JGoodies Looks | JGoodies Looks]]
* [[Java/Swing Components/Label | Label]]
* [[Java/Swing Components/LayeredPane | LayeredPane]]
* [[Java/Swing Components/Link Button | Link Button]]
* [[Java/Swing Components/List | List]]
* [[Java/Swing Components/Outlook Bar | Outlook Bar]]
* [[Java/Swing Components/Panel | Panel]]
* [[Java/Swing Components/Property Sheet Table | Property Sheet Table]]
* [[Java/Swing Components/Separator | Separator]]
* [[Java/Swing Components/Slider | Slider]]
* [[Java/Swing Components/Status Bar | Status Bar]]
* [[Java/Swing Components/Swing Balloon | Swing Balloon]]
* [[Java/Swing Components/TabbedPane | TabbedPane]]
* [[Java/Swing Components/Taskpane | Taskpane]]
* [[Java/Swing Components/Timer | Timer]]
* [[Java/Swing Components/Tip of the Day | Tip of the Day]]
* [[Java/Swing Components/Tree | Tree]]
* [[Java/Swing Components/TreeTable | TreeTable]]
* [[Java/Swing Components/Wizard | Wizard]]

== A dialog allow selection and a font and its associated info. ==



<source lang="java">

/*
* Copyright (C) 2001-2004 Colin Bell
* colbell@users.sourceforge.net
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
import java.awt.BorderLayout;
import java.awt.Dialog;
import java.awt.Dimension;
import java.awt.Font;
import java.awt.Frame;
import java.awt.GraphicsEnvironment;
import java.awt.GridBagConstraints;
import java.awt.GridBagLayout;
import java.awt.Insets;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.io.Serializable;
import javax.swing.BorderFactory;
import javax.swing.JButton;
import javax.swing.JCheckBox;
import javax.swing.JComboBox;
import javax.swing.JDialog;
import javax.swing.JLabel;
import javax.swing.JPanel;
/**
* A dialog allow selection and a font and its associated info.
*
* @author
*/
public class FontChooser extends JDialog
{
private final boolean _selectStyles;
private JComboBox _fontNamesCmb;
private final JComboBox _fontSizesCmb = new JComboBox(new String[]
{ "8", "9", "10", "12", "14" });
private final JCheckBox _boldChk = new JCheckBox("Bold");
private final JCheckBox _italicChk = new JCheckBox("Italic");
private final JLabel _previewLbl = new JLabel("PreviewText");
private Font _font;
private ActionListener _previewUpdater;
/**
* Default ctor.
*/
public FontChooser()
{
this((Frame)null);
}
/**
* ctor specifying whether styles can be selected.
*
* @param selectStyles If <TT>true</TT> bold and italic checkboxes displayed.
*/
public FontChooser(boolean selectStyles)
{
this((Frame)null, selectStyles);
}
/**
* ctor specifying the parent frame.
*
* @param owner Parent frame.
*/
public FontChooser(Frame owner)
{
super(owner, "Font Chooser", true);
_selectStyles = true;
createUserInterface();
}
/**
* ctor specifying the parent frame and whether styles can be selected.
*
* @param owner Parent frame.
* @param selectStyles If <TT>true</TT> bold and italic checkboxes displayed.
*/
public FontChooser(Frame owner, boolean selectStyles)
{
super(owner, "Font Chooser", true);
_selectStyles = selectStyles;
createUserInterface();
}
/**
* ctor specifying the parent dialog.
*
* @param owner Parent frame.
*/
public FontChooser(Dialog owner)
{
super(owner, "Font Chooser", true);
_selectStyles = true;
createUserInterface();
}
/**
* ctor specifying the parent dialog and whether styles can be selected.
*
* @param owner Parent frame.
* @param selectStyles If <TT>true</TT> bold and italic checkboxes displayed.
*/
public FontChooser(Dialog owner, boolean selectStyles)
{
super(owner, "Font Chooser", true);
_selectStyles = selectStyles;
createUserInterface();
}
/**
* Component is being added to its parent.
*/
public void addNotify()
{
super.addNotify();
if (_previewUpdater == null)
{
_previewUpdater = new PreviewLabelUpdater();
_fontNamesCmb.addActionListener(_previewUpdater);
_fontSizesCmb.addActionListener(_previewUpdater);
_boldChk.addActionListener(_previewUpdater);
_italicChk.addActionListener(_previewUpdater);
}
}
/**
* Component is being removed from its parent.
*/
public void removeNotify()
{
super.removeNotify();
if (_previewUpdater != null)
{
_fontNamesCmb.removeActionListener(_previewUpdater);
_fontSizesCmb.removeActionListener(_previewUpdater);
_boldChk.removeActionListener(_previewUpdater);
_italicChk.removeActionListener(_previewUpdater);
_previewUpdater = null;
}
}
public Font showDialog()
{
return showDialog(null);
}
/**
* Show dialog defaulting to the passed font.
*
* @param font The font to default to.
*/
public Font showDialog(Font font)
{
if (font != null)
{
_fontNamesCmb.setSelectedItem(font.getName());
_fontSizesCmb.setSelectedItem("" + font.getSize());
_boldChk.setSelected(_selectStyles && font.isBold());
_italicChk.setSelected(_selectStyles && font.isItalic());
}
else
{
_fontNamesCmb.setSelectedIndex(0);
_fontSizesCmb.setSelectedIndex(0);
_boldChk.setSelected(false);
_italicChk.setSelected(false);
}
setupPreviewLabel();
setVisible(true);
return _font;
}
public Font getSelectedFont()
{
return _font;
}
protected void setupFontFromDialog()
{
int size = 12;
try
{
size = Integer.parseInt((String)_fontSizesCmb.getSelectedItem());
}
catch (Exception ignore)
{
// Ignore.
}
FontInfo fi = new FontInfo();
fi.setFamily((String)_fontNamesCmb.getSelectedItem());
fi.setSize(size);
fi.setIsBold(_boldChk.isSelected());
fi.setIsItalic(_italicChk.isSelected());
_font = fi.createFont();
}
private void createUserInterface()
{
final JPanel content = new JPanel(new GridBagLayout());
final GridBagConstraints gbc = new GridBagConstraints();
setContentPane(content);
content.setBorder(BorderFactory.createEmptyBorder(5, 5, 5, 5));
gbc.anchor = GridBagConstraints.WEST;
gbc.insets = new Insets(2, 2, 2, 2);
gbc.fill = GridBagConstraints.HORIZONTAL;
gbc.gridx = gbc.gridy = 0;
content.add(new JLabel("Font"), gbc);
++gbc.gridx;
content.add(new JLabel("Size"), gbc);
if (_selectStyles)
{
++gbc.gridx;
content.add(new JLabel("Style"), gbc);
}
++gbc.gridy;
gbc.gridx = 0;
_fontNamesCmb = new JComboBox(GraphicsEnvironment.getLocalGraphicsEnvironment().getAvailableFontFamilyNames());
content.add(_fontNamesCmb, gbc);
++gbc.gridx;
_fontSizesCmb.setEditable(true);
content.add(_fontSizesCmb, gbc);
if (_selectStyles)
{
++gbc.gridx;
content.add(_boldChk, gbc);
++gbc.gridy;
content.add(_italicChk, gbc);
}
gbc.gridx = 0;
++gbc.gridy;
gbc.gridwidth = GridBagConstraints.REMAINDER;
gbc.fill = GridBagConstraints.BOTH;
gbc.anchor = GridBagConstraints.CENTER;
content.add(createPreviewPanel(), gbc);
++gbc.gridy;
gbc.fill = GridBagConstraints.HORIZONTAL;
content.add(createButtonsPanel(), gbc);
pack();
setResizable(true);
}
private JPanel createPreviewPanel()
{
final JPanel pnl = new JPanel(new BorderLayout());
pnl.setBorder(BorderFactory.createTitledBorder("PreviewTitle"));
Dimension prefSize = _previewLbl.getPreferredSize();
prefSize.height = 50;
_previewLbl.setPreferredSize(prefSize);
pnl.add(_previewLbl, BorderLayout.CENTER);
setupPreviewLabel();
return pnl;
}
private JPanel createButtonsPanel()
{
JPanel pnl = new JPanel();
JButton okBtn = new JButton("OK");
okBtn.addActionListener(new ActionListener()
{
public void actionPerformed(ActionEvent evt)
{
setupFontFromDialog();
dispose();
}
});
JButton cancelBtn = new JButton("Cancel");
cancelBtn.addActionListener(new ActionListener()
{
public void actionPerformed(ActionEvent evt)
{
FontChooser.this._font = null;
dispose();
}
});
pnl.add(okBtn);
pnl.add(cancelBtn);
getRootPane().setDefaultButton(okBtn);
return pnl;
}
private void setupPreviewLabel()
{
setupFontFromDialog();
_previewLbl.setFont(_font);
}
private final class PreviewLabelUpdater implements ActionListener
{
public void actionPerformed(ActionEvent evt)
{
setupPreviewLabel();
}
}
}

/*
* Copyright (C) 2001-2003 Colin Bell
* colbell@users.sourceforge.net
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
class FontInfo implements Cloneable, Serializable
{
private static final long serialVersionUID = 1L;
public interface IPropertyNames
{
String FAMILY = "family";
String IS_BOLD = "isBold";
String IS_ITALIC = "isItalic";
String SIZE = "size";
}
private static String DEFAULT_FAMILY = "Monospaced";
private String _familyName;
private boolean _isBold;
private boolean _isItalic;
private int _size;
public FontInfo()
{
super();
setFamily(DEFAULT_FAMILY);
setSize(12);
}
public FontInfo(Font font)
{
super();
if (font == null)
{
throw new IllegalArgumentException("Null Font passed");
}
setFont(font);
}
/**
* Return a copy of this object.
*/
public Object clone()
{
try
{
return super.clone();
}
catch (CloneNotSupportedException ex)
{
throw new InternalError(ex.getMessage()); // Impossible.
}
}
public String getFamily()
{
return _familyName;
}
public void setFamily(String value)
{
_familyName = value != null ? value : DEFAULT_FAMILY;
}
public boolean isBold()
{
return _isBold;
}
public void setIsBold(boolean value)
{
_isBold = value;
}
public boolean isItalic()
{
return _isItalic;
}
public void setIsItalic(boolean value)
{
_isItalic = value;
}
public int getSize()
{
return _size;
}
public void setSize(int value)
{
_size = value;
}
public void setFont(Font font) throws IllegalArgumentException
{
if (font == null)
{
throw new IllegalArgumentException("Null Font passed");
}
_familyName = font.getFamily();
_isBold = font.isBold();
_isItalic = font.isItalic();
_size = font.getSize();
}
public boolean doesFontMatch(Font font)
{
if (font == null)
{
return false;
}
return font.getFamily().equals(_familyName)
&& font.getSize() == getSize()
&& font.getStyle() == generateStyle();
}
public int generateStyle()
{
int style = 0;
if (!_isBold && !_isItalic)
{
style = Font.PLAIN;
}
else
{
if (_isBold)
{
style |= Font.BOLD;
}
if (_isItalic)
{
style |= Font.ITALIC;
}
}
return style;
}
public Font createFont()
{
return new Font(_familyName, generateStyle(), _size);
}
// i18n ? What is this used for?
public String toString()
{
StringBuffer buf = new StringBuffer();
buf.append(_familyName).append(", " + _size);
if (_isBold)
{
buf.append(", bold");
}
if (_isItalic)
{
buf.append(", italic");
}
return buf.toString();
}
/**
* @see java.lang.Object#hashCode()
*/
@Override
public int hashCode() {
final int PRIME = 31;
int result = 1;
result = PRIME * result + ((_familyName == null) ? 0 : _familyName.hashCode());
result = PRIME * result + (_isBold ? 1231 : 1237);
result = PRIME * result + (_isItalic ? 1231 : 1237);
result = PRIME * result + _size;
return result;
}
/**
* @see java.lang.Object#equals(java.lang.Object)
*/
@Override
public boolean equals(Object obj) {
if (this == obj)
return true;
if (obj == null)
return false;
if (getClass() != obj.getClass())
return false;
final FontInfo other = (FontInfo) obj;
if (_familyName == null) {
if (other._familyName != null)
return false;
} else if (!_familyName.equals(other._familyName))
return false;
if (_isBold != other._isBold)
return false;
if (_isItalic != other._isItalic)
return false;
if (_size != other._size)
return false;
return true;
}
}

</source>



== FontChooser, adapted from NwFontChooserS by Noah Wairauch ==



<source lang="java">

/*BEGIN_COPYRIGHT_BLOCK
*
* Copyright (c) 2001-2008, JavaPLT group at Rice University (drjava@rice.edu)
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
* * Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
* * Neither the names of DrJava, the JavaPLT group, Rice University, nor the
* names of its contributors may be used to endorse or promote products
* derived from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
* PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
* LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
* This software is Open Source Initiative approved Open Source Software.
* Open Source Initative Approved is a trademark of the Open Source Initiative.
*
* This file is part of DrJava. Download the current version of this project
* from http://www.drjava.org/ or http://sourceforge.net/projects/drjava/
*
* END_COPYRIGHT_BLOCK*/

import javax.swing.*;
import javax.swing.event.ListSelectionEvent;
import javax.swing.event.ListSelectionListener;
import java.awt.*;
import java.awt.event.*;
/**
* FontChooser, adapted from NwFontChooserS by Noah Wairauch.
* (see http:///forum.java.sun.ru/thread.jsp?forum=57&thread=195067)
*
* @version $Id: FontChooser.java 4872 2009-04-06 21:37:28Z mgricken $
*/
public class FontChooser extends JDialog {
/** Available font styles.
*/
private static final String[] STYLES =
new String[] { "Plain", "Bold", "Italic", "Bold Italic" };
/** Available font sizes.
*/
private static final String[] SIZES =
new String[] { "3", "4", "5", "6", "7", "8", "9", "10", "11", "12",
"13", "14", "15", "16", "17", "18", "19", "20", "22",
"24", "27", "30", "34", "39", "45", "51", "60"};
// Lists to display
private NwList _styleList;
private NwList _fontList;
private NwList _sizeList;
// Swing elements
private JButton _okButton;
private JButton _cancelButton;
private JLabel _sampleText = new JLabel();
private boolean _clickedOK = false;
/** Constructs a new modal FontChooser for the given frame,
* using the specified font.
*/
private FontChooser(Frame parent, Font font) {
super(parent, true);
initAll();
if (font == null) font = _sampleText.getFont();
_fontList.setSelectedItem(font.getName());
_sizeList.setSelectedItem(font.getSize() + "");
_styleList.setSelectedItem(STYLES[font.getStyle()]);
//this.setResizable(false);
resize();
}
/** Method used to show the font chooser, and select a new font.
*
* @param parent The parent frame.
* @param title The title for this window.
* @param font The previously chosen font.
* @return the newly chosen font.
*/
public static Font showDialog(Frame parent, String title, Font font) {
FontChooser fd = new FontChooser(parent, font);
fd.setTitle(title);

fd.setVisible(true);
Font chosenFont = null;
if (fd.clickedOK()) {
chosenFont = fd.getFont();
}
fd.dispose();
return (chosenFont);
}
/** Shows the font chooser with a standard title ("Font Chooser").
*/
public static Font showDialog(Frame parent, Font font) {
return showDialog(parent, "Font Chooser", font);
}
private void initAll() {
getContentPane().setLayout(null);
setBounds(50, 50, 425, 400);
_sampleText = new JLabel();
addLists();
addButtons();
_sampleText.setForeground(Color.black);
getContentPane().add(_sampleText);
addWindowListener(new WindowAdapter() {
public void windowClosing(java.awt.event.WindowEvent e) {
setVisible(false);
}
});
addComponentListener(new ComponentAdapter() {
public void componentResized(ComponentEvent evt) {
resize();
}
});
}
private void resize() {
int w = getWidth();
int h = getHeight();
double wf = (double) w / 425;
int w2 = (int) (80 * wf);
int w3 = (int) (50 * wf);
if (w3 < 30) w3 = 30;
int w1 = w - w2 - w3 - 25;
_fontList.setBounds(5, 5, w1, h - 91);
_styleList.setBounds(w1 + 10, 5, w2, h - 91);
_sizeList.setBounds(w1 + w2 + 15, 5, w3, h - 91);
_sampleText.setBounds(10, h - 78, w - 20, 45);
_okButton.setBounds(w - 165, h - 55, 70, 20);
_cancelButton.setBounds(w - 81, h - 55, 70, 20);
validate();
}
private void addLists() {
_fontList = new NwList(GraphicsEnvironment.getLocalGraphicsEnvironment().getAvailableFontFamilyNames());
_styleList = new NwList(STYLES);
_sizeList = new NwList(SIZES);
getContentPane().add(_fontList);
getContentPane().add(_styleList);
getContentPane().add(_sizeList);
}
private void addButtons() {
_okButton = new JButton("OK");
_okButton.setMargin(new Insets(0, 0, 0, 0));
_cancelButton = new JButton("Cancel");
_cancelButton.setMargin(new Insets(0, 0, 0, 0));
_okButton.setFont(new Font(" ", 1, 11));
_cancelButton.setFont(new Font(" ", 1, 12));
getContentPane().add(_okButton);
getContentPane().add(_cancelButton);
_okButton.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
setVisible(false);
_clickedOK = true;
}
});
_cancelButton.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
setVisible(false);
_clickedOK = false;
}
});
}
private void showSample() {
int g = 0;
try { g = Integer.parseInt(_sizeList.getSelectedValue()); }
catch (NumberFormatException nfe) { /* do nothing */ }
String st = _styleList.getSelectedValue();
int s = Font.PLAIN;
if (st.equalsIgnoreCase("Bold")) s = Font.BOLD;
if (st.equalsIgnoreCase("Italic")) s = Font.ITALIC;
if (st.equalsIgnoreCase("Bold Italic")) s = Font.BOLD | Font.ITALIC;
_sampleText.setFont(new Font(_fontList.getSelectedValue(), s, g));
_sampleText.setText("The quick brown fox jumped over the lazy dog.");
_sampleText.setVerticalAlignment(SwingConstants.TOP);
}
/** Returns whether the user clicked OK when the dialog was closed. (If false, the user clicked cancel.) */
public boolean clickedOK() { return _clickedOK; }
/** Returns the currently selected Font. */
public Font getFont() { return _sampleText.getFont(); }
/** Private inner class for a list which displays a list of options in addition to a label indicating the currently
* selected item.
*/
public class NwList extends JPanel {
JList jl;
JScrollPane sp;
JLabel jt;
String si = " ";
public NwList(String[] values) {
setLayout(null);
jl = new JList(values);
sp = new JScrollPane(jl);
jt = new JLabel();
jt.setBackground(Color.white);
jt.setForeground(Color.black);
jt.setOpaque(true);
jt.setBorder(new JTextField().getBorder());
jt.setFont(getFont());
jl.addListSelectionListener(new ListSelectionListener() {
public void valueChanged(ListSelectionEvent e) {
jt.setText((String) jl.getSelectedValue());
si = (String) jl.getSelectedValue();
showSample();
}
});
add(sp);
add(jt);
}
public void setBounds(int x, int y, int w, int h) {
super.setBounds(x, y, w, h);
sp.setBounds(0, y + 16, w, h - 23);
sp.revalidate();
jt.setBounds(0, 0, w, 20);
}
public String getSelectedValue() { return (si); }
public void setSelectedItem(String s) { jl.setSelectedValue(s, true);}
}
}

</source>



== FontChooser by Noah w ==



<source lang="java">

/* This code was found posted on a forum without any copyright
* restrictions. It was written by someone named Noah W.
* That"s all I know */
/* I have modified the original code but claim no copyright on it of any kind */

/*
This file is part of BORG.
BORG is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
BORG is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with BORG; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Copyright 2003 by Mike Berger
*/

import java.awt.Color;
import java.awt.Font;
import java.awt.Frame;
import java.awt.GraphicsEnvironment;
import java.awt.Insets;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;
import java.util.Enumeration;
import javax.swing.JButton;
import javax.swing.JDialog;
import javax.swing.JLabel;
import javax.swing.JList;
import javax.swing.JPanel;
import javax.swing.JScrollPane;
import javax.swing.JTextField;
import javax.swing.UIManager;
import javax.swing.event.ListSelectionEvent;
import javax.swing.event.ListSelectionListener;
import javax.swing.plaf.FontUIResource;

//
// FontChooser by Noah w.
//
public class NwFontChooserS extends JDialog {
String[] styleList = new String[] { "Plain", "Bold", "Italic" };
String[] sizeList =
new String[] {
"3",
"4",
"5",
"6",
"7",
"8",
"9",
"10",
"11",
"12",
"13",
"14",
"15",
"16",
"17",
"18",
"19",
"20",
"22",
"24",
"27",
"30",
"34",
"39",
"45",
"51",
"60" };
NwList StyleList;
NwList FontList;
NwList SizeList;
static JLabel Sample = new JLabel();
boolean ob = false;

private NwFontChooserS(Frame parent, boolean modal, Font font) {
super(parent, modal);
initAll();
setTitle("Font Choosr");
if (font == null)
font = Sample.getFont();
FontList.setSelectedItem(font.getName());
SizeList.setSelectedItem(font.getSize() + "");
StyleList.setSelectedItem(styleList[font.getStyle()]);

}
public static Font showDialog(Frame parent, String s, Font font) {
NwFontChooserS fd = new NwFontChooserS(parent, true, font);
if (s != null)
fd.setTitle(s);
fd.setVisible(true);
Font fo = null;
if (fd.ob)
fo = Sample.getFont();
fd.dispose();
return (fo);
}
private void initAll() {
getContentPane().setLayout(null);
setBounds(50, 50, 450, 450);
addLists();
addButtons();
Sample.setBounds(10, 320, 415, 25);
Sample.setForeground(Color.black);
getContentPane().add(Sample);
addWindowListener(new WindowAdapter() {
public void windowClosing(WindowEvent e) {
setVisible(false);
}
});
}
private void addLists() {
FontList =
new NwList(
GraphicsEnvironment
.getLocalGraphicsEnvironment()
.getAvailableFontFamilyNames());
StyleList = new NwList(styleList);
SizeList = new NwList(sizeList);
FontList.setBounds(10, 10, 260, 295);
StyleList.setBounds(280, 10, 80, 295);
SizeList.setBounds(370, 10, 40, 295);
getContentPane().add(FontList);
getContentPane().add(StyleList);
getContentPane().add(SizeList);
}
private void addButtons() {
JButton ok = new JButton("OK");
ok.setMargin(new Insets(0, 0, 0, 0));
JButton ca = new JButton("Cancel");
ca.setMargin(new Insets(0, 0, 0, 0));
ok.setBounds(260, 350, 70, 20);
ok.setFont(new Font(" ", 1, 11));
ca.setBounds(340, 350, 70, 20);
ca.setFont(new Font(" ", 1, 12));
getContentPane().add(ok);
getContentPane().add(ca);
ok.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
setVisible(false);
ob = true;
}
});
ca.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
setVisible(false);
ob = false;
}
});
}
private void showSample() {
int g = 0;
try {
g = Integer.parseInt(SizeList.getSelectedValue());
}
catch (NumberFormatException nfe) {
}
String st = StyleList.getSelectedValue();
int s = Font.PLAIN;
if (st.equalsIgnoreCase("Bold"))
s = Font.BOLD;
if (st.equalsIgnoreCase("Italic"))
s = Font.ITALIC;
Sample.setFont(new Font(FontList.getSelectedValue(), s, g));
Sample.setText("The quick brown fox jumped over the lazy dog.");
}
//////////////////////////////////////////////////////////////////////
private class NwList extends JPanel {
JList jl;
JScrollPane sp;
JLabel jt;
String si = " ";

public NwList(String[] values) {
setLayout(null);
jl = new JList(values);
sp = new JScrollPane(jl);
jt = new JLabel();
jt.setBackground(Color.white);
jt.setForeground(Color.black);
jt.setOpaque(true);
jt.setBorder(new JTextField().getBorder());
jt.setFont(getFont());
jl.setBounds(0, 0, 100, 1000);
jl.setBackground(Color.white);
jl.addListSelectionListener(new ListSelectionListener() {
public void valueChanged(ListSelectionEvent e) {
jt.setText((String) jl.getSelectedValue());
si = (String) jl.getSelectedValue();
showSample();
}
});
add(sp);
add(jt);
}
public String getSelectedValue() {
return (si);
}
public void setSelectedItem(String s) {
jl.setSelectedValue(s, true);
}
public void setBounds(int x, int y, int w, int h) {
super.setBounds(x, y, w, h);
sp.setBounds(0, y + 12, w, h - 23);
sp.revalidate();
jt.setBounds(0, 0, w, 20);
}
}

static public String fontString(Font font) {
String fs = font.getFamily();
if( !font.isPlain() ) {
fs += "-";
if( font.isBold()) {
fs += "BOLD";
}
if( font.isItalic()) {
fs += "ITALIC";
}
}
fs += "-" + font.getSize();
return(fs);
}

static public void setDefaultFont(Font f ) {
FontUIResource fui = new FontUIResource(f);
Enumeration<Object> keys = UIManager.getDefaults().keys();
while (keys.hasMoreElements()) {
Object key = keys.nextElement();
Object value = UIManager.get(key);
if (value instanceof FontUIResource)
UIManager.put(key, fui);
}

}

public static void main(String args[]) {
Font font = null;
font = NwFontChooserS.showDialog(null, null, null);

System.out.println(fontString(font));
}
}

</source>



== Font Chooser extends javax.swing.JDialog ==



<source lang="java">

/*
Atlantida is an open source (GPL) multilingual dictionary written in Java.
It can translate words from one language to another and pronounce them.
Copyright (C) 2006 Sergey S. http://atla.revdanica.ru/
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/**
* FontChooser
* @author Janos Szatmary, Sergei S.
* @version 003
*/
/*
* http://forum.java.sun.ru/thread.jsp?forum=57&thread=124810
* For those who asked where"s the constructor, have in mind that the constructor provided
* is private. As the author of the code says, the use of this class is as
* follows (supposing we are in a Frame class):
* FontChooser.showDialog(this,"FontChooser",new Font("Dialog", 0, 12));
* This file originally writter by Janos Szatmary, then modifyed by Sergei S. for
* Atlantida Multilingual Dictionary http://atla.sf.net
*/

import java.awt.*;
import java.awt.event.*;
import java.util.*;
import javax.swing.*;

public class FontChooser extends javax.swing.JDialog
{
String[] styleList = new String[]
{ "Plain","Bold","Italic"};
String[] sizeList = new String[]
{ "2","4","6","8","10","12","14","16","18","20","22","24","30","36","48","72"};
String currentFont = null;
int currentStyle = -1;
int currentSize = -1;
public boolean ok = false;
/* ------------------------------------------------------------- */
private FontChooser(java.awt.Frame parent,boolean modal)
{
super (parent,modal);
initComponents();
setListValues(jFontList,GraphicsEnvironment.getLocalGraphicsEnvironment().getAvailableFontFamilyNames());
setListValues(jStyleList,styleList);
setListValues(jSizeList,sizeList);
setCurrentFont(jSample.getFont());
pack();
}
private FontChooser(java.awt.Frame parent,boolean modal,Font font)
{
this(parent,modal);
setCurrentFont(font);
}
/* ------------------------------------------------------------- */
private void setListValues(JList list,String[] values)
{
if(list.getModel() instanceof DefaultListModel)
{
DefaultListModel model = (DefaultListModel)
list.getModel();
model.removeAllElements();
for( String value : values )
{
model.addElement( value );
}
}
}
/* ------------------------------------------------------------- */
private void setSampleFont()
{
if(currentFont != null && currentStyle >= 0 && currentSize > 0)
{
jSample.setFont(new Font
(currentFont,currentStyle,currentSize));
}
}
private String styleToString(int style)
{
String str = "";
if((style&Font.BOLD) == Font.BOLD)
{
if(str.length() > 0)
{
str += ",";
}
str += "Bold";
}
if((style&Font.ITALIC) == Font.ITALIC)
{
if(str.length() > 0)
{
str += ",";
}
str += "Italic";
}
if( str.length() <= 0 )
{
str = "Plain";
}
return str;
}
/* ------------------------------------------------------------- */
public Font getCurrentFont()
{
return jSample.getFont();
}
/* ------------------------------------------------------------- */
public void setCurrentFont(Font font)
{
if(font==null)
{
font = jSample.getFont();
}
jFont.setText(font.getName());
jFontActionPerformed(null);
jStyle.setText(styleToString(font.getStyle()));
jStyleActionPerformed(null);
jSize.setText(Integer.toString(font.getSize()));
jSizeActionPerformed(null);
}

// Create font chooser dialog.
// If user selected a font (i.e. clicked OK button) - return the font that user has selected.
// If user didn"t click OK button - return "null".
public static Font showDialog( Frame parent, String title, Font font)
{
FontChooser dialog = new FontChooser(parent,true,font);
Point p1 = parent.getLocation();
Dimension d1 = parent.getSize();
Dimension d2 = dialog.getSize();
int x = p1.x+(d1.width-d2.width)/2;
int y = p1.y+(d1.height-d2.height)/2;
if(x < 0)
{
x = 0;
}
if(y < 0)
{
y = 0;
}
if(title!=null)
{
dialog.setTitle(title);
}
dialog.setLocation(x,y);
dialog.setVisible(true);
Font newfont = null;
if(dialog.ok)
{
newfont = dialog.getCurrentFont();
}
dialog.dispose();
return newfont;
}
/** This method is called from within the constructor to
* initialize the form.
* WARNING: Do NOT modify this code. The content of this method is
* always regenerated by the FormEditor.
*/
private void initComponents()
{
jPanel3 = new javax.swing.JPanel();
jFont = new javax.swing.JTextField();
jScrollPane1 = new javax.swing.JScrollPane();
jFontList = new javax.swing.JList();
jPanel4 = new javax.swing.JPanel();
jStyle = new javax.swing.JTextField();
jScrollPane2 = new javax.swing.JScrollPane();
jStyleList = new javax.swing.JList();
jPanel5 = new javax.swing.JPanel();
jSize = new javax.swing.JTextField();
jScrollPane3 = new javax.swing.JScrollPane();
jSizeList = new javax.swing.JList();
jPanel1 = new javax.swing.JPanel();
jScrollPane4 = new javax.swing.JScrollPane();
jSample = new javax.swing.JTextArea();
jButtons = new javax.swing.JPanel();
jOk = new javax.swing.JButton();
jCancel = new javax.swing.JButton();
jLabel6 = new javax.swing.JLabel();
getContentPane().setLayout(new java.awt.GridBagLayout());
java.awt.GridBagConstraints gridBagConstraints1;
setTitle("Font Chooser");
addWindowListener(new java.awt.event.WindowAdapter()
{
public void windowClosing(java.awt.event.WindowEvent evt)
{
closeDialog(evt);
}
}
);
jPanel3.setLayout(new java.awt.GridBagLayout());
java.awt.GridBagConstraints gridBagConstraints2;
jPanel3.setBorder(new javax.swing.border.TitledBorder(new javax.swing.border.EtchedBorder(), " Font "));
jFont.setColumns(24);
jFont.addActionListener(new java.awt.event.ActionListener()
{
public void actionPerformed(java.awt.event.ActionEvent evt)
{
jFontActionPerformed(evt);
}
}
);
gridBagConstraints2 = new java.awt.GridBagConstraints();
gridBagConstraints2.gridwidth = 0;
gridBagConstraints2.fill =
java.awt.GridBagConstraints.HORIZONTAL;
gridBagConstraints2.insets = new java.awt.Insets(0, 3, 0, 3);
gridBagConstraints2.anchor = java.awt.GridBagConstraints.NORTHWEST;
gridBagConstraints2.weightx = 1.0;
jPanel3.add(jFont, gridBagConstraints2);

jFontList.setModel(new DefaultListModel());
jFontList.setSelectionMode(javax.swing.ListSelectionModel.SINGLE_SELECTION);
jFontList.addListSelectionListener(new javax.swing.event.ListSelectionListener()
{
public void valueChanged(javax.swing.event.ListSelectionEvent evt)
{
jFontListValueChanged(evt);
}
}
);
jScrollPane1.setViewportView(jFontList);
gridBagConstraints2 = new java.awt.GridBagConstraints();
gridBagConstraints2.fill = java.awt.GridBagConstraints.BOTH;
gridBagConstraints2.insets = new java.awt.Insets(3, 3, 3, 3);
gridBagConstraints2.anchor = java.awt.GridBagConstraints.NORTHWEST;
gridBagConstraints2.weightx = 1.0;
gridBagConstraints2.weighty = 1.0;
jPanel3.add(jScrollPane1, gridBagConstraints2);

gridBagConstraints1 = new java.awt.GridBagConstraints();
gridBagConstraints1.fill = java.awt.GridBagConstraints.BOTH;
gridBagConstraints1.insets = new java.awt.Insets(5, 5, 0, 0);
gridBagConstraints1.weightx = 0.5;
gridBagConstraints1.weighty = 1.0;
getContentPane().add(jPanel3, gridBagConstraints1);

jPanel4.setLayout(new java.awt.GridBagLayout());
java.awt.GridBagConstraints gridBagConstraints3;
jPanel4.setBorder(new javax.swing.border.TitledBorder(new javax.swing.border.EtchedBorder(), " Style "));
jStyle.setColumns(18);
jStyle.addActionListener(new java.awt.event.ActionListener()
{
public void actionPerformed(java.awt.event.ActionEvent evt)
{
jStyleActionPerformed(evt);
}
}
);
gridBagConstraints3 = new java.awt.GridBagConstraints();
gridBagConstraints3.gridwidth = 0;
gridBagConstraints3.fill =
java.awt.GridBagConstraints.HORIZONTAL;
gridBagConstraints3.insets = new java.awt.Insets(0, 3, 0, 3);
gridBagConstraints3.anchor = java.awt.GridBagConstraints.NORTHWEST;
gridBagConstraints3.weightx = 1.0;
jPanel4.add(jStyle, gridBagConstraints3);
jStyleList.setModel(new DefaultListModel());
jStyleList.setVisibleRowCount(4);
jStyleList.addListSelectionListener(new javax.swing.event.ListSelectionListener()
{
public void valueChanged(javax.swing.event.ListSelectionEvent evt)
{
jStyleListValueChanged(evt);
}
}
);
jScrollPane2.setViewportView(jStyleList);
gridBagConstraints3 = new java.awt.GridBagConstraints();
gridBagConstraints3.fill = java.awt.GridBagConstraints.BOTH;
gridBagConstraints3.insets = new java.awt.Insets(3, 3, 3, 3);
gridBagConstraints3.anchor = java.awt.GridBagConstraints.NORTHWEST;
gridBagConstraints3.weightx = 0.5;
gridBagConstraints3.weighty = 1.0;
jPanel4.add(jScrollPane2, gridBagConstraints3);
gridBagConstraints1 = new java.awt.GridBagConstraints();
gridBagConstraints1.fill = java.awt.GridBagConstraints.BOTH;
gridBagConstraints1.insets = new java.awt.Insets(5, 5, 0, 0);
gridBagConstraints1.weightx = 0.375;
gridBagConstraints1.weighty = 1.0;
getContentPane().add(jPanel4, gridBagConstraints1);
jPanel5.setLayout(new java.awt.GridBagLayout());
java.awt.GridBagConstraints gridBagConstraints4;
jPanel5.setBorder(new javax.swing.border.TitledBorder(new javax.swing.border.EtchedBorder(), " Size "));
jSize.setColumns(6);
jSize.addActionListener(new
java.awt.event.ActionListener()
{
public void actionPerformed(java.awt.event.ActionEvent evt)
{
jSizeActionPerformed(evt);
}
}
);
gridBagConstraints4 = new java.awt.GridBagConstraints();
gridBagConstraints4.gridwidth = 0;
gridBagConstraints4.fill = java.awt.GridBagConstraints.HORIZONTAL;
gridBagConstraints4.insets = new java.awt.Insets(0, 3, 0, 3);
gridBagConstraints4.anchor = java.awt.GridBagConstraints.NORTHWEST;
gridBagConstraints4.weightx = 1.0;
jPanel5.add(jSize, gridBagConstraints4);
jSizeList.setModel(new DefaultListModel());
jSizeList.setVisibleRowCount(4);
jSizeList.setSelectionMode(javax.swing.ListSelectionModel.SINGLE_SELECTION);
jSizeList.addListSelectionListener(new javax.swing.event.ListSelectionListener()
{
public void valueChanged(javax.swing.event.ListSelectionEvent evt)
{
jSizeListValueChanged(evt);
}
}
);
jScrollPane3.setViewportView(jSizeList);
gridBagConstraints4 = new java.awt.GridBagConstraints();
gridBagConstraints4.fill = java.awt.GridBagConstraints.BOTH;
gridBagConstraints4.insets = new java.awt.Insets(3, 3, 3, 3);
gridBagConstraints4.anchor = java.awt.GridBagConstraints.NORTHWEST;
gridBagConstraints4.weightx = 0.25;
gridBagConstraints4.weighty = 1.0;
jPanel5.add(jScrollPane3, gridBagConstraints4);
gridBagConstraints1 = new java.awt.GridBagConstraints();
gridBagConstraints1.gridwidth = 0;
gridBagConstraints1.fill = java.awt.GridBagConstraints.BOTH;
gridBagConstraints1.insets = new java.awt.Insets(5, 5, 0, 5);
gridBagConstraints1.weightx = 0.125;
gridBagConstraints1.weighty = 1.0;
getContentPane().add(jPanel5, gridBagConstraints1);
jPanel1.setLayout(new java.awt.GridBagLayout());
java.awt.GridBagConstraints gridBagConstraints5;
jPanel1.setBorder(new javax.swing.border.TitledBorder(new javax.swing.border.EtchedBorder(), " Sample "));
jSample.setWrapStyleWord(true);
jSample.setLineWrap(true);
jSample.setColumns(20);
jSample.setRows(3);
jSample.setText("The quick brown fox jumped over the lazy dog.");
jScrollPane4.setViewportView(jSample);
gridBagConstraints5 = new java.awt.GridBagConstraints();
gridBagConstraints5.fill = java.awt.GridBagConstraints.BOTH;
gridBagConstraints5.insets = new java.awt.Insets(0, 3, 3, 3);
gridBagConstraints5.weightx = 1.0;
gridBagConstraints5.weighty = 1.0;
jPanel1.add(jScrollPane4, gridBagConstraints5);
gridBagConstraints1 = new java.awt.GridBagConstraints();
gridBagConstraints1.gridwidth = 0;
gridBagConstraints1.fill = java.awt.GridBagConstraints.BOTH;
gridBagConstraints1.insets = new java.awt.Insets(0, 5, 0, 5);
gridBagConstraints1.anchor = java.awt.GridBagConstraints.NORTHWEST;
gridBagConstraints1.weightx = 1.0;
getContentPane().add(jPanel1, gridBagConstraints1);
jButtons.setLayout(new java.awt.GridBagLayout());
java.awt.GridBagConstraints gridBagConstraints6;
jOk.setMnemonic(KeyEvent.VK_O);
jOk.setText("OK");
jOk.setRequestFocusEnabled(false);
jOk.addActionListener(new java.awt.event.ActionListener()
{
public void actionPerformed(java.awt.event.ActionEvent evt)
{
jOkActionPerformed(evt);
}
}
);
gridBagConstraints6 = new java.awt.GridBagConstraints();
gridBagConstraints6.insets = new java.awt.Insets(5, 5, 5, 0);
gridBagConstraints6.anchor = java.awt.GridBagConstraints.WEST;
jButtons.add(jOk, gridBagConstraints6);

jCancel.setMnemonic(KeyEvent.VK_C);
jCancel.setText("Cancel");
jCancel.setRequestFocusEnabled(false);
jCancel.addActionListener(new
java.awt.event.ActionListener()
{
public void actionPerformed(java.awt.event.ActionEvent evt)
{
jCancelActionPerformed(evt);
}
}
);
gridBagConstraints6 = new java.awt.GridBagConstraints();
gridBagConstraints6.gridwidth = 0;
gridBagConstraints6.insets = new java.awt.Insets(5, 5, 5, 5);
gridBagConstraints6.anchor = java.awt.GridBagConstraints.WEST;
gridBagConstraints6.weightx = 1.0;
jButtons.add(jCancel, gridBagConstraints6);
gridBagConstraints6 = new java.awt.GridBagConstraints();
gridBagConstraints6.weightx = 1.0;
jButtons.add(jLabel6, gridBagConstraints6);
gridBagConstraints1 = new java.awt.GridBagConstraints();
gridBagConstraints1.gridwidth = 0;
gridBagConstraints1.anchor = java.awt.GridBagConstraints.SOUTHWEST;
gridBagConstraints1.weightx = 1.0;
getContentPane().add(jButtons, gridBagConstraints1);
}
private void jCancelActionPerformed(java.awt.event.ActionEvent evt)
{
// Add your handling code here:
setVisible(false);
}
private void jOkActionPerformed (java.awt.event.ActionEvent evt)
{
// Add your handling code here:
ok = true;
setVisible(false);
}
private void jSizeActionPerformed (java.awt.event.ActionEvent evt)
{
// Add your handling code here:
int size = Integer.parseInt(jSize.getText());
if(size > 0)
{
currentSize = size;
setSampleFont();
}
}
private void jStyleActionPerformed (java.awt.event.ActionEvent evt)
{
// Add your handling code here:
StringTokenizer st = new StringTokenizer(jStyle.getText(),",");
int style = 0;
while(st.hasMoreTokens())
{
String str = st.nextToken().trim();
if(str.equalsIgnoreCase("Plain"))
{
style |= Font.PLAIN;
}
else
if(str.equalsIgnoreCase("Bold"))
{
style |= Font.BOLD;
}
else
if(str.equalsIgnoreCase("Italic"))
{
style |= Font.ITALIC;
}
}
if(style >= 0)
{
currentStyle = style;
setSampleFont();
}
}
private void jFontActionPerformed (java.awt.event.ActionEvent evt)
{
// Add your handling code here:
DefaultListModel model = (DefaultListModel)
jFontList.getModel();
if(model.indexOf(jFont.getText()) >= 0)
{
currentFont = jFont.getText();
setSampleFont();
}
}
private void jStyleListValueChanged(javax.swing.event.ListSelectionEvent evt)
{
// Add your handling code here:
String str = "";
Object[] values = jStyleList.getSelectedValues();
if(values.length > 0)
{
int j;
for(j=0; j < values.length; j++)
{
String s = (String) values[j];
if(s.equalsIgnoreCase("Plain"))
{
str = "Plain"; break;
}
if(str.length() > 0)
{
str += ",";
}
str += (String) values[j];
}
}
else
{
str = styleToString(currentStyle);
}
jStyle.setText(str);
jStyleActionPerformed(null);
}
private void jSizeListValueChanged(javax.swing.event.ListSelectionEvent evt)
{
// Add your handling code here:
String str = (String) jSizeList.getSelectedValue();
if(str==null || str.length() <= 0)
{
str = Integer.toString(currentSize);
}
jSize.setText(str);
jSizeActionPerformed(null);
}
private void jFontListValueChanged(javax.swing.event.ListSelectionEvent evt)
{
// Add your handling code here:
String str = (String) jFontList.getSelectedValue();
if(str==null || str.length() <= 0)
{
str = currentFont;
}
jFont.setText(str);
jFontActionPerformed(null);
}
/** Closes the dialog */
private void closeDialog(java.awt.event.WindowEvent evt)
{
setVisible (false);
}
// Variables declaration - do not modify
private javax.swing.JPanel jPanel3;
private javax.swing.JTextField jFont;
private javax.swing.JScrollPane jScrollPane1;
private javax.swing.JList jFontList;
private javax.swing.JPanel jPanel4;
private javax.swing.JTextField jStyle;
private javax.swing.JScrollPane jScrollPane2;
private javax.swing.JList jStyleList;
private javax.swing.JPanel jPanel5;
private javax.swing.JTextField jSize;
private javax.swing.JScrollPane jScrollPane3;
private javax.swing.JList jSizeList;
private javax.swing.JPanel jPanel1;
private javax.swing.JScrollPane jScrollPane4;
private javax.swing.JTextArea jSample;
private javax.swing.JPanel jButtons;
private javax.swing.JButton jOk;
private javax.swing.JButton jCancel;
private javax.swing.JLabel jLabel6;
// End of variables declaration
}

</source>



== Font Chooser Source Code ==

== Font dialog ==



<source lang="java">

/*
* JCommon : a free general purpose class library for the Java(tm) platform
*
*
* (C) Copyright 2000-2005, by Object Refinery Limited and Contributors.
*
* Project Info: http://www.jfree.org/jcommon/index.html
*
* This library is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation; either version 2.1 of the License, or
* (at your option) any later version.
*
* This library is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
* License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
* USA.
*
* [Java is a trademark or registered trademark of Sun Microsystems, Inc.
* in the United States and other countries.]
*
* ----------------------
* FontChooserDialog.java
* ----------------------
* (C) Copyright 2000-2004, by Object Refinery Limited.
*
* Original Author: David Gilbert (for Object Refinery Limited);
* Contributor(s): -;
*
* $Id: FontChooserDialog.java,v 1.5 2007/11/02 17:50:36 taqua Exp $
*
* Changes (from 26-Oct-2001)
* --------------------------
* 26-Oct-2001 : Changed package to com.jrefinery.ui.*;
* 14-Oct-2002 : Fixed errors reported by Checkstyle (DG);
*
*/
import java.awt.BorderLayout;
import java.awt.Dialog;
import java.awt.Font;
import java.awt.Frame;
import java.awt.GraphicsEnvironment;
import java.awt.GridLayout;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import javax.swing.BorderFactory;
import javax.swing.JButton;
import javax.swing.JCheckBox;
import javax.swing.JDialog;
import javax.swing.JList;
import javax.swing.JPanel;
import javax.swing.JScrollPane;
import javax.swing.JTextField;
import javax.swing.ListModel;
/**
* A dialog for choosing a font from the available system fonts.
*
* @author David Gilbert
*/
public class FontChooserDialog extends StandardDialog {
/** The panel within the dialog that contains the font selection controls. */
private FontChooserPanel fontChooserPanel;
/**
* Standard constructor - builds a font chooser dialog owned by another dialog.
*
* @param owner the dialog that "owns" this dialog.
* @param title the title for the dialog.
* @param modal a boolean that indicates whether or not the dialog is modal.
* @param font the initial font displayed.
*/
public FontChooserDialog(final Dialog owner, final String title, final boolean modal, final Font font) {
super(owner, title, modal);
setContentPane(createContent(font));
}
/**
* Standard constructor - builds a font chooser dialog owned by a frame.
*
* @param owner the frame that "owns" this dialog.
* @param title the title for the dialog.
* @param modal a boolean that indicates whether or not the dialog is modal.
* @param font the initial font displayed.
*/
public FontChooserDialog(final Frame owner, final String title, final boolean modal, final Font font) {
super(owner, title, modal);
setContentPane(createContent(font));
}
/**
* Returns the selected font.
*
* @return the font.
*/
public Font getSelectedFont() {
return this.fontChooserPanel.getSelectedFont();
}
/**
* Returns the panel that is the user interface.
*
* @param font the font.
*
* @return the panel.
*/
private JPanel createContent(Font font) {
final JPanel content = new JPanel(new BorderLayout());
content.setBorder(BorderFactory.createEmptyBorder(4, 4, 4, 4));
if (font == null) {
font = new Font("Dialog", 10, Font.PLAIN);
}
this.fontChooserPanel = new FontChooserPanel(font);
content.add(this.fontChooserPanel);
final JPanel buttons = createButtonPanel();
buttons.setBorder(BorderFactory.createEmptyBorder(4, 0, 0, 0));
content.add(buttons, BorderLayout.SOUTH);
return content;
}
}
/*
* JCommon : a free general purpose class library for the Java(tm) platform
* s
*
* (C) Copyright 2000-2008, by Object Refinery Limited and Contributors.
*
* Project Info: http://www.jfree.org/jcommon/index.html
*
* This library is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation; either version 2.1 of the License, or
* (at your option) any later version.
*
* This library is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
* License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
* USA.
*
* [Java is a trademark or registered trademark of Sun Microsystems, Inc.
* in the United States and other countries.]
*
* ---------------------
* FontChooserPanel.java
* ---------------------
* (C) Copyright 2000-2008, by Object Refinery Limited.
*
* Original Author: David Gilbert (for Object Refinery Limited);
* Contributor(s): Arnaud Lelievre;
*
* $Id: FontChooserPanel.java,v 1.6 2008/12/18 09:57:32 mungady Exp $
*
* Changes (from 26-Oct-2001)
* --------------------------
* 26-Oct-2001 : Changed package to com.jrefinery.ui.*;
* 14-Oct-2002 : Fixed errors reported by Checkstyle (DG);
* 08-Sep-2003 : Added internationalization via use of properties resourceBundle (RFE 690236) (AL);
* 21-Feb-2004 : The FontParameter of the constructor was never used (TM);
* 18-Dec-2008 : Use ResourceBundleWrapper - see JFreeChart patch 1607918 by
* Jess Thrysoee (DG);
*
*/
/**
* A panel for choosing a font from the available system fonts - still a bit of
* a hack at the moment, but good enough for demonstration applications.
*
* @author David Gilbert
*/
class FontChooserPanel extends JPanel {
/** The font sizes that can be selected. */
public static final String[] SIZES = {"9", "10", "11", "12", "14", "16",
"18", "20", "22", "24", "28", "36", "48", "72"};
/** The list of fonts. */
private JList fontlist;
/** The list of sizes. */
private JList sizelist;
/** The checkbox that indicates whether the font is bold. */
private JCheckBox bold;
/** The checkbox that indicates whether or not the font is italic. */
private JCheckBox italic;

/**
* Standard constructor - builds a FontChooserPanel initialised with the
* specified font.
*
* @param font the initial font to display.
*/
public FontChooserPanel(final Font font) {
final GraphicsEnvironment g
= GraphicsEnvironment.getLocalGraphicsEnvironment();
final String[] fonts = g.getAvailableFontFamilyNames();
setLayout(new BorderLayout());
final JPanel right = new JPanel(new BorderLayout());
final JPanel fontPanel = new JPanel(new BorderLayout());
fontPanel.setBorder(BorderFactory.createTitledBorder(
BorderFactory.createEtchedBorder(),
"Font"));
this.fontlist = new JList(fonts);
final JScrollPane fontpane = new JScrollPane(this.fontlist);
fontpane.setBorder(BorderFactory.createEtchedBorder());
fontPanel.add(fontpane);
add(fontPanel);
final JPanel sizePanel = new JPanel(new BorderLayout());
sizePanel.setBorder(BorderFactory.createTitledBorder(
BorderFactory.createEtchedBorder(),
"Size"));
this.sizelist = new JList(SIZES);
final JScrollPane sizepane = new JScrollPane(this.sizelist);
sizepane.setBorder(BorderFactory.createEtchedBorder());
sizePanel.add(sizepane);
final JPanel attributes = new JPanel(new GridLayout(1, 2));
this.bold = new JCheckBox("Bold");
this.italic = new JCheckBox("Italic");
attributes.add(this.bold);
attributes.add(this.italic);
attributes.setBorder(BorderFactory.createTitledBorder(
BorderFactory.createEtchedBorder(),
"Attributes"));
right.add(sizePanel, BorderLayout.CENTER);
right.add(attributes, BorderLayout.SOUTH);
add(right, BorderLayout.EAST);
setSelectedFont(font);
}
/**
* Returns a Font object representing the selection in the panel.
*
* @return the font.
*/
public Font getSelectedFont() {
return new Font(getSelectedName(), getSelectedStyle(),
getSelectedSize());
}
/**
* Returns the selected name.
*
* @return the name.
*/
public String getSelectedName() {
return (String) this.fontlist.getSelectedValue();
}
/**
* Returns the selected style.
*
* @return the style.
*/
public int getSelectedStyle() {
if (this.bold.isSelected() && this.italic.isSelected()) {
return Font.BOLD + Font.ITALIC;
}
if (this.bold.isSelected()) {
return Font.BOLD;
}
if (this.italic.isSelected()) {
return Font.ITALIC;
}
else {
return Font.PLAIN;
}
}
/**
* Returns the selected size.
*
* @return the size.
*/
public int getSelectedSize() {
final String selected = (String) this.sizelist.getSelectedValue();
if (selected != null) {
return Integer.parseInt(selected);
}
else {
return 10;
}
}
/**
* Initializes the contents of the dialog from the given font
* object.
*
* @param font the font from which to read the properties.
*/
public void setSelectedFont (final Font font) {
if (font == null) {
throw new NullPointerException();
}
this.bold.setSelected(font.isBold());
this.italic.setSelected(font.isItalic());
final String fontName = font.getName();
ListModel model = this.fontlist.getModel();
this.fontlist.clearSelection();
for (int i = 0; i < model.getSize(); i++) {
if (fontName.equals(model.getElementAt(i))) {
this.fontlist.setSelectedIndex(i);
break;
}
}
final String fontSize = String.valueOf(font.getSize());
model = this.sizelist.getModel();
this.sizelist.clearSelection();
for (int i = 0; i < model.getSize(); i++) {
if (fontSize.equals(model.getElementAt(i))) {
this.sizelist.setSelectedIndex(i);
break;
}
}
}
}
/*
* JCommon : a free general purpose class library for the Java(tm) platform
*
*
* (C) Copyright 2000-2008, by Object Refinery Limited and Contributors.
*
* Project Info: http://www.jfree.org/jcommon/index.html
*
* This library is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation; either version 2.1 of the License, or
* (at your option) any later version.
*
* This library is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
* License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
* USA.
*
* [Java is a trademark or registered trademark of Sun Microsystems, Inc.
* in the United States and other countries.]
*
* -------------------
* StandardDialog.java
* -------------------
* (C) Copyright 2000-2008, by Object Refinery Limited.
*
* Original Author: David Gilbert (for Object Refinery Limited);
* Contributor(s): Arnaud Lelievre;
*
* $Id: StandardDialog.java,v 1.7 2008/12/18 09:57:32 mungady Exp $
*
* Changes (from 26-Oct-2001)
* --------------------------
* 26-Oct-2001 : Changed package to com.jrefinery.ui.*;
* 08-Sep-2003 : Added internationalization via use of properties
* resourceBundle (RFE 690236) (AL);
* 18-Dec-2008 : Use ResourceBundleWrapper - see JFreeChart patch 1607918 by
* Jess Thrysoee (DG);
*
*/

/**
* The base class for standard dialogs.
*
* @author David Gilbert
*/
class StandardDialog extends JDialog implements ActionListener {
/** Flag that indicates whether or not the dialog was cancelled. */
private boolean cancelled;

/**
* Standard constructor - builds a dialog...
*
* @param owner the owner.
* @param title the title.
* @param modal modal?
*/
public StandardDialog(final Frame owner, final String title,
final boolean modal) {
super(owner, title, modal);
this.cancelled = false;
}
/**
* Standard constructor - builds a dialog...
*
* @param owner the owner.
* @param title the title.
* @param modal modal?
*/
public StandardDialog(final Dialog owner, final String title,
final boolean modal) {
super(owner, title, modal);
this.cancelled = false;
}
/**
* Returns a flag that indicates whether or not the dialog has been
* cancelled.
*
* @return boolean.
*/
public boolean isCancelled() {
return this.cancelled;
}
/**
* Handles clicks on the standard buttons.
*
* @param event the event.
*/
public void actionPerformed(final ActionEvent event) {
final String command = event.getActionCommand();
if (command.equals("helpButton")) {
// display help information
}
else if (command.equals("okButton")) {
this.cancelled = false;
setVisible(false);
}
else if (command.equals("cancelButton")) {
this.cancelled = true;
setVisible(false);
}
}
/**
* Builds and returns the user interface for the dialog. This method is
* shared among the constructors.
*
* @return the button panel.
*/
protected JPanel createButtonPanel() {
final L1R2ButtonPanel buttons = new L1R2ButtonPanel(
"Help",
"OK",
"Cancel");
final JButton helpButton = buttons.getLeftButton();
helpButton.setActionCommand("helpButton");
helpButton.addActionListener(this);
final JButton okButton = buttons.getRightButton1();
okButton.setActionCommand("okButton");
okButton.addActionListener(this);
final JButton cancelButton = buttons.getRightButton2();
cancelButton.setActionCommand("cancelButton");
cancelButton.addActionListener(this);
buttons.setBorder(BorderFactory.createEmptyBorder(4, 0, 0, 0));
return buttons;
}
}
/*
* JCommon : a free general purpose class library for the Java(tm) platform
*
*
* (C) Copyright 2000-2005, by Object Refinery Limited and Contributors.
*
* Project Info: http://www.jfree.org/jcommon/index.html
*
* This library is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation; either version 2.1 of the License, or
* (at your option) any later version.
*
* This library is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
* License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
* USA.
*
* [Java is a trademark or registered trademark of Sun Microsystems, Inc.
* in the United States and other countries.]
*
* --------------------
* L1R2ButtonPanel.java
* --------------------
* (C) Copyright 2000-2004, by Object Refinery Limited.
*
* Original Author: David Gilbert (for Object Refinery Limited);
* Contributor(s): -;
*
* $Id: L1R2ButtonPanel.java,v 1.4 2007/11/02 17:50:36 taqua Exp $
*
* Changes (from 26-Oct-2001)
* --------------------------
* 26-Oct-2001 : Changed package to com.jrefinery.ui.*;
* 26-Jun-2002 : Removed unnecessary import (DG);
* 14-Oct-2002 : Fixed errors reported by Checkstyle (DG);
*
*/

/**
* A "ready-made" panel that has one button on the left and two buttons on the right - nested
* panels and layout managers take care of resizing.
*
* @author David Gilbert
*/
class L1R2ButtonPanel extends JPanel {
/** The left button. */
private JButton left;
/** The first button on the right of the panel. */
private JButton right1;
/** The second button on the right of the panel. */
private JButton right2;
/**
* Standard constructor - creates a three button panel with the specified button labels.
*
* @param label1 the label for button 1.
* @param label2 the label for button 2.
* @param label3 the label for button 3.
*/
public L1R2ButtonPanel(final String label1, final String label2, final String label3) {
setLayout(new BorderLayout());
// create the pieces...
this.left = new JButton(label1);
final JPanel rightButtonPanel = new JPanel(new GridLayout(1, 2));
this.right1 = new JButton(label2);
this.right2 = new JButton(label3);
rightButtonPanel.add(this.right1);
rightButtonPanel.add(this.right2);
// ...and put them together
add(this.left, BorderLayout.WEST);
add(rightButtonPanel, BorderLayout.EAST);
}
/**
* Returns a reference to button 1, allowing the caller to set labels, action-listeners etc.
*
* @return the left button.
*/
public JButton getLeftButton() {
return this.left;
}
/**
* Returns a reference to button 2, allowing the caller to set labels, action-listeners etc.
*
* @return the right button 1.
*/
public JButton getRightButton1() {
return this.right1;
}
/**
* Returns a reference to button 3, allowing the caller to set labels, action-listeners etc.
*
* @return the right button 2.
*/
public JButton getRightButton2() {
return this.right2;
}
}
/*
* JCommon : a free general purpose class library for the Java(tm) platform
*
*
* (C) Copyright 2000-2008, by Object Refinery Limited and Contributors.
*
* Project Info: http://www.jfree.org/jcommon/index.html
*
* This library is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation; either version 2.1 of the License, or
* (at your option) any later version.
*
* This library is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
* License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
* USA.
*
* [Java is a trademark or registered trademark of Sun Microsystems, Inc.
* in the United States and other countries.]
*
* ---------------------
* FontDisplayField.java
* ---------------------
* (C) Copyright 2000-2008, by Object Refinery Limited.
*
* Original Author: David Gilbert (for Object Refinery Limited);
* Contributor(s): Arnaud Lelievre;
*
* $Id: FontDisplayField.java,v 1.6 2008/12/18 09:57:32 mungady Exp $
*
* Changes (from 26-Oct-2001)
* ----------------------------------
* 26-Oct-2001 : Changed package to com.jrefinery.ui.*;
* 14-Oct-2002 : Fixed errors reported by Checkstyle (DG);
* 08-Sep-2003 : Added internationalization via use of properties
* resourceBundle (RFE 690236) (AL);
* 18-Dec-2008 : Use ResourceBundleWrapper - see JFreeChart patch 1607918 by
* Jess Thrysoee (DG);
*
*/

/**
* A field for displaying a font selection. The display field itself is
* read-only, to the developer must provide another mechanism to allow the
* user to change the font.
*
* @author David Gilbert
*/
class FontDisplayField extends JTextField {
/** The current font. */
private Font displayFont;

/**
* Standard constructor - builds a FontDescriptionField initialised with
* the specified font.
*
* @param font the font.
*/
public FontDisplayField(final Font font) {
super("");
setDisplayFont(font);
setEnabled(false);
}
/**
* Returns the current font.
*
* @return the font.
*/
public Font getDisplayFont() {
return this.displayFont;
}
/**
* Sets the font.
*
* @param font the font.
*/
public void setDisplayFont(final Font font) {
this.displayFont = font;
setText(fontToString(this.displayFont));
}
/**
* Returns a string representation of the specified font.
*
* @param font the font.
*
* @return a string describing the font.
*/
private String fontToString(final Font font) {
if (font != null) {
return font.getFontName() + ", " + font.getSize();
}
else {
return "No Font Selected";
}
}
}

</source>



== Font Dialog from claribole ==



<source lang="java">

/* FILE: FontDialog.java
* DATE OF CREATION: Wed Jan 15 17:07:07 2002
* AUTHOR : Emmanuel Pietriga (emmanuel@w3.org)
* MODIF: Emmanuel Pietriga (emmanuel.pietriga@inria.fr)
* Copyright (c) Emmanuel Pietriga, 2002. All Rights Reserved
* Copyright (c) INRIA, 2008. All Rights Reserved
* Licensed under the GNU LGPL. For full terms see the file COPYING.
*
* $Id: FontDialog.java 1207 2008-08-13 16:03:07Z epietrig $
*/

import java.awt.Container;
import java.awt.Dialog;
import java.awt.FlowLayout;
import java.awt.Font;
import java.awt.Frame;
import java.awt.GridBagConstraints;
import java.awt.GridBagLayout;
import java.awt.Window;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.awt.event.ruponentAdapter;
import java.awt.event.ruponentEvent;
import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;
import java.util.StringTokenizer;
import javax.swing.JButton;
import javax.swing.JDialog;
import javax.swing.JList;
import javax.swing.JPanel;
import javax.swing.JScrollPane;
public class FontDialog extends JDialog implements ActionListener {
static final String ZVTM_FONT_CHOOSER = "ZVTM Font Chooser";
static String DEFAULT_FAMILY="Dialog";
static int DEFAULT_STYLE=Font.PLAIN;
static int DEFAULT_SIZE=10;
FontTracker ft;
JButton okBt,cancelBt;
JList familyList,styleList,sizeList;
String[] allFontFamilies=java.awt.GraphicsEnvironment.getLocalGraphicsEnvironment().getAvailableFontFamilyNames();
String[] allFontStyles={"Plain","Bold","Italic","BoldItalic"};
String[] allFontSizes={"4","6","8","10","12","14","16","18","20","24"};

/** Call a FontDialog window that will return the font selected in the window
*@param owner application frame that owns this Modal component
*/
public static Font getFontDialog(Frame owner){
FontTracker res=new FontTracker();
FontDialog fd=new FontDialog(res,owner);
fd.addWindowListener(new FontDialog.Closer());
fd.addComponentListener(new FontDialog.DisposeOnClose());
fd.setLocationRelativeTo(owner);
fd.setVisible(true); //blocks until the dialog is closed
return res.getFont();
}
/** Call a FontDialog window that will return the font selected in the window
*@param owner application dialog that owns this Modal component
*/
public static Font getFontDialog(Dialog owner){
FontTracker res=new FontTracker();
FontDialog fd=new FontDialog(res,owner);
fd.addWindowListener(new FontDialog.Closer());
fd.addComponentListener(new FontDialog.DisposeOnClose());
fd.setLocationRelativeTo(owner);
fd.setVisible(true); //blocks until the dialog is closed
return res.getFont();
}
/** Call a FontDialog window that will return the font selected in the window
*@param owner application frame that owns this Modal component
*@param f a font giving the default parameters with which the dialog should be initialized (family, size, style)
*/
public static Font getFontDialog(Frame owner,Font f){
if (f!=null){
DEFAULT_FAMILY=f.getFamily();
DEFAULT_STYLE=f.getStyle();
DEFAULT_SIZE=f.getSize();
}
FontTracker res=new FontTracker();
FontDialog fd=new FontDialog(res,owner);
fd.addWindowListener(new FontDialog.Closer());
fd.addComponentListener(new FontDialog.DisposeOnClose());
fd.setLocationRelativeTo(owner);
fd.setVisible(true); //blocks until the dialog is closed
return res.getFont();
}
/** Call a FontDialog window that will return the font selected in the window
*@param owner application dialog that owns this Modal component
*@param f a font giving the default parameters with which the dialog should be initialized (family, size, style)
*/
public static Font getFontDialog(Dialog owner,Font f){
if (f!=null){
DEFAULT_FAMILY=f.getFamily();
DEFAULT_STYLE=f.getStyle();
DEFAULT_SIZE=f.getSize();
}
FontTracker res=new FontTracker();
FontDialog fd=new FontDialog(res,owner);
fd.addWindowListener(new FontDialog.Closer());
fd.addComponentListener(new FontDialog.DisposeOnClose());
fd.setLocationRelativeTo(owner);
fd.setVisible(true); //blocks until the dialog is closed
return res.getFont();
}
/**
* Font.decode does not seem to work that well, or I don;t understand how it is supposed to work
* Anyway, this one does what I want (decodes family+" "+style+" "+size)
*/
public static Font decode(String fontSpec){
if (fontSpec!=null && fontSpec.length()>0){
StringTokenizer st=new StringTokenizer(fontSpec," ",false);
String[] tokens=new String[st.countTokens()];
if (tokens.length>=3){
int i=0;
while (st.hasMoreTokens()) {
tokens[i++]=st.nextToken();
}
String tokenizedFamily="";
for (int j=0;j<tokens.length-3;j++){
tokenizedFamily+=tokens[j]+" ";
}
tokenizedFamily+=tokens[tokens.length-3];
String family=tokenizedFamily;if (family==null){family=DEFAULT_FAMILY;}
String tokenizedStyle=tokens[tokens.length-2];
String tokenizedSize=tokens[tokens.length-1];
int style;
if (tokenizedStyle.equals("Bold")){style=Font.BOLD;}
else if (tokenizedStyle.equals("Italic")){style=Font.ITALIC;}
else if (tokenizedStyle.equals("BoldItalic")){style=Font.BOLD+Font.ITALIC;}
else {style=Font.PLAIN;}//"Plain"
int size;
try {
size=Integer.parseInt(tokenizedSize);
if (size<=0){size=DEFAULT_SIZE;}
}
catch (NumberFormatException ex){size=DEFAULT_SIZE;}
return new Font(family,style,size);
}
else {return new Font(DEFAULT_FAMILY,DEFAULT_STYLE,DEFAULT_SIZE);}
}
else {return new Font(DEFAULT_FAMILY,DEFAULT_STYLE,DEFAULT_SIZE);}
}
FontDialog(FontTracker ftt,Frame owner){
super(owner,ZVTM_FONT_CHOOSER,true);
setLocation(owner.getLocation());
ft=ftt;
initUI();
}
FontDialog(FontTracker ftt,Dialog owner){
super(owner,ZVTM_FONT_CHOOSER,true);
setLocation(owner.getLocation());
ft=ftt;
initUI();
}
void initUI(){//depending on selected item/default shape type
Container cp=this.getContentPane();
try {
okBt.removeActionListener(this);
cancelBt.removeActionListener(this);
}
catch (NullPointerException ex){/*all these might be null (for instance when poping up a GlyphFactory for the first time)*/}
cp.removeAll();
//main font panel
JPanel mainPanel=new JPanel();
GridBagLayout gridBag1=new GridBagLayout();
GridBagConstraints constraints1=new GridBagConstraints();
mainPanel.setLayout(gridBag1);
constraints1.fill=GridBagConstraints.BOTH;
constraints1.anchor=GridBagConstraints.CENTER;
familyList=new JList(allFontFamilies);
JScrollPane sp1=new JScrollPane(familyList);
buildConstraints(constraints1,0,0,1,1,30,100);
gridBag1.setConstraints(sp1,constraints1);
mainPanel.add(sp1);
styleList=new JList(allFontStyles);
JScrollPane sp2=new JScrollPane(styleList);
buildConstraints(constraints1,1,0,1,1,30,0);
gridBag1.setConstraints(sp2,constraints1);
mainPanel.add(sp2);
sizeList=new JList(allFontSizes);
JScrollPane sp3=new JScrollPane(sizeList);
buildConstraints(constraints1,2,0,1,1,25,0);
gridBag1.setConstraints(sp3,constraints1);
mainPanel.add(sp3);
//ok, cancel, reset buttons
JPanel btPanel=new JPanel();
btPanel.setLayout(new FlowLayout());
okBt=new JButton("OK");
okBt.addActionListener(this);
btPanel.add(okBt);
cancelBt=new JButton("Cancel");
cancelBt.addActionListener(this);
btPanel.add(cancelBt);
//main components
GridBagLayout gridBag=new GridBagLayout();
GridBagConstraints constraints=new GridBagConstraints();
cp.setLayout(gridBag);
constraints.fill=GridBagConstraints.BOTH;
constraints.anchor=GridBagConstraints.CENTER;
buildConstraints(constraints,0,0,1,1,100,99);
gridBag.setConstraints(mainPanel,constraints);
cp.add(mainPanel);
buildConstraints(constraints,0,1,1,1,100,1);
gridBag.setConstraints(btPanel,constraints);
cp.add(btPanel);
this.setSize(350,200);
this.setResizable(false);
familyList.setSelectedValue(DEFAULT_FAMILY,true);
if (DEFAULT_STYLE==Font.PLAIN){styleList.setSelectedValue("Plain",true);}
else if (DEFAULT_STYLE==Font.BOLD){styleList.setSelectedValue("Bold",true);}
else if (DEFAULT_STYLE==Font.ITALIC){styleList.setSelectedValue("Italic",true);}
else if (DEFAULT_STYLE==Font.BOLD+Font.ITALIC){styleList.setSelectedValue("BoldItalic",true);}
sizeList.setSelectedValue((new Integer(DEFAULT_SIZE)).toString(),true);
}
public void actionPerformed(ActionEvent e){
Object source=e.getSource();
if (source==okBt){
ft.setFont(getSelectedFont());
this.dispose();
}
else if (source==cancelBt){
ft.setFont(null);
this.dispose();
}
}

Font getSelectedFont(){
String family=(String)familyList.getSelectedValue();if (family==null){family=DEFAULT_FAMILY;}
String selectedStyle=(String)styleList.getSelectedValue();
int style;
if (selectedStyle.equals("Bold")){style=Font.BOLD;}
else if (selectedStyle.equals("Italic")){style=Font.ITALIC;}
else if (selectedStyle.equals("BoldItalic")){style=Font.BOLD+Font.ITALIC;}
else {style=Font.PLAIN;}//"Plain"
int size;
try {
String selectedSize=(String)sizeList.getSelectedValue();
size=Integer.parseInt(selectedSize);
if (size<=0){size=DEFAULT_SIZE;}
}
catch (NumberFormatException ex){size=DEFAULT_SIZE;}
return new Font(family,style,size);
}
static void buildConstraints(GridBagConstraints gbc, int gx,int gy,int gw,int gh,int wx,int wy){
gbc.gridx=gx;
gbc.gridy=gy;
gbc.gridwidth=gw;
gbc.gridheight=gh;
gbc.weightx=wx;
gbc.weighty=wy;
}

static class Closer extends WindowAdapter {
public void windowClosing(WindowEvent e) {
Window w = e.getWindow();
w.setVisible(false);
}
}
static class DisposeOnClose extends ComponentAdapter {
public void componentHidden(ComponentEvent e) {
Window w = (Window)e.getComponent();
w.dispose();
}
}
public static String getFontStyleName(int i){
if (i==java.awt.Font.BOLD){return "Bold";}
else if (i==java.awt.Font.ITALIC){return "Italic";}
else if (i==java.awt.Font.BOLD+java.awt.Font.ITALIC){return "BoldItalic";}
else {return "Plain";}
}
}
class FontTracker {
Font font;
public void setFont(Font f){
font=f;
}
public Font getFont() {
return font;
}
}

</source>



== Font Loader Dialog ==



<source lang="java">

/*
* FontLoaderDialog.java
*
* Created on November 13, 2006, 8:30 AM
*/

// Revised from jaspersoft designer
import java.lang.reflect.InvocationTargetException;
import javax.swing.SwingUtilities;
/**
*
* @author gtoffoli
*/
public class FontLoaderDialog extends javax.swing.JDialog {

/** Creates new form FontLoaderDialog */
public FontLoaderDialog(java.awt.Frame parent, boolean modal) {
super(parent, modal);
initComponents();
//applyI18n();
this.pack();

setLocationRelativeTo(null);
}

/** This method is called from within the constructor to
* initialize the form.
* WARNING: Do NOT modify this code. The content of this method is
* always regenerated by the Form Editor.
*/
// <editor-fold defaultstate="collapsed" desc="Generated Code">//GEN-BEGIN:initComponents
private void initComponents() {
java.awt.GridBagConstraints gridBagConstraints;
jLabelStatus = new javax.swing.JLabel();
setDefaultCloseOperation(javax.swing.WindowConstants.DISPOSE_ON_CLOSE);
getContentPane().setLayout(new java.awt.GridBagLayout());
jLabelStatus.setText("FontLoaderDialog.Label.LoadingStatus"); // NOI18N
jLabelStatus.setVerticalAlignment(javax.swing.SwingConstants.TOP);
jLabelStatus.setPreferredSize(new java.awt.Dimension(391, 51));
gridBagConstraints = new java.awt.GridBagConstraints();
gridBagConstraints.fill = java.awt.GridBagConstraints.BOTH;
gridBagConstraints.weightx = 1.0;
gridBagConstraints.weighty = 1.0;
gridBagConstraints.insets = new java.awt.Insets(4, 4, 4, 4);
getContentPane().add(jLabelStatus, gridBagConstraints);
pack();
}// </editor-fold>//GEN-END:initComponents

public void setStatus(String s)
{
jLabelStatus.setText(s);
}

public void fontsLoadingStatusUpdated(String statusMsg) {

final String s = statusMsg;
try {
SwingUtilities.invokeAndWait( new Runnable()
{
public void run()
{
setStatus(s);
}
}
);
} catch (InterruptedException ex) {
ex.printStackTrace();
} catch (InvocationTargetException ex) {
ex.printStackTrace();
}

}
public void fontsLoadingStarted() {

try {
SwingUtilities.invokeAndWait( new Runnable()
{
public void run()
{
setVisible(true);
}
}
);
} catch (InterruptedException ex) {
ex.printStackTrace();
} catch (InvocationTargetException ex) {
ex.printStackTrace();
}
}
public void fontsLoadingFinished() {
try {
SwingUtilities.invokeAndWait( new Runnable()
{
public void run()
{
setVisible(false);
}
}
);
} catch (InterruptedException ex) {
ex.printStackTrace();
} catch (InvocationTargetException ex) {
ex.printStackTrace();
}
}

// Variables declaration - do not modify//GEN-BEGIN:variables
private javax.swing.JLabel jLabelStatus;
// End of variables declaration//GEN-END:variables

// public void applyI18n(){
// // Start autogenerated code ----------------------
// jLabelStatus.setText(I18n.getString("fontLoaderDialog.labelStatus","Loading status"));
// // End autogenerated code ----------------------
// }
}

</source>



== JFont Chooser ==



<source lang="java">

// revised from greef ui
import java.awt.BorderLayout;
import java.awt.ruponent;
import java.awt.Container;
import java.awt.FlowLayout;
import java.awt.Font;
import java.awt.GraphicsEnvironment;
import java.awt.GridBagConstraints;
import java.awt.GridBagLayout;
import java.awt.HeadlessException;
import java.awt.Insets;
import java.awt.Window;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.awt.event.ruponentAdapter;
import java.awt.event.ruponentEvent;
import java.awt.event.KeyEvent;
import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;
import java.io.Serializable;
import javax.swing.AbstractAction;
import javax.swing.Action;
import javax.swing.ActionMap;
import javax.swing.InputMap;
import javax.swing.JButton;
import javax.swing.JCheckBox;
import javax.swing.JComponent;
import javax.swing.JDialog;
import javax.swing.JLabel;
import javax.swing.JList;
import javax.swing.JOptionPane;
import javax.swing.JPanel;
import javax.swing.JScrollPane;
import javax.swing.KeyStroke;
import javax.swing.ListSelectionModel;
import javax.swing.UIManager;
import javax.swing.event.ChangeEvent;
import javax.swing.event.ChangeListener;
import javax.swing.event.EventListenerList;
import javax.swing.event.ListSelectionEvent;
import javax.swing.event.ListSelectionListener;
/**
* <code>JFontChooser</code> provides a pane of controls designed to allow
* a user to manipulate and select a font.
*
* This class provides three levels of API:
* <ol>
* <li>A static convenience method which shows a modal font-chooser
* dialog and returns the font selected by the user.
* <li>A static convenience method for creating a font-chooser dialog
* where <code>ActionListeners</code> can be specified to be invoked when
* the user presses one of the dialog buttons.
* <li>The ability to create instances of <code>JFontChooser</code> panes
* directly (within any container). <code>PropertyChange</code> listeners
* can be added to detect when the current "font" property changes.
* </ol>
* <p>
*
* @author Adrian BER
*/
public class JFontChooser extends JComponent {
/** The list of possible font sizes. */
private static final Integer[] SIZES =
{8, 9, 10, 11, 12, 13, 14, 16, 18, 20, 24, 26, 28, 32, 36, 40, 48, 56, 64, 72};
/** The list of possible fonts. */
private static final String[] FONTS = GraphicsEnvironment.getLocalGraphicsEnvironment()
.getAvailableFontFamilyNames();

private FontSelectionModel selectionModel;
private JList fontList;
private JList sizeList;
private JCheckBox boldCheckBox;
private JCheckBox italicCheckBox;
private JLabel previewLabel;
/** The preview text, if null the font name will be the preview text. */
private String previewText;
/** Listener used to update the font of the selection model. */
private SelectionUpdater selectionUpdater = new SelectionUpdater();
/** Listener used to update the font in the components. This should be registered
* with the selection model. */
private LabelUpdater labelUpdater = new LabelUpdater();
/** True if the components are being updated and no event should be generated. */
private boolean updatingComponents = false;
/** Listener class used to update the font in the components. This should be registered
* with the selection model. */
private class LabelUpdater implements ChangeListener {
public void stateChanged(ChangeEvent e) {
updateComponents();
}
}
/** Listener class used to update the font of the preview label. */
private class SelectionUpdater implements ChangeListener, ListSelectionListener {
public void stateChanged(ChangeEvent e) {
if (!updatingComponents) {
setFont(buildFont());
}
}
public void valueChanged(ListSelectionEvent e) {
if (!updatingComponents) {
setFont(buildFont());
}
}
}
/**
* Shows a modal font-chooser dialog and blocks until the
* dialog is hidden. If the user presses the "OK" button, then
* this method hides/disposes the dialog and returns the selected color.
* If the user presses the "Cancel" button or closes the dialog without
* pressing "OK", then this method hides/disposes the dialog and returns
* <code>null</code>.
*
* @param component the parent <code>Component</code> for the dialog
* @param title the String containing the dialog"s title
* @return the selected font or <code>null</code> if the user opted out
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true.
* @see java.awt.GraphicsEnvironment#isHeadless
*/
public Font showDialog(Component component, String title) {
FontTracker ok = new FontTracker(this);
JDialog dialog = createDialog(component, title, true, ok, null);
dialog.addWindowListener(new FontChooserDialog.Closer());
dialog.addComponentListener(new FontChooserDialog.DisposeOnClose());
dialog.setVisible(true); // blocks until user brings dialog down...
return ok.getFont();
}

/**
* Creates and returns a new dialog containing the specified
* <code>ColorChooser</code> pane along with "OK", "Cancel", and "Reset"
* buttons. If the "OK" or "Cancel" buttons are pressed, the dialog is
* automatically hidden (but not disposed). If the "Reset"
* button is pressed, the color-chooser"s color will be reset to the
* font which was set the last time <code>show</code> was invoked on the
* dialog and the dialog will remain showing.
*
* @param c the parent component for the dialog
* @param title the title for the dialog
* @param modal a boolean. When true, the remainder of the program
* is inactive until the dialog is closed.
* @param okListener the ActionListener invoked when "OK" is pressed
* @param cancelListener the ActionListener invoked when "Cancel" is pressed
* @return a new dialog containing the font-chooser pane
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true.
* @see java.awt.GraphicsEnvironment#isHeadless
*/
public JDialog createDialog(Component c, String title, boolean modal,
ActionListener okListener, ActionListener cancelListener) {
return new FontChooserDialog(c, title, modal, this,
okListener, cancelListener);
}
/**
* Creates a color chooser pane with an initial font which is the same font
* as the default font for labels.
*/
public JFontChooser() {
this(new DefaultFontSelectionModel());
}
/**
* Creates a font chooser pane with the specified initial font.
*
* @param initialFont the initial font set in the chooser
*/
public JFontChooser(Font initialFont) {
this(new DefaultFontSelectionModel(initialFont));
}
/**
* Creates a font chooser pane with the specified
* <code>FontSelectionModel</code>.
*
* @param model the font selection model used by this component
*/
public JFontChooser(FontSelectionModel model) {
selectionModel = model;
init(model.getSelectedFont());
selectionModel.addChangeListener(labelUpdater);
}
private void init(Font font) {
setLayout(new GridBagLayout());
Insets ins = new Insets(2, 2, 2, 2);
fontList = new JList(FONTS);
fontList.setVisibleRowCount(10);
fontList.setSelectionMode(ListSelectionModel.SINGLE_SELECTION);
add(new JScrollPane(fontList), new GridBagConstraints(0, 0, 1, 1, 2, 2,
GridBagConstraints.CENTER, GridBagConstraints.BOTH,
ins, 0, 0));
sizeList = new JList(SIZES);
((JLabel)sizeList.getCellRenderer()).setHorizontalAlignment(JLabel.RIGHT);
sizeList.setVisibleRowCount(10);
sizeList.setSelectionMode(ListSelectionModel.SINGLE_SELECTION);
add(new JScrollPane(sizeList), new GridBagConstraints(1, 0, 1, 1, 1, 2,
GridBagConstraints.CENTER, GridBagConstraints.BOTH,
ins, 0, 0));
boldCheckBox = new JCheckBox("Bold");
add(boldCheckBox, new GridBagConstraints(0, 1, 2, 1, 1, 0,
GridBagConstraints.WEST, GridBagConstraints.NONE,
ins, 0, 0));
italicCheckBox = new JCheckBox("Italic");
add(italicCheckBox, new GridBagConstraints(0, 2, 2, 1, 1, 0,
GridBagConstraints.WEST, GridBagConstraints.NONE,
ins, 0, 0));
previewLabel = new JLabel("");
previewLabel.setHorizontalAlignment(JLabel.CENTER);
previewLabel.setVerticalAlignment(JLabel.CENTER);
add(new JScrollPane(previewLabel), new GridBagConstraints(0, 3, 2, 1, 1, 1,
GridBagConstraints.CENTER, GridBagConstraints.BOTH,
ins, 0, 0));
setFont(font == null ? previewLabel.getFont() : font);
fontList.addListSelectionListener(selectionUpdater);
sizeList.addListSelectionListener(selectionUpdater);
boldCheckBox.addChangeListener(selectionUpdater);
italicCheckBox.addChangeListener(selectionUpdater);
}
private Font buildFont() {
// Font labelFont = previewLabel.getFont();
String fontName = (String)fontList.getSelectedValue();
if (fontName == null) {
return null;
// fontName = labelFont.getName();
}
Integer sizeInt = (Integer)sizeList.getSelectedValue();
if (sizeInt == null) {
// size = labelFont.getSize();
return null;
}
// create the font
// // first create the font attributes
// HashMap map = new HashMap();
// map.put(TextAttribute.BACKGROUND, Color.white);
// map.put(TextAttribute.FAMILY, fontName);
// map.put(TextAttribute.FOREGROUND, Color.black);
// map.put(TextAttribute.SIZE , new Float(size));
// map.put(TextAttribute.UNDERLINE, italicCheckBox.isSelected() ? TextAttribute.UNDERLINE_LOW_ONE_PIXEL : TextAttribute.UNDERLINE_LOW_TWO_PIXEL);
// map.put(TextAttribute.STRIKETHROUGH, italicCheckBox.isSelected() ? TextAttribute.STRIKETHROUGH_ON : Boolean.FALSE);
// map.put(TextAttribute.WEIGHT, boldCheckBox.isSelected() ? TextAttribute.WEIGHT_BOLD : TextAttribute.WEIGHT_REGULAR);
// map.put(TextAttribute.POSTURE,
// italicCheckBox.isSelected() ? TextAttribute.POSTURE_OBLIQUE : TextAttribute.POSTURE_REGULAR);
//
// return new Font(map);
return new Font(fontName,
(italicCheckBox.isSelected() ? Font.ITALIC : Font.PLAIN)
| (boldCheckBox.isSelected() ? Font.BOLD : Font.PLAIN),
sizeInt);
}
/** Updates the font in the preview component according to the selected values. */
private void updateComponents() {
updatingComponents = true;
Font font = getFont();
fontList.setSelectedValue(font.getName(), true);
sizeList.setSelectedValue(font.getSize(), true);
boldCheckBox.setSelected(font.isBold());
italicCheckBox.setSelected(font.isItalic());
if (previewText == null) {
previewLabel.setText(font.getName());
}
// set the font and fire a property change
Font oldValue = previewLabel.getFont();
previewLabel.setFont(font);
firePropertyChange("font", oldValue, font);
updatingComponents = false;
}
/**
* Returns the data model that handles font selections.
*
* @return a FontSelectionModel object
*/
public FontSelectionModel getSelectionModel() {
return selectionModel;
}

/**
* Set the model containing the selected font.
*
* @param newModel the new FontSelectionModel object
*/
public void setSelectionModel(FontSelectionModel newModel ) {
FontSelectionModel oldModel = selectionModel;
selectionModel = newModel;
oldModel.removeChangeListener(labelUpdater);
newModel.addChangeListener(labelUpdater);
firePropertyChange("selectionModel", oldModel, newModel);
}
/**
* Gets the current font value from the font chooser.
*
* @return the current font value of the font chooser
*/
public Font getFont() {
return selectionModel.getSelectedFont();
}
/**
* Sets the current font of the font chooser to the specified font.
* The <code>ColorSelectionModel</code> will fire a <code>ChangeEvent</code>
* @param font the font to be set in the font chooser
* @see JComponent#addPropertyChangeListener
*/
public void setFont(Font font) {
selectionModel.setSelectedFont(font);
}
/** Returns the preview text displayed in the preview component.
* @return the preview text, if null the font name will be displayed
*/
public String getPreviewText() {
return previewText;
}
/** Sets the preview text displayed in the preview component.
* @param previewText the preview text, if null the font name will be displayed
*/
public void setPreviewText(String previewText) {
this.previewText = previewText;
previewLabel.setText("");
updateComponents();
}
}

/*
* Class which builds a font chooser dialog consisting of
* a JFontChooser with "Ok", "Cancel", and "Reset" buttons.
*
* Note: This needs to be fixed to deal with localization!
*/
class FontChooserDialog extends JDialog {
private Font initialFont;
private JFontChooser chooserPane;
public FontChooserDialog(Component c, String title, boolean modal,
JFontChooser chooserPane,
ActionListener okListener, ActionListener cancelListener) {
super(JOptionPane.getFrameForComponent(c), title, modal);
//setResizable(false);
String okString = UIManager.getString("ColorChooser.okText");
String cancelString = UIManager.getString("ColorChooser.cancelText");
String resetString = UIManager.getString("ColorChooser.resetText");
/*
* Create Lower button panel
*/
JPanel buttonPane = new JPanel();
buttonPane.setLayout(new FlowLayout(FlowLayout.CENTER));
JButton okButton = new JButton(okString);
getRootPane().setDefaultButton(okButton);
okButton.setActionCommand("OK");
if (okListener != null) {
okButton.addActionListener(okListener);
}
okButton.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
setVisible(false);
}
});
buttonPane.add(okButton);
JButton cancelButton = new JButton(cancelString);
// The following few lines are used to register esc to close the dialog
Action cancelKeyAction = new AbstractAction() {
public void actionPerformed(ActionEvent e) {
// todo make it in 1.3
// ActionListener[] listeners
// = ((AbstractButton) e.getSource()).getActionListeners();
// for (int i = 0; i < listeners.length; i++) {
// listeners[i].actionPerformed(e);
// }
}
};
KeyStroke cancelKeyStroke = KeyStroke.getKeyStroke((char) KeyEvent.VK_ESCAPE);
InputMap inputMap = cancelButton.getInputMap(JComponent.WHEN_IN_FOCUSED_WINDOW);
ActionMap actionMap = cancelButton.getActionMap();
if (inputMap != null && actionMap != null) {
inputMap.put(cancelKeyStroke, "cancel");
actionMap.put("cancel", cancelKeyAction);
}
// end esc handling
cancelButton.setActionCommand("cancel");
if (cancelListener != null) {
cancelButton.addActionListener(cancelListener);
}
cancelButton.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
setVisible(false);
}
});
buttonPane.add(cancelButton);
JButton resetButton = new JButton(resetString);
resetButton.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
reset();
}
});
int mnemonic = UIManager.getInt("ColorChooser.resetMnemonic");
if (mnemonic != -1) {
resetButton.setMnemonic(mnemonic);
}
buttonPane.add(resetButton);

// initialiase the content pane
this.chooserPane = chooserPane;
Container contentPane = getContentPane();
contentPane.setLayout(new BorderLayout());
contentPane.add(chooserPane, BorderLayout.CENTER);
contentPane.add(buttonPane, BorderLayout.SOUTH);
pack();
setLocationRelativeTo(c);
}
public void setVisible(boolean visible) {
if (visible)
initialFont = chooserPane.getFont();
super.setVisible(visible);
}
public void reset() {
chooserPane.setFont(initialFont);
}
static class Closer extends WindowAdapter implements Serializable {
public void windowClosing(WindowEvent e) {
Window w = e.getWindow();
w.setVisible(false);
}
}
static class DisposeOnClose extends ComponentAdapter implements Serializable {
public void componentHidden(ComponentEvent e) {
Window w = (Window) e.getComponent();
w.dispose();
}
}
}
class FontTracker implements ActionListener, Serializable {
JFontChooser chooser;
Font color;
public FontTracker(JFontChooser c) {
chooser = c;
}
public void actionPerformed(ActionEvent e) {
color = chooser.getFont();
}
public Font getFont() {
return color;
}
}

/**
* A generic implementation of <code>{@link FontSelectionModel}</code>.
*
* @author Adrian BER
*/
class DefaultFontSelectionModel implements FontSelectionModel {
/** The default selected font. */
private static final Font DEFAULT_INITIAL_FONT = new Font("Dialog", Font.PLAIN, 12);

/** The selected font. */
private Font selectedFont;
/** The change listeners notified by a change in this model. */
private EventListenerList listeners = new EventListenerList();
/**
* Creates a <code>DefaultFontSelectionModel</code> with the
* current font set to <code>Dialog, 12</code>. This is
* the default constructor.
*/
public DefaultFontSelectionModel() {
this(DEFAULT_INITIAL_FONT);
}
/**
* Creates a <code>DefaultFontSelectionModel</code> with the
* current font set to <code>font</code>, which should be
* non-<code>null</code>. Note that setting the font to
* <code>null</code> is undefined and may have unpredictable
* results.
*
* @param selectedFont the new <code>Font</code>
*/
public DefaultFontSelectionModel(Font selectedFont) {
if (selectedFont == null) {
selectedFont = DEFAULT_INITIAL_FONT;
}
this.selectedFont = selectedFont;
}
public Font getSelectedFont() {
return selectedFont;
}
public void setSelectedFont(Font selectedFont) {
if (selectedFont != null) {
this.selectedFont = selectedFont;
fireChangeListeners();
}
}
public void addChangeListener(ChangeListener listener) {
listeners.add(ChangeListener.class, listener);
}
public void removeChangeListener(ChangeListener listener) {
listeners.remove(ChangeListener.class, listener);
}
/** Fires the listeners registered with this model. */
protected void fireChangeListeners() {
ChangeEvent ev = new ChangeEvent(this);
Object[] l = listeners.getListeners(ChangeListener.class);
for (Object listener : l) {
((ChangeListener) listener).stateChanged(ev);
}
}
}

/**
* A model that supports selecting a <code>Font</code>.
*
* @author Adrian BER
*
* @see java.awt.Font
*/
interface FontSelectionModel {
/**
* Returns the selected <code>Font</code> which should be
* non-<code>null</code>.
*
* @return the selected <code>Font</code>
* @see #setSelectedFont
*/
Font getSelectedFont();
/**
* Sets the selected font to <code>font</code>.
* Note that setting the font to <code>null</code>
* is undefined and may have unpredictable results.
* This method fires a state changed event if it sets the
* current font to a new non-<code>null</code> font.
*
* @param font the new <code>Font</code>
* @see #getSelectedFont
* @see #addChangeListener
*/
void setSelectedFont(Font font);
/**
* Adds <code>listener</code> as a listener to changes in the model.
* @param listener the <code>ChangeListener</code> to be added
*/
void addChangeListener(ChangeListener listener);
/**
* Removes <code>listener</code> as a listener to changes in the model.
* @param listener the <code>ChangeListener</code> to be removed
*/
void removeChangeListener(ChangeListener listener);
}
//////////////////////////////
package com.greef.ui.font;
import com.greef.ui.UIUtilities;
import javax.swing.*;
import javax.swing.event.ChangeListener;
import javax.swing.event.ChangeEvent;
import javax.swing.event.DocumentListener;
import javax.swing.event.DocumentEvent;
import java.awt.*;
import java.awt.event.ActionListener;
import java.awt.event.ActionEvent;
/**
* @author Adrian BER (beradrian@yahoo.ru)
*/
public class JFontChooserDemo extends JPanel {
private static final Insets INSETS = new Insets(5, 5, 5, 5);
private JFontChooser fontChooser;
private JCheckBox defaultPreviewCheckBox;
private JTextField previewTextField;
private JLabel previewLabel;
private JTextArea codeTextArea;
public JFontChooserDemo() {
init();
}
private void init() {
setLayout(new GridBagLayout());
defaultPreviewCheckBox = new JCheckBox("Use font name as the preview text");
defaultPreviewCheckBox.addChangeListener(new ChangeListener() {
public void stateChanged(ChangeEvent e) {
boolean selected = defaultPreviewCheckBox.isSelected();
fontChooser.setPreviewText(selected ? null : previewTextField.getText());
previewLabel.setEnabled(!selected);
previewTextField.setEnabled(!selected);
updateCode();
}
});
add(defaultPreviewCheckBox, new GridBagConstraints(0, 0, 2, 1, 0, 0, GridBagConstraints.WEST,
GridBagConstraints.NONE, INSETS, 0, 0));
previewLabel = new JLabel("Preview text:");
add(previewLabel, new GridBagConstraints(0, 1, 1, 1, 0, 0, GridBagConstraints.EAST,
GridBagConstraints.NONE, INSETS, 0, 0));
previewTextField = new JTextField();
previewTextField.getDocument().addDocumentListener(new DocumentListener() {
private void changePreviewText() {
fontChooser.setPreviewText(previewTextField.getText());
updateCode();
}
public void insertUpdate(DocumentEvent e) {
changePreviewText();
}
public void removeUpdate(DocumentEvent e) {
changePreviewText();
}
public void changedUpdate(DocumentEvent e) {
changePreviewText();
}
});
add(previewTextField, new GridBagConstraints(1, 1, 1, 1, 1, 0, GridBagConstraints.WEST,
GridBagConstraints.HORIZONTAL, INSETS, 0, 0));
JButton testButton = new JButton("Test");
testButton.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
Font font = fontChooser.showDialog(JFontChooserDemo.this, "Choose a font");
JOptionPane.showMessageDialog(JFontChooserDemo.this, font == null ? "You canceled the dialog."
: "You have selected " + font.getName() + ", " + font.getSize()
+ (font.isBold() ? ", Bold" : "") + (font.isItalic() ? ", Italic" : ""));
}
});
add(testButton, new GridBagConstraints(0, 2, 2, 1, 1, 0, GridBagConstraints.NORTHEAST,
GridBagConstraints.NONE, INSETS, 0, 0));
codeTextArea = new JTextArea(5, 30);
codeTextArea.setOpaque(false);
codeTextArea.setEditable(false);
codeTextArea.setBorder(BorderFactory.createTitledBorder("Code"));
add(codeTextArea, new GridBagConstraints(0, 3, 2, 1, 1, 1, GridBagConstraints.CENTER,
GridBagConstraints.BOTH, INSETS, 0, 0));
setFontChooser(new JFontChooser());
}
private void setFontChooser(JFontChooser fontChooser) {
this.fontChooser = fontChooser;
String previewText = fontChooser.getPreviewText();
defaultPreviewCheckBox.setSelected(previewText == null);
previewTextField.setText(previewText);
updateCode();
}
private void updateCode() {
codeTextArea.setText("JFontChooser fontChooser = new JFontChooser();\n"
+ (defaultPreviewCheckBox.isSelected() ? "" : "fontChooser.setPreviewText(\""
+ previewTextField.getText() + "\");\n")
+ "Font font = fontChooser.showDialog(invokerComponent, \"Choose a font\");\n"
+ "System.out.println(font == null ? \"You have canceled the dialog.\" : \"You have selected \" + font);");
}
public void updateUI() {
super.updateUI();
if (fontChooser != null)
SwingUtilities.updateComponentTreeUI(fontChooser);
}
}

</source>



== JFreeChart: Font Dialog ==

== Word like special font chooser ==



<source lang="java">

/*
* @(#)Font2DTest.java 1.28 05/11/17
*
* Copyright (c) 2006 Sun Microsystems, Inc. All Rights Reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* -Redistribution of source code must retain the above copyright notice, this
* list of conditions and the following disclaimer.
*
* -Redistribution in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* Neither the name of Sun Microsystems, Inc. or the names of contributors may
* be used to endorse or promote products derived from this software without
* specific prior written permission.
*
* This software is provided "AS IS," without a warranty of any kind. ALL
* EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING
* ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
* OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN MIDROSYSTEMS, INC. ("SUN")
* AND ITS LICENSORS SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE
* AS A RESULT OF USING, MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS
* DERIVATIVES. IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR ANY LOST
* REVENUE, PROFIT OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL,
* INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY
* OF LIABILITY, ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE,
* EVEN IF SUN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
*
* You acknowledge that this software is not designed, licensed or intended
* for use in the design, construction, operation or maintenance of any
* nuclear facility.
*/
/*
* @(#)Font2DTest.java 1.28 05/11/17
*/
import static java.awt.RenderingHints.KEY_ANTIALIASING;
import static java.awt.RenderingHints.KEY_FRACTIONALMETRICS;
import static java.awt.RenderingHints.KEY_TEXT_ANTIALIASING;
import static java.awt.RenderingHints.KEY_TEXT_LCD_CONTRAST;
import static java.awt.RenderingHints.VALUE_ANTIALIAS_OFF;
import static java.awt.RenderingHints.VALUE_ANTIALIAS_ON;
import static java.awt.RenderingHints.VALUE_FRACTIONALMETRICS_DEFAULT;
import static java.awt.RenderingHints.VALUE_FRACTIONALMETRICS_OFF;
import static java.awt.RenderingHints.VALUE_FRACTIONALMETRICS_ON;
import static java.awt.RenderingHints.VALUE_TEXT_ANTIALIAS_DEFAULT;
import static java.awt.RenderingHints.VALUE_TEXT_ANTIALIAS_GASP;
import static java.awt.RenderingHints.VALUE_TEXT_ANTIALIAS_LCD_HBGR;
import static java.awt.RenderingHints.VALUE_TEXT_ANTIALIAS_LCD_HRGB;
import static java.awt.RenderingHints.VALUE_TEXT_ANTIALIAS_LCD_VBGR;
import static java.awt.RenderingHints.VALUE_TEXT_ANTIALIAS_LCD_VRGB;
import static java.awt.RenderingHints.VALUE_TEXT_ANTIALIAS_OFF;
import static java.awt.RenderingHints.VALUE_TEXT_ANTIALIAS_ON;
import java.awt.BorderLayout;
import java.awt.Color;
import java.awt.ruponent;
import java.awt.Container;
import java.awt.Cursor;
import java.awt.Dimension;
import java.awt.Font;
import java.awt.FontMetrics;
import java.awt.Graphics;
import java.awt.Graphics2D;
import java.awt.GraphicsConfiguration;
import java.awt.GraphicsEnvironment;
import java.awt.GridBagConstraints;
import java.awt.GridBagLayout;
import java.awt.GridLayout;
import java.awt.Insets;
import java.awt.Point;
import java.awt.RenderingHints;
import java.awt.Toolkit;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.awt.event.AdjustmentEvent;
import java.awt.event.AdjustmentListener;
import java.awt.event.ruponentAdapter;
import java.awt.event.ruponentEvent;
import java.awt.event.ItemEvent;
import java.awt.event.ItemListener;
import java.awt.event.MouseEvent;
import java.awt.event.MouseListener;
import java.awt.event.MouseMotionListener;
import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;
import java.awt.font.FontRenderContext;
import java.awt.font.GlyphVector;
import java.awt.font.LineBreakMeasurer;
import java.awt.font.TextLayout;
import java.awt.geom.AffineTransform;
import java.awt.geom.NoninvertibleTransformException;
import java.awt.geom.Rectangle2D;
import java.awt.image.BufferedImage;
import java.awt.print.PageFormat;
import java.awt.print.Printable;
import java.awt.print.PrinterJob;
import java.io.BufferedInputStream;
import java.io.BufferedOutputStream;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.text.AttributedString;
import java.util.BitSet;
import java.util.EnumSet;
import java.util.StringTokenizer;
import java.util.Vector;
import javax.imageio.ImageIO;
import javax.swing.ButtonGroup;
import javax.swing.DefaultListCellRenderer;
import javax.swing.ImageIcon;
import javax.swing.JButton;
import javax.swing.JCheckBoxMenuItem;
import javax.swing.JComboBox;
import javax.swing.JComponent;
import javax.swing.JDialog;
import javax.swing.JFileChooser;
import javax.swing.JFrame;
import javax.swing.JLabel;
import javax.swing.JList;
import javax.swing.JMenu;
import javax.swing.JMenuBar;
import javax.swing.JMenuItem;
import javax.swing.JPanel;
import javax.swing.JRadioButton;
import javax.swing.JScrollBar;
import javax.swing.JScrollPane;
import javax.swing.JSlider;
import javax.swing.JTextArea;
import javax.swing.JTextField;
import javax.swing.JWindow;
import javax.swing.UIManager;
import javax.swing.event.ChangeEvent;
import javax.swing.event.ChangeListener;
/**
* Font2DTest.java
*
* @version
* @(#)Font2DTest.java 1.2 00/08/22
* @author Shinsuke Fukuda
* @author Ankit Patel [Conversion to Swing - 01/07/30]
*/
// / Main Font2DTest Class
public final class Font2DTest extends JPanel implements ActionListener, ItemListener,
ChangeListener {
// / JFrame that will contain Font2DTest
private final JFrame parent;
// / FontPanel class that will contain all graphical output
private final FontPanel fp;
// / RangeMenu class that contains info about the unicode ranges
private final RangeMenu rm;
// / Other menus to set parameters for text drawing
private final ChoiceV2 fontMenu;
private final JTextField sizeField;
private final ChoiceV2 styleMenu;
private final ChoiceV2 textMenu;
private int currentTextChoice = 0;
private final ChoiceV2 transformMenu;
private final ChoiceV2 transformMenuG2;
private final ChoiceV2 methodsMenu;
private final JComboBox antiAliasMenu;
private final JComboBox fracMetricsMenu;
private final JSlider contrastSlider;
// / CheckboxMenuItems
private CheckboxMenuItemV2 displayGridCBMI;
private CheckboxMenuItemV2 force16ColsCBMI;
private CheckboxMenuItemV2 showFontInfoCBMI;
// / JDialog boxes
private JDialog userTextDialog;
private JTextArea userTextArea;
private JDialog printDialog;
private JDialog fontInfoDialog;
private LabelV2 fontInfos[] = new LabelV2[2];
private JFileChooser filePromptDialog = null;
private ButtonGroup printCBGroup;
private JRadioButton printModeCBs[] = new JRadioButton[3];
// / Status bar
private final LabelV2 statusBar;
private int fontStyles[] = { Font.PLAIN, Font.BOLD, Font.ITALIC, Font.BOLD | Font.ITALIC };
// / Text filename
private String tFileName;
// Enabled or disabled status of canDisplay check
private static boolean canDisplayCheck = true;
// / Initialize GUI variables and its layouts
public Font2DTest(JFrame f, boolean isApplet) {
parent = f;
rm = new RangeMenu(this, parent);
fp = new FontPanel(this, parent);
statusBar = new LabelV2("");
fontMenu = new ChoiceV2(this, canDisplayCheck);
sizeField = new JTextField("12", 3);
sizeField.addActionListener(this);
styleMenu = new ChoiceV2(this);
textMenu = new ChoiceV2(); // listener added later
transformMenu = new ChoiceV2(this);
transformMenuG2 = new ChoiceV2(this);
methodsMenu = new ChoiceV2(this);
antiAliasMenu = new JComboBox(EnumSet.allOf(FontPanel.AAValues.class).toArray());
antiAliasMenu.addActionListener(this);
fracMetricsMenu = new JComboBox(EnumSet.allOf(FontPanel.FMValues.class).toArray());
fracMetricsMenu.addActionListener(this);
contrastSlider = new JSlider(JSlider.HORIZONTAL, 100, 250, FontPanel.getDefaultLCDContrast()
.intValue());
contrastSlider.setEnabled(false);
contrastSlider.setMajorTickSpacing(20);
contrastSlider.setMinorTickSpacing(10);
contrastSlider.setPaintTicks(true);
contrastSlider.setPaintLabels(true);
contrastSlider.addChangeListener(this);
setupPanel();
setupMenu(isApplet);
setupDialog(isApplet);
if (canDisplayCheck) {
fireRangeChanged();
}
}
// / Set up the main interface panel
private void setupPanel() {
GridBagLayout gbl = new GridBagLayout();
GridBagConstraints gbc = new GridBagConstraints();
gbc.fill = GridBagConstraints.HORIZONTAL;
gbc.weightx = 1;
gbc.insets = new Insets(2, 0, 2, 2);
this.setLayout(gbl);
addLabeledComponentToGBL("Font: ", fontMenu, gbl, gbc, this);
addLabeledComponentToGBL("Size: ", sizeField, gbl, gbc, this);
gbc.gridwidth = GridBagConstraints.REMAINDER;
addLabeledComponentToGBL("Font Transform:", transformMenu, gbl, gbc, this);
gbc.gridwidth = 1;
addLabeledComponentToGBL("Range: ", rm, gbl, gbc, this);
addLabeledComponentToGBL("Style: ", styleMenu, gbl, gbc, this);
gbc.gridwidth = GridBagConstraints.REMAINDER;
addLabeledComponentToGBL("Graphics Transform: ", transformMenuG2, gbl, gbc, this);
gbc.gridwidth = 1;
gbc.anchor = GridBagConstraints.WEST;
addLabeledComponentToGBL("Method: ", methodsMenu, gbl, gbc, this);
addLabeledComponentToGBL("", null, gbl, gbc, this);
gbc.anchor = GridBagConstraints.EAST;
gbc.gridwidth = GridBagConstraints.REMAINDER;
addLabeledComponentToGBL("Text to use:", textMenu, gbl, gbc, this);
gbc.weightx = 1;
gbc.gridwidth = 1;
gbc.fill = GridBagConstraints.HORIZONTAL;
gbc.anchor = GridBagConstraints.WEST;
addLabeledComponentToGBL("LCD contrast: ", contrastSlider, gbl, gbc, this);
gbc.gridwidth = 1;
gbc.fill = GridBagConstraints.NONE;
addLabeledComponentToGBL("Antialiasing: ", antiAliasMenu, gbl, gbc, this);
gbc.anchor = GridBagConstraints.EAST;
gbc.gridwidth = GridBagConstraints.REMAINDER;
addLabeledComponentToGBL("Fractional metrics: ", fracMetricsMenu, gbl, gbc, this);
gbc.weightx = 1;
gbc.weighty = 1;
gbc.anchor = GridBagConstraints.WEST;
gbc.insets = new Insets(2, 0, 0, 2);
gbc.fill = GridBagConstraints.BOTH;
gbl.setConstraints(fp, gbc);
this.add(fp);
gbc.weighty = 0;
gbc.insets = new Insets(0, 2, 0, 0);
gbl.setConstraints(statusBar, gbc);
this.add(statusBar);
}
// / Adds a component to a container with a label to its left in GridBagLayout
private void addLabeledComponentToGBL(String name, JComponent c, GridBagLayout gbl,
GridBagConstraints gbc, Container target) {
LabelV2 l = new LabelV2(name);
GridBagConstraints gbcLabel = (GridBagConstraints) gbc.clone();
gbcLabel.insets = new Insets(2, 2, 2, 0);
gbcLabel.gridwidth = 1;
gbcLabel.weightx = 0;
if (c == null)
c = new JLabel("");
gbl.setConstraints(l, gbcLabel);
target.add(l);
gbl.setConstraints(c, gbc);
target.add(c);
}
// / Sets up menu entries
private void setupMenu(boolean isApplet) {
JMenu fileMenu = new JMenu("File");
JMenu optionMenu = new JMenu("Option");
fileMenu.add(new MenuItemV2("Save Selected Options...", this));
fileMenu.add(new MenuItemV2("Load Options...", this));
fileMenu.addSeparator();
fileMenu.add(new MenuItemV2("Save as PNG...", this));
fileMenu.add(new MenuItemV2("Load PNG File to Compare...", this));
fileMenu.add(new MenuItemV2("Page Setup...", this));
fileMenu.add(new MenuItemV2("Print...", this));
fileMenu.addSeparator();
if (!isApplet)
fileMenu.add(new MenuItemV2("Exit", this));
else
fileMenu.add(new MenuItemV2("Close", this));
displayGridCBMI = new CheckboxMenuItemV2("Display Grid", true, this);
force16ColsCBMI = new CheckboxMenuItemV2("Force 16 Columns", false, this);
showFontInfoCBMI = new CheckboxMenuItemV2("Display Font Info", false, this);
optionMenu.add(displayGridCBMI);
optionMenu.add(force16ColsCBMI);
optionMenu.add(showFontInfoCBMI);
JMenuBar mb = parent.getJMenuBar();
if (mb == null)
mb = new JMenuBar();
mb.add(fileMenu);
mb.add(optionMenu);
parent.setJMenuBar(mb);
String fontList[] = GraphicsEnvironment.getLocalGraphicsEnvironment()
.getAvailableFontFamilyNames();
for (int i = 0; i < fontList.length; i++)
fontMenu.addItem(fontList[i]);
fontMenu.setSelectedItem("Dialog");
styleMenu.addItem("Plain");
styleMenu.addItem("Bold");
styleMenu.addItem("Italic");
styleMenu.addItem("Bold Italic");
transformMenu.addItem("None");
transformMenu.addItem("Scale");
transformMenu.addItem("Shear");
transformMenu.addItem("Rotate");
transformMenuG2.addItem("None");
transformMenuG2.addItem("Scale");
transformMenuG2.addItem("Shear");
transformMenuG2.addItem("Rotate");
methodsMenu.addItem("drawString");
methodsMenu.addItem("drawChars");
methodsMenu.addItem("drawBytes");
methodsMenu.addItem("drawGlyphVector");
methodsMenu.addItem("TextLayout.draw");
methodsMenu.addItem("GlyphVector.getOutline + draw");
methodsMenu.addItem("TextLayout.getOutline + draw");
textMenu.addItem("Unicode Range");
textMenu.addItem("All Glyphs");
textMenu.addItem("User Text");
textMenu.addItem("Text File");
textMenu.addActionListener(this); // listener added later so unneeded events
// not thrown
}
// / Sets up the all dialogs used in Font2DTest...
private void setupDialog(boolean isApplet) {
if (!isApplet)
filePromptDialog = new JFileChooser();
else
filePromptDialog = null;
// / Prepare user text dialog...
userTextDialog = new JDialog(parent, "User Text", false);
JPanel dialogTopPanel = new JPanel();
JPanel dialogBottomPanel = new JPanel();
LabelV2 message1 = new LabelV2("Enter text below and then press update");
LabelV2 message2 = new LabelV2("(Unicode char can be denoted by \\uXXXX)");
LabelV2 message3 = new LabelV2("(Supplementary chars can be denoted by \\UXXXXXX)");
userTextArea = new JTextArea("Java2D!");
ButtonV2 bUpdate = new ButtonV2("Update", this);
userTextArea.setFont(new Font("dialog", Font.PLAIN, 12));
dialogTopPanel.setLayout(new GridLayout(3, 1));
dialogTopPanel.add(message1);
dialogTopPanel.add(message2);
dialogTopPanel.add(message3);
dialogBottomPanel.add(bUpdate);
// ABP
JScrollPane userTextAreaSP = new JScrollPane(userTextArea);
userTextAreaSP.setPreferredSize(new Dimension(300, 100));
userTextDialog.getContentPane().setLayout(new BorderLayout());
userTextDialog.getContentPane().add("North", dialogTopPanel);
userTextDialog.getContentPane().add("Center", userTextAreaSP);
userTextDialog.getContentPane().add("South", dialogBottomPanel);
userTextDialog.pack();
userTextDialog.addWindowListener(new WindowAdapter() {
public void windowClosing(WindowEvent e) {
userTextDialog.hide();
}
});
// / Prepare printing dialog...
printCBGroup = new ButtonGroup();
printModeCBs[fp.ONE_PAGE] = new JRadioButton(
"Print one page from currently displayed character/line", true);
printModeCBs[fp.CUR_RANGE] = new JRadioButton(
"Print all characters in currently selected range", false);
printModeCBs[fp.ALL_TEXT] = new JRadioButton("Print all lines of text", false);
LabelV2 l = new LabelV2(
"Note: Page range in native \"Print\" dialog will not affect the result");
JPanel buttonPanel = new JPanel();
printModeCBs[fp.ALL_TEXT].setEnabled(false);
buttonPanel.add(new ButtonV2("Print", this));
buttonPanel.add(new ButtonV2("Cancel", this));
printDialog = new JDialog(parent, "Print...", true);
printDialog.setResizable(false);
printDialog.addWindowListener(new WindowAdapter() {
public void windowClosing(WindowEvent e) {
printDialog.hide();
}
});
printDialog.getContentPane().setLayout(new GridLayout(printModeCBs.length + 2, 1));
printDialog.getContentPane().add(l);
for (int i = 0; i < printModeCBs.length; i++) {
printCBGroup.add(printModeCBs[i]);
printDialog.getContentPane().add(printModeCBs[i]);
}
printDialog.getContentPane().add(buttonPanel);
printDialog.pack();
// / Prepare font information dialog...
fontInfoDialog = new JDialog(parent, "Font info", false);
fontInfoDialog.setResizable(false);
fontInfoDialog.addWindowListener(new WindowAdapter() {
public void windowClosing(WindowEvent e) {
fontInfoDialog.hide();
showFontInfoCBMI.setState(false);
}
});
JPanel fontInfoPanel = new JPanel();
fontInfoPanel.setLayout(new GridLayout(fontInfos.length, 1));
for (int i = 0; i < fontInfos.length; i++) {
fontInfos[i] = new LabelV2("");
fontInfoPanel.add(fontInfos[i]);
}
fontInfoDialog.getContentPane().add(fontInfoPanel);
// / Move the location of the dialog...
userTextDialog.setLocation(200, 300);
fontInfoDialog.setLocation(0, 400);
}
// / RangeMenu object signals using this function
// / when Unicode range has been changed and text needs to be redrawn
public void fireRangeChanged() {
int range[] = rm.getSelectedRange();
fp.setTextToDraw(fp.RANGE_TEXT, range, null, null);
if (canDisplayCheck) {
setupFontList(range[0], range[1]);
}
if (showFontInfoCBMI.getState())
fireUpdateFontInfo();
}
// / Changes the message on the status bar
public void fireChangeStatus(String message, boolean error) {
// / If this is not ran as an applet, use own status bar,
// / Otherwise, use the appletviewer/browser"s status bar
statusBar.setText(message);
if (error)
fp.showingError = true;
else
fp.showingError = false;
}
// / Updates the information about the selected font
public void fireUpdateFontInfo() {
if (showFontInfoCBMI.getState()) {
String infos[] = fp.getFontInfo();
for (int i = 0; i < fontInfos.length; i++)
fontInfos[i].setText(infos[i]);
fontInfoDialog.pack();
}
}
private void setupFontList(int rangeStart, int rangeEnd) {
int listCount = fontMenu.getItemCount();
int size = 16;
try {
size = Float.valueOf(sizeField.getText()).intValue();
} catch (Exception e) {
System.out.println("Invalid font size in the size textField. Using default value of 16");
}
int style = fontStyles[styleMenu.getSelectedIndex()];
Font f;
for (int i = 0; i < listCount; i++) {
String fontName = (String) fontMenu.getItemAt(i);
f = new Font(fontName, style, size);
if ((rm.getSelectedIndex() != RangeMenu.SURROGATES_AREA_INDEX)
&& canDisplayRange(f, rangeStart, rangeEnd)) {
fontMenu.setBit(i, true);
} else {
fontMenu.setBit(i, false);
}
}
fontMenu.repaint();
}
protected boolean canDisplayRange(Font font, int rangeStart, int rangeEnd) {
for (int i = rangeStart; i < rangeEnd; i++) {
if (font.canDisplay(i)) {
return true;
}
}
return false;
}
// / Displays a file load/save dialog and returns the specified file
private String promptFile(boolean isSave, String initFileName) {
int retVal;
String str;
// / ABP
if (filePromptDialog == null)
return null;
if (isSave) {
filePromptDialog.setDialogType(JFileChooser.SAVE_DIALOG);
filePromptDialog.setDialogTitle("Save...");
str = "Save";
} else {
filePromptDialog.setDialogType(JFileChooser.OPEN_DIALOG);
filePromptDialog.setDialogTitle("Load...");
str = "Load";
}
if (initFileName != null)
filePromptDialog.setSelectedFile(new File(initFileName));
retVal = filePromptDialog.showDialog(this, str);
if (retVal == JFileChooser.APPROVE_OPTION) {
File file = filePromptDialog.getSelectedFile();
String fileName = file.getAbsolutePath();
if (fileName != null) {
return fileName;
}
}
return null;
}
// / Converts user text into arrays of String, delimited at newline character
// / Also replaces any valid escape sequence with appropriate unicode
// character
// / Support \\UXXXXXX notation for surrogates
private String[] parseUserText(String orig) {
int length = orig.length();
StringTokenizer perLine = new StringTokenizer(orig, "\n");
String textLines[] = new String[perLine.countTokens()];
int lineNumber = 0;
while (perLine.hasMoreElements()) {
StringBuffer converted = new StringBuffer();
String oneLine = perLine.nextToken();
int lineLength = oneLine.length();
int prevEscapeEnd = 0;
int nextEscape = -1;
do {
int nextBMPEscape = oneLine.indexOf("\\u", prevEscapeEnd);
int nextSupEscape = oneLine.indexOf("\\U", prevEscapeEnd);
nextEscape = (nextBMPEscape < 0) ? ((nextSupEscape < 0) ? -1 : nextSupEscape)
: ((nextSupEscape < 0) ? nextBMPEscape : Math.min(nextBMPEscape, nextSupEscape));
if (nextEscape != -1) {
if (prevEscapeEnd < nextEscape)
converted.append(oneLine.substring(prevEscapeEnd, nextEscape));
prevEscapeEnd = nextEscape + (nextEscape == nextBMPEscape ? 6 : 8);
try {
String hex = oneLine.substring(nextEscape + 2, prevEscapeEnd);
if (nextEscape == nextBMPEscape) {
converted.append((char) Integer.parseInt(hex, 16));
} else {
converted.append(new String(Character.toChars(Integer.parseInt(hex, 16))));
}
} catch (Exception e) {
int copyLimit = Math.min(lineLength, prevEscapeEnd);
converted.append(oneLine.substring(nextEscape, copyLimit));
}
}
} while (nextEscape != -1);
if (prevEscapeEnd < lineLength)
converted.append(oneLine.substring(prevEscapeEnd, lineLength));
textLines[lineNumber++] = converted.toString();
}
return textLines;
}
// / Reads the text from specified file, detecting UTF-16 encoding
// / Then breaks the text into String array, delimited at every line break
private void readTextFile(String fileName) {
try {
String fileText, textLines[];
BufferedInputStream bis = new BufferedInputStream(new FileInputStream(fileName));
int numBytes = bis.available();
if (numBytes == 0) {
throw new Exception("Text file " + fileName + " is empty");
}
byte byteData[] = new byte[numBytes];
bis.read(byteData, 0, numBytes);
bis.close();
// / If byte mark is found, then use UTF-16 encoding to convert bytes...
if (numBytes >= 2
&& ((byteData[0] == (byte) 0xFF && byteData[1] == (byte) 0xFE) || (byteData[0] == (byte) 0xFE && byteData[1] == (byte) 0xFF)))
fileText = new String(byteData, "UTF-16");
// / Otherwise, use system default encoding
else
fileText = new String(byteData);
int length = fileText.length();
StringTokenizer perLine = new StringTokenizer(fileText, "\n");
// / Determine "Return Char" used in this file
// / This simply finds first occurrence of CR, CR+LF or LF...
for (int i = 0; i < length; i++) {
char iTh = fileText.charAt(i);
if (iTh == "\r") {
if (i < length - 1 && fileText.charAt(i + 1) == "\n")
perLine = new StringTokenizer(fileText, "\r\n");
else
perLine = new StringTokenizer(fileText, "\r");
break;
} else if (iTh == "\n")
// / Use the one already created
break;
}
int lineNumber = 0, numLines = perLine.countTokens();
textLines = new String[numLines];
while (perLine.hasMoreElements()) {
String oneLine = perLine.nextToken();
if (oneLine == null)
// / To make LineBreakMeasurer to return a valid TextLayout
// / on an empty line, simply feed it a space char...
oneLine = " ";
textLines[lineNumber++] = oneLine;
}
fp.setTextToDraw(fp.FILE_TEXT, null, null, textLines);
rm.setEnabled(false);
methodsMenu.setEnabled(false);
} catch (Exception ex) {
fireChangeStatus("ERROR: Failed to Read Text File; See Stack Trace", true);
ex.printStackTrace();
}
}
// / Returns a String storing current configuration
private void writeCurrentOptions(String fileName) {
try {
String curOptions = fp.getCurrentOptions();
BufferedOutputStream bos = new BufferedOutputStream(new FileOutputStream(fileName));
// / Prepend title and the option that is only obtainable here
int range[] = rm.getSelectedRange();
String completeOptions = ("Font2DTest Option File\n" + displayGridCBMI.getState() + "\n"
+ force16ColsCBMI.getState() + "\n" + showFontInfoCBMI.getState() + "\n"
+ rm.getSelectedItem() + "\n" + range[0] + "\n" + range[1] + "\n" + curOptions + tFileName);
byte toBeWritten[] = completeOptions.getBytes("UTF-16");
bos.write(toBeWritten, 0, toBeWritten.length);
bos.close();
} catch (Exception ex) {
fireChangeStatus("ERROR: Failed to Save Options File; See Stack Trace", true);
ex.printStackTrace();
}
}
// / Updates GUI visibility/status after some parameters have changed
private void updateGUI() {
int selectedText = textMenu.getSelectedIndex();
// / Set the visibility of User Text dialog
if (selectedText == fp.USER_TEXT)
userTextDialog.show();
else
userTextDialog.hide();
// / Change the visibility/status/availability of Print JDialog buttons
printModeCBs[fp.ONE_PAGE].setSelected(true);
if (selectedText == fp.FILE_TEXT || selectedText == fp.USER_TEXT) {
// / ABP
// / update methodsMenu to show that TextLayout.draw is being used
// / when we are in FILE_TEXT mode
if (selectedText == fp.FILE_TEXT)
methodsMenu.setSelectedItem("TextLayout.draw");
methodsMenu.setEnabled(selectedText == fp.USER_TEXT);
printModeCBs[fp.CUR_RANGE].setEnabled(false);
printModeCBs[fp.ALL_TEXT].setEnabled(true);
} else {
// / ABP
// / update methodsMenu to show that drawGlyph is being used
// / when we are in ALL_GLYPHS mode
if (selectedText == fp.ALL_GLYPHS)
methodsMenu.setSelectedItem("drawGlyphVector");
methodsMenu.setEnabled(selectedText == fp.RANGE_TEXT);
printModeCBs[fp.CUR_RANGE].setEnabled(true);
printModeCBs[fp.ALL_TEXT].setEnabled(false);
}
// / Modify RangeMenu and fontInfo label availabilty
if (selectedText == fp.RANGE_TEXT) {
fontInfos[1].setVisible(true);
rm.setEnabled(true);
} else {
fontInfos[1].setVisible(false);
rm.setEnabled(false);
}
}
// / Loads saved options and applies them
private void loadOptions(String fileName) {
try {
BufferedInputStream bis = new BufferedInputStream(new FileInputStream(fileName));
int numBytes = bis.available();
byte byteData[] = new byte[numBytes];
bis.read(byteData, 0, numBytes);
bis.close();
if (numBytes < 2 || (byteData[0] != (byte) 0xFE || byteData[1] != (byte) 0xFF))
throw new Exception("Not a Font2DTest options file");
String options = new String(byteData, "UTF-16");
StringTokenizer perLine = new StringTokenizer(options, "\n");
String title = perLine.nextToken();
if (!title.equals("Font2DTest Option File"))
throw new Exception("Not a Font2DTest options file");
// / Parse all options
boolean displayGridOpt = Boolean.parseBoolean(perLine.nextToken());
boolean force16ColsOpt = Boolean.parseBoolean(perLine.nextToken());
boolean showFontInfoOpt = Boolean.parseBoolean(perLine.nextToken());
String rangeNameOpt = perLine.nextToken();
int rangeStartOpt = Integer.parseInt(perLine.nextToken());
int rangeEndOpt = Integer.parseInt(perLine.nextToken());
String fontNameOpt = perLine.nextToken();
float fontSizeOpt = Float.parseFloat(perLine.nextToken());
int fontStyleOpt = Integer.parseInt(perLine.nextToken());
int fontTransformOpt = Integer.parseInt(perLine.nextToken());
int g2TransformOpt = Integer.parseInt(perLine.nextToken());
int textToUseOpt = Integer.parseInt(perLine.nextToken());
int drawMethodOpt = Integer.parseInt(perLine.nextToken());
int antialiasOpt = Integer.parseInt(perLine.nextToken());
int fractionalOpt = Integer.parseInt(perLine.nextToken());
int lcdContrast = Integer.parseInt(perLine.nextToken());
String userTextOpt[] = { "Java2D!" }, dialogEntry = "Java2D!";
if (textToUseOpt == fp.USER_TEXT) {
int numLines = perLine.countTokens(), lineNumber = 0;
if (numLines != 0) {
userTextOpt = new String[numLines];
dialogEntry = "";
for (; perLine.hasMoreElements(); lineNumber++) {
userTextOpt[lineNumber] = perLine.nextToken();
dialogEntry += userTextOpt[lineNumber] + "\n";
}
}
}
// / Reset GUIs
displayGridCBMI.setState(displayGridOpt);
force16ColsCBMI.setState(force16ColsOpt);
showFontInfoCBMI.setState(showFontInfoOpt);
rm.setSelectedRange(rangeNameOpt, rangeStartOpt, rangeEndOpt);
fontMenu.setSelectedItem(fontNameOpt);
sizeField.setText(String.valueOf(fontSizeOpt));
styleMenu.setSelectedIndex(fontStyleOpt);
transformMenu.setSelectedIndex(fontTransformOpt);
transformMenuG2.setSelectedIndex(g2TransformOpt);
textMenu.setSelectedIndex(textToUseOpt);
methodsMenu.setSelectedIndex(drawMethodOpt);
antiAliasMenu.setSelectedIndex(antialiasOpt);
fracMetricsMenu.setSelectedIndex(fractionalOpt);
contrastSlider.setValue(lcdContrast);
userTextArea.setText(dialogEntry);
updateGUI();
if (textToUseOpt == fp.FILE_TEXT) {
tFileName = perLine.nextToken();
readTextFile(tFileName);
}
// / Reset option variables and repaint
fp.loadOptions(displayGridOpt, force16ColsOpt, rangeStartOpt, rangeEndOpt, fontNameOpt,
fontSizeOpt, fontStyleOpt, fontTransformOpt, g2TransformOpt, textToUseOpt, drawMethodOpt,
antialiasOpt, fractionalOpt, lcdContrast, userTextOpt);
if (showFontInfoOpt) {
fireUpdateFontInfo();
fontInfoDialog.show();
} else
fontInfoDialog.hide();
} catch (Exception ex) {
fireChangeStatus("ERROR: Failed to Load Options File; See Stack Trace", true);
ex.printStackTrace();
}
}
// / Loads a previously saved image
private void loadComparisonPNG(String fileName) {
try {
BufferedImage image = javax.imageio.ImageIO.read(new File(fileName));
JFrame f = new JFrame("Comparison PNG");
ImagePanel ip = new ImagePanel(image);
f.setResizable(false);
f.getContentPane().add(ip);
f.addWindowListener(new WindowAdapter() {
public void windowClosing(WindowEvent e) {
((JFrame) e.getSource()).dispose();
}
});
f.pack();
f.show();
} catch (Exception ex) {
fireChangeStatus("ERROR: Failed to Load PNG File; See Stack Trace", true);
ex.printStackTrace();
}
}
// / Interface functions...
// / ActionListener interface function
// / Responds to JMenuItem, JTextField and JButton actions
public void actionPerformed(ActionEvent e) {
Object source = e.getSource();
if (source instanceof JMenuItem) {
JMenuItem mi = (JMenuItem) source;
String itemName = mi.getText();
if (itemName.equals("Save Selected Options...")) {
String fileName = promptFile(true, "options.txt");
if (fileName != null)
writeCurrentOptions(fileName);
} else if (itemName.equals("Load Options...")) {
String fileName = promptFile(false, "options.txt");
if (fileName != null)
loadOptions(fileName);
} else if (itemName.equals("Save as PNG...")) {
String fileName = promptFile(true, fontMenu.getSelectedItem() + ".png");
if (fileName != null)
fp.doSavePNG(fileName);
} else if (itemName.equals("Load PNG File to Compare...")) {
String fileName = promptFile(false, null);
if (fileName != null)
loadComparisonPNG(fileName);
} else if (itemName.equals("Page Setup..."))
fp.doPageSetup();
else if (itemName.equals("Print..."))
printDialog.show();
else if (itemName.equals("Close"))
parent.dispose();
else if (itemName.equals("Exit"))
System.exit(0);
}
else if (source instanceof JTextField) {
JTextField tf = (JTextField) source;
float sz = 12f;
try {
sz = Float.parseFloat(sizeField.getText());
if (sz < 1f || sz > 120f) {
sz = 12f;
sizeField.setText("12");
}
} catch (Exception se) {
sizeField.setText("12");
}
if (tf == sizeField)
fp.setFontParams(fontMenu.getSelectedItem(), sz, styleMenu.getSelectedIndex(),
transformMenu.getSelectedIndex());
}
else if (source instanceof JButton) {
String itemName = ((JButton) source).getText();
// / Print dialog buttons...
if (itemName.equals("Print")) {
for (int i = 0; i < printModeCBs.length; i++)
if (printModeCBs[i].isSelected()) {
printDialog.hide();
fp.doPrint(i);
}
} else if (itemName.equals("Cancel"))
printDialog.hide();
// / Update button from Usert Text JDialog...
else if (itemName.equals("Update"))
fp.setTextToDraw(fp.USER_TEXT, null, parseUserText(userTextArea.getText()), null);
} else if (source instanceof JComboBox) {
JComboBox c = (JComboBox) source;
// / RangeMenu handles actions by itself and then calls fireRangeChanged,
// / so it is not listed or handled here
if (c == fontMenu || c == styleMenu || c == transformMenu) {
float sz = 12f;
try {
sz = Float.parseFloat(sizeField.getText());
if (sz < 1f || sz > 120f) {
sz = 12f;
sizeField.setText("12");
}
} catch (Exception se) {
sizeField.setText("12");
}
fp.setFontParams(fontMenu.getSelectedItem(), sz, styleMenu.getSelectedIndex(),
transformMenu.getSelectedIndex());
} else if (c == methodsMenu)
fp.setDrawMethod(methodsMenu.getSelectedIndex());
else if (c == textMenu) {
if (canDisplayCheck) {
fireRangeChanged();
}
int selected = textMenu.getSelectedIndex();
if (selected == fp.RANGE_TEXT)
fp.setTextToDraw(fp.RANGE_TEXT, rm.getSelectedRange(), null, null);
else if (selected == fp.USER_TEXT)
fp.setTextToDraw(fp.USER_TEXT, null, parseUserText(userTextArea.getText()), null);
else if (selected == fp.FILE_TEXT) {
String fileName = promptFile(false, null);
if (fileName != null) {
tFileName = fileName;
readTextFile(fileName);
} else {
// / User cancelled selection; reset to previous choice
c.setSelectedIndex(currentTextChoice);
return;
}
} else if (selected == fp.ALL_GLYPHS)
fp.setTextToDraw(fp.ALL_GLYPHS, null, null, null);
updateGUI();
currentTextChoice = selected;
} else if (c == transformMenuG2) {
fp.setTransformG2(transformMenuG2.getSelectedIndex());
} else if (c == antiAliasMenu || c == fracMetricsMenu) {
if (c == antiAliasMenu) {
boolean enabled = FontPanel.AAValues.isLCDMode(antiAliasMenu.getSelectedItem());
contrastSlider.setEnabled(enabled);
}
fp.setRenderingHints(antiAliasMenu.getSelectedItem(), fracMetricsMenu.getSelectedItem(),
contrastSlider.getValue());
}
}
}
public void stateChanged(ChangeEvent e) {
Object source = e.getSource();
if (source instanceof JSlider) {
fp.setRenderingHints(antiAliasMenu.getSelectedItem(), fracMetricsMenu.getSelectedItem(),
contrastSlider.getValue());
}
}
// / ItemListener interface function
// / Responds to JCheckBoxMenuItem, JComboBox and JCheckBox actions
public void itemStateChanged(ItemEvent e) {
Object source = e.getSource();
if (source instanceof JCheckBoxMenuItem) {
JCheckBoxMenuItem cbmi = (JCheckBoxMenuItem) source;
if (cbmi == displayGridCBMI)
fp.setGridDisplay(displayGridCBMI.getState());
else if (cbmi == force16ColsCBMI)
fp.setForce16Columns(force16ColsCBMI.getState());
else if (cbmi == showFontInfoCBMI) {
if (showFontInfoCBMI.getState()) {
fireUpdateFontInfo();
fontInfoDialog.show();
} else
fontInfoDialog.hide();
}
}
}
private static void printUsage() {
String usage = "Usage: java -jar Font2DTest.jar [options]\n" + "\nwhere options include:\n"
+ " -dcdc | -disablecandisplaycheck disable canDisplay check for font\n"
+ " -? | -help print this help message\n" + "\nExample :\n"
+ " To disable canDisplay check on font for ranges\n"
+ " java -jar Font2DTest.jar -dcdc";
System.out.println(usage);
System.exit(0);
}
// / Main function
public static void main(String argv[]) {
if (argv.length > 0) {
if (argv[0].equalsIgnoreCase("-disablecandisplaycheck") || argv[0].equalsIgnoreCase("-dcdc")) {
canDisplayCheck = false;
} else {
printUsage();
}
}
UIManager.put("swing.boldMetal", Boolean.FALSE);
final JFrame f = new JFrame("Font2DTest");
final Font2DTest f2dt = new Font2DTest(f, false);
f.addWindowListener(new WindowAdapter() {
public void windowOpening(WindowEvent e) {
f2dt.repaint();
}
public void windowClosing(WindowEvent e) {
System.exit(0);
}
});
f.getContentPane().add(f2dt);
f.pack();
f.show();
}
// / Inner class definitions...
// / Class to display just an image file
// / Used to show the comparison PNG image
private final class ImagePanel extends JPanel {
private final BufferedImage bi;
public ImagePanel(BufferedImage image) {
bi = image;
}
public Dimension getPreferredSize() {
return new Dimension(bi.getWidth(), bi.getHeight());
}
public void paintComponent(Graphics g) {
g.drawImage(bi, 0, 0, this);
}
}
// / Classes made to avoid repetitive calls... (being lazy)
private final class ButtonV2 extends JButton {
public ButtonV2(String name, ActionListener al) {
super(name);
this.addActionListener(al);
}
}
private final class ChoiceV2 extends JComboBox {
private BitSet bitSet = null;
public ChoiceV2() {
;
}
public ChoiceV2(ActionListener al) {
super();
this.addActionListener(al);
}
public ChoiceV2(ActionListener al, boolean fontChoice) {
this(al);
if (fontChoice) {
// Register this component in ToolTipManager
setToolTipText("");
bitSet = new BitSet();
setRenderer(new ChoiceV2Renderer(this));
}
}
public String getToolTipText() {
int index = this.getSelectedIndex();
String fontName = (String) this.getSelectedItem();
if (fontName != null && (textMenu.getSelectedIndex() == fp.RANGE_TEXT)) {
if (getBit(index)) {
return "Font \"" + fontName + "\" can display some characters in \""
+ rm.getSelectedItem() + "\" range";
} else {
return "Font \"" + fontName + "\" cannot display any characters in \""
+ rm.getSelectedItem() + "\" range";
}
}
return super.getToolTipText();
}
public void setBit(int bitIndex, boolean value) {
bitSet.set(bitIndex, value);
}
public boolean getBit(int bitIndex) {
return bitSet.get(bitIndex);
}
}
private final class ChoiceV2Renderer extends DefaultListCellRenderer {
private ImageIcon yesImage, blankImage;
private ChoiceV2 choice = null;
public ChoiceV2Renderer(ChoiceV2 choice) {
try {
yesImage = new ImageIcon(getClass().getResource("yes.gif"));
blankImage = new ImageIcon(getClass().getResource("blank.gif"));
} catch (Exception exception) {
System.out.println("Exception : " + exception);
}
this.choice = choice;
}
public Component getListCellRendererComponent(JList list, Object value, int index,
boolean isSelected, boolean cellHasFocus) {
if (textMenu.getSelectedIndex() == fp.RANGE_TEXT) {
super.getListCellRendererComponent(list, value, index, isSelected, cellHasFocus);
// For JComboBox if index is -1, its rendering the selected index.
if (index == -1) {
index = choice.getSelectedIndex();
}
if (choice.getBit(index)) {
setIcon(yesImage);
} else {
setIcon(blankImage);
}
} else {
super.getListCellRendererComponent(list, value, index, isSelected, cellHasFocus);
setIcon(blankImage);
}
return this;
}
}
private final class LabelV2 extends JLabel {
public LabelV2(String name) {
super(name);
}
}
private final class MenuItemV2 extends JMenuItem {
public MenuItemV2(String name, ActionListener al) {
super(name);
this.addActionListener(al);
}
}
private final class CheckboxMenuItemV2 extends JCheckBoxMenuItem {
public CheckboxMenuItemV2(String name, boolean b, ItemListener il) {
super(name, b);
this.addItemListener(il);
}
}
}
/*
* @(#)FontPanel.java 1.20 05/11/17
*
* Copyright (c) 2006 Sun Microsystems, Inc. All Rights Reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* -Redistribution of source code must retain the above copyright notice, this
* list of conditions and the following disclaimer.
*
* -Redistribution in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* Neither the name of Sun Microsystems, Inc. or the names of contributors may
* be used to endorse or promote products derived from this software without
* specific prior written permission.
*
* This software is provided "AS IS," without a warranty of any kind. ALL
* EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY
* IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR
* NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN MIDROSYSTEMS, INC. ("SUN") AND ITS
* LICENSORS SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A
* RESULT OF USING, MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES.
* IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT
* OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR
* PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY,
* ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE, EVEN IF SUN HAS
* BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
*
* You acknowledge that this software is not designed, licensed or intended for
* use in the design, construction, operation or maintenance of any nuclear
* facility.
*/
/*
* @(#)FontPanel.java 1.20 05/11/17
*/
/**
* FontPanel.java
*
* @version
* @(#)FontPanel.java 1.1 00/08/22
* @author Shinsuke Fukuda
* @author Ankit Patel [Conversion to Swing - 01/07/30]
*/
// / This panel is combination of the text drawing area of Font2DTest
// / and the custom controlled scroll bar
final class FontPanel extends JPanel implements AdjustmentListener {
// / Drawing Option Constants
private final String STYLES[] = { "plain", "bold", "italic", "bold italic" };
private final int NONE = 0;
private final int SCALE = 1;
private final int SHEAR = 2;
private final int ROTATE = 3;
private final String TRANSFORMS[] = { "with no transforms", "with scaling", "with Shearing",
"with rotation" };
private final int DRAW_STRING = 0;
private final int DRAW_CHARS = 1;
private final int DRAW_BYTES = 2;
private final int DRAW_GLYPHV = 3;
private final int TL_DRAW = 4;
private final int GV_OUTLINE = 5;
private final int TL_OUTLINE = 6;
private final String METHODS[] = { "drawString", "drawChars", "drawBytes", "drawGlyphVector",
"TextLayout.draw", "GlyphVector.getOutline", "TextLayout.getOutline" };
public final int RANGE_TEXT = 0;
public final int ALL_GLYPHS = 1;
public final int USER_TEXT = 2;
public final int FILE_TEXT = 3;
private final String MS_OPENING[] = { " Unicode ", " Glyph Code ", " lines ", " lines " };
private final String MS_CLOSING[] = { "", "", " of User Text ",
" of LineBreakMeasurer-reformatted Text " };
// / General Graphics Variable
private final JScrollBar verticalBar;
private final FontCanvas fc;
private boolean updateBackBuffer = true;
private boolean updateFontMetrics = true;
private boolean updateFont = true;
private boolean force16Cols = false;
public boolean showingError = false;
private int g2Transform = NONE; // / ABP
// / Printing constants and variables
public final int ONE_PAGE = 0;
public final int CUR_RANGE = 1;
public final int ALL_TEXT = 2;
private int printMode = ONE_PAGE;
private PageFormat page = null;
private PrinterJob printer = null;
// / Text drawing variables
private String fontName = "Dialog";
private float fontSize = 12;
private int fontStyle = Font.PLAIN;
private int fontTransform = NONE;
private Font testFont = null;
private Object antiAliasType = VALUE_TEXT_ANTIALIAS_DEFAULT;
private Object fractionalMetricsType = VALUE_FRACTIONALMETRICS_DEFAULT;
private Object lcdContrast = getDefaultLCDContrast();
private int drawMethod = DRAW_STRING;
private int textToUse = RANGE_TEXT;
private String userText[] = null;
private String fileText[] = null;
private int drawRange[] = { 0x0000, 0x007f };
private String fontInfos[] = new String[2];
private boolean showGrid = true;
// / Parent Font2DTest panel
private final Font2DTest f2dt;
private final JFrame parent;
public FontPanel(Font2DTest demo, JFrame f) {
f2dt = demo;
parent = f;
verticalBar = new JScrollBar(JScrollBar.VERTICAL);
fc = new FontCanvas();
this.setLayout(new BorderLayout());
this.add("Center", fc);
this.add("East", verticalBar);
verticalBar.addAdjustmentListener(this);
this.addComponentListener(new ComponentAdapter() {
public void componentResized(ComponentEvent e) {
updateBackBuffer = true;
updateFontMetrics = true;
}
});
// / Initialize font and its infos
testFont = new Font(fontName, fontStyle, (int) fontSize);
if ((float) ((int) fontSize) != fontSize) {
testFont = testFont.deriveFont(fontSize);
}
updateFontInfo();
}
public Dimension getPreferredSize() {
return new Dimension(600, 200);
}
// / Functions called by the main programs to set the various parameters
public void setTransformG2(int transform) {
g2Transform = transform;
updateBackBuffer = true;
updateFontMetrics = true;
fc.repaint();
}
// / convenience fcn to create AffineTransform of appropriate type
private AffineTransform getAffineTransform(int transform) {
// / ABP
AffineTransform at = new AffineTransform();
switch (transform) {
case SCALE:
at.setToScale(1.5f, 1.5f);
break;
case ROTATE:
at.setToRotation(Math.PI / 6);
break;
case SHEAR:
at.setToShear(0.4f, 0);
break;
case NONE:
break;
default:
// System.err.println( "Illegal G2 Transform Arg: " + transform);
break;
}
return at;
}
public void setFontParams(Object obj, float size, int style, int transform) {
setFontParams((String) obj, size, style, transform);
}
public void setFontParams(String name, float size, int style, int transform) {
boolean fontModified = false;
if (!name.equals(fontName) || style != fontStyle)
fontModified = true;
fontName = name;
fontSize = size;
fontStyle = style;
fontTransform = transform;
// / Recreate the font as specified
testFont = new Font(fontName, fontStyle, (int) fontSize);
if ((float) ((int) fontSize) != fontSize) {
testFont = testFont.deriveFont(fontSize);
}
if (fontTransform != NONE) {
AffineTransform at = getAffineTransform(fontTransform);
testFont = testFont.deriveFont(at);
}
updateBackBuffer = true;
updateFontMetrics = true;
fc.repaint();
if (fontModified) {
// / Tell main panel to update the font info
updateFontInfo();
f2dt.fireUpdateFontInfo();
}
}
public void setRenderingHints(Object aa, Object fm, Object contrast) {
antiAliasType = ((AAValues) aa).getHint();
fractionalMetricsType = ((FMValues) fm).getHint();
lcdContrast = contrast;
updateBackBuffer = true;
updateFontMetrics = true;
fc.repaint();
}
public void setDrawMethod(int i) {
drawMethod = i;
updateBackBuffer = true;
fc.repaint();
}
public void setTextToDraw(int i, int range[], String textSet[], String fileData[]) {
textToUse = i;
if (textToUse == RANGE_TEXT)
drawRange = range;
else if (textToUse == ALL_GLYPHS)
drawMethod = DRAW_GLYPHV;
else if (textToUse == USER_TEXT)
userText = textSet;
else if (textToUse == FILE_TEXT) {
fileText = fileData;
drawMethod = TL_DRAW;
}
updateBackBuffer = true;
updateFontMetrics = true;
fc.repaint();
updateFontInfo();
}
public void setGridDisplay(boolean b) {
showGrid = b;
updateBackBuffer = true;
fc.repaint();
}
public void setForce16Columns(boolean b) {
force16Cols = b;
updateBackBuffer = true;
updateFontMetrics = true;
fc.repaint();
}
// / Prints out the text display area
public void doPrint(int i) {
if (printer == null) {
printer = PrinterJob.getPrinterJob();
page = printer.defaultPage();
}
printMode = i;
printer.setPrintable(fc, page);
if (printer.printDialog()) {
try {
printer.print();
} catch (Exception e) {
f2dt.fireChangeStatus("ERROR: Printing Failed; See Stack Trace", true);
}
}
}
// / Displays the page setup dialog and updates PageFormat info
public void doPageSetup() {
if (printer == null) {
printer = PrinterJob.getPrinterJob();
page = printer.defaultPage();
}
page = printer.pageDialog(page);
}
// / Obtains the information about selected font
private void updateFontInfo() {
int numGlyphs = 0, numCharsInRange = drawRange[1] - drawRange[0] + 1;
fontInfos[0] = "Font Face Name: " + testFont.getFontName();
fontInfos[1] = "Glyphs in This Range: ";
if (textToUse == RANGE_TEXT) {
for (int i = drawRange[0]; i < drawRange[1]; i++)
if (testFont.canDisplay(i))
numGlyphs++;
fontInfos[1] = fontInfos[1] + numGlyphs + " / " + numCharsInRange;
} else
fontInfos[1] = null;
}
// / Accessor for the font information
public String[] getFontInfo() {
return fontInfos;
}
// / Collects the currectly set options and returns them as string
public String getCurrentOptions() {
// / Create a new String to store the options
// / The array will contain all 8 setting (font name, size...) and
// / character range or user text data used (no file text data)
int userTextSize = 0;
String options;
options = (fontName + "\n" + fontSize + "\n" + fontStyle + "\n" + fontTransform + "\n"
+ g2Transform + "\n" + textToUse + "\n" + drawMethod + "\n"
+ AAValues.getHintVal(antiAliasType) + "\n" + FMValues.getHintVal(fractionalMetricsType)
+ "\n" + lcdContrast + "\n");
if (textToUse == USER_TEXT)
for (int i = 0; i < userText.length; i++)
options += (userText[i] + "\n");
return options;
}
// / Reload all options and refreshes the canvas
public void loadOptions(boolean grid, boolean force16, int start, int end, String name,
float size, int style, int transform, int g2transform, int text, int method, int aa, int fm,
int contrast, String user[]) {
int range[] = { start, end };
// / Since repaint call has a low priority, these functions will finish
// / before the actual repainting is done
setGridDisplay(grid);
setForce16Columns(force16);
// previous call to readTextFile has already set the text to draw
if (textToUse != FILE_TEXT) {
setTextToDraw(text, range, user, null);
}
setFontParams(name, size, style, transform);
setTransformG2(g2transform); // ABP
setDrawMethod(method);
setRenderingHints(AAValues.getValue(aa), FMValues.getValue(fm), new Integer(contrast));
}
// / Writes the current screen to PNG file
public void doSavePNG(String fileName) {
fc.writePNG(fileName);
}
// / When scrolled using the scroll bar, update the backbuffer
public void adjustmentValueChanged(AdjustmentEvent e) {
updateBackBuffer = true;
fc.repaint();
}
public void paintComponent(Graphics g) {
// Windows does not repaint correctly, after
// a zoom. Thus, we need to force the canvas
// to repaint, but only once. After the first repaint,
// everything stabilizes. [ABP]
fc.repaint();
}
// / Inner class definition...
// / Inner panel that holds the actual drawing area and its routines
private class FontCanvas extends JPanel implements MouseListener, MouseMotionListener, Printable {
// / Number of characters that will fit across and down this canvas
private int numCharAcross, numCharDown;
// / First and last character/line that will be drawn
// / Limit is the end of range/text where no more draw will be done
private int drawStart, drawEnd, drawLimit;
// / FontMetrics variables
// / Here, gridWidth is equivalent to maxAdvance (slightly bigger though)
// / and gridHeight is equivalent to lineHeight
private int maxAscent, maxDescent, gridWidth = 0, gridHeight = 0;
// / Offset from the top left edge of the canvas where the draw will start
private int canvasInset_X = 5, canvasInset_Y = 5;
// / Offscreen buffer of this canvas
private BufferedImage backBuffer = null;
// / LineBreak"ed TextLayout vector
private Vector lineBreakTLs = null;
// / Whether the current draw command requested is for printing
private boolean isPrinting = false;
// / Other printing infos
private int lastPage, printPageNumber, currentlyShownChar = 0;
private final int PR_OFFSET = 10;
private final int PR_TITLE_LINEHEIGHT = 30;
// / Information about zooming (used with range text draw)
private final JWindow zoomWindow;
private BufferedImage zoomImage = null;
private int mouseOverCharX = -1, mouseOverCharY = -1;
private int currMouseOverChar = -1, prevZoomChar = -1;
private float ZOOM = 2.0f;
private boolean nowZooming = false;
private boolean firstTime = true;
// ABP
// / Status bar message backup
private String backupStatusString = null;
// / Error constants
private final String ERRORS[] = {
"ERROR: drawBytes cannot handle characters beyond 0x00FF. Select different range or draw methods.",
"ERROR: Cannot fit text with the current font size. Resize the window or use smaller font size.",
"ERROR: Cannot print with the current font size. Use smaller font size.", };
private final int DRAW_BYTES_ERROR = 0;
private final int CANT_FIT_DRAW = 1;
private final int CANT_FIT_PRINT = 2;
// / Other variables
private final Cursor blankCursor;
public FontCanvas() {
this.addMouseListener(this);
this.addMouseMotionListener(this);
this.setForeground(Color.black);
this.setBackground(Color.white);
// / Creates an invisble pointer by giving it bogus image
// / Possibly find a workaround for this...
Toolkit tk = Toolkit.getDefaultToolkit();
byte bogus[] = { (byte) 0 };
blankCursor = tk.createCustomCursor(tk.createImage(bogus), new Point(0, 0), "");
zoomWindow = new JWindow(parent) {
public void paint(Graphics g) {
g.drawImage(zoomImage, 0, 0, zoomWindow);
}
};
zoomWindow.setCursor(blankCursor);
zoomWindow.pack();
}
public boolean firstTime() {
return firstTime;
}
public void refresh() {
firstTime = false;
updateBackBuffer = true;
repaint();
}
// / Sets the font, hints, according to the set parameters
private void setParams(Graphics2D g2) {
g2.setFont(testFont);
g2.setRenderingHint(KEY_TEXT_ANTIALIASING, antiAliasType);
g2.setRenderingHint(KEY_FRACTIONALMETRICS, fractionalMetricsType);
g2.setRenderingHint(KEY_TEXT_LCD_CONTRAST, lcdContrast);
/*
* I am preserving a somewhat dubious behaviour of this program. Outline
* text would be drawn anti-aliased by setting the graphics anti-aliasing
* hint if the text anti-aliasing hint was set. The dubious element here
* is that people simply using this program may think this is built-in
* behaviour but its not - at least not when the app explictly draws
* outline text. This becomes more dubious in cases such as "GASP" where
* the size at which text is AA"ed is not something you can easily
* calculate, so mimicing that behaviour isn"t going to be easy. So I
* precisely preserve the behaviour : this is done only if the AA value is
* "ON". Its not applied in the other cases.
*/
if (antiAliasType == VALUE_TEXT_ANTIALIAS_ON
&& (drawMethod == TL_OUTLINE || drawMethod == GV_OUTLINE)) {
g2.setRenderingHint(KEY_ANTIALIASING, VALUE_ANTIALIAS_ON);
} else {
g2.setRenderingHint(KEY_ANTIALIASING, VALUE_ANTIALIAS_OFF);
}
}
// / Draws the grid (Used for unicode/glyph range drawing)
private void drawGrid(Graphics2D g2) {
int totalGridWidth = numCharAcross * gridWidth;
int totalGridHeight = numCharDown * gridHeight;
g2.setColor(Color.black);
for (int i = 0; i < numCharDown + 1; i++)
g2.drawLine(canvasInset_X, i * gridHeight + canvasInset_Y, canvasInset_X + totalGridWidth,
i * gridHeight + canvasInset_Y);
for (int i = 0; i < numCharAcross + 1; i++)
g2.drawLine(i * gridWidth + canvasInset_X, canvasInset_Y, i * gridWidth + canvasInset_X,
canvasInset_Y + totalGridHeight);
}
// / Draws one character at time onto the canvas according to
// / the method requested (Used for RANGE_TEXT and ALL_GLYPHS)
public void modeSpecificDrawChar(Graphics2D g2, int charCode, int baseX, int baseY) {
GlyphVector gv;
int oneGlyph[] = { charCode };
char charArray[] = Character.toChars(charCode);
FontRenderContext frc = g2.getFontRenderContext();
AffineTransform oldTX = g2.getTransform();
// / Create GlyphVector to measure the exact visual advance
// / Using that number, adjust the position of the character drawn
if (textToUse == ALL_GLYPHS)
gv = testFont.createGlyphVector(frc, oneGlyph);
else
gv = testFont.createGlyphVector(frc, charArray);
Rectangle2D r2d2 = gv.getPixelBounds(frc, 0, 0);
int shiftedX = baseX;
// getPixelBounds returns a result in device space.
// we need to convert back to user space to be able to
// calculate the shift as baseX is in user space.
try {
double pt[] = new double[4];
pt[0] = r2d2.getX();
pt[1] = r2d2.getY();
pt[2] = r2d2.getX() + r2d2.getWidth();
pt[3] = r2d2.getY() + r2d2.getHeight();
oldTX.inverseTransform(pt, 0, pt, 0, 2);
shiftedX = baseX - (int) (pt[2] / 2 + pt[0]);
} catch (NoninvertibleTransformException e) {
}
// / ABP - keep track of old tform, restore it later
g2.translate(shiftedX, baseY);
g2.transform(getAffineTransform(g2Transform));
if (textToUse == ALL_GLYPHS)
g2.drawGlyphVector(gv, 0f, 0f);
else {
if (testFont.canDisplay(charCode))
g2.setColor(Color.black);
else {
g2.setColor(Color.lightGray);
}
switch (drawMethod) {
case DRAW_STRING:
g2.drawString(new String(charArray), 0, 0);
break;
case DRAW_CHARS:
g2.drawChars(charArray, 0, 1, 0, 0);
break;
case DRAW_BYTES:
if (charCode > 0xff)
throw new CannotDrawException(DRAW_BYTES_ERROR);
byte oneByte[] = { (byte) charCode };
g2.drawBytes(oneByte, 0, 1, 0, 0);
break;
case DRAW_GLYPHV:
g2.drawGlyphVector(gv, 0f, 0f);
break;
case TL_DRAW:
TextLayout tl = new TextLayout(new String(charArray), testFont, frc);
tl.draw(g2, 0f, 0f);
break;
case GV_OUTLINE:
r2d2 = gv.getVisualBounds();
shiftedX = baseX - (int) (r2d2.getWidth() / 2 + r2d2.getX());
g2.draw(gv.getOutline(0f, 0f));
break;
case TL_OUTLINE:
r2d2 = gv.getVisualBounds();
shiftedX = baseX - (int) (r2d2.getWidth() / 2 + r2d2.getX());
TextLayout tlo = new TextLayout(new String(charArray), testFont, g2
.getFontRenderContext());
g2.draw(tlo.getOutline(null));
}
}
// / ABP - restore old tform
g2.setTransform(oldTX);
}
// Java2D!\\U01d586\\U01d587\\U01d588
// / Draws one line of text at given position
private void modeSpecificDrawLine(Graphics2D g2, String line, int baseX, int baseY) {
// / ABP - keep track of old tform, restore it later
AffineTransform oldTx = null;
oldTx = g2.getTransform();
g2.translate(baseX, baseY);
g2.transform(getAffineTransform(g2Transform));
switch (drawMethod) {
case DRAW_STRING:
g2.drawString(line, 0, 0);
break;
case DRAW_CHARS:
g2.drawChars(line.toCharArray(), 0, line.length(), 0, 0);
break;
case DRAW_BYTES:
try {
byte lineBytes[] = line.getBytes("ISO-8859-1");
g2.drawBytes(lineBytes, 0, lineBytes.length, 0, 0);
} catch (Exception e) {
e.printStackTrace();
}
break;
case DRAW_GLYPHV:
GlyphVector gv = testFont.createGlyphVector(g2.getFontRenderContext(), line);
g2.drawGlyphVector(gv, (float) 0, (float) 0);
break;
case TL_DRAW:
TextLayout tl = new TextLayout(line, testFont, g2.getFontRenderContext());
tl.draw(g2, (float) 0, (float) 0);
break;
case GV_OUTLINE:
GlyphVector gvo = testFont.createGlyphVector(g2.getFontRenderContext(), line);
g2.draw(gvo.getOutline((float) 0, (float) 0));
break;
case TL_OUTLINE:
TextLayout tlo = new TextLayout(line, testFont, g2.getFontRenderContext());
AffineTransform at = new AffineTransform();
g2.draw(tlo.getOutline(at));
}
// / ABP - restore old tform
g2.setTransform(oldTx);
}
// / Draws one line of text at given position
private void tlDrawLine(Graphics2D g2, TextLayout tl, float baseX, float baseY) {
// / ABP - keep track of old tform, restore it later
AffineTransform oldTx = null;
oldTx = g2.getTransform();
g2.translate(baseX, baseY);
g2.transform(getAffineTransform(g2Transform));
tl.draw(g2, (float) 0, (float) 0);
// / ABP - restore old tform
g2.setTransform(oldTx);
}
// / If textToUse is set to range drawing, then convert
// / int to hex string and prepends 0s to make it length 4
// / Otherwise line number was fed; simply return number + 1 converted to
// String
// / (This is because first line is 1, not 0)
private String modeSpecificNumStr(int i) {
if (textToUse == USER_TEXT || textToUse == FILE_TEXT)
return String.valueOf(i + 1);
StringBuffer s = new StringBuffer(Integer.toHexString(i));
while (s.length() < 4)
s.insert(0, "0");
return s.toString().toUpperCase();
}
// / Resets the scrollbar to display correct range of text currently on
// screen
// / (This scrollbar is not part of a "ScrollPane". It merely simulates its
// effect by
// / indicating the necessary area to be drawn within the panel.
// / By doing this, it prevents creating gigantic panel when large text
// range,
// / i.e. CJK Ideographs, is requested)
private void resetScrollbar(int oldValue) {
int totalNumRows = 1, numCharToDisplay;
if (textToUse == RANGE_TEXT || textToUse == ALL_GLYPHS) {
if (textToUse == RANGE_TEXT)
numCharToDisplay = drawRange[1] - drawRange[0];
else
// / textToUse == ALL_GLYPHS
numCharToDisplay = testFont.getNumGlyphs();
totalNumRows = numCharToDisplay / numCharAcross;
if (numCharToDisplay % numCharAcross != 0)
totalNumRows++;
if (oldValue / numCharAcross > totalNumRows)
oldValue = 0;
verticalBar.setValues(oldValue / numCharAcross, numCharDown, 0, totalNumRows);
} else {
if (textToUse == USER_TEXT)
totalNumRows = userText.length;
else
// / textToUse == FILE_TEXT;
totalNumRows = lineBreakTLs.size();
verticalBar.setValues(oldValue, numCharDown, 0, totalNumRows);
}
if (totalNumRows <= numCharDown && drawStart == 0) {
verticalBar.setEnabled(false);
} else {
verticalBar.setEnabled(true);
}
}
// / Calculates the font"s metrics that will be used for draw
private void calcFontMetrics(Graphics2D g2d, int w, int h) {
FontMetrics fm;
Graphics2D g2 = (Graphics2D) g2d.create();
// / ABP
if (g2Transform != NONE && textToUse != FILE_TEXT) {
g2.setFont(g2.getFont().deriveFont(getAffineTransform(g2Transform)));
fm = g2.getFontMetrics();
} else {
fm = g2.getFontMetrics();
}
maxAscent = fm.getMaxAscent();
maxDescent = fm.getMaxDescent();
if (maxAscent == 0)
maxAscent = 10;
if (maxDescent == 0)
maxDescent = 5;
if (textToUse == RANGE_TEXT || textToUse == ALL_GLYPHS) {
// / Give slight extra room for each character
maxAscent += 3;
maxDescent += 3;
gridWidth = fm.getMaxAdvance() + 6;
gridHeight = maxAscent + maxDescent;
if (force16Cols)
numCharAcross = 16;
else
numCharAcross = (w - 10) / gridWidth;
numCharDown = (h - 10) / gridHeight;
canvasInset_X = (w - numCharAcross * gridWidth) / 2;
canvasInset_Y = (h - numCharDown * gridHeight) / 2;
if (numCharDown == 0 || numCharAcross == 0)
throw new CannotDrawException(isPrinting ? CANT_FIT_PRINT : CANT_FIT_DRAW);
if (!isPrinting)
resetScrollbar(verticalBar.getValue() * numCharAcross);
} else {
maxDescent += fm.getLeading();
canvasInset_X = 5;
canvasInset_Y = 5;
// / gridWidth and numCharAcross will not be used in this mode...
gridHeight = maxAscent + maxDescent;
numCharDown = (h - canvasInset_Y * 2) / gridHeight;
if (numCharDown == 0)
throw new CannotDrawException(isPrinting ? CANT_FIT_PRINT : CANT_FIT_DRAW);
// / If this is text loaded from file, prepares the LineBreak"ed
// / text layout at this point
if (textToUse == FILE_TEXT) {
if (!isPrinting)
f2dt.fireChangeStatus("LineBreaking Text... Please Wait", false);
lineBreakTLs = new Vector();
for (int i = 0; i < fileText.length; i++) {
AttributedString as = new AttributedString(fileText[i], g2.getFont().getAttributes());
LineBreakMeasurer lbm = new LineBreakMeasurer(as.getIterator(), g2
.getFontRenderContext());
while (lbm.getPosition() < fileText[i].length())
lineBreakTLs.add(lbm.nextLayout((float) w));
}
}
if (!isPrinting)
resetScrollbar(verticalBar.getValue());
}
}
// / Calculates the amount of text that will be displayed on screen
private void calcTextRange() {
String displaying = null;
if (textToUse == RANGE_TEXT || textToUse == ALL_GLYPHS) {
if (isPrinting)
if (printMode == ONE_PAGE)
drawStart = currentlyShownChar;
else
// / printMode == CUR_RANGE
drawStart = numCharAcross * numCharDown * printPageNumber;
else
drawStart = verticalBar.getValue() * numCharAcross;
if (textToUse == RANGE_TEXT) {
drawStart += drawRange[0];
drawLimit = drawRange[1];
} else
drawLimit = testFont.getNumGlyphs();
drawEnd = drawStart + numCharAcross * numCharDown - 1;
if (drawEnd >= drawLimit)
drawEnd = drawLimit;
} else {
if (isPrinting)
if (printMode == ONE_PAGE)
drawStart = currentlyShownChar;
else
// / printMode == ALL_TEXT
drawStart = numCharDown * printPageNumber;
else {
drawStart = verticalBar.getValue();
}
drawEnd = drawStart + numCharDown - 1;
if (textToUse == USER_TEXT)
drawLimit = userText.length - 1;
else
drawLimit = lineBreakTLs.size() - 1;
if (drawEnd >= drawLimit)
drawEnd = drawLimit;
}
// ABP
if (drawStart > drawEnd) {
drawStart = 0;
verticalBar.setValue(drawStart);
}
// / Change the status bar if not printing...
if (!isPrinting) {
backupStatusString = ("Displaying" + MS_OPENING[textToUse] + modeSpecificNumStr(drawStart)
+ " to " + modeSpecificNumStr(drawEnd) + MS_CLOSING[textToUse]);
f2dt.fireChangeStatus(backupStatusString, false);
}
}
// / Draws text according to the parameters set by Font2DTest GUI
private void drawText(Graphics g, int w, int h) {
Graphics2D g2;
// / Create back buffer when not printing, and its Graphics2D
// / Then set drawing parameters for that Graphics2D object
if (isPrinting)
g2 = (Graphics2D) g;
else {
backBuffer = (BufferedImage) this.createImage(w, h);
g2 = backBuffer.createGraphics();
g2.setColor(Color.white);
g2.fillRect(0, 0, w, h);
g2.setColor(Color.black);
}
// / sets font, RenderingHints.
setParams(g2);
// / If flag is set, recalculate fontMetrics and reset the scrollbar
if (updateFontMetrics || isPrinting) {
// / NOTE: re-calculates in case G2 transform
// / is something other than NONE
calcFontMetrics(g2, w, h);
updateFontMetrics = false;
}
// / Calculate the amount of text that can be drawn...
calcTextRange();
// / Draw according to the set "Text to Use" mode
if (textToUse == RANGE_TEXT || textToUse == ALL_GLYPHS) {
int charToDraw = drawStart;
if (showGrid)
drawGrid(g2);
if (!isPrinting)
g.drawImage(backBuffer, 0, 0, this);
for (int i = 0; i < numCharDown && charToDraw <= drawEnd; i++) {
for (int j = 0; j < numCharAcross && charToDraw <= drawEnd; j++, charToDraw++) {
int gridLocX = j * gridWidth + canvasInset_X;
int gridLocY = i * gridHeight + canvasInset_Y;
modeSpecificDrawChar(g2, charToDraw, gridLocX + gridWidth / 2, gridLocY + maxAscent);
// if ( !isPrinting ) {
// g.setClip( gridLocX, gridLocY, gridWidth + 1, gridHeight + 1 );
// g.drawImage( backBuffer, 0, 0, this );
// }
}
}
} else if (textToUse == USER_TEXT) {
g2.drawRect(0, 0, w - 1, h - 1);
if (!isPrinting)
g.drawImage(backBuffer, 0, 0, this);
for (int i = drawStart; i <= drawEnd; i++) {
int lineStartX = canvasInset_Y;
int lineStartY = (i - drawStart) * gridHeight + maxAscent;
modeSpecificDrawLine(g2, userText[i], lineStartX, lineStartY);
}
} else {
float xPos, yPos = (float) canvasInset_Y;
g2.drawRect(0, 0, w - 1, h - 1);
if (!isPrinting)
g.drawImage(backBuffer, 0, 0, this);
for (int i = drawStart; i <= drawEnd; i++) {
TextLayout oneLine = (TextLayout) lineBreakTLs.elementAt(i);
xPos = oneLine.isLeftToRight() ? canvasInset_X
: ((float) w - oneLine.getAdvance() - canvasInset_X);
float fmData[] = { 0, oneLine.getAscent(), 0, oneLine.getDescent(), 0,
oneLine.getLeading() };
if (g2Transform != NONE) {
AffineTransform at = getAffineTransform(g2Transform);
at.transform(fmData, 0, fmData, 0, 3);
}
// yPos += oneLine.getAscent();
yPos += fmData[1]; // ascent
// oneLine.draw( g2, xPos, yPos );
tlDrawLine(g2, oneLine, xPos, yPos);
// yPos += oneLine.getDescent() + oneLine.getLeading();
yPos += fmData[3] + fmData[5]; // descent + leading
}
}
if (!isPrinting)
g.drawImage(backBuffer, 0, 0, this);
g2.dispose();
}
// / Component paintComponent function...
// / Draws/Refreshes canvas according to flag(s) set by other functions
public void paintComponent(Graphics g) {
if (updateBackBuffer) {
Dimension d = this.getSize();
isPrinting = false;
try {
drawText(g, d.width, d.height);
} catch (CannotDrawException e) {
f2dt.fireChangeStatus(ERRORS[e.id], true);
super.paintComponent(g);
return;
}
} else {
// / Screen refresh
g.drawImage(backBuffer, 0, 0, this);
}
showingError = false;
updateBackBuffer = false;
}
// / Printable interface function
// / Component print function...
public int print(Graphics g, PageFormat pf, int pageIndex) {
if (pageIndex == 0) {
// / Reset the last page index to max...
lastPage = Integer.MAX_VALUE;
currentlyShownChar = verticalBar.getValue() * numCharAcross;
}
if (printMode == ONE_PAGE) {
if (pageIndex > 0)
return NO_SUCH_PAGE;
} else {
if (pageIndex > lastPage)
return NO_SUCH_PAGE;
}
int pageWidth = (int) pf.getImageableWidth();
int pageHeight = (int) pf.getImageableHeight();
// / Back up metrics and other drawing info before printing modifies it
int backupDrawStart = drawStart, backupDrawEnd = drawEnd;
int backupNumCharAcross = numCharAcross, backupNumCharDown = numCharDown;
Vector backupLineBreakTLs = null;
if (textToUse == FILE_TEXT)
backupLineBreakTLs = (Vector) lineBreakTLs.clone();
printPageNumber = pageIndex;
isPrinting = true;
// / Push the actual draw area 60 down to allow info to be printed
g.translate((int) pf.getImageableX(), (int) pf.getImageableY() + 60);
try {
drawText(g, pageWidth, pageHeight - 60);
} catch (CannotDrawException e) {
f2dt.fireChangeStatus(ERRORS[e.id], true);
return NO_SUCH_PAGE;
}
// / Draw information about what is being printed
String hints = (" with antialias " + antiAliasType + "and" + " fractional metrics "
+ fractionalMetricsType + " and lcd contrast = " + lcdContrast);
String infoLine1 = ("Printing" + MS_OPENING[textToUse] + modeSpecificNumStr(drawStart)
+ " to " + modeSpecificNumStr(drawEnd) + MS_CLOSING[textToUse]);
String infoLine2 = ("With " + fontName + " " + STYLES[fontStyle] + " at " + fontSize
+ " point size " + TRANSFORMS[fontTransform]);
String infoLine3 = "Using " + METHODS[drawMethod] + hints;
String infoLine4 = "Page: " + (pageIndex + 1);
g.setFont(new Font("dialog", Font.PLAIN, 12));
g.setColor(Color.black);
g.translate(0, -60);
g.drawString(infoLine1, 15, 10);
g.drawString(infoLine2, 15, 22);
g.drawString(infoLine3, 15, 34);
g.drawString(infoLine4, 15, 46);
if (drawEnd == drawLimit)
// / This indicates that the draw will be completed with this page
lastPage = pageIndex;
// / Restore the changed values back...
// / This is important for JScrollBar settings and LineBreak"ed TLs
drawStart = backupDrawStart;
drawEnd = backupDrawEnd;
numCharAcross = backupNumCharAcross;
numCharDown = backupNumCharDown;
if (textToUse == FILE_TEXT)
lineBreakTLs = backupLineBreakTLs;
return PAGE_EXISTS;
}
// / Ouputs the current canvas into a given PNG file
public void writePNG(String fileName) {
try {
ImageIO.write(backBuffer, "png", new java.io.File(fileName));
} catch (Exception e) {
f2dt.fireChangeStatus("ERROR: Failed to Save PNG image; See stack trace", true);
e.printStackTrace();
}
}
// / Figures out whether a character at the pointer location is valid
// / And if so, updates mouse location informations, as well as
// / the information on the status bar
private boolean checkMouseLoc(MouseEvent e) {
if (gridWidth != 0 && gridHeight != 0)
if (textToUse == RANGE_TEXT || textToUse == ALL_GLYPHS) {
int charLocX = (e.getX() - canvasInset_X) / gridWidth;
int charLocY = (e.getY() - canvasInset_Y) / gridHeight;
// / Check to make sure the mouse click location is within drawn area
if (charLocX >= 0 && charLocY >= 0 && charLocX < numCharAcross && charLocY < numCharDown) {
int mouseOverChar = charLocX + (verticalBar.getValue() + charLocY) * numCharAcross;
if (textToUse == RANGE_TEXT)
mouseOverChar += drawRange[0];
if (mouseOverChar > drawEnd)
return false;
mouseOverCharX = charLocX;
mouseOverCharY = charLocY;
currMouseOverChar = mouseOverChar;
// / Update status bar
f2dt.fireChangeStatus("Pointing to" + MS_OPENING[textToUse]
+ modeSpecificNumStr(mouseOverChar), false);
return true;
}
}
return false;
}
// / Shows (updates) the character zoom window
public void showZoomed() {
GlyphVector gv;
Font backup = testFont;
Point canvasLoc = this.getLocationOnScreen();
// / Calculate the zoom area"s location and size...
int dialogOffsetX = (int) (gridWidth * (ZOOM - 1) / 2);
int dialogOffsetY = (int) (gridHeight * (ZOOM - 1) / 2);
int zoomAreaX = mouseOverCharX * gridWidth + canvasInset_X - dialogOffsetX;
int zoomAreaY = mouseOverCharY * gridHeight + canvasInset_Y - dialogOffsetY;
int zoomAreaWidth = (int) (gridWidth * ZOOM);
int zoomAreaHeight = (int) (gridHeight * ZOOM);
// / Position and set size of zoom window as needed
zoomWindow.setLocation(canvasLoc.x + zoomAreaX, canvasLoc.y + zoomAreaY);
if (!nowZooming) {
if (zoomWindow.getWarningString() != null)
// / If this is not opened as a "secure" window,
// / it has a banner below the zoom dialog which makes it look really
// BAD
// / So enlarge it by a bit
zoomWindow.setSize(zoomAreaWidth + 1, zoomAreaHeight + 20);
else
zoomWindow.setSize(zoomAreaWidth + 1, zoomAreaHeight + 1);
}
// / Prepare zoomed image
zoomImage = (BufferedImage) zoomWindow.createImage(zoomAreaWidth + 1, zoomAreaHeight + 1);
Graphics2D g2 = (Graphics2D) zoomImage.getGraphics();
testFont = testFont.deriveFont(fontSize * ZOOM);
setParams(g2);
g2.setColor(Color.white);
g2.fillRect(0, 0, zoomAreaWidth, zoomAreaHeight);
g2.setColor(Color.black);
g2.drawRect(0, 0, zoomAreaWidth, zoomAreaHeight);
modeSpecificDrawChar(g2, currMouseOverChar, zoomAreaWidth / 2, (int) (maxAscent * ZOOM));
g2.dispose();
if (!nowZooming)
zoomWindow.show();
// / This is sort of redundant... since there is a paint function
// / inside zoomWindow definition that does the drawImage.
// / (I should be able to call just repaint() here)
// / However, for some reason, that paint function fails to respond
// / from second time and on; So I have to force the paint here...
zoomWindow.getGraphics().drawImage(zoomImage, 0, 0, this);
nowZooming = true;
prevZoomChar = currMouseOverChar;
testFont = backup;
// Windows does not repaint correctly, after
// a zoom. Thus, we need to force the canvas
// to repaint, but only once. After the first repaint,
// everything stabilizes. [ABP]
if (firstTime()) {
refresh();
}
}
// / Listener Functions
// / MouseListener interface function
// / Zooms a character when mouse is pressed above it
public void mousePressed(MouseEvent e) {
if (!showingError) {
if (checkMouseLoc(e)) {
showZoomed();
this.setCursor(blankCursor);
}
}
}
// / MouseListener interface function
// / Redraws the area that was drawn over by zoomed character
public void mouseReleased(MouseEvent e) {
if (textToUse == RANGE_TEXT || textToUse == ALL_GLYPHS) {
if (nowZooming)
zoomWindow.hide();
nowZooming = false;
}
this.setCursor(Cursor.getDefaultCursor());
}
// / MouseListener interface function
// / Resets the status bar to display range instead of a specific character
public void mouseExited(MouseEvent e) {
if (!showingError && !nowZooming)
f2dt.fireChangeStatus(backupStatusString, false);
}
// / MouseMotionListener interface function
// / Adjusts the status bar message when mouse moves over a character
public void mouseMoved(MouseEvent e) {
if (!showingError) {
if (!checkMouseLoc(e))
f2dt.fireChangeStatus(backupStatusString, false);
}
}
// / MouseMotionListener interface function
// / Scrolls the zoomed character when mouse is dragged
public void mouseDragged(MouseEvent e) {
if (!showingError)
if (nowZooming) {
if (checkMouseLoc(e) && currMouseOverChar != prevZoomChar)
showZoomed();
}
}
// / Empty function to comply with interface requirement
public void mouseClicked(MouseEvent e) {
}
public void mouseEntered(MouseEvent e) {
}
}
private final class CannotDrawException extends RuntimeException {
// / Error ID
public final int id;
public CannotDrawException(int i) {
id = i;
}
}
enum FMValues {
FMDEFAULT("DEFAULT", VALUE_FRACTIONALMETRICS_DEFAULT), FMOFF("OFF", VALUE_FRACTIONALMETRICS_OFF), FMON(
"ON", VALUE_FRACTIONALMETRICS_ON);
private String name;
private Object hint;
private static FMValues[] valArray;
FMValues(String s, Object o) {
name = s;
hint = o;
}
public String toString() {
return name;
}
public Object getHint() {
return hint;
}
public static Object getValue(int ordinal) {
if (valArray == null) {
valArray = (FMValues[]) EnumSet.allOf(FMValues.class).toArray(new FMValues[0]);
}
for (int i = 0; i < valArray.length; i++) {
if (valArray[i].ordinal() == ordinal) {
return valArray[i];
}
}
return valArray[0];
}
private static FMValues[] getArray() {
if (valArray == null) {
valArray = (FMValues[]) EnumSet.allOf(FMValues.class).toArray(new FMValues[0]);
}
return valArray;
}
public static int getHintVal(Object hint) {
getArray();
for (int i = 0; i < valArray.length; i++) {
if (valArray[i].getHint() == hint) {
return i;
}
}
return 0;
}
}
enum AAValues {
AADEFAULT("DEFAULT", VALUE_TEXT_ANTIALIAS_DEFAULT), AAOFF("OFF", VALUE_TEXT_ANTIALIAS_OFF), AAON(
"ON", VALUE_TEXT_ANTIALIAS_ON), AAGASP("GASP", VALUE_TEXT_ANTIALIAS_GASP), AALCDHRGB(
"LCD_HRGB", VALUE_TEXT_ANTIALIAS_LCD_HRGB), AALCDHBGR("LCD_HBGR",
VALUE_TEXT_ANTIALIAS_LCD_HBGR), AALCDVRGB("LCD_VRGB", VALUE_TEXT_ANTIALIAS_LCD_VRGB), AALCDVBGR(
"LCD_VBGR", VALUE_TEXT_ANTIALIAS_LCD_VBGR);
private String name;
private Object hint;
private static AAValues[] valArray;
AAValues(String s, Object o) {
name = s;
hint = o;
}
public String toString() {
return name;
}
public Object getHint() {
return hint;
}
public static boolean isLCDMode(Object o) {
return (o instanceof AAValues && ((AAValues) o).ordinal() >= AALCDHRGB.ordinal());
}
public static Object getValue(int ordinal) {
if (valArray == null) {
valArray = (AAValues[]) EnumSet.allOf(AAValues.class).toArray(new AAValues[0]);
}
for (int i = 0; i < valArray.length; i++) {
if (valArray[i].ordinal() == ordinal) {
return valArray[i];
}
}
return valArray[0];
}
private static AAValues[] getArray() {
if (valArray == null) {
Object[] oa = EnumSet.allOf(AAValues.class).toArray(new AAValues[0]);
valArray = (AAValues[]) (EnumSet.allOf(AAValues.class).toArray(new AAValues[0]));
}
return valArray;
}
public static int getHintVal(Object hint) {
getArray();
for (int i = 0; i < valArray.length; i++) {
if (valArray[i].getHint() == hint) {
return i;
}
}
return 0;
}
}
private static Integer defaultContrast;
static Integer getDefaultLCDContrast() {
if (defaultContrast == null) {
GraphicsConfiguration gc = GraphicsEnvironment.getLocalGraphicsEnvironment()
.getDefaultScreenDevice().getDefaultConfiguration();
Graphics2D g2d = (Graphics2D) (gc.createCompatibleImage(1, 1).getGraphics());
defaultContrast = (Integer) g2d.getRenderingHint(RenderingHints.KEY_TEXT_LCD_CONTRAST);
}
return defaultContrast;
}
}
/*
* @(#)RangeMenu.java 1.18 05/11/17
*
* Copyright (c) 2006 Sun Microsystems, Inc. All Rights Reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* -Redistribution of source code must retain the above copyright notice, this
* list of conditions and the following disclaimer.
*
* -Redistribution in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* Neither the name of Sun Microsystems, Inc. or the names of contributors may
* be used to endorse or promote products derived from this software without
* specific prior written permission.
*
* This software is provided "AS IS," without a warranty of any kind. ALL
* EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY
* IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR
* NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN MIDROSYSTEMS, INC. ("SUN") AND ITS
* LICENSORS SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A
* RESULT OF USING, MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES.
* IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT
* OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR
* PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY,
* ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE, EVEN IF SUN HAS
* BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
*
* You acknowledge that this software is not designed, licensed or intended for
* use in the design, construction, operation or maintenance of any nuclear
* facility.
*/
/*
* @(#)RangeMenu.java 1.18 05/11/17
*/
/**
* RangeMenu.java
*
* @version
* @(#)RangeMenu.java 1.1 00/08/22
* @author Shinsuke Fukuda
* @author Ankit Patel [Conversion to Swing - 01/07/30]
*/
// / Custom made choice menu that holds data for unicode range
final class RangeMenu extends JComboBox implements ActionListener {
// / Painfully extracted from java.lang.Character.UnicodeBlock. Arrrgh!
// / Unicode 3.0 data.
private final int[][] UNICODE_RANGES = { { 0x000000, 0x00007f }, // /
// BASIC_LATIN
{ 0x000080, 0x0000ff }, // / LATIN_1_SUPPLEMENT
{ 0x000100, 0x00017f }, // / LATIN_EXTENDED_A
{ 0x000180, 0x00024f }, // / LATIN_EXTENDED_B
{ 0x000250, 0x0002af }, // / IPA_EXTENSIONS
{ 0x0002b0, 0x0002ff }, // / SPACING_MODIFIER_LETTERS
{ 0x000300, 0x00036f }, // / COMBINING_DIACRITICAL_MARKS
{ 0x000370, 0x0003ff }, // / GREEK
{ 0x000400, 0x0004ff }, // / CYRILLIC
{ 0x000500, 0x00052f }, // / CYRILLIC_SUPPLEMENTARY
{ 0x000530, 0x00058f }, // / ARMENIAN
{ 0x000590, 0x0005ff }, // / HEBREW
{ 0x000600, 0x0006ff }, // / ARABIC
{ 0x000700, 0x00074f }, // / SYRIAC
{ 0x000780, 0x0007bf }, // / THAANA
{ 0x000900, 0x00097f }, // / DEVANAGARI
{ 0x000980, 0x0009ff }, // / BENGALI
{ 0x000a00, 0x000a7f }, // / GURMUKHI
{ 0x000a80, 0x000aff }, // / GUJARATI
{ 0x000b00, 0x000b7f }, // / ORIYA
{ 0x000b80, 0x000bff }, // / TAMIL
{ 0x000c00, 0x000c7f }, // / TELUGU
{ 0x000c80, 0x000cff }, // / KANNADA
{ 0x000d00, 0x000d7f }, // / MALAYALAM
{ 0x000d80, 0x000dff }, // / SINHALA
{ 0x000e00, 0x000e7f }, // / THAI
{ 0x000e80, 0x000eff }, // / LAO
{ 0x000f00, 0x000fff }, // / TIBETAN
{ 0x001000, 0x00109f }, // / MYANMAR
{ 0x0010a0, 0x0010ff }, // / GEORGIAN
{ 0x001100, 0x0011ff }, // / HANGUL_JAMO
{ 0x001200, 0x00137f }, // / ETHIOPIC
{ 0x0013a0, 0x0013ff }, // / CHEROKEE
{ 0x001400, 0x00167f }, // / UNIFIED_CANADIAN_ABORIGINAL_SYLLABICS
{ 0x001680, 0x00169f }, // / OGHAM
{ 0x0016a0, 0x0016ff }, // / RUNIC
{ 0x001700, 0x00171f }, // / TAGALOG
{ 0x001720, 0x00173f }, // / HANUNOO
{ 0x001740, 0x00175f }, // / BUHID
{ 0x001760, 0x00177f }, // / TAGBANWA
{ 0x001780, 0x0017ff }, // / KHMER
{ 0x001800, 0x0018af }, // / MONGOLIAN
{ 0x001900, 0x00194f }, // / LIMBU
{ 0x001950, 0x00197f }, // / TAI_LE
{ 0x0019e0, 0x0019ff }, // / KHMER_SYMBOLS
{ 0x001d00, 0x001d7f }, // / PHONETIC_EXTENSIONS
{ 0x001e00, 0x001eff }, // / LATIN_EXTENDED_ADDITIONAL
{ 0x001f00, 0x001fff }, // / GREEK_EXTENDED
{ 0x002000, 0x00206f }, // / GENERAL_PUNCTUATION
{ 0x002070, 0x00209f }, // / SUPERSCRIPTS_AND_SUBSCRIPTS
{ 0x0020a0, 0x0020cf }, // / CURRENCY_SYMBOLS
{ 0x0020d0, 0x0020ff }, // / COMBINING_MARKS_FOR_SYMBOLS
{ 0x002100, 0x00214f }, // / LETTERLIKE_SYMBOLS
{ 0x002150, 0x00218f }, // / NUMBER_FORMS
{ 0x002190, 0x0021ff }, // / ARROWS
{ 0x002200, 0x0022ff }, // / MATHEMATICAL_OPERATORS
{ 0x002300, 0x0023ff }, // / MISCELLANEOUS_TECHNICAL
{ 0x002400, 0x00243f }, // / CONTROL_PICTURES
{ 0x002440, 0x00245f }, // / OPTICAL_CHARACTER_RECOGNITION
{ 0x002460, 0x0024ff }, // / ENCLOSED_ALPHANUMERICS
{ 0x002500, 0x00257f }, // / BOX_DRAWING
{ 0x002580, 0x00259f }, // / BLOCK_ELEMENTS
{ 0x0025a0, 0x0025ff }, // / GEOMETRIC_SHAPES
{ 0x002600, 0x0026ff }, // / MISCELLANEOUS_SYMBOLS
{ 0x002700, 0x0027bf }, // / DINGBATS
{ 0x0027c0, 0x0027ef }, // / MISCELLANEOUS_MATHEMATICAL_SYMBOLS_A
{ 0x0027f0, 0x0027ff }, // / SUPPLEMENTAL_ARROWS_A
{ 0x002800, 0x0028ff }, // / BRAILLE_PATTERNS
{ 0x002900, 0x00297f }, // / SUPPLEMENTAL_ARROWS_B
{ 0x002980, 0x0029ff }, // / MISCELLANEOUS_MATHEMATICAL_SYMBOLS_B
{ 0x002a00, 0x002aff }, // / SUPPLEMENTAL_MATHEMATICAL_OPERATORS
{ 0x002b00, 0x002bff }, // / MISCELLANEOUS_SYMBOLS_AND_ARROWS
{ 0x002e80, 0x002eff }, // / CJK_RADICALS_SUPPLEMENT
{ 0x002f00, 0x002fdf }, // / KANGXI_RADICALS
{ 0x002ff0, 0x002fff }, // / IDEOGRAPHIC_DESCRIPTION_CHARACTERS
{ 0x003000, 0x00303f }, // / CJK_SYMBOLS_AND_PUNCTUATION
{ 0x003040, 0x00309f }, // / HIRAGANA
{ 0x0030a0, 0x0030ff }, // / KATAKANA
{ 0x003100, 0x00312f }, // / BOPOMOFO
{ 0x003130, 0x00318f }, // / HANGUL_COMPATIBILITY_JAMO
{ 0x003190, 0x00319f }, // / KANBUN
{ 0x0031a0, 0x0031bf }, // / BOPOMOFO_EXTENDED
{ 0x0031f0, 0x0031ff }, // / KATAKANA_PHONETIC_EXTENSIONS
{ 0x003200, 0x0032ff }, // / ENCLOSED_CJK_LETTERS_AND_MONTHS
{ 0x003300, 0x0033ff }, // / CJK_COMPATIBILITY
{ 0x003400, 0x004dbf }, // / CJK_UNIFIED_IDEOGRAPHS_EXTENSION_A
{ 0x004dc0, 0x004dff }, // / YIJING_HEXAGRAM_SYMBOLS
{ 0x004e00, 0x009fff }, // / CJK_UNIFIED_IDEOGRAPHS
{ 0x00a000, 0x00a48f }, // / YI_SYLLABLES
{ 0x00a490, 0x00a4cf }, // / YI_RADICALS
{ 0x00ac00, 0x00d7af }, // / HANGUL_SYLLABLES
{ 0x00d800, 0x00dfff }, // / SURROGATES_AREA
{ 0x00e000, 0x00f8ff }, // / PRIVATE_USE_AREA
{ 0x00f900, 0x00faff }, // / CJK_COMPATIBILITY_IDEOGRAPHS
{ 0x00fb00, 0x00fb4f }, // / ALPHABETIC_PRESENTATION_FORMS
{ 0x00fb50, 0x00fdff }, // / ARABIC_PRESENTATION_FORMS_A
{ 0x00fe00, 0x00fe0f }, // / VARIATION_SELECTORS
{ 0x00fe20, 0x00fe2f }, // / COMBINING_HALF_MARKS
{ 0x00fe30, 0x00fe4f }, // / CJK_COMPATIBILITY_FORMS
{ 0x00fe50, 0x00fe6f }, // / SMALL_FORM_VARIANTS
{ 0x00fe70, 0x00feff }, // / ARABIC_PRESENTATION_FORMS_B
{ 0x00ff00, 0x00ffef }, // / HALFWIDTH_AND_FULLWIDTH_FORMS
{ 0x00fff0, 0x00ffff }, // / SPECIALS
{ 0x010000, 0x01007f }, // / LINEAR_B_SYLLABARY
{ 0x010080, 0x0100ff }, // / LINEAR_B_IDEOGRAMS
{ 0x010100, 0x01013f }, // / AEGEAN_NUMBERS
{ 0x010300, 0x01032f }, // / OLD_ITALIC
{ 0x010330, 0x01034f }, // / GOTHIC
{ 0x010380, 0x01039f }, // / UGARITIC
{ 0x010400, 0x01044f }, // / DESERET
{ 0x010450, 0x01047f }, // / SHAVIAN
{ 0x010480, 0x0104af }, // / OSMANYA
{ 0x010800, 0x01083f }, // / CYPRIOT_SYLLABARY
{ 0x01d000, 0x01d0ff }, // / BYZANTINE_MUSICAL_SYMBOLS
{ 0x01d100, 0x01d1ff }, // / MUSICAL_SYMBOLS
{ 0x01d300, 0x01d35f }, // / TAI_XUAN_JING_SYMBOLS
{ 0x01d400, 0x01d7ff }, // / MATHEMATICAL_ALPHANUMERIC_SYMBOLS
{ 0x020000, 0x02a6df }, // / CJK_UNIFIED_IDEOGRAPHS_EXTENSION_B
{ 0x02f800, 0x02fa1f }, // / CJK_COMPATIBILITY_IDEOGRAPHS_SUPPLEMENT
{ 0x0e0000, 0x0e007f }, // / TAGS
{ 0x0e0100, 0x0e01ef }, // / VARIATION_SELECTORS_SUPPLEMENT
{ 0x0f0000, 0x0fffff }, // / SUPPLEMENTARY_PRIVATE_USE_AREA_A
{ 0x100000, 0x10ffff }, // / SUPPLEMENTARY_PRIVATE_USE_AREA_B
{ 0x000000, 0x00007f }, // / OTHER [USER DEFINED RANGE]
};
private final String[] UNICODE_RANGE_NAMES = { "Basic Latin", "Latin-1 Supplement",
"Latin Extended-A", "Latin Extended-B", "IPA Extensions", "Spacing Modifier Letters",
"Combining Diacritical Marks", "Greek", "Cyrillic", "Cyrillic Supplement", "Armenian",
"Hebrew", "Arabic", "Syriac", "Thaana", "Devanagari", "Bengali", "Gurmukhi", "Gujarati",
"Oriya", "Tamil", "Telugu", "Kannada", "Malayalam", "Sinhala", "Thai", "Lao", "Tibetan",
"Myanmar", "Georgian", "Hangul Jamo", "Ethiopic", "Cherokee",
"Unified Canadian Aboriginal Syllabics", "Ogham", "Runic", "Tagalog", "Hanunoo", "Buhid",
"Tagbanwa", "Khmer", "Mongolian", "Limbu", "Tai Le", "Khmer Symbols", "Phonetic Extensions",
"Latin Extended Additional", "Greek Extended", "General Punctuation",
"Superscripts and Subscripts", "Currency Symbols", "Combining Marks for Symbols",
"Letterlike Symbols", "Number Forms", "Arrows", "Mathematical Operators",
"Miscellaneous Technical", "Control Pictures", "Optical Character Recognition",
"Enclosed Alphanumerics", "Box Drawing", "Block Elements", "Geometric Shapes",
"Miscellaneous Symbols", "Dingbats", "Miscellaneous Mathematical Symbols-A",
"Supplemental Arrows-A", "Braille Patterns", "Supplemental Arrows-B",
"Miscellaneous Mathematical Symbols-B", "Supplemental Mathematical Operators",
"Miscellaneous Symbols and Arrows", "CJK Radicals Supplement", "Kangxi Radicals",
"Ideographic Description Characters", "CJK Symbols and Punctuation", "Hiragana", "Katakana",
"Bopomofo", "Hangul Compatibility Jamo", "Kanbun", "Bopomofo Extended",
"Katakana Phonetic Extensions", "Enclosed CJK Letters and Months", "CJK Compatibility",
"CJK Unified Ideographs Extension A", "Yijing Hexagram Symbols", "CJK Unified Ideographs",
"Yi Syllables", "Yi Radicals", "Hangul Syllables", "Surrogates Area", // High
// Surrogates,
// High
// Private
// Use
// Surrogates,
// Low
// Surrogates
"Private Use Area", "CJK Compatibility Ideographs", "Alphabetic Presentation Forms",
"Arabic Presentation Forms-A", "Variation Selectors", "Combining Half Marks",
"CJK Compatibility Forms", "Small Form Variants", "Arabic Presentation Forms-B",
"Halfwidth and Fullwidth Forms", "Specials", "Linear B Syllabary", "Linear B Ideograms",
"Aegean Numbers", "Old Italic", "Gothic", "Ugaritic", "Deseret", "Shavian", "Osmanya",
"Cypriot Syllabary", "Byzantine Musical Symbols", "Musical Symbols", "Tai Xuan Jing Symbols",
"Mathematical Alphanumeric Symbols", "CJK Unified Ideographs Extension B",
"CJK Compatibility Ideographs Supplement", "Tags", "Variation Selectors Supplement",
"Supplementary Private Use Area-A", "Supplementary Private Use Area-B", "Custom...", };
private boolean useCustomRange = false;
private int[] customRange = { 0x0000, 0x007f };
// / Custom range dialog variables
private final JDialog customRangeDialog;
private final JTextField customRangeStart = new JTextField("0000", 4);
private final JTextField customRangeEnd = new JTextField("007F", 4);
private final int CUSTOM_RANGE_INDEX = UNICODE_RANGE_NAMES.length - 1;
// / Parent Font2DTest Object holder
private final Font2DTest parent;
public static final int SURROGATES_AREA_INDEX = 91;
public RangeMenu(Font2DTest demo, JFrame f) {
super();
parent = demo;
for (int i = 0; i < UNICODE_RANGE_NAMES.length; i++)
addItem(UNICODE_RANGE_NAMES[i]);
setSelectedIndex(0);
addActionListener(this);
// / Set up custom range dialog...
customRangeDialog = new JDialog(f, "Custom Unicode Range", true);
customRangeDialog.setResizable(false);
JPanel dialogTop = new JPanel();
JPanel dialogBottom = new JPanel();
JButton okButton = new JButton("OK");
JLabel from = new JLabel("From:");
JLabel to = new JLabel("To:");
Font labelFont = new Font("dialog", Font.BOLD, 12);
from.setFont(labelFont);
to.setFont(labelFont);
okButton.setFont(labelFont);
dialogTop.add(from);
dialogTop.add(customRangeStart);
dialogTop.add(to);
dialogTop.add(customRangeEnd);
dialogBottom.add(okButton);
okButton.addActionListener(this);
customRangeDialog.getContentPane().setLayout(new BorderLayout());
customRangeDialog.getContentPane().add("North", dialogTop);
customRangeDialog.getContentPane().add("South", dialogBottom);
customRangeDialog.pack();
}
// / Return the range that is currently selected
public int[] getSelectedRange() {
if (useCustomRange) {
int startIndex, endIndex;
String startText, endText;
String empty = "";
try {
startText = customRangeStart.getText().trim();
endText = customRangeEnd.getText().trim();
if (startText.equals(empty) && !endText.equals(empty)) {
endIndex = Integer.parseInt(endText, 16);
startIndex = endIndex - 7 * 25;
} else if (!startText.equals(empty) && endText.equals(empty)) {
startIndex = Integer.parseInt(startText, 16);
endIndex = startIndex + 7 * 25;
} else {
startIndex = Integer.parseInt(customRangeStart.getText(), 16);
endIndex = Integer.parseInt(customRangeEnd.getText(), 16);
}
} catch (Exception e) {
// / Error in parsing the hex number ---
// / Reset the range to what it was before and return that
customRangeStart.setText(Integer.toString(customRange[0], 16));
customRangeEnd.setText(Integer.toString(customRange[1], 16));
return customRange;
}
if (startIndex < 0)
startIndex = 0;
if (endIndex > 0xffff)
endIndex = 0xffff;
if (startIndex > endIndex)
startIndex = endIndex;
customRange[0] = startIndex;
customRange[1] = endIndex;
return customRange;
} else
return UNICODE_RANGES[getSelectedIndex()];
}
// / Function used by loadOptions in Font2DTest main panel
// / to reset setting and range selection
public void setSelectedRange(String name, int start, int end) {
setSelectedItem(name);
customRange[0] = start;
customRange[1] = end;
parent.fireRangeChanged();
}
// / ActionListener interface function
// / ABP
// / moved JComboBox event code into this fcn from
// / itemStateChanged() method. Part of change to Swing.
public void actionPerformed(ActionEvent e) {
Object source = e.getSource();
if (source instanceof JComboBox) {
String rangeName = (String) ((JComboBox) source).getSelectedItem();
if (rangeName.equals("Custom...")) {
useCustomRange = true;
customRangeDialog.setLocationRelativeTo(parent);
customRangeDialog.show();
} else {
useCustomRange = false;
}
parent.fireRangeChanged();
} else if (source instanceof JButton) {
// / Since it is only "OK" button that sends any action here...
customRangeDialog.hide();
}
}
}

</source>

Java

2010-06-01T07:30:08Z

Admin: 1 версия

Java/Web Services SOA/AXIOM

2010-06-01T07:30:07Z

Admin: 1 версия

== We are deploying an AXIOM based POJO service after writing a services.xml and creating an aar ==



<source lang="java">

Axis2 Quick Start Guide - Sample 3 (AXIOM)
==========================================
This sample contains source code for the xdocs/1_1/quickstartguide.html document found in
the extracted Axis2 Documents Distribution. For a more detailed description on the
source code kindly see this "Axis2 Quick Start Guide" document.
Introduction
============
In this sample, we are deploying an AXIOM based POJO service after writing
a services.xml and creating an aar. We also test successful
deployment using an AXIOM based client.

Pre-Requisites
==============
Apache Ant 1.6.2 or later
Building the Service
====================
Type "ant generate.service" from AXIS2_HOME/samples/quickstartaxiom directory.
Then deploy the
AXIS2_HOME/samples/quickstartaxiom/build/StockQuoteService.aar

Running the Client
==================
Type ant run.client in the AXIS2_HOME/samples/quickstartaxiom directory
Help
====
Please contact axis-user list (axis-user@ws.apache.org) if you have
any trouble running the sample.

</source>

Java/Web Services SOA

2010-06-01T07:30:07Z

Admin: 1 версия

* [[Java/Web Services SOA/ADB | ADB]]
* [[Java/Web Services SOA/AXIOM | AXIOM]]
* [[Java/Web Services SOA/AXIS2 | AXIS2]]
* [[Java/Web Services SOA/Asynchronous Web Method | Asynchronous Web Method]]
* [[Java/Web Services SOA/CXF XFire | CXF XFire]]
* [[Java/Web Services SOA/CXF XFire Document Literal | CXF XFire Document Literal]]
* [[Java/Web Services SOA/Code First | Code First]]
* [[Java/Web Services SOA/HTTPS | HTTPS]]
* [[Java/Web Services SOA/JAX WS | JAX WS]]
* [[Java/Web Services SOA/JAX WS Attachment | JAX WS Attachment]]
* [[Java/Web Services SOA/JAX WS Document Literal | JAX WS Document Literal]]
* [[Java/Web Services SOA/JAX WS RPC | JAX WS RPC]]
* [[Java/Web Services SOA/JAX WS Tools | JAX WS Tools]]
* [[Java/Web Services SOA/JMS | JMS]]
* [[Java/Web Services SOA/JavaScript SOAP | JavaScript SOAP]]
* [[Java/Web Services SOA/JiBX | JiBX]]
* [[Java/Web Services SOA/MTOM | MTOM]]
* [[Java/Web Services SOA/POJO Web service | POJO Web service]]
* [[Java/Web Services SOA/REST | REST]]
* [[Java/Web Services SOA/RPC | RPC]]
* [[Java/Web Services SOA/SOAP | SOAP]]
* [[Java/Web Services SOA/Spring | Spring]]
* [[Java/Web Services SOA/WS Addressing | WS Addressing]]
* [[Java/Web Services SOA/WS Policy | WS Policy]]
* [[Java/Web Services SOA/WS ReliableMessaging | WS ReliableMessaging]]
* [[Java/Web Services SOA/WSDL | WSDL]]
* [[Java/Web Services SOA/XMLBEANS | XMLBEANS]]
* [[Java/Web Services SOA/eBay | eBay]]

Java/Web Services SOA/ADB

2010-06-01T07:27:49Z

Admin: 1 версия

== Deploying an ADB generated service ==



<source lang="java">

Axis2 Quick Start Guide- Sample 2 (ADB)
======================================
This sample contains source code for the xdocs/1_1/quickstartguide.html document found in
the extracted Axis2 Documents Distribution. For a more detailed description on the
source code kindly see this "Axis2 Quick Start Guide" document.
Introduction
============
In this sample, we are deploying an ADB generated service. The service
is tested using generated client stubs.
Pre-Requisites
==============
Apache Ant 1.6.2 or later
Building the Service
====================
Type "ant generate.service" from Axis2_HOME/samples/quickstartadb
directory and then deploy the
Axis2_HOME/samples/quickstartadb/build/service/build/lib/StockQuoteService.aar
Running the Client
==================
type ant run.client in the Axis2_HOME/samples/quickstartadb directory
Help
====
Please contact axis-user list (axis-user@ws.apache.org) if you
have any trouble running the sample.

</source>

Java/Web Services SOA/JAX WS

2010-06-01T07:27:49Z

Admin: 1 версия

== Create a simple Web Service ==



<source lang="java">

import java.text.SimpleDateFormat;
import java.util.Calendar;
import javax.jws.WebMethod;
import javax.jws.WebService;
@WebService()
public class Main {
@WebMethod
public String getTime() {
Calendar calendar = Calendar.getInstance();
SimpleDateFormat sdf = new SimpleDateFormat("HH:mm");
return (sdf.format(calendar.getTime()));
}
}

</source>



== Developing Web Services Using JAX-WS ==



<source lang="java">

import javax.jws.WebService;
import javax.jws.WebMethod;
@WebService(
name="Calculator",
serviceName="CalculatorService",
targetNamespace="http://techtip.ru/jaxws/sample"
)
public class Calculator {
public Calculator() {}

@WebMethod(operationName="add", action="urn:Add")
public int add(int i, int j) {
int k = i +j ;
System.out.println(i + "+" + j +" = " + k);
return k;
}
}

import javax.xml.ws.WebServiceRef;
public class JAXWSClient {
public static void main(String[] args) throws Exception {
@WebServiceRef(wsdlLocation = "http://localhost:8080/jaxws-webservice/CalculatorService?WSDL")
static CalculatorService service;
Calculator port = service.getCalculatorPort();
System.out.println(" Invoking add operation on the calculator port");
for (int i = 0; i > 10; i++) {
int ret = port.add(i, 10);
if (ret != (i + 10)) {
System.out.println("Unexpected greeting " + ret);
return;
}
System.out.println(" Adding : " + i + " + 10 = " + ret);
}
}
}

</source>



== JAX-WS Any URI ==

== JAX-WS: No data binding ==

== JAX-WS: Nodatabinding-JAXB-Integration ==

== JAX-WS: Polymorphic Processor ==

== JAX-WS: Polymorphic Processor With Validation ==

== JAX-WS: Raw Bytes Mtom ==

== JAX-WS: simpleclient ==

== JAX-WS: simpleclient basic authentication ==

== JAX-WS: simple client cert ==

== JAX-WS: Style Example ==

== Simple web service based on jaxws ==



<source lang="java">

/*
* Client.java
*
* Created on March 7, 2006, 11:31 PM
*/
package client;
import javax.xml.ws.WebServiceRef;
import endpoint.HelloService;
import endpoint.Hello;
public class Client
{
@WebServiceRef(wsdlLocation="http://localhost:8080/Hello/HelloService?WSDL")
static HelloService service;

public static void main(String[] args)
{
Client client = new Client();
client.doHello();
}

public void doHello()
{
try
{
Hello port = service.getHelloPort();
String ret = port.getHello(System.getProperty("user.name"));
System.out.println("Hello result = " + ret);
}
catch(Exception e)
{
e.printStackTrace();
}
}
}
/////////////////////////
package endpoint;
import javax.jws.WebService;
@WebService
public class Hello
{
public String getHello(String name)
{
return "Hello " + name + "!";
}
}

</source>



== XML Web Service WSDL ==

Java/Web Services SOA/eBay

2010-06-01T07:27:48Z

Admin: 1 версия

== JAX-WS: web services EBay Client Server ==



<source lang="java">

Copyright 2006 Sun Microsystems, Inc. ALL RIGHTS RESERVED Use of
this software is authorized pursuant to the terms of the license
found at http://developers.sun.ru/berkeley_license.html .
Copyright 1994-2005 Sun Microsystems, Inc. All Rights Reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:

* Redistribution of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
* Redistribution in binary form must reproduce the above
copyright notice, this list of conditions and the following
disclaimer in the documentation and/or other materials provided
with the distribution.
Neither the name of Sun Microsystems, Inc. or the names of
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.
This software is provided "AS IS," without a warranty of any kind.
ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES,
INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A
PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN
MICROSYSTEMS, INC. ("SUN") AND ITS LICENSORS SHALL NOT BE LIABLE FOR
ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR
DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES. IN NO EVENT WILL SUN
OR ITS LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR
FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE
DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY,
ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE, EVEN IF
SUN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

You acknowledge that this software is not designed, licensed or
intended for use in the design, construction, operation or
maintenance of any nuclear facility.
</source>

Java/Web Services SOA/WSDL

2010-06-01T07:27:48Z

Admin: 1 версия

== WSDL Helper ==



<source lang="java">

/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/

import java.io.File;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import javax.wsdl.Binding;
import javax.wsdl.BindingOperation;
import javax.wsdl.Definition;
import javax.wsdl.Input;
import javax.wsdl.Message;
import javax.wsdl.Operation;
import javax.wsdl.Output;
import javax.wsdl.Part;
import javax.wsdl.PortType;
import javax.wsdl.factory.WSDLFactory;
import javax.wsdl.xml.WSDLReader;
public class WSDLHelper {
public BindingOperation getBindingOperation(Definition def, String operationName) {
if (operationName == null) {
return null;
}
Iterator ite = def.getBindings().values().iterator();
while (ite.hasNext()) {
Binding binding = (Binding)ite.next();
Iterator ite1 = binding.getBindingOperations().iterator();
while (ite1.hasNext()) {
BindingOperation bop = (BindingOperation)ite1.next();
if (bop.getName().equals(operationName)) {
return bop;
}
}
}
return null;
}
public BindingOperation getBindingOperation(Binding binding, String operationName) {
if (operationName == null) {
return null;
}
List bindingOperations = binding.getBindingOperations();
for (Iterator iter = bindingOperations.iterator(); iter.hasNext();) {
BindingOperation bindingOperation = (BindingOperation)iter.next();
if (operationName.equals(bindingOperation.getName())) {
return bindingOperation;
}
}
return null;
}
public Map getParts(Operation operation, boolean out) {
Message message = null;
if (out) {
Output output = operation.getOutput();
message = output.getMessage();
} else {
Input input = operation.getInput();
message = input.getMessage();
}
return message.getParts() == null ? new HashMap() : message.getParts();
}
public List<PortType> getPortTypes(Definition def) {
List<PortType> portTypes = new ArrayList<PortType>();
Iterator ite = def.getPortTypes().values().iterator();
while (ite.hasNext()) {
PortType portType = (PortType)ite.next();
portTypes.add(portType);
}
return portTypes;
}
public List<Part> getInMessageParts(Operation operation) {
Input input = operation.getInput();
List<Part> partsList = new ArrayList<Part>();
if (input != null) {
Iterator ite = input.getMessage().getParts().values().iterator();
while (ite.hasNext()) {
partsList.add((Part)ite.next());
}
}
return partsList;
}
public List<Part> getOutMessageParts(Operation operation) {
Output output = operation.getOutput();
List<Part> partsList = new ArrayList<Part>();
if (output != null) {
Iterator ite = output.getMessage().getParts().values().iterator();
while (ite.hasNext()) {
partsList.add((Part)ite.next());
}
}
return partsList;
}
public Binding getBinding(BindingOperation bop, Definition def) {
Iterator ite = def.getBindings().values().iterator();
while (ite.hasNext()) {
Binding binding = (Binding)ite.next();
for (Iterator ite2 = binding.getBindingOperations().iterator(); ite2.hasNext();) {
BindingOperation bindingOperation = (BindingOperation)ite2.next();
if (bindingOperation.getName().equals(bop.getName())) {
return binding;
}
}
}
return null;
}
public Definition getDefinition(File wsdlFile) throws Exception {
WSDLFactory wsdlFactory = WSDLFactory.newInstance();
WSDLReader reader = wsdlFactory.newWSDLReader();
reader.setFeature("javax.wsdl.verbose", false);
return reader.readWSDL(wsdlFile.toURI().toURL().toString());
}
}

</source>

Java/Web Services SOA/XMLBEANS

2010-06-01T07:27:48Z

Admin: 1 версия

== In this sample, we are deploying an XMLBEANS generated service ==



<source lang="java">

Axis2 Quick Start Guide- Sample 4 (XML Beans)
============================================
This sample contains source code for the xdocs/1_1/quickstartguide.html document found in
the extracted Axis2 Documents Distribution. For a more detailed description on the
source code kindly see this "Axis2 Quick Start Guide" document.
Introduction
============
In this sample, we are deploying an XMLBEANS generated service. The service
is tested using generated client stubs.

Pre-Requisites
==============
Apache Ant 1.6.2 or later
Building the Service
====================
Type "ant generate.service" from Axis2_HOME/samples/quickstartxmlbeans
directory. Then deploy the
AXIS2_HOME/samples/quickstartxmlbeans/build/service/build/lib/StockQuoteService.aar

Running the Client
==================
type ant run.client in the AXIS2_HOME/samples/quickstartxmlbeans directory
Help
====
Please contact axis-user list (axis-user@ws.apache.org) if you have
any trouble running the sample.
</source>

Java/Web Services SOA/JAX WS Tools

2010-06-01T07:27:46Z

Admin: 1 версия

== Using wsgen Tools ==

Java/Web Services SOA/JAX WS Attachment

2010-06-01T07:27:46Z

Admin: 1 версия

== JAX-WS: Attachment From Java ==

== JAX-WS: Attachment From WSDL ==

Java/Web Services SOA/RPC

2010-06-01T07:27:46Z

Admin: 1 версия

== The RPC-Literal style binding ==



<source lang="java">

Hello World Demo using RPC-Literal Style
========================================
This version of Helloe World demonstrates the use
of the RPC-Literal style binding.
Please review the README in the samples directory before
continuing.

Prerequisites
-------------
If your environment already includes cxf-manifest-incubator.jar on the
CLASSPATH, and the JDK and ant bin directories on the PATH
it is not necessary to set the environment as described in
the samples directory"s README. If your environment is not
properly configured, or if you are planning on using wsdl2java,
javac, and java to build and run the demos, you must set the
environment.

Building and running the demo using ant
---------------------------------------
From the samples/hello_world_RPCLit directory, the ant build script
can be used to build and run the demo.
Using either UNIX or Windows:
ant build
ant server
ant client

To remove the code generated from the WSDL file and the .class
files, run:
ant clean

Building the demo using wsdl2java and javac
-------------------------------------------
From the samples/hello_world_RPCLit directory, first create the target
directory build/classes and then generate code from the WSDL file.
For UNIX:
mkdir -p build/classes
wsdl2java -d build/classes -compile ./wsdl/hello_world_RPCLit.wsdl
For Windows:
mkdir build\classes
Must use back slashes.
wsdl2java -d build\classes -compile .\wsdl\hello_world_RPCLit.wsdl
May use either forward or back slashes.
Now compile the provided client and server applications with the commands:
For UNIX:

export CLASSPATH=$CLASSPATH:$CXF_HOME/lib/cxf-manifest-incubator.jar:./build/classes
javac -d build/classes src/demo/hwRPCLit/client/*.java
javac -d build/classes src/demo/hwRPCLit/server/*.java
For Windows:
set classpath=%classpath%;%CXF_HOME%\lib\cxf-manifest-incubator.jar;.\build\classes
javac -d build\classes src\demo\hwRPCLit\client\*.java
javac -d build\classes src\demo\hwRPCLit\server\*.java

Running the demo using java
---------------------------
From the samples/hello_world_RPCLit directory run the following
commands. They are entered on a single command line:
For UNIX (must use forward slashes):
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.hwRPCLit.server.Server &
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.hwRPCLit.client.Client ./wsdl/hello_world_RPCLit.wsdl
The server process starts in the background. After running the client,
use the kill command to terminate the server process.
For Windows (may use either forward or back slashes):
start
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.hwRPCLit.server.Server
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.hwRPCLit.client.Client .\wsdl\hello_world_RPCLit.wsdl
A new command windows opens for the server process. After running the
client, terminate the server process by issuing Ctrl-C in its command window.
To remove the code generated from the WSDL file and the .class
files, either delete the build directory and its contents or run:
ant clean

Building and running the demo in a servlet container
----------------------------------------------------
From the samples/hello_world_RPCLit directory, the ant build script
can be used to create the war file that is deployed into the
servlet container.
Build the war file with the command:
ant war

Preparing deploy to APACHE TOMCAT
* set CATALINA_HOME environment to your TOMCAT home directory

Deploy the application into APACHE TOMCAT with the commond:
[NOTE] This step will check if the cxf jars present in Tomcat,
if not, it will automatically copy all the jars into CATALINA_HOME/shared/lib

ant deploy -Dtomcat=true
The servlet container will extract the war and deploy the application.

Using ant, run the client application with the command:
ant client-servlet -Dbase.url=http://localhost:#
Where # is the TCP/IP port used by the servlet container,
e.g., 8080.
Or
ant client-servlet -Dhost=localhost -Dport=8080
You can ignore the -Dhost and -Dport if your tomcat setup is same, i.e ant client-servlet
Using java, run the client application with the command:
For UNIX:

java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.hwRPCLit.client.Client http://localhost:#/helloworld/services/hello_world_rpclit?wsdl
For Windows:
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.hwRPCLit.client.Client http://localhost:#/helloworld/services/hello_world_rpclit?wsdl
Where # is the TCP/IP port used by the servlet container,
e.g., 8080.
Undeploy the application from the APACHE TOMCAT with the command:
ant undeploy -Dtomcat=true

Running demo with HTTP GET
----------------------------------------------------
APACHE CXF support HTTP GET to invoke the service, instead of running
ant client
you can use
ant client.get
to invoke the service with simple HttpURLConnection, or you can even
use your favoriate browser to get the results back.

///////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.hwRPCLit.client;
import java.io.File;
import java.net.URL;
import javax.xml.namespace.QName;
import org.apache.hello_world_rpclit.GreeterRPCLit;
import org.apache.hello_world_rpclit.SOAPServiceRPCLit;
import org.apache.hello_world_rpclit.types.MyComplexStruct;
public final class Client {
private static final QName SERVICE_NAME =
new QName("http://apache.org/hello_world_rpclit", "SOAPServiceRPCLit");
private static final QName PORT_NAME =
new QName("http://apache.org/hello_world_rpclit", "SoapPortRPCLit");
private Client() {
}
public static void main(String[] args) throws Exception {
if (args.length == 0) {
System.out.println("please specify wsdl");
System.exit(1);
}
URL wsdlURL;
File wsdlFile = new File(args[0]);
if (wsdlFile.exists()) {
wsdlURL = wsdlFile.toURL();
} else {
wsdlURL = new URL(args[0]);
}

SOAPServiceRPCLit service = new SOAPServiceRPCLit(wsdlURL, SERVICE_NAME);
GreeterRPCLit greeter = (GreeterRPCLit)service.getPort(PORT_NAME, GreeterRPCLit.class);
System.out.println("Invoking sayHi...");
System.out.println("server responded with: " + greeter.sayHi());
System.out.println();
System.out.println("Invoking greetMe...");
System.out.println("server responded with: " + greeter.greetMe(System.getProperty("user.name")));
System.out.println();

MyComplexStruct argument = new MyComplexStruct();
MyComplexStruct retVal = null;
String str1 = "this is element 1";
String str2 = "this is element 2";
int int1 = 42;
argument.setElem1(str1);
argument.setElem2(str2);
argument.setElem3(int1);
System.out.println("Invoking sendReceiveData...");
retVal = greeter.sendReceiveData(argument);
System.out.println("Response from sendReceiveData operation :");
System.out.println("Element-1 : " + retVal.getElem1());
System.out.println("Element-2 : " + retVal.getElem2());
System.out.println("Element-3 : " + retVal.getElem3());
System.out.println();

System.exit(0);
}
}

///////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.hwRPCLit.client;
import java.io.ByteArrayOutputStream;
import java.io.InputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Properties;
import javax.xml.transform.OutputKeys;
import javax.xml.transform.Source;
import javax.xml.transform.Transformer;
import javax.xml.transform.TransformerFactory;
import javax.xml.transform.stream.StreamResult;
import javax.xml.transform.stream.StreamSource;
public final class Get {
private Get() {
}
public static void main(String args[]) throws Exception {
// Sent HTTP GET request to invoke sayHi
String target = "http://localhost:9000/SoapContext/SoapPort/sayHi";
URL url = new URL(target);
HttpURLConnection httpConnection = (HttpURLConnection) url.openConnection();
httpConnection.connect();
System.out.println("Invoking server through HTTP GET to invoke sayHi");
InputStream in = httpConnection.getInputStream();
StreamSource source = new StreamSource(in);
printSource(source);
// Sent HTTP GET request to invoke greetMe FAULT
target = "http://localhost:9000/SoapContext/SoapPort/greetMe/me/CXF";
url = new URL(target);
httpConnection = (HttpURLConnection) url.openConnection();
httpConnection.connect();
System.out.println("Invoking server through HTTP GET to invoke greetMe");
try {
in = httpConnection.getInputStream();
source = new StreamSource(in);
printSource(source);
} catch (Exception e) {
System.err.println("GreetMe Fault: " + e.getMessage());
}
InputStream err = httpConnection.getErrorStream();
source = new StreamSource(err);
printSource(source);
// Sent HTTP GET request to invoke greetMe
target = "http://localhost:9000/SoapContext/SoapPort/greetMe/in/CXF";
url = new URL(target);
httpConnection = (HttpURLConnection) url.openConnection();
httpConnection.connect();
System.out.println("Invoking server through HTTP GET to invoke greetMe");
in = httpConnection.getInputStream();
source = new StreamSource(in);
printSource(source);
}
private static void printSource(Source source) {
try {
ByteArrayOutputStream bos = new ByteArrayOutputStream();
StreamResult sr = new StreamResult(bos);
Transformer trans = TransformerFactory.newInstance().newTransformer();
Properties oprops = new Properties();
oprops.put(OutputKeys.OMIT_XML_DECLARATION, "yes");
trans.setOutputProperties(oprops);
trans.transform(source, sr);
System.out.println();
System.out.println("**** Response ******");
System.out.println();
System.out.println(bos.toString());
bos.close();
System.out.println();
} catch (Exception e) {
e.printStackTrace();
}
}
}
///////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.hwRPCLit.server;
import java.util.logging.Logger;
import org.apache.hello_world_rpclit.GreeterRPCLit;
import org.apache.hello_world_rpclit.types.MyComplexStruct;
@javax.jws.WebService(portName = "SoapPortRPCLit", serviceName = "SOAPServiceRPCLit",
targetNamespace = "http://apache.org/hello_world_rpclit",
endpointInterface = "org.apache.hello_world_rpclit.GreeterRPCLit")
public class GreeterRPCLitImpl implements GreeterRPCLit {
private static final Logger LOG = Logger.getLogger(GreeterRPCLitImpl.class.getPackage().getName());
public String greetMe(String me) {
LOG.info("Executing operation greetMe");
System.out.println("Executing operation greetMe");
System.out.println("Message received: " + me + "\n");
return "Hello " + me;
}
public String sayHi() {
LOG.info("Executing operation sayHi");
System.out.println("Executing operation sayHi" + "\n");
return "Bonjour";
}
public MyComplexStruct sendReceiveData(MyComplexStruct in) {
LOG.info("Executing operation sendReceiveData");
System.out.println("Executing operation sendReceiveData");
System.out.println("Received struct with values :\nElement-1 : " + in.getElem1() + "\nElement-2 : "
+ in.getElem2() + "\nElement-3 : " + in.getElem3() + "\n");
return in;
}
}

///////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.hwRPCLit.server;
import javax.xml.ws.Endpoint;
public class Server {
protected Server() throws Exception {
System.out.println("Starting Server");
Object implementor = new GreeterRPCLitImpl();
String address = "http://localhost:9000/SoapContext/SoapPort";
Endpoint.publish(address, implementor);
}
public static void main(String args[]) throws Exception {
new Server();
System.out.println("Server ready...");

Thread.sleep(5 * 60 * 1000);
System.out.println("Server exiting");
System.exit(0);
}
}

///////////////////////////////////////////////////////////////////////
<?xml version="1.0" encoding="UTF-8"?>

<wsdl:definitions name="HelloWorld" targetNamespace="http://apache.org/hello_world_rpclit"
xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:tns="http://apache.org/hello_world_rpclit"
xmlns:x1="http://apache.org/hello_world_rpclit/types"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<wsdl:types>
<schema targetNamespace="http://apache.org/hello_world_rpclit/types"
xmlns="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
<complexType name="myComplexStruct">
<sequence>
<element name="elem1" type="xsd:string"/>
<element name="elem2" type="xsd:string"/>
<element name="elem3" type="xsd:int"/>
</sequence>
</complexType>
</schema>
</wsdl:types>

<wsdl:message name="sayHiRequest"/>

<wsdl:message name="sayHiResponse">
<wsdl:part type="xsd:string" name="out"/>
</wsdl:message>

<wsdl:message name="greetMeRequest">
<wsdl:part type="xsd:string" name="in"/>
</wsdl:message>

<wsdl:message name="greetMeResponse">
<wsdl:part type="xsd:string" name="out"/>
</wsdl:message>

<wsdl:message name="sendReceiveDataRequest">
<wsdl:part type="x1:myComplexStruct" name="in"/>
</wsdl:message>

<wsdl:message name="sendReceiveDataResponse">
<wsdl:part type="x1:myComplexStruct" name="out"/>
</wsdl:message>

<wsdl:portType name="GreeterRPCLit">
<wsdl:operation name="sayHi">
<wsdl:input message="tns:sayHiRequest" name="sayHiRequest"/>
<wsdl:output message="tns:sayHiResponse" name="sayHiResponse"/>
</wsdl:operation>
<wsdl:operation name="greetMe">
<wsdl:input message="tns:greetMeRequest" name="greetMeRequest"/>
<wsdl:output message="tns:greetMeResponse" name="greetMeResponse"/>
</wsdl:operation>
<wsdl:operation name="sendReceiveData">
<wsdl:input message="tns:sendReceiveDataRequest" name="SendReceiveDataRequest"/>
<wsdl:output message="tns:sendReceiveDataResponse" name="SendReceiveDataResponse"/>
</wsdl:operation>
</wsdl:portType>

<wsdl:binding name="Greeter_SOAPBinding_RPCLit" type="tns:GreeterRPCLit">

<soap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/>

<wsdl:operation name="sayHi">
<soap:operation soapAction="" style="rpc"/>
<wsdl:input>
<soap:body namespace="http://apache.org/hello_world_rpclit" use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body namespace="http://apache.org/hello_world_rpclit" use="literal"/>
</wsdl:output>
</wsdl:operation>

<wsdl:operation name="greetMe">
<soap:operation soapAction="" style="rpc"/>
<wsdl:input>
<soap:body namespace="http://apache.org/hello_world_rpclit" use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body namespace="http://apache.org/hello_world_rpclit" use="literal"/>
</wsdl:output>
</wsdl:operation>

<wsdl:operation name="sendReceiveData">
<soap:operation soapAction="" style="rpc"/>
<wsdl:input>
<soap:body namespace="http://apache.org/hello_world_rpclit" use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body namespace="http://apache.org/hello_world_rpclit" use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>

<wsdl:service name="SOAPServiceRPCLit">
<wsdl:port binding="tns:Greeter_SOAPBinding_RPCLit" name="SoapPortRPCLit">
<soap:address location="http://localhost:9000/SoapContext/SoapPort"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
</source>

Java/Web Services SOA/JAX WS RPC

2010-06-01T07:27:45Z

Admin: 1 версия

== JAX-WS: HelloWorld RPC ==

== JAX-WS: RPC Literal From WSDL ==

Java/Web Services SOA/Asynchronous Web Method

2010-06-01T07:27:45Z

Admin: 1 версия

== This example demonstrates the use of asynchronous Web method invocations ==



<source lang="java">

Sample: Google Spell Checker
=============================
Introduction
============
This example demonstrates the use of asynchronous Web method invocations. The user can continue to type
text on the text editor where the text editor does the spell check from a hosted Web service. The Web
method invocation is carried out in an asynchronous manner allowing the user to continuously type text
without having to stall for the response.

Pre-Requisites
==============
Apache Ant 1.6.2 or later

Running The Sample
==================
To generate stubs and run the text editor, type ant.
Note that when running the build script, a stub is generated for the hosted spell check service at:
http://tools.wso2.net:12001/axis2/services/SimplifiedSpellCheck?wsdl
N.B.: This public Web service uses Google Web APIs to provide spell check service. In case of a
failure SimplifiedSpellCheck echo sends back the phrase (sent for spell check) instead of throwing
an error. Therefore, if the spell check editor just outputs the input words/phrase, that is because
of this behavior of the SimplifiedSpellCheck service.
Help
====
Please contact axis-user list (axis-user@ws.apache.org) if you have any trouble running the sample.
</source>

Java/Web Services SOA/HTTPS

2010-06-01T07:27:44Z

Admin: 1 версия

== Doing the communication using HTTPS ==



<source lang="java">

Hello World Demo using HTTPS communications
=============================================
This demo takes the hello world demo a step further
by doing the communication using HTTPS.
Please review the README in the samples directory before
continuing.

Prerequisite
------------
If your environment already includes cxf-manifest-incubator.jar on the
CLASSPATH, and the JDK and ant bin directories on the PATH
it is not necessary to run the environment script described in
the samples directory README. If your environment is not
properly configured, or if you are planning on using wsdl2java,
javac, and java to build and run the demos, you must set the
environment by running the script.

Building and running the demo using ant
---------------------------------------
From the samples/hello_world_https directory, the ant build script
can be used to build demo.
Using either UNIX or Windows:
ant build

To remove the code generated from the WSDL file and the .class
files, run:
ant clean

The demo illustrates how authentication can be achieved through
configuration using 2 different scenarios. The non-defaulted security
policy values are be specified via configuration files.
Scenario 1:
A HTTPS listener is started up. The listener requires
client authentication so the client must provide suitable credentials.
The listener configuration is taken from the "CherryServer.cxf" file
located in this directory. The client"s security data is taken from
from the "InsecureClient.cxf" file in this directory, using the bean name:
"{http://apache.org/hello_world_soap_http}SoapPort.http-conduit". The
client does NOT provide the appropriate credentials and so the
invocation on the server fails.
To run:
ant server
ant insecure.client
Scenario 2:
The same HTTPS listener is used. The client"s security data is taken
from the "WibbleClient.cxf" configuration file in this directory,
using the bean name:
"{http://apache.org/hello_world_soap_http}SoapPort.http-conduit".
The client is configured to provide its certificate "CN=Wibble" and
chain stored in the Java KeyStore "certs/wibble.jks" to the server. The
server authenticates the client"s certificate using its trust store
"certs/truststore.jks", which holds the Certificate Authorities"
certificates.
Likewise the client authenticates the server"s certificate "CN=Cherry"
and chain against the same trust store. Note also the usage of the
cipherSuitesFilter configuration in the configuration files,
where each party imposes different ciphersuites contraints, so that the
ciphersuite eventually negotiated during the TLS handshake is acceptable
to both sides. This may be viewed by adding a -Djavax.net.debug=all
argument to the JVM.
But please note that it is not adviseable to store sensitive data such
as passwords stored in a clear text configuration file, unless the
file is sufficiently protected by OS level permissions. The KeyStores
may be configured programatically so using user interaction may be
employed to keep passwords from being stored in configuration files.
The approach taken here is for demonstration reasons only.

To run:
ant server
ant secure.client
Certificates:
If the certificates are expired for some reason, a shell script in
bin/gencerts.sh will generate the set of certificates needed for
this sample. Just do the following:
cd certs
sh ../bin/gencerts.sh

</source>

Java/Web Services SOA/JMS

2010-06-01T07:27:43Z

Admin: 1 версия

== Document-Literal style binding over JMS Transport using the queue mechanism ==



<source lang="java">

JMS Transport Demo using Document-Literal Style
==========================================================
This sample demonstrates use of the Document-Literal style
binding over JMS Transport using the queue mechanism.
Please review the README in the samples directory before
continuing.
This demo uses ActiveMQ as the JMS implementation for
illustration purposes only. Other JMS implementations
such as Apache Qpid could also be used in the same way.
For details on how to use this demo on non-ActiveMQ
implementations please check "Using other JMS implementaions"
below.
Prerequisite
------------
If your environment already includes cxf-manifest-incubator.jar on the
CLASSPATH, and the JDK and ant bin directories on the PATH
it is not necessary to set the environment as described in
the samples directory README. If your environment is not
properly configured, or if you are planning on using wsdl2java,
javac, and java to build and run the demos, you must set the
environment.
This demo requires ActiveMQ 4.1.X. Before you run this
demo, please make sure you had installed the ActiveMQ 4.1.X and
set ACTIVEMQ_HOME and ACTIVEMQ_VERSION environment variables.
ActiveMQ 4.1.0 the version variable should be
For Unix:
export ACTIVEMQ_VERSION=4.1.0-incubator
For Windows:
set ACTIVEMQ_VERSION=4.1.0-incubator
ActiveMQ 4.1.1 the version variable should be
For Unix:
export ACTIVEMQ_VERSION=4.1.1
For Windows:
set ACTIVEMQ_VERSION=4.1.1

Before you run this demo, please start up the JMS message broker first.
From your ActiveMQ 4.1.X installation launch ActiveMQ JMS broker in a
separate window or in the background using the commandline:
For Unix:
cd <activemq.home.dir>/bin
activemq
For Windows:
cd <activemq.home.dir>\bin
activemq.bat
The location of <activemq.home.dir> depends on whether you have installed the
binary or source release.

Building and running the demo using ant
---------------------------------------
From the samples/jms_queue directory, the ant build script
can be used to build and run the demo.
Using either UNIX or Windows:
ant build
ant jmsbroker.start
ant server
ant client

To remove the code generated from the WSDL file and the .class
files, run:
ant clean

Building the demo using wsdl2java and javac
-------------------------------------------
From the samples/jms_queue directory, first create the target
directory build/classes and then generate code from the WSDL file.
For UNIX:
mkdir -p build/classes
wsdl2java -d build/classes -compile ./wsdl/jms_greeter.wsdl
For Windows:
mkdir build\classes
Must use back slashes.
wsdl2java -d build\classes -compile .\wsdl\jms_greeter.wsdl
May use either forward or back slashes.
Now compile the provided client and server applications with the commands:
For UNIX:

export CLASSPATH=$CLASSPATH:$CXF_HOME/lib/cxf-manifest-incubator.jar:./build/classes:
$ACTIVEMQ_HOME/apache-activemq-$ACTIVEMQ_VERSION.jar
javac -d build/classes src/demo/jms_greeter/client/*.java
javac -d build/classes src/demo/jms_greeter/server/*.java
For Windows:
set classpath=%classpath%;%CXF_HOME%\lib\cxf-manifest-incubator.jar;.\build\classes;
%ACTIVEMQ_HOME%\apache-activemq-%ACTIVEMQ_VERSION%.jar
javac -d build\classes src\demo\jms_greeter\client\*.java
javac -d build\classes src\demo\jms_greeter\server\*.java

Running the demo using java
---------------------------
From the samples/jms_queue directory run the commands, entered on a
single command line:
For UNIX (must use forward slashes):
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.jms_greeter.server.Server &
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.jms_greeter.client.Client ./wsdl/jms_greeter.wsdl
The server process starts in the background. After running the client,
use the kill command to terminate the server process.
For Windows (may use either forward or back slashes):
start
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.jms_greeter.server.Server
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.jms_greeter.client.Client .\wsdl\jms_greeter.wsdl
A new command windows opens for the server process. After running the
client, terminate the server process by issuing Ctrl-C in its command window.

Now you can stop ActiveMQ JMS Broker by issuing Ctrl-C in its command window.
To remove the code generated from the WSDL file and the .class
files, either delete the build directory and its contents or run:
ant clean
Using other JMS implementations:
-------------------------------
Using it with Apache Qpid:
-------------------------
Before running the run, you will have to set QPID_HOME in your environment,
and also have to start the Qpid broker.
The following changes are needed to the demo to make it work for Apache Qpid.
1. Changes to wsdl/jms_greeter.wsdl
- Replace the jms:address element under wsdl:port with:
<jms:address
destinationStyle="queue"
jndiConnectionFactoryName="local"
jndiDestinationName="dq">
<jms:JMSNamingProperty name="java.naming.factory.initial"
value="org.apache.qpid.jndi.PropertiesFileInitialContextFactory"/>
<jms:JMSNamingProperty name="java.naming.provider.url"
value="tcp://localhost:5672"/>
<jms:JMSNamingProperty name="connectionfactory.local"
value="amqp://guest:guest@clientid/test?brokerlist="tcp://localhost:5672""/>
<jms:JMSNamingProperty name="queue.dq" value="queue://queuetest"/>
</jms:address>
2. Changes to build.xml.
- Replace
<condition property="activemq.home" value="${env.ACTIVEMQ_HOME}">
<isset property="env.ACTIVEMQ_HOME"/>
</condition>
<fail message="this sample need to use activemq, please setup ACTIVEMQ_HOME in your environment"
unless="activemq.home"/>
<condition property="activemq.version" value="${env.ACTIVEMQ_VERSION}">
<isset property="env.ACTIVEMQ_VERSION"/>
</condition>
<fail message="this sample need to use activemq, please setup ACTIVEMQ_VERSION in your envrionment"
unless="activemq.version"/>
<property name="thirdparty.classpath" location="${activemq.home}/incubator-activemq-${activemq.version}.jar"/>

with
<condition property="qpid.home" value="${env.QPID_HOME}">
<isset property="env.QPID_HOME"/>
</condition>
<fail message="this sample need to use qpid, please setup QPID_HOME in your environment"
unless="qpid.home"/>
<property name="thirdparty.classpath" location="${qpid.home}/lib/qpid-incubating.jar"/>
- Remove the target jmsbroker.start from build.xml. This is only a helper function to start the
Active MQ broker, and is not required if the broker can be started through the scripts.
3. Remove the file, EmbeddedBroker.java from under the directory src/demo/jms_greeter/broker. This is
only a helper function and therefore need not be used, as long as the broker is started
through the scripts.

//////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.jms_greeter.server;
import java.util.logging.Logger;
import org.apache.cxf.jms_greeter.JMSGreeterPortType;
@javax.jws.WebService(portName = "GreeterPort",
serviceName = "JMSGreeterService",
targetNamespace = "http://cxf.apache.org/jms_greeter",
endpointInterface = "org.apache.cxf.jms_greeter.JMSGreeterPortType",
wsdlLocation = "file:./wsdl/jms_greeter.wsdl")
public class GreeterJMSImpl implements JMSGreeterPortType {
private static final Logger LOG = Logger.getLogger(GreeterJMSImpl.class.getPackage().getName());
public String greetMe(String me) {
LOG.info("Executing operation greetMe");
System.out.println("Executing operation greetMe");
System.out.println("Message received: " + me + "\n");
return "Hello " + me;
}
public String sayHi() {
LOG.info("Executing operation sayHi");
System.out.println("Executing operation sayHi" + "\n");
return "Bonjour";
}

public void greetMeOneWay(String me) {
LOG.info("Executing operation greetMeOneWay");
System.out.println("Executing operation greetMeOneWay\n");
System.out.println("Hello there " + me);
}
}

///////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.jms_greeter.broker;
import org.apache.activemq.broker.BrokerService;
import org.apache.activemq.store.memory.MemoryPersistenceAdapter;
public final class EmbeddedBroker {
private EmbeddedBroker() {
}
public static void main(String[] args) throws Exception {
BrokerService broker = new BrokerService();
broker.setPersistenceAdapter(new MemoryPersistenceAdapter());
broker.addConnector("tcp://localhost:61616");
broker.start();
System.out.println("JMS broker ready ...");
Thread.sleep(125 * 60 * 1000);
System.out.println("JMS broker exiting");
broker.stop();
System.exit(0);
}
}

///////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.jms_greeter.client;
import java.io.File;
import java.lang.reflect.InvocationHandler;
import java.lang.reflect.Proxy;
import java.util.Map;
import javax.xml.namespace.QName;
import javax.xml.ws.BindingProvider;
import org.apache.cxf.jms_greeter.JMSGreeterPortType;
import org.apache.cxf.jms_greeter.JMSGreeterService;
import org.apache.cxf.transport.jms.JMSMessageHeadersType;
import org.apache.cxf.transport.jms.JMSPropertyType;

public final class Client {
private static final QName SERVICE_NAME =
new QName("http://cxf.apache.org/jms_greeter", "JMSGreeterService");
private static final QName PORT_NAME =
new QName("http://cxf.apache.org/jms_greeter", "GreeterPort");
private Client() {
}
public static void main(String[] args) throws Exception {
if (args.length == 0) {
System.out.println("please specify wsdl");
System.exit(1);
}
File wsdl = new File(args[0]);
JMSGreeterService service = new JMSGreeterService(wsdl.toURL(), SERVICE_NAME);
JMSGreeterPortType greeter = (JMSGreeterPortType)service.getPort(PORT_NAME, JMSGreeterPortType.class);
System.out.println("Invoking sayHi...");
System.out.println("server responded with: " + greeter.sayHi());
System.out.println();
System.out.println("Invoking greetMe...");
System.out.println("server responded with: " + greeter.greetMe(System.getProperty("user.name")));
System.out.println();
System.out.println("Invoking greetMeOneWay...");
greeter.greetMeOneWay(System.getProperty("user.name"));
System.out.println("No response from server as method is OneWay");
System.out.println();

// Demonstration of JMS Context usage
InvocationHandler handler = Proxy.getInvocationHandler(greeter);
BindingProvider bp = null;
if (handler instanceof BindingProvider) {
bp = (BindingProvider)handler;
Map<String, Object> requestContext = bp.getRequestContext();
JMSMessageHeadersType requestHeader = new JMSMessageHeadersType();
requestHeader.setJMSCorrelationID("JMS_QUEUE_SAMPLE_CORRELATION_ID");
requestHeader.setJMSExpiration(3600000L);
JMSPropertyType propType = new JMSPropertyType();
propType.setName("Test.Prop");
propType.setValue("mustReturn");
requestHeader.getProperty().add(propType);
requestContext.put("org.apache.cxf.jms.client.request.headers", requestHeader);
//To override the default receive timeout.
requestContext.put("org.apache.cxf.jms.client.timeout", new Long(1000));
}
System.out.println("Invoking sayHi with JMS Context information ...");
System.out.println("server responded with: " + greeter.sayHi());
if (bp != null) {
Map<String, Object> responseContext = bp.getResponseContext();
JMSMessageHeadersType responseHdr = (JMSMessageHeadersType)responseContext.get(
"org.apache.cxf.jms.client.response.headers");
if (responseHdr == null) {
System.out.println("response Header should not be null");
System.out.println();
System.exit(1);
}
if ("JMS_QUEUE_SAMPLE_CORRELATION_ID".equals(responseHdr.getJMSCorrelationID())
&& responseHdr.getProperty() != null) {
System.out.println("Received expected contents in response context");
} else {
System.out.println("Received wrong contents in response context");
System.out.println();
System.exit(2);
}
} else {
System.out.println("Failed to get the binding provider cannot access context info.");
System.exit(3);
}

System.out.println();
System.exit(0);
}
}
///////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.jms_greeter.server;
import javax.xml.ws.Endpoint;
public class Server {
protected Server() throws Exception {
System.out.println("Starting Server");
Object implementor = new GreeterJMSImpl();
String address = "http://cxf.apache.org/transports/jms";
Endpoint.publish(address, implementor);
}
public static void main(String args[]) throws Exception {
new Server();
System.out.println("Server ready...");
Thread.sleep(125 * 60 * 1000);
System.out.println("Server exiting");
System.exit(0);
}
}
///////////////////////////////////////////////////////////////////////////
<?xml version="1.0" encoding="UTF-8"?>

<wsdl:definitions name="JMSGreeterService"
targetNamespace="http://cxf.apache.org/jms_greeter"
xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:jms="http://cxf.apache.org/transports/jms"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:tns="http://cxf.apache.org/jms_greeter"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:x1="http://cxf.apache.org/jms_greeter/types">
<wsdl:types>
<schema targetNamespace="http://cxf.apache.org/jms_greeter/types"
xmlns="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
<element name="sayHi">
<complexType/>
</element>
<element name="sayHiResponse">
<complexType>
<sequence>
<element name="responseType" type="xsd:string"/>
</sequence>
</complexType>
</element>
<element name="greetMe">
<complexType>
<sequence>
<element name="requestType" type="xsd:string"/>
</sequence>
</complexType>
</element>
<element name="greetMeResponse">
<complexType>
<sequence>
<element name="responseType" type="xsd:string"/>
</sequence>
</complexType>
</element>
<element name="greetMeOneWay">
<complexType>
<sequence>
<element name="requestType" type="xsd:string"/>
</sequence>
</complexType>
</element>
</schema>
</wsdl:types>

<wsdl:message name="sayHiRequest">
<wsdl:part element="x1:sayHi" name="in"/>
</wsdl:message>
<wsdl:message name="sayHiResponse">
<wsdl:part element="x1:sayHiResponse" name="out"/>
</wsdl:message>
<wsdl:message name="greetMeRequest">
<wsdl:part element="x1:greetMe" name="in"/>
</wsdl:message>
<wsdl:message name="greetMeResponse">
<wsdl:part element="x1:greetMeResponse" name="out"/>
</wsdl:message>
<wsdl:message name="greetMeOneWayRequest">
<wsdl:part element="x1:greetMeOneWay" name="in"/>
</wsdl:message>

<wsdl:portType name="JMSGreeterPortType">
<wsdl:operation name="sayHi">
<wsdl:input message="tns:sayHiRequest" name="sayHiRequest"/>
<wsdl:output message="tns:sayHiResponse" name="sayHiResponse"/>
</wsdl:operation>

<wsdl:operation name="greetMe">
<wsdl:input message="tns:greetMeRequest" name="greetMeRequest"/>
<wsdl:output message="tns:greetMeResponse" name="greetMeResponse"/>
</wsdl:operation>

<wsdl:operation name="greetMeOneWay">
<wsdl:input message="tns:greetMeOneWayRequest" name="greetMeOneWayRequest"/>
</wsdl:operation>
</wsdl:portType>

<wsdl:binding name="JMSGreeterPortBinding" type="tns:JMSGreeterPortType">
<soap:binding style="document" transport="http://cxf.apache.org/transport/jms"/>

<wsdl:operation name="greetMe">
<soap:operation soapAction="" style="document"/>
<wsdl:input name="greetMeRequest">
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output name="greetMeResponse">
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>

<wsdl:operation name="sayHi">
<soap:operation soapAction="" style="document"/>
<wsdl:input name="sayHiRequest">
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output name="sayHiResponse">
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>

<wsdl:operation name="greetMeOneWay">
<soap:operation soapaction="" style="document"/>
<wsdl:input name="greetMeOneWayRequest">
<soap:body use="literal"/>
</wsdl:input>
</wsdl:operation>
</wsdl:binding>

<wsdl:service name="JMSGreeterService">
<wsdl:port binding="tns:JMSGreeterPortBinding" name="GreeterPort">
<jms:address
destinationStyle="queue"
jndiConnectionFactoryName="ConnectionFactory"
jndiDestinationName="dynamicQueues/test.cxf.jmstransport.queue">

<jms:JMSNamingProperty name="java.naming.factory.initial" value="org.apache.activemq.jndi.ActiveMQInitialContextFactory"/>
<jms:JMSNamingProperty name="java.naming.provider.url" value="tcp://localhost:61616"/>

</jms:address>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
</source>



== The Document-Literal style binding over JMS transport using the pub/sub mechanism ==



<source lang="java">

JMS Transport Demo using Document-Literal Style.
==========================================================
This sample demonstrates use of the Document-Literal style
binding over JMS transport using the pub/sub mechanism.
Please review the README in the samples directory before
continuing.
This demo uses ActiveMQ as the JMS implementation for
illustration purposes only. Other JMS implementations
such as Apache Qpid could also be used in the same way.
For details on how to use this demo on non-ActiveMQ
implementations please check "Using other JMS implementaions"
below.
Prerequisite
------------
If your environment already includes cxf-manifest-incubator.jar on the
CLASSPATH, and the JDK and ant bin directories on the PATH
it is not necessary to set the environment as described in
the samples directory README. If your environment is not
properly configured, or if you are planning on using wsdl2java,
javac, and java to build and run the demos, you must set the
environment.
This demo requires ActiveMQ 4.1.X. Before you run this
demo, please make sure you had installed the ActiveMQ 4.1.X and
set ACTIVEMQ_HOME and ACTIVEMQ_VERSION environment variables.
ActiveMQ 4.1.0 the version variable should be
For Unix:
export ACTIVEMQ_VERSION=4.1.0-incubator
For Windows:
set ACTIVEMQ_VERSION=4.1.0-incubator
ActiveMQ 4.1.1 the version variable should be
For Unix:
export ACTIVEMQ_VERSION=4.1.1
For Windows:
set ACTIVEMQ_VERSION=4.1.1

Before you run this demo, start up the JMS message broker.
From ActiveMQ 4.1.X insallation launch ActiveMQ JMS Broker in seperate window
or in background using the commands:
For Unix:
cd <activemq.home.dir>/bin
activemq
For Windows:
cd <activemq.home.dir>\bin
activemq.bat
The location of <activemq.home.dir> depends on whether you have installed the
binary or source release.

Building and running the demo using ant
---------------------------------------
From the samples/jms_pubsub directory, the ant build script
can be used to build and run the demo.
Using either UNIX or Windows:
ant build
ant jmsbroker.start
ant server
ant client

To remove the code generated from the WSDL file and the .class
files, run:
ant clean

Building the demo using wsdl2java and javac
-------------------------------------------
From the samples/jms_pubsub directory, first create the target
directory build/classes and then generate code from the WSDL file.
For UNIX:
mkdir -p build/classes
wsdl2java -d build/classes -compile ./wsdl/jms_greeter.wsdl
For Windows:
mkdir build\classes
Must use back slashes.
wsdl2java -d build\classes -compile .\wsdl\jms_greeter.wsdl
May use either forward or back slashes.
Now compile the provided client and server applications with the commands:
For UNIX:

export CLASSPATH=$CLASSPATH:$CXF_HOME/lib/cxf-manifest-incubator.jar:./build/classes:
$ACTIVEMQ_HOME/apache-activemq-$ACTIVEMQ_VERSION.jar
javac -d build/classes src/demo/jms_greeter/client/*.java
javac -d build/classes src/demo/jms_greeter/server/*.java
For Windows:
set classpath=%classpath%;%CXF_HOME%\lib\cxf-manifest-incubator.jar;.\build\classes;
%ACTIVEMQ_HOME%\apache-activemq-%ACTIVEMQ_VERSION%.jar
javac -d build\classes src\demo\jms_greeter\client\*.java
javac -d build\classes src\demo\jms_greeter\server\*.java
Running the demo using java
---------------------------
The location of <activemq.home.dir> depends on whether you have installed the
binary or source release.
From the samples/jms_pubsub directory run the commands, entered on a
single command line:
For UNIX (must use forward slashes):
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.jms_greeter.server.Server &
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.jms_greeter.client.Client ./wsdl/jms_greeter.wsdl
The server process starts in the background. After running the client,
use the kill command to terminate the server process.
For Windows (may use either forward or back slashes):
start
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.jms_greeter.server.Server
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.jms_greeter.client.Client .\wsdl\jms_greeter.wsdl
A new command windows opens for the server process. After running the
client, terminate the server process by issuing Ctrl-C in its command window.

Now you can stop ActiveMQ JMS Broker by issuing Ctrl-C in its command window.
To remove the code generated from the WSDL file and the .class
files, either delete the build directory and its contents or run:
ant clean
Using other JMS implementations:
-------------------------------
Using it with Apache Qpid:
-------------------------
Before running the run, you will have to set QPID_HOME in your environment,
and also have to start the Qpid broker.
The following changes are needed to the demo to make it work for Apache Qpid.
1. Changes to wsdl/jms_greeter.wsdl
- Replace the jms:address element under wsdl:port with:
<jms:address
destinationStyle="topic"
jndiConnectionFactoryName="local"
jndiDestinationName="direct">
<jms:JMSNamingProperty name="java.naming.factory.initial"
value="org.apache.qpid.jndi.PropertiesFileInitialContextFactory"/>
<jms:JMSNamingProperty name="java.naming.provider.url"
value="tcp://localhost:5672"/>
<jms:JMSNamingProperty name="connectionfactory.local"
value="amqp://guest:guest@pdartix30.boston.amer.iona.ru1167022402426/test?brokerlist="tcp://localhost:5672""/>
<jms:JMSNamingProperty name="topic.direct" value="topic://topictest"/>
</jms:address>
2. Changes to build.xml.
- Replace
<condition property="activemq.home" value="${env.ACTIVEMQ_HOME}">
<isset property="env.ACTIVEMQ_HOME"/>
</condition>
<fail message="this sample need to use activemq, please setup ACTIVEMQ_HOME in your environment"
unless="activemq.home"/>
<condition property="activemq.version" value="${env.ACTIVEMQ_VERSION}">
<isset property="env.ACTIVEMQ_VERSION"/>
</condition>
<fail message="this sample need to use activemq, please setup ACTIVEMQ_VERSION in your envrionment"
unless="activemq.version"/>
<property name="thirdparty.classpath" location="${activemq.home}/incubator-activemq-${activemq.version}.jar"/>

with
<condition property="qpid.home" value="${env.QPID_HOME}">
<isset property="env.QPID_HOME"/>
</condition>
<fail message="this sample need to use qpid, please setup QPID_HOME in your environment"
unless="qpid.home"/>
<property name="thirdparty.classpath" location="${qpid.home}/lib/qpid-incubating.jar"/>
- Remove the target jmsbroker.start from build.xml. This is only a helper function to start the
Active MQ broker, and is not required if the broker can be started through the scripts.
3. Remove the file, EmbeddedBroker.java from under the directory src/demo/jms_greeter/broker. This is
only a helper function and therefore need not be used, as long as the broker is started
through the scripts.

///////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.jms_greeter.broker;
import org.apache.activemq.broker.BrokerService;
import org.apache.activemq.store.memory.MemoryPersistenceAdapter;
public final class EmbeddedBroker {
private EmbeddedBroker() {
}
public static void main(String[] args) throws Exception {
BrokerService broker = new BrokerService();
broker.setPersistenceAdapter(new MemoryPersistenceAdapter());
broker.addConnector("tcp://localhost:61616");
broker.start();
System.out.println("JMS broker ready ...");
Thread.sleep(125 * 60 * 1000);
System.out.println("JMS broker exiting");
broker.stop();
System.exit(0);
}
}

///////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.jms_greeter.client;
import java.io.File;
import javax.xml.namespace.QName;
import org.apache.cxf.jms_greeter.JMSGreeterPortType;
import org.apache.cxf.jms_greeter.JMSGreeterService;
public final class Client {
private static final QName SERVICE_NAME =
new QName("http://cxf.apache.org/jms_greeter", "JMSGreeterService");
private static final QName PORT_NAME =
new QName("http://cxf.apache.org/jms_greeter", "GreeterPort");
private Client() {
}
public static void main(String[] args) throws Exception {
if (args.length == 0) {
System.out.println("please specify wsdl");
System.exit(1);
}
File wsdl = new File(args[0]);
JMSGreeterService service = new JMSGreeterService(wsdl.toURL(), SERVICE_NAME);
JMSGreeterPortType greeter = (JMSGreeterPortType)service.getPort(PORT_NAME, JMSGreeterPortType.class);
System.out.println("Invoking greetMeOneWay...");
greeter.greetMeOneWay(System.getProperty("user.name"));
System.out.println("No response from server as method is OneWay");
System.out.println();
System.exit(0);
}
}

///////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.jms_greeter.server;
import java.util.logging.Logger;
import org.apache.cxf.jms_greeter.JMSGreeterPortType;
@javax.jws.WebService(portName = "GreeterPort", serviceName = "JMSGreeterService",
targetNamespace = "http://cxf.apache.org/jms_greeter",
endpointInterface = "org.apache.cxf.jms_greeter.JMSGreeterPortType",
wsdlLocation = "file:./wsdl/jms_greeter.wsdl")
public class GreeterJMSImpl implements JMSGreeterPortType {
private static final Logger LOG = Logger.getLogger(GreeterJMSImpl.class.getPackage().getName());
public void greetMeOneWay(String me) {
LOG.info("Executing operation greetMeOneWay");
System.out.println("Executing operation greetMeOneWay\n");
System.out.println("Hello there " + me);
}
}

///////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.jms_greeter.server;
import javax.xml.ws.Endpoint;
public class Server {
protected Server() throws Exception {
System.out.println("Starting Server");
Object implementor = new GreeterJMSImpl();
String address = "http://cxf.apache.org/transports/jms";
Endpoint.publish(address, implementor);
}
public static void main(String args[]) throws Exception {
new Server();
System.out.println("Server ready...");
Thread.sleep(125 * 60 * 1000);
System.out.println("Server exiting");
System.exit(0);
}
}

///////////////////////////////////////////////////////////////////////////
<?xml version="1.0" encoding="UTF-8"?>

<wsdl:definitions name="JMSGreeterService"
targetNamespace="http://cxf.apache.org/jms_greeter"
xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:jms="http://cxf.apache.org/transports/jms"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:tns="http://cxf.apache.org/jms_greeter"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:x1="http://cxf.apache.org/jms_greeter/types">
<wsdl:types>
<schema targetNamespace="http://cxf.apache.org/jms_greeter/types"
xmlns="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
<element name="greetMeOneWay">
<complexType>
<sequence>
<element name="requestType" type="xsd:string"/>
</sequence>
</complexType>
</element>
</schema>
</wsdl:types>

<wsdl:message name="greetMeOneWayRequest">
<wsdl:part element="x1:greetMeOneWay" name="in"/>
</wsdl:message>

<wsdl:portType name="JMSGreeterPortType">
<wsdl:operation name="greetMeOneWay">
<wsdl:input message="tns:greetMeOneWayRequest" name="greetMeOneWayRequest"/>
</wsdl:operation>
</wsdl:portType>

<wsdl:binding name="JMSGreeterPortBinding" type="tns:JMSGreeterPortType">
<soap:binding style="document" transport="http://cxf.apache.org/transport/jms"/>

<wsdl:operation name="greetMeOneWay">
<soap:operation soapaction="" style="document"/>
<wsdl:input name="greetMeOneWayRequest">
<soap:body use="literal"/>
</wsdl:input>
</wsdl:operation>
</wsdl:binding>

<wsdl:service name="JMSGreeterService">
<wsdl:port binding="tns:JMSGreeterPortBinding" name="GreeterPort">
<jms:address
destinationStyle="topic"
jndiConnectionFactoryName="ConnectionFactory"
jndiDestinationName="dynamicTopics/test.cxf.jmstransport.topic"
>

<jms:JMSNamingProperty name="java.naming.factory.initial" value="org.apache.activemq.jndi.ActiveMQInitialContextFactory"/>
<jms:JMSNamingProperty name="java.naming.provider.url" value="tcp://localhost:61616"/>

</jms:address>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
</source>

Java/Web Services SOA/MTOM

2010-06-01T07:27:43Z

Admin: 1 версия

== The capabilities and power of MTOM support of AXIS2: user can send a file to the service. ==



<source lang="java">

Sample: MTOM (Message Transmission Optimization Mechanism)
=========================================================
Introduction:
============
This sample demonstrates the capabilities and power of MTOM support of AXIS2. In this sample the
user can send a file to the service.
Prerequisites
=============
Apache Ant 1.6.2 or later

Running the Sample:
===================
1. Use ant generate.service or just the ant command alone in the Axis2_HOME/sample/mtom/ to build the service.
2. Generated service gets copied to the AXIS2_HOME/repository/services automatically.
3. Run the AXIS2_HOME/bin/axis2server.{sh/bat} to start the standalone axis2 server. (Alternatively
you can drop the sample into the services directory of a Axis2 server running in a servlet container)
4. Use ant generate.client to build the client.
5. Use ant run.client -Dfile "file to be sent" -Ddest "destination file name" to run the client.

Note
==============
Sometimes, if you"re having trouble running the client successfully,
It may be necessary to clean the services repository before you generate the service, deploy it
and run the client. (i.e. delete services created from previous samples.)
Help
====
Please contact axis-user list (axis-user@ws.apache.org) if you have any trouble running the sample.

</source>

Java/Web Services SOA/JAX WS Document Literal

2010-06-01T07:27:41Z

Admin: 1 версия

== JAX-WS: Doc-Literal From Java ==

== JAX-WS: Doc-Literal From WSDL ==

== JAX-WS: Doc-Literal String XML ==

== JAX-WS: Document Literal ==

== JAX-WS: Document-Literal String XML Based64 ==

Java/Web Services SOA/WS ReliableMessaging

2010-06-01T07:27:41Z

Admin: 1 версия

== This demo shows how WS-ReliableMessaging support in Apache CXF may be enabled ==



<source lang="java">

WS-RM Demo
==========
This demo shows how WS-ReliableMessaging support in Apache CXF may be enabled.
The client and server both use interceptor configuration to install the
WS-RM interceptors, comprising logical interceptors (RMInInterceptor/RMOutInterceptor)
responsible for managing the reliability properties of the current message, and a
protocol interceptor (RMSoapInterceptor) responsible for encoding/decoding
these properties as SOAP Headers.
As WS-RM is dependent on WS-Addressing, the configuration uses
the same approach as the ws_addressing sample to enable this
functionality. However, you may notice that the WS-Addressing
namespace URI is different in this case (i.e.
http://schemas.xmlsoap.org/ws/2004/08/addressing as opposed to
http://www.w3.org/2005/08/addressing). This is because the WS-RM
specification is still based on an older version of WS-Addressing.
Three additional interceptors are configured:
- LoggingInInterceptor used on both the client- and server-side to log the
inbound SOAP messages and display these to the console. Notice the usage of
out-of-band RM protocol messages (CreateSequence and CreateSequenceResponse)
and the WS-RM headers in application-level messages (Sequence,
SequenceAcknowledgement, AckRequested etc.)
- LoggingOutInterceptor used on both the client- and server-side to log the
outbound SOAP messages and display these to the console.
- MessageLossSimulator used only on the client-side to simulate message
loss by discarding every second application level message. This simulated
unreliability allows the retransmission of unacknowledged messages to be
observed.
This demo also illustrates usage of the decoupled HTTP transport, whereby
a separate server->client HTTP connection is used to deliver responses
to (application or RM protocol) requests and server side originated
standalone acknowlegments.
The "partial response" referred to in the log output is the payload of
the HTTP 202 Accepted response sent on the back-channel of the original
client->server connection.
In all other respects this demo is based on the basic hello_world sample,
illustrating that WS-Addressing usage is independent of the application.
One notable addition to the familiar hello_world WSDL is the usage
of the <wsaw:UsingAddressing> extension element to indicate the
WS-Addressing support is enabled for the service endpoint.
Please review the README in the samples directory before continuing.

Prerequisite
------------
If your environment already includes cxf-manifest-incubator.jar on the CLASSPATH,
and the JDK and ant bin directories on the PATH, it is not necessary to
run the environment script described in the samples directory README.
If your environment is not properly configured, or if you are planning
on using wsdl2java, javac, and java to build and run the demos, you must
set the environment by running the script.
Building and running the demo using ant
---------------------------------------
From the samples/ws_rm directory, the ant build script can be used to
build and run the demo. The server and client targets automatically build
the demo.
Using either UNIX or Windows:
ant server
ant client
On startup, the client makes a sequence of 4 oneway invocations.
The output of the logging interceptors will show that only the 1st and 3rd
reach their destination. Notice how after approximately 2 seconds the
messages that actually have arrived at the server will be acknowledged,
and how after approximately 4 seconds the client will resend the 2nd and 4th
application message. These will be acknowledged another 2 seconds
later so that there will be no further retransmissions from the client.
To remove the code generated from the WSDL file and the .class
files, run:
ant clean

Building the demo using wsdl2java and javac
-------------------------------------------
From the samples/ws_rm directory, first create the target directory
build/classes and then generate code from the WSDL file.
For UNIX:
mkdir -p build/classes
wsdl2java -d build/classes -compile ./wsdl/hello_world_rm.wsdl
For Windows:
mkdir build\classes
Must use back slashes.
wsdl2java -d build\classes -compile .\wsdl\hello_world_rm.wsdl
May use either forward or back slashes.
Now compile the provided client and server applications with the commands:
For UNIX:

export CLASSPATH=$CLASSPATH:$CXF_HOME/lib/celtix.jar:./build/classes
javac -d build/classes src/demo/ws_rm/common/*.java
javac -d build/classes src/demo/ws_rm/client/*.java
javac -d build/classes src/demo/ws_rm/server/*.java
For Windows:
set classpath=%classpath%;%CXF_HOME%\lib\celtix.jar;.\build\classes
javac -d build\classes src\demo\ws_rm\common\*.java
javac -d build\classes src\demo\ws_rm\client\*.java
javac -d build\classes src\demo\ws_rm\server\*.java
Running the demo using java
---------------------------
From the samples/ws_rm directory run the commands (entered on a single command line):
For UNIX (must use forward slashes):
java -Djava.util.logging.config.file=./logging.properties
demo.ws_rm.server.Server &
java -Djava.util.logging.config.file=./logging.properties
demo.ws_rm.client.Client ./wsdl/hello_world_rm.wsdl
The server process starts in the background.
For Windows (may use either forward or back slashes):
start
java -Djava.util.logging.config.file=.\logging.properties
demo.ws_rm.server.Server
java -Djava.util.logging.config.file=.\logging.properties
demo.ws_rm.client.Client .\wsdl\hello_world_rm.wsdl
The server process starts in a new command window.
After running the client, terminate the server process.
To remove the code generated from the WSDL file and the .class
files, either delete the build directory and its contents or run:
ant clean

//////////////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.ws_rm.client;
import java.lang.reflect.UndeclaredThrowableException;
import demo.ws_rm.rumon.MessageLossSimulator;
import org.apache.cxf.Bus;
import org.apache.cxf.bus.spring.SpringBusFactory;
import org.apache.cxf.hello_world_soap_http.Greeter;
import org.apache.cxf.hello_world_soap_http.GreeterService;

public final class Client {

private static final String USER_NAME = System.getProperty("user.name");
private Client() {
}
public static void main(String args[]) throws Exception {
try {

SpringBusFactory bf = new SpringBusFactory();
Bus bus = bf.createBus("ws_rm.xml");
bf.setDefaultBus(bus);
bus.getOutInterceptors().add(new MessageLossSimulator());

GreeterService service = new GreeterService();
Greeter port = service.getGreeterPort();
String[] names = new String[] {"Anne", "Bill", "Chris", "Daisy"};
// make a sequence of 4 invocations
for (int i = 0; i < 4; i++) {
System.out.println("Invoking greetMeOneWay...");
port.greetMeOneWay(names[i]);
System.out.println("No response as method is OneWay\n");
}
// allow aynchronous resends to occur
Thread.sleep(30 * 1000);
bus.shutdown(true);
} catch (UndeclaredThrowableException ex) {
ex.getUndeclaredThrowable().printStackTrace();
} catch (Exception ex) {
ex.printStackTrace();
} finally {
System.exit(0);
}
}
}

//////////////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demos.ws_rm.rumon;
import java.util.logging.LogRecord;
import java.util.logging.SimpleFormatter;
public class ConciseFormatter extends SimpleFormatter {
public synchronized String format(LogRecord record) {
String longForm = super.format(record);
String shortForm = longForm.indexOf("INFO: ") > 0
? longForm.substring(longForm.indexOf("INFO: ") + 6)
: longForm;
return shortForm;
}
}
//////////////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.ws_rm.rumon;
import java.io.IOException;
import java.io.OutputStream;
import java.math.BigInteger;
import java.util.ListIterator;
import java.util.logging.Level;
import java.util.logging.Logger;
import org.apache.cxf.interceptor.Fault;
import org.apache.cxf.interceptor.InterceptorChain;
import org.apache.cxf.interceptor.MessageSenderInterceptor;
import org.apache.cxf.io.AbstractWrappedOutputStream;
import org.apache.cxf.message.Message;
import org.apache.cxf.phase.AbstractPhaseInterceptor;
import org.apache.cxf.phase.Phase;
import org.apache.cxf.phase.PhaseInterceptor;
import org.apache.cxf.ws.addressing.AddressingProperties;
import org.apache.cxf.ws.rm.RMContextUtils;
/**
*
*/
public class MessageLossSimulator extends AbstractPhaseInterceptor<Message> {
private static final Logger LOG = Logger.getLogger(MessageLossSimulator.class.getName());
private int appMessageCount;

public MessageLossSimulator() {
super(Phase.PREPARE_SEND);
addBefore(MessageSenderInterceptor.class.getName());
}
/**
* Simulate loss of every second application message by replacing the stream normally
* provided by the transport (in the MessageSenderInterceptor)/
*/
public void handleMessage(Message message) throws Fault {
AddressingProperties maps =
RMContextUtils.retrieveMAPs(message, false, true);
RMContextUtils.ensureExposedVersion(maps);
String action = null;
if (maps != null && null != maps.getAction()) {
action = maps.getAction().getValue();
}
if (RMContextUtils.isRMProtocolMessage(action)) {
return;
}
appMessageCount++;
if (0 != (appMessageCount % 2)) {
return;
}

InterceptorChain chain = message.getInterceptorChain();
ListIterator it = chain.getIterator();
while (it.hasNext()) {
PhaseInterceptor pi = (PhaseInterceptor)it.next();
if (MessageSenderInterceptor.class.getName().equals(pi.getId())) {
chain.remove(pi);
LOG.fine("Removed MessageSenderInterceptor from interceptor chain.");
break;
}
}

message.setContent(OutputStream.class, new WrappedOutputStream(message));
}

private class WrappedOutputStream extends AbstractWrappedOutputStream {
private Message outMessage;
public WrappedOutputStream(Message m) {
this.outMessage = m;
}
@Override
protected void onFirstWrite() throws IOException {
if (LOG.isLoggable(Level.FINE)) {
BigInteger nr = RMContextUtils.retrieveRMProperties(outMessage, true)
.getSequence().getMessageNumber();
LOG.fine("Losing message " + nr);
}
wrappedStream = new DummyOutputStream();
}
}

private class DummyOutputStream extends OutputStream {
@Override
public void write(int b) throws IOException {
// TODO Auto-generated method stub

}

}

}

//////////////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.ws_rm.server;
import java.util.logging.Logger;
import org.apache.cxf.hello_world_soap_http.Greeter;
@javax.jws.WebService(serviceName = "GreeterService",
portName = "GreeterPort",
endpointInterface = "org.apache.cxf.hello_world_soap_http.Greeter",
wsdlLocation = "file:./wsdl/hello_world_rm.wsdl",
targetNamespace = "http://cxf.apache.org/hello_world_soap_http")

public class GreeterImpl implements Greeter {
private static final Logger LOG =
Logger.getLogger(GreeterImpl.class.getPackage().getName());

/* (non-Javadoc)
* @see org.apache.cxf.hello_world_soap_http.Greeter#greetMe(java.lang.String)
*/
public String greetMe(String me) {
LOG.info("Executing operation greetMe");
System.out.println("Executing operation greetMe");
System.out.println("Message received: " + me + "\n");
return "Hello " + me;
}

/* (non-Javadoc)
* @see org.apache.cxf.hello_world_soap_http.Greeter#greetMeOneWay(java.lang.String)
*/
public void greetMeOneWay(String me) {
LOG.info("Executing operation greetMeOneWay");
System.out.println("Executing operation greetMeOneWay\n");
System.out.println("Hello there " + me);
}
/* (non-Javadoc)
* @see org.apache.cxf.hello_world_soap_http.Greeter#sayHi()
*/
public String sayHi() {
LOG.info("Executing operation sayHi");
System.out.println("Executing operation sayHi\n");
return "Bonjour";
}
}
//////////////////////////////////////////////////////////////////////////////////

/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.ws_rm.server;
import javax.xml.ws.Endpoint;
import org.apache.cxf.Bus;
import org.apache.cxf.bus.spring.SpringBusFactory;
public class Server {
protected Server() throws Exception {
System.out.println("Starting Server");

Object implementor = new GreeterImpl();
String address = "http://localhost:9000/SoapContext/GreeterPort";
Endpoint e = Endpoint.publish(address, implementor);
}

public static void main(String args[]) throws Exception {
SpringBusFactory bf = new SpringBusFactory();
Bus bus = bf.createBus("ws_rm.xml");
bf.setDefaultBus(bus);
new Server();
System.out.println("Server ready...");

Thread.sleep(5 * 60 * 1000);

bus.shutdown(true);
System.out.println("Server exiting");
System.exit(0);
}
}

/////////////////////////////////////////////////////////////////////////////

<?xml version="1.0" encoding="UTF-8"?>

<wsdl:definitions name="HelloWorld" targetNamespace="http://cxf.apache.org/hello_world_soap_http"
xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:tns="http://cxf.apache.org/hello_world_soap_http"
xmlns:x1="http://cxf.apache.org/hello_world_soap_http/types"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<wsdl:types>
<schema targetNamespace="http://cxf.apache.org/hello_world_soap_http/types"
xmlns="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
<element name="sayHi">
<complexType/>
</element>
<element name="sayHiResponse">
<complexType>
<sequence>
<element name="responseType" type="xsd:string"/>
</sequence>
</complexType>
</element>
<element name="greetMe">
<complexType>
<sequence>
<element name="requestType" type="xsd:string"/>
</sequence>
</complexType>
</element>
<element name="greetMeResponse">
<complexType>
<sequence>
<element name="responseType" type="xsd:string"/>
</sequence>
</complexType>
</element>
<element name="greetMeOneWay">
<complexType>
<sequence>
<element name="requestType" type="xsd:string"/>
</sequence>
</complexType>
</element>
</schema>
</wsdl:types>
<wsdl:message name="sayHiRequest">
<wsdl:part element="x1:sayHi" name="in"/>
</wsdl:message>
<wsdl:message name="sayHiResponse">
<wsdl:part element="x1:sayHiResponse" name="out"/>
</wsdl:message>
<wsdl:message name="greetMeRequest">
<wsdl:part element="x1:greetMe" name="in"/>
</wsdl:message>
<wsdl:message name="greetMeResponse">
<wsdl:part element="x1:greetMeResponse" name="out"/>
</wsdl:message>
<wsdl:message name="greetMeOneWayRequest">
<wsdl:part element="x1:greetMeOneWay" name="in"/>
</wsdl:message>

<wsdl:portType name="Greeter">
<wsdl:operation name="sayHi">
<wsdl:input message="tns:sayHiRequest" name="sayHiRequest"/>
<wsdl:output message="tns:sayHiResponse" name="sayHiResponse"/>
</wsdl:operation>

<wsdl:operation name="greetMe">
<wsdl:input message="tns:greetMeRequest" name="greetMeRequest"/>
<wsdl:output message="tns:greetMeResponse" name="greetMeResponse"/>
</wsdl:operation>

<wsdl:operation name="greetMeOneWay">
<wsdl:input message="tns:greetMeOneWayRequest" name="greetMeOneWayRequest"/>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="Greeter_SOAPBinding" type="tns:Greeter">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>

<wsdl:operation name="sayHi">
<soap:operation soapAction="" style="document"/>
<wsdl:input name="sayHiRequest">
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output name="sayHiResponse">
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>

<wsdl:operation name="greetMe">
<soap:operation soapAction="" style="document"/>
<wsdl:input name="greetMeRequest">
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output name="greetMeResponse">
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>

<wsdl:operation name="greetMeOneWay">
<soap:operation soapAction="" style="document"/>
<wsdl:input name="greetMeOneWayRequest">
<soap:body use="literal"/>
</wsdl:input>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="GreeterService">
<wsdl:port binding="tns:Greeter_SOAPBinding" name="GreeterPort">
<soap:address location="http://localhost:9000/SoapContext/GreeterPort"/>
<wswa:UsingAddressing xmlns:wswa="http://www.w3.org/2005/02/addressing/wsdl"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>

</source>

Java/Web Services SOA/CXF XFire

2010-06-01T07:27:40Z

Admin: 1 версия

== MTOSI 1.1 Samples ==



<source lang="java">

MTOSI 1.1 Samples
=================
mtosi_1.1 contains the following subdirectories:
wsdl - contains the mtosi 1.1 wsdls
xsd - contains the mtosi 1.1 schemas
alarm_retrieval - contains a simple sample implementation of the
alarm_retrieval mtosi interface. Please refer to
the alarm_retrieval/README.txt for instructions to
run that demo.
code_gen - contains targets for generating code for mtosi
interfaces which do not have a sample implementation

Going beyond the basic sample
=============================
You can use the alarm_retrieval demo as a template for implementing
any of the other mtosi interfaces. The code_gen directory
demonstrates the wsdl2java targets needed to generate code for the
remaining mtosi interfaces.

</source>



== This demo illustrates the use of the JAX-WS APIs to run a simple client against a standalone server using SOAP 1.1 over HTTP ==



<source lang="java">

Hello World Demo using Document/Literal Style
=============================================
This demo illustrates the use of the JAX-WS APIs to run a simple
client against a standalone server using SOAP 1.1 over HTTP.
It also shows how CXF configuration can be used to enable schema validation
on the client and/or server side: By default the message parameters would not
be validated, but the presence of the cxf.xml configuration file on
the classpath, and its content change this default behavior:
The configuration file specifies that
a) if a JAX-WS client proxy is created for port {http://apache.org/hello_world_soap_http}SoapPort
it should have schema validation enabled.
b) if a JAX-WS server endpoint is created for port {http://apache.org/hello_world_soap_http}SoapPort
it should have schema validation enabled.
The client"s second greetMe invocation causes an exception (a marshalling
error) on the client side, i.e. before the request with the invalid parameter
goes on the wire.
After commenting the definition of the <jaxws:client> element in cxf.xml you
will notice that the client"s second greetMe invocation still throws an exception,
but that this time the exception is caused by an unmarshalling error on the
server side.
Commenting both elements, or renaming/removing the cfg.xml file, and thus
restoring the default behavior, results in the second greetMe invocation
not causing an exception.
Please review the README in the samples directory before continuing.

Prerequisite
------------
If your environment already includes cxf-manifest-incubator.jar on the
CLASSPATH, and the JDK and ant bin directories on the PATH
it is not necessary to set the environment as described in
the samples directory README. If your environment is not
properly configured, or if you are planning on using wsdl2java,
javac, and java to build and run the demos, you must set the
environment.

Building and running the demo using ant
---------------------------------------
From the samples/hello_world directory, the ant build script
can be used to build and run the demo.
Using either UNIX or Windows:
ant build
ant server
ant client

To remove the code generated from the WSDL file and the .class
files, run:
ant clean

Building the demo using wsdl2java and javac
-------------------------------------------
From the samples/hello_world directory, first create the target
directory build/classes and then generate code from the WSDL file.
For UNIX:
mkdir -p build/classes
wsdl2java -d build/classes -compile ./wsdl/hello_world.wsdl
For Windows:
mkdir build\classes
Must use back slashes.
wsdl2java -d build\classes -compile .\wsdl\hello_world.wsdl
May use either forward or back slashes.
Now compile the provided client and server applications with the commands:
For UNIX:

export CLASSPATH=$CLASSPATH:$CXF_HOME/lib/cxf-manifest-incubator.jar:./build/classes
javac -d build/classes src/demo/hw/client/*.java
javac -d build/classes src/demo/hw/server/*.java
For Windows:
set classpath=%classpath%;%CXF_HOME%\lib\cxf-manifest-incubator.jar;.\build\classes
javac -d build\classes src\demo\hw\client\*.java
javac -d build\classes src\demo\hw\server\*.java

Running the demo using java
---------------------------
From the samples/hello_world directory run the commands, entered on a
single command line:
For UNIX (must use forward slashes):
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.hw.server.Server &
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.hw.client.Client ./wsdl/hello_world.wsdl
The server process starts in the background. After running the client,
use the kill command to terminate the server process.
For Windows (may use either forward or back slashes):
start
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.hw.server.Server
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.hw.client.Client .\wsdl\hello_world.wsdl
A new command windows opens for the server process. After running the
client, terminate the server process by issuing Ctrl-C in its command window.
To remove the code generated from the WSDL file and the .class
files, either delete the build directory and its contents or run:
ant clean

Building and running the demo in a servlet container
----------------------------------------------------
From the samples/hello_world directory, the ant build script
can be used to create the war file that is deployed into the
servlet container.
Build the war file with the command:
ant war

Preparing deploy to APACHE TOMCAT
* set CATALINA_HOME environment to your TOMCAT home directory

Deploy the application into APACHE TOMCAT with the commond:
[NOTE] This step will check if the cxf jars present in Tomcat,
if not, it will automatically copy all the jars into CATALINA_HOME/shared/lib

ant deploy -Dtomcat=true
The servlet container will extract the war and deploy the application.

Using ant, run the client application with the command:
ant client-servlet -Dbase.url=http://localhost:#
Where # is the TCP/IP port used by the servlet container,
e.g., 8080.
Or
ant client-servlet -Dhost=localhost -Dport=8080
You can ignore the -Dhost and -Dport if your tomcat setup is same, i.e ant client-servlet
Using java, run the client application with the command:
For UNIX:

java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.hw.client.Client http://localhost:#/helloworld/services/hello_world?wsdl
For Windows:
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.hw.client.Client http://localhost:#/helloworld/services/hello_world?wsdl
Where # is the TCP/IP port used by the servlet container,
e.g., 8080.
Undeploy the application from the APACHE TOMCAT with the command:
ant undeploy -Dtomcat=true

Running demo with HTTP GET
----------------------------------------------------
APACHE CXF support HTTP GET to invoke the service, instead of running
ant client
you can use
ant client.get
to invoke the service with simple HttpURLConnection, or you can even
use your favoriate browser to get the results back.
/////////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.hw.client;
import java.io.File;
import java.net.URL;
import javax.xml.namespace.QName;
import javax.xml.ws.WebServiceException;
import org.apache.hello_world_soap_http.Greeter;
import org.apache.hello_world_soap_http.PingMeFault;
import org.apache.hello_world_soap_http.SOAPService;
import org.apache.hello_world_soap_http.types.FaultDetail;
public final class Client {
private static final QName SERVICE_NAME
= new QName("http://apache.org/hello_world_soap_http", "SOAPService");

private Client() {
}
public static void main(String args[]) throws Exception {

if (args.length == 0) {
System.out.println("please specify wsdl");
System.exit(1);
}
URL wsdlURL;
File wsdlFile = new File(args[0]);
if (wsdlFile.exists()) {
wsdlURL = wsdlFile.toURL();
} else {
wsdlURL = new URL(args[0]);
}

System.out.println(wsdlURL);
SOAPService ss = new SOAPService(wsdlURL, SERVICE_NAME);
Greeter port = ss.getSoapPort();
String resp;
System.out.println("Invoking sayHi...");
resp = port.sayHi();
System.out.println("Server responded with: " + resp);
System.out.println();
System.out.println("Invoking greetMe...");
resp = port.greetMe(System.getProperty("user.name"));
System.out.println("Server responded with: " + resp);
System.out.println();
System.out.println("Invoking greetMe with invalid length string, expecting exception...");
try {
resp = port.greetMe("Invoking greetMe with invalid length string, expecting exception...");
} catch (WebServiceException ex) {
System.out.println("Caught expected WebServiceException:");
System.out.println(" " + ex.getMessage());
}
System.out.println();
System.out.println("Invoking greetMeOneWay...");
port.greetMeOneWay(System.getProperty("user.name"));
System.out.println("No response from server as method is OneWay");
System.out.println();
try {
System.out.println("Invoking pingMe, expecting exception...");
port.pingMe();
} catch (PingMeFault ex) {
System.out.println("Expected exception: PingMeFault has occurred: " + ex.getMessage());
FaultDetail detail = ex.getFaultInfo();
System.out.println("FaultDetail major:" + detail.getMajor());
System.out.println("FaultDetail minor:" + detail.getMinor());
}
System.exit(0);
}
}
/////////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.hw.client;
import java.io.ByteArrayOutputStream;
import java.io.InputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Properties;
import javax.xml.transform.OutputKeys;
import javax.xml.transform.Source;
import javax.xml.transform.Transformer;
import javax.xml.transform.TransformerFactory;
import javax.xml.transform.stream.StreamResult;
import javax.xml.transform.stream.StreamSource;
public final class Get {
private Get() {
}
public static void main(String args[]) throws Exception {
// Sent HTTP GET request to invoke sayHi
String target = "http://localhost:9000/SoapContext/SoapPort/sayHi";
URL url = new URL(target);
HttpURLConnection httpConnection = (HttpURLConnection) url.openConnection();
httpConnection.connect();
System.out.println("Invoking server through HTTP GET to invoke sayHi");
InputStream in = httpConnection.getInputStream();
StreamSource source = new StreamSource(in);
printSource(source);
// Sent HTTP GET request to invoke greetMe FAULT
target = "http://localhost:9000/SoapContext/SoapPort/greetMe/me/CXF";
url = new URL(target);
httpConnection = (HttpURLConnection) url.openConnection();
httpConnection.connect();
System.out.println("Invoking server through HTTP GET to invoke greetMe");
try {
in = httpConnection.getInputStream();
source = new StreamSource(in);
printSource(source);
} catch (Exception e) {
System.err.println("GreetMe Fault: " + e.getMessage());
}
InputStream err = httpConnection.getErrorStream();
source = new StreamSource(err);
printSource(source);
// Sent HTTP GET request to invoke greetMe
target = "http://localhost:9000/SoapContext/SoapPort/greetMe/requestType/CXF";
url = new URL(target);
httpConnection = (HttpURLConnection) url.openConnection();
httpConnection.connect();
System.out.println("Invoking server through HTTP GET to invoke greetMe");
in = httpConnection.getInputStream();
source = new StreamSource(in);
printSource(source);
// Sent HTTP GET request to invoke pingMe
target = "http://localhost:9000/SoapContext/SoapPort/pingMe";
url = new URL(target);
httpConnection = (HttpURLConnection) url.openConnection();
httpConnection.connect();
System.out.println("Invoking server through HTTP GET to invoke pingMe");
try {
in = httpConnection.getInputStream();
} catch (Exception e) {
System.out.println("PingMe fault raised");
}
err = httpConnection.getErrorStream();
source = new StreamSource(err);
printSource(source);
}
private static void printSource(Source source) {
try {
ByteArrayOutputStream bos = new ByteArrayOutputStream();
StreamResult sr = new StreamResult(bos);
Transformer trans = TransformerFactory.newInstance().newTransformer();
Properties oprops = new Properties();
oprops.put(OutputKeys.OMIT_XML_DECLARATION, "yes");
trans.setOutputProperties(oprops);
trans.transform(source, sr);
System.out.println();
System.out.println("**** Response ******");
System.out.println();
System.out.println(bos.toString());
bos.close();
System.out.println();
} catch (Exception e) {
e.printStackTrace();
}
}
}
/////////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.hw.server;
import java.util.logging.Logger;
import org.apache.hello_world_soap_http.Greeter;
import org.apache.hello_world_soap_http.PingMeFault;
import org.apache.hello_world_soap_http.types.FaultDetail;
@javax.jws.WebService(portName = "SoapPort", serviceName = "SOAPService",
targetNamespace = "http://apache.org/hello_world_soap_http",
endpointInterface = "org.apache.hello_world_soap_http.Greeter")

public class GreeterImpl implements Greeter {
private static final Logger LOG =
Logger.getLogger(GreeterImpl.class.getPackage().getName());

/* (non-Javadoc)
* @see org.apache.hello_world_soap_http.Greeter#greetMe(java.lang.String)
*/
public String greetMe(String me) {
LOG.info("Executing operation greetMe");
System.out.println("Executing operation greetMe");
System.out.println("Message received: " + me + "\n");
return "Hello " + me;
}

/* (non-Javadoc)
* @see org.apache.hello_world_soap_http.Greeter#greetMeOneWay(java.lang.String)
*/
public void greetMeOneWay(String me) {
LOG.info("Executing operation greetMeOneWay");
System.out.println("Executing operation greetMeOneWay\n");
System.out.println("Hello there " + me);
}
/* (non-Javadoc)
* @see org.apache.hello_world_soap_http.Greeter#sayHi()
*/
public String sayHi() {
LOG.info("Executing operation sayHi");
System.out.println("Executing operation sayHi\n");
return "Bonjour";
}

public void pingMe() throws PingMeFault {
FaultDetail faultDetail = new FaultDetail();
faultDetail.setMajor((short)2);
faultDetail.setMinor((short)1);
LOG.info("Executing operation pingMe, throwing PingMeFault exception");
System.out.println("Executing operation pingMe, throwing PingMeFault exception\n");
throw new PingMeFault("PingMeFault raised by server", faultDetail);
}

}
/////////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.hw.server;
import javax.xml.ws.Endpoint;
public class Server {
protected Server() throws Exception {
System.out.println("Starting Server");
Object implementor = new GreeterImpl();
String address = "http://localhost:9000/SoapContext/SoapPort";
Endpoint.publish(address, implementor);
}
public static void main(String args[]) throws Exception {
new Server();
System.out.println("Server ready...");
Thread.sleep(5 * 60 * 1000);
System.out.println("Server exiting");
System.exit(0);
}
}
/////////////////////////////////////////////////////////////////////////////
<?xml version="1.0" encoding="UTF-8"?>

<wsdl:definitions name="HelloWorld" targetNamespace="http://apache.org/hello_world_soap_http"
xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:tns="http://apache.org/hello_world_soap_http"
xmlns:x1="http://apache.org/hello_world_soap_http/types"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<wsdl:types>
<schema targetNamespace="http://apache.org/hello_world_soap_http/types"
xmlns="http://www.w3.org/2001/XMLSchema"
xmlns:tns="http://apache.org/hello_world_soap_http/types"
elementFormDefault="qualified">
<simpleType name="MyStringType">
<restriction base="string">
<maxLength value="30" />
</restriction>
</simpleType>
<element name="sayHi">
<complexType/>
</element>
<element name="sayHiResponse">
<complexType>
<sequence>
<element name="responseType" type="string"/>
</sequence>
</complexType>
</element>
<element name="greetMe">
<complexType>
<sequence>
<element name="requestType" type="tns:MyStringType"/>
</sequence>
</complexType>
</element>
<element name="greetMeResponse">
<complexType>
<sequence>
<element name="responseType" type="string"/>
</sequence>
</complexType>
</element>
<element name="greetMeOneWay">
<complexType>
<sequence>
<element name="requestType" type="string"/>
</sequence>
</complexType>
</element>
<element name="pingMe">
<complexType/>
</element>
<element name="pingMeResponse">
<complexType/>
</element>
<element name="faultDetail">
<complexType>
<sequence>
<element name="minor" type="short"/>
<element name="major" type="short"/>
</sequence>
</complexType>
</element>
</schema>
</wsdl:types>
<wsdl:message name="sayHiRequest">
<wsdl:part element="x1:sayHi" name="in"/>
</wsdl:message>
<wsdl:message name="sayHiResponse">
<wsdl:part element="x1:sayHiResponse" name="out"/>
</wsdl:message>
<wsdl:message name="greetMeRequest">
<wsdl:part element="x1:greetMe" name="in"/>
</wsdl:message>
<wsdl:message name="greetMeResponse">
<wsdl:part element="x1:greetMeResponse" name="out"/>
</wsdl:message>
<wsdl:message name="greetMeOneWayRequest">
<wsdl:part element="x1:greetMeOneWay" name="in"/>
</wsdl:message>
<wsdl:message name="pingMeRequest">
<wsdl:part name="in" element="x1:pingMe"/>
</wsdl:message>
<wsdl:message name="pingMeResponse">
<wsdl:part name="out" element="x1:pingMeResponse"/>
</wsdl:message>
<wsdl:message name="pingMeFault">
<wsdl:part name="faultDetail" element="x1:faultDetail"/>
</wsdl:message>

<wsdl:portType name="Greeter">
<wsdl:operation name="sayHi">
<wsdl:input message="tns:sayHiRequest" name="sayHiRequest"/>
<wsdl:output message="tns:sayHiResponse" name="sayHiResponse"/>
</wsdl:operation>

<wsdl:operation name="greetMe">
<wsdl:input message="tns:greetMeRequest" name="greetMeRequest"/>
<wsdl:output message="tns:greetMeResponse" name="greetMeResponse"/>
</wsdl:operation>

<wsdl:operation name="greetMeOneWay">
<wsdl:input message="tns:greetMeOneWayRequest" name="greetMeOneWayRequest"/>
</wsdl:operation>
<wsdl:operation name="pingMe">
<wsdl:input name="pingMeRequest" message="tns:pingMeRequest"/>
<wsdl:output name="pingMeResponse" message="tns:pingMeResponse"/>
<wsdl:fault name="pingMeFault" message="tns:pingMeFault"/>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="Greeter_SOAPBinding" type="tns:Greeter">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>

<wsdl:operation name="sayHi">
<soap:operation soapAction="" style="document"/>
<wsdl:input name="sayHiRequest">
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output name="sayHiResponse">
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>

<wsdl:operation name="greetMe">
<soap:operation soapAction="" style="document"/>
<wsdl:input name="greetMeRequest">
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output name="greetMeResponse">
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>

<wsdl:operation name="greetMeOneWay">
<soap:operation soapAction="" style="document"/>
<wsdl:input name="greetMeOneWayRequest">
<soap:body use="literal"/>
</wsdl:input>
</wsdl:operation>
<wsdl:operation name="pingMe">
<soap:operation style="document"/>
<wsdl:input>
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body use="literal"/>
</wsdl:output>
<wsdl:fault name="pingMeFault">
<soap:fault name="pingMeFault" use="literal"/>
</wsdl:fault>
</wsdl:operation>

</wsdl:binding>
<wsdl:service name="SOAPService">
<wsdl:port binding="tns:Greeter_SOAPBinding" name="SoapPort">
<soap:address location="http://localhost:9000/SoapContext/SoapPort"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>

</source>



== This demo illustrates the use of the JAX-WS asynchronous invocation model ==



<source lang="java">

/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/

Hello World Asynchronous Demo using Document/Literal Style
==========================================================
This demo illustrates the use of the JAX-WS asynchronous
invocation model. Please refer to the JAX-WS 2.0 specification
(http://jcp.org/aboutJava/communityProcess/pfd/jsr224/index.html)
for background.
The asynchronous model allows the client thread to continue after
making a two-way invocation without being blocked while awaiting a
response from the server. Once the response is available, it is
delivered to the client application asynchronously using one
of two alternative approaches:
- Callback: the client application implements the
javax.xml.ws.AsyncHandler interface to accept notification
of the response availability
- Polling: the client application periodically polls a
javax.xml.ws.Response instance to check if the response
is available
This demo illustrates both approaches.
Additional methods are generated on the Service Endpoint
Interface (SEI) to provide this asynchrony, named by
convention with the suffix "Async".
As many applications will not require this functionality,
the asynchronous variants of the SEI methods are omitted
by default to avoid polluting the SEI with unnecessary
baggage. In order to enable generation of these methods,
a bindings file (wsdl/async_bindings.xml) is passed
to the wsdl2java generator.
Please review the README in the samples directory before
continuing.

Prerequisite
------------
If your environment already includes cxf-manifest-incubator.jar on the
CLASSPATH, and the JDK and ant bin directories on the PATH
it is not necessary to set the environment as described in
the samples directory README. If your environment is not
properly configured, or if you are planning on using wsdl2java,
javac, and java to build and run the demos, you must set the
environment.

Building and running the demo using ant
---------------------------------------
From the samples/hello_world_async directory, the ant build script
can be used to build and run the demo.
Using either UNIX or Windows:
ant build
ant server
ant client

To remove the code generated from the WSDL file and the .class
files, run:
ant clean

Building the demo using wsdl2java and javac
-------------------------------------------
From the samples/hello_world_async directory, run the following wsdl2java
command to generate classes required in the async case.
For UNIX:
mkdir -p build/classes
wsdl2java -d build/classes -b ./wsdl/async_binding.xml -compile ./wsdl/hello_world_async.wsdl
For Windows:
mkdir build\classes
Must use back slashes.
wsdl2java -d build\classes -b .\wsdl\async_binding.xml -compile .\wsdl\hello_world_async.wsdl
May use either forward or back slashes.
Now compile the provided client and server applications with the commands:
For UNIX:

export CLASSPATH=$CLASSPATH:$CXF_HOME/lib/cxf-manifest-incubator.jar:./build/classes
javac -d build/classes src/demo/hw/client/*.java
javac -d build/classes src/demo/hw/server/*.java
For Windows:
set classpath=%classpath%;%CXF_HOME%\lib\cxf-manifest-incubator.jar;.\build\classes
javac -d build\classes src\demo\hw\client\*.java
javac -d build\classes src\demo\hw\server\*.java

Running the demo using java
---------------------------
From the samples/hello_world_async directory run the commands, entered on a
single command line:
For UNIX (must use forward slashes):
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.hw.server.Server &
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.hw.client.Client ./wsdl/hello_world_async.wsdl
The server process starts in the background. After running the client,
use the kill command to terminate the server process.
For Windows (may use either forward or back slashes):
start
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.hw.server.Server
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.hw.client.Client .\wsdl\hello_world_async.wsdl
A new command windows opens for the server process. After running the
client, terminate the server process by issuing Ctrl-C in its command window.
To remove the code generated from the WSDL file and the .class
files, either delete the build directory and its contents or run:
ant clean

///////////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/

package demo.hw.client;
import java.io.File;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
import java.util.concurrent.Future;
import javax.xml.namespace.QName;
import javax.xml.ws.Response;
import org.apache.hello_world_async_soap_http.GreeterAsync;
import org.apache.hello_world_async_soap_http.SOAPService;
import org.apache.hello_world_async_soap_http.types.GreetMeSometimeResponse;
public final class Client {
private static final QName SERVICE_NAME
= new QName("http://apache.org/hello_world_async_soap_http", "SOAPService");

private Client() {
}
public static void main(String args[]) throws Exception {

if (args.length == 0) {
System.out.println("please specify wsdl");
System.exit(1);
}
File wsdl = new File(args[0]);

SOAPService ss = new SOAPService(wsdl.toURL(), SERVICE_NAME);
ExecutorService executor = Executors.newFixedThreadPool(5);
ss.setExecutor(executor);
GreeterAsync port = ss.getSoapPort();
String resp;

// callback method
TestAsyncHandler testAsyncHandler = new TestAsyncHandler();
System.out.println("Invoking greetMeSometimeAsync using callback object...");
Future<?> response = port.greetMeSometimeAsync(System.getProperty("user.name"), testAsyncHandler);
while (!response.isDone()) {
Thread.sleep(100);
}
resp = testAsyncHandler.getResponse();
System.out.println();
System.out.println("Server responded through callback with: " + resp);
System.out.println();

//polling method
System.out.println("Invoking greetMeSometimeAsync using polling...");
Response<GreetMeSometimeResponse> greetMeSomeTimeResp =
port.greetMeSometimeAsync(System.getProperty("user.name"));
while (!greetMeSomeTimeResp.isDone()) {
Thread.sleep(100);
}
GreetMeSometimeResponse reply = greetMeSomeTimeResp.get();
System.out.println("Server responded through polling with: " + reply.getResponseType());
System.exit(0);
}
}
///////////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.hw.client;
import javax.xml.ws.AsyncHandler;
import javax.xml.ws.Response;
import org.apache.hello_world_async_soap_http.types.GreetMeSometimeResponse;

public class TestAsyncHandler implements AsyncHandler<GreetMeSometimeResponse> {

private GreetMeSometimeResponse reply;
public void handleResponse(Response<GreetMeSometimeResponse> response) {
try {
System.err.println("handleResponse called");
reply = response.get();
} catch (Exception ex) {
ex.printStackTrace();
}
}

public String getResponse() {
return reply.getResponseType();
}

}
///////////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/

package demo.hw.server;
import java.util.concurrent.Future;
import java.util.logging.Logger;
import javax.jws.WebService;
import javax.xml.ws.AsyncHandler;
import javax.xml.ws.Response;
import org.apache.hello_world_async_soap_http.GreeterAsync;
import org.apache.hello_world_async_soap_http.types.GreetMeSometimeResponse;
@WebService(serviceName = "SOAPService",
portName = "SoapPort",
endpointInterface = "org.apache.hello_world_async_soap_http.GreeterAsync",
targetNamespace = "http://apache.org/hello_world_async_soap_http")

public class GreeterImpl implements GreeterAsync {
private static final Logger LOG =
Logger.getLogger(GreeterImpl.class.getPackage().getName());

/* (non-Javadoc)
* @see org.apache.hello_world_soap_http.Greeter#greetMeSometime(java.lang.String)
*/
public String greetMeSometime(String me) {
LOG.info("Executing operation greetMeSometime");
System.out.println("Executing operation greetMeSometime\n");
return "How are you " + me;
}

public Future<?> greetMeSometimeAsync(String requestType,
AsyncHandler<GreetMeSometimeResponse> asyncHandler) {
return null;
/*not called */
}

public Response<GreetMeSometimeResponse> greetMeSometimeAsync(String requestType) {
return null;
/*not called */
}

}
///////////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/

package demo.hw.server;
import javax.xml.ws.Endpoint;
public class Server {
protected Server() throws Exception {
System.out.println("Starting Server");
Object implementor = new GreeterImpl();
String address = "http://localhost:9000/SoapContext/SoapPort";
Endpoint.publish(address, implementor);
}

public static void main(String args[]) throws Exception {
new Server();
System.out.println("Server ready...");

Thread.sleep(5 * 60 * 1000);
System.out.println("Server exiting");
System.exit(0);
}
}
///////////////////////////////////////////////////////////////////////////////


<bindings
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
wsdlLocation="hello_world_async.wsdl"
xmlns="http://java.sun.ru/xml/ns/jaxws">
<bindings node="wsdl:definitions">
<enableAsyncMapping>true</enableAsyncMapping>
</bindings>
</bindings>
///////////////////////////////////////////////////////////////////////////////
<?xml version="1.0" encoding="UTF-8"?>

<wsdl:definitions xmlns="http://schemas.xmlsoap.org/wsdl/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://apache.org/hello_world_async_soap_http" xmlns:x1="http://apache.org/hello_world_async_soap_http/types" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" targetNamespace="http://apache.org/hello_world_async_soap_http" name="HelloWorld">
<wsdl:types>
<schema targetNamespace="http://apache.org/hello_world_async_soap_http/types" xmlns="http://www.w3.org/2001/XMLSchema" xmlns:x1="http://apache.org/hello_world_async_soap_http/types" elementFormDefault="qualified">
<element name="greetMeSometime">
<complexType>
<sequence>
<element name="requestType" type="xsd:string"/>
</sequence>
</complexType>
</element>
<element name="greetMeSometimeResponse">
<complexType>
<sequence>
<element name="responseType" type="xsd:string"/>
</sequence>
</complexType>
</element>
</schema>
</wsdl:types>
<wsdl:message name="greetMeSometimeRequest">
<wsdl:part name="in" element="x1:greetMeSometime"/>
</wsdl:message>
<wsdl:message name="greetMeSometimeResponse">
<wsdl:part name="out" element="x1:greetMeSometimeResponse"/>
</wsdl:message>
<wsdl:portType name="GreeterAsync">
<wsdl:operation name="greetMeSometime">
<wsdl:input name="greetMeSometimeRequest" message="tns:greetMeSometimeRequest"/>
<wsdl:output name="greetMeSometimeResponse" message="tns:greetMeSometimeResponse"/>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="GreeterAsync_SOAPBinding" type="tns:GreeterAsync">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="greetMeSometime">
<soap:operation style="document"/>
<wsdl:input>
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="SOAPService">
<wsdl:port name="SoapPort" binding="tns:GreeterAsync_SOAPBinding">
<soap:address location="http://localhost:9000/SoapContext/SoapPort"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
</source>



== This demo shows a client creating a callback object by passing an EndpointReferenceType to the server ==



<source lang="java">

/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/

Callback Demo
=============================================
This demo shows a client creating a callback object by
passing an EndpointReferenceType to the server. The
EndpointRefrenceType is then used by the server to call
back on the callback object
Please review the README in the samples directory before
continuing.

Prerequisite
------------
If your environment already includes cxf-manifest-incubator.jar on the
CLASSPATH, and the JDK and ant bin directories on the PATH
it is not necessary to set the environment as described in
the samples directory"s README. If your environment is not
properly configured, or if you are planning on using wsdl2java,
javac, and java to build and run the demos, you must set the
environment.

Building and running the demo using ant
---------------------------------------
From the samples/basic_callback directory, the ant build script
can be used to build and run the demo.
Using either UNIX or Windows:
ant build
ant server
ant client

To remove the code generated from the WSDL file and the .class
files, run:
ant clean

Building the demo using wsdl2java and javac
------------------------------------------
From the samples/basic_callback directory, first create the target
directory build/classes and then generate code from the WSDL file.
For UNIX:
mkdir -p build/classes
wsdl2java -d build/classes -compile ./wsdl/basic_callback.wsdl
For Windows:
mkdir build\classes
Must use back slashes.
wsdl2java -d build\classes -compile .\wsdl\basic_callback.wsdl
May use either forward or back slashes.
Now compile the provided client and server applications with the commands:
For UNIX:

export CLASSPATH=$CLASSPATH:$CXF_HOME/lib/cxf-manifest-incubator.jar:./build/classes
javac -d build/classes src/demo/callback/client/*.java
javac -d build/classes src/demo/callback/server/*.java
For Windows:
set classpath=%classpath%;%CXF_HOME%\lib\cxf-manifest-incubator.jar;.\build\classes
javac -d build\classes src\demo\callback\client\*.java
javac -d build\classes src\demo\callback\server\*.java

Running the demo using java
---------------------------
From the samples/basic_callback directory run the commands, entered on a
single command line:
For UNIX (must use forward slashes):
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.callback.server.Server &
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.callback.client.Client ./wsdl/basic_callback.wsdl
The server process starts in the background. After running the client,
use the kill command to terminate the server process.
For Windows (may use either forward or back slashes):
start
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.callback.server.Server
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.callback.client.Client .\wsdl\basic_callback.wsdl
A new command windows opens for the server process. After running the
client, terminate the server process by issuing Ctrl-C in its command window.
To remove the code generated from the WSDL file and the .class
files, either delete the build directory and its contents or run:
ant clean

////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/

package demo.callback.client;
import org.apache.callback.CallbackPortType;

@javax.jws.WebService(serviceName = "CallbackService",
portName = "CallbackPort",
endpointInterface = "org.apache.callback.CallbackPortType",
targetNamespace = "http://apache.org/callback")

public class CallbackImpl implements CallbackPortType {

/**
* serverSayHi
* @param: return_message (String)
* @return: String
*/
public String serverSayHi(String message) {
System.out.println("Callback object invoked");
System.out.println("Message recieved: " + message);
return new String("Hi " + message);
}

}

///////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/

package demo.callback.client;
import java.io.File;
import java.net.URL;
import javax.xml.namespace.QName;
import javax.xml.ws.Endpoint;
import org.apache.callback.SOAPService;
import org.apache.callback.ServerPortType;
import org.apache.cxf.ws.addressing.EndpointReferenceType;
import org.apache.cxf.wsdl.EndpointReferenceUtils;

public final class Client {
private static final QName SERVICE_NAME
= new QName("http://apache.org/callback", "SOAPService");
private static final QName SERVICE_NAME_CALLBACK
= new QName("http://apache.org/callback", "CallbackService");

private static final QName PORT_NAME_CALLBACK
= new QName("http://apache.org/callback", "CallbackPort");

private static final QName PORT_TYPE_CALLBACK
= new QName("http://apache.org/callback", "CallbackPortType");
private Client() {
}
public static void main(String args[]) throws Exception {

Object implementor = new CallbackImpl();
String address = "http://localhost:9005/CallbackContext/CallbackPort";
Endpoint.publish(address, implementor);

if (args.length == 0) {
System.out.println("please specify wsdl");
System.exit(1);
}
URL wsdlURL;
File wsdlFile = new File(args[0]);
if (wsdlFile.exists()) {
wsdlURL = wsdlFile.toURL();
} else {
wsdlURL = new URL(args[0]);
}

SOAPService ss = new SOAPService(wsdlURL, SERVICE_NAME);
ServerPortType port = ss.getSOAPPort();

EndpointReferenceType ref =
EndpointReferenceUtils.getEndpointReference(wsdlURL,
SERVICE_NAME_CALLBACK,
PORT_NAME_CALLBACK.getLocalPart());
EndpointReferenceUtils.setInterfaceName(ref, PORT_TYPE_CALLBACK);

String resp = port.registerCallback(ref);
System.out.println("Response from server: " + resp);

System.exit(0);
}
}
/////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/

package demo.callback.server;
import javax.xml.ws.Endpoint;
public class Server {
protected Server() throws Exception {
System.out.println("Starting Server");
Object implementor = new ServerImpl();
String address = "http://localhost:9000/SoapContext/SoapPort";
Endpoint.publish(address, implementor);
}
public static void main(String args[]) throws Exception {
new Server();
System.out.println("Server ready...");
Thread.sleep(5 * 60 * 1000);
System.out.println("Server exiting");
System.exit(0);
}
}

/////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.callback.server;
import java.net.URL;
import javax.xml.namespace.QName;
import javax.xml.ws.Service;
import org.apache.callback.CallbackPortType;
import org.apache.callback.ServerPortType;
import org.apache.cxf.jaxb.JAXBUtils;
import org.apache.cxf.ws.addressing.EndpointReferenceType;
import org.apache.cxf.wsdl.EndpointReferenceUtils;
import org.apache.cxf.wsdl.WSDLManager;
import org.apache.cxf.wsdl11.WSDLManagerImpl;

@javax.jws.WebService(serviceName = "SOAPService",
portName = "SOAPPort",
targetNamespace = "http://apache.org/callback",
endpointInterface = "org.apache.callback.ServerPortType")

public class ServerImpl implements ServerPortType {

public String registerCallback(EndpointReferenceType callback) {

try {
WSDLManager manager = new WSDLManagerImpl();

QName interfaceName = EndpointReferenceUtils.getInterfaceName(callback);
String wsdlLocation = EndpointReferenceUtils.getWSDLLocation(callback);
QName serviceName = EndpointReferenceUtils.getServiceName(callback);
String portString = EndpointReferenceUtils.getPortName(callback);

QName portName = new QName(serviceName.getNamespaceURI(), portString);

StringBuffer seiName = new StringBuffer();
seiName.append(JAXBUtils.namespaceURIToPackage(interfaceName.getNamespaceURI()));
seiName.append(".");
seiName.append(JAXBUtils.nameToIdentifier(interfaceName.getLocalPart(),
JAXBUtils.IdentifierType.INTERFACE));
System.out.println("the seiname is " + seiName.toString());
Class<?> sei = null;
try {
sei = Class.forName(seiName.toString(),
true, manager.getClass().getClassLoader());
} catch (ClassNotFoundException ex) {
ex.printStackTrace();
}

URL wsdlURL = new URL(wsdlLocation);

Service service = Service.create(wsdlURL, serviceName);
CallbackPortType port = (CallbackPortType)service.getPort(portName, sei);
System.out.println("Invoking on callback object");
String resp = port.serverSayHi(System.getProperty("user.name"));
System.out.println("Response from callback object: " + resp);

} catch (Exception ex) {
ex.printStackTrace();
return null;
}

return "registerCallback called";
}

}

///////////////////////////////////////////////////////////////////
<?xml version="1.0" encoding="UTF-8"?>

<wsdl:definitions name="basic_callback" targetNamespace="http://apache.org/callback"
xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:references="http://www.w3.org/2005/08/addressing"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:tns="http://apache.org/callback"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:jaxb="http://java.sun.ru/xml/ns/jaxb" jaxb:version="2.0">

<wsdl:types>
<schema targetNamespace="http://apache.org/callback"
xmlns="http://www.w3.org/2001/XMLSchema"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:jaxb="http://java.sun.ru/xml/ns/jaxb"
jaxb:version="2.0">
<xsd:import namespace="http://www.w3.org/2005/08/addressing" schemaLocation="/schemas/wsdl/ws-addr.xsd"/>
<element name="callback_message" type="xsd:string"/>
<element name="RegisterCallback" type="references:EndpointReferenceType"/>
<element name="returnType" type="xsd:string"/>
</schema>
</wsdl:types>
<wsdl:message name="server_sayHi">
<wsdl:part element="tns:callback_message" name="return_message"/>
</wsdl:message>
<wsdl:message name="register_callback">
<wsdl:part element="tns:RegisterCallback" name="callback_object"/>
</wsdl:message>
<wsdl:message name="returnMessage">
<wsdl:part element="tns:returnType" name="the_return"/>
</wsdl:message>
<wsdl:portType name="CallbackPortType">
<wsdl:operation name="ServerSayHi">
<wsdl:input message="tns:server_sayHi" name="ServerSayHiRequest"/>
<wsdl:output message="tns:returnMessage" name="ServerSayHiResponse"/>
</wsdl:operation>
</wsdl:portType>
<wsdl:portType name="ServerPortType">
<wsdl:operation name="RegisterCallback">
<wsdl:input message="tns:register_callback" name="RegisterCallbackRequest"/>
<wsdl:output message="tns:returnMessage" name="RegisterCallbackResponse"/>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="CallbackPortType_SOAPBinding" type="tns:CallbackPortType">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="ServerSayHi">
<soap:operation soapAction="" style="document"/>
<wsdl:input name="ServerSayHiRequest">
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output name="ServerSayHiResponse">
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:binding name="ServerPortType_SOAPBinding" type="tns:ServerPortType">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="RegisterCallback">
<soap:operation soapAction="" style="document"/>
<wsdl:input name="RegisterCallbackRequest">
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output name="RegisterCallbackResponse">
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="CallbackService">
<wsdl:port binding="tns:CallbackPortType_SOAPBinding" name="CallbackPort">
<soap:address location="http://localhost:9005/CallbackContext/CallbackPort"/>
</wsdl:port>
</wsdl:service>
<wsdl:service name="SOAPService">
<wsdl:port binding="tns:ServerPortType_SOAPBinding" name="SOAPPort">
<soap:address location="http://localhost:9000/SoapContext/SoapPort"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
</source>



== This demo shows how JAX-WS handlers are used ==



<source lang="java">

Handler Demo
============
This demo shows how JAX-WS handlers are used. The server uses a
SOAP protocol handler which logs incoming and outgoing messages
to the console.
The server code registers a handler using the @HandlerChain annotation
within the service implementation class. For this demo, LoggingHandler
is SOAPHandler that logs the entire SOAP message content to stdout.
The client includes a logical handler that checks the parameters on
outbound requests and short-circuits the invocation in certain
circumstances. This handler is specified programatically.
Please review the README in the samples directory before continuing.

Prerequisite
------------
If your environment already includes cxf-manifest-incubator.jar on the CLASSPATH,
and the JDK and ant bin directories on the PATH, it is not necessary to
set the environment as described in the samples directory"s README.
If your environment is not properly configured, or if you are planning
on using wsdl2java, javac, and java to build and run the demos, you must
set the environment.

Building and running the demo using ant
---------------------------------------
From the samples/handlers directory, the ant build script can be used to
build and run the demo. The server and client targets automatically build
the demo.
Using either UNIX or Windows:
ant server
ant client
When using these ant targets, the server process uses the LoggingHandler
and the client process uses the SmallNumberHandler. Notice that both
the client and server consoles display short informative messages. The
client handler examines the operation parameters and, based on the
parameter values, may decide not to forward the request to the server. The server
handler displays the entire content of each message in its console.
The @HandlerChain annotation in the implementation class indicates that
the file demo_handler.xml includes the information needed to identify the
handler class.
@HandlerChain(file = "../common/demo_handlers.xml", name = "DemoHandlerChain")
The client side SmallNumberHandler is specified programatically:
SmallNumberHandler sh = new SmallNumberHandler();
List<Handler> newHandlerChain = new ArrayList<Handler>();
newHandlerChain.add(sh);
((BindingProvider)port).getBinding().setHandlerChain(newHandlerChain);

After running the client, terminate the server process.
To remove the code generated from the WSDL file and the .class
files, run:
ant clean

Building the demo using wsdl2java and javac
-------------------------------------------
From the samples/handlers directory, first create the target directory
build/classes and then generate code from the WSDL file.
For UNIX:
mkdir -p build/classes
wsdl2java -d build/classes -compile ./wsdl/addNumbers.wsdl
For Windows:
mkdir build\classes
Must use back slashes.
wsdl2java -d build\classes -compile .\wsdl\addNumbers.wsdl
May use either forward or back slashes.
Now compile the provided client and server applications with the commands:
For UNIX:

export CLASSPATH=$CLASSPATH:$CXF_HOME/lib/cxf-manifest-incubator.jar:./build/classes
javac -d build/classes src/demo/handlers/common/*.java
javac -d build/classes src/demo/handlers/client/*.java
javac -d build/classes src/demo/handlers/server/*.java
For Windows:
set classpath=%classpath%;%CXF_HOME%\lib\cxf-manifest-incubator.jar;.\build\classes
javac -d build\classes src\demo\handlers\common\*.java
javac -d build\classes src\demo\handlers\client\*.java
javac -d build\classes src\demo\handlers\server\*.java
Finally, copy the demo_handlers.xml file from the src/demo/handlers/common
directory into the build/classes/demo/handlers/common directory.
For UNIX:
cp ./src/demo/handlers/common/demo_handlers.xml ./build/classes/demo/handlers/common
For Windows:
copy src\demo\handlers\common\demo_handlers.xml build\classes\demo\handlers\common

Running the demo using java
---------------------------
From the samples/handlers directory run the commands (entered on a single command line):
For UNIX (must use forward slashes):
java -Djava.util.logging.config.file=$CXF_HOME%/etc/logging.properties
demo.handlers.server.Server &
java -Djava.util.logging.config.file=$CXF_HOME%/etc/logging.properties
demo.handlers.client.Client ./wsdl/addNumbers.wsdl
The server process starts in the background.
For Windows (may use either forward or back slashes):
start
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.handlers.server.Server
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.handlers.client.Client .\wsdl\addNumbers.wsdl
The server process starts in a new command window.
After running the client, terminate the server process.
To remove the code generated from the WSDL file and the .class
files, either delete the build directory and its contents or run:
ant clean

</source>



== This demo shows how to develope an user interceptor and add the interceptor into the interceptor chain through configuration ==



<source lang="java">

Stream GZIP Interceptor Demo
============================
This demo shows how to develope an user interceptor and add
the interceptor into the interceptor chain through configuration.
Please review the README in the samples directory before
continuing.
Prerequisite
------------
If your environment already includes cxf-manifest-incubator.jar on the
CLASSPATH, and the JDK and ant bin directories on the PATH
it is not necessary to set the environment as described in
the samples directory README. If your environment is not
properly configured, or if you are planning on using wsdl2java,
javac, and java to build and run the demos, you must set the
environment.

Building and running the demo using ant
---------------------------------------
From the samples/streamInterceptor directory, the ant build script
can be used to build and run the demo.
Using either UNIX or Windows:
ant build
ant server
ant client

To remove the code generated from the WSDL file and the .class
files, run:
ant clean
Building the demo using wsdl2java and javac
-------------------------------------------
From the samples/streamInterceptor directory, first create the target
directory build/classes and then generate code from the WSDL file.
For UNIX:
mkdir -p build/classes
wsdl2java -d build/classes -compile ./wsdl/hello_world.wsdl
For Windows:
mkdir build\classes
Must use back slashes.
wsdl2java -d build\classes -compile .\wsdl\hello_world.wsdl
May use either forward or back slashes.
Now compile the provided client and server applications with the commands:
For UNIX:

export CLASSPATH=$CLASSPATH:$CXF_HOME/lib/cxf-manifest-incubator.jar:./build/classes
javac -d build/classes src/demo/stream/interceptor/*.java
javac -d build/classes src/demo/stream/client/*.java
javac -d build/classes src/demo/stream/server/*.java
For Windows:
set classpath=%classpath%;%CXF_HOME%\lib\cxf-manifest-incubator.jar;.\build\classes
javac -d build\classes src\demo\stream\interceptor\*.java
javac -d build\classes src\demo\stream\client\*.java
javac -d build\classes src\demo\stream\server\*.java

Running the demo using java
---------------------------
From the samples/streamInterceptor directory run the commands, entered on a
single command line:
For UNIX (must use forward slashes):
java -Dcxf.config.file=server.xml
demo.stream.server.Server &
java -Dcxf.config.file=client.xml
demo.stream.client.Client ./wsdl/hello_world.wsdl
The server process starts in the background. After running the client,
use the kill command to terminate the server process.
For Windows (may use either forward or back slashes):
start
java -Dcxf.config.file=server.xml
demo.stream.server.Server
java -Dcxf.config.file=client.xml
demo.stream.client.Client .\wsdl\hello_world.wsdl
A new command windows opens for the server process. After running the
client, terminate the server process by issuing Ctrl-C in its command window.
To remove the code generated from the WSDL file and the .class
files, either delete the build directory and its contents or run:
ant clean

</source>

Java/Web Services SOA/JiBX

2010-06-01T07:27:40Z

Admin: 1 версия

== Deploying a JiBX generated service ==



<source lang="java">

Axis2 Quick Start Guide- (JiBX)
======================================
Introduction
============
In this sample, we are deploying a JiBX generated service. The service
is tested using generated client stubs.
Pre-Requisites
==============
Apache Ant 1.6.2 or later
Building the Service
====================
Type "ant generate.service" from Axis2_HOME/samples/quickstartjibx
directory and then deploy the
Axis2_HOME/samples/quickstartjibx/build/service/build/lib/StockQuoteService.aar
Running the Client
==================
type ant run.client in the Axis2_HOME/samples/quickstartadb directory
Help
====
Please contact axis-user list (axis-user@ws.apache.org) if you
have any trouble running the sample.
</source>



== JiBX, AXIS2 web services 1 ==

== JiBX, AXIS2 web services 2 ==

== JiBX, AXIS2 web services 3 ==

== JiBX, AXIS2 web services: JiBX to WSDL ==

Java/Web Services SOA/JavaScript SOAP

2010-06-01T07:27:37Z

Admin: 1 версия

== Axis2 client API has facilities to accept responses in JSON ==



<source lang="java">

Sample for Yahoo - Search - JSON
=================================
Introduction
============
Axis2 client API has facilities to accept responses in JSON.
Yahoo provides an API to call its search service and retrieve JSON responses. This sample demonstrates how to call Yahoo
search service using an Axis2 client which accepts a JSON response.
Pre-Requisites
==============
Apache Ant 1.6.2 or later
Running The Sample
==================
Type "ant" from Axis2_HOME/samples/yahoojsonsearch directory.
Help
====
Please contact axis-user list (axis-user@ws.apache.org) if you have any trouble running the sample.

</source>



== The client demo demonstrates the use of (non-browser) JavaScript to call a CXF server ==



<source lang="java">

Hello World Client Demo using JavaScript
=========================================================
The client demo demonstrates the use of (non-browser)
JavaScript to call a CXF server.
The client side makes call by JAXWS. It uses the Mozilla Rhino library
to read the JavaScript file and run it.

Building and running the demo server using ant
---------------------------------------
From the samples/hello_world directory, the ant build script
can be used to build and run the demo.
Using either UNIX or Windows:
ant build
ant server (in the background or another window)
To remove the code generated from the WSDL file and the .class
files, run:
ant clean
Running the JavaScript client
-----------------------------
In another command line window, run the ant "client" target from
the build.xml file located in the same directory as this README.
Using either UNIX or Windows:
ant client
When running the client, you can terminate the server process by issuing
Ctrl-C in its command window.
The client will show this output:
invoke sayHi(). return Bonjour
invoke greetMe(String). return Hello Jeff
The same time, the server will give this output:
[java] Executing operation sayHi
[java] Executing operation greetMe
[java] Message received: Jeff

////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
importPackage(Packages.java.io);
importPackage(Packages.javax.xml.namespace);
importPackage(Packages.org.apache.hello_world_soap_http);
var qname=new Packages.javax.xml.namespace.QName("http://apache.org/hello_world_soap_http", "SOAPService");
var curpath=new File("..");
var sepa=File.separator;
var hwpath=curpath.getAbsolutePath()+sepa+"hello_world"+sepa+"wsdl"+sepa+"hello_world.wsdl";
var url = new File(hwpath).toURL();
var ss=new SOAPService(url,qname);
var port = ss.getSoapPort();
var resp=port.sayHi();
print("invoke sayHi(). return " + resp);
resp=port.greetMe("Jeff");
print("invoke greetMe(String). return " + resp);
</source>



== The demo demonstrates the use of the JavaScript and E4X dynamic languages to implement JAX-WS Providers ==



<source lang="java">

Hello World Demo using JavaScript and E4X Implementations
=========================================================
The demo demonstrates the use of the JavaScript and E4X dynamic
languages to implement JAX-WS Providers.
The client side makes two Dispatch-based invocations. The first uses
SOAPMessage data in MESSAGE mode, and the second uses DOMSource in
PAYLOAD mode. The first service is implemented using E4X, the second
using JavaScript.
The two messages are constructed by reading in the XML files found in
the demo/hwDispatch/client directory.
Please review the README in the samples directory before
continuing.

Prerequisite
------------
If your environment already includes cxf-manifest-incubator.jar on the
CLASSPATH, and the JDK and ant bin directories on the PATH
it is not necessary to set the environment as described in
the samples directory"s README. If your environment is not
properly configured, or if you are planning on using wsdl2java,
javac, and java to build and run the demos, you must set the
environment.

Building and running the demo using ant
---------------------------------------
From the samples/js_provider directory, the ant build script
can be used to build and run the demo.
Using either UNIX or Windows:
ant build
ant server (in the background or another window)
ant client

To remove the code generated from the WSDL file and the .class
files, run:
ant clean

Building the demo using wsdl2java and javac
-------------------------------------------
From the samples/dispatch_provider directory, first create the target
directory build/classes and then generate code from the WSDL file.
For UNIX:
mkdir -p build/classes
wsdl2java -d build/classes ./wsdl/hello_world.wsdl
For Windows:
mkdir build\classes
Must use back slashes.
wsdl2java -d build\classes .\wsdl\hello_world.wsdl
May use either forward or back slashes.
Now compile both the generated code and the provided client
application with the commands:
For UNIX:
export CLASSPATH=$CLASSPATH:$CXF_HOME/lib/cxf-manifest-incubator.jar:
$CXF_HOME/lib/js-1.6R5.jar:$CXF_HOME/lib/xbean-2.2.0.jar:
build/classes
javac -d build/classes src/demo/hwDispatch/client/*.java
For Windows:
set CLASSPATH=%CLASSPATH%;%CXF_HOME%\lib\cxf-manifest-incubator.jar;
%CXF_HOME%\lib\js-1.6R5.jar;%CXF_HOME%\lib\xbean-2.2.0.jar;
build\classes
javac -d build\classes src\demo\hwDispatch\client\*.java
Windows may use either forward or back slashes.
Since JavaScript and E4X are interpreted at runtime and do not require
compilation, there is no server-side java code requiring compilation.

Finally, copy resource files into the build/classes directory with the commands:
For UNIX:
cp ./src/demo/hwDispatch/client/*.xml ./build/classes/demo/hwDispatch/client
For Windows:
copy src\demo\hwDispatch\client\*.xml build\classes\demo\hwDispatch\client

Running the demo using java
---------------------------
From the samples/js_dispatch directory run the commands, entered on a
single command line:
For UNIX (must use forward slashes):
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
org.apache.cxf.js.rhino.ServerApp -v
-b http://localhost:9000/SoapContext impl.jsx impl.js
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.hwDispatch.client.Client ./wsdl/hello_world.wsdl
The server process starts in the background. After running the client,
use the kill command to terminate the server process.
For Windows (may use either forward or back slashes):
start
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
org.apache.cxf.js.rhino.ServerApp -v
-b http://localhost:9000/SoapContext impl.jsx impl.js
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.hwDispatch.client.Client .\wsdl\hello_world.wsdl
A new command windows opens for the server process. After running the
client, terminate the server process by issuing Ctrl-C in its command window.
To remove the code generated from the WSDL file and the .class
files, either delete the build directory and its contents or run:
ant clean

///////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.hwDispatch.client;
import java.io.File;
import java.io.InputStream;
import java.net.URL;
import javax.xml.namespace.QName;
import javax.xml.soap.MessageFactory;
import javax.xml.soap.SOAPMessage;
import javax.xml.transform.dom.DOMSource;
import javax.xml.ws.Dispatch;
import javax.xml.ws.Service.Mode;
import org.apache.hello_world_soap_http.SOAPService1;
import org.apache.hello_world_soap_http.SOAPService3;
public final class Client {
private Client() {
}
public static void main(String args[]) throws Exception {
if (args.length == 0) {
System.out.println("please specify wsdl");
System.exit(1);
}
URL wsdlURL;
File wsdlFile = new File(args[0]);
if (wsdlFile.exists()) {
wsdlURL = wsdlFile.toURL();
} else {
wsdlURL = new URL(args[0]);
}
MessageFactory factory = MessageFactory.newInstance();
System.out.println(wsdlURL + "\n\n");
final String ns = "http://apache.org/hello_world_soap_http";
QName serviceName1 = new QName(ns, "SOAPService1");
QName portName1 = new QName(ns, "SoapPort1");
SOAPService1 service1 = new SOAPService1(wsdlURL, serviceName1);
InputStream is1 = Client.class.getResourceAsStream("GreetMeDocLiteralReq1.xml");
SOAPMessage soapReq1 = factory.createMessage(null, is1);
Dispatch<SOAPMessage> dispSOAPMsg = service1.createDispatch(portName1,
SOAPMessage.class, Mode.MESSAGE);
System.out.println("Invoking server through Dispatch interface using SOAPMessage");
SOAPMessage soapResp = dispSOAPMsg.invoke(soapReq1);
System.out.println("Response from server: " + soapResp.getSOAPBody().getTextContent());
QName serviceName3 = new QName(ns, "SOAPService3");
QName portName3 = new QName(ns, "SoapPort3");
SOAPService3 service3 = new SOAPService3(wsdlURL, serviceName3);
InputStream is3 = Client.class.getResourceAsStream("GreetMeDocLiteralReq3.xml");
SOAPMessage soapReq3 = MessageFactory.newInstance().createMessage(null, is3);
DOMSource domReqPayload = new DOMSource(soapReq3.getSOAPBody().extractContentAsDocument());
Dispatch<DOMSource> dispDOMSrcPayload = service3.createDispatch(portName3,
DOMSource.class, Mode.PAYLOAD);
System.out.println("Invoking server through Dispatch interface using DOMSource in PAYLOAD Mode");
DOMSource domRespPayload = dispDOMSrcPayload.invoke(domReqPayload);
System.out.println("Response from server: "
+ domRespPayload.getNode().getFirstChild().getTextContent());
System.exit(0);
}
}

////////////////////////////////////////////////////////////////////////////////
<?xml version="1.0" encoding="UTF-8"?>

<wsdl:definitions name="HelloWorld" targetNamespace="http://apache.org/hello_world_soap_http"
xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:tns="http://apache.org/hello_world_soap_http"
xmlns:x1="http://apache.org/hello_world_soap_http/types"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<wsdl:types>
<schema targetNamespace="http://apache.org/hello_world_soap_http/types"
xmlns="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
<element name="sayHi">
<complexType/>
</element>
<element name="sayHiResponse">
<complexType>
<sequence>
<element name="responseType" type="xsd:string"/>
</sequence>
</complexType>
</element>
<element name="greetMe">
<complexType>
<sequence>
<element name="requestType" type="xsd:string"/>
</sequence>
</complexType>
</element>
<element name="greetMeResponse">
<complexType>
<sequence>
<element name="responseType" type="xsd:string"/>
</sequence>
</complexType>
</element>
<element name="greetMeOneWay">
<complexType>
<sequence>
<element name="requestType" type="xsd:string"/>
</sequence>
</complexType>
</element>
<element name="pingMe">
<complexType/>
</element>
<element name="pingMeResponse">
<complexType/>
</element>
<element name="faultDetail">
<complexType>
<sequence>
<element name="minor" type="xsd:short"/>
<element name="major" type="xsd:short"/>
</sequence>
</complexType>
</element>
</schema>
</wsdl:types>
<wsdl:message name="sayHiRequest">
<wsdl:part element="x1:sayHi" name="in"/>
</wsdl:message>
<wsdl:message name="sayHiResponse">
<wsdl:part element="x1:sayHiResponse" name="out"/>
</wsdl:message>
<wsdl:message name="greetMeRequest">
<wsdl:part element="x1:greetMe" name="in"/>
</wsdl:message>
<wsdl:message name="greetMeResponse">
<wsdl:part element="x1:greetMeResponse" name="out"/>
</wsdl:message>
<wsdl:message name="greetMeOneWayRequest">
<wsdl:part element="x1:greetMeOneWay" name="in"/>
</wsdl:message>

<wsdl:portType name="Greeter">
<wsdl:operation name="sayHi">
<wsdl:input message="tns:sayHiRequest" name="sayHiRequest"/>
<wsdl:output message="tns:sayHiResponse" name="sayHiResponse"/>
</wsdl:operation>

<wsdl:operation name="greetMe">
<wsdl:input message="tns:greetMeRequest" name="greetMeRequest"/>
<wsdl:output message="tns:greetMeResponse" name="greetMeResponse"/>
</wsdl:operation>

<wsdl:operation name="greetMeOneWay">
<wsdl:input message="tns:greetMeOneWayRequest" name="greetMeOneWayRequest"/>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="Greeter_SOAPBinding" type="tns:Greeter">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>

<wsdl:operation name="sayHi">
<soap:operation soapAction="" style="document"/>
<wsdl:input name="sayHiRequest">
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output name="sayHiResponse">
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>

<wsdl:operation name="greetMe">
<soap:operation soapAction="" style="document"/>
<wsdl:input name="greetMeRequest">
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output name="greetMeResponse">
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>

<wsdl:operation name="greetMeOneWay">
<soap:operation soapAction="" style="document"/>
<wsdl:input name="greetMeOneWayRequest">
<soap:body use="literal"/>
</wsdl:input>
</wsdl:operation>
</wsdl:binding>

<wsdl:service name="SOAPService1">
<wsdl:port binding="tns:Greeter_SOAPBinding" name="SoapPort1">
<soap:address location="http://localhost:9000/SoapContext/SoapPort1"/>
</wsdl:port>
</wsdl:service>
<wsdl:service name="SOAPService2">
<wsdl:port binding="tns:Greeter_SOAPBinding" name="SoapPort2">
<soap:address location="http://localhost:9000/SoapContext/SoapPort2"/>
</wsdl:port>
</wsdl:service>
<wsdl:service name="SOAPService3">
<wsdl:port binding="tns:Greeter_SOAPBinding" name="SoapPort3">
<soap:address location="http://localhost:9000/SoapContext/SoapPort3"/>
</wsdl:port>
</wsdl:service>

</wsdl:definitions>

</source>

Java/Web Services SOA/Spring

2010-06-01T07:27:36Z

Admin: 1 версия

== This example will lead you through creating your first service with Spring ==



<source lang="java">

Spring HTTP demo
=============================================
This example will lead you through creating your first service with
Spring. You"ll learn how to:
* Writing a simple JAX-WS "code-first" service
* Set up the HTTP servlet transport
* Use CXF"s Spring beans
For more information see the documentation for this example in the
user"s guide.

Prerequisite
------------
If your environment already includes cxf-manifest-incubator.jar on the
CLASSPATH, and the JDK and ant bin directories on the PATH
it is not necessary to set the environment as described in
the samples directory README. If your environment is not
properly configured, or if you are planning on using wsdl2java,
javac, and java to build and run the demos, you must set the
environment.

Building and running the demo using ant
---------------------------------------
From the samples/hello_world directory, the ant build script
can be used to build and run the demo.
Using either UNIX or Windows:
ant build
ant server
ant client

To remove the code generated from the WSDL file and the .class
files, run:
ant clean

</source>

Java/Web Services SOA/Code First

2010-06-01T07:27:36Z

Admin: 1 версия

== This demo illustrates how to develop a service use the "code first" approach using the JAX-WS APIs ==



<source lang="java">


Hello World Demo using Document/Literal Style
=============================================
This demo illustrates how to develop a service use the "code first"
approach using the JAX-WS APIs.
Prerequisite
------------
If your environment already includes cxf-manifest-incubator.jar on the
CLASSPATH, and the JDK and ant bin directories on the PATH
it is not necessary to set the environment as described in
the samples directory README. If your environment is not
properly configured, or if you are planning on using wsdl2java,
javac, and java to build and run the demos, you must set the
environment.

Building and running the demo using ant
---------------------------------------
From the samples/hello_world directory, the ant build script
can be used to build and run the demo.
Using either UNIX or Windows:
ant build
ant server
ant client

To remove the code generated from the WSDL file and the .class
files, run:
ant clean

Building the demo using wsdl2java and javac
-------------------------------------------
From the samples/hello_world directory, first create the target
directory build/classes and then generate code from the WSDL file.
For UNIX:
mkdir -p build/classes
wsdl2java -d build/classes -compile ./wsdl/hello_world.wsdl
For Windows:
mkdir build\classes
Must use back slashes.
wsdl2java -d build\classes -compile .\wsdl\hello_world.wsdl
May use either forward or back slashes.
Now compile the provided client and server applications with the commands:
For UNIX:

export CLASSPATH=$CLASSPATH:$CXF_HOME/lib/cxf-manifest-incubator.jar:./build/classes
javac -d build/classes src/demo/hw/client/*.java
javac -d build/classes src/demo/hw/server/*.java
For Windows:
set classpath=%classpath%;%CXF_HOME%\lib\cxf-manifest-incubator.jar;.\build\classes
javac -d build\classes src\demo\hw\client\*.java
javac -d build\classes src\demo\hw\server\*.java

Running the demo using java
---------------------------
From the samples/hello_world directory run the commands, entered on a
single command line:
For UNIX (must use forward slashes):
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.hw.server.Server &
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.hw.client.Client ./wsdl/hello_world.wsdl
The server process starts in the background. After running the client,
use the kill command to terminate the server process.
For Windows (may use either forward or back slashes):
start
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.hw.server.Server
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.hw.client.Client .\wsdl\hello_world.wsdl
A new command windows opens for the server process. After running the
client, terminate the server process by issuing Ctrl-C in its command window.
To remove the code generated from the WSDL file and the .class
files, either delete the build directory and its contents or run:
ant clean

Building and running the demo in a servlet container
----------------------------------------------------
From the samples/hello_world directory, the ant build script
can be used to create the war file that is deployed into the
servlet container.
Build the war file with the command:
ant war

Preparing deploy to APACHE TOMCAT
* set CATALINA_HOME environment to your TOMCAT home directory

Deploy the application into APACHE TOMCAT with the commond:
[NOTE] This step will check if the cxf jars present in Tomcat,
if not, it will automatically copy all the jars into CATALINA_HOME/shared/lib

ant deploy -Dtomcat=true
The servlet container will extract the war and deploy the application.

Using ant, run the client application with the command:
ant client-servlet -Dbase.url=http://localhost:#
Where # is the TCP/IP port used by the servlet container,
e.g., 8080.
Or
ant client-servlet -Dhost=localhost -Dport=8080
You can ignore the -Dhost and -Dport if your tomcat setup is same, i.e ant client-servlet
Using java, run the client application with the command:
For UNIX:

java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.hw.client.Client http://localhost:#/helloworld/services/hello_world?wsdl
For Windows:
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.hw.client.Client http://localhost:#/helloworld/services/hello_world?wsdl
Where # is the TCP/IP port used by the servlet container,
e.g., 8080.
Undeploy the application from the APACHE TOMCAT with the command:
ant undeploy -Dtomcat=true

Running demo with HTTP GET
----------------------------------------------------
APACHE CXF support HTTP GET to invoke the service, instead of running
ant client
you can use
ant client.get
to invoke the service with simple HttpURLConnection, or you can even
use your favoriate browser to get the results back.

////////////////////////////////////////////////////////////////////////
<?xml version="1.0" encoding="UTF-8"?>

<project name="hello world code first demo" default="build" basedir=".">
<import file="common_build.xml"/>

<target name="client" description="run demo client" depends="build">
<property name="param" value=""/>
<cxfrun classname="demo.hw.client.Client"
param1=""
param2="${op}"
param3="${param}"/>
</target>

<target name="server" description="run demo server" depends="build">
<cxfrun classname="demo.hw.server.Server"/>
</target>

<property name="cxf.war.file.name" value="helloworld"/>
<target name="war" depends="build">
<cxfwar wsdl="hello_world.wsdl" filename="${cxf.war.file.name}.war"/>
</target>
<target name="client-servlet" description="run demo client hitting servlet" depends="build">
<property name="param" value=""/>
<cxfrun classname="demo.hw.client.Client" param1="${base.url}/helloworld/services/hello_world?wsdl" param2="${op}" param3="${param}"/>
</target>
</project>

////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.hw.client;
import javax.xml.namespace.QName;
import javax.xml.ws.Service;
import javax.xml.ws.soap.SOAPBinding;
import demo.hw.server.HelloWorld;
public final class Client {
private static final QName SERVICE_NAME
= new QName("http://server.hw.demo/", "HelloWorld");
private static final QName PORT_NAME
= new QName("http://server.hw.demo/", "HelloWorldPort");

private Client() {
}
public static void main(String args[]) throws Exception {
Service service = Service.create(SERVICE_NAME);
// Endpoint Address
String endpointAddress = "http://localhost:9000/helloWorld";
// Add a port to the Service
service.addPort(PORT_NAME, SOAPBinding.SOAP11HTTP_BINDING, endpointAddress);

HelloWorld hw = service.getPort(HelloWorld.class);
System.out.println(hw.sayHi("World"));
}
}
////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
// START SNIPPET: service
package demo.hw.server;
import javax.jws.WebService;
@WebService
public interface HelloWorld {
String sayHi(String text);
}
// END SNIPPET: service

////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
// START SNIPPET: service
package demo.hw.server;
import javax.jws.WebService;
@WebService(endpointInterface = "demo.hw.server.HelloWorld",
serviceName = "HelloWorld")
public class HelloWorldImpl implements HelloWorld {
public String sayHi(String text) {
return "Hello " + text;
}
}
// END SNIPPET: service

////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.hw.server;
import javax.xml.ws.Endpoint;
public class Server {
protected Server() throws Exception {
// START SNIPPET: publish
System.out.println("Starting Server");
HelloWorldImpl implementor = new HelloWorldImpl();
String address = "http://localhost:9000/helloWorld";
Endpoint.publish(address, implementor);
// END SNIPPET: publish
}
public static void main(String args[]) throws Exception {
new Server();
System.out.println("Server ready...");
Thread.sleep(5 * 60 * 1000);
System.out.println("Server exiting");
System.exit(0);
}
}

</source>

Java/Web Services SOA/SOAP

2010-06-01T07:27:35Z

Admin: 1 версия

== A SOAP message with an attachment and XML-binary Optimized Packaging ==



<source lang="java">

MTOM Demo for SWA & XOP
=============================================
This demo illustrates the use of a SOAP message
with an attachment and XML-binary Optimized Packaging.
Please review the README in the samples directory before
continuing.

Prerequisite
------------
If your environment already includes cxf-manifest-incubator.jar on the
CLASSPATH, and the JDK and ant bin directories on the PATH
it is not necessary to set the environment as described in
the samples directory"s README. If your environment is not
properly configured, or if you are planning on using wsdl2java,
javac, and java to build and run the demos, you must set the
environment.

Building and running the demo using ant
---------------------------------------
From the samples/mtom directory, the ant build script
can be used to build and run the demo.
Using either UNIX or Windows:
ant build
ant server
ant client

To remove the code generated from the WSDL file and the .class
files, run:
ant clean

Building the demo using wsdl2java and javac
-------------------------------------------
From the samples/mtom directory, first create the target
directory build/classes and then generate code from the WSDL file.
For UNIX:
mkdir -p build/classes
wsdl2java -d build/classes -compile ./wsdl/mtom_xop.wsdl
For Windows:
mkdir build\classes
Must use back slashes.
wsdl2java -d build\classes -compile .\wsdl\mtom_xop.wsdl
May use either forward or back slashes.
Now compile the provided client and server applications with the commands:
For UNIX:

export CLASSPATH=$CLASSPATH:$CXF_HOME/lib/cxf-manifest-incubator.jar:./build/classes
javac -d build/classes src/demo/mtom/client/*.java
javac -d build/classes src/demo/mtom/server/*.java
cp src/demo/mtom/client/me.bmp build/classes/demo/mtom/client/me.bmp
For Windows:
set classpath=%classpath%;%CXF_HOME%\lib\cxf-manifest-incubator.jar;.\build\classes
javac -d build\classes src\demo\mtom\client\*.java
javac -d build\classes src\demo\mtom\server\*.java
copy src\demo\mtom\client\me.bmp build\classes\demo\mtom\client\me.bmp

Running the demo using java
---------------------------
From the samples/mtom directory run the following commands.
They are entered on a single command line.
For UNIX (must use forward slashes):
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.mtom.server.Server &
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.mtom.client.Client ./wsdl/mtom_xop.wsdl
The server process starts in the background. After running the client,
use the kill command to terminate the server process.
For Windows (may use either forward or back slashes):
start
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.mtom.server.Server
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.mtom.client.Client .\wsdl\mtom_xop.wsdl
A new command windows opens for the server process. After running the
client, terminate the server process by issuing Ctrl-C in its command window.
To remove the code generated from the WSDL file and the .class
files, either delete the build directory and its contents or run:
ant clean

Building and running the demo in a servlet container
----------------------------------------------------
From the samples/mtom directory, the ant build script
can be used to create the war file that is deployed into the
servlet container.
Build the war file with the command:
ant war

The war file will be included in the directory
samples/mtom/build/war. Simply copy the war file into
the servlet container"s deployment directory. For example,
with Tomcat copy the war file into the directory
<installationDirectory>/webapps. The servlet container will
extract the war and deploy the application.
Make sure already copy all jars from CXF_HOME/lib to
<TomcatInstallationDirectory>/shared/lib
Using ant, run the client application with the command:
ant client-servlet -Dbase.url=http://localhost:#
Where # is the TCP/IP port used by the servlet container,
e.g., 8080.
Using java, run the client application with the command:
For UNIX:

java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.mtom.client.Client http://localhost:#/mtom/services/mtom?wsdl
For Windows:
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.mtom.client.Client http://localhost:#/mtom/services/mtom?wsdl
Where # is the TCP/IP port used by the servlet container,
e.g., 8080.

//////////////////////////////////////////////////////////////////

/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.mtom.client;
import java.awt.Image;
import java.io.ByteArrayInputStream;
import java.io.File;
import java.io.FileInputStream;
import java.io.InputStream;
import java.net.URL;
import javax.activation.DataHandler;
import javax.imageio.ImageIO;
import javax.mail.util.ByteArrayDataSource;
import javax.xml.namespace.QName;
import javax.xml.ws.Binding;
import javax.xml.ws.BindingProvider;
import javax.xml.ws.Holder;
import javax.xml.ws.soap.SOAPBinding;
import org.apache.cxf.mime.TestMtom;
import org.apache.cxf.mime.TestMtomService;
public final class Client {
private static final QName SERVICE_NAME = new QName("http://cxf.apache.org/mime", "TestMtomService");
private static final QName PORT_NAME = new QName("http://cxf.apache.org/mime", "TestMtomPort");
private Client() {
}
public static void main(String args[]) throws Exception {
Client client = new Client();
if (args.length == 0) {
System.out.println("please specify wsdl");
System.exit(1);
}
URL wsdlURL;
File wsdlFile = new File(args[0]);
if (wsdlFile.exists()) {
wsdlURL = wsdlFile.toURL();
} else {
wsdlURL = new URL(args[0]);
}
System.out.println(wsdlURL);
TestMtomService tms = new TestMtomService(wsdlURL, SERVICE_NAME);
TestMtom port = (TestMtom) tms.getPort(PORT_NAME, TestMtom.class);
Binding binding = ((BindingProvider)port).getBinding();
((SOAPBinding)binding).setMTOMEnabled(true);
InputStream pre = client.getClass().getResourceAsStream("me.bmp");
long fileSize = 0;
for (int i = pre.read(); i != -1; i = pre.read()) {
fileSize++;
}
Holder<byte[]> param = new Holder<byte[]>();
param.value = new byte[(int) fileSize];
System.out.println("Start test without Mtom enable!");
System.out.println("Sending out the me.bmp Image content to server, data size is " + fileSize);
InputStream in = client.getClass().getResourceAsStream("me.bmp");
in.read(param.value);
Holder<String> name = new Holder<String>("call detail");
port.testXop(name, param);
System.out.println("received byte[] back from server, the size is " + param.value.length);
Image image = ImageIO.read(new ByteArrayInputStream(param.value));
System.out.println("build image with the returned byte[] back from server successfully, hashCode="
+ image.hashCode());
System.out.println("Successfully run demo without mtom enable");
System.out.println("Start test with Mtom enable!");
System.out.println("Sending out the me.bmp Image content to server, data size is " + fileSize);
Holder<DataHandler> handler = new Holder<DataHandler>();
byte[] data = new byte[(int) fileSize];
client.getClass().getResourceAsStream("me.bmp").read(data);
handler.value = new DataHandler(new ByteArrayDataSource(data, "application/octet-stream"));
port.testMtom(name, handler);
InputStream mtomIn = handler.value.getInputStream();
fileSize = 0;

for (int i = mtomIn.read(); i != -1; i = mtomIn.read()) {
fileSize++;
}
System.out.println("received DataHandler back from server, the size is " + fileSize);
System.out.println("Successfully run demo with mtom enable");
System.exit(0);
}
private static InputStream getResourceStream(File file) throws Exception {
InputStream in = new FileInputStream(file);
return in;
}
}

/////////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.mtom.server;
import javax.xml.ws.Binding;
import javax.xml.ws.Endpoint;
import javax.xml.ws.soap.SOAPBinding;
public class Server {
protected Server() throws Exception {
System.out.println("Starting Server");
Object implementor = new TestMtomImpl();
String address = "http://localhost:9000/mime-test";
Endpoint ep = Endpoint.publish(address, implementor);
Binding binding = ep.getBinding();
((SOAPBinding)binding).setMTOMEnabled(true);
}
public static void main(String args[]) throws Exception {
new Server();
System.out.println("Server ready...");
Thread.sleep(5 * 60 * 1000);
System.out.println("Server exiting");
System.exit(0);
}
}

/////////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.mtom.server;
import java.io.InputStream;
import javax.activation.DataHandler;
import javax.jws.WebService;
import javax.xml.ws.Holder;
import org.apache.cxf.mime.TestMtom;
@WebService(serviceName = "TestMtomService",
portName = "TestMtomPort",
endpointInterface = "org.apache.cxf.mime.TestMtom",
targetNamespace = "http://cxf.apache.org/mime")
public class TestMtomImpl implements TestMtom {

public void testXop(Holder<String> name, Holder<byte[]> attachinfo) {
System.out.println("Received image holder data from client");
System.out.println("The image holder data length is " + attachinfo.value.length);
name.value = "return detail + " + name.value;
}
public void testMtom(Holder<String> name, Holder<DataHandler> attachinfo) {
try {
System.out.println("Received image holder data with mtom enable from client");
InputStream mtomIn = attachinfo.value.getInputStream();
long fileSize = 0;
System.out.println("The image holder data length is " + mtomIn.available());
name.value = "return detail + " + name.value;
} catch (Exception e) {
e.printStackTrace();
}
}

}
/////////////////////////////////////////////////////////////////////////////
<?xml version="1.0" encoding="utf-8"?>

<wsdl:definitions name="SOAPBuilders-mime-cr-test" xmlns:types="http://cxf.apache.org/mime/types"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:tns="http://cxf.apache.org/mime"
xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/"
xmlns:xmime="http://www.w3.org/2005/05/xmlmime"
targetNamespace="http://cxf.apache.org/mime">
<wsdl:types>
<schema xmlns="http://www.w3.org/2001/XMLSchema" targetNamespace="http://cxf.apache.org/mime/types"
xmlns:xmime="http://www.w3.org/2005/05/xmlmime" elementFormDefault="qualified">
<complexType name="XopType">
<sequence>
<element name="name" type="xsd:string" />
<element name="attachinfo" type="xsd:base64Binary"/>
</sequence>
</complexType>
<element name="testXop" type="types:XopType" />
<element name="testXopResponse" type="types:XopType" />

<complexType name="MtomType">
<sequence>
<element name="name" type="xsd:string" />
<element name="attachinfo" type="xsd:base64Binary" xmime:expectedContentTypes="application/octet-stream"/>
</sequence>
</complexType>
<element name="testMtom" type="types:MtomType" />
<element name="testMtomResponse" type="types:MtomType" />
</schema>
</wsdl:types>

<wsdl:message name="testXopIn">
<wsdl:part name="data" element="types:testXop" />
</wsdl:message>
<wsdl:message name="testXopOut">
<wsdl:part name="data" element="types:testXopResponse" />
</wsdl:message>

<wsdl:message name="testMtomIn">
<wsdl:part name="data" element="types:testMtom" />
</wsdl:message>
<wsdl:message name="testMtomOut">
<wsdl:part name="data" element="types:testMtomResponse" />
</wsdl:message>

<wsdl:portType name="TestMtom">
<wsdl:operation name="testXop">
<wsdl:input message="tns:testXopIn" />
<wsdl:output message="tns:testXopOut" />
</wsdl:operation>
<wsdl:operation name="testMtom">
<wsdl:input message="tns:testMtomIn" />
<wsdl:output message="tns:testMtomOut" />
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="TestMtomBinding" type="tns:TestMtom">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http" />
<wsdl:operation name="testXop">
<soap:operation soapAction="" />
<wsdl:input>
<soap:body use="literal" />
</wsdl:input>
<wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="testMtom">
<soap:operation soapAction="" />
<wsdl:input>
<soap:body use="literal" />
</wsdl:input>
<wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="TestMtomService">
<wsdl:port name="TestMtomPort" binding="tns:TestMtomBinding">
<soap:address location="http://localhost:9000/mime-test" />
</wsdl:port>
</wsdl:service>
</wsdl:definitions>

</source>



== Demonstrates the capabilities and power of SOAP with Attachment support and the Attachment API of AXIS2 ==



<source lang="java">

Sample: SOAP with Attachments
================================
Introduction
============
This sample demonstrates the capabilities and power of SOAP with Attachment support and the
Attachment API of AXIS2. More information about Axis2 attachment implementation can be found at
http://ws.apache.org/axis2/1_1/mtom-guide.html.
This sample includes a service and a client which can be used to upload a file to the server using
SOAP message containing a SOAP with Attachment type binary attachment. The service is written and
deployed using the RCPMessageReceiver and a POJO(Plain Old Java Object). The POJO service class uses
the Attachment API of the MessageContext to retrieve the received attachment.The client program is
written using the OperationClient API of Axis2 together with the Attachment API of MessageContext.

Objectives
==========
* Writing a POJO (Plain Old Java Object) based service to access attachments.
* Implement a Axis2 OperationClient based Web Service client to invoke the service with SOAP
with Attachment type attachments.
* Invoke the deployed service.
Prerequisites
=============
Install Apache Ant 1.6.2 or later

Running the Sample:
===================
The files belonging to this sample are contained in the samples/soapwithattachments folder of the
extracted Axis2 binary distribution, which will be called here after as SWA_SAMPLE_DIR. The
location of the extracted binary distribution will be refered as AXIS2_DIST. There is a
"build.xml" Ant script in the SWA_SAMPLE_DIR that contains build targets for building the service
archive and running the client application - all described in steps below.
1. Generate the service
Use "ant generate.service" command in the SWA_SAMPLE_DIR to build the service. Generated service
will automatically gets copied in to the AXIS2_DIST/repository/services directory. Source file
ralating to this service can be found at
SWA_SAMPLE_DIR/src/sample/soapwithattachments/service/AttachmentService.java. The services.xml used
when building this service can be found at SWA_SAMPLE_DIR/resources directory.
2. Deploy the service
Run the AXIS2_DIST/bin/axis2server.{sh.bat} script to start the standalone axis2 server. This server
will deploy all the srvices available at AXIS2_DIST/repository/services directory. Alternatively you
can drop the sample-swa.aar service archive to the services directory of a running Axis2 servlet)
3. Running the client
Use "ant run.client -Dfile <file to be send> -Ddest <destination file name>" command in the
SWA_SAMPLE_DIR to build and run the client. Source file ralating to the client can be found at
SWA_SAMPLE_DIR/src/sample/soapwithattachments/client/SWAClient.java.
Help
====
Please contact axis-user list (axis-user@ws.apache.org) if you have any trouble running the sample.

</source>



== Hello World SOAP12 Demo using Document/Literal Style: the use of Apache CXF"s SOAP 1.2 capabilities ==



<source lang="java">

Hello World SOAP12 Demo using Document/Literal Style
====================================================
This demo shows the use of Apache CXF"s SOAP 1.2 capabilities.
Please review the README in the samples directory before
continuing.

Prerequisites
-------------
If your environment already includes cxf-manifest-incubator.jar on the
CLASSPATH, and the JDK and ant bin directories on the PATH
it is not necessary to set the environment as described in
the samples directory"s README. If your environment is not
properly configured, or if you are planning on using wsdl2java,
javac, and java to build and run the demos, you must set the
environment.

Building and running the demo using ant
---------------------------------------
From the samples/hello_world directory, the ant build script
can be used to build and run the demo.
Using either UNIX or Windows:
ant build
ant server
ant client

To remove the code generated from the WSDL file and the .class
files, run:
ant clean

Building the demo using wsdl2java and javac
-------------------------------------------
From the samples/hello_world directory, first create the target
directory build/classes and then generate code from the WSDL file.
For UNIX:
mkdir -p build/classes
wsdl2java -d build/classes -compile ./wsdl/hello_world_soap12.wsdl
For Windows:
mkdir build\classes
Must use back slashes.
wsdl2java -d build\classes -compile .\wsdl\hello_world_soap12.wsdl
May use either forward or back slashes.
Now compile the provided client and server applications with the commands:
For UNIX:

export CLASSPATH=$CLASSPATH:$CXF_HOME/lib/cxf-manifest-incubator.jar:./build/classes
javac -d build/classes src/demo/hw/client/*.java
javac -d build/classes src/demo/hw/server/*.java
For Windows:
set classpath=%classpath%;%CXF_HOME%\lib\cxf-manifest-incubator.jar;.\build\classes
javac -d build\classes src\demo\hw\client\*.java
javac -d build\classes src\demo\hw\server\*.java

Running the demo using java
---------------------------
From the samples/hello_world directory run the following commands.
They are entered on a single command line:
For UNIX (must use forward slashes):
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.hw.server.Server &
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.hw.client.Client ./wsdl/hello_world_soap12.wsdl
The server process starts in the background. After running the client,
use the kill command to terminate the server process.
For Windows (may use either forward or back slashes):
start
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.hw.server.Server
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.hw.client.Client .\wsdl\hello_world_soap12.wsdl
A new command windows opens for the server process. After running the
client, terminate the server process by issuing Ctrl-C in its command window.
To remove the code generated from the WSDL file and the .class
files, either delete the build directory and its contents or run:
ant clean

Building and running the demo in a servlet container
----------------------------------------------------
From the samples/hello_world directory, the ant build script
can be used to create the war file that is deployed into the
servlet container.
Build the war file with the command:
ant war

Preparing deploy to APACHE TOMCAT
* set CATALINA_HOME environment to your TOMCAT home directory

Deploy the application into APACHE TOMCAT with the commond:
[NOTE] This step will check if the cxf jars present in Tomcat,
if not, it will automatically copy all the jars into CATALINA_HOME/shared/lib

ant deploy -Dtomcat=true
The servlet container will extract the war and deploy the application.

Using ant, run the client application with the command:
ant client-servlet -Dbase.url=http://localhost:#
Where # is the TCP/IP port used by the servlet container,
e.g., 8080.
Or
ant client-servlet -Dhost=localhost -Dport=8080
You can ignore the -Dhost and -Dport if your tomcat setup is same, i.e ant client-servlet
Using java, run the client application with the command:
For UNIX:

java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.hw.client.Client http://localhost:#/helloworld/services/hello_world_soap12?wsdl
For Windows:
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.hw.client.Client http://localhost:#/helloworld/services/hello_world_soap12?wsdl
Where # is the TCP/IP port used by the servlet container,
e.g., 8080.
Undeploy the application from the APACHE TOMCAT with the command:
ant undeploy -Dtomcat=true

Running demo with HTTP GET
----------------------------------------------------
APACHE CXF support HTTP GET to invoke the service, instead of running
ant client
you can use
ant client.get
to invoke the service with simple HttpURLConnection, or you can even
use your favorite browser to get the results back.

////////////////////////////////////////////////////////////////////////////

/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.hw.client;
import java.io.File;
import java.net.URL;
import javax.xml.namespace.QName;
import javax.xml.ws.ProtocolException;
import org.apache.hello_world_soap12_http.Greeter;
import org.apache.hello_world_soap12_http.PingMeFault;
import org.apache.hello_world_soap12_http.SOAPService;
import org.apache.hello_world_soap12_http.types.FaultDetail;
public final class Client {
private static final QName SERVICE_NAME
= new QName("http://apache.org/hello_world_soap12_http", "SOAPService");

private Client() {
}
public static void main(String args[]) throws Exception {

if (args.length == 0) {
System.out.println("please specify wsdl");
System.exit(1);
}
URL wsdlURL;
File wsdlFile = new File(args[0]);
if (wsdlFile.exists()) {
wsdlURL = wsdlFile.toURL();
} else {
wsdlURL = new URL(args[0]);
}

System.out.println(wsdlURL);
SOAPService ss = new SOAPService(wsdlURL, SERVICE_NAME);
Greeter port = ss.getSoapPort();
String resp;
System.out.println("Invoking sayHi...");
resp = port.sayHi();
System.out.println("Server responded with: " + resp);
System.out.println();
System.out.println("Invoking greetMe...");
resp = port.greetMe(System.getProperty("user.name"));
System.out.println("Server responded with: " + resp);
System.out.println();
System.out.println("Invoking greetMe with invalid length string, expecting exception...");
try {
resp = port.greetMe("Invoking greetMe with invalid length string, expecting exception...");
} catch (ProtocolException e) {
System.out.println("Expected exception has occurred: " + e.getClass().getName());
}
System.out.println();
System.out.println("Invoking greetMeOneWay...");
port.greetMeOneWay(System.getProperty("user.name"));
System.out.println("No response from server as method is OneWay");
System.out.println();
try {
System.out.println("Invoking pingMe, expecting exception...");
port.pingMe();
} catch (PingMeFault ex) {
System.out.println("Expected exception: PingMeFault has occurred: " + ex.getMessage());
FaultDetail detail = ex.getFaultInfo();
System.out.println("FaultDetail major:" + detail.getMajor());
System.out.println("FaultDetail minor:" + detail.getMinor());
}
System.exit(0);
}
}

/////////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.hw.client;
import java.io.ByteArrayOutputStream;
import java.io.InputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Properties;
import javax.xml.transform.OutputKeys;
import javax.xml.transform.Source;
import javax.xml.transform.Transformer;
import javax.xml.transform.TransformerFactory;
import javax.xml.transform.stream.StreamResult;
import javax.xml.transform.stream.StreamSource;
public final class Get {
private Get() {
}
public static void main(String args[]) throws Exception {
// Sent HTTP GET request to invoke sayHi
String target = "http://localhost:9000/SoapContext/SoapPort/sayHi";
URL url = new URL(target);
HttpURLConnection httpConnection = (HttpURLConnection) url.openConnection();
httpConnection.connect();
System.out.println("Invoking server through HTTP GET to invoke sayHi");
InputStream in = httpConnection.getInputStream();
StreamSource source = new StreamSource(in);
printSource(source);
// Sent HTTP GET request to invoke greetMe FAULT
target = "http://localhost:9000/SoapContext/SoapPort/greetMe/me/CXF";
url = new URL(target);
httpConnection = (HttpURLConnection) url.openConnection();
httpConnection.connect();
System.out.println("Invoking server through HTTP GET to invoke greetMe");
try {
in = httpConnection.getInputStream();
source = new StreamSource(in);
printSource(source);
} catch (Exception e) {
System.err.println("GreetMe Fault: " + e.getMessage());
}
InputStream err = httpConnection.getErrorStream();
source = new StreamSource(err);
printSource(source);
// Sent HTTP GET request to invoke greetMe
target = "http://localhost:9000/SoapContext/SoapPort/greetMe/requestType/CXF";
url = new URL(target);
httpConnection = (HttpURLConnection) url.openConnection();
httpConnection.connect();
System.out.println("Invoking server through HTTP GET to invoke greetMe");
in = httpConnection.getInputStream();
source = new StreamSource(in);
printSource(source);
// Sent HTTP GET request to invoke pingMe
target = "http://localhost:9000/SoapContext/SoapPort/pingMe";
url = new URL(target);
httpConnection = (HttpURLConnection) url.openConnection();
httpConnection.connect();
System.out.println("Invoking server through HTTP GET to invoke pingMe");
try {
in = httpConnection.getInputStream();
} catch (Exception e) {
System.out.println("PingMe fault raised");
}
err = httpConnection.getErrorStream();
source = new StreamSource(err);
printSource(source);
}
private static void printSource(Source source) {
try {
ByteArrayOutputStream bos = new ByteArrayOutputStream();
StreamResult sr = new StreamResult(bos);
Transformer trans = TransformerFactory.newInstance().newTransformer();
Properties oprops = new Properties();
oprops.put(OutputKeys.OMIT_XML_DECLARATION, "yes");
trans.setOutputProperties(oprops);
trans.transform(source, sr);
System.out.println();
System.out.println("**** Response ******");
System.out.println();
System.out.println(bos.toString());
bos.close();
System.out.println();
} catch (Exception e) {
e.printStackTrace();
}
}
}
/////////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.hw.server;
import java.util.logging.Logger;
import org.apache.hello_world_soap12_http.Greeter;
import org.apache.hello_world_soap12_http.PingMeFault;
import org.apache.hello_world_soap12_http.types.FaultDetail;
@javax.jws.WebService(portName = "SoapPort", serviceName = "SOAPService",
targetNamespace = "http://apache.org/hello_world_soap12_http",
endpointInterface = "org.apache.hello_world_soap12_http.Greeter")
@javax.xml.ws.BindingType(value = "http://www.w3.org/2003/05/soap/bindings/HTTP/")
public class GreeterImpl implements Greeter {
private static final Logger LOG =
Logger.getLogger(GreeterImpl.class.getPackage().getName());

public String greetMe(String me) {
LOG.info("Executing operation greetMe");
System.out.println("Executing operation greetMe");
System.out.println("Message received: " + me + "\n");
return "Hello " + me;
}

public void greetMeOneWay(String me) {
LOG.info("Executing operation greetMeOneWay");
System.out.println("Executing operation greetMeOneWay\n");
System.out.println("Hello there " + me);
}
public String sayHi() {
LOG.info("Executing operation sayHi");
System.out.println("Executing operation sayHi\n");
return "Bonjour";
}

public void pingMe() throws PingMeFault {
FaultDetail faultDetail = new FaultDetail();
faultDetail.setMajor((short)2);
faultDetail.setMinor((short)1);
LOG.info("Executing operation pingMe, throwing PingMeFault exception");
System.out.println("Executing operation pingMe, throwing PingMeFault exception\n");
throw new PingMeFault("PingMeFault raised by server", faultDetail);
}

}
/////////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.hw.server;
import javax.xml.ws.Endpoint;
public class Server {
protected Server() throws Exception {
System.out.println("Starting Server");
Object implementor = new GreeterImpl();
String address = "http://localhost:9000/SoapContext/SoapPort";
Endpoint.publish(address, implementor);
}
public static void main(String args[]) throws Exception {
new Server();
System.out.println("Server ready...");
Thread.sleep(5 * 60 * 1000);
System.out.println("Server exiting");
System.exit(0);
}
}

////////////////////////////////////////////////////////////////////////////////
<?xml version="1.0" encoding="UTF-8"?>

<definitions name="HelloWorld"
xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:tns="http://apache.org/hello_world_soap12_http"
xmlns:x1="http://apache.org/hello_world_soap12_http/types"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://apache.org/hello_world_soap12_http"
xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/">
<wsdl:types>
<schema targetNamespace="http://apache.org/hello_world_soap12_http/types"
xmlns="http://www.w3.org/2001/XMLSchema"
xmlns:x1="http://apache.org/hello_world_soap12_http/types"
elementFormDefault="qualified">
<simpleType name="MyStringType">
<restriction base="string">
<maxLength value="30" />
</restriction>
</simpleType>
<element name="sayHi">
<complexType/>
</element>
<element name="sayHiResponse">
<complexType>
<sequence>
<element name="responseType" type="string"/>
</sequence>
</complexType>
</element>
<element name="greetMe">
<complexType>
<sequence>
<element name="requestType" type="x1:MyStringType"/>
</sequence>
</complexType>
</element>
<element name="greetMeResponse">
<complexType>
<sequence>
<element name="responseType" type="string"/>
</sequence>
</complexType>
</element>
<element name="greetMeOneWay">
<complexType>
<sequence>
<element name="requestType" type="string"/>
</sequence>
</complexType>
</element>
<element name="pingMe">
<complexType/>
</element>
<element name="pingMeResponse">
<complexType/>
</element>
<element name="faultDetail">
<complexType>
<sequence>
<element name="minor" type="short"/>
<element name="major" type="short"/>
</sequence>
</complexType>
</element>
</schema>
</wsdl:types>
<wsdl:message name="sayHiRequest">
<wsdl:part name="in" element="x1:sayHi"/>
</wsdl:message>
<wsdl:message name="sayHiResponse">
<wsdl:part name="out" element="x1:sayHiResponse"/>
</wsdl:message>
<wsdl:message name="greetMeRequest">
<wsdl:part element="x1:greetMe" name="in"/>
</wsdl:message>
<wsdl:message name="greetMeResponse">
<wsdl:part element="x1:greetMeResponse" name="out"/>
</wsdl:message>
<wsdl:message name="greetMeOneWayRequest">
<wsdl:part element="x1:greetMeOneWay" name="in"/>
</wsdl:message>
<wsdl:message name="pingMeRequest">
<wsdl:part name="in" element="x1:pingMe"/>
</wsdl:message>
<wsdl:message name="pingMeResponse">
<wsdl:part name="out" element="x1:pingMeResponse"/>
</wsdl:message>
<wsdl:message name="pingMeFault">
<wsdl:part name="faultDetail" element="x1:faultDetail"/>
</wsdl:message>
<wsdl:portType name="Greeter">
<wsdl:operation name="sayHi">
<wsdl:input name="sayHiRequest" message="tns:sayHiRequest"/>
<wsdl:output name="sayHiResponse" message="tns:sayHiResponse"/>
</wsdl:operation>
<wsdl:operation name="greetMe">
<wsdl:input message="tns:greetMeRequest" name="greetMeRequest"/>
<wsdl:output message="tns:greetMeResponse" name="greetMeResponse"/>
</wsdl:operation>

<wsdl:operation name="greetMeOneWay">
<wsdl:input message="tns:greetMeOneWayRequest" name="greetMeOneWayRequest"/>
</wsdl:operation>
<wsdl:operation name="pingMe">
<wsdl:input name="pingMeRequest" message="tns:pingMeRequest"/>
<wsdl:output name="pingMeResponse" message="tns:pingMeResponse"/>
<wsdl:fault name="pingMeFault" message="tns:pingMeFault"/>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="Greeter_SOAPBinding" type="tns:Greeter">
<soap12:binding transport="http://www.w3.org/2003/05/soap/bindings/HTTP/" style="document" />
<operation name="sayHi">
<soap12:operation style="document" soapAction=""/>
<input>
<soap12:body use="literal" />
</input>
<output>
<soap12:body use="literal" />
</output>
</operation>
<wsdl:operation name="greetMe">
<soap12:operation soapAction="" style="document"/>
<wsdl:input name="greetMeRequest">
<soap12:body use="literal"/>
</wsdl:input>
<wsdl:output name="greetMeResponse">
<soap12:body use="literal"/>
</wsdl:output>
</wsdl:operation>

<wsdl:operation name="greetMeOneWay">
<soap12:operation soapAction="" style="document"/>
<wsdl:input name="greetMeOneWayRequest">
<soap12:body use="literal"/>
</wsdl:input>
</wsdl:operation>
<operation name="pingMe">
<soap12:operation style="document"/>
<input>
<soap12:body use="literal"/>
</input>
<output>
<soap12:body use="literal"/>
</output>
<fault name="pingMeFault">
<soap12:fault name="pingMeFault" use="literal"/>
</fault>
</operation>
</wsdl:binding>
<wsdl:service name="SOAPService">
<wsdl:port name="SoapPort" binding="tns:Greeter_SOAPBinding">
<soap12:address location="http://localhost:9000/SoapContext/SoapPort"/>
</wsdl:port>
</wsdl:service>
</definitions>

</source>



== JAX-WS: SOAP Element ==

== JAX-WS: SOAP Element Any Type ==

== This demo illustrates Apache CXF"s support for SOAP headers ==



<source lang="java">

SOAP Headers
============
This demo illustrates Apache CXF"s support for SOAP headers. In the
WSDL file, the SOAP header is included as an additional part within
the message and binding definitions. Using this approach to defining a
SOAP header, Apache CXF treats the header content as another parameter
to the operation. Consequently, the header content is simply
manipulated within the method body.
The client application creates the header content, which is simply
a string value. The server application views the supplied values
and may set these values into the operation"s return values or
out/inout headers.
Please review the README in the samples directory before
continuing.

Prerequisites
-------------
If your environment already includes cxf.jar on the
CLASSPATH, and the JDK and ant bin directories on the PATH
it is not necessary to set the environment as described in
the samples directory"s README. If your environment is not
properly configured, or if you are planning on using wsdl2java,
javac, and java to build and run the demos, you must set the
environment.

Building and running the demo using ant
---------------------------------------
From the samples/soap_header directory, the ant build script
can be used to build and run the demo.
Using either UNIX or Windows:
ant build
ant server
ant client

To remove the code generated from the WSDL file and the .class
files, run:
ant clean

Building the demo using wsdl2java and javac
------------------------------------------
From the samples/soap_header directory, first create the target
directory build/classes and then generate code from the WSDL file.
For UNIX:
mkdir -p build/classes
wsdl2java -d build/classes -compile ./wsdl/soap_header.wsdl
For Windows:
mkdir build\classes
Must use back slashes.
wsdl2java -d build\classes -compile .\wsdl\soap_header.wsdl
May use either forward or back slashes.
Now compile the provided client and server applications with the commands:
For UNIX:

export CLASSPATH=$CLASSPATH:$CXF_HOME/lib/cxf.jar:./build/classes
javac -d build/classes src/demo/soap_header/client/*.java
javac -d build/classes src/demo/soap_header/server/*.java
For Windows:
set classpath=%classpath%;%CXF_HOME%\lib\cxf.jar;.\build\classes
javac -d build\classes src\demo\soap_header\client\*.java
javac -d build\classes src\demo\soap_header\server\*.java
Running the demo using java
---------------------------
From the samples/soap_header directory run the following commands.
They are entered on a single command line:
For UNIX (must use forward slashes):
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.soap_header.server.Server &
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.soap_header.client.Client ./wsdl/soap_header.wsdl
The server process starts in the background. After running the client,
use the kill command to terminate the server process.
For Windows (may use either forward or back slashes):
start
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.soap_header.server.Server
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.soap_header.client.Client .\wsdl\soap_header.wsdl
A new command windows opens for the server process. After running the
client, terminate the server process by issuing Ctrl-C in its command window.
To remove the code generated from the WSDL file and the .class
files, either delete the build directory and its contents or run:
ant clean

Building and running the demo in a servlet container
----------------------------------------------------
From the samples/soap_header directory, the ant build script
can be used to create the war file that is deployed into the
servlet container.
Build the war file with the command:
ant war
Preparing deploy to APACHE TOMCAT
* set CATALINA_HOME environment to your TOMCAT home directory

Deploy the war file into APACHE TOMCAT with the commond:
[NOTE] This step will check if the cxf jars present in Tomcat,
if not, it will automatically copy all the jars into CATALINA_HOME/shared/lib

ant deploy -Dtomcat=true
The servlet container will extract the war and deploy the application.

Using ant, run the client application with the command:
ant client-servlet -Dbase.url=http://localhost:#
Where # is the TCP/IP port used by the servlet container,
e.g., 8080.
Or
ant client-servlet -Dhost=localhost -Dport=8080
You can ignore the -Dhost and -Dport if your tomcat setup is same, i.e ant client-servlet
Using java, run the client application with the command:
For UNIX:

java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.soap_header.client.Client http://localhost:#/soapheader/services/soap_header?wsdl
For Windows:
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.soap_header.client.Client http://localhost:#/soapheader/services/soap_header?wsdl
Where # is the TCP/IP port used by the servlet container,
e.g., 8080.
Undeploy the application from the APACHE TOMCAT with the command:
ant undeploy -Dtomcat=true

/////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/

package demo.soap_header.client;
import java.io.File;
import java.net.URL;
import javax.xml.namespace.QName;
import javax.xml.ws.Holder;
import org.apache.headers.HeaderService;
import org.apache.headers.HeaderTester;
import org.apache.headers.InHeader;
import org.apache.headers.InHeaderResponse;
import org.apache.headers.InoutHeader;
import org.apache.headers.InoutHeaderResponse;
import org.apache.headers.OutHeader;
import org.apache.headers.OutHeaderResponse;
import org.apache.headers.SOAPHeaderData;
public final class Client {
private static final QName SERVICE_NAME
= new QName("http://apache.org/headers", "HeaderService");

private Client() {
}
public static void main(String args[]) throws Exception {
if (args.length == 0) {
System.out.println("please specify wsdl");
System.exit(1);
}
URL wsdlURL;
File wsdlFile = new File(args[0]);
if (wsdlFile.exists()) {
wsdlURL = wsdlFile.toURL();
} else {
wsdlURL = new URL(args[0]);
}

HeaderService hs = new HeaderService(wsdlURL, SERVICE_NAME);
HeaderTester proxy = hs.getSoapPort();
invokeInHeader(proxy);
invokeOutHeader(proxy);
invokeInOutHeader(proxy);
}

private static void invokeInHeader(HeaderTester proxy) {
// invoke inHeader operation
System.out.println("Invoking inHeader operation");
InHeader me = new InHeader();
me.setRequestType("CXF user");
SOAPHeaderData headerInfo = new SOAPHeaderData();
headerInfo.setOriginator("CXF client");
headerInfo.setMessage("Invoking inHeader operation");
InHeaderResponse response = proxy.inHeader(me, headerInfo);
System.out.println("\tinHeader invocation returned: ");
System.out.println("\t\tResult: " + response.getResponseType());
}
private static void invokeOutHeader(HeaderTester proxy) {
// invoke outHeaderoperation
System.out.println("Invoking outHeader operation");
OutHeader me = new OutHeader();
me.setRequestType("CXF user");
Holder<OutHeaderResponse> theResponse = new Holder<OutHeaderResponse>();
Holder<SOAPHeaderData> headerInfo = new Holder<SOAPHeaderData>();
proxy.outHeader(me, theResponse, headerInfo);
System.out.println("\toutHeader invocation returned: ");
System.out.println("\t\tOut parameter: " + theResponse.value.getResponseType());
System.out.println("\t\tHeader content:");
System.out.println("\t\t\tOriginator: " + headerInfo.value.getOriginator());
System.out.println("\t\t\tMessage: " + headerInfo.value.getMessage());
}
private static void invokeInOutHeader(HeaderTester proxy) {
System.out.println("Invoking inoutHeader operation");
InoutHeader me = new InoutHeader();
me.setRequestType("CXF user");
Holder<SOAPHeaderData> headerInfo = new Holder<SOAPHeaderData>();
SOAPHeaderData shd = new SOAPHeaderData();
shd.setOriginator("CXF client");
shd.setMessage("Invoking inoutHeader operation");
headerInfo.value = shd;
InoutHeaderResponse response = proxy.inoutHeader(me, headerInfo);
System.out.println("\tinoutHeader invocation returned: ");
System.out.println("\t\tResult: " + response.getResponseType());
System.out.println("\t\tHeader content:");
System.out.println("\t\t\tOriginator: " + headerInfo.value.getOriginator());
System.out.println("\t\t\tMessage: " + headerInfo.value.getMessage());
System.exit(0);
}
}

//////////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/

package demo.soap_header.server;
import javax.xml.ws.Holder;
import org.apache.headers.HeaderTester;
import org.apache.headers.InHeader;
import org.apache.headers.InHeaderResponse;
import org.apache.headers.InoutHeader;
import org.apache.headers.InoutHeaderResponse;
import org.apache.headers.OutHeader;
import org.apache.headers.OutHeaderResponse;
import org.apache.headers.SOAPHeaderData;

@javax.jws.WebService(serviceName = "HeaderService",
portName = "SoapPort",
endpointInterface = "org.apache.headers.HeaderTester",
targetNamespace = "http://apache.org/headers")

public class HeaderTesterImpl implements HeaderTester {
public InHeaderResponse inHeader(InHeader me,
SOAPHeaderData headerInfo) {
System.out.println("inHeader invoked");
System.out.println("\tGetting Originator: " + headerInfo.getOriginator());
System.out.println("\tGetting Message: " + headerInfo.getMessage());
InHeaderResponse ihr = new InHeaderResponse();
ihr.setResponseType("Hello " + me.getRequestType());
return ihr;
}
public void outHeader(OutHeader me,
Holder<OutHeaderResponse> theResponse,
Holder<SOAPHeaderData> headerInfo) {
System.out.println("outHeader invoked");
System.out.println("\tSetting originator: CXF server");
System.out.println("\tSetting message: outHeader invocation succeeded");
SOAPHeaderData sh = new SOAPHeaderData();
sh.setOriginator("CXF server");
sh.setMessage("outHeader invocation succeeded");
headerInfo.value = sh;
OutHeaderResponse ohr = new OutHeaderResponse();
ohr.setResponseType("Hello " + me.getRequestType());
theResponse.value = ohr;
}
public InoutHeaderResponse inoutHeader(InoutHeader me,
Holder<SOAPHeaderData> headerInfo) {
System.out.println("inoutHeader invoked");
System.out.println("\tGetting Originator: " + headerInfo.value.getOriginator());
System.out.println("\tGetting Message: " + headerInfo.value.getMessage());
System.out.println("\tSetting originator: CXF server");
System.out.println("\tSetting message: inoutHeader invocation succeeded");
headerInfo.value.setOriginator("CXF server");
headerInfo.value.setMessage("inoutHeader invocation succeeded");
InoutHeaderResponse iohr = new InoutHeaderResponse();
iohr.setResponseType("Hello " + me.getRequestType());
return iohr;
}
}

//////////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/

package demo.soap_header.server;
import javax.xml.ws.Endpoint;
public class Server {
protected Server() throws Exception {
System.out.println("Starting Server");
Object implementor = new HeaderTesterImpl();
String address = "http://localhost:9000/headers";
Endpoint.publish(address, implementor);
}
public static void main(String args[]) throws Exception {
new Server();
System.out.println("Server ready...");
Thread.sleep(5 * 60 * 1000);
System.out.println("Server exiting");
System.exit(0);
}
}

//////////////////////////////////////////////////////////////////////////////
<?xml version="1.0" encoding="UTF-8"?>

<definitions name="soap_header" targetNamespace="http://apache.org/headers"
xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:http="http://schemas.xmlsoap.org/wsdl/http/"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:tns="http://apache.org/headers"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<types>
<schema targetNamespace="http://apache.org/headers"
xmlns="http://www.w3.org/2001/XMLSchema"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
<complexType name="SOAPHeaderData">
<sequence>
<element maxOccurs="1" minOccurs="1" name="originator" type="string"/>
<element maxOccurs="1" minOccurs="1" name="message" type="string"/>
</sequence>
</complexType>
<element name="SOAPHeaderInfo" type="tns:SOAPHeaderData"/>
<element name="inHeader">
<complexType>
<sequence>
<element name="requestType" type="xsd:string"/>
</sequence>
</complexType>
</element>
<element name="inHeaderResponse">
<complexType>
<sequence>
<element name="responseType" type="xsd:string"/>
</sequence>
</complexType>
</element>
<element name="outHeader">
<complexType>
<sequence>
<element name="requestType" type="xsd:string"/>
</sequence>
</complexType>
</element>
<element name="outHeaderResponse">
<complexType>
<sequence>
<element name="responseType" type="xsd:string"/>
</sequence>
</complexType>
</element>
<element name="inoutHeader">
<complexType>
<sequence>
<element name="requestType" type="xsd:string"/>
</sequence>
</complexType>
</element>
<element name="inoutHeaderResponse">
<complexType>
<sequence>
<element name="responseType" type="xsd:string"/>
</sequence>
</complexType>
</element>
</schema>
</types>
<message name="inHeaderRequest">
<part element="tns:inHeader" name="me"/>
<part element="tns:SOAPHeaderInfo" name="header_info"/>
</message>
<message name="inHeaderResponse">
<part element="tns:inHeaderResponse" name="the_response"/>
</message>
<message name="outHeaderRequest">
<part element="tns:outHeader" name="me"/>
</message>
<message name="outHeaderResponse">
<part element="tns:outHeaderResponse" name="the_response"/>
<part element="tns:SOAPHeaderInfo" name="header_info"/>
</message>
<message name="inoutHeaderRequest">
<part element="tns:inoutHeader" name="me"/>
<part element="tns:SOAPHeaderInfo" name="header_info"/>
</message>
<message name="inoutHeaderResponse">
<part element="tns:inoutHeaderResponse" name="the_response"/>
<part element="tns:SOAPHeaderInfo" name="header_info"/>
</message>
<portType name="headerTester">
<operation name="inHeader">
<input message="tns:inHeaderRequest" name="inHeaderRequest"/>
<output message="tns:inHeaderResponse" name="inHeaderResponse"/>
</operation>
<operation name="outHeader">
<input message="tns:outHeaderRequest" name="outHeaderRequest"/>
<output message="tns:outHeaderResponse" name="outHeaderResponse"/>
</operation>
<operation name="inoutHeader">
<input message="tns:inoutHeaderRequest" name="inoutHeaderRequest"/>
<output message="tns:inoutHeaderResponse" name="inoutHeaderResponse"/>
</operation>
</portType>
<binding name="headerTesterSOAPBinding" type="tns:headerTester">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<operation name="inHeader">
<soap:operation soapAction="" style="document"/>
<input name="inHeaderRequest">
<soap:body parts="me" use="literal"/>
<soap:header message="tns:inHeaderRequest" part="header_info"
use="literal"/>
</input>
<output name="inHeaderResponse">
<soap:body use="literal"/>
</output>
</operation>
<operation name="outHeader">
<soap:operation soapAction="" style="document"/>
<input name="outHeaderRequest">
<soap:body use="literal"/>
</input>
<output name="outHeaderResponse">
<soap:body parts="the_response" use="literal"/>
<soap:header message="tns:outHeaderResponse" part="header_info"
use="literal"/>
</output>
</operation>
<operation name="inoutHeader">
<soap:operation soapAction="" style="document"/>
<input name="inoutHeaderRequest">
<soap:body parts="me" use="literal"/>
<soap:header message="tns:inoutHeaderRequest" part="header_info"
use="literal"/>
</input>
<output name="inoutHeaderResponse">
<soap:body parts="the_response" use="literal"/>
<soap:header message="tns:inoutHeaderResponse" part="header_info"
use="literal"/>
</output>
</operation>
</binding>
<service name="HeaderService">
<port binding="tns:headerTesterSOAPBinding" name="SoapPort">
<soap:address location="http://localhost:9000/headers"/>
</port>
</service>
</definitions>

</source>

Java/Web Services SOA/CXF XFire Document Literal

2010-06-01T07:27:33Z

Admin: 1 версия

== Apache CXF"s xml binding: how xml binding works with the doc-lit wrapped style ==



<source lang="java">

Hello World Demo using WRAPPED Style in XML Binding
=============================================
This demo illustrates the use of Apache CXF"s xml binding. This
specific demo shows you how xml binding works with the
doc-lit wrapped style.
Please review the README in the samples directory before
continuing.

Prerequisite
------------
If your environment already includes cxf-manifest-incubator.jar on the
CLASSPATH, and the JDK and ant bin directories on the PATH
it is not necessary to set the environment as described in
the samples directory"s README. If your environment is not
properly configured, or if you are planning on using wsdl2java,
javac, and java to build and run the demos, you must set the
environment.

Building and running the demo using ant
---------------------------------------
From the samples/hello_world_xml_wrapped directory, the ant build script
can be used to build and run the demo.
Using either UNIX or Windows:
ant build
ant server
ant client

To remove the code generated from the WSDL file and the .class
files, run:
ant clean

Building the demo using wsdl2java and javac
-------------------------------------------
From the samples/hello_world_xml_wrapped directory, first create the target
directory build/classes and then generate code from the WSDL file.
For UNIX:
mkdir -p build/classes
wsdl2java -d build/classes -compile ./wsdl/hello_world.wsdl
For Windows:
mkdir build\classes
Must use back slashes.
wsdl2java -d build\classes -compile .\wsdl\hello_world.wsdl
May use either forward or back slashes.
Now compile the provided client and server applications with the commands:
For UNIX:

export CLASSPATH=$CLASSPATH:$CXF_HOME/lib/cxf-manifest-incubator.jar:./build/classes
javac -d build/classes src/demo/hw/client/*.java
javac -d build/classes src/demo/hw/server/*.java
For Windows:
set classpath=%classpath%;%CXF_HOME%\lib\cxf-manifest-incubator.jar;.\build\classes
javac -d build\classes src\demo\hw\client\*.java
javac -d build\classes src\demo\hw\server\*.java

Running the demo using java
---------------------------
From the samples/hello_world_xml_wrapped directory run the commands, entered
on a single command line:
For UNIX (must use forward slashes):
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.hw.server.Server &
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.hw.client.Client ./wsdl/hello_world.wsdl
The server process starts in the background. After running the client,
use the kill command to terminate the server process.
For Windows (may use either forward or back slashes):
start
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.hw.server.Server
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.hw.client.Client .\wsdl\hello_world.wsdl
A new command windows opens for the server process. After running the
client, terminate the server process by issuing Ctrl-C in its command window.
To remove the code generated from the WSDL file and the .class
files, either delete the build directory and its contents or run:
ant clean

Building and running the demo in a servlet container
----------------------------------------------------
From the samples/hello_world_xml_wrapped directory, the ant build script
can be used to create the war file that is deployed into the
servlet container.
Build the war file with the command:
ant war

Preparing deploy to APACHE TOMCAT
* set CATALINA_HOME environment to your TOMCAT home directory

Deploy the application into APACHE TOMCAT with the commond:
[NOTE] This step will check if the cxf jars present in Tomcat,
if not, it will automatically copy all the jars into CATALINA_HOME/shared/lib

ant deploy -Dtomcat=true
The servlet container will extract the war and deploy the application.

Using ant, run the client application with the command:
ant client-servlet -Dbase.url=http://localhost:#
Where # is the TCP/IP port used by the servlet container,
e.g., 8080.
Or
ant client-servlet -Dhost=localhost -Dport=8080
Using java, run the client application with the command:
For UNIX:

java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.hw.client.Client http://localhost:#/helloworld/services/hello_world?wsdl
For Windows:
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.hw.client.Client http://localhost:#/helloworld/services/hello_world?wsdl
Where # is the TCP/IP port used by the servlet container,
e.g., 8080.
Undeploy the application from the APACHE TOMCAT with the command:
ant undeploy -Dtomcat=true

Running demo with HTTP GET
----------------------------------------------------
APACHE CXF support HTTP GET to invoke the service, instead of running
ant client
you can use
ant client.get
to invoke the service with simple HttpURLConnection, or you can even
use your favoriate browser to get the results back.

///////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.hw.client;
import java.io.File;
import java.net.URL;
import javax.xml.namespace.QName;
import org.apache.hello_world_xml_http.wrapped.Greeter;
import org.apache.hello_world_xml_http.wrapped.PingMeFault;
import org.apache.hello_world_xml_http.wrapped.XMLService;
public final class Client {
public static final QName SERVICE_NAME = new QName("http://apache.org/hello_world_xml_http/wrapped",
"XMLService");
public static final QName PORT_NAME =
new QName("http://apache.org/hello_world_xml_http/wrapped", "XMLPort");
private Client() {
}
public static void main(String args[]) throws Exception {
if (args.length == 0) {
System.out.println("please specify wsdl");
System.exit(1);
}
URL wsdlURL;
File wsdlFile = new File(args[0]);
if (wsdlFile.exists()) {
wsdlURL = wsdlFile.toURL();
} else {
wsdlURL = new URL(args[0]);
}
System.out.println(wsdlURL);
XMLService ss = new XMLService(wsdlURL, SERVICE_NAME);
Greeter port = ss.getXMLPort();
String resp;
System.out.println("Invoking sayHi...");
resp = port.sayHi();
System.out.println("Server responded with: " + resp);
System.out.println();
System.out.println("Invoking greetMe...");
resp = port.greetMe(System.getProperty("user.name"));
System.out.println("Server responded with: " + resp);
System.out.println();
System.out.println("Invoking greetMeOneWay...");
port.greetMeOneWay(System.getProperty("user.name"));
System.out.println("No response from server as method is OneWay");
System.out.println();
try {
System.out.println("Invoking pingMe, expecting exception...");
port.pingMe();
} catch (PingMeFault ex) {
System.out.println("Expected exception: " + ex.getMessage());
}

System.exit(0);
}
}
///////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.hw.client;
import java.io.ByteArrayOutputStream;
import java.io.InputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Properties;
import javax.xml.transform.OutputKeys;
import javax.xml.transform.Source;
import javax.xml.transform.Transformer;
import javax.xml.transform.TransformerFactory;
import javax.xml.transform.stream.StreamResult;
import javax.xml.transform.stream.StreamSource;
public final class Get {
private Get() {
}
public static void main(String args[]) throws Exception {
// Sent HTTP GET request to invoke sayHi
String target = "http://localhost:9000/XMLService/XMLPort/sayHi";
URL url = new URL(target);
HttpURLConnection httpConnection = (HttpURLConnection) url.openConnection();
httpConnection.connect();
System.out.println("Invoking server through HTTP GET to invoke sayHi");
InputStream in = httpConnection.getInputStream();
StreamSource source = new StreamSource(in);
printSource(source);
// Sent HTTP GET request to invoke greetMe FAULT
target = "http://localhost:9000/XMLService/XMLPort/greetMe/me/CXF";
url = new URL(target);
httpConnection = (HttpURLConnection) url.openConnection();
httpConnection.connect();
System.out.println("Invoking server through HTTP GET to invoke greetMe");
try {
in = httpConnection.getInputStream();
source = new StreamSource(in);
printSource(source);
} catch (Exception e) {
System.err.println("GreetMe Fault: " + e.getMessage());
}
InputStream err = httpConnection.getErrorStream();
source = new StreamSource(err);
printSource(source);
// Sent HTTP GET request to invoke greetMe
target = "http://localhost:9000/XMLService/XMLPort/greetMe/requestType/CXF";
url = new URL(target);
httpConnection = (HttpURLConnection) url.openConnection();
httpConnection.connect();
System.out.println("Invoking server through HTTP GET to invoke greetMe");
in = httpConnection.getInputStream();
source = new StreamSource(in);
printSource(source);
// Sent HTTP GET request to invoke pingMe
target = "http://localhost:9000/XMLService/XMLPort/pingMe";
url = new URL(target);
httpConnection = (HttpURLConnection) url.openConnection();
httpConnection.connect();
System.out.println("Invoking server through HTTP GET to invoke pingMe");
try {
in = httpConnection.getInputStream();
} catch (Exception e) {
System.out.println("PingMe fault raised");
}
err = httpConnection.getErrorStream();
source = new StreamSource(err);
printSource(source);
}
private static void printSource(Source source) {
try {
ByteArrayOutputStream bos = new ByteArrayOutputStream();
StreamResult sr = new StreamResult(bos);
Transformer trans = TransformerFactory.newInstance().newTransformer();
Properties oprops = new Properties();
oprops.put(OutputKeys.OMIT_XML_DECLARATION, "yes");
trans.setOutputProperties(oprops);
trans.transform(source, sr);
System.out.println();
System.out.println("**** Response ******");
System.out.println();
System.out.println(bos.toString());
bos.close();
System.out.println();
} catch (Exception e) {
e.printStackTrace();
}
}
}
///////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.hw.server;
import org.apache.hello_world_xml_http.wrapped.Greeter;
import org.apache.hello_world_xml_http.wrapped.PingMeFault;
import org.apache.hello_world_xml_http.wrapped.types.FaultDetail;
@javax.jws.WebService(serviceName = "XMLService",
portName = "XMLPort",
endpointInterface = "org.apache.hello_world_xml_http.wrapped.Greeter",
targetNamespace = "http://apache.org/hello_world_xml_http/wrapped")
@javax.xml.ws.BindingType(value = "http://cxf.apache.org/bindings/xformat")
public class GreeterImpl implements Greeter {
public String greetMe(String me) {
System.out.println("received calling greetMe!");
return "Hello " + me;
}
public void greetMeOneWay(String me) {
System.out.println("Executing operation greetMeOneWay\n");
System.out.println("Hello there " + me);
}
public String sayHi() {
System.out.println("received calling sayHi!");
return "Bonjour";
}
public void pingMe() throws PingMeFault {
System.out.println("received calling PingMeFault!");
FaultDetail faultDetail = new FaultDetail();
faultDetail.setMajor((short)2);
faultDetail.setMinor((short)1);
throw new PingMeFault("PingMeFault raised by server", faultDetail);
}
}
///////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.hw.server;
import javax.xml.ws.Endpoint;
public class Server {
protected Server() throws Exception {
System.out.println("Starting Server");
Object implementor = new GreeterImpl();
String address = "http://localhost:9000/XMLService/XMLPort";
Endpoint.publish(address, implementor);
}
public static void main(String args[]) throws Exception {
new Server();
System.out.println("Server ready...");
Thread.sleep(5 * 60 * 1000);
System.out.println("Server exiting");
System.exit(0);
}
}
///////////////////////////////////////////////////////////////////
<?xml version="1.0" encoding="UTF-8"?>

<wsdl:definitions name="HelloWorld"
targetNamespace="http://apache.org/hello_world_xml_http/wrapped"
xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:http="http://schemas.xmlsoap.org/wsdl/http/"
xmlns:tns="http://apache.org/hello_world_xml_http/wrapped"
xmlns:x1="http://apache.org/hello_world_xml_http/wrapped/types"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:xformat="http://cxf.apache.org/bindings/xformat"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<wsdl:types>
<schema
targetNamespace="http://apache.org/hello_world_xml_http/wrapped/types"
xmlns="http://www.w3.org/2001/XMLSchema"
elementFormDefault="qualified">
<element name="sayHi">
<complexType />
</element>
<element name="sayHiResponse">
<complexType>
<sequence>
<element name="responseType" type="xsd:string" />
</sequence>
</complexType>
</element>
<element name="greetMe">
<complexType>
<sequence>
<element name="requestType" type="xsd:string" />
</sequence>
</complexType>
</element>
<element name="greetMeResponse">
<complexType>
<sequence>
<element name="responseType" type="xsd:string" />
</sequence>
</complexType>
</element>
<element name="greetMeOneWay">
<complexType>
<sequence>
<element name="requestType" type="xsd:string" />
</sequence>
</complexType>
</element>
<element name="pingMe">
<complexType />
</element>
<element name="pingMeResponse">
<complexType />
</element>
<element name="faultDetail">
<complexType>
<sequence>
<element name="minor" type="xsd:short" />
<element name="major" type="xsd:short" />
</sequence>
</complexType>
</element>
</schema>
</wsdl:types>
<wsdl:message name="sayHiRequest">
<wsdl:part element="x1:sayHi" name="in" />
</wsdl:message>
<wsdl:message name="sayHiResponse">
<wsdl:part element="x1:sayHiResponse" name="out" />
</wsdl:message>
<wsdl:message name="greetMeRequest">
<wsdl:part element="x1:greetMe" name="in" />
</wsdl:message>
<wsdl:message name="greetMeResponse">
<wsdl:part element="x1:greetMeResponse" name="out" />
</wsdl:message>
<wsdl:message name="greetMeOneWayRequest">
<wsdl:part element="x1:greetMeOneWay" name="in" />
</wsdl:message>
<wsdl:message name="pingMeRequest">
<wsdl:part name="in" element="x1:pingMe" />
</wsdl:message>
<wsdl:message name="pingMeResponse">
<wsdl:part name="out" element="x1:pingMeResponse" />
</wsdl:message>
<wsdl:message name="pingMeFault">
<wsdl:part name="faultDetail" element="x1:faultDetail" />
</wsdl:message>
<wsdl:portType name="Greeter">
<wsdl:operation name="sayHi">
<wsdl:input message="tns:sayHiRequest" name="sayHiRequest" />
<wsdl:output message="tns:sayHiResponse"
name="sayHiResponse" />
</wsdl:operation>
<wsdl:operation name="greetMe">
<wsdl:input message="tns:greetMeRequest"
name="greetMeRequest" />
<wsdl:output message="tns:greetMeResponse"
name="greetMeResponse" />
</wsdl:operation>
<wsdl:operation name="greetMeOneWay">
<wsdl:input message="tns:greetMeOneWayRequest"
name="greetMeOneWayRequest" />
</wsdl:operation>
<wsdl:operation name="pingMe">
<wsdl:input name="pingMeRequest"
message="tns:pingMeRequest" />
<wsdl:output name="pingMeResponse"
message="tns:pingMeResponse" />
<wsdl:fault name="pingMeFault" message="tns:pingMeFault" />
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="Greeter_XMLBinding" type="tns:Greeter">
<xformat:binding />
<wsdl:operation name="sayHi">
<wsdl:input name="sayHiRequest" />
<wsdl:output name="sayHiResponse" />
</wsdl:operation>
<wsdl:operation name="greetMe">
<wsdl:input name="greetMeRequest" />
<wsdl:output name="greetMeResponse" />
</wsdl:operation>
<wsdl:operation name="greetMeOneWay">
<wsdl:input name="greetMeOneWayRequest" />
</wsdl:operation>
<wsdl:operation name="pingMe">
<wsdl:input />
<wsdl:output />
<wsdl:fault name="pingMeFault" />
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="XMLService">
<wsdl:port binding="tns:Greeter_XMLBinding" name="XMLPort">
<http:address
location="http://localhost:9000/XMLService/XMLPort" />
</wsdl:port>
</wsdl:service>
</wsdl:definitions>

</source>



== Colocated Demo using Document/Literal Style ==



<source lang="java">

/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/

Colocated Demo using Document/Literal Style
=============================================
Please review the README in the samples directory before
continuing.

Prerequisite
------------
If your environment already includes cxf-incubator.jar on the
CLASSPATH, and the JDK and ant bin directories on the PATH
it is not necessary to set the environment as described in
the samples directory README. If your environment is not
properly configured, or if you are planning on using wsdl2java,
javac, and java to build and run the demos, you must set the
environment.

Building and running the demo using ant
---------------------------------------
From the samples/colocated directory, the ant build script
can be used to build and run the demo.
Using either UNIX or Windows:
ant build
ant client

To remove the code generated from the WSDL file and the .class
files, run:
ant clean

Building the demo using wsdl2java and javac
-------------------------------------------
From the samples/colocated directory, first create the target
directory build/classes and then generate code from the WSDL file.
For UNIX:
mkdir -p build/classes
wsdl2java -d build/classes -compile ./wsdl/hello_world.wsdl
For Windows:
mkdir build\classes
Must use back slashes.
wsdl2java -d build\classes -compile .\wsdl\hello_world.wsdl
May use either forward or back slashes.
Now compile the provided client and server applications with the commands:
For UNIX:
export CLASSPATH=$CLASSPATH:$CXF_HOME/lib/cxf-incubator.jar:./build/classes
javac -d build/classes src/demo/colocated/server/*.java
javac -d build/classes src/demo/colocated/client/*.java
For Windows:
set classpath=%classpath%;%CXF_HOME%\lib\cxf-incubator.jar;.\build\classes
javac -d build\classes src\demo\colocated\server\*.java
javac -d build\classes src\demo\colocated\client\*.java

Running the demo using java
---------------------------
From the samples/colocated directory run the commands, entered on a
single command line:
For UNIX (must use forward slashes):
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
-Dcxf.config.file=./coloc.xml
demo.colocated.client.Client ./wsdl/hello_world.wsdl
For Windows (may use either forward or back slashes):
start
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
-Dcxf.config.file=.\coloc.xml
demo.colocated.client.Client .\wsdl\hello_world.wsdl
To remove the code generated from the WSDL file and the .class
files, either delete the build directory and its contents or run:
ant clean

////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.colocated.client;
import java.io.File;
import java.net.URL;
import javax.xml.namespace.QName;
import demo.colocated.server.Server;
import org.apache.hello_world_soap_http.Greeter;
import org.apache.hello_world_soap_http.PingMeFault;
import org.apache.hello_world_soap_http.SOAPService;
import org.apache.hello_world_soap_http.types.FaultDetail;
public final class Client {
private static final QName SERVICE_NAME
= new QName("http://apache.org/hello_world_soap_http", "SOAPService");

private Client() {
}
public static void main(String args[]) throws Exception {
if (args.length == 0) {
System.out.println("please specify wsdl");
System.exit(1);
}
Server.main(new String[]{"inProcess"});
URL wsdlURL;
File wsdlFile = new File(args[0]);
if (wsdlFile.exists()) {
wsdlURL = wsdlFile.toURL();
} else {
wsdlURL = new URL(args[0]);
}
System.out.println(wsdlURL);
SOAPService ss = new SOAPService(wsdlURL, SERVICE_NAME);
Greeter port = ss.getSoapPort();
String resp;
System.out.println("Invoking sayHi...");
resp = port.sayHi();
System.out.println("Server responded with: " + resp);
System.out.println();
System.out.println("Invoking greetMe...");
resp = port.greetMe(System.getProperty("user.name"));
System.out.println("Server responded with: " + resp);
System.out.println();
try {
System.out.println("Invoking pingMe, expecting exception...");
port.pingMe();
} catch (PingMeFault ex) {
System.out.println("Expected exception: PingMeFault has occurred: " + ex.getMessage());
FaultDetail detail = ex.getFaultInfo();
System.out.println("FaultDetail major:" + detail.getMajor());
System.out.println("FaultDetail minor:" + detail.getMinor());
}
System.exit(0);
}
}
///////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.colocated.rumon;
import javax.xml.ws.ProtocolException;
import org.apache.cxf.interceptor.Fault;
import org.apache.cxf.message.Message;
import org.apache.cxf.phase.AbstractPhaseInterceptor;
import org.apache.cxf.phase.Phase;
public class ThrowFaultInterceptor extends AbstractPhaseInterceptor<Message> {
public ThrowFaultInterceptor() {
super(Phase.PREPARE_SEND);
}
public void handleMessage(Message message) throws Fault {
Boolean isColoc = (Boolean)message.get("org.apache.cxf.message.Message.COLOCATED");
if (isColoc == null || isColoc == Boolean.FALSE) {
String str = new String("Collocated Invocation should have been detected.");
throw new ProtocolException(str);
}
}
}

///////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.colocated.server;
import java.util.logging.Logger;
import org.apache.hello_world_soap_http.Greeter;
import org.apache.hello_world_soap_http.PingMeFault;
import org.apache.hello_world_soap_http.types.FaultDetail;
@javax.jws.WebService(portName = "SoapPort", serviceName = "SOAPService",
targetNamespace = "http://apache.org/hello_world_soap_http",
endpointInterface = "org.apache.hello_world_soap_http.Greeter")
public class GreeterImpl implements Greeter {
private static final Logger LOG =
Logger.getLogger(GreeterImpl.class.getPackage().getName());
/* (non-Javadoc)
* @see org.apache.hello_world_soap_http.Greeter#greetMe(java.lang.String)
*/
public String greetMe(String me) {
LOG.info("Executing operation greetMe");
System.out.println("Executing operation greetMe");
System.out.println("Message received: " + me + "\n");
return "Hello " + me;
}
/* (non-Javadoc)
* @see org.apache.hello_world_soap_http.Greeter#greetMeOneWay(java.lang.String)
*/
public void greetMeOneWay(String me) {
LOG.info("Executing operation greetMeOneWay");
System.out.println("Executing operation greetMeOneWay\n");
System.out.println("Hello there " + me);
}
/* (non-Javadoc)
* @see org.apache.hello_world_soap_http.Greeter#sayHi()
*/
public String sayHi() {
LOG.info("Executing operation sayHi");
System.out.println("Executing operation sayHi\n");
return "Bonjour";
}
public void pingMe() throws PingMeFault {
FaultDetail faultDetail = new FaultDetail();
faultDetail.setMajor((short)2);
faultDetail.setMinor((short)1);
LOG.info("Executing operation pingMe, throwing PingMeFault exception");
System.out.println("Executing operation pingMe, throwing PingMeFault exception\n");
throw new PingMeFault("PingMeFault raised by server", faultDetail);
}

}
///////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.colocated.server;
import javax.xml.ws.Endpoint;
public class Server {
protected Server() throws Exception {
System.out.println("Starting Server");
Object implementor = new GreeterImpl();
String address = "http://localhost:9000/SoapContext/SoapPort";
Endpoint.publish(address, implementor);
}
public static void main(String args[]) throws Exception {
new Server();
System.out.println("Server ready...");
if (!"inProcess".equals(args[0])) {
Thread.sleep(5 * 60 * 1000);
System.out.println("Server exiting");
System.exit(0);
}
}
}
///////////////////////////////////////////////////////////////////////////
<?xml version="1.0" encoding="UTF-8"?>

<wsdl:definitions name="HelloWorld"
targetNamespace="http://apache.org/hello_world_soap_http"
xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:tns="http://apache.org/hello_world_soap_http"
xmlns:x1="http://apache.org/hello_world_soap_http/types"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<wsdl:types>
<schema targetNamespace="http://apache.org/hello_world_soap_http/types"
xmlns="http://www.w3.org/2001/XMLSchema"
xmlns:tns="http://apache.org/hello_world_soap_http/types"
elementFormDefault="qualified">
<element name="sayHi">
<complexType/>
</element>
<element name="sayHiResponse">
<complexType>
<sequence>
<element name="responseType" type="string"/>
</sequence>
</complexType>
</element>
<element name="greetMe">
<complexType>
<sequence>
<element name="requestType" type="string"/>
</sequence>
</complexType>
</element>
<element name="greetMeResponse">
<complexType>
<sequence>
<element name="responseType" type="string"/>
</sequence>
</complexType>
</element>
<element name="greetMeOneWay">
<complexType>
<sequence>
<element name="requestType" type="string"/>
</sequence>
</complexType>
</element>
<element name="pingMe">
<complexType/>
</element>
<element name="pingMeResponse">
<complexType/>
</element>
<element name="faultDetail">
<complexType>
<sequence>
<element name="minor" type="short"/>
<element name="major" type="short"/>
</sequence>
</complexType>
</element>
</schema>
</wsdl:types>
<wsdl:message name="sayHiRequest">
<wsdl:part element="x1:sayHi" name="in"/>
</wsdl:message>
<wsdl:message name="sayHiResponse">
<wsdl:part element="x1:sayHiResponse" name="out"/>
</wsdl:message>
<wsdl:message name="greetMeRequest">
<wsdl:part element="x1:greetMe" name="in"/>
</wsdl:message>
<wsdl:message name="greetMeResponse">
<wsdl:part element="x1:greetMeResponse" name="out"/>
</wsdl:message>
<wsdl:message name="greetMeOneWayRequest">
<wsdl:part element="x1:greetMeOneWay" name="in"/>
</wsdl:message>
<wsdl:message name="pingMeRequest">
<wsdl:part name="in" element="x1:pingMe"/>
</wsdl:message>
<wsdl:message name="pingMeResponse">
<wsdl:part name="out" element="x1:pingMeResponse"/>
</wsdl:message>
<wsdl:message name="pingMeFault">
<wsdl:part name="faultDetail" element="x1:faultDetail"/>
</wsdl:message>

<wsdl:portType name="Greeter">
<wsdl:operation name="sayHi">
<wsdl:input message="tns:sayHiRequest" name="sayHiRequest"/>
<wsdl:output message="tns:sayHiResponse" name="sayHiResponse"/>
</wsdl:operation>

<wsdl:operation name="greetMe">
<wsdl:input message="tns:greetMeRequest" name="greetMeRequest"/>
<wsdl:output message="tns:greetMeResponse" name="greetMeResponse"/>
</wsdl:operation>

<wsdl:operation name="greetMeOneWay">
<wsdl:input message="tns:greetMeOneWayRequest" name="greetMeOneWayRequest"/>
</wsdl:operation>
<wsdl:operation name="pingMe">
<wsdl:input name="pingMeRequest" message="tns:pingMeRequest"/>
<wsdl:output name="pingMeResponse" message="tns:pingMeResponse"/>
<wsdl:fault name="pingMeFault" message="tns:pingMeFault"/>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="Greeter_SOAPBinding" type="tns:Greeter">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>

<wsdl:operation name="sayHi">
<soap:operation soapAction="" style="document"/>
<wsdl:input name="sayHiRequest">
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output name="sayHiResponse">
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>

<wsdl:operation name="greetMe">
<soap:operation soapAction="" style="document"/>
<wsdl:input name="greetMeRequest">
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output name="greetMeResponse">
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>

<wsdl:operation name="greetMeOneWay">
<soap:operation soapAction="" style="document"/>
<wsdl:input name="greetMeOneWayRequest">
<soap:body use="literal"/>
</wsdl:input>
</wsdl:operation>
<wsdl:operation name="pingMe">
<soap:operation style="document"/>
<wsdl:input>
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body use="literal"/>
</wsdl:output>
<wsdl:fault name="pingMeFault">
<soap:fault name="pingMeFault" use="literal"/>
</wsdl:fault>
</wsdl:operation>

</wsdl:binding>
<wsdl:service name="SOAPService">
<wsdl:port binding="tns:Greeter_SOAPBinding" name="SoapPort">
<soap:address location="http://localhost:9000/SoapContext/SoapPort"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>

</source>



== Hello World Dispatch Demo using Document/Literal Style ==



<source lang="java">

/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/

Hello World Dispatch Demo using Document/Literal Style
======================================================
The demo demonstrates the use of JAX-WS Dispatch and Provider interface.
The client side Dispatch instance invokes upon an endpoint using a JAX-WS
Provider implementor. There are three differnt invocations from the client.
The first uses the SOAPMessage data in MESSAGE mode. The second uses the DOMSource
data in MESSAGE mode. The third uses the DOMSource in PAYLOAD mode. The three
different messages are constructed by reading in the XML files found in the
src/demo/hwDispatch/client directory.
Please review the README in the samples directory before
continuing.

Prerequisite
------------
If your environment already includes cxf-manifest-incubator.jar on the
CLASSPATH, and the JDK and ant bin directories on the PATH
it is not necessary to set the environment as described in
the samples directory"s README. If your environment is not
properly configured, or if you are planning on using wsdl2java,
javac, and java to build and run the demos, you must set the
environment.

Building and running the demo using ant
---------------------------------------
From the samples/dispatch_provider directory, the ant build script
can be used to build and run the demo.
Using either UNIX or Windows:
ant build
ant server
ant client

To remove the code generated from the WSDL file and the .class
files, run:
ant clean

Building the demo using wsdl2java and javac
-------------------------------------------
From the samples/dispatch_provider directory, first create the target
directory build/classes and then generate code from the WSDL file.
For UNIX:
mkdir -p build/classes
wsdl2java -d build/classes -compile ./wsdl/hello_world.wsdl
For Windows:
mkdir build\classes
Must use back slashes.
wsdl2java -d build\classes -compile .\wsdl\hello_world.wsdl
May use either forward or back slashes.
Now compile the provided client and server applications with the commands:
For UNIX:

export CLASSPATH=$CLASSPATH:$CXF_HOME/lib/cxf-manifest-incubator.jar:./build/classes
javac -d build/classes src/demo/hwDispatch/client/*.java
javac -d build/classes src/demo/hwDispatch/server/*.java
For Windows:
set classpath=%classpath%;%CXF_HOME%\lib\cxf-manifest-incubator.jar;.\build\classes
javac -d build\classes src\demo\hwDispatch\client\*.java
javac -d build\classes src\demo\hwDispatch\server\*.java

Finally, copy resource files into the build/classes directory with the commands:
For UNIX:
cp ./src/demo/hwDispatch/client/*.xml ./build/classes/demo/hwDispatch/client
cp ./src/demo/hwDispatch/server/*.xml ./build/classes/demo/hwDispatch/server
For Windows:
copy src\demo\hwDispatch\client\*.xml build\classes\demo\hwDispatch\client
copy src\demo\hwDispatch\server\*.xml build\classes\demo\hwDispatch\server

Running the demo using java
---------------------------
From the samples/hello_world_dispatch directory run the commands, entered on a
single command line:
For UNIX (must use forward slashes):
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.hwDispatch.server.Server &
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.hwDispatch.client.Client ./wsdl/hello_world.wsdl
The server process starts in the background. After running the client,
use the kill command to terminate the server process.
For Windows (may use either forward or back slashes):
start
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.hwDispatch.server.Server
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.hwDispatch.client.Client .\wsdl\hello_world.wsdl
A new command windows opens for the server process. After running the
client, terminate the server process by issuing Ctrl-C in its command window.
To remove the code generated from the WSDL file and the .class
files, either delete the build directory and its contents or run:
ant clean
</source>



== The use of Apache CXF"s xml binding: how xml binding works with the doc-lit bare style ==



<source lang="java">

Hello World Demo using BARE Style in XML Binding
=============================================
This demo illustrates the use of Apache CXF"s xml binding. This
specific demo shows you how xml binding works with the
doc-lit bare style
Please review the README in the samples directory before
continuing.

Prerequisite
------------
If your environment already includes cxf-manifest-incubator.jar on the
CLASSPATH, and the JDK and ant bin directories on the PATH
it is not necessary to set the environment as described in
the samples directory"s README. If your environment is not
properly configured, or if you are planning on using wsdl2java,
javac, and java to build and run the demos, you must set the
environment.

Building and running the demo using ant
---------------------------------------
From the samples/hello_world_xml_bare directory, the ant build script
can be used to build and run the demo.
Using either UNIX or Windows:
ant build
ant server
ant client

To remove the code generated from the WSDL file and the .class
files, run:
ant clean

Building the demo using wsdl2java and javac
-------------------------------------------
From the samples/hello_world_xml_bare directory, first create the target
directory build/classes and then generate code from the WSDL file.
For UNIX:
mkdir -p build/classes
wsdl2java -d build/classes -compile ./wsdl/hello_world.wsdl
For Windows:
mkdir build\classes
Must use back slashes.
wsdl2java -d build\classes -compile .\wsdl\hello_world.wsdl
May use either forward or back slashes.
Now compile the provided client and server applications with the commands:
For UNIX:

export CLASSPATH=$CLASSPATH:$CXF_HOME/lib/cxf-manifest-incubator.jar:./build/classes
javac -d build/classes src/demo/hw/client/*.java
javac -d build/classes src/demo/hw/server/*.java
For Windows:
set classpath=%classpath%;%CXF_HOME%\lib\cxf-manifest-incubator.jar;.\build\classes
javac -d build\classes src\demo\hw\client\*.java
javac -d build\classes src\demo\hw\server\*.java

Running the demo using java
---------------------------
From the samples/hello_world_xml_bare directory run the following
commands. They are entered on a single command line.
For UNIX (must use forward slashes):
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.hw.server.Server &
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.hw.client.Client ./wsdl/hello_world.wsdl
The server process starts in the background. After running the client,
use the kill command to terminate the server process.
For Windows (may use either forward or back slashes):
start
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.hw.server.Server
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.hw.client.Client .\wsdl\hello_world.wsdl
A new command windows opens for the server process. After running the
client, terminate the server process by issuing Ctrl-C in its command window.
To remove the code generated from the WSDL file and the .class
files, either delete the build directory and its contents or run:
ant clean

Building and running the demo in a servlet container
----------------------------------------------------
From the samples/hello_world_xml_bare directory, the ant build script
can be used to create the war file that is deployed into the
servlet container.
Build the war file with the command:
ant war

Preparing deploy to APACHE TOMCAT
* set CATALINA_HOME environment to your TOMCAT home directory

Deploy the application into APACHE TOMCAT with the commond:
[NOTE] This step will check if the cxf jars present in Tomcat,
if not, it will automatically copy all the jars into CATALINA_HOME/shared/lib

ant deploy -Dtomcat=true
The servlet container will extract the war and deploy the application.

Using ant, run the client application with the command:
ant client-servlet -Dbase.url=http://localhost:#
Where # is the TCP/IP port used by the servlet container,
e.g., 8080.
Or
ant client-servlet -Dhost=localhost -Dport=8080
You can ignore the -Dhost and -Dport if your tomcat setup is same, i.e ant client-servlet
Using java, run the client application with the command:
For UNIX:

java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.hw.client.Client http://localhost:#/helloworld/services/hello_world?wsdl
For Windows:
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.hw.client.Client http://localhost:#/helloworld/services/hello_world?wsdl
Where # is the TCP/IP port used by the servlet container,
e.g., 8080.
Undeploy the application from the APACHE TOMCAT with the command:
ant undeploy -Dtomcat=true

Running demo with HTTP GET
----------------------------------------------------
APACHE CXF support HTTP GET to invoke the service, instead of running
ant client
you can use
ant client.get
to invoke the service with simple HttpURLConnection, or you can even
use your favoriate browser to get the results back.

///////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.hw.client;
import java.io.File;
import java.net.URL;
import javax.xml.namespace.QName;
import org.apache.hello_world_xml_http.bare.Greeter;
import org.apache.hello_world_xml_http.bare.XMLService;
import org.apache.hello_world_xml_http.bare.types.MyComplexStructType;
// import org.apache.hello_world_xml_http.bare.PingMeFault;
public final class Client {
private static final QName SERVICE_NAME = new QName("http://apache.org/hello_world_xml_http/bare",
"XMLService");
private static final QName PORT_NAME =
new QName("http://apache.org/hello_world_xml_http/bare", "XMLPort");
private Client() {
}
public static void main(String args[]) throws Exception {
if (args.length == 0) {
System.out.println("please specify wsdl");
System.exit(1);
}
URL wsdlURL;
File wsdlFile = new File(args[0]);
if (wsdlFile.exists()) {
wsdlURL = wsdlFile.toURL();
} else {
wsdlURL = new URL(args[0]);
}
System.out.println(wsdlURL);
XMLService service = new XMLService(wsdlURL, SERVICE_NAME);
Greeter greeter = (Greeter) service.getPort(PORT_NAME, Greeter.class);
System.out.println("Invoking sayHi...");
System.out.println("server responded with: " + greeter.sayHi());
System.out.println();
System.out.println("Invoking greetMe...");
System.out.println("server responded with: " + greeter.greetMe(System.getProperty("user.name")));
System.out.println();
MyComplexStructType argument = new MyComplexStructType();
MyComplexStructType retVal = null;
String str1 = "this is element 1";
String str2 = "this is element 2";
int int1 = 42;
argument.setElem1(str1);
argument.setElem2(str2);
argument.setElem3(int1);
System.out.println("Invoking sendReceiveData...");
retVal = greeter.sendReceiveData(argument);
System.out.println("Response from sendReceiveData operation :");
System.out.println("Element-1 : " + retVal.getElem1());
System.out.println("Element-2 : " + retVal.getElem2());
System.out.println("Element-3 : " + retVal.getElem3());
System.out.println();
/*
* try { System.out.println("Invoking pingMe, expecting exception...");
* port.pingMe(); } catch (PingMeFault ex) {
* System.out.println("Expected exception: PingMeFault has occurred: " +
* ex.getMessage()); }
*/
System.exit(0);
}
}

///////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.hw.client;
import java.io.ByteArrayOutputStream;
import java.io.InputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Properties;
import javax.xml.transform.OutputKeys;
import javax.xml.transform.Source;
import javax.xml.transform.Transformer;
import javax.xml.transform.TransformerFactory;
import javax.xml.transform.stream.StreamResult;
import javax.xml.transform.stream.StreamSource;
public final class Get {
private Get() {
}
public static void main(String args[]) throws Exception {
// Sent HTTP GET request to invoke sayHi
String target = "http://localhost:9000/XMLService/XMLPort/sayHi";
URL url = new URL(target);
HttpURLConnection httpConnection = (HttpURLConnection) url.openConnection();
httpConnection.connect();
System.out.println("Invoking server through HTTP GET to invoke sayHi");
InputStream in = httpConnection.getInputStream();
StreamSource source = new StreamSource(in);
printSource(source);
// Sent HTTP GET request to invoke greetMe FAULT
target = "http://localhost:9000/XMLService/XMLPort/greetMe/me/CXF";
url = new URL(target);
httpConnection = (HttpURLConnection) url.openConnection();
httpConnection.connect();
System.out.println("Invoking server through HTTP GET to invoke greetMe");
try {
in = httpConnection.getInputStream();
source = new StreamSource(in);
printSource(source);
} catch (Exception e) {
System.err.println("GreetMe Fault: " + e.getMessage());
}
InputStream err = httpConnection.getErrorStream();
source = new StreamSource(err);
printSource(source);
// Sent HTTP GET request to invoke greetMe
target = "http://localhost:9000/XMLService/XMLPort/greetMe/requestType/CXF";
url = new URL(target);
httpConnection = (HttpURLConnection) url.openConnection();
httpConnection.connect();
System.out.println("Invoking server through HTTP GET to invoke greetMe");
in = httpConnection.getInputStream();
source = new StreamSource(in);
printSource(source);
}
private static void printSource(Source source) {
try {
ByteArrayOutputStream bos = new ByteArrayOutputStream();
StreamResult sr = new StreamResult(bos);
Transformer trans = TransformerFactory.newInstance().newTransformer();
Properties oprops = new Properties();
oprops.put(OutputKeys.OMIT_XML_DECLARATION, "yes");
trans.setOutputProperties(oprops);
trans.transform(source, sr);
System.out.println();
System.out.println("**** Response ******");
System.out.println();
System.out.println(bos.toString());
bos.close();
System.out.println();
} catch (Exception e) {
e.printStackTrace();
}
}
}

///////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.hw.server;
import org.apache.hello_world_xml_http.bare.Greeter;
import org.apache.hello_world_xml_http.bare.types.MyComplexStructType;
@javax.jws.WebService(serviceName = "XMLService",
portName = "XMLPort",
endpointInterface = "org.apache.hello_world_xml_http.bare.Greeter",
targetNamespace = "http://apache.org/hello_world_xml_http/bare")
@javax.xml.ws.BindingType(value = "http://cxf.apache.org/bindings/xformat")
public class GreeterImpl implements Greeter {
public String greetMe(String me) {
// TODO Auto-generated method stub
System.out.println("received calling greetMe!");
return "Hello " + me;
}
public String sayHi() {
// TODO Auto-generated method stub
System.out.println("received calling sayHi!");
return "Bonjour";
}
public MyComplexStructType sendReceiveData(MyComplexStructType in) {
// TODO Auto-generated method stub
System.out.println("received calling sendReceiveData!");
return in;
}
public String testMultiParamPart(MyComplexStructType in2, String in1) {
// TODO Auto-generated method stub
in2.setElem1(in1);
return "Bonjour";
}
}

///////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.hw.server;
import javax.xml.ws.Endpoint;
public class Server {
protected Server() throws Exception {
System.out.println("Starting Server");
Object implementor = new GreeterImpl();
String address = "http://localhost:9000/XMLService/XMLPort";
Endpoint.publish(address, implementor);
}
public static void main(String args[]) throws Exception {
new Server();
System.out.println("Server ready...");
Thread.sleep(5 * 60 * 1000);
System.out.println("Server exiting");
System.exit(0);
}
}
///////////////////////////////////////////////////////////////////
<?xml version="1.0" encoding="UTF-8"?>

<wsdl:definitions name="HelloWorld" targetNamespace="http://apache.org/hello_world_xml_http/bare"
xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:http="http://schemas.xmlsoap.org/wsdl/http/"
xmlns:xformat="http://cxf.apache.org/bindings/xformat"
xmlns:tns="http://apache.org/hello_world_xml_http/bare"
xmlns:x1="http://apache.org/hello_world_xml_http/bare/types"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<wsdl:types>
<schema targetNamespace="http://apache.org/hello_world_xml_http/bare/types"
xmlns="http://www.w3.org/2001/XMLSchema"
elementFormDefault="qualified">
<element name="responseType" type="xsd:string"/>
<element name="requestType" type="xsd:string"/>
<element name="myComplexStruct" type="x1:myComplexStructType"/>

<complexType name="myComplexStructType">
<sequence>
<element name="elem1" type="xsd:string"/>
<element name="elem2" type="xsd:string"/>
<element name="elem3" type="xsd:int"/>
</sequence>
</complexType>
</schema>
</wsdl:types>

<wsdl:message name="sayHiRequest"/>

<wsdl:message name="sayHiResponse">
<wsdl:part type="xsd:string" name="out"/>
</wsdl:message>

<wsdl:message name="greetMeRequest">
<wsdl:part element="x1:requestType" name="me"/>
</wsdl:message>

<wsdl:message name="greetMeResponse">
<wsdl:part element="x1:responseType" name="theResponse"/>
</wsdl:message>

<wsdl:message name="sendReceiveDataRequest">
<wsdl:part type="x1:myComplexStructType" name="in"/>
</wsdl:message>

<wsdl:message name="sendReceiveDataResponse">
<wsdl:part type="x1:myComplexStructType" name="out"/>
</wsdl:message>
<wsdl:message name="multiParamPartRequest">
<wsdl:part element="x1:requestType" name="in1"/>
<wsdl:part element="x1:myComplexStruct" name="in2"/>
</wsdl:message>

<wsdl:message name="multiParamPartResponse">
<wsdl:part element="x1:responseType" name="out1"/>
</wsdl:message>
<wsdl:portType name="Greeter">
<wsdl:operation name="sayHi">
<wsdl:input message="tns:sayHiRequest" name="sayHiRequest"/>
<wsdl:output message="tns:sayHiResponse" name="sayHiResponse"/>
</wsdl:operation>
<wsdl:operation name="greetMe">
<wsdl:input message="tns:greetMeRequest" name="greetMeRequest"/>
<wsdl:output message="tns:greetMeResponse" name="greetMeResponse"/>
</wsdl:operation>
<wsdl:operation name="sendReceiveData">
<wsdl:input message="tns:sendReceiveDataRequest" name="SendReceiveDataRequest"/>
<wsdl:output message="tns:sendReceiveDataResponse" name="SendReceiveDataResponse"/>
</wsdl:operation>
<wsdl:operation name="testMultiParamPart" parameterOrder="in2 in1">
<wsdl:input message="tns:multiParamPartRequest" name="multiParamPartRequest"/>
<wsdl:output message="tns:multiParamPartResponse" name="multiParamPartResponse"/>
</wsdl:operation>
</wsdl:portType>

<wsdl:binding name="Greeter_XMLBinding" type="tns:Greeter">
<xformat:binding/>
<wsdl:operation name="sayHi">
<wsdl:input>
<xformat:body rootNode="tns:sayHi"/>
</wsdl:input>
<wsdl:output/>
</wsdl:operation>

<wsdl:operation name="greetMe">
<wsdl:input/>
<wsdl:output/>
</wsdl:operation>

<wsdl:operation name="sendReceiveData">
<wsdl:input/>
<wsdl:output/>
</wsdl:operation>
<wsdl:operation name="testMultiParamPart">
<wsdl:input>
<xformat:body rootNode="tns:multiParamRootReq"/>
</wsdl:input>
<wsdl:output/>
</wsdl:operation>
</wsdl:binding>

<wsdl:service name="XMLService">
<wsdl:port binding="tns:Greeter_XMLBinding" name="XMLPort">
<http:address location="http://localhost:9000/XMLService/XMLPort"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>

</source>



== XFire CXF integration ==

Java/Web Services SOA/REST

2010-06-01T07:27:31Z

Admin: 1 версия

== Axis2 client API has facilities to invoke REST interfaces ==



<source lang="java">

Sample for Yahoo - Search - REST
=================================
Introduction
============
Axis2 client API has facilities to invoke REST interfaces. The API to be used is almost the same
as the one we use while invoking with REST.
Yahoo provides a REST API to call its search service. This sample demonstrates how to call Yahoo
search service using an Axis2 client.
Pre-Requisites
==============
Apache Ant 1.6.2 or later
Running The Sample
==================
Type "ant" from Axis2_HOME/samples/yahoorestsearch directory.
Help
====
Please contact axis-user list (axis-user@ws.apache.org) if you have any trouble running the sample.
</source>



== REST based Web Services using the HTTP binding and JAX-WS Provider/Dispatch ==



<source lang="java">

RESTful Hello World Demo
========================
The demo shows REST based Web Services using the HTTP binding and
JAX-WS Provider/Dispatch. The REST server provides the following services:
A RESTful customer service is provided on URL http://localhost:9000/customerservice/customer.
Users access this URI to query or update customer info.
A HTTP GET request to URL http://localhost:9000/customerservice/customer returns
a list of customer hyperlinks. This allows client navigates through the
application states. The XML document returned:
<Customers>
<Customer href="http://localhost/customerservice/customer?id=1234">
<id>1234</id>
</Customer>
<Customer href="http://localhost/customerservice/customer?id=1235">
<id>1235</id>
</Customer>
<Customer href="http://localhost/customerservice/customer?id=1236">
<id>1236</id>
</Customer>
</Customers>
A HTTP GET request to URL http://localhost:9000/customerservice/customer?id=1234
returns a customer instance whose id is 1234. The XML document returned:
<Customer>
<id>1234</id>
<name>John</name>
<phoneNumber>123456</phoneNumber>
</Customer>
A HTTP POST request to URL http://localhost:9000/customerservice/customer
with the data:
<Customer>
<id>1234</id>
<name>John</name>
<phoneNumber>123456</phoneNumber>
</Customer>
updates customer 1234 with the data provided.
The client code demonstrates how to send HTTP POST with XML data using
JAX-WS Dispatch and how to send HTTP GET using URL.openStream(). The
server code demonstrates how to build a RESTful endpoints through
JAX-WS Provider interface.

Please review the README in the samples directory before
continuing.

Prerequisites
------------
If your environment already includes cxf-manifest-incubator.jar on the
CLASSPATH, and the JDK and ant bin directories on the PATH
it is not necessary to set the environment as described in
the samples directory README. If your environment is not
properly configured, or if you are planning on using wsdl2java,
javac, and java to build and run the demos, you must set the
environment.

Building and running the demo using ant
---------------------------------------
From the samples/restful directory, the ant build script
can be used to build and run the demo.
Using either UNIX or Windows:
ant build
ant server
ant client

To remove the code generated from the WSDL file and the .class
files, run:
ant clean

Building the demo using wsdl2java and javac
-------------------------------------------
From the samples/restful directory, first create the target
directory build/classes and then compile the provided client
and server applications with the commands:
For UNIX:
mkdir -p build/classes

export CLASSPATH=$CLASSPATH:$CXF_HOME/lib/cxf-manifest-incubator.jar:./build/classes
javac -d build/classes src/demo/restful/client/*.java
javac -d build/classes src/demo/restful/server/*.java
For Windows:
mkdir build\classes
Must use back slashes.
set classpath=%classpath%;%CXF_HOME%\lib\cxf-manifest-incubator.jar;.\build\classes
javac -d build\classes src\demo\restful\client\*.java
javac -d build\classes src\demo\restful\server\*.java

Finally, copy resource files into the build/classes directory with the commands:
For UNIX:
cp ./src/demo/restful/client/*.xml ./build/classes/demo/restful/client
cp ./src/demo/restful/server/*.xml ./build/classes/demo/restful/server
For Windows:
copy src\demo\restful\client\*.xml build\classes\demo\restful\client
copy src\demo\restful\server\*.xml build\classes\demo\restful\server

Running the demo using java
---------------------------
From the samples/restful directory run the following commands. They
are entered on a single command line.
For UNIX (must use forward slashes):
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.restful.server.Server &
java -Djava.util.logging.config.file=$CXF_HOME/etc/logging.properties
demo.restful.client.Client
The server process starts in the background. After running the client,
use the kill command to terminate the server process.
For Windows (may use either forward or back slashes):
start
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.restful.server.Server
java -Djava.util.logging.config.file=%CXF_HOME%\etc\logging.properties
demo.restful.client.Client
A new command windows opens for the server process. After running the
client, terminate the server process by issuing Ctrl-C in its command window.
To remove the code generated from the WSDL file and the .class
files, either delete the build directory and its contents or run:
ant clean
//////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.restful.client;
import java.io.ByteArrayOutputStream;
import java.io.InputStream;
import java.net.URI;
import java.net.URL;
import java.util.Map;
import java.util.Properties;
import javax.xml.namespace.QName;
import javax.xml.transform.OutputKeys;
import javax.xml.transform.Source;
import javax.xml.transform.Transformer;
import javax.xml.transform.TransformerFactory;
import javax.xml.transform.dom.DOMSource;
import javax.xml.transform.stream.StreamResult;
import javax.xml.transform.stream.StreamSource;
import javax.xml.ws.Dispatch;
import javax.xml.ws.Service;
import javax.xml.ws.handler.MessageContext;
import javax.xml.ws.http.HTTPBinding;
import org.w3c.dom.Document;
import org.apache.cxf.helpers.XMLUtils;
public final class Client {
private Client() {
}
public static void main(String args[]) throws Exception {
QName serviceName = new QName("http://apache.org/hello_world_xml_http/wrapped",
"cutomerservice");
QName portName = new QName("http://apache.org/hello_world_xml_http/wrapped",
"RestProviderPort");
String endpointAddress = "http://localhost:9000/customerservice/customer";
// Sent HTTP GET request to query all customer info
URL url = new URL(endpointAddress);
System.out.println("Invoking server through HTTP GET to query all customer info");
InputStream in = url.openStream();
StreamSource source = new StreamSource(in);
printSource(source);
// Sent HTTP GET request to query customer info
url = new URL(endpointAddress + "?id=1234");
System.out.println("Invoking server through HTTP GET to query customer info");
in = url.openStream();
source = new StreamSource(in);
printSource(source);
// Sent HTTP POST request to update customer info using JAX-WS Dispatch
URI endpointURI = new URI(endpointAddress.toString());
String path = null;
if (endpointURI != null) {
path = endpointURI.getPath();
}
Service service = Service.create(serviceName);
service.addPort(portName, HTTPBinding.HTTP_BINDING, endpointAddress);
Dispatch<DOMSource> dispatcher = service.createDispatch(portName,
DOMSource.class, Service.Mode.PAYLOAD);
Map<String, Object> requestContext = dispatcher.getRequestContext();
Client client = new Client();
InputStream is = client.getClass().getResourceAsStream("CustomerJohnReq.xml");
Document doc = XMLUtils.parse(is);
DOMSource reqMsg = new DOMSource(doc);
requestContext.put(MessageContext.HTTP_REQUEST_METHOD, "POST");
System.out.println("Invoking through HTTP POST to update customer using JAX-WS Dispatch");
DOMSource result = dispatcher.invoke(reqMsg);
printSource(result);
System.out.println("Client Invoking is succeeded!");
System.exit(0);
}
private static void printSource(Source source) {
try {
ByteArrayOutputStream bos = new ByteArrayOutputStream();
StreamResult sr = new StreamResult(bos);
Transformer trans = TransformerFactory.newInstance().newTransformer();
Properties oprops = new Properties();
oprops.put(OutputKeys.OMIT_XML_DECLARATION, "yes");
trans.setOutputProperties(oprops);
trans.transform(source, sr);
System.out.println("**** Response ******");
System.out.println(bos.toString());
bos.close();
System.out.println();
} catch (Exception e) {
e.printStackTrace();
}
}
}
//////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.restful.server;
import java.io.InputStream;
import javax.annotation.Resource;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.transform.dom.DOMSource;
import javax.xml.ws.Provider;
import javax.xml.ws.Service;
import javax.xml.ws.ServiceMode;
import javax.xml.ws.WebServiceContext;
import javax.xml.ws.WebServiceProvider;
import javax.xml.ws.handler.MessageContext;
import org.w3c.dom.Document;
import org.apache.cxf.message.Message;
@WebServiceProvider()
@ServiceMode(value = Service.Mode.PAYLOAD)
public class RestSourcePayloadProvider implements Provider<DOMSource> {
@Resource
protected WebServiceContext wsContext;
public RestSourcePayloadProvider() {
}
public DOMSource invoke(DOMSource request) {
MessageContext mc = wsContext.getMessageContext();
String path = (String)mc.get(Message.PATH_INFO);
String query = (String)mc.get(Message.QUERY_STRING);
String httpMethod = (String)mc.get(Message.HTTP_REQUEST_METHOD);
System.out.println("--path--- " + path);
System.out.println("--query--- " + query);
System.out.println("--httpMethod--- " + httpMethod);
if (httpMethod.equalsIgnoreCase("POST")) {
// TBD: parse query info from DOMSource
System.out.println("---Invoking updateCustomer---");
return updateCustomer(request);
} else if (httpMethod.equalsIgnoreCase("GET")) {
if (path.equals("/customerservice/customer") && query == null) {
System.out.println("---Invoking getAllCustomers---");
return getAllCustomers();
} else if (path.equals("/customerservice/customer") && query != null) {
System.out.println("---Invoking getCustomer---");
return getCustomer(query);
}
}
return null;
}
private DOMSource getAllCustomers() {
return createDOMSource("CustomerAllResp.xml");
}
private DOMSource getCustomer(String customerID) {
return createDOMSource("CustomerJohnResp.xml");
}
private DOMSource updateCustomer(DOMSource request) {
// TBD: returned update customer info
return createDOMSource("CustomerJohnResp.xml");
}
private DOMSource createDOMSource(String fileName) {
DocumentBuilderFactory factory;
DocumentBuilder builder;
Document document = null;
DOMSource response = null;
try {
factory = DocumentBuilderFactory.newInstance();
//factory.setValidating(true);
builder = factory.newDocumentBuilder();
InputStream greetMeResponse = getClass().getResourceAsStream(fileName);
document = builder.parse(greetMeResponse);
response = new DOMSource(document);
} catch (Exception e) {
e.printStackTrace();
}
return response;
}
}

//////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.restful.server;
import javax.xml.ws.Endpoint;
import javax.xml.ws.http.HTTPBinding;
public class Server {
protected Server() throws Exception {
System.out.println("Starting Server");
Endpoint e = Endpoint.create(HTTPBinding.HTTP_BINDING, new RestSourcePayloadProvider());
String address = "http://localhost:9000/customerservice/customer";
e.publish(address);
}
public static void main(String args[]) throws Exception {
new Server();
System.out.println("Server ready...");
Thread.sleep(5 * 60 * 1000);
System.out.println("Server exiting");
System.exit(0);
}
}

</source>



== This demo shows how to create RESTful services using CXF"s HTTP binding ==



<source lang="java">

This demo shows how to create RESTful services using CXF"s HTTP binding.
The server in the demo creates 3 different endpoints: a RESTful XML
endpoint, a RESTful JSON endpoint, and a SOAP endpoint.
[RUNNING THE DEMO]
The demo has a class called com.acme.customer.Main which starts up various
endpoints. To start this server run the command:
$ ant server
Once it is running try going to the following URLs:
http://localhost:8080/xml/customers
http://localhost:8080/json/customers
http://localhost:8080/xml/customers/123
http://localhost:8080/json/customers/123
These will serve out XML and JSON representation of the resources.
There is an HTML page that is served by CXF so you can try using the
JSON service via Javascript. Just go to:
http://localhost:8080/test.html
Included are some example JSON and XML files so you can add or update
customers using wget. Try the following commands and look at the results:
wget --post-file add.json http://localhost:8080/json/customers
wget --post-file add.xml http://localhost:8080/xml/customers
wget --post-file update.xml http://localhost:8080/xml/customers/123
And if you are interested in SOAP you can try the SOAP endpoint:
http://localhost:8080/soap?wsdl
[RUNNING THE CLIENT]
The demo also includes a Client class which accesses data using
HTTP. To run this demo, do:
$ ant client

</source>

Java/Web Services SOA/WS Policy

2010-06-01T07:27:30Z

Admin: 1 версия

== This demo shows how the CXF WS-Policy framework in Apache CXF uses WSDL 1.1 Policy attachments to enable the use of WS-Addressing ==



<source lang="java">

WS-Policy Demo
==============
This demo shows how the CXF WS-Policy framework in Apache CXF uses
WSDL 1.1 Policy attachments to enable the use of WS-Addressing.
While most of the demo is very similar to the ws_addressing demo, there
are two major differences:
1. � Policy element containing an Addressing assertion is attached to
the port element in the demo"s wsdl.
2. The configuration files for the client and server specify that the
CXF policy engine should be enabled.
In addition, the configuration file for the server tells the policy
engine where to look for external policy attachments. This is necessary
since neither the implementor not the interface specify wsdlLocation
in their WebService annotation (the client could also use external policy
attachments instead of WSDL 1.1 attachments).
Note that, apart from the configuration of the decoupled http endpoint
on which the client receives responses from the server, nothing else
needs to be configured. In particular, there is no need to specify the
WS-Addressing interceptors. The internals of what is involved in
ensuring that addressing headers are added to the messages (namely:
the addition of two addressing interceptors to the inbound and outbound
fault and message processing chains) are left to the policy framework,
or rather: its built-in support for the Addressing assertion.
Please review the README in the samples directory before continuing.

Prerequisite
------------
If your environment already includes cxf-manifest-incubator.jar on the CLASSPATH,
and the JDK and ant bin directories on the PATH, it is not necessary to
run the environment script described in the samples directory README.
If your environment is not properly configured, or if you are planning
on using wsdl2java, javac, and java to build and run the demos, you must
set the environment by running the script.

Building and running the demo using ant
---------------------------------------
From the samples/ws_policy directory, the ant build script can be used to
build and run the demo. The server and client targets automatically build
the demo.
Using either UNIX or Windows:
ant server
ant client
Although not explicitly instructed to use these interceptors,
both client and server will use the MAPAggregator and MAPCodec
interceptors to aggregate and encode the WS-Addressing MAPs.
To remove the code generated from the WSDL file and the .class
files, run:
ant clean

Buildng the demo using wsdl2java and javac
------------------------------------------
From the samples/ws_policy directory, first create the target directory
build/classes and then generate code from the WSDL file.
For UNIX:
mkdir -p build/classes
wsdl2java -d build/classes -compile ./wsdl/hello_world_addr.wsdl
For Windows:
mkdir build\classes
Must use back slashes.
wsdl2java -d build\classes -compile .\wsdl\hello_world_addr.wsdl
May use either forward or back slashes.
Now compile the provided client and server applications with the commands:
For UNIX:

export CLASSPATH=$CLASSPATH:$CXF_HOME/lib/cxf-manifest-incubator.jar:./build/classes:.
javac -d build/classes src/demo/ws_policy/common/*.java
javac -d build/classes src/demo/ws_policy/client/*.java
javac -d build/classes src/demo/ws_policy/server/*.java
For Windows:
set classpath=%classpath%;%CXF_HOME%\lib\cxf-manifest-incubator.jar;.\build\classes;.
javac -d build\classes src\demo\ws_policy\common\*.java
javac -d build\classes src\demo\ws_policy\client\*.java
javac -d build\classes src\demo\ws_policy\server\*.java
Running the demo using java
---------------------------
From the samples/ws_policy directory run the commands (entered on a single command line):
For UNIX (must use forward slashes):
java -Djava.util.logging.config.file=./logging.properties
-Dcxf.config.file=server.xml
demo.ws_policy.server.Server &
java -Djava.util.logging.config.file=./logging.properties
-Dcxf.config.file=client.xml
demo.ws_policy.client.Client
The server process starts in the background.
For Windows (may use either forward or back slashes):
start
java -Djava.util.logging.config.file=.\logging.properties
-Dcxf.config.file=server.xml
demo.ws_policy.server.Server
java -Djava.util.logging.config.file=.\logging.properties
-Dcxf.config.file=client.xml
demo.ws_policy.client.Client
The server process starts in a new command window.
After running the client, terminate the server process.
To remove the code generated from the WSDL file and the .class
files, either delete the build directory and its contents or run:
ant clean

/////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.ws_policy.client;
import org.apache.hello_world_soap_http.Greeter;
import org.apache.hello_world_soap_http.PingMeFault;
import org.apache.hello_world_soap_http.SOAPService;
public final class Client {

private static final String USER_NAME = System.getProperty("user.name");
private Client() {
}
public static void main(String args[]) {
try {
SOAPService service = new SOAPService();
Greeter port = service.getSoapPort();
System.out.println("Invoking sayHi...");
String resp = port.sayHi();
System.out.println("Server responded with: " + resp + "\n");

System.out.println("Invoking greetMe...");
resp = port.greetMe(USER_NAME);
System.out.println("Server responded with: " + resp + "\n");

System.out.println("Invoking greetMeOneWay...");
port.greetMeOneWay(USER_NAME);
System.out.println("No response from server as method is OneWay\n");

try {
System.out.println("Invoking pingMe, expecting exception...");
port.pingMe();
} catch (PingMeFault ex) {
System.out.println("Expected exception occurred: " + ex);
}
} catch (Exception ex) {
ex.printStackTrace();
} finally {
System.exit(0);
}
}
}

////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.ws_policy.rumon;
import java.util.logging.LogRecord;
import java.util.logging.SimpleFormatter;
public class ConciseFormatter extends SimpleFormatter {
public synchronized String format(LogRecord record) {
String longForm = super.format(record);
String shortForm = longForm.indexOf("INFO: ") > 0
? longForm.substring(longForm.indexOf("INFO: ") + 6)
: longForm;
return shortForm;
}
}

/////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.ws_policy.server;
import java.util.logging.Logger;
import javax.jws.WebService;
import org.apache.hello_world_soap_http.Greeter;
import org.apache.hello_world_soap_http.PingMeFault;
import org.apache.hello_world_soap_http.types.FaultDetail;

@WebService(name = "Greeter",
serviceName = "SOAPService",
targetNamespace = "http://apache.org/hello_world_soap_http")

public class GreeterImpl implements Greeter {
private static final Logger LOG =
Logger.getLogger(GreeterImpl.class.getPackage().getName());

/* (non-Javadoc)
* @see org.apache.hello_world_soap_http.Greeter#greetMe(java.lang.String)
*/
public String greetMe(String me) {
LOG.info("Executing operation greetMe");
System.out.println("Executing operation greetMe");
System.out.println("Message received: " + me + "\n");
return "Hello " + me;
}

/* (non-Javadoc)
* @see org.apache.hello_world_soap_http.Greeter#greetMeOneWay(java.lang.String)
*/
public void greetMeOneWay(String me) {
LOG.info("Executing operation greetMeOneWay");
System.out.println("Executing operation greetMeOneWay\n");
System.out.println("Hello there " + me);
}
/* (non-Javadoc)
* @see org.apache.hello_world_soap_http.Greeter#sayHi()
*/
public String sayHi() {
LOG.info("Executing operation sayHi");
System.out.println("Executing operation sayHi\n");
return "Bonjour";
}

public void pingMe() throws PingMeFault {
FaultDetail faultDetail = new FaultDetail();
faultDetail.setMajor((short)2);
faultDetail.setMinor((short)1);
LOG.info("Executing operation pingMe, throwing PingMeFault exception");
System.out.println("Executing operation pingMe, throwing PingMeFault exception\n");
throw new PingMeFault("PingMeFault raised by server", faultDetail);
}

}

/////////////////////////////////////////////////////////////////////////
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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.
*/
package demo.ws_policy.server;
import javax.xml.ws.Endpoint;
public class Server {
protected Server() throws Exception {
System.out.println("Starting Server");

Object implementor = new GreeterImpl();
String address = "http://localhost:9000/SoapContext/SoapPort";
Endpoint.publish(address, implementor);
}

public static void main(String args[]) throws Exception {
new Server();
System.out.println("Server ready...");

Thread.sleep(5 * 60 * 1000);
System.out.println("Server exiting");
System.exit(0);
}
}

////////////////////////////////////////////////////////////////////////

<?xml version="1.0" encoding="UTF-8"?>

<wsdl:definitions name="HelloWorld" targetNamespace="http://apache.org/hello_world_soap_http"
xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:tns="http://apache.org/hello_world_soap_http"
xmlns:x1="http://apache.org/hello_world_soap_http/types"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<wsdl:types>
<schema targetNamespace="http://apache.org/hello_world_soap_http/types"
xmlns="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
<element name="sayHi">
<complexType/>
</element>
<element name="sayHiResponse">
<complexType>
<sequence>
<element name="responseType" type="xsd:string"/>
</sequence>
</complexType>
</element>
<element name="greetMe">
<complexType>
<sequence>
<element name="requestType" type="xsd:string"/>
</sequence>
</complexType>
</element>
<element name="greetMeResponse">
<complexType>
<sequence>
<element name="responseType" type="xsd:string"/>
</sequence>
</complexType>
</element>
<element name="greetMeOneWay">
<complexType>
<sequence>
<element name="requestType" type="xsd:string"/>
</sequence>
</complexType>
</element>
<element name="pingMe">
<complexType/>
</element>
<element name="pingMeResponse">
<complexType/>
</element>
<element name="faultDetail">
<complexType>
<sequence>
<element name="minor" type="xsd:short"/>
<element name="major" type="xsd:short"/>
</sequence>
</complexType>
</element>
</schema>
</wsdl:types>
<wsdl:message name="sayHiRequest">
<wsdl:part element="x1:sayHi" name="in"/>
</wsdl:message>
<wsdl:message name="sayHiResponse">
<wsdl:part element="x1:sayHiResponse" name="out"/>
</wsdl:message>
<wsdl:message name="greetMeRequest">
<wsdl:part element="x1:greetMe" name="in"/>
</wsdl:message>
<wsdl:message name="greetMeResponse">
<wsdl:part element="x1:greetMeResponse" name="out"/>
</wsdl:message>
<wsdl:message name="greetMeOneWayRequest">
<wsdl:part element="x1:greetMeOneWay" name="in"/>
</wsdl:message>
<wsdl:message name="pingMeRequest">
<wsdl:part name="in" element="x1:pingMe"/>
</wsdl:message>
<wsdl:message name="pingMeResponse">
<wsdl:part name="out" element="x1:pingMeResponse"/>
</wsdl:message>
<wsdl:message name="pingMeFault">
<wsdl:part name="faultDetail" element="x1:faultDetail"/>
</wsdl:message>

<wsdl:portType name="Greeter">
<wsdl:operation name="sayHi">
<wsdl:input message="tns:sayHiRequest" name="sayHiRequest"/>
<wsdl:output message="tns:sayHiResponse" name="sayHiResponse"/>
</wsdl:operation>

<wsdl:operation name="greetMe">
<wsdl:input message="tns:greetMeRequest" name="greetMeRequest"/>
<wsdl:output message="tns:greetMeResponse" name="greetMeResponse"/>
</wsdl:operation>

<wsdl:operation name="greetMeOneWay">
<wsdl:input message="tns:greetMeOneWayRequest" name="greetMeOneWayRequest"/>
</wsdl:operation>
<wsdl:operation name="pingMe">
<wsdl:input name="pingMeRequest" message="tns:pingMeRequest"/>
<wsdl:output name="pingMeResponse" message="tns:pingMeResponse"/>
<wsdl:fault name="pingMeFault" message="tns:pingMeFault"/>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="Greeter_SOAPBinding" type="tns:Greeter">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>

<wsdl:operation name="sayHi">
<soap:operation soapAction="" style="document"/>
<wsdl:input name="sayHiRequest">
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output name="sayHiResponse">
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>

<wsdl:operation name="greetMe">
<soap:operation soapAction="" style="document"/>
<wsdl:input name="greetMeRequest">
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output name="greetMeResponse">
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>

<wsdl:operation name="greetMeOneWay">
<soap:operation soapAction="" style="document"/>
<wsdl:input name="greetMeOneWayRequest">
<soap:body use="literal"/>
</wsdl:input>
</wsdl:operation>
<wsdl:operation name="pingMe">
<soap:operation style="document"/>
<wsdl:input>
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body use="literal"/>
</wsdl:output>
<wsdl:fault name="pingMeFault">
<soap:fault name="pingMeFault" use="literal"/>
</wsdl:fault>
</wsdl:operation>

</wsdl:binding>
<wsdl:service name="SOAPService">
<wsdl:port binding="tns:Greeter_SOAPBinding" name="SoapPort">
<soap:address location="http://localhost:9000/SoapContext/SoapPort"/>
<wsp:Policy xmlns:wsp="http://www.w3.org/2006/07/ws-policy">
<wsam:Addressing xmlns:wsam="http://www.w3.org/2007/02/addressing/metadata">
<wsp:Policy/>
</wsam:Addressing>
</wsp:Policy>
<wswa:UsingAddressing xmlns:wswa="http://www.w3.org/2005/02/addressing/wsdl"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>

</source>

Java/Web Services SOA/POJO Web service

2010-06-01T07:27:30Z

Admin: 1 версия

== An example POJO Web service: how to expose the methods of a Java class as a Web service using Axis2. ==



<source lang="java">

Sample: POJO (Plain Old Java Object)
====================================
Introduction
============
This is an example POJO Web service. It shows how to expose the methods of a Java class as a Web
service using Aixs2.

Prerequisites
=============
To build the sample service you must have ant-1.6.x installed in your system.
To set AXIS2_HOME in Unix/Linux type:
$export AXIS2_HOME=<path to axis2 distribution>
Building the Service
====================
To build the sample service, type: $ant generate.service or just ant
This will build the AddressBookService.aar in the build directory and copy it to the
<AXIS2_HOME>/repository/services directory.
You can start the Axis2 server by running either axis2server.bat (on Windows) or axis2server.sh
(on Linux)that are located in <AXIS2_HOME>/bin directory.
The WSDL for this service should be viewable at:
http://<yourhost>:<yourport>/axis2/services/AddressBookService?wsdl
(e.g. http://localhost:8080/axis2/services/AddressBookService?wsdl)
src/sample/addressbook/rpcclient/AddressBookRPCClient.java is a Client that uses RPCServiceClient
to invoke the methods of this web services just like the method invocations of a Java object.

Running the Client
==================
To compile and run, type
$ant rpc.client
src/sample/addressbook/adbclient/AddressBookADBClient is Client that uses a generated stub with ADB
to invoke the methods of this web service.
To generate the stub, compile and run, type
$ant adb.client -Dwsdl=http://<yourhost>:<yourport>/axis2/services/AddressBookService?wsdl
Help
====
Please contact axis-user list (axis-user@ws.apache.org) if you have any trouble running the sample.
</source>



== How to expose the getters and setters of a Service: this demo uses the Spring to initialize the property of the Service ==



<source lang="java">

POJO Web Services using Apache Axis2- Sample 2
==============================================
This sample contains source code for the xdocs/1_1/pojoguide.html document found in
the extracted Axis2 Documents Distribution. For a more detailed description on the
source code kindly see this "POJO Web Services using Apache Axis2" document.
In this specific sample you"ll be shown how to take a POJO (Plain Old Java Object)
based on the Spring Framework, and deploy that as an AAR packaged Web service on Tomcat.
This is a quick way to get a Web service up and running in no time.
Introduction
============
This sample shows how to expose the getters and setters of WeatherSpringService that
takes Weather type Java Object as the argument and the return type. It uses the Spring
framework to initialize the weather property of the WeatherSpringService.

Pre-Requisites
==============
Apache Ant 1.6.2 or later
Spring-1.2.6.jar or later
You need to have this jar in your build and runtime class path. The easiest way to do this
is to copy it to Axis2_HOME/lib directory.
Building the Service
====================
Type $ant from Axis2_HOME/samples/pojoguidespring

Running the Client
==================
Type $ant rpc.client from from Axis2_HOME/samples/pojoguidespring
Help
====
Please contact axis-user list (axis-user@ws.apache.org) if you have any trouble running the sample.
</source>



== In this sample, we are deploying a POJO after writing a services.xml and creating an aar ==



<source lang="java">

Axis2 Quick Start Guide- Sample 1
=================================
This sample contains source code for the xdocs/1_1/quickstartguide.html document found in
the extracted Axis2 Documents Distribution. For a more detailed description on the
source code kindly see this "Axis2 Quick Start Guide" document.
Introduction
============
In this sample, we are deploying a POJO after writing a services.xml and
creating an aar. We also test the getPrice and update methods using a browser.
Pre-Requisites
==============
Apache Ant 1.6.2 or later
Building the Service
====================
Type "ant generate.service" or just "ant" from Axis2_HOME/samples/quickstart directory
and then deploy the Axis2_HOME/samples/quickstart/build/StockQuoteService.aar
Generate WSDL
==============
Type "ant generate.wsdl" from Axis2_HOME/samples/quickstart directory which generates a
WSDL file for the above Web service and it will be placed in Axis2_HOME/samples/quickstart/build
directory.
Running the Client
==================
- From your browser, If you point to the following URL:
http://localhost:8080/axis2/services/StockQuoteService/getPrice?symbol=IBM
You will get the following response:
<ns:getPriceResponse><ns:return>42.0</ns:return></ns:getPriceResponse>
- If you invoke the update method like so:
http://localhost:8080/axis2/services/StockQuoteService/update?symbol=IBM&price=100
And then execute the first getPrice url. You can see that the price got updated.
Help
====
Please contact axis-user list (axis-user@ws.apache.org) if you have any trouble running the sample.
</source>



== This sample shows how to expose a Java class as a web service ==



<source lang="java">

POJO Web Services using Apache Axis2- Sample 1
=============================================
This sample contains source code for the xdocs/1_1/pojoguide.html document found in
the extracted Axis2 Documents Distribution. For a more detailed description on the
source code kindly see this "POJO Web Services using Apache Axis2" document.
The above mentioned document shows you how to take a simple POJO (Plain Old Java
Object), and deploy it on Apache Tomcat as a Web service in the exploded directory
format. This is a quick way to get a Web service up and running in no time.
Introduction
============
This sample shows how to expose a Java class as a web service.
The WeatherService Java class provides methods to get and set a Weather
type Java objects. The client uses RPCServiceClient to invoke those two
methods just as Java object method invocation.
Prerequisites
==============
Apache Ant 1.6.2 or later
Building the Service
====================
Type $ant from Axis2_HOME/samples/pojoguide

Running the Client
==================
Type $ant rpc.client

Help
====
Please contact axis-user list (axis-user@ws.apache.org) if you have any trouble running the sample.
</source>

Java/Generics/Generic Class

2010-06-01T07:27:29Z

Admin: 1 версия

== A nongeneric class can be the superclass of a generic subclass. ==



<source lang="java">

/*
Java 2, v5.0 (Tiger) New Features
by Herbert Schildt
ISBN: 0072258543
Publisher: McGraw-Hill/Osborne, 2004
*/

// A nongeneric class.
class NonGen {
int num;

NonGen(int i) {
num = i;
}

int getnum() {
return num;
}
}

// A generic subclass.
class Gen<T> extends NonGen {
T ob; // declare an object of type T

// Pass the constructor a reference to
// an object of type T.
Gen(T o, int i) {
super(i);
ob = o;
}

// Return ob.
T getob() {
return ob;
}
}

// Create a Gen object.
public class HierDemo2 {
public static void main(String args[]) {

// Create a Gen object for String.
Gen<String> w = new Gen<String>("Hello", 47);

System.out.print(w.getob() + " ");
System.out.println(w.getnum());
}
}

</source>



== A simple generic class. ==



<source lang="java">

class Gen<T> {
T ob; // declare an object of type T
Gen(T o) {
ob = o;
}
T getob() {
return ob;
}
void showType() {
System.out.println("Type of T is " + ob.getClass().getName());
}
}
public class GenDemo {
public static void main(String args[]) {
Gen<Integer> iOb;
iOb = new Gen<Integer>(88);
iOb.showType();
int v = iOb.getob();
System.out.println("value: " + v);
System.out.println();
Gen<String> strOb = new Gen<String>("Generics Test");
strOb.showType();
String str = strOb.getob();
System.out.println("value: " + str);
}
}

</source>



== A simple generic class hierarchy. ==



<source lang="java">

/*
Java 2, v5.0 (Tiger) New Features
by Herbert Schildt
ISBN: 0072258543
Publisher: McGraw-Hill/Osborne, 2004
*/
class Gen<T> {
T ob;

Gen(T o) {
ob = o;
}

// Return ob.
T getob() {
return ob;
}
}

// A subclass of Gen that defines a second
// type parameter, called V.
class Gen2<T, V> extends Gen<T> {
V ob2;

Gen2(T o, V o2) {
super(o);
ob2 = o2;
}

V getob2() {
return ob2;
}
}

// Create an object of type Gen2.
public class HierDemo {
public static void main(String args[]) {

// Create a Gen2 object for String and Integer.
Gen2<String, Integer> x =
new Gen2<String, Integer>("Value is: ", 99);

System.out.print(x.getob());
System.out.println(x.getob2());
}
}

</source>



== Custom Generic Object Tester ==



<source lang="java">

/*
License for Java 1.5 "Tiger": A Developer"s Notebook
(O"Reilly) example package
Java 1.5 "Tiger": A Developer"s Notebook (O"Reilly)
by Brett McLaughlin and David Flanagan.
ISBN: 0-596-00738-8
You can use the examples and the source code any way you want, but
please include a reference to where it comes from if you use it in
your own products or services. Also note that this software is
provided by the author "as is", with no expressed or implied warranties.
In no event shall the author be liable for any direct or indirect
damages arising in any way out of the use of this software.
*/

import java.io.IOException;
import java.io.PrintStream;

import java.util.LinkedList;
import java.util.List;
class GuitarManufacturerList extends LinkedList<String> {
public GuitarManufacturerList() {
super();
}
public boolean add(String manufacturer) {
if (manufacturer.indexOf("Guitars") == -1) {
return false;
} else {
super.add(manufacturer);
return true;
}
}
}
public class CustomObjectTester {
/** A custom object that extends List */
private GuitarManufacturerList manufacturers;
public CustomObjectTester() {
this.manufacturers = new GuitarManufacturerList();
}
/**
* <p>Test iterating over an object that extends List</p>
*/
public void testListExtension(PrintStream out) throws IOException {
// Add some items for good measure
manufacturers.add("Epiphone Guitars");
manufacturers.add("Gibson Guitars");
// Iterate with for/in
for (String manufacturer : manufacturers) {
out.println(manufacturer);
}
}
public static void main(String[] args) {
try {
CustomObjectTester tester = new CustomObjectTester();
tester.testListExtension(System.out);
} catch (Exception e) {
e.printStackTrace();
}
}
}

</source>



== Demonstrate the non generic class ==



<source lang="java">

class NonGen {
Object ob;

NonGen(Object o) {
ob = o;
}

Object getob() {
return ob;
}
void showType() {
System.out.println("Type of ob is " +
ob.getClass().getName());
}
}

public class NonGenDemo {
public static void main(String args[]) {
NonGen integerObject;
integerObject = new NonGen(88);

integerObject.showType();

int v = (Integer) integerObject.getob();
System.out.println("value: " + v);

NonGen strOb = new NonGen("Non-Generics Test");
strOb.showType();

String str = (String) strOb.getob();
System.out.println("value: " + str);

integerObject = strOb;
v = (Integer) integerObject.getob();
}
}

</source>



== Java hierarchy generic class ==



<source lang="java">

/*
Java 2, v5.0 (Tiger) New Features
by Herbert Schildt
ISBN: 0072258543
Publisher: McGraw-Hill/Osborne, 2004
*/
// Here, T is bound by Object by default.
class Gen<T> {
T ob; // here, T will be replaced by Object

Gen(T o) {
ob = o;
}

// Return ob.
T getob() {
return ob;
}
}

// Here, T is bound by String.
class GenStr<T extends String> {
T str; // here, T will be replaced by String

GenStr(T o) {
str = o;
}

T getstr() { return str; }
}
public class GenTypeDemo {
public static void main(String args[]) {
Gen<Integer> iOb = new Gen<Integer>(99);
Gen<Float> fOb = new Gen<Float>(102.2F);

System.out.println(iOb.getClass().getName());
System.out.println(fOb.getClass().getName());
}
}

</source>



== Pair of template arguments ==



<source lang="java">

/* $Id$
*
* Behavior Protocols Tools - Parsers, Transformations
* Copyright (C) 2006-2007 DSRG, Charles University in Prague
* http://dsrg.mff.cuni.cz/
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
* MA 02110-1301 USA
*
*/
package org.ow2.dsrg.fm.bptools.util;

/**
* Keeps pair of values whose type is given by template arguments
* @author thorm
*/
public class Pair<T1, T2> {

/**
* Creates a new instance of Pair
* @param first first value
* @param second second value
*/
public Pair(T1 first, T2 second) {
this.first = first;
this.second = second;
}

public boolean equals(Object obj) {
if (obj instanceof Pair) {
Pair other = (Pair)obj;
return (other.first == null ? this.first == null : other.first.equals(this.first)) &&
(other.second == null ? this.second == null : other.second.equals(this.second));
}
else
return false;
}
public String toString(){
return first.toString() +"::"+second.toString() ;
}

/**
* first value
*/
public T1 first;
/**
* second value
*/
public T2 second;
}

</source>



== Stats attempts (unsuccessfully) to create a generic class ==



<source lang="java">

/*
Java 2, v5.0 (Tiger) New Features
by Herbert Schildt
ISBN: 0072258543
Publisher: McGraw-Hill/Osborne, 2004
*/
// Stats attempts (unsuccessfully) to create a generic class that can compute
// the average of an array of numbers of any given type.
// The class contains an error!
public class Stats<T> {
T[] nums; // nums is an array of type T

// Pass the constructor a reference to
// an array of type T.
Stats(T[] o) {
nums = o;
}

// Return type double in all cases.
double average() {
double sum = 0.0;

for(int i=0; i < nums.length; i++)
sum += nums[i].doubleValue(); // Error!!!

return sum / nums.length;
}
}

</source>



== Use the instanceof operator with a generic class hierarchy. ==



<source lang="java">

/*
Java 2, v5.0 (Tiger) New Features
by Herbert Schildt
ISBN: 0072258543
Publisher: McGraw-Hill/Osborne, 2004
*/
class Gen<T> {
T ob;

Gen(T o) {
ob = o;
}

// Return ob.
T getob() {
return ob;
}
}

// A subclass of Gen.
class Gen2<T> extends Gen<T> {
Gen2(T o) {
super(o);
}
}

// Demonstrate runtime type ID implications of generic class hierarchy.
public class HierDemo3 {
public static void main(String args[]) {

// Create a Gen object for Integers.
Gen<Integer> iOb = new Gen<Integer>(88);

// Create a Gen2 object for Integers.
Gen2<Integer> iOb2 = new Gen2<Integer>(99);

// Create a Gen2 object for Strings.
Gen2<String> strOb2 = new Gen2<String>("Generics Test");

// See if iOb2 is some form of Gen2.
if(iOb2 instanceof Gen2<?>)
System.out.println("iOb2 is instance of Gen2");

// See if iOb2 is some form of Gen.
if(iOb2 instanceof Gen<?>)
System.out.println("iOb2 is instance of Gen");

System.out.println();

// See if strOb2 is a Gen2.
if(strOb2 instanceof Gen2<?>)
System.out.println("strOb is instance of Gen2");

// See if strOb2 is a Gen.
if(strOb2 instanceof Gen<?>)
System.out.println("strOb is instance of Gen");

System.out.println();

// See if iOb is an instance of Gen2, which its not.
if(iOb instanceof Gen2<?>)
System.out.println("iOb is instance of Gen2");

// See if iOb is an instance of Gen, which it is.
if(iOb instanceof Gen<?>)
System.out.println("iOb is instance of Gen");

// The following can"t be compiled because
// generic type info does not exist at runtime.
// if(iOb2 instanceof Gen2<Integer>)
// System.out.println("iOb2 is instance of Gen2<Integer>");
}
}

</source>

Java/Generics

2010-06-01T07:27:29Z

Admin: 1 версия

* [[Java/Generics/Constraints | Constraints]]
* [[Java/Generics/Generic Class | Generic Class]]
* [[Java/Generics/Generic Collection | Generic Collection]]
* [[Java/Generics/Generic Constructor | Generic Constructor]]
* [[Java/Generics/Generic Interface | Generic Interface]]
* [[Java/Generics/Generic Method | Generic Method]]
* [[Java/Generics/Generic Parameter | Generic Parameter]]

Java/Web Services SOA/WS Addressing

2010-06-01T07:27:29Z

Admin: 1 версия

== This demo shows how WS-Addressing support in Apache CXF may be enabled ==



<source lang="java">

WS-Addressing Demo
==================
This demo shows how WS-Addressing support in Apache CXF may be enabled.
The client and server both use interceptor configuration to install the
WS-Addressing interceptor, comprising a logical interceptor (MAPAggregator)
responsible for aggregating the WS-A MessageAddressingProperties for
the current message, and a protocol interceptor (MAPCodec) responsible for
encoding/decoding these properties as SOAP Headers.
A demo-specific logging.properties file is used to snoop the log messages
relating to WS-A Headers and display these to the console in concise form.
Normally the WS-Addressing MessageAddressProperties are generated and
propagated implicitly, without any intravention from the
application. In certain circumstances however, the application may wish
to participate in MAP assembly, for example to associate a sequence of
requests via the RelatesTo header. This demo illustrates both implicit
and explicit MAP propagation.
This demo also illustrates usage of the decoupled HTTP transport, whereby
a seperate server->client HTTP connection is used to deliver the responses.
Note the normal HTTP mode (where the response is delivered on the back-
channel of the original client->server HTTP connection) may of course also
be used with WS-Addressing; in this case the <wsa:ReplyTo> header is set to
a well-known anonymous URI, "http://www.w3.org/2005/08/addressing/anonymous".
In all other respects this demo is based on the basic hello_world sample,
illustrating that WS-Addressing usage is independent of the application.
One notable addition to the familiar hello_world WSDL is the usage
of the <wsaw:UsingAddressing> extension element to indicate the
WS-Addressing support is enabled for the service endpoint.
Please review the README in the samples directory before continuing.

Prerequisite
------------
If your environment already includes cxf-manifest-incubator.jar on the CLASSPATH,
and the JDK and ant bin directories on the PATH, it is not necessary to
run the environment script described in the samples directory README.
If your environment is not properly configured, or if you are planning
on using wsdl2java, javac, and java to build and run the demos, you must
set the environment by running the script.

Building and running the demo using ant
---------------------------------------
From the samples/ws_addressing directory, the ant build script can be used to
build and run the demo. The server and client targets automatically build
the demo.
Using either UNIX or Windows:
ant server
ant client
Both client and server will use the MAPAggregator and MAPCodec
handlers to aggregate and encode the WS-Addressing MAPs.
To remove the code generated from the WSDL file and the .class
files, run:
ant clean

Buildng the demo using wsdl2java and javac
------------------------------------------
From the samples/ws_addressing directory, first create the target directory
build/classes and then generate code from the WSDL file.
For UNIX:
mkdir -p build/classes
wsdl2java -d build/classes -compile ./wsdl/hello_world_addr.wsdl
For Windows:
mkdir build\classes
Must use back slashes.
wsdl2java -d build\classes -compile .\wsdl\hello_world_addr.wsdl
May use either forward or back slashes.
Now compile the provided client and server applications with the commands:
For UNIX:

export CLASSPATH=$CLASSPATH:$CXF_HOME/lib/cxf-manifest-incubator.jar:./build/classes:.
javac -d build/classes src/demo/ws_addressing/common/*.java
javac -d build/classes src/demo/ws_addressing/client/*.java
javac -d build/classes src/demo/ws_addressing/server/*.java
For Windows:
set classpath=%classpath%;%CXF_HOME%\lib\cxf-manifest-incubator.jar;.\build\classes;.
javac -d build\classes src\demo\ws_addressing\common\*.java
javac -d build\classes src\demo\ws_addressing\client\*.java
javac -d build\classes src\demo\ws_addressing\server\*.java
Running the demo using java
---------------------------
From the samples/ws_addressing directory run the commands (entered on a single command line):
For UNIX (must use forward slashes):
java -Djava.util.logging.config.file=./logging.properties
-Dcxf.config.file=server.xml
demo.ws_addressing.server.Server &
java -Djava.util.logging.config.file=./logging.properties
-Dcxf.config.file=client.xml
demo.ws_addressing.client.Client ./wsdl/hello_world_addr.wsdl
The server process starts in the background.
For Windows (may use either forward or back slashes):
start
java -Djava.util.logging.config.file=.\logging.properties
-Dcxf.config.file=server.xml
demo.ws_addressing.server.Server
java -Djava.util.logging.config.file=.\logging.properties
-Dcxf.config.file=client.xml
demo.ws_addressing.client.Client .\wsdl\hello_world_addr.wsdl
The server process starts in a new command window.
After running the client, terminate the server process.
To remove the code generated from the WSDL file and the .class
files, either delete the build directory and its contents or run:
ant clean

</source>

Java/Generics/Generic Method

2010-06-01T07:27:27Z

Admin: 1 версия

== Demonstrate a simple generic method. ==



<source lang="java">
/*
Java 2, v5.0 (Tiger) New Features
by Herbert Schildt
ISBN: 0072258543
Publisher: McGraw-Hill/Osborne, 2004
*/

public class GenMethDemo {

// Determine if an object is in an array.
static <T, V extends T> boolean isIn(T x, V[] y) {

for(int i=0; i < y.length; i++)
if(x.equals(y[i])) return true;

return false;
}

public static void main(String args[]) {

// Use isIn() on Integers.
Integer nums[] = { 1, 2, 3, 4, 5 };

if(isIn(2, nums))
System.out.println("2 is in nums");

if(!isIn(7, nums))
System.out.println("7 is not in nums");

System.out.println();

// Use isIn() on Strings.
String strs[] = { "one", "two", "three",
"four", "five" };

if(isIn("two", strs))
System.out.println("two is in strs");

if(!isIn("seven", strs))
System.out.println("seven is not in strs");

// Opps! Won"t compile! Types must be compatible.
// if(isIn("two", nums))
// System.out.println("two is in strs");
}
}

</source>



== Java generic: Ambiguity caused by erasure on overloaded methods. ==



<source lang="java">
/*
Java 2, v5.0 (Tiger) New Features
by Herbert Schildt
ISBN: 0072258543
Publisher: McGraw-Hill/Osborne, 2004
*/
class MyGenClass<T, V> {
T ob1;
V ob2;

// ...

// These two overloaded methods are ambiguous.
// and will not compile.
void set(T o) {
ob1 = o;
}

void set(V o) {
ob2 = o;
}
}
// Can"t create an instance of T.
class Gen<T> {
T ob;
Gen() {
ob = new T(); // Illegal!!!
}
}
public class Wrong<T> {
// Wrong, no static variables of type T.
static T ob;

// Wrong, no static method can use T.
static T getob() {
return ob;
}

// Wrong, no static method can access object
// of type T.
static void showob() {
System.out.println(ob);
}
}

</source>



== Java generic: A situation that creates a bridge method. ==



<source lang="java">
/*
Java 2, v5.0 (Tiger) New Features
by Herbert Schildt
ISBN: 0072258543
Publisher: McGraw-Hill/Osborne, 2004
*/
//
class Gen<T> {
T ob; // declare an object of type T

// Pass the constructor a reference to
// an object of type T.
Gen(T o) {
ob = o;
}

// Return ob.
T getob() {
return ob;
}
}

// A subclass of Gen.
class Gen2 extends Gen<String> {

Gen2(String o) {
super(o);
}

// A String-specific override of getob().
String getob() {
System.out.print("You called String getob(): ");
return ob;
}
}

// Demonstrate a situation that requires a bridge method.
public class BridgeDemo {
public static void main(String args[]) {

// Create a Gen2 object for Strings.
Gen2 strOb2 = new Gen2("Generics Test");

System.out.println(strOb2.getob());
}
}

</source>



== Overriding a generic method in a generic class. ==



<source lang="java">
/*
Java 2, v5.0 (Tiger) New Features
by Herbert Schildt
ISBN: 0072258543
Publisher: McGraw-Hill/Osborne, 2004
*/
class Gen<T> {
T ob; // declare an object of type T

// Pass the constructor a reference to
// an object of type T.
Gen(T o) {
ob = o;
}

// Return ob.
T getob() {
System.out.print("Gen"s getob(): " );
return ob;
}
}

// A subclass of Gen that overrides getob().
class Gen2<T> extends Gen<T> {

Gen2(T o) {
super(o);
}

// Override getob().
T getob() {
System.out.print("Gen2"s getob(): ");
return ob;
}
}

// Demonstrate generic method override.
public class OverrideDemo {
public static void main(String args[]) {

// Create a Gen object for Integers.
Gen<Integer> iOb = new Gen<Integer>(88);

// Create a Gen2 object for Integers.
Gen2<Integer> iOb2 = new Gen2<Integer>(99);

// Create a Gen2 object for Strings.
Gen2<String> strOb2 = new Gen2<String>("Generics Test");

System.out.println(iOb.getob());
System.out.println(iOb2.getob());
System.out.println(strOb2.getob());
}
}

</source>



== Return generic value from method ==



<source lang="java">
import java.io.Serializable;
class Base {
}
class Sub1 extends Base implements Serializable {
public void run() {
}
}
class Sub2 extends Base implements Serializable {
public void run() {
}
}
public class TypeInference {
static <T extends Base> T infer(T t1, T t2) {
return null;
}
public static void main(String[] args) {
Base base = infer(new Sub1(), new Sub2());
Serializable runnable = infer(new Sub1(), new Sub2());
}
}
</source>

Java/Generics/Constraints

2010-06-01T07:27:26Z

Admin: 1 версия

== Bounded Wildcard arguments. ==



<source lang="java">

class TwoD {
int x, y;
TwoD(int a, int b) {
x = a;
y = b;
}
}
class ThreeD extends TwoD {
int z;
ThreeD(int a, int b, int c) {
super(a, b);
z = c;
}
}
class FourD extends ThreeD {
int t;
FourD(int a, int b, int c, int d) {
super(a, b, c);
t = d;
}
}
class Coords<T extends TwoD> {
T[] coords;
Coords(T[] o) {
coords = o;
}
}
class BoundedWildcard {
static void showXY(Coords<?> c) {
System.out.println("X Y Coordinates:");
for (int i = 0; i < c.coords.length; i++)
System.out.println(c.coords[i].x + " " + c.coords[i].y);
System.out.println();
}
static void showXYZ(Coords<? extends ThreeD> c) {
System.out.println("X Y Z Coordinates:");
for (int i = 0; i < c.coords.length; i++)
System.out.println(c.coords[i].x + " " + c.coords[i].y + " " + c.coords[i].z);
System.out.println();
}
static void showAll(Coords<? extends FourD> c) {
System.out.println("X Y Z T Coordinates:");
for (int i = 0; i < c.coords.length; i++)
System.out.println(c.coords[i].x + " " + c.coords[i].y + " " + c.coords[i].z + " "
+ c.coords[i].t);
System.out.println();
}
public static void main(String args[]) {
TwoD td[] = { new TwoD(0, 0), new TwoD(7, 9), new TwoD(18, 4), new TwoD(-1, -23) };
Coords<TwoD> tdlocs = new Coords<TwoD>(td);
System.out.println("Contents of tdlocs.");
showXY(tdlocs); // OK, is a TwoD
FourD fd[] = { new FourD(1, 2, 3, 4), new FourD(6, 8, 14, 8), new FourD(22, 9, 4, 9),
new FourD(3, -2, -23, 17) };
Coords<FourD> fdlocs = new Coords<FourD>(fd);
System.out.println("Contents of fdlocs.");
// These are all OK.
showXY(fdlocs);
showXYZ(fdlocs);
showAll(fdlocs);
}
}

</source>



== Generic cast ==



<source lang="java">

/*
* Copyright (C) 2001-2003 Colin Bell
* colbell@users.sourceforge.net
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
import java.io.*;
import java.text.NumberFormat;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
/**
* General purpose utilities functions.
*
* @author
*/
public class Utilities
{

/**
* This is taken from Eammon McManus" blog:
* http://weblogs.java.net/blog/emcmanus/archive/2007/03/getting_rid_of.html This prevents you from having
* to place SuppressWarnings throughout your code.
*
* @param <T>
* the return type to cast the object to
* @param x
* the object to cast.
* @return a type-casted version of the specified object.
*/
@SuppressWarnings("unchecked")
public static <T> T cast(Object x) {
return (T) x;
}
}

</source>



== Java generic: Bounded Wildcard arguments ==



<source lang="java">

/*
Java 2, v5.0 (Tiger) New Features
by Herbert Schildt
ISBN: 0072258543
Publisher: McGraw-Hill/Osborne, 2004
*/

// Two-dimensional coordinates.
class TwoD {
int x, y;

TwoD(int a, int b) {
x = a;
y = b;
}
}

// Three-dimensional coordinates.
class ThreeD extends TwoD {
int z;

ThreeD(int a, int b, int c) {
super(a, b);
z = c;
}
}

// Four-dimensional coordinates.
class FourD extends ThreeD {
int t;

FourD(int a, int b, int c, int d) {
super(a, b, c);
t = d;
}
}

// This class holds an array of coordinate objects.
class Coords<T extends TwoD> {
T[] coords;

Coords(T[] o) { coords = o; }
}

// Demonstrate a bounded wildcard.
public class BoundedWildcard {
static void showXY(Coords<?> c) {
System.out.println("X Y Coordinates:");
for(int i=0; i < c.coords.length; i++)
System.out.println(c.coords[i].x + " " +
c.coords[i].y);
System.out.println();
}

static void showXYZ(Coords<? extends ThreeD> c) {
System.out.println("X Y Z Coordinates:");
for(int i=0; i < c.coords.length; i++)
System.out.println(c.coords[i].x + " " +
c.coords[i].y + " " +
c.coords[i].z);
System.out.println();
}

static void showAll(Coords<? extends FourD> c) {
System.out.println("X Y Z T Coordinates:");
for(int i=0; i < c.coords.length; i++)
System.out.println(c.coords[i].x + " " +
c.coords[i].y + " " +
c.coords[i].z + " " +
c.coords[i].t);
System.out.println();
}

public static void main(String args[]) {
TwoD td[] = {
new TwoD(0, 0),
new TwoD(7, 9),
new TwoD(18, 4),
new TwoD(-1, -23)
};

Coords<TwoD> tdlocs = new Coords<TwoD>(td);

System.out.println("Contents of tdlocs.");
showXY(tdlocs); // OK, is a TwoD
// showXYZ(tdlocs); // Error, not a ThreeD
// showAll(tdlocs); // Erorr, not a FourD

// Now, create some FourD objects.
FourD fd[] = {
new FourD(1, 2, 3, 4),
new FourD(6, 8, 14, 8),
new FourD(22, 9, 4, 9),
new FourD(3, -2, -23, 17)
};

Coords<FourD> fdlocs = new Coords<FourD>(fd);

System.out.println("Contents of fdlocs.");
// These are all OK.
showXY(fdlocs);
showXYZ(fdlocs);
showAll(fdlocs);
}
}

</source>



== Java generic: Use a wildcard. ==



<source lang="java">

/*
Java 2, v5.0 (Tiger) New Features
by Herbert Schildt
ISBN: 0072258543
Publisher: McGraw-Hill/Osborne, 2004
*/

class Stats<T extends Number> {
T[] nums; // array of Number or subclass

// Pass the constructor a reference to
// an array of type Number or subclass.
Stats(T[] o) {
nums = o;
}

// Return type double in all cases.
double average() {
double sum = 0.0;

for(int i=0; i < nums.length; i++)
sum += nums[i].doubleValue();

return sum / nums.length;
}

// Determine if two averages are the same.
// Notice the use of the wildcard.
boolean sameAvg(Stats<?> ob) {
if(average() == ob.average())
return true;

return false;
}
}

// Demonstrate wildcard.
public class WildcardDemo {
public static void main(String args[]) {
Integer inums[] = { 1, 2, 3, 4, 5 };
Stats<Integer> iob = new Stats<Integer>(inums);
double v = iob.average();
System.out.println("iob average is " + v);

Double dnums[] = { 1.1, 2.2, 3.3, 4.4, 5.5 };
Stats<Double> dob = new Stats<Double>(dnums);
double w = dob.average();
System.out.println("dob average is " + w);

Float fnums[] = { 1.0F, 2.0F, 3.0F, 4.0F, 5.0F };
Stats<Float> fob = new Stats<Float>(fnums);
double x = fob.average();
System.out.println("fob average is " + x);

// See which arrays have same average.
System.out.print("Averages of iob and dob ");
if(iob.sameAvg(dob))
System.out.println("are the same.");
else
System.out.println("differ.");

System.out.print("Averages of iob and fob ");
if(iob.sameAvg(fob))
System.out.println("are the same.");
else
System.out.println("differ.");
}
}

</source>



== Use a wildcard. ==



<source lang="java">

class Stats<T extends Number> {
T[] nums;
Stats(T[] o) {
nums = o;
}
double average() {
double sum = 0.0;
for (int i = 0; i < nums.length; i++)
sum += nums[i].doubleValue();
return sum / nums.length;
}
boolean sameAvg(Stats<?> ob) {
if (average() == ob.average())
return true;
return false;
}
}
class WildcardDemo {
public static void main(String args[]) {
Integer inums[] = { 1, 2, 3, 4, 5 };
Stats<Integer> iob = new Stats<Integer>(inums);
double v = iob.average();
System.out.println("iob average is " + v);
Double dnums[] = { 1.1, 2.2, 3.3, 4.4, 5.5 };
Stats<Double> dob = new Stats<Double>(dnums);
double w = dob.average();
System.out.println("dob average is " + w);
Float fnums[] = { 1.0F, 2.0F, 3.0F, 4.0F, 5.0F };
Stats<Float> fob = new Stats<Float>(fnums);
double x = fob.average();
System.out.println("fob average is " + x);
// See which arrays have same average.
System.out.print("Averages of iob and dob ");
if (iob.sameAvg(dob))
System.out.println("are the same.");
else
System.out.println("differ.");
System.out.print("Averages of iob and fob ");
if (iob.sameAvg(fob))
System.out.println("are the same.");
else
System.out.println("differ.");
}
}

</source>

Java/Generics/Generic Parameter

2010-06-01T07:27:25Z

Admin: 1 версия

== A simple generic class with two type parameters: T and V. ==



<source lang="java">
class TwoGen<T, V> {
T ob1;
V ob2;
TwoGen(T o1, V o2) {
ob1 = o1;
ob2 = o2;
}
void showTypes() {
System.out.println("Type of T is " + ob1.getClass().getName());
System.out.println("Type of V is " + ob2.getClass().getName());
}
T getob1() {
return ob1;
}
V getob2() {
return ob2;
}
}
public class SimpGen {
public static void main(String args[]) {
TwoGen<Integer, String> tgObj = new TwoGen<Integer, String>(88, "Generics");
tgObj.showTypes();
int v = tgObj.getob1();
System.out.println("value: " + v);
String str = tgObj.getob2();
System.out.println("value: " + str);
}
}

</source>



== A subclass can add its own type parameters. ==



<source lang="java">

class Gen<T> {
T ob; // declare an object of type T
Gen(T o) {
ob = o;
}
// Return ob.
T getob() {
return ob;
}
}
// A subclass of Gen that defines a second type parameter, called V.
class Gen2<T, V> extends Gen<T> {
V ob2;
Gen2(T o, V o2) {
super(o);
ob2 = o2;
}
V getob2() {
return ob2;
}
}
class HierDemo {
public static void main(String args[]) {
Gen2<String, Integer> x = new Gen2<String, Integer>("Value is: ", 99);
System.out.print(x.getob());
System.out.println(x.getob2());
}
}
</source>



== Boxing Generic Example ==



<source lang="java">
import java.util.*;
public class BoxingGenericsExample {
public static void main(String args[])
{
HashMap<String,Integer> hm = new HashMap<String,Integer>();
hm.put("speed", 20);
}
}

</source>



== Create a generic class that can compute the average of an array of numbers of any given type. ==



<source lang="java">

class Stats<T> {
T[] nums;
Stats(T[] o) {
nums = o;
}
double average() {
double sum = 0.0;
for (int i = 0; i < nums.length; i++)
sum += nums[i].doubleValue(); // Error!!!
return sum / nums.length;
}
}
</source>



== Demonstrate a raw generic type. ==



<source lang="java">
/*
Java 2, v5.0 (Tiger) New Features
by Herbert Schildt
ISBN: 0072258543
Publisher: McGraw-Hill/Osborne, 2004
*/
class Gen<T> {
T ob; // declare an object of type T

// Pass the constructor a reference to
// an object of type T.
Gen(T o) {
ob = o;
}

// Return ob.
T getob() {
return ob;
}
}

// Demonstrate raw type.
public class RawDemo {
public static void main(String args[]) {

// Create a Gen object for Integers.
Gen<Integer> iOb = new Gen<Integer>(88);

// Create a Gen object for Strings.
Gen<String> strOb = new Gen<String>("Generics Test");

// Create a raw-type Gen object and give it
// a Double value.
Gen raw = new Gen(new Double(98.6));

// Cast here is necessary because type is unknown.
double d = (Double) raw.getob();
System.out.println("value: " + d);

// The use of a raw type can lead to runtime.
// exceptions. Here are some examples.

// The following cast causes a runtime error!
// int i = (Integer) raw.getob(); // runtime error

// This assigment overrides type safety.
strOb = raw; // OK, but potentially wrong
// String str = strOb.getob(); // runtime error

// This assignment also overrides type safety.
raw = iOb; // OK, but potentially wrong
// d = (Double) raw.getob(); // runtime error
}
}

</source>



== Demonstrate a raw type. ==



<source lang="java">

class Gen<T> {
T ob; // declare an object of type T
Gen(T o) {
ob = o;
}
T getob() {
return ob;
}
}
class RawDemo {
public static void main(String args[]) {
Gen<Integer> iOb = new Gen<Integer>(88);
Gen<String> strOb = new Gen<String>("Generics Test");
Gen raw = new Gen(new Double(98.6));
double d = (Double) raw.getob();
System.out.println("value: " + d);
strOb = raw; // OK, but potentially wrong
raw = iOb; // OK, but potentially wrong
}
}
</source>



== Java generic: Hierarchy argument ==



<source lang="java">
class Stats<T extends Number> {
T[] nums;
Stats(T[] o) {
nums = o;
}
double average() {
double sum = 0.0;
for (int i = 0; i < nums.length; i++)
sum += nums[i].doubleValue();
return sum / nums.length;
}
}
public class BoundsDemo {
public static void main(String args[]) {
Integer inums[] = { 1, 2, 3, 4, 5 };
Stats<Integer> iob = new Stats<Integer>(inums);
double v = iob.average();
System.out.println("iob average is " + v);
Double dnums[] = { 1.1, 2.2, 3.3, 4.4, 5.5 };
Stats<Double> dob = new Stats<Double>(dnums);
double w = dob.average();
System.out.println("dob average is " + w);
}
}

</source>



== the type argument for T must be either Number, or a class derived from Number. ==



<source lang="java">

class Stats<T extends Number> {
T[] nums;
Stats(T[] o) {
nums = o;
}
double average() {
double sum = 0.0;
for (int i = 0; i < nums.length; i++)
sum += nums[i].doubleValue();
return sum / nums.length;
}
}
class BoundsDemo {
public static void main(String args[]) {
Integer inums[] = { 1, 2, 3, 4, 5 };
Stats<Integer> iob = new Stats<Integer>(inums);
double v = iob.average();
System.out.println("iob average is " + v);
Double dnums[] = { 1.1, 2.2, 3.3, 4.4, 5.5 };
Stats<Double> dob = new Stats<Double>(dnums);
double w = dob.average();
System.out.println("dob average is " + w);
}
}
</source>



== T is a type parameter that will be replaced by a real type when an object of type Gen is created. ==



<source lang="java">

class Gen<T> {
T ob;
Gen(T o) {
ob = o;
}
T getob() {
return ob;
}
void showType() {
System.out.println("Type of T is " + ob.getClass().getName());
}
}
class GenDemo {
public static void main(String args[]) {
Gen<Integer> iOb;
iOb = new Gen<Integer>(88);
iOb.showType();
int v = iOb.getob();
System.out.println("value: " + v);
System.out.println();
Gen<String> strOb = new Gen<String>("Generics Test");
strOb.showType();
String str = strOb.getob();
System.out.println("value: " + str);
}
}
</source>

Java/Generics/Generic Collection

2010-06-01T07:27:23Z

Admin: 1 версия

== A list declared to hold objects of a type T can also hold objects that extend from T. ==



<source lang="java">

import java.util.ArrayList;
import java.util.List;
public class Main {
public static void main(String[] argv) {
List<Number> numlist = new ArrayList<Number>();
numlist.add(new Integer(123));
numlist.add(new Float(123));
}
}

</source>



== A value retrieved from a type-specific list does not need to be casted ==



<source lang="java">

import java.net.MalformedURLException;
import java.net.URL;
import java.util.ArrayList;
import java.util.List;
public class Main {
public static void main(String[] argv) {
List<URL> urlList = new ArrayList<URL>();
try {
urlList.add(new URL("http://www.jexp.ru"));
} catch (MalformedURLException e) {
}
String s = urlList.get(0).getHost();
}
}

</source>



== Circular Object Buffer ==



<source lang="java">

/*
* Circular Object Buffer
* Copyright (C) 2002-2004 Stephen Ostermiller
* http://ostermiller.org/contact.pl?regarding=Java+Utilities
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* See COPYING.TXT for details.
*/
/**
* Implements the Circular Buffer producer/consumer model for Objects.
* More information about this class is available from .
* <p>
* This class is thread safe.
*
* @see CircularCharBuffer
* @see CircularByteBuffer
*
* @author Stephen Ostermiller http://ostermiller.org/contact.pl?regarding=Java+Utilities
* @param <ElementType> Type of object allowed in this circular buffer
* @since ostermillerutils 1.00.00
*/
public class CircularObjectBuffer <ElementType> {
/**
* The default size for a circular object buffer.
*
* @since ostermillerutils 1.00.00
*/
private final static int DEFAULT_SIZE = 1024;
/**
* A buffer that will grow as things are added.
*
* @since ostermillerutils 1.00.00
*/
public final static int INFINITE_SIZE = -1;
/**
* The circular buffer.
* <p>
* The actual capacity of the buffer is one less than the actual length
* of the buffer so that an empty and a full buffer can be
* distinguished. An empty buffer will have the readPostion and the
* writePosition equal to each other. A full buffer will have
* the writePosition one less than the readPostion.
* <p>
* There are two important indexes into the buffer:
* The readPosition, and the writePosition. The Objects
* available to be read go from the readPosition to the writePosition,
* wrapping around the end of the buffer. The space available for writing
* goes from the write position to one less than the readPosition,
* wrapping around the end of the buffer.
*
* @since ostermillerutils 1.00.00
*/
protected ElementType[] buffer;
/**
* Index of the first Object available to be read.
*
* @since ostermillerutils 1.00.00
*/
protected volatile int readPosition = 0;
/**
* Index of the first Object available to be written.
*
* @since ostermillerutils 1.00.00
*/
protected volatile int writePosition = 0;
/**
* If this buffer is infinite (should resize itself when full)
*
* @since ostermillerutils 1.00.00
*/
protected volatile boolean infinite = false;
/**
* True if a write to a full buffer should block until the buffer
* has room, false if the write method should throw an IOException
*
* @since ostermillerutils 1.00.00
*/
protected boolean blockingWrite = true;
/**
* True when no more input is coming into this buffer. At that
* point reading from the buffer may return null if the buffer
* is empty, otherwise a read will block until an Object is available.
*
* @since ostermillerutils 1.00.00
*/
protected boolean inputDone = false;
/**
* Make this buffer ready for reuse. The contents of the buffer
* will be cleared and the streams associated with this buffer
* will be reopened if they had been closed.
*
* @since ostermillerutils 1.00.00
*/
public void clear(){
synchronized (this){
readPosition = 0;
writePosition = 0;
inputDone = false;
}
}
/**
* Get number of Objects that are available to be read.
* <p>
* Note that the number of Objects available plus
* the number of Objects free may not add up to the
* capacity of this buffer, as the buffer may reserve some
* space for other purposes.
*
* @return the size in Objects of this buffer
*
* @since ostermillerutils 1.00.00
*/
public int getAvailable(){
synchronized (this){
return available();
}
}
/**
* Get the number of Objects this buffer has free for
* writing.
* <p>
* Note that the number of Objects available plus
* the number of Objects free may not add up to the
* capacity of this buffer, as the buffer may reserve some
* space for other purposes.
*
* @return the available space in Objects of this buffer
*
* @since ostermillerutils 1.00.00
*/
public int getSpaceLeft(){
synchronized (this){
return spaceLeft();
}
}
/**
* Get the capacity of this buffer.
* <p>
* Note that the number of Objects available plus
* the number of Objects free may not add up to the
* capacity of this buffer, as the buffer may reserve some
* space for other purposes.
*
* @return the size in Objects of this buffer
*
* @since ostermillerutils 1.00.00
*/
public int getSize(){
synchronized (this){
return buffer.length;
}
}
@SuppressWarnings("unchecked") private ElementType[] createArray(int size){
return (ElementType[]) new Object[size];
}
/**
* double the size of the buffer
*
* @since ostermillerutils 1.00.00
*/
private void resize(){
ElementType[] newBuffer = createArray(buffer.length * 2);
int available = available();
if (readPosition <= writePosition){
// any space between the read and
// the first write needs to be saved.
// In this case it is all in one piece.
int length = writePosition - readPosition;
System.arraycopy(buffer, readPosition, newBuffer, 0, length);
} else {
int length1 = buffer.length - readPosition;
System.arraycopy(buffer, readPosition, newBuffer, 0, length1);
int length2 = writePosition;
System.arraycopy(buffer, 0, newBuffer, length1, length2);
}
buffer = newBuffer;
readPosition = 0;
writePosition = available;
}
/**
* Space available in the buffer which can be written.
*
* @since ostermillerutils 1.00.00
*/
private int spaceLeft(){
if (writePosition < readPosition){
// any space between the first write and
// the read except one Object is available.
// In this case it is all in one piece.
return (readPosition - writePosition - 1);
}
// space at the beginning and end.
return ((buffer.length - 1) - (writePosition - readPosition));
}
/**
* Objects available for reading.
*
* @since ostermillerutils 1.00.00
*/
private int available(){
if (readPosition <= writePosition){
// any space between the first read and
// the first write is available. In this case i
// is all in one piece.
return (writePosition - readPosition);
}
// space at the beginning and end.
return (buffer.length - (readPosition - writePosition));
}
/**
* Create a new buffer with a default capacity.
* Writing to a full buffer will block until space
* is available rather than throw an exception.
*
* @since ostermillerutils 1.00.00
*/
public CircularObjectBuffer(){
this (DEFAULT_SIZE, true);
}
/**
* Create a new buffer with given capacity.
* Writing to a full buffer will block until space
* is available rather than throw an exception.
* <p>
* Note that the buffer may reserve some Objects for
* special purposes and capacity number of Objects may
* not be able to be written to the buffer.
* <p>
* Note that if the buffer is of INFINITE_SIZE it will
* neither block or throw exceptions, but rather grow
* without bound.
*
* @param size desired capacity of the buffer in Objects or CircularObjectBuffer.INFINITE_SIZE.
*
* @since ostermillerutils 1.00.00
*/
public CircularObjectBuffer(int size){
this (size, true);
}
/**
* Create a new buffer with a default capacity and
* given blocking behavior.
*
* @param blockingWrite true writing to a full buffer should block
* until space is available, false if an exception should
* be thrown instead.
*
* @since ostermillerutils 1.00.00
*/
public CircularObjectBuffer(boolean blockingWrite){
this (DEFAULT_SIZE, blockingWrite);
}
/**
* Create a new buffer with the given capacity and
* blocking behavior.
* <p>
* Note that the buffer may reserve some Objects for
* special purposes and capacity number of Objects may
* not be able to be written to the buffer.
* <p>
* Note that if the buffer is of INFINITE_SIZE it will
* neither block or throw exceptions, but rather grow
* without bound.
*
* @param size desired capacity of the buffer in Objects or CircularObjectBuffer.INFINITE_SIZE.
* @param blockingWrite true writing to a full buffer should block
* until space is available, false if an exception should
* be thrown instead.
*
* @since ostermillerutils 1.00.00
*/
public CircularObjectBuffer(int size, boolean blockingWrite){
if (size == INFINITE_SIZE){
buffer = createArray(DEFAULT_SIZE);
infinite = true;
} else {
buffer = createArray(size);
infinite = false;
}
this.blockingWrite = blockingWrite;
}

/**
* Get a single Object from this buffer. This method should be called
* by the consumer.
* This method will block until a Object is available or no more
* objects are available.
*
* @return The Object read, or null if there are no more objects
* @throws InterruptedException if the thread is interrupted while waiting.
*
* @since ostermillerutils 1.00.00
*/
public ElementType read() throws InterruptedException {
while (true){
synchronized (this){
int available = available();
if (available > 0){
ElementType result = buffer[readPosition];
readPosition++;
if (readPosition == buffer.length){
readPosition = 0;
}
return result;
} else if (inputDone){
return null;
}
}
Thread.sleep(100);
}
}
/**
* Get Objects into an array from this buffer. This method should
* be called by the consumer.
* This method will block until some input is available,
* or there is no more input.
*
* @param buf Destination buffer.
* @return The number of Objects read, or -1 there will
* be no more objects available.
* @throws InterruptedException if the thread is interrupted while waiting.
*
* @since ostermillerutils 1.00.00
*/
public int read(ElementType[] buf) throws InterruptedException {
return read(buf, 0, buf.length);
}
/**
* Get Objects into a portion of an array from this buffer. This
* method should be called by the consumer.
* This method will block until some input is available,
* an I/O error occurs, or the end of the stream is reached.
*
* @param buf Destination buffer.
* @param off Offset at which to start storing Objects.
* @param len Maximum number of Objects to read.
* @return The number of Objects read, or -1 there will
* be no more objects available.
* @throws InterruptedException if the thread is interrupted while waiting.
*
* @since ostermillerutils 1.00.00
*/
public int read(ElementType[] buf, int off, int len) throws InterruptedException {
while (true){
synchronized (this){
int available = available();
if (available > 0){
int length = Math.min(len, available);
int firstLen = Math.min(length, buffer.length - readPosition);
int secondLen = length - firstLen;
System.arraycopy(buffer, readPosition, buf, off, firstLen);
if (secondLen > 0){
System.arraycopy(buffer, 0, buf, off+firstLen, secondLen);
readPosition = secondLen;
} else {
readPosition += length;
}
if (readPosition == buffer.length) {
readPosition = 0;
}
return length;
} else if (inputDone){
return -1;
}
}
Thread.sleep(100);
}
}

/**
* Skip Objects. This method should be used by the consumer
* when it does not care to examine some number of Objects.
* This method will block until some Objects are available,
* or there will be no more Objects available.
*
* @param n The number of Objects to skip
* @return The number of Objects actually skipped
* @throws IllegalArgumentException if n is negative.
* @throws InterruptedException if the thread is interrupted while waiting.
*
* @since ostermillerutils 1.00.00
*/
public long skip(long n) throws InterruptedException, IllegalArgumentException {
while (true){
synchronized (this){
int available = available();
if (available > 0){
int length = Math.min((int)n, available);
int firstLen = Math.min(length, buffer.length - readPosition);
int secondLen = length - firstLen;
if (secondLen > 0){
readPosition = secondLen;
} else {
readPosition += length;
}
if (readPosition == buffer.length) {
readPosition = 0;
}
return length;
} else if (inputDone){
return 0;
}
}
Thread.sleep(100);
}
}
/**
* This method should be used by the producer to signal to the consumer
* that the producer is done producing objects and that the consumer
* should stop asking for objects once it has used up buffered objects.
* <p>
* Once the producer has signaled that it is done, further write() invocations
* will cause an IllegalStateException to be thrown. Calling done() multiple times,
* however, has no effect.
*
* @since ostermillerutils 1.00.00
*/
public void done(){
synchronized (this){
inputDone = true;
}
}
/**
* Fill this buffer with array of Objects. This method should be called
* by the producer.
* If the buffer allows blocking writes, this method will block until
* all the data has been written rather than throw a BufferOverflowException.
*
* @param buf Array of Objects to be written
* @throws BufferOverflowException if buffer does not allow blocking writes
* and the buffer is full. If the exception is thrown, no data
* will have been written since the buffer was set to be non-blocking.
* @throws IllegalStateException if done() has been called.
* @throws InterruptedException if the write is interrupted.
*
* @since ostermillerutils 1.00.00
*/
public void write(ElementType[] buf) throws Exception{
write(buf, 0, buf.length);
}
/**
* Fill this buffer with a portion of an array of Objects.
* This method should be called by the producer.
* If the buffer allows blocking writes, this method will block until
* all the data has been written rather than throw an IOException.
*
* @param buf Array of Objects
* @param off Offset from which to start writing Objects
* @param len - Number of Objects to write
* @throws BufferOverflowException if buffer does not allow blocking writes
* and the buffer is full. If the exception is thrown, no data
* will have been written since the buffer was set to be non-blocking.
* @throws IllegalStateException if done() has been called.
* @throws InterruptedException if the write is interrupted.
*
* @since ostermillerutils 1.00.00
*/
public void write(ElementType[] buf, int off, int len) throws Exception{
while (len > 0){
synchronized (CircularObjectBuffer.this){
if (inputDone) throw new IllegalStateException("CircularObjectBuffer.done() has been called, CircularObjectBuffer.write() failed.");
int spaceLeft = spaceLeft();
while (infinite && spaceLeft < len){
resize();
spaceLeft = spaceLeft();
}
if (!blockingWrite && spaceLeft < len) throw new Exception("CircularObjectBuffer is full; cannot write " + len + " Objects");
int realLen = Math.min(len, spaceLeft);
int firstLen = Math.min(realLen, buffer.length - writePosition);
int secondLen = Math.min(realLen - firstLen, buffer.length - readPosition - 1);
int written = firstLen + secondLen;
if (firstLen > 0){
System.arraycopy(buf, off, buffer, writePosition, firstLen);
}
if (secondLen > 0){
System.arraycopy(buf, off+firstLen, buffer, 0, secondLen);
writePosition = secondLen;
} else {
writePosition += written;
}
if (writePosition == buffer.length) {
writePosition = 0;
}
off += written;
len -= written;
}
if (len > 0){
Thread.sleep(100);
}
}
}
/**
* Add a single Object to this buffer. This method should be
* called by the producer.
* If the buffer allows blocking writes, this method will block until
* all the data has been written rather than throw an IOException.
*
* @param o Object to be written.
* @throws BufferOverflowException if buffer does not allow blocking writes
* and the buffer is full. If the exception is thrown, no data
* will have been written since the buffer was set to be non-blocking.
* @throws IllegalStateException if done() has been called.
* @throws InterruptedException if the write is interrupted.
*
* @since ostermillerutils 1.00.00
*/
public void write(ElementType o) throws Exception{
boolean written = false;
while (!written){
synchronized (CircularObjectBuffer.this){
if (inputDone) throw new IllegalStateException("CircularObjectBuffer.done() has been called, CircularObjectBuffer.write() failed.");
int spaceLeft = spaceLeft();
while (infinite && spaceLeft < 1){
resize();
spaceLeft = spaceLeft();
}
if (!blockingWrite && spaceLeft < 1) throw new Exception("CircularObjectBuffer is full; cannot write 1 Object");
if (spaceLeft > 0){
buffer[writePosition] = o;
writePosition++;
if (writePosition == buffer.length) {
writePosition = 0;
}
written = true;
}
}
if (!written){
Thread.sleep(100);
}
}
}
}

</source>



== Collections and Data structure: the generic way ==



<source lang="java">

/*
License for Java 1.5 "Tiger": A Developer"s Notebook
(O"Reilly) example package
Java 1.5 "Tiger": A Developer"s Notebook (O"Reilly)
by Brett McLaughlin and David Flanagan.
ISBN: 0-596-00738-8
You can use the examples and the source code any way you want, but
please include a reference to where it comes from if you use it in
your own products or services. Also note that this software is
provided by the author "as is", with no expressed or implied warranties.
In no event shall the author be liable for any direct or indirect
damages arising in any way out of the use of this software.
*/
import java.util.ArrayList;
import java.io.IOException;
import java.io.PrintStream;
import java.util.HashMap;
import java.util.Iterator;
import java.util.LinkedList;
import java.util.List;
import java.util.Map;
public class GenericsTester {
public GenericsTester() {
}
public void testTypeSafeMaps(PrintStream out) throws IOException {
Map<Integer, Integer> squares = new HashMap<Integer, Integer>();
for (int i=0; i<100; i++) {
squares.put(i, i*i);
}
for (int i=0; i<10; i++) {
int n = i*3;
out.println("The square of " + n + " is " + squares.get(n));
}
}
public void testTypeSafeLists(PrintStream out) throws IOException {
List listOfStrings = getListOfStrings();
for (Iterator i = listOfStrings.iterator(); i.hasNext(); ) {
String item = (String)i.next();

// Work with that string
}
List<String> onlyStrings = new LinkedList<String>();
onlyStrings.add("Legal addition");
/**
* Uncomment these two lines for an error
onlyStrings.add(new StringBuilder("Illegal Addition"));
onlyStrings.add(25);
*/
}
public void testTypeSafeIterators(PrintStream out) throws IOException {
List<String> listOfStrings = new LinkedList<String>();
listOfStrings.add("Happy");
listOfStrings.add("Birthday");
listOfStrings.add("To");
listOfStrings.add("You");
for (Iterator<String> i = listOfStrings.iterator(); i.hasNext(); ) {
String s = i.next();
out.println(s);
}
printListOfStrings(getListOfStrings(), out);
}
private List getList() {
List list = new LinkedList();
list.add(3);
list.add("Blind");
list.add("Mice");
return list;
}
private List<String> getListOfStrings() {
List<String> list = new LinkedList<String>();
list.add("Hello");
list.add("World");
list.add("How");
list.add("Are");
list.add("You?");
return list;
}
public void testTypeSafeReturnValues(PrintStream out) throws IOException {
List<String> strings = getListOfStrings();

for (String s : strings) {
out.println(s);
}
}
private void printListOfStrings(List<String> list, PrintStream out)
throws IOException {
for (Iterator<String> i = list.iterator(); i.hasNext(); ) {
out.println(i.next());
}
}
public void printList(List<?> list, PrintStream out) throws IOException {
for (Iterator<?> i = list.iterator(); i.hasNext(); ) {
out.println(i.next().toString());
}
}
public static void main(String[] args) {
GenericsTester tester = new GenericsTester();
try {
tester.testTypeSafeLists(System.out);
tester.testTypeSafeMaps(System.out);
tester.testTypeSafeIterators(System.out);
tester.testTypeSafeReturnValues(System.out);
List<Integer> ints = new LinkedList<Integer>();
ints.add(1);
ints.add(2);
ints.add(3);
tester.printList(ints, System.out);
/** Uncomment for an error
NumberBox<String> illegal = new NumberBox<String>();
*/
} catch (Exception e) {
e.printStackTrace();
}
}
}
class NumberBox<N extends Number> extends Box<N> {
public NumberBox() {
super();
}

// Sum everything in the box
public double sum() {
double total = 0;
for (Iterator<N> i = contents.iterator(); i.hasNext(); ) {
total = total + i.next().doubleValue();
}
return total;
}
public static <A extends Number> double sum(Box<A> box1,
Box<A> box2) {
double total = 0;
for (Iterator<A> i = box1.contents.iterator(); i.hasNext(); ) {
total = total + i.next().doubleValue();
}
for (Iterator<A> i = box2.contents.iterator(); i.hasNext(); ) {
total = total + i.next().doubleValue();
}
return total;
}
}
class Box<T> {
protected List<T> contents;
public Box() {
contents = new ArrayList<T>();
}
public int getSize() {
return contents.size();
}
public boolean isEmpty() {
return (contents.size() == 0);
}
public void add(T o) {
contents.add(o);
}

public T grab() {
if (!isEmpty()) {
return contents.remove(0);
} else
return null;
}
}

</source>



== Create a typesafe copy of a raw list. ==



<source lang="java">

/*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
*
* Copyright 1997-2007 Sun Microsystems, Inc. All rights reserved.
*
* The contents of this file are subject to the terms of either the GNU
* General Public License Version 2 only ("GPL") or the Common
* Development and Distribution License("CDDL") (collectively, the
* "License"). You may not use this file except in compliance with the
* License. You can obtain a copy of the License at
* http://www.netbeans.org/cddl-gplv2.html
* or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
* specific language governing permissions and limitations under the
* License. When distributing the software, include this License Header
* Notice in each file and include the License file at
* nbbuild/licenses/CDDL-GPL-2-CP. Sun designates this
* particular file as subject to the "Classpath" exception as provided
* by Sun in the GPL Version 2 section of the License file that
* accompanied this code. If applicable, add the following below the
* License Header, with the fields enclosed by brackets [] replaced by
* your own identifying information:
* "Portions Copyrighted [year] [name of copyright owner]"
*
* Contributor(s):
*
* The Original Software is NetBeans. The Initial Developer of the Original
* Software is Sun Microsystems, Inc. Portions Copyright 1997-2006 Sun
* Microsystems, Inc. All Rights Reserved.
*
* If you wish your version of this file to be governed by only the CDDL
* or only the GPL Version 2, indicate your decision by adding
* "[Contributor] elects to include this software in this distribution
* under the [CDDL or GPL Version 2] license." If you do not indicate a
* single choice of license, a recipient has the option to distribute
* your version of this file under either the CDDL, the GPL Version 2 or
* to extend the choice of license to its licensees as provided above.
* However, if you add GPL Version 2 code and therefore, elected the GPL
* Version 2 license, then the option applies only if the new code is
* made subject to such option by the copyright holder.
*/

import java.util.ArrayList;
import java.util.Iterator;
import java.util.LinkedList;
import java.util.List;
import java.util.RandomAccess;
/**
* @since 4.37
* @author Jaroslav Tulach
*/

public class Utils {
/**
* Create a typesafe copy of a raw list.
* @param rawList an unchecked list
* @param type the desired supertype of the entries
* @param strict true to throw a <code>ClassCastException</code> if the raw list has an invalid entry,
* false to skip over such entries (warnings may be logged)
* @return a typed list guaranteed to contain only entries assignable
* to the named type (or they may be null)
* @throws ClassCastException if some entry in the raw list was not well-typed, and only if <code>strict</code> was true
*/
public static <E> List<E> checkedListByCopy(List rawList, Class<E> type, boolean strict) throws ClassCastException {
List<E> l = (rawList instanceof RandomAccess) ? new ArrayList<E>(rawList.size()) : new LinkedList<E>();
Iterator it = rawList.iterator();
while (it.hasNext()) {
Object e = it.next();
try {
l.add(type.cast(e));
} catch (ClassCastException x) {
if (strict) {
throw x;
} else {
System.out.println("not assignable ");
}
}
}
return l;
}
}

</source>



== Create a typesafe copy of a raw map. ==



<source lang="java">

/*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
*
* Copyright 1997-2007 Sun Microsystems, Inc. All rights reserved.
*
* The contents of this file are subject to the terms of either the GNU
* General Public License Version 2 only ("GPL") or the Common
* Development and Distribution License("CDDL") (collectively, the
* "License"). You may not use this file except in compliance with the
* License. You can obtain a copy of the License at
* http://www.netbeans.org/cddl-gplv2.html
* or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
* specific language governing permissions and limitations under the
* License. When distributing the software, include this License Header
* Notice in each file and include the License file at
* nbbuild/licenses/CDDL-GPL-2-CP. Sun designates this
* particular file as subject to the "Classpath" exception as provided
* by Sun in the GPL Version 2 section of the License file that
* accompanied this code. If applicable, add the following below the
* License Header, with the fields enclosed by brackets [] replaced by
* your own identifying information:
* "Portions Copyrighted [year] [name of copyright owner]"
*
* Contributor(s):
*
* The Original Software is NetBeans. The Initial Developer of the Original
* Software is Sun Microsystems, Inc. Portions Copyright 1997-2006 Sun
* Microsystems, Inc. All Rights Reserved.
*
* If you wish your version of this file to be governed by only the CDDL
* or only the GPL Version 2, indicate your decision by adding
* "[Contributor] elects to include this software in this distribution
* under the [CDDL or GPL Version 2] license." If you do not indicate a
* single choice of license, a recipient has the option to distribute
* your version of this file under either the CDDL, the GPL Version 2 or
* to extend the choice of license to its licensees as provided above.
* However, if you add GPL Version 2 code and therefore, elected the GPL
* Version 2 license, then the option applies only if the new code is
* made subject to such option by the copyright holder.
*/

import java.util.HashMap;
import java.util.Iterator;
import java.util.Map;
/**
* @since 4.37
* @author Jaroslav Tulach
*/

public class Utils {
/**
* Create a typesafe copy of a raw map.
* @param rawMap an unchecked map
* @param keyType the desired supertype of the keys
* @param valueType the desired supertype of the values
* @param strict true to throw a <code>ClassCastException</code> if the raw map has an invalid key or value,
* false to skip over such map entries (warnings may be logged)
* @return a typed map guaranteed to contain only keys and values assignable
* to the named types (or they may be null)
* @throws ClassCastException if some key or value in the raw map was not well-typed, and only if <code>strict</code> was true
*/
public static <K,V> Map<K,V> checkedMapByCopy(Map rawMap, Class<K> keyType, Class<V> valueType, boolean strict) throws ClassCastException {
Map<K,V> m2 = new HashMap<K,V>(rawMap.size() * 4 / 3 + 1);
Iterator it = rawMap.entrySet().iterator();
while (it.hasNext()) {
Map.Entry e = (Map.Entry) it.next();
try {
m2.put(keyType.cast(e.getKey()), valueType.cast(e.getValue()));
} catch (ClassCastException x) {
if (strict) {
throw x;
} else {
System.out.println("not assignable");
}
}
}
return m2;
}
}

</source>



== Create a typesafe copy of a raw set. ==



<source lang="java">

/*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
*
* Copyright 1997-2007 Sun Microsystems, Inc. All rights reserved.
*
* The contents of this file are subject to the terms of either the GNU
* General Public License Version 2 only ("GPL") or the Common
* Development and Distribution License("CDDL") (collectively, the
* "License"). You may not use this file except in compliance with the
* License. You can obtain a copy of the License at
* http://www.netbeans.org/cddl-gplv2.html
* or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
* specific language governing permissions and limitations under the
* License. When distributing the software, include this License Header
* Notice in each file and include the License file at
* nbbuild/licenses/CDDL-GPL-2-CP. Sun designates this
* particular file as subject to the "Classpath" exception as provided
* by Sun in the GPL Version 2 section of the License file that
* accompanied this code. If applicable, add the following below the
* License Header, with the fields enclosed by brackets [] replaced by
* your own identifying information:
* "Portions Copyrighted [year] [name of copyright owner]"
*
* Contributor(s):
*
* The Original Software is NetBeans. The Initial Developer of the Original
* Software is Sun Microsystems, Inc. Portions Copyright 1997-2006 Sun
* Microsystems, Inc. All Rights Reserved.
*
* If you wish your version of this file to be governed by only the CDDL
* or only the GPL Version 2, indicate your decision by adding
* "[Contributor] elects to include this software in this distribution
* under the [CDDL or GPL Version 2] license." If you do not indicate a
* single choice of license, a recipient has the option to distribute
* your version of this file under either the CDDL, the GPL Version 2 or
* to extend the choice of license to its licensees as provided above.
* However, if you add GPL Version 2 code and therefore, elected the GPL
* Version 2 license, then the option applies only if the new code is
* made subject to such option by the copyright holder.
*/

import java.util.HashSet;
import java.util.Iterator;
import java.util.Set;
/**
* @since 4.37
* @author Jaroslav Tulach
*/

public class Utils {
/**
* Create a typesafe copy of a raw set.
* @param rawSet an unchecked set
* @param type the desired supertype of the entries
* @param strict true to throw a <code>ClassCastException</code> if the raw set has an invalid entry,
* false to skip over such entries (warnings may be logged)
* @return a typed set guaranteed to contain only entries assignable
* to the named type (or they may be null)
* @throws ClassCastException if some entry in the raw set was not well-typed, and only if <code>strict</code> was true
*/
public static <E> Set<E> checkedSetByCopy(Set rawSet, Class<E> type, boolean strict) throws ClassCastException {
Set<E> s = new HashSet<E>(rawSet.size() * 4 / 3 + 1);
Iterator it = rawSet.iterator();
while (it.hasNext()) {
Object e = it.next();
try {
s.add(type.cast(e));
} catch (ClassCastException x) {
if (strict) {
throw x;
} else {
System.out.println("not assignable ");
}
}
}
return s;
}
}

</source>



== Create a typesafe filter of an unchecked enumeration. ==



<source lang="java">

/*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
*
* Copyright 1997-2007 Sun Microsystems, Inc. All rights reserved.
*
* The contents of this file are subject to the terms of either the GNU
* General Public License Version 2 only ("GPL") or the Common
* Development and Distribution License("CDDL") (collectively, the
* "License"). You may not use this file except in compliance with the
* License. You can obtain a copy of the License at
* http://www.netbeans.org/cddl-gplv2.html
* or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
* specific language governing permissions and limitations under the
* License. When distributing the software, include this License Header
* Notice in each file and include the License file at
* nbbuild/licenses/CDDL-GPL-2-CP. Sun designates this
* particular file as subject to the "Classpath" exception as provided
* by Sun in the GPL Version 2 section of the License file that
* accompanied this code. If applicable, add the following below the
* License Header, with the fields enclosed by brackets [] replaced by
* your own identifying information:
* "Portions Copyrighted [year] [name of copyright owner]"
*
* Contributor(s):
*
* The Original Software is NetBeans. The Initial Developer of the Original
* Software is Sun Microsystems, Inc. Portions Copyright 1997-2006 Sun
* Microsystems, Inc. All Rights Reserved.
*
* If you wish your version of this file to be governed by only the CDDL
* or only the GPL Version 2, indicate your decision by adding
* "[Contributor] elects to include this software in this distribution
* under the [CDDL or GPL Version 2] license." If you do not indicate a
* single choice of license, a recipient has the option to distribute
* your version of this file under either the CDDL, the GPL Version 2 or
* to extend the choice of license to its licensees as provided above.
* However, if you add GPL Version 2 code and therefore, elected the GPL
* Version 2 license, then the option applies only if the new code is
* made subject to such option by the copyright holder.
*/
import java.io.Serializable;
import java.util.AbstractMap;
import java.util.AbstractSet;
import java.util.Collection;
import java.util.Enumeration;
import java.util.Iterator;
import java.util.Map;
import java.util.NoSuchElementException;
import java.util.Set;
/**
* @since 4.37
* @author Jaroslav Tulach
*/

public class Utils {
/**
* Create a typesafe filter of an unchecked enumeration.
* @param rawEnum an unchecked enumeration
* @param type the desired enumeration type
* @param strict if false, elements which are not null but not assignable to the requested type are omitted;
* if true, {@link ClassCastException} may be thrown from an enumeration operation
* @return an enumeration guaranteed to contain only objects of the requested type (or null)
*/
public static <E> Enumeration<E> checkedEnumerationByFilter(Enumeration rawEnum, final Class<E> type, final boolean strict) {
@SuppressWarnings("unchecked")
Enumeration<Object> _rawEnum = rawEnum;
return Enumerations.<Object,E>filter(_rawEnum, new Enumerations.Processor<Object,E>() {
public E process(Object o, Collection<Object> ignore) {
if (o == null) {
return null;
} else {
try {
return type.cast(o);
} catch (ClassCastException x) {
if (strict) {
throw x;
} else {
return null;
}
}
}
}
});
}
}
abstract class CheckedIterator<E> implements Iterator<E> {
static final Object WAITING = new Object();
private final Iterator it;
private Object next = WAITING;
public CheckedIterator(Iterator it) {
this.it = it;
}
protected abstract boolean accept(Object o);
public boolean hasNext() {
if (next != WAITING) {
return true;
}
while (it.hasNext()) {
next = it.next();
if (accept(next)) {
return true;
}
}
next = WAITING;
return false;
}
public E next() {
if (next == WAITING && !hasNext()) {
throw new NoSuchElementException();
}
assert next != WAITING;
@SuppressWarnings("unchecked")
// type-checking is done by accept()
E x = (E) next;
next = WAITING;
return x;
}
public void remove() {
it.remove();
}
}

</source>



== Create a typesafe filter of an unchecked iterator. ==



<source lang="java">

/*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
*
* Copyright 1997-2007 Sun Microsystems, Inc. All rights reserved.
*
* The contents of this file are subject to the terms of either the GNU
* General Public License Version 2 only ("GPL") or the Common
* Development and Distribution License("CDDL") (collectively, the
* "License"). You may not use this file except in compliance with the
* License. You can obtain a copy of the License at
* http://www.netbeans.org/cddl-gplv2.html
* or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
* specific language governing permissions and limitations under the
* License. When distributing the software, include this License Header
* Notice in each file and include the License file at
* nbbuild/licenses/CDDL-GPL-2-CP. Sun designates this
* particular file as subject to the "Classpath" exception as provided
* by Sun in the GPL Version 2 section of the License file that
* accompanied this code. If applicable, add the following below the
* License Header, with the fields enclosed by brackets [] replaced by
* your own identifying information:
* "Portions Copyrighted [year] [name of copyright owner]"
*
* Contributor(s):
*
* The Original Software is NetBeans. The Initial Developer of the Original
* Software is Sun Microsystems, Inc. Portions Copyright 1997-2006 Sun
* Microsystems, Inc. All Rights Reserved.
*
* If you wish your version of this file to be governed by only the CDDL
* or only the GPL Version 2, indicate your decision by adding
* "[Contributor] elects to include this software in this distribution
* under the [CDDL or GPL Version 2] license." If you do not indicate a
* single choice of license, a recipient has the option to distribute
* your version of this file under either the CDDL, the GPL Version 2 or
* to extend the choice of license to its licensees as provided above.
* However, if you add GPL Version 2 code and therefore, elected the GPL
* Version 2 license, then the option applies only if the new code is
* made subject to such option by the copyright holder.
*/
import java.util.Iterator;
import java.util.NoSuchElementException;
/**
* @since 4.37
* @author Jaroslav Tulach
*/
public class Utils {
/**
* Create a typesafe filter of an unchecked iterator. {@link Iterator#remove}
* will work if it does in the unchecked iterator.
*
* @param rawIterator
* an unchecked iterator
* @param type
* the desired enumeration type
* @param strict
* if false, elements which are not null but not assignable to the
* requested type are omitted; if true, {@link ClassCastException}
* may be thrown from an iterator operation
* @return an iterator guaranteed to contain only objects of the requested
* type (or null)
*/
public static <E> Iterator<E> checkedIteratorByFilter(Iterator rawIterator, final Class<E> type,
final boolean strict) {
return new CheckedIterator<E>(rawIterator) {
protected boolean accept(Object o) {
if (o == null) {
return true;
} else if (type.isInstance(o)) {
return true;
} else if (strict) {
throw new ClassCastException(o + " was not a " + type.getName()); // NOI18N
} else {
return false;
}
}
};
}
}
abstract class CheckedIterator<E> implements Iterator<E> {
static final Object WAITING = new Object();
private final Iterator it;
private Object next = WAITING;
public CheckedIterator(Iterator it) {
this.it = it;
}
protected abstract boolean accept(Object o);
public boolean hasNext() {
if (next != WAITING) {
return true;
}
while (it.hasNext()) {
next = it.next();
if (accept(next)) {
return true;
}
}
next = WAITING;
return false;
}
public E next() {
if (next == WAITING && !hasNext()) {
throw new NoSuchElementException();
}
assert next != WAITING;
@SuppressWarnings("unchecked")
// type-checking is done by accept()
E x = (E) next;
next = WAITING;
return x;
}
public void remove() {
it.remove();
}
}

</source>



== Create a typesafe view over an underlying raw map. ==



<source lang="java">

/*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
*
* Copyright 1997-2007 Sun Microsystems, Inc. All rights reserved.
*
* The contents of this file are subject to the terms of either the GNU
* General Public License Version 2 only ("GPL") or the Common
* Development and Distribution License("CDDL") (collectively, the
* "License"). You may not use this file except in compliance with the
* License. You can obtain a copy of the License at
* http://www.netbeans.org/cddl-gplv2.html
* or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
* specific language governing permissions and limitations under the
* License. When distributing the software, include this License Header
* Notice in each file and include the License file at
* nbbuild/licenses/CDDL-GPL-2-CP. Sun designates this
* particular file as subject to the "Classpath" exception as provided
* by Sun in the GPL Version 2 section of the License file that
* accompanied this code. If applicable, add the following below the
* License Header, with the fields enclosed by brackets [] replaced by
* your own identifying information:
* "Portions Copyrighted [year] [name of copyright owner]"
*
* Contributor(s):
*
* The Original Software is NetBeans. The Initial Developer of the Original
* Software is Sun Microsystems, Inc. Portions Copyright 1997-2006 Sun
* Microsystems, Inc. All Rights Reserved.
*
* If you wish your version of this file to be governed by only the CDDL
* or only the GPL Version 2, indicate your decision by adding
* "[Contributor] elects to include this software in this distribution
* under the [CDDL or GPL Version 2] license." If you do not indicate a
* single choice of license, a recipient has the option to distribute
* your version of this file under either the CDDL, the GPL Version 2 or
* to extend the choice of license to its licensees as provided above.
* However, if you add GPL Version 2 code and therefore, elected the GPL
* Version 2 license, then the option applies only if the new code is
* made subject to such option by the copyright holder.
*/
import java.io.Serializable;
import java.util.AbstractMap;
import java.util.AbstractSet;
import java.util.Iterator;
import java.util.Map;
import java.util.NoSuchElementException;
import java.util.Set;
/**
* @since 4.37
* @author Jaroslav Tulach
*/

public class Utils {
/**
* Create a typesafe view over an underlying raw map.
* Mutations affect the underlying map (this is not a copy).
* {@link Map#clear} will make the view empty but may not clear the underlying map.
* You may add entries only of the requested type pair.
* {@link Map#get}, {@link Map#containsKey}, and {@link Map#containsValue} also perform a type check
* and will throw {@link ClassCastException} for an illegal argument.
* The view is serializable if the underlying map is.
* @param rawMap an unchecked map
* @param keyType the desired entry key type
* @param valueType the desired entry value type
* @param strict if false, entries in the underlying map for which the key is not null but not assignable
* to the requested key type, and/or the value is not null but not assignable to
* the requested value type, are omitted from the view;
* if true, a {@link ClassCastException} may arise during some map operation
* @return a view over the raw map guaranteed to match the specified type
*/
public static <K,V> Map<K,V> checkedMapByFilter(Map rawMap, Class<K> keyType, Class<V> valueType, boolean strict) {
return new CheckedMap<K,V>(rawMap, keyType, valueType, strict);
}
private static final class CheckedMap<K,V> extends AbstractMap<K,V> implements Serializable {
private static final long serialVersionUID = 1L;
private final Map rawMap;
private final Class<K> keyType;
private final Class<V> valueType;
private final boolean strict;
public CheckedMap(Map rawMap, Class<K> keyType, Class<V> valueType, boolean strict) {
this.rawMap = rawMap;
this.keyType = keyType;
this.valueType = valueType;
this.strict = strict;
}
private boolean acceptKey(Object o) {
if (o == null) {
return true;
} else if (keyType.isInstance(o)) {
return true;
} else if (strict) {
throw new ClassCastException(o + " was not a " + keyType.getName()); // NOI18N
} else {
return false;
}
}
private boolean acceptValue(Object o) {
if (o == null) {
return true;
} else if (valueType.isInstance(o)) {
return true;
} else if (strict) {
throw new ClassCastException(o + " was not a " + valueType.getName()); // NOI18N
} else {
return false;
}
}
private boolean acceptEntry(Map.Entry e) {
return acceptKey(e.getKey()) && acceptValue(e.getValue());
}
private final class EntrySet extends AbstractSet<Map.Entry<K, V>> {
@Override
public Iterator<Map.Entry<K,V>> iterator() {
return new CheckedIterator<Map.Entry<K,V>>(rawMap.entrySet().iterator()) {
@Override
protected boolean accept(Object o) {
return acceptEntry((Map.Entry) o);
}
};
}
@Override
public int size() {
int c = 0;
Iterator it = rawMap.entrySet().iterator();
while (it.hasNext()) {
if (acceptEntry((Map.Entry) it.next())) {
c++;
}
}
return c;
}
}
@Override
public Set<Map.Entry<K, V>> entrySet() {
return new EntrySet();
}
@Override
public V get(Object key) {
Object o = rawMap.get(keyType.cast(key));
if (acceptValue(o)) {
@SuppressWarnings("unchecked")
V v = (V) o;
return v;
} else {
return null;
}
}
@SuppressWarnings("unchecked")
@Override
public V put(K key, V value) {
Object old = rawMap.put(keyType.cast(key), valueType.cast(value));
if (acceptValue(old)) {
return (V) old;
} else {
return null;
}
}
@Override
public V remove(Object key) {
Object old = rawMap.remove(keyType.cast(key));
if (acceptValue(old)) {
@SuppressWarnings("unchecked")
V v = (V) old;
return v;
} else {
return null;
}
}
@Override
public boolean containsKey(Object key) {
return rawMap.containsKey(keyType.cast(key)) &&
acceptValue(rawMap.get(key));
}
@Override
public boolean containsValue(Object value) {
// Cannot just ask rawMap since we could not check type of key.
return super.containsValue(valueType.cast(value));
}
@Override
public int size() {
int c = 0;
Iterator it = rawMap.entrySet().iterator();
while (it.hasNext()) {
if (acceptEntry((Map.Entry) it.next())) {
c++;
}
}
return c;
}
// keySet, values cannot be so easily overridden because we type-check whole entries
}
}
abstract class CheckedIterator<E> implements Iterator<E> {
static final Object WAITING = new Object();
private final Iterator it;
private Object next = WAITING;
public CheckedIterator(Iterator it) {
this.it = it;
}
protected abstract boolean accept(Object o);
public boolean hasNext() {
if (next != WAITING) {
return true;
}
while (it.hasNext()) {
next = it.next();
if (accept(next)) {
return true;
}
}
next = WAITING;
return false;
}
public E next() {
if (next == WAITING && !hasNext()) {
throw new NoSuchElementException();
}
assert next != WAITING;
@SuppressWarnings("unchecked")
// type-checking is done by accept()
E x = (E) next;
next = WAITING;
return x;
}
public void remove() {
it.remove();
}
}

</source>



== Create a typesafe view over an underlying raw set. ==



<source lang="java">

/*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
*
* Copyright 1997-2007 Sun Microsystems, Inc. All rights reserved.
*
* The contents of this file are subject to the terms of either the GNU
* General Public License Version 2 only ("GPL") or the Common
* Development and Distribution License("CDDL") (collectively, the
* "License"). You may not use this file except in compliance with the
* License. You can obtain a copy of the License at
* http://www.netbeans.org/cddl-gplv2.html
* or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
* specific language governing permissions and limitations under the
* License. When distributing the software, include this License Header
* Notice in each file and include the License file at
* nbbuild/licenses/CDDL-GPL-2-CP. Sun designates this
* particular file as subject to the "Classpath" exception as provided
* by Sun in the GPL Version 2 section of the License file that
* accompanied this code. If applicable, add the following below the
* License Header, with the fields enclosed by brackets [] replaced by
* your own identifying information:
* "Portions Copyrighted [year] [name of copyright owner]"
*
* Contributor(s):
*
* The Original Software is NetBeans. The Initial Developer of the Original
* Software is Sun Microsystems, Inc. Portions Copyright 1997-2006 Sun
* Microsystems, Inc. All Rights Reserved.
*
* If you wish your version of this file to be governed by only the CDDL
* or only the GPL Version 2, indicate your decision by adding
* "[Contributor] elects to include this software in this distribution
* under the [CDDL or GPL Version 2] license." If you do not indicate a
* single choice of license, a recipient has the option to distribute
* your version of this file under either the CDDL, the GPL Version 2 or
* to extend the choice of license to its licensees as provided above.
* However, if you add GPL Version 2 code and therefore, elected the GPL
* Version 2 license, then the option applies only if the new code is
* made subject to such option by the copyright holder.
*/
import java.io.Serializable;
import java.util.AbstractSet;
import java.util.Iterator;
import java.util.NoSuchElementException;
import java.util.Set;
/**
* @since 4.37
* @author Jaroslav Tulach
*/
public class Utils {
/**
* Create a typesafe view over an underlying raw set.
* Mutations affect the underlying set (this is not a copy).
* {@link Set#clear} will make the view empty but may not clear the underlying set.
* You may add elements only of the requested type.
* {@link Set#contains} also performs a type check and will throw {@link ClassCastException}
* for an illegal argument.
* The view is serializable if the underlying set is.
* @param rawSet an unchecked set
* @param type the desired element type
* @param strict if false, elements in the underlying set which are not null and which are not assignable
* to the requested type are omitted from the view;
* if true, a {@link ClassCastException} may arise during some set operation
* @return a view over the raw set guaranteed to match the specified type
*/
public static <E> Set<E> checkedSetByFilter(Set rawSet, Class<E> type, boolean strict) {
return new CheckedSet<E>(rawSet, type, strict);
}
private static final class CheckedSet<E> extends AbstractSet<E> implements Serializable {
private static final long serialVersionUID = 1L;
private final Set rawSet;
private final Class<E> type;
private final boolean strict;
public CheckedSet(Set rawSet, Class<E> type, boolean strict) {
this.rawSet = rawSet;
this.type = type;
this.strict = strict;
}
private boolean acceptEntry(Object o) {
if (o == null) {
return true;
} else if (type.isInstance(o)) {
return true;
} else if (strict) {
throw new ClassCastException(o + " was not a " + type.getName()); // NOI18N
} else {
return false;
}
}
@Override
public Iterator<E> iterator() {
return new CheckedIterator<E>(rawSet.iterator()) {
@Override
protected boolean accept(Object o) {
return acceptEntry(o);
}
};
}
@Override
public int size() {
int c = 0;
Iterator it = rawSet.iterator();
while (it.hasNext()) {
if (acceptEntry(it.next())) {
c++;
}
}
return c;
}
@Override
@SuppressWarnings("unchecked") // complains about usage of raw set
public boolean add(E o) {
return rawSet.add(type.cast(o));
}
@Override
public boolean contains(Object o) {
return rawSet.contains(type.cast(o));
}
}
}
abstract class CheckedIterator<E> implements Iterator<E> {
static final Object WAITING = new Object();
private final Iterator it;
private Object next = WAITING;
public CheckedIterator(Iterator it) {
this.it = it;
}
protected abstract boolean accept(Object o);
public boolean hasNext() {
if (next != WAITING) {
return true;
}
while (it.hasNext()) {
next = it.next();
if (accept(next)) {
return true;
}
}
next = WAITING;
return false;
}
public E next() {
if (next == WAITING && !hasNext()) {
throw new NoSuchElementException();
}
assert next != WAITING;
@SuppressWarnings("unchecked")
// type-checking is done by accept()
E x = (E) next;
next = WAITING;
return x;
}
public void remove() {
it.remove();
}
}

</source>



== Creating a Type-Specific List ==



<source lang="java">

import java.util.ArrayList;
import java.util.List;
public class Main {
public static void main(String[] argv) {
List<Integer> intlist = new ArrayList<Integer>();
intlist.add(new Integer(123));
}
}

</source>



== Data structure and collections: Modern, generics version. ==



<source lang="java">

/*
Java 2, v5.0 (Tiger) New Features
by Herbert Schildt
ISBN: 0072258543
Publisher: McGraw-Hill/Osborne, 2004
*/

import java.util.*;

public class NewStyle {
public static void main(String args[]) {

// Now, list holds references of type String.
ArrayList<String> list = new ArrayList<String>();

list.add("one");
list.add("two");
list.add("three");
list.add("four");

// Notice that Iterator is also generic.
Iterator<String> itr = list.iterator();

// The following statement will now cause a compile-time eror.
// Iterator<Integer> itr = list.iterator(); // Error!

while(itr.hasNext()) {
String str = itr.next(); // no cast needed

// Now, the following line is a compile-time,
// rather than runtime, error.
// Integer i = itr.next(); // this won"t compile

System.out.println(str + " is " + str.length() + " chars long.");
}
}
}

</source>



== Enum and Generic ==



<source lang="java">

/*
* Copyright (c) Ian F. Darwin, http://www.darwinsys.ru/, 1996-2002.
* All rights reserved. Software written by Ian F. Darwin and others.
* $Id: LICENSE,v 1.8 2004/02/09 03:33:38 ian Exp $
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS""
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*
* Java, the Duke mascot, and all variants of Sun"s Java "steaming coffee
* cup" logo are trademarks of Sun Microsystems. Sun"s, and James Gosling"s,
* pioneering role in inventing and promulgating (and standardizing) the Java
* language and environment is gratefully acknowledged.
*
* The pioneering role of Dennis Ritchie and Bjarne Stroustrup, of AT&T, for
* inventing predecessor languages C and C++ is also gratefully acknowledged.
*/
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.io.InputStream;
import java.io.PrintStream;
import java.util.ArrayList;
import java.util.List;
import java.util.StringTokenizer;
/**
* MediaInvoicer - Simple applicatin of Media, MediaFactory &c.
*
* @author ian
* @version $Id: MediaInvoicer.java,v 1.2 2004/03/08 03:30:59 ian Exp $
*/
public class MediaInvoicer {
public static void main(String[] args) throws IOException {
MediaInvoicer mi = new MediaInvoicer(System.in);
Invoice i = mi.getInvoice();
i.print(System.out);
}
BufferedReader myFile;
public MediaInvoicer(InputStream is) {
myFile = new BufferedReader(new InputStreamReader(is));
}
public Invoice getInvoice() throws IOException {
String line;
List < Item > items = new ArrayList < Item > ();
while ((line = myFile.readLine()) != null) {
if (line.startsWith("#")) {
continue;
}
StringTokenizer st = new StringTokenizer(line);
st.nextToken();
Media m = MediaFactory.getMedia(st.nextToken());
int stock = Integer.parseInt(st.nextToken());
int qty = Integer.parseInt(st.nextToken());
Item tmp = new Item(m, stock, qty);
items.add(tmp);
}
return new Invoice(1, 3,
(Item[]) items.toArray(new Item[items.size()]));
}
/** Inner class for line order item */
class Item {
Media product;
int stockNumber;
int quantity;
/**
* @param product
* @param stockNumber
* @param quantity
*/
public Item(Media product, int stockNumber, int quantity) {
super();
this.product = product;
this.stockNumber = stockNumber;
this.quantity = quantity;
}
public String toString() {
return "Item[" + product + " " + stockNumber + "]";
}
}
/** Inner class for one invoice */
class Invoice {
int orderNumber;
int custNumber;
Item[] items;
public Invoice(int orderNumber, int custNumber, Item[] items) {
super();
this.orderNumber = orderNumber;
this.custNumber = custNumber;
this.items = items;
}
public void print(PrintStream ps) {
ps.println("*** Invoice ***");
ps.println("Customer: " + custNumber + ")");
ps.println("Our order number: " + orderNumber);
for (int i = 0; i < items.length; i++) {
Item it = items[i];
ps.println(it);
}
}
}
}

enum Media {
book, music_cd, music_vinyl, movie_vhs, movie_dvd;
}

</source>



== Foreach and generic data structure ==



<source lang="java">

/*
* Copyright (c) Ian F. Darwin, http://www.darwinsys.ru/, 1996-2002.
* All rights reserved. Software written by Ian F. Darwin and others.
* $Id: LICENSE,v 1.8 2004/02/09 03:33:38 ian Exp $
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS""
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*
* Java, the Duke mascot, and all variants of Sun"s Java "steaming coffee
* cup" logo are trademarks of Sun Microsystems. Sun"s, and James Gosling"s,
* pioneering role in inventing and promulgating (and standardizing) the Java
* language and environment is gratefully acknowledged.
*
* The pioneering role of Dennis Ritchie and Bjarne Stroustrup, of AT&T, for
* inventing predecessor languages C and C++ is also gratefully acknowledged.
*/
import java.util.Collection;
import java.util.List;
import java.util.ArrayList;
public class ForeachDemo {
static void iterate(Collection<String> c) {
for (String s : c)
System.out.println(s);
}
public static void main(String args[]) {
List<String> l = new ArrayList<String>();
l.add("Toronto");
l.add("Stockholm");
iterate(l);
}
}

</source>



== Generic ArrayList ==



<source lang="java">

/*
* Copyright (c) Ian F. Darwin, http://www.darwinsys.ru/, 1996-2002.
* All rights reserved. Software written by Ian F. Darwin and others.
* $Id: LICENSE,v 1.8 2004/02/09 03:33:38 ian Exp $
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS""
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*
* Java, the Duke mascot, and all variants of Sun"s Java "steaming coffee
* cup" logo are trademarks of Sun Microsystems. Sun"s, and James Gosling"s,
* pioneering role in inventing and promulgating (and standardizing) the Java
* language and environment is gratefully acknowledged.
*
* The pioneering role of Dennis Ritchie and Bjarne Stroustrup, of AT&T, for
* inventing predecessor languages C and C++ is also gratefully acknowledged.
*/
import java.util.*;
public class ArrayListGenericDemo {
public static void main(String[] args) {
ArrayList<String> data = new ArrayList<String>();
data.add("hello");
data.add("goodbye");
// data.add(new Date()); This won"t compile!
Iterator<String> it = data.iterator();
while (it.hasNext()) {
String s = it.next();
System.out.println(s);
}
}
}

</source>



== Generic Data Structure ==



<source lang="java">

import java.io.*;
interface Executor<E extends Exception> {
void execute() throws E;
}
public class GenericExceptionTest {
public static void main(String args[]) {
try {
Executor<IOException> e =
new Executor<IOException>() {
public void execute() throws IOException
{
// code here that may throw an
// IOException or a subtype of
// IOException
}
};
e.execute();
} catch(IOException ioe) {
System.out.println("IOException: " + ioe);
ioe.printStackTrace();
}
}
}

</source>



== Generic HashMap ==



<source lang="java">

/*
* Copyright (c) Ian F. Darwin, http://www.darwinsys.ru/, 1996-2002.
* All rights reserved. Software written by Ian F. Darwin and others.
* $Id: LICENSE,v 1.8 2004/02/09 03:33:38 ian Exp $
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS""
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*
* Java, the Duke mascot, and all variants of Sun"s Java "steaming coffee
* cup" logo are trademarks of Sun Microsystems. Sun"s, and James Gosling"s,
* pioneering role in inventing and promulgating (and standardizing) the Java
* language and environment is gratefully acknowledged.
*
* The pioneering role of Dennis Ritchie and Bjarne Stroustrup, of AT&T, for
* inventing predecessor languages C and C++ is also gratefully acknowledged.
*/
import java.util.HashMap;
public class HashDemoGeneric {
public static void main(String[] args) {
HashMap<Integer,String> map = new HashMap<Integer,String>();
map.put(1, "Ian");
map.put(42, "Scott");
map.put(123, "Somebody else");
String name = map.get(42);
System.out.println(name);
}
}

</source>



== Generic Stack ==



<source lang="java">

/*
* Copyright (c) Ian F. Darwin, http://www.darwinsys.ru/, 1996-2002.
* All rights reserved. Software written by Ian F. Darwin and others.
* $Id: LICENSE,v 1.8 2004/02/09 03:33:38 ian Exp $
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS""
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*
* Java, the Duke mascot, and all variants of Sun"s Java "steaming coffee
* cup" logo are trademarks of Sun Microsystems. Sun"s, and James Gosling"s,
* pioneering role in inventing and promulgating (and standardizing) the Java
* language and environment is gratefully acknowledged.
*
* The pioneering role of Dennis Ritchie and Bjarne Stroustrup, of AT&T, for
* inventing predecessor languages C and C++ is also gratefully acknowledged.
*/
public class MyStackDemo {
public static void main(String[] args) {
MyStack<String> ms1 = new MyStack<String>();
ms1.push("billg");
ms1.push("scottm");
while (ms1.hasNext()) {
String name = ms1.pop();
System.out.println(name);
}
// Old way of using Collections: not type safe.
MyStack ms2 = new MyStack();
ms2.push("billg"); // EXPECT WARNING
ms2.push("scottm"); // EXPECT WARNING
ms2.push(new java.util.Date()); // EXPECT WARNING

// Show that it is broken
try {
String bad = (String)ms2.pop();
System.err.println("Didn"t get expected exception!");
} catch (ClassCastException ex) {
System.out.println("Did get expected exception.");
}
// Removed the brokenness, print rest of it.
while (ms2.hasNext()) {
String name = (String)ms2.pop();
System.out.println(name);
}
}
}
/** A lax Stack implementation.
* @version $Id: MyStack.java,v 1.4 2004/03/07 23:18:59 ian Exp $
*/
class MyStack<T> {
private int ix = 0;
public static final int MAX = 10;
private T[] data = (T[])new Object[MAX];
public void push(T obj) {
data[ix++] = obj;
}
public boolean hasNext() {
return ix > 0;
}
public boolean hasRoom() {
return ix < MAX;
}
public T pop() {
if (hasNext()) {
return data[--ix];
}
throw new ArrayIndexOutOfBoundsException(-1);
}
}

</source>



== Java generic: Generics and arrays. ==



<source lang="java">

class Gen<T extends Number> {
T ob;

T vals[];

Gen(T o, T[] nums) {
ob = o;

vals = nums;
}
}

public class GenArrays {
public static void main(String args[]) {
Integer n[] = { 1, 2, 3, 4, 5 };

Gen<Integer> iOb = new Gen<Integer>(50, n);

// Can"t create an array of type-specific generic references.
// Gen<Integer> gens[] = new Gen<Integer>[10]; // Wrong!

Gen<?> gens[] = new Gen<?>[10]; // OK
}
}

</source>



== Pre generics example that uses a collection. ==



<source lang="java">

/*
Java 2, v5.0 (Tiger) New Features
by Herbert Schildt
ISBN: 0072258543
Publisher: McGraw-Hill/Osborne, 2004
*/

import java.util.*;

public class OldStyle {
public static void main(String args[]) {
ArrayList list = new ArrayList();

// These lines store strings, but any type of object
// can be stored. In old-style code, there is no
// convenient way restrict the type of objects stored
// in a collection
list.add("one");
list.add("two");
list.add("three");
list.add("four");

Iterator itr = list.iterator();
while(itr.hasNext()) {

// To retrieve an element, an explicit type cast is needed
// because the collection stores only Object.
String str = (String) itr.next(); // explicit cast needed here.

System.out.println(str + " is " + str.length() + " chars long.");
}
}
}

</source>



== The GenStack Class ==



<source lang="java">

import java.util.LinkedList;
class GenStack<E> {
private LinkedList<E> list = new LinkedList<E>();
public void push(E item) {
list.addFirst(item);
}
public E pop() {
return list.poll();
}
public E peek() {
return list.peek();
}
public boolean hasItems() {
return !list.isEmpty();
}
public int size() {
return list.size();
}
}
public class GenStackTest {
public static void main(String[] args) {
GenStack<String> gs = new GenStack<String>();
gs.push("One");
gs.push("Two");
gs.push("Three");
gs.push("Four");
System.out.println("There are " + gs.size() + " items in the stack.\n");
System.out.println("The top item is: " + gs.peek() + "\n");
System.out.println("There are still " + gs.size() + " items in the stack.\n");
System.out.println("Popping everything:");
while (gs.hasItems())
System.out.println(gs.pop());
System.out.println("There are now " + gs.size() + " items in the stack.\n");
System.out.println("The top item is: " + gs.peek() + "\n");
}
}

</source>



== Unchecked Example ==



<source lang="java">

import java.util.*;
public class UncheckedExample {
public void processIntVector(Vector<Integer> v)
{
// perform some processing on the vector
}
public static void main(String args[])
{
Vector<Integer> intVector = new Vector<Integer>();
Vector oldVector = new Vector();
UncheckedExample ue = new UncheckedExample();
// This is permitted
oldVector = intVector;
// This causes an unchecked warning
intVector = oldVector;
// This is permitted
ue.processIntVector(intVector);
// This causes an unchecked warning
ue.processIntVector(oldVector);
}
}

</source>

Java/Generics/Generic Interface

2010-06-01T07:27:19Z

Admin: 1 версия

== A generic interface example. ==



<source lang="java">
interface MinMax<T extends Comparable<T>> {
T min();
T max();
}

class MyClass<T extends Comparable<T>> implements MinMax<T> {
T[] vals;

MyClass(T[] o) { vals = o; }

public T min() {
T v = vals[0];
for(int i=1; i < vals.length; i++)
if(vals[i].rupareTo(v) < 0) v = vals[i];

return v;
}

public T max() {
T v = vals[0];

for(int i=1; i < vals.length; i++)
if(vals[i].rupareTo(v) > 0) v = vals[i];

return v;
}
}

public class GenIFDemo {
public static void main(String args[]) {
Integer inums[] = {3, 6, 2, 8, 6 };
Character chs[] = {"b", "r", "p", "w" };

MyClass<Integer> iob = new MyClass<Integer>(inums);
MyClass<Character> cob = new MyClass<Character>(chs);

System.out.println("Max value in inums: " + iob.max());
System.out.println("Min value in inums: " + iob.min());

System.out.println("Max value in chs: " + cob.max());
System.out.println("Min value in chs: " + cob.min());
}
}

</source>



== Interface Generic (Has compile error) ==



<source lang="java">

import java.util.*;
interface BaseInterface<A> {
A getInfo();
}
class ParentClass implements BaseInterface<Integer> {
public Integer getInfo()
{
return(null);
}
}
class ChildClass extends ParentClass implements BaseInterface<String> { }
public class BadParents {
public static void main(String args[])
{
Vector<Integer> v1 = new Vector<Integer>();
Vector v2;
v1 = v2;
v2 = v1;
}
}

</source>

Java/Generics/Generic Constructor

2010-06-01T07:27:19Z

Admin: 1 версия

== Use a generic constructor. ==



<source lang="java">
class GenCons {
private double val;
<T extends Number> GenCons(T arg) {
val = arg.doubleValue();
}
void showval() {
System.out.println("val: " + val);
}
}
public class GenConsDemo {
public static void main(String args[]) {
GenCons test = new GenCons(100);
GenCons test2 = new GenCons(123.5F);
test.showval();
test2.showval();
}
}

</source>

Java/Collections Data Structure

2010-06-01T07:27:18Z

Admin: 1 версия

* [[Java/Collections Data Structure/Algorithms | Algorithms]]
* [[Java/Collections Data Structure/Array | Array]]
* [[Java/Collections Data Structure/Array Collections | Array Collections]]
* [[Java/Collections Data Structure/Array Compare | Array Compare]]
* [[Java/Collections Data Structure/Array Convert | Array Convert]]
* [[Java/Collections Data Structure/Array Insert Remove | Array Insert Remove]]
* [[Java/Collections Data Structure/Array Sort Search | Array Sort Search]]
* [[Java/Collections Data Structure/Array SubArray | Array SubArray]]
* [[Java/Collections Data Structure/ArrayList | ArrayList]]
* [[Java/Collections Data Structure/Arrays | Arrays]]
* [[Java/Collections Data Structure/Auto Growth Array | Auto Growth Array]]
* [[Java/Collections Data Structure/BitSet | BitSet]]
* [[Java/Collections Data Structure/Collection | Collection]]
* [[Java/Collections Data Structure/Collections | Collections]]
* [[Java/Collections Data Structure/Comparator | Comparator]]
* [[Java/Collections Data Structure/Concurrent | Concurrent]]
* [[Java/Collections Data Structure/Custom List | Custom List]]
* [[Java/Collections Data Structure/Customized Map | Customized Map]]
* [[Java/Collections Data Structure/Deque | Deque]]
* [[Java/Collections Data Structure/Dictionary | Dictionary]]
* [[Java/Collections Data Structure/EnumMap | EnumMap]]
* [[Java/Collections Data Structure/EnumSet | EnumSet]]
* [[Java/Collections Data Structure/Enumerator | Enumerator]]
* [[Java/Collections Data Structure/General Collections | General Collections]]
* [[Java/Collections Data Structure/Graph | Graph]]
* [[Java/Collections Data Structure/HashMap | HashMap]]
* [[Java/Collections Data Structure/HashSet | HashSet]]
* [[Java/Collections Data Structure/HashTable Map | HashTable Map]]
* [[Java/Collections Data Structure/Heaps | Heaps]]
* [[Java/Collections Data Structure/History | History]]
* [[Java/Collections Data Structure/IdentityHashMap | IdentityHashMap]]
* [[Java/Collections Data Structure/Infix Postfix | Infix Postfix]]
* [[Java/Collections Data Structure/Iterator | Iterator]]
* [[Java/Collections Data Structure/Link List | Link List]]
* [[Java/Collections Data Structure/LinkedHashMap | LinkedHashMap]]
* [[Java/Collections Data Structure/LinkedHashSet | LinkedHashSet]]
* [[Java/Collections Data Structure/List | List]]
* [[Java/Collections Data Structure/Map | Map]]
* [[Java/Collections Data Structure/Paging | Paging]]
* [[Java/Collections Data Structure/Priority List | Priority List]]
* [[Java/Collections Data Structure/Queue | Queue]]
* [[Java/Collections Data Structure/Range | Range]]
* [[Java/Collections Data Structure/Set | Set]]
* [[Java/Collections Data Structure/Shuffle | Shuffle]]
* [[Java/Collections Data Structure/Soft Map | Soft Map]]
* [[Java/Collections Data Structure/SoftReference | SoftReference]]
* [[Java/Collections Data Structure/Sort Search | Sort Search]]
* [[Java/Collections Data Structure/SortedSet | SortedSet]]
* [[Java/Collections Data Structure/Stack | Stack]]
* [[Java/Collections Data Structure/State Machine | State Machine]]
* [[Java/Collections Data Structure/Tree | Tree]]
* [[Java/Collections Data Structure/TreeMap | TreeMap]]
* [[Java/Collections Data Structure/TreeSet | TreeSet]]
* [[Java/Collections Data Structure/Vector | Vector]]
* [[Java/Collections Data Structure/Weak List | Weak List]]
* [[Java/Collections Data Structure/Weak Set | Weak Set]]
* [[Java/Collections Data Structure/WeakHashMap | WeakHashMap]]

Java/Collections Data Structure/Set

2010-06-01T07:27:17Z

Admin: 1 версия

== An IdentitySet that uses reference-equality instead of object-equality ==



<source lang="java">

/*
* Copyright 2005 Ralf Joachim
*
* 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.
*/
import java.util.Collection;
import java.util.Iterator;
import java.util.NoSuchElementException;
import java.util.Set;
/**
* An IdentitySet that uses reference-equality instead of object-equality. According
* to its special function it violates some design contracts of the <code>Set</code>
* interface.
*
* @author
* @version $Revision: 7491 $ $Date: 2006-04-13 10:49:49 -0600 (Thu, 13 Apr 2006) $
* @since 0.9.9
*/
public final class IdentitySet implements Set {
//--------------------------------------------------------------------------
/** Default number of buckets. */
private static final int DEFAULT_CAPACITY = 17;

/** Default load factor. */
private static final float DEFAULT_LOAD = 0.75f;

/** Default number of entries. */
private static final int DEFAULT_ENTRIES = (int) (DEFAULT_CAPACITY * DEFAULT_LOAD);

/** Default factor to increment capacity. */
private static final int DEFAULT_INCREMENT = 2;

/** First prime number to check is 3 as we prevent 2 by design. */
private static final int FIRST_PRIME_TO_CHECK = 3;

//--------------------------------------------------------------------------
/** Number of buckets. */
private int _capacity;

/** Maximum number of entries before rehashing. */
private int _maximum;
/** Buckets. */
private Entry[] _buckets;
/** Number of map entries. */
private int _entries = 0;
//--------------------------------------------------------------------------
/**
* Construct a set with default capacity.
*/
public IdentitySet() {
_capacity = DEFAULT_CAPACITY;
_maximum = DEFAULT_ENTRIES;
_buckets = new Entry[DEFAULT_CAPACITY];
}

/**
* Construct a set with given capacity.
*
* @param capacity The capacity of entries this set should be initialized with.
*/
public IdentitySet(final int capacity) {
_capacity = capacity;
_maximum = (int) (capacity * DEFAULT_LOAD);
_buckets = new Entry[capacity];
}

/**
* {@inheritDoc}
* @see java.util.Collection#clear()
*/
public void clear() {
_capacity = DEFAULT_CAPACITY;
_maximum = DEFAULT_ENTRIES;
_buckets = new Entry[DEFAULT_CAPACITY];
_entries = 0;
}
/**
* {@inheritDoc}
* @see java.util.Collection#size()
*/
public int size() { return _entries; }
/**
* {@inheritDoc}
* @see java.util.Collection#isEmpty()
*/
public boolean isEmpty() { return (_entries == 0); }
/**
* {@inheritDoc}
* @see java.util.Collection#add(java.lang.Object)
*/
public boolean add(final Object key) {
int hash = System.identityHashCode(key);
int index = hash % _capacity;
if (index < 0) { index = -index; }
Entry entry = _buckets[index];
Entry prev = null;
while (entry != null) {
if (entry.getKey() == key) {
// There is already a mapping for this key.
return false;
}
prev = entry;
entry = entry.getNext();
}
if (prev == null) {
// There is no previous entry in this bucket.
_buckets[index] = new Entry(key, hash);
} else {
// Next entry is empty so we have no mapping for this key.
prev.setNext(new Entry(key, hash));
}
_entries++;
if (_entries > _maximum) { rehash(); }
return true;
}
/**
* Rehash the map into a new array with increased capacity.
*/
private void rehash() {
long nextCapacity = _capacity * DEFAULT_INCREMENT;
if (nextCapacity > Integer.MAX_VALUE) { return; }
nextCapacity = nextPrime(nextCapacity);
if (nextCapacity > Integer.MAX_VALUE) { return; }
int newCapacity = (int) nextCapacity;
Entry[] newBuckets = new Entry[newCapacity];
Entry entry = null;
Entry temp = null;
Entry next = null;
int newIndex = 0;
for (int index = 0; index < _capacity; index++) {
entry = _buckets[index];
while (entry != null) {
next = entry.getNext();
newIndex = entry.getHash() % newCapacity;
if (newIndex < 0) { newIndex = -newIndex; }
temp = newBuckets[newIndex];
if (temp == null) {
// First entry of the bucket.
entry.setNext(null);
} else {
// Hook entry into beginning of the buckets chain.
entry.setNext(temp);
}
newBuckets[newIndex] = entry;
entry = next;
}
}
_capacity = newCapacity;
_maximum = (int) (newCapacity * DEFAULT_LOAD);
_buckets = newBuckets;
}
/**
* Find next prime number greater than minimum.
*
* @param minimum The minimum (exclusive) value of the next prime number.
* @return The next prime number greater than minimum.
*/
private long nextPrime(final long minimum) {
long candidate = ((minimum + 1) / 2) * 2 + 1;
while (!isPrime(candidate)) { candidate += 2; }
return candidate;
}
/**
* Check for prime number.
*
* @param candidate Number to be checked for being a prime number.
* @return <code>true</code> if the given number is a prime number
* <code>false</code> otherwise.
*/
private boolean isPrime(final long candidate) {
if ((candidate / 2) * 2 == candidate) { return false; }
long stop = candidate / 2;
for (long i = FIRST_PRIME_TO_CHECK; i < stop; i += 2) {
if ((candidate / i) * i == candidate) { return false; }
}
return true;
}
/**
* {@inheritDoc}
* @see java.util.Collection#contains(java.lang.Object)
*/
public boolean contains(final Object key) {
int hash = System.identityHashCode(key);
int index = hash % _capacity;
if (index < 0) { index = -index; }
Entry entry = _buckets[index];
while (entry != null) {
if (entry.getKey() == key) { return true; }
entry = entry.getNext();
}
return false;
}
/**
* {@inheritDoc}
* @see java.util.Collection#remove(java.lang.Object)
*/
public boolean remove(final Object key) {
int hash = System.identityHashCode(key);
int index = hash % _capacity;
if (index < 0) { index = -index; }
Entry entry = _buckets[index];
Entry prev = null;
while (entry != null) {
if (entry.getKey() == key) {
// Found the entry.
if (prev == null) {
// First element in bucket matches.
_buckets[index] = entry.getNext();
} else {
// Remove the entry from the chain.
prev.setNext(entry.getNext());
}
_entries--;
return true;
}
prev = entry;
entry = entry.getNext();
}
return false;
}

/**
* {@inheritDoc}
* @see java.util.Collection#iterator()
*/
public Iterator iterator() {
return new IdentityIterator();
}

/**
* {@inheritDoc}
* @see java.util.Collection#toArray()
*/
public Object[] toArray() {
Object[] result = new Object[_entries];
int j = 0;
for (int i = 0; i < _capacity; i++) {
Entry entry = _buckets[i];
while (entry != null) {
result[j++] = entry.getKey();
entry = entry.getNext();
}
}

return result;
}

/**
* {@inheritDoc}
* @see java.util.Collection#toArray(java.lang.Object[])
*/
public Object[] toArray(final Object[] a) {
Object[] result = a;
if (result.length < _entries) {
result = (Object[]) java.lang.reflect.Array.newInstance(
result.getClass().getComponentType(), _entries);
}

int j = 0;
for (int i = 0; i < _capacity; i++) {
Entry entry = _buckets[i];
while (entry != null) {
result[j++] = entry.getKey();
entry = entry.getNext();
}
}

while (j < result.length) {
result[j++] = null;
}

return result;
}

/**
* In contrast with the design contract of the <code>Set</code> interface this method
* has not been implemented and throws a <code>UnsupportedOperationException</code>.
*
* {@inheritDoc}
* @see java.util.Set#containsAll
*/
public boolean containsAll(final Collection c) {
throw new UnsupportedOperationException();
}

/**
* This optional method has not been implemented for <code>IdentitySet</code> instead
* it throws a <code>UnsupportedOperationException</code> as defined in the
* <code>Set</code> interface.
*
* {@inheritDoc}
* @see java.util.Set#addAll
*/
public boolean addAll(final Collection c) {
throw new UnsupportedOperationException();
}

/**
* This optional method has not been implemented for <code>IdentitySet</code> instead
* it throws a <code>UnsupportedOperationException</code> as defined in the
* <code>Set</code> interface.
*
* {@inheritDoc}
* @see java.util.Set#removeAll
*/
public boolean removeAll(final Collection c) {
throw new UnsupportedOperationException();
}

/**
* This optional method has not been implemented for <code>IdentitySet</code> instead
* it throws a <code>UnsupportedOperationException</code> as defined in the
* <code>Set</code> interface.
*
* {@inheritDoc}
* @see java.util.Set#retainAll
*/
public boolean retainAll(final Collection c) {
throw new UnsupportedOperationException();
}

//--------------------------------------------------------------------------
/**
* An entry of the <code>IdentitySet</code>.
*/
public final class Entry {
/** Key of entry. */
private Object _key;

/** Identity hashcode of key. */
private int _hash;

/** Reference to next entry. */
private Entry _next = null;
/**
* Construct an entry.
*
* @param key Key of entry.
* @param hash Identity hashcode of key.
*/
public Entry(final Object key, final int hash) {
_key = key;
_hash = hash;
}
/**
* Get key of entry.
*
* @return Key of entry.
*/
public Object getKey() { return _key; }
/**
* Get identity hashcode of key.
*
* @return Identity hashcode of key.
*/
public int getHash() { return _hash; }
/**
* Set reference to next entry.
*
* @param next New reference to next entry.
*/
public void setNext(final Entry next) { _next = next; }
/**
* Get reference to next entry.
*
* @return Reference to next entry.
*/
public Entry getNext() { return _next; }
}
//--------------------------------------------------------------------------
/**
* An iterator over all entries of the <code>IdentitySet</code>.
*/
private class IdentityIterator implements Iterator {
/** Index of the current bucket. */
private int _index = 0;

/** The next entry to be returned. <code>null</code> when there is none. */
private Entry _next = _buckets[0];
/**
* Construct a iterator over all entries of the <code>IdentitySet</code>.
*/
public IdentityIterator() {
if (_entries > 0) {
while ((_next == null) && (++_index < _capacity)) {
_next = _buckets[_index];
}
}
}
/**
* {@inheritDoc}
* @see java.util.Iterator#hasNext()
*/
public boolean hasNext() {
return (_next != null);
}
/**
* {@inheritDoc}
* @see java.util.Iterator#next()
*/
public Object next() {
Entry entry = _next;
if (entry == null) { throw new NoSuchElementException(); }

_next = entry.getNext();
while ((_next == null) && (++_index < _capacity)) {
_next = _buckets[_index];
}

return entry.getKey();
}

/**
* This optional method is not implemented for <code>IdentityIterator</code>
* instead it throws a <code>UnsupportedOperationException</code> as defined
* in the <code>Iterator</code> interface.
*
* @see java.util.Iterator#remove()
*/
public void remove() {
throw new UnsupportedOperationException();
}
}

//--------------------------------------------------------------------------
}

</source>



== An implementation of the java.util.Stack based on an ArrayList instead of a Vector, so it is not synchronized to protect against multi-threaded access. ==



<source lang="java">

/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You 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.
*/

import java.util.ArrayList;
import java.util.Collection;
import java.util.EmptyStackException;
import java.util.NoSuchElementException;
/**
* An implementation of the {@link java.util.Stack} API that is based on an
* <code>ArrayList</code> instead of a <code>Vector</code>, so it is not
* synchronized to protect against multi-threaded access. The implementation
* is therefore operates faster in environments where you do not need to
* worry about multiple thread contention.
* <p>
* The removal order of an <code>ArrayStack</code> is based on insertion
* order: The most recently added element is removed first. The iteration
* order is <i>not</i> the same as the removal order. The iterator returns
* elements from the bottom up, whereas the {@link #remove()} method removes
* them from the top down.
* <p>
* Unlike <code>Stack</code>, <code>ArrayStack</code> accepts null entries.
* <p>
* <strong>Note:</strong> this class should be bytecode-identical to the
* version in commons collections. This is required to allow backwards
* compability with both previous versions of BeanUtils and also allow
* coexistance with both collections 2.1 and 3.0.
*
* @see java.util.Stack
* @since Commons Collections 1.0
* @version $Revision: 555824 $ $Date: 2007-07-13 01:27:15 +0100 (Fri, 13 Jul 2007) $
*
* @author Craig R. McClanahan
* @author Paul Jack
* @author Stephen Colebourne
*/
public class ArrayStack extends ArrayList implements Buffer {
/** Ensure serialization compatibility */
private static final long serialVersionUID = 2130079159931574599L;
/**
* Constructs a new empty <code>ArrayStack</code>. The initial size
* is controlled by <code>ArrayList</code> and is currently 10.
*/
public ArrayStack() {
super();
}
/**
* Constructs a new empty <code>ArrayStack</code> with an initial size.
*
* @param initialSize the initial size to use
* @throws IllegalArgumentException if the specified initial size
* is negative
*/
public ArrayStack(int initialSize) {
super(initialSize);
}
/**
* Return <code>true</code> if this stack is currently empty.
* <p>
* This method exists for compatibility with <code>java.util.Stack</code>.
* New users of this class should use <code>isEmpty</code> instead.
*
* @return true if the stack is currently empty
*/
public boolean empty() {
return isEmpty();
}
/**
* Returns the top item off of this stack without removing it.
*
* @return the top item on the stack
* @throws EmptyStackException if the stack is empty
*/
public Object peek() throws EmptyStackException {
int n = size();
if (n <= 0) {
throw new EmptyStackException();
} else {
return get(n - 1);
}
}
/**
* Returns the n"th item down (zero-relative) from the top of this
* stack without removing it.
*
* @param n the number of items down to go
* @return the n"th item on the stack, zero relative
* @throws EmptyStackException if there are not enough items on the
* stack to satisfy this request
*/
public Object peek(int n) throws EmptyStackException {
int m = (size() - n) - 1;
if (m < 0) {
throw new EmptyStackException();
} else {
return get(m);
}
}
/**
* Pops the top item off of this stack and return it.
*
* @return the top item on the stack
* @throws EmptyStackException if the stack is empty
*/
public Object pop() throws EmptyStackException {
int n = size();
if (n <= 0) {
throw new EmptyStackException();
} else {
return remove(n - 1);
}
}
/**
* Pushes a new item onto the top of this stack. The pushed item is also
* returned. This is equivalent to calling <code>add</code>.
*
* @param item the item to be added
* @return the item just pushed
*/
public Object push(Object item) {
add(item);
return item;
}
/**
* Returns the one-based position of the distance from the top that the
* specified object exists on this stack, where the top-most element is
* considered to be at distance <code>1</code>. If the object is not
* present on the stack, return <code>-1</code> instead. The
* <code>equals()</code> method is used to compare to the items
* in this stack.
*
* @param object the object to be searched for
* @return the 1-based depth into the stack of the object, or -1 if not found
*/
public int search(Object object) {
int i = size() - 1; // Current index
int n = 1; // Current distance
while (i >= 0) {
Object current = get(i);
if ((object == null && current == null) ||
(object != null && object.equals(current))) {
return n;
}
i--;
n++;
}
return -1;
}
/**
* Returns the element on the top of the stack.
*
* @return the element on the top of the stack
* @throws BufferUnderflowException if the stack is empty
*/
public Object get() {
int size = size();
if (size == 0) {
throw new BufferUnderflowException();
}
return get(size - 1);
}
/**
* Removes the element on the top of the stack.
*
* @return the removed element
* @throws BufferUnderflowException if the stack is empty
*/
public Object remove() {
int size = size();
if (size == 0) {
throw new BufferUnderflowException();
}
return remove(size - 1);
}
}
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You 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.
*/

/**
* Defines a collection that allows objects to be removed in some well-defined order.
* <p>
* The removal order can be based on insertion order (eg, a FIFO queue or a
* LIFO stack), on access order (eg, an LRU cache), on some arbitrary comparator
* (eg, a priority queue) or on any other well-defined ordering.
* <p>
* Note that the removal order is not necessarily the same as the iteration
* order. A <code>Buffer</code> implementation may have equivalent removal
* and iteration orders, but this is not required.
* <p>
* This interface does not specify any behavior for
* {@link Object#equals(Object)} and {@link Object#hashCode} methods. It
* is therefore possible for a <code>Buffer</code> implementation to also
* also implement {@link java.util.List}, {@link java.util.Set} or
* {@link Bag}.
* <p>
* <strong>Note:</strong> this class should be bytecode-identical to the
* version in commons collections. This is required to allow backwards
* compability with both previous versions of BeanUtils and also allow
* coexistance with both collections 2.1 and 3.0.
*
* @since Commons Collections 2.1
* @version $Revision: 555824 $ $Date: 2007-07-13 01:27:15 +0100 (Fri, 13 Jul 2007) $
*
* @author Avalon
* @author Berin Loritsch
* @author Paul Jack
* @author Stephen Colebourne
*/
interface Buffer extends Collection {
/**
* Gets and removes the next object from the buffer.
*
* @return the next object in the buffer, which is also removed
* @throws BufferUnderflowException if the buffer is already empty
*/
Object remove();
/**
* Gets the next object from the buffer without removing it.
*
* @return the next object in the buffer, which is not removed
* @throws BufferUnderflowException if the buffer is empty
*/
Object get();
}
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You 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.
*/

/**
* The BufferUnderflowException is used when the buffer is already empty.
* <p>
* NOTE: From version 3.0, this exception extends NoSuchElementException.
*
* @since Commons Collections 2.1
* @version $Revision: 555824 $ $Date: 2007-07-13 01:27:15 +0100 (Fri, 13 Jul 2007) $
*
* @author Avalon
* @author Berin Loritsch
* @author Jeff Turner
* @author Paul Jack
* @author Stephen Colebourne
*/
class BufferUnderflowException extends NoSuchElementException {

/** The root cause throwable */
private final Throwable throwable;
/**
* Constructs a new <code>BufferUnderflowException</code>.
*/
public BufferUnderflowException() {
super();
throwable = null;
}
/**
* Construct a new <code>BufferUnderflowException</code>.
*
* @param message the detail message for this exception
*/
public BufferUnderflowException(String message) {
this(message, null);
}
/**
* Construct a new <code>BufferUnderflowException</code>.
*
* @param message the detail message for this exception
* @param exception the root cause of the exception
*/
public BufferUnderflowException(String message, Throwable exception) {
super(message);
throwable = exception;
}
/**
* Gets the root cause of the exception.
*
* @return the root cause
*/
public final Throwable getCause() {
return throwable;
}

}

</source>



== Another Set demo ==



<source lang="java">

import java.util.Arrays;
import java.util.HashSet;
import java.util.Set;
public class SetMembership {
final static String[] keywordarray = { "abstract", "assert", "boolean",
"break", "byte", "while" };
final static Set keywords = new HashSet(Arrays.asList(keywordarray));
static boolean isKeyword1(String id) {
return keywords.contains(id);
}
static boolean isKeyword2(String id) {
return Arrays.binarySearch(keywordarray, id) >= 0;
}
}

</source>



== Array Set extends AbstractSet ==



<source lang="java">

import java.io.Serializable;
import java.util.*;
public class ArraySet extends AbstractSet
implements Cloneable, Serializable {
private ArrayList list;
public ArraySet() {
list = new ArrayList();
}
public ArraySet(Collection col) {
list = new ArrayList();
// No need to check for dups if col is a set
Iterator itor = col.iterator();
if (col instanceof Set) {
while (itor.hasNext()) {
list.add(itor.next());
}
} else {
while(itor.hasNext()) {
add(itor.next());
}
}
}
public Iterator iterator() {
return list.iterator();
}
public int size() {
return list.size();
}
public boolean add(Object element) {
boolean modified;
if (modified = !list.contains(element)) {
list.add(element);
}
return modified;
}
public boolean remove(Object element) {
return list.remove(element);
}
public boolean isEmpty() {
return list.isEmpty();
}
public boolean contains(Object element) {
return list.contains(element);
}
public void clear() {
list.clear();
}
public Object clone() {
try {
ArraySet newSet = (ArraySet)super.clone();
newSet.list = (ArrayList)list.clone();
return newSet;
} catch (CloneNotSupportedException e) {
throw new InternalError();
}
}
}

</source>



== A thin wrapper around a List transforming it into a modifiable Set. ==



<source lang="java">

import java.io.Serializable;
import java.util.AbstractSet;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Iterator;
import java.util.List;
import java.util.Set;
/**
* A thin wrapper around a <code>List</code> transforming it into a modifiable
* <code>Set</code>.
*
* @version <tt>$Revision: 2800 $</tt>
* @author
*/
@SuppressWarnings("unchecked")
public class ListSet extends AbstractSet implements Set, Cloneable, Serializable {
/** The serialVersionUID */
private static final long serialVersionUID = 7333619218072079496L;
/** The <tt>List</tt> which will be used for element storage. */
protected final List list;
/**
* Construct a <tt>ListSet</tt>.
*
* @param list
* The <tt>List</tt> which will be used for element storage.
*
* @throws IllegalArgumentException
* List is <tt>null</tt> or contains duplicate entries.
*/
public ListSet(final List list) {
if (list == null)
throw new RuntimeException("list");
// make sure there are no duplicates
int size = list.size();
for (int i = 0; i < size; i++) {
Object obj = list.get(i);
if (list.indexOf(obj) != list.lastIndexOf(obj)) {
throw new IllegalArgumentException("list contains duplicate entries");
}
}
this.list = list;
}
/**
* Construct a <tt>ListSet</tt> using an <tt>ArrayList</tt> for backing.
*/
public ListSet() {
this(new ArrayList());
}
/**
* Construct a <tt>ListSet</tt> using an <tt>ArrayList</tt> for backing
* and populated with the given elements.
*
* @param elements
* The elements for the list.
*/
public ListSet(final Collection elements) {
this(new ArrayList(elements));
}
public List getList() {
return list;
}
/**
* Return the size of the set.
*
* @return The size of the set.
*/
public int size() {
return list.size();
}
/**
* Return an iteration over the elements in the set.
*
* @return An iteration over the elements in the set.
*/
public Iterator iterator() {
return list.iterator();
}
/**
* Add an element to the set.
*
* @param obj
* Element to add to the set.
* @return True if the element was added.
*/
public boolean add(final Object obj) {
boolean added = false;
if (!list.contains(obj)) {
added = list.add(obj);
}
return added;
}
/**
* Returns <tt>true</tt> if this set contains no elements.
*
* @return <tt>true</tt> if this set contains no elements.
*/
public boolean isEmpty() {
return list.isEmpty();
}
/**
* Returns <tt>true</tt> if this set contains the specified element.
*
* @param obj
* Element whose presence in this set is to be tested.
* @return <tt>true</tt> if this set contains the specified element.
*/
public boolean contains(final Object obj) {
return list.contains(obj);
}
/**
* Removes the given element from this set if it is present.
*
* @param obj
* Object to be removed from this set, if present.
* @return <tt>true</tt> if the set contained the specified element.
*/
public boolean remove(final Object obj) {
return list.remove(obj);
}
/**
* Removes all of the elements from this set.
*/
public void clear() {
list.clear();
}
/**
* Returns a shallow copy of this <tt>ListSet</tt> instance.
*
* @return A shallow copy of this set.
*/
public Object clone() {
try {
return super.clone();
} catch (CloneNotSupportedException e) {
throw new InternalError();
}
}
}

</source>



== A thread-safe Set that manages canonical objects ==



<source lang="java">

/*
* Copyright 2004 Brian S O"Neill
*
* 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.
*/
//revised from cojen
import java.lang.ref.Reference;
import java.lang.ref.ReferenceQueue;
import java.lang.ref.WeakReference;
import java.util.AbstractSet;
import java.util.Iterator;
import java.util.NoSuchElementException;
/**
* A thread-safe Set that manages canonical objects: sharable objects that are
* typically immutable. Call the {@link #put put} method for supplying the
* WeakCanonicalSet with candidate canonical instances.
* <p>
* Objects that do not customize the hashCode and equals methods don"t make
* sense to be canonicalized because each instance will be considered unique.
* The object returned from the {@link #put put} method will always be the same
* as the one passed in.
*
* @author Brian S O"Neill
*/
public class WeakCanonicalSet<T> extends AbstractSet<T> {
private Entry<T>[] table;
private int count;
private int threshold;
private final float loadFactor;
private final ReferenceQueue<T> queue;
public WeakCanonicalSet() {
final int initialCapacity = 101;
final float loadFactor = 0.75f;
this.loadFactor = loadFactor;
this.table = new Entry[initialCapacity];
this.threshold = (int)(initialCapacity * loadFactor);
this.queue = new ReferenceQueue<T>();
}
/**
* Pass in a candidate canonical object and get a unique instance from this
* set. The returned object will always be of the same type as that passed
* in. If the object passed in does not equal any object currently in the
* set, it will be added to the set, becoming canonical.
*
* @param obj candidate canonical object; null is also accepted
*/
public synchronized <U extends T> U put(U obj) {
// This implementation is based on the WeakIdentityMap.put method.
if (obj == null) {
return null;
}
Entry<T>[] tab = this.table;
// Cleanup after cleared References.
{
ReferenceQueue queue = this.queue;
Reference ref;
while ((ref = queue.poll()) != null) {
// Since buckets are single-linked, traverse entire list and
// cleanup all cleared references in it.
int index = (((Entry) ref).hash & 0x7fffffff) % tab.length;
for (Entry<T> e = tab[index], prev = null; e != null; e = e.next) {
if (e.get() == null) {
if (prev != null) {
prev.next = e.next;
} else {
tab[index] = e.next;
}
this.count--;
} else {
prev = e;
}
}
}
}
int hash = hashCode(obj);
int index = (hash & 0x7fffffff) % tab.length;
for (Entry<T> e = tab[index], prev = null; e != null; e = e.next) {
T iobj = e.get();
if (iobj == null) {
// Clean up after a cleared Reference.
if (prev != null) {
prev.next = e.next;
} else {
tab[index] = e.next;
}
this.count--;
} else if (e.hash == hash &&
obj.getClass() == iobj.getClass() &&
equals(obj, iobj)) {
// Found canonical instance.
return (U) iobj;
} else {
prev = e;
}
}
if (this.count >= this.threshold) {
// Rehash the table if the threshold is exceeded.
rehash();
tab = this.table;
index = (hash & 0x7fffffff) % tab.length;
}
// Create a new entry.
tab[index] = new Entry<T>(obj, this.queue, hash, tab[index]);
this.count++;
return obj;
}
public Iterator<T> iterator() {
return new SetIterator();
}
public int size() {
return this.count;
}
public synchronized boolean contains(Object obj) {
if (obj == null) {
return false;
}
Entry<T>[] tab = this.table;
int hash = hashCode(obj);
int index = (hash & 0x7fffffff) % tab.length;
for (Entry<T> e = tab[index], prev = null; e != null; e = e.next) {
Object iobj = e.get();
if (iobj == null) {
// Clean up after a cleared Reference.
if (prev != null) {
prev.next = e.next;
} else {
tab[index] = e.next;
}
this.count--;
} else if (e.hash == hash &&
obj.getClass() == iobj.getClass() &&
equals(obj, iobj)) {
// Found canonical instance.
return true;
} else {
prev = e;
}
}
return false;
}

protected int hashCode(Object obj) {
return obj.hashCode();
}
protected boolean equals(Object a, Object b) {
return a.equals(b);
}
private void rehash() {
int oldCapacity = this.table.length;
Entry<T>[] tab = this.table;
int newCapacity = oldCapacity * 2 + 1;
Entry<T>[] newTab = new Entry[newCapacity];
this.threshold = (int)(newCapacity * this.loadFactor);
this.table = newTab;
for (int i = oldCapacity; i-- > 0; ) {
for (Entry<T> old = tab[i]; old != null; ) {
Entry<T> e = old;
old = old.next;
// Only copy entry if it hasn"t been cleared.
if (e.get() == null) {
this.count--;
} else {
int index = (e.hash & 0x7fffffff) % newCapacity;
e.next = newTab[index];
newTab[index] = e;
}
}
}
}
private static class Entry<T> extends WeakReference<T> {
int hash;
Entry<T> next;
Entry(T canonical, ReferenceQueue<T> queue, int hash, Entry<T> next) {
super(canonical, queue);
this.hash = hash;
this.next = next;
}
}
private class SetIterator implements Iterator<T> {
private final Entry<T>[] table;
private int index;
// To ensure that the iterator doesn"t return cleared entries, keep a
// hard reference to the canonical object. Its existence will prevent
// the weak reference from being cleared.
private T entryCanonical;
private Entry<T> entry;
SetIterator() {
this.table = WeakCanonicalSet.this.table;
this.index = table.length;
}
public boolean hasNext() {
while (this.entry == null || (this.entryCanonical = this.entry.get()) == null) {
if (this.entry != null) {
// Skip past a cleared Reference.
this.entry = this.entry.next;
} else {
if (this.index <= 0) {
return false;
} else {
this.entry = this.table[--this.index];
}
}
}
return true;
}
public T next() {
if (!hasNext()) {
throw new NoSuchElementException();
}
this.entry = this.entry.next;
return this.entryCanonical;
}
public void remove() {
throw new UnsupportedOperationException();
}
}
}

</source>



== Converts a char array to a Set ==



<source lang="java">

/*
* The contents of this file are subject to the Sapient Public License
* Version 1.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://carbon.sf.net/License.html.
*
* Software distributed under the License is distributed on an "AS IS" basis,
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for
* the specific language governing rights and limitations under the License.
*
* The Original Code is The Carbon Component Framework.
*
* The Initial Developer of the Original Code is Sapient Corporation
*
* Copyright (C) 2003 Sapient Corporation. All Rights Reserved.
*/

import java.util.ArrayList;
import java.util.HashSet;
import java.util.List;
import java.util.Set;
import java.util.StringTokenizer;
/**
* <p>Utilities for strings.</p>
*
*
* Copyright 2002 Sapient
* @since carbon 1.0
* @author Greg Hinkle, May 2002
* @version $Revision: 1.5 $($Author: dvoet $ / $Date: 2003/05/05 21:21:24 $)
*/
public class StringUtil {
/**
* <p> Converts a string to a Set. Breaks the string to characters and store
* each character in a Set.
*
* @param string the string to convert
* @return a <code>Set</code> containing all characters in the text string parameter
*/
public static Set convertToSet(String string) {
// Result hashset
Set resultSet = new HashSet();
for (int i = 0; i < string.length(); i++) {
resultSet.add(new Character(string.charAt(i)));
}
// Return result
return resultSet;
}
/**
* <p> Converts a char array to a Set. Puts all characters in the array to a Set.
*
* @param charArray an array of <CODE>char</CODE>s
* @return a <code>set</code> containing all characters in the char array
*/
public static Set convertToSet(char[] charArray) {
// Result hashset
Set resultSet = new HashSet();
for (int i = 0; i < charArray.length; i++) {
resultSet.add(new Character(charArray[i]));
}
// Return result
return resultSet;
}
}

</source>



== Converts a string to a Set ==



<source lang="java">

/*
* The contents of this file are subject to the Sapient Public License
* Version 1.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://carbon.sf.net/License.html.
*
* Software distributed under the License is distributed on an "AS IS" basis,
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for
* the specific language governing rights and limitations under the License.
*
* The Original Code is The Carbon Component Framework.
*
* The Initial Developer of the Original Code is Sapient Corporation
*
* Copyright (C) 2003 Sapient Corporation. All Rights Reserved.
*/

import java.util.ArrayList;
import java.util.HashSet;
import java.util.List;
import java.util.Set;
import java.util.StringTokenizer;
/**
* <p>Utilities for strings.</p>
*
*
* Copyright 2002 Sapient
* @since carbon 1.0
* @author Greg Hinkle, May 2002
* @version $Revision: 1.5 $($Author: dvoet $ / $Date: 2003/05/05 21:21:24 $)
*/
public class StringUtil {
/**
* <p> Converts a string to a Set. Breaks the string to characters and store
* each character in a Set.
*
* @param string the string to convert
* @return a <code>Set</code> containing all characters in the text string parameter
*/
public static Set convertToSet(String string) {
// Result hashset
Set resultSet = new HashSet();
for (int i = 0; i < string.length(); i++) {
resultSet.add(new Character(string.charAt(i)));
}
// Return result
return resultSet;
}
/**
* <p> Converts a char array to a Set. Puts all characters in the array to a Set.
*
* @param charArray an array of <CODE>char</CODE>s
* @return a <code>set</code> containing all characters in the char array
*/
public static Set convertToSet(char[] charArray) {
// Result hashset
Set resultSet = new HashSet();
for (int i = 0; i < charArray.length; i++) {
resultSet.add(new Character(charArray[i]));
}
// Return result
return resultSet;
}
}

</source>



== Copy all the elements from set2 to set1 (set1 += set2), set1 becomes the union of set1 and set2 ==



<source lang="java">

import java.util.HashSet;
import java.util.Set;
public class Main {
public static void main(String[] argv) throws Exception {
Set set1 = new HashSet();
Set set2 = new HashSet();
set1.addAll(set2);
}
}

</source>



== Demonstrate the Set interface ==



<source lang="java">

/*
* Copyright (c) Ian F. Darwin, http://www.darwinsys.ru/, 1996-2002.
* All rights reserved. Software written by Ian F. Darwin and others.
* $Id: LICENSE,v 1.8 2004/02/09 03:33:38 ian Exp $
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS""
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*
* Java, the Duke mascot, and all variants of Sun"s Java "steaming coffee
* cup" logo are trademarks of Sun Microsystems. Sun"s, and James Gosling"s,
* pioneering role in inventing and promulgating (and standardizing) the Java
* language and environment is gratefully acknowledged.
*
* The pioneering role of Dennis Ritchie and Bjarne Stroustrup, of AT&T, for
* inventing predecessor languages C and C++ is also gratefully acknowledged.
*/
import java.util.*;
/**
* Demonstrate the Set interface
* @author Ian F. Darwin, http://www.darwinsys.ru/
* @version $Id: SetDemo.java,v 1.4 2004/02/09 03:34:04 ian Exp $
*/
public class SetDemo {
public static void main(String[] argv) {
//+
Set h = new HashSet();
h.add("One");
h.add("Two");
h.add("One"); // DUPLICATE
h.add("Three");
Iterator it = h.iterator();
while (it.hasNext()) {
System.out.println(it.next());
}
//-
}
}

</source>



== Extend AbstractSet to Create Simple Set ==



<source lang="java">

/* SimpleSet Copyright (C) 1998-2002 Jochen Hoenicke.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation; either version 2, or (at your option)
* any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program; see the file COPYING.LESSER. If not, write to
* the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
*
* $Id: SimpleSet.java.in,v 1.1.2.1 2002/05/28 17:34:24 hoenicke Exp $
*/
import java.util.AbstractSet;
import java.util.Iterator;
public class SimpleSet extends AbstractSet implements Cloneable
{
Object[] elementObjects;
int count = 0;
public SimpleSet() {
this(2);
}
public SimpleSet(int initialSize) {
elementObjects = new Object[initialSize];
}
public int size() {
return count;
}
public boolean add(Object element) {
if (element == null)
throw new NullPointerException();
for (int i=0; i< count; i++) {
if (element.equals(elementObjects[i]))
return false;
}

if (count == elementObjects.length) {
Object[] newArray = new Object[(count+1)*3/2];
System.arraycopy(elementObjects,0,newArray,0,count);
elementObjects = newArray;
}
elementObjects[count++] = element;
return true;
}

public Object clone() {
try {
SimpleSet other = (SimpleSet) super.clone();
other.elementObjects = (Object[]) elementObjects.clone();
return other;
} catch (CloneNotSupportedException ex) {

}
}
public Iterator iterator() {
return new Iterator() {
int pos = 0;
public boolean hasNext() {
return pos < count;
}

public Object next() {
return elementObjects[pos++];
}

public void remove() {
if (pos < count)
System.arraycopy(elementObjects, pos,
elementObjects, pos-1, count - pos);
count--;
pos--;
}
};
}
}

</source>



== Get the intersection of set1 and set2, set1 becomes the intersection of set1 and set2 ==



<source lang="java">

import java.util.HashSet;
import java.util.Set;
public class Main {
public static void main(String[] argv) throws Exception {
Set set1 = new HashSet();
Set set2 = new HashSet();
set1.retainAll(set2);
// Remove all elements from a set
set1.clear();
}
}

</source>



== Implements the Set interface, backed by a ConcurrentHashMap instance ==



<source lang="java">

/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You 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.
*/
import java.io.IOException;
import java.io.ObjectInputStream;
import java.util.AbstractSet;
import java.util.Collection;
import java.util.Iterator;
import java.util.Set;
import java.util.concurrent.ConcurrentHashMap;
/**
* This class implements the <tt>Set</tt> interface, backed by a ConcurrentHashMap instance.
*
* @author Matt Tucker
* @param <E>
*/
public class ConcurrentHashSet<E> extends AbstractSet<E>
implements
Set<E>,
Cloneable,
java.io.Serializable
{
/** */
private static final long serialVersionUID = 1L;
private transient ConcurrentHashMap<E, Object> map;
// Dummy value to associate with an Object in the backing Map
private static final Object PRESENT = new Object();
/**
* Constructs a new, empty set; the backing <tt>ConcurrentHashMap</tt> instance has default
* initial capacity (16) and load factor (0.75).
*/
public ConcurrentHashSet()
{
map = new ConcurrentHashMap<E, Object>();
}
/**
* Constructs a new set containing the elements in the specified collection. The
* <tt>ConcurrentHashMap</tt> is created with default load factor (0.75) and an initial capacity
* sufficient to contain the elements in the specified collection.
*
* @param c
* the collection whose elements are to be placed into this set.
* @throws NullPointerException
* if the specified collection is null.
*/
public ConcurrentHashSet(Collection<? extends E> c)
{
map = new ConcurrentHashMap<E, Object>(Math.max((int)(c.size() / .75f) + 1, 16));
addAll(c);
}
/**
* Constructs a new, empty set; the backing <tt>ConcurrentHashMap</tt> instance has the
* specified initial capacity and the specified load factor.
*
* @param initialCapacity
* the initial capacity of the hash map.
* @param loadFactor
* the load factor of the hash map.
* @throws IllegalArgumentException
* if the initial capacity is less than zero, or if the load factor is nonpositive.
*/
public ConcurrentHashSet(int initialCapacity, float loadFactor)
{
map = new ConcurrentHashMap<E, Object>(initialCapacity, loadFactor, 16);
}
/**
* Constructs a new, empty set; the backing <tt>HashMap</tt> instance has the specified initial
* capacity and default load factor, which is <tt>0.75</tt>.
*
* @param initialCapacity
* the initial capacity of the hash table.
* @throws IllegalArgumentException
* if the initial capacity is less than zero.
*/
public ConcurrentHashSet(int initialCapacity)
{
map = new ConcurrentHashMap<E, Object>(initialCapacity);
}
/**
*
* @see java.util.AbstractCollection#iterator()
*/
@Override
public Iterator<E> iterator()
{
return map.keySet().iterator();
}
/**
*
* @see java.util.AbstractCollection#size()
*/
@Override
public int size()
{
return map.size();
}
/**
*
* @see java.util.AbstractCollection#isEmpty()
*/
@Override
public boolean isEmpty()
{
return map.isEmpty();
}
/**
*
* @see java.util.AbstractCollection#contains(java.lang.Object)
*/
@Override
public boolean contains(Object o)
{
return map.containsKey(o);
}
/**
*
* @see java.util.AbstractCollection#add(java.lang.Object)
*/
@Override
public boolean add(E o)
{
return map.put(o, PRESENT) == null;
}
/**
*
* @see java.util.AbstractCollection#remove(java.lang.Object)
*/
@Override
public boolean remove(Object o)
{
return map.remove(o) == PRESENT;
}
/**
*
* @see java.util.AbstractCollection#clear()
*/
@Override
public void clear()
{
map.clear();
}
/**
*
* @see java.lang.Object#clone()
*/
@SuppressWarnings("unchecked")
@Override
public Object clone()
{
try
{
ConcurrentHashSet<E> newSet = (ConcurrentHashSet<E>)super.clone();
newSet.map.putAll(map);
return newSet;
}
catch (CloneNotSupportedException e)
{
throw new InternalError();
}
}
/**
*
* @param s
* @throws java.io.IOException
*/
private void writeObject(java.io.ObjectOutputStream s) throws java.io.IOException
{
s.defaultWriteObject();
s.writeInt(map.size());
for (Iterator<E> i = map.keySet().iterator(); i.hasNext();)
{
s.writeObject(i.next());
}
}
/**
* Re-constitute the <tt>HashSet</tt> instance from a stream.
*
* @param inputStream
* @throws ClassNotFoundException
* @throws IOException
*/
private void readObject(ObjectInputStream inputStream) throws ClassNotFoundException,
IOException
{
inputStream.defaultReadObject();
map = new ConcurrentHashMap<E, Object>();
int size = inputStream.readInt();
for (int i = 0; i < size; i++)
{
E e = (E)inputStream.readObject();
map.put(e, PRESENT);
}
}
}

</source>



== Int Set ==



<source lang="java">

/* Copyright (C) 2003 Vladimir Roubtsov. All rights reserved.
*
* This program and the accompanying materials are made available under
* the terms of the Common Public License v1.0 which accompanies this distribution,
* and is available at http://www.eclipse.org/legal/cpl-v10.html
*
* $Id: IntSet.java,v 1.1.1.1 2004/05/09 16:57:53 vlad_r Exp $
*/
// ----------------------------------------------------------------------------
/**
*
* MT-safety: an instance of this class is <I>not</I> safe for access from
* multiple concurrent threads [even if access is done by a single thread at a
* time]. The caller is expected to synchronize externally on an instance [the
* implementation does not do internal synchronization for the sake of efficiency].
* java.util.ConcurrentModificationException is not supported either.
*
* @author Vlad Roubtsov, (C) 2001
*/
public
final class IntSet
{
// public: ................................................................
/**
* Equivalent to <CODE>IntSet(11, 0.75F)</CODE>.
*/
public IntSet ()
{
this (11, 0.75F);
}

/**
* Equivalent to <CODE>IntSet(capacity, 0.75F)</CODE>.
*/
public IntSet (final int initialCapacity)
{
this (initialCapacity, 0.75F);
}

/**
* Constructs an IntSet with specified initial capacity and load factor.
*
* @param initialCapacity initial number of hash buckets in the table [may not be negative, 0 is equivalent to 1].
* @param loadFactor the load factor to use to determine rehashing points [must be in (0.0, 1.0] range].
*/
public IntSet (int initialCapacity, final float loadFactor)
{
if (initialCapacity < 0) throw new IllegalArgumentException ("negative input: initialCapacity [" + initialCapacity + "]");
if ((loadFactor <= 0.0) || (loadFactor >= 1.0 + 1.0E-6))
throw new IllegalArgumentException ("loadFactor not in (0.0, 1.0] range: " + loadFactor);

if (initialCapacity == 0) initialCapacity = 1;

m_loadFactor = loadFactor > 1.0 ? 1.0F : loadFactor;
m_sizeThreshold = (int) (initialCapacity * loadFactor);
m_buckets = new Entry [initialCapacity];
}

/**
* Overrides Object.toString() for debug purposes.
*/
public String toString ()
{
final StringBuffer s = new StringBuffer ();
debugDump (s);

return s.toString ();
}

/**
* Returns the number of key-value mappings in this map.
*/
public int size ()
{
return m_size;
}

public boolean contains (final int key)
{
// index into the corresponding hash bucket:
final Entry [] buckets = m_buckets;
final int bucketIndex = (key & 0x7FFFFFFF) % buckets.length;

// traverse the singly-linked list of entries in the bucket:
for (Entry entry = buckets [bucketIndex]; entry != null; entry = entry.m_next)
{
if (key == entry.m_key)
return true;
}

return false;
}

public int [] values ()
{
if (m_size == 0)
return new int[0];
else
{
final int [] result = new int [m_size];
int scan = 0;

for (int b = 0; b < m_buckets.length; ++ b)
{
for (Entry entry = m_buckets [b]; entry != null; entry = entry.m_next)
{
result [scan ++] = entry.m_key;
}
}

return result;
}
}

public void values (final int [] target, final int offset)
{
if (m_size != 0)
{
int scan = offset;

for (int b = 0; b < m_buckets.length; ++ b)
{
for (Entry entry = m_buckets [b]; entry != null; entry = entry.m_next)
{
target [scan ++] = entry.m_key;
}
}
}
}

public boolean add (final int key)
{
Entry currentKeyEntry = null;

// detect if "key" is already in the table [in which case, set "currentKeyEntry" to point to its entry]:

// index into the corresponding hash bucket:
int bucketIndex = (key & 0x7FFFFFFF) % m_buckets.length;

// traverse the singly-linked list of entries in the bucket:
Entry [] buckets = m_buckets;
for (Entry entry = buckets [bucketIndex]; entry != null; entry = entry.m_next)
{
if (key == entry.m_key)
{
currentKeyEntry = entry;
break;
}
}

if (currentKeyEntry == null)
{
// add a new entry:

if (m_size >= m_sizeThreshold) rehash ();

buckets = m_buckets;
bucketIndex = (key & 0x7FFFFFFF) % buckets.length;
final Entry bucketListHead = buckets [bucketIndex];
final Entry newEntry = new Entry (key, bucketListHead);
buckets [bucketIndex] = newEntry;

++ m_size;

return true;
}
else
return false;
}

// protected: .............................................................
// package: ...............................................................

void debugDump (final StringBuffer out)
{
if (out != null)
{
out.append (super.toString ()); out.append (EOL);
out.append ("size = " + m_size + ", bucket table size = " + m_buckets.length + ", load factor = " + m_loadFactor + EOL);
out.append ("size threshold = " + m_sizeThreshold + EOL);
}
}
// private: ...............................................................

/**
* The structure used for chaining colliding keys.
*/
private static final class Entry
{
Entry (final int key, final Entry next)
{
m_key = key;
m_next = next;
}

final int m_key;

Entry m_next; // singly-linked list link

} // end of nested class

/**
* Re-hashes the table into a new array of buckets.
*/
private void rehash ()
{
// TODO: it is possible to run this method twice, first time using the 2*k+1 prime sequencer for newBucketCount
// and then with that value reduced to actually shrink capacity. As it is right now, the bucket table can
// only grow in size

final Entry [] buckets = m_buckets;

final int newBucketCount = (m_buckets.length << 1) + 1;
final Entry [] newBuckets = new Entry [newBucketCount];
// rehash all entry chains in every bucket:
for (int b = 0; b < buckets.length; ++ b)
{
for (Entry entry = buckets [b]; entry != null; )
{
final Entry next = entry.m_next; // remember next pointer because we are going to reuse this entry
final int entryKey = entry.m_key;

// index into the corresponding new hash bucket:
final int newBucketIndex = (entryKey & 0x7FFFFFFF) % newBucketCount;

final Entry bucketListHead = newBuckets [newBucketIndex];
entry.m_next = bucketListHead;
newBuckets [newBucketIndex] = entry;

entry = next;
}
}

m_sizeThreshold = (int) (newBucketCount * m_loadFactor);
m_buckets = newBuckets;
}

private final float m_loadFactor; // determines the setting of m_sizeThreshold

private Entry [] m_buckets; // table of buckets
private int m_size; // number of keys in the table, not cleared as of last check
private int m_sizeThreshold; // size threshold for rehashing

private static final String EOL = System.getProperty ("line.separator", "\n");

} // end of class
// ----------------------------------------------------------------------------

</source>



== List Set implements Set ==



<source lang="java">

import java.io.Serializable;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Iterator;
import java.util.List;
import java.util.Set;
/*
*
* JAFFA - Java Application Framework For All
*
* Copyright (C) 2002 JAFFA Development Group
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*
* Redistribution and use of this software and associated documentation ("Software"),
* with or without modification, are permitted provided that the following conditions are met:
* 1. Redistributions of source code must retain copyright statements and notices.
* Redistributions must also contain a copy of this document.
* 2. Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
* 3. The name "JAFFA" must not be used to endorse or promote products derived from
* this Software without prior written permission. For written permission,
* please contact mail to: jaffagroup@yahoo.ru.
* 4. Products derived from this Software may not be called "JAFFA" nor may "JAFFA"
* appear in their names without prior written permission.
* 5. Due credit should be given to the JAFFA Project (http://jaffa.sourceforge.net).
*
* THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
*
*/

/**
* This class is backed by an ArrayList. Features are
* 1) Ensure the Set functionality of unique elements(including a null) in this data structure
* 2) Iterate through the list in the order in which the entries were made
*/
class ListSet implements Set, Cloneable, Serializable {
List m_set = null;

/** Creates new ListSet */
public ListSet() {
m_set = new ArrayList();
}
/** Creates new ListSet specifying the initial capacity.
* @param initialCapacity The initial capacity.
*/
public ListSet(int initialCapacity) {
m_set = new ArrayList(initialCapacity);
}
/** Creates new ListSet from an existing Collection.
* @param c An existing collection.
*/
public ListSet(Collection c) {
m_set = new ArrayList();
if (c != null) {
for (Iterator itr = c.iterator(); itr.hasNext();) {
Object obj = itr.next();
if ( !m_set.contains(obj) )
m_set.add(obj);
}
}
}

// *** Set Interface methods ***
/** Retains only the elements in this set that are contained in the specified collection.
* @param c collection that defines which elements this set will retain.
* @return true if this collection changed as a result of the call.
*/
public boolean retainAll(Collection c) {
return m_set.retainAll(c);
}
/** Returns true if this set contains the specified element.
* @param o element whose presence in this set is to be tested.
* @return true if this set contains the specified element.
*/
public boolean contains(Object o) {
return m_set.contains(o);
}
/** Returns an array containing all of the elements in this set.
* @return an array containing all of the elements in this set.
*/
public Object[] toArray() {
return m_set.toArray();
}
/** Returns an array containing all of the elements in this set; the runtime type of the returned array is that of the specified array.
* @param a the array into which the elements of this set are to be stored, if it is big enough; otherwise, a new array of the same runtime type is allocated for this purpose.
* @return an array containing all of the elements in this set; the runtime type of the returned array is that of the specified array
*/
public Object[] toArray(Object[] a) {
return m_set.toArray(a);
}
/** Returns an iterator over the elements in this set.
* @return an iterator over the elements in this set.
*/
public Iterator iterator() {
return m_set.iterator();
}
/** Removes from this set all of its elements that are contained in the specified collection.
* @param c collection that defines which elements will be removed from this set.
* @return true if this set changed as a result of the call.
*/
public boolean removeAll(Collection c) {
return m_set.removeAll(c);
}
/** Removes the specified element from this set if it is present.
* @param o object to be removed from this set, if present.
* @return true if the set contained the specified element.
*/
public boolean remove(Object o) {
return m_set.remove(o);
}
/** Removes all of the elements from this set.*/
public void clear() {
m_set.clear();
}
/** Returns the hash code value for this set.
* @return the hash code value for this set.
*/
public int hashCode() {
return m_set.hashCode();
}
/** Adds all of the elements in the specified collection to this set if they"re not already present.
* @param c collection whose elements are to be added to this set.
* @return true if this set changed as a result of the call.
*/
public boolean addAll(Collection c) {
boolean added = false;
if (c != null) {
for (Iterator itr = c.iterator(); itr.hasNext();) {
Object obj = itr.next();
if ( !m_set.contains(obj) ) {
m_set.add(obj);
added = true;
}
}
}
return added;
}
/** Returns the number of elements in this set.
* @return the number of elements in this set.
*/
public int size() {
return m_set.size();
}
/** Returns true if this set contains all of the elements of the specified collection.
* @param c collection to be checked for containment in this set.
* @return true if this set contains all of the elements of the specified collection.
*/
public boolean containsAll(Collection c) {
return m_set.containsAll(c);
}
/** Adds the specified element to this set if it is not already present.
* @param o element to be added to this set.
* @return true if this set did not already contain the specified element.
*/
public boolean add(Object o) {
boolean added = false;
if ( !m_set.contains(o) ) {
m_set.add(o);
added = true;
}
return added;
}
/** Compares the specified object with this set for equality.
* @param o Object to be compared for equality with this set.
* @return true if the specified Object is equal to this set.
*/
public boolean equals(Object o) {
return m_set.equals(o);
}
/** Returns true if this set contains no elements.
* @return true if this set contains no elements.
*/
public boolean isEmpty() {
return m_set.isEmpty();
}

// *** Additional Methods ***
/** Adds the specified element to this set if it is not already present, at the specified index.
* @param index The position at which the element is to be added.
* @param o element to be added to this set.
*/
public void add(int index, Object o) {
if ( !m_set.contains(o) )
m_set.add(index, o);
}
/** Returns the element from the specified position.
* @param index The position from which the element is to be retrieved.
* @return the element from the specified position.
*/
public Object get(int index) {
return m_set.get(index);
}
/** Remove the element from the specified position.
* @param index The position from which the element is to be removed.
* @return the element being removed.
*/
public Object remove(int index) {
return m_set.remove(index);
}
/** Returns the index of the element in this set.
* @param o The element whose index is to be found.
* @return the index of the element in this set.
*/
public int indexOf(Object o) {
return m_set.indexOf(o);
}

// *** CLONEABLE INTERFACE METHODS ***
/** Returns a clone of the Set.
* @throws CloneNotSupportedException if cloning is not supported. Should never happen.
* @return a clone of the Set.
*/
public Object clone() throws CloneNotSupportedException {
Object obj = super.clone();
if (m_set != null && m_set instanceof Cloneable)
( (ListSet) obj ).m_set = (List) ( (ArrayList) m_set ).clone();
return obj;
}
}

</source>



== One Item Set ==



<source lang="java">

/* $Id$
*
* Behavior Protocols Tools - Parsers, Transformations
* Copyright (C) 2006-2007 DSRG, Charles University in Prague
* http://dsrg.mff.cuni.cz/
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
* MA 02110-1301 USA
*
*/

import java.io.Serializable;
import java.util.AbstractCollection;
import java.util.Iterator;
import java.util.NoSuchElementException;

/**
*
* @author thorm
*/
public class OneItemSet<E> extends AbstractCollection<E> implements Serializable{

public boolean add(E i) {
if (item == i) {
return false;
}
if (item == null) {
item = i;
return true;
}
throw new IllegalArgumentException();
}

public Iterator<E> iterator() {
return new Iterator() {
public boolean hasNext() {
return hasNxt;
}

public E next() {
if (hasNxt) {
hasNxt = false;
return item;
}
throw new NoSuchElementException();
}

public void remove() {
item = null;
}
boolean hasNxt = true;
};
}

public int size() {
return (item == null) ? 0 : 1;
}
public int hashCode() {
return item.hashCode();
}
public boolean equals(Object o) {
return (o instanceof OneItemSet) && item.equals(((OneItemSet) o).item);
}

E item;
}

</source>



== Putting your own type in a Set ==



<source lang="java">

// : c11:Set2.java
// Putting your own type in a Set.
// From "Thinking in Java, 3rd ed." (c) Bruce Eckel 2002
// www.BruceEckel.ru. See copyright notice in CopyRight.txt.
import java.util.HashSet;
import java.util.LinkedHashSet;
import java.util.Set;
import java.util.TreeSet;
public class Set2 {
public static Set fill(Set a, int size) {
for (int i = 0; i < size; i++)
a.add(new Integer(i));
return a;
}
public static void test(Set a) {
fill(a, 10);
fill(a, 10); // Try to add duplicates
fill(a, 10);
a.addAll(fill(new TreeSet(), 10));
System.out.println(a);
}
public static void main(String[] args) {
test(new HashSet());
test(new TreeSet());
test(new LinkedHashSet());
}
} ///:~

</source>



== Remove all elements from a set ==



<source lang="java">

import java.util.HashSet;
import java.util.Set;
public class Main {
public static void main(String[] argv) throws Exception {
Set set1 = new HashSet();

set1.clear();
}
}

</source>



== Remove all the elements in set1 from set2 (set1 -= set2), set1 becomes the asymmetric difference of set1 and set2 ==



<source lang="java">

import java.util.HashSet;
import java.util.Set;
public class Main {
public static void main(String[] argv) throws Exception {
Set set1 = new HashSet();
Set set2 = new HashSet();
set1.removeAll(set2);
}
}

</source>



== Set and TreeSet ==



<source lang="java">

import java.util.*;
public class Comp {
public static void main (String args[]) throws Exception {
String elements[] = {"Irish Setter", "Poodle",
"English Setter", "Gordon Setter", "Pug"};
Set set = new TreeSet(Collections.reverseOrder());
for (int i=0, n=elements.length; i<n; i++) {
set.add(elements[i]);
}
System.out.println(set);
System.out.println(((TreeSet)set).ruparator());
}
}

</source>



== Set Copy ==



<source lang="java">

import java.io.*;
import java.util.*;
public class Copy {
public static void main (String args[]) throws Exception {
String elements[] = {"Irish Setter", "Poodle",
"English Setter", "Gordon Setter", "Pug"};
Set set = new HashSet(Arrays.asList(elements));
Set set2 = ((Set)((HashSet)set).clone());
System.out.println(set2);
FileOutputStream fos = new FileOutputStream("set.ser");
ObjectOutputStream oos = new ObjectOutputStream(fos);
oos.writeObject(set);
oos.close();
FileInputStream fis = new FileInputStream("set.ser");
ObjectInputStream ois = new ObjectInputStream(fis);
Set set3 = (Set)ois.readObject();
ois.close();
System.out.println(set3);
}
}

</source>



== Set, HashSet and TreeSet ==



<source lang="java">

import java.util.HashSet;
import java.util.Set;
import java.util.TreeSet;
public class Main {
public static void main(String args[]) {
Set<String> hs = new HashSet<String>();
hs.add("one");
hs.add("two");
hs.add("three");
System.out.println("Here is the HashSet: " + hs);
if (!hs.add("three"))
System.out.println("Attempt to add duplicate. " + "Set is unchanged: " + hs);
TreeSet<Integer> ts = new TreeSet<Integer>();
ts.add(8);
ts.add(19);
ts.add(-2);
ts.add(3);
System.out.println(ts);
System.out.println("First element in ts: " + ts.first());
System.out.println("Last element in ts: " + ts.last());
System.out.println("First element > 15: " + ts.higher(15));
System.out.println("First element < 15: " + ts.lower(15));
}
}

</source>



== Set implementation that use == instead of equals() ==



<source lang="java">

/*
* Hibernate, Relational Persistence for Idiomatic Java
*
* Copyright (c) 2008, Red Hat Middleware LLC or third-party contributors as
* indicated by the @author tags or express copyright attribution
* statements applied by the authors. All third-party contributions are
* distributed under license by Red Hat Middleware LLC.
*
* This copyrighted material is made available to anyone wishing to use, modify,
* copy, or redistribute it subject to the terms and conditions of the GNU
* Lesser General Public License, as published by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
* for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this distribution; if not, write to:
* Free Software Foundation, Inc.
* 51 Franklin Street, Fifth Floor
* Boston, MA 02110-1301 USA
*
*/
import java.util.Collection;
import java.util.IdentityHashMap;
import java.util.Iterator;
import java.util.Set;
/**
* Set implementation that use == instead of equals() as its comparison
* mechanism. This is achieved by internally using an IdentityHashMap.
*
* @author Emmanuel Bernard
*/
public class IdentitySet implements Set {
private static final Object DUMP_VALUE = new Object();
private final IdentityHashMap map;
/**
* Create an IdentitySet with default sizing.
*/
public IdentitySet() {
this.map = new IdentityHashMap();
}
/**
* Create an IdentitySet with the given sizing.
*
* @param sizing The sizing of the set to create.
*/
public IdentitySet(int sizing) {
this.map = new IdentityHashMap( sizing );
}
public int size() {
return map.size();
}
public boolean isEmpty() {
return map.isEmpty();
}
public boolean contains(Object o) {
return map.get( o ) == DUMP_VALUE;
}
public Iterator iterator() {
return map.entrySet().iterator();
}
public Object[] toArray() {
return map.entrySet().toArray();
}
public Object[] toArray(Object[] a) {
return map.entrySet().toArray( a );
}
public boolean add(Object o) {
return map.put( o, DUMP_VALUE ) == null;
}
public boolean remove(Object o) {
return map.remove( o ) == DUMP_VALUE;
}
public boolean containsAll(Collection c) {
Iterator it = c.iterator();
while ( it.hasNext() ) {
if ( !map.containsKey( it.next() ) ) {
return false;
}
}
return true;
}
public boolean addAll(Collection c) {
Iterator it = c.iterator();
boolean changed = false;
while ( it.hasNext() ) {
if ( this.add( it.next() ) ) {
changed = true;
}
}
return changed;
}
public boolean retainAll(Collection c) {
//doable if needed
throw new UnsupportedOperationException();
}
public boolean removeAll(Collection c) {
Iterator it = c.iterator();
boolean changed = false;
while ( it.hasNext() ) {
if ( this.remove( it.next() ) ) {
changed = true;
}
}
return changed;
}
public void clear() {
map.clear();
}
}

</source>



== Set operations: union, intersection, difference, symmetric difference, is subset, is superset ==



<source lang="java">

import java.util.Set;
import java.util.TreeSet;
public class Main {
public static <T> Set<T> union(Set<T> setA, Set<T> setB) {
Set<T> tmp = new TreeSet<T>(setA);
tmp.addAll(setB);
return tmp;
}
public static <T> Set<T> intersection(Set<T> setA, Set<T> setB) {
Set<T> tmp = new TreeSet<T>();
for (T x : setA)
if (setB.contains(x))
tmp.add(x);
return tmp;
}
public static <T> Set<T> difference(Set<T> setA, Set<T> setB) {
Set<T> tmp = new TreeSet<T>(setA);
tmp.removeAll(setB);
return tmp;
}
public static <T> Set<T> symDifference(Set<T> setA, Set<T> setB) {
Set<T> tmpA;
Set<T> tmpB;
tmpA = union(setA, setB);
tmpB = intersection(setA, setB);
return difference(tmpA, tmpB);
}
public static <T> boolean isSubset(Set<T> setA, Set<T> setB) {
return setB.containsAll(setA);
}
public static <T> boolean isSuperset(Set<T> setA, Set<T> setB) {
return setA.containsAll(setB);
}
public static void main(String args[]) {
TreeSet<Character> set1 = new TreeSet<Character>();
TreeSet<Character> set2 = new TreeSet<Character>();
set1.add("A");
set1.add("B");
set1.add("C");
set1.add("D");
set2.add("C");
set2.add("D");
set2.add("E");
set2.add("F");
System.out.println("set1: " + set1);
System.out.println("set2: " + set2);
System.out.println("Union: " + union(set1, set2));
System.out.println("Intersection: " + intersection(set1, set2));
System.out.println("Difference (set1 - set2): " + difference(set1, set2));
System.out.println("Symmetric Difference: " + symDifference(set1, set2));
TreeSet<Character> set3 = new TreeSet<Character>(set1);
set3.remove("D");
System.out.println("set3: " + set3);
System.out.println("Is set1 a subset of set2? " + isSubset(set1, set3));
System.out.println("Is set1 a superset of set2? " + isSuperset(set1, set3));
System.out.println("Is set3 a subset of set1? " + isSubset(set3, set1));
System.out.println("Is set3 a superset of set1? " + isSuperset(set3, set1));
}
}

</source>



== Set subtraction ==



<source lang="java">

import java.util.HashSet;
import java.util.Set;
public class FindDupsAndUnique {
public static void main(String args[]) {
Set uniques = new HashSet();
Set dups = new HashSet();
String[] values = new String[] { "java", "java2", "jexp", "javas",
"java" };
for (int i = 0; i < values.length; i++)
if (!uniques.add(values[i]))
dups.add(values[i]);
uniques.removeAll(dups); // Destructive set-difference
System.out.println("Unique words: " + uniques);
System.out.println("Duplicate words: " + dups);
}
}

</source>



== Set that compares object by identity rather than equality ==



<source lang="java">

// $Id: IdentitySet.java 16179 2009-03-18 11:08:10Z hardy.ferentschik $
/*
* JBoss, Home of Professional Open Source
* Copyright 2008, Red Hat Middleware LLC, and individual contributors
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* 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.
*/
import java.util.Collection;
import java.util.IdentityHashMap;
import java.util.Iterator;
import java.util.Map;
import java.util.Set;
/**
* Set that compares object by identity rather than equality. Wraps around a <code>IdentityHashMap</code>
*
* @author Emmanuel Bernard
*/
public class IdentitySet implements Set {
private Map<Object, Object> map;
private Object CONTAINS = new Object();
public IdentitySet() {
this( 10 );
}
public IdentitySet(int size) {
this.map = new IdentityHashMap<Object, Object>( size );
}
public int size() {
return map.size();
}
public boolean isEmpty() {
return map.isEmpty();
}
public boolean contains(Object o) {
return map.containsKey( o );
}
public Iterator iterator() {
return map.keySet().iterator();
}
public Object[] toArray() {
return map.keySet().toArray();
}
public boolean add(Object o) {
return map.put( o, CONTAINS ) == null;
}
public boolean remove(Object o) {
return map.remove( o ) == CONTAINS;
}
public boolean addAll(Collection c) {
boolean doThing = false;
for ( Object o : c ) {
doThing = doThing || add( o );
}
return doThing;
}
public void clear() {
map.clear();
}
public boolean removeAll(Collection c) {
boolean remove = false;
for ( Object o : c ) {
remove = remove || remove( o );
}
return remove;
}
public boolean retainAll(Collection c) {
throw new UnsupportedOperationException();
}
public boolean containsAll(Collection c) {
for ( Object o : c ) {
if ( !contains( o ) ) {
return false;
}
}
return true;
}
public Object[] toArray(Object[] a) {
return map.keySet().toArray( a );
}
@Override
public String toString() {
return "IdentitySet{" +
"map=" + map +
"}";
}
}

</source>



== Set union and intersection ==



<source lang="java">

/* *****************************************************************************
* SetUils.java
* ****************************************************************************/
/* J_LZ_COPYRIGHT_BEGIN *******************************************************
* Copyright 2001-2004 Laszlo Systems, Inc. All Rights Reserved. *
* Use is subject to license terms. *
* J_LZ_COPYRIGHT_END *********************************************************/
import java.util.*;
/**
* A utility class containing set utility functions.
*
* @author Oliver Steele
*/
public abstract class SetUtils {
public static boolean containsAny(Set a, Set b) {
for (Iterator iter = b.iterator(); iter.hasNext(); ) {
if (a.contains(iter.next())) {
return true;
}
}
return false;
}
public static Set intersection(Set a, Set b) {
Set c = new HashSet();
for (Iterator iter = b.iterator(); iter.hasNext(); ) {
Object e = iter.next();
if (a.contains(e)) {
c.add(e);
}
}
return c;
}
}

</source>



== Set with values iterated in insertion order. ==



<source lang="java">

/*
Copyright (c) 2007, Dennis M. Sosnoski
All rights reserved.
Redistribution and use in source and binary forms, with or without modification,
are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
* Neither the name of JiBX nor the names of its contributors may be used
to endorse or promote products derived from this software without specific
prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/

import java.util.ArrayList;
import java.util.Collection;
import java.util.HashSet;
import java.util.Iterator;
import java.util.Set;
/**
* Set with values iterated in insertion order. This is similar to the Java 1.4
* java.util.LinkedHashSet class, but compatible with earlier JVM versions. This
* implementation is for insert-only sets.
*/
public class InsertionOrderedSet implements Set
{
private final Set m_baseMap;
private final ArrayList m_insertList;

public InsertionOrderedSet() {
m_baseMap = new HashSet();
m_insertList = new ArrayList();
}

/* (non-Javadoc)
* @see java.util.Map#clear()
*/
public void clear() {
m_baseMap.clear();
m_insertList.clear();
}
/* (non-Javadoc)
* @see java.util.Set#isEmpty()
*/
public boolean isEmpty() {
return m_baseMap.isEmpty();
}
/* (non-Javadoc)
* @see java.util.Set#size()
*/
public int size() {
return m_baseMap.size();
}

/* (non-Javadoc)
* @see java.util.Set#add(java.lang.Object)
*/
public boolean add(Object o) {
if (m_baseMap.contains(o)) {
return false;
} else {
m_baseMap.add(o);
m_insertList.add(o);
return true;
}
}
/* (non-Javadoc)
* @see java.util.Set#addAll(java.util.Collection)
*/
public boolean addAll(Collection c) {
boolean changed = false;
for (Iterator iter = c.iterator(); iter.hasNext();) {
Object item = (Object)iter.next();
if (add(item)) {
changed = true;
}
}
return changed;
}
/* (non-Javadoc)
* @see java.util.Set#contains(java.lang.Object)
*/
public boolean contains(Object o) {
return m_baseMap.contains(o);
}
/* (non-Javadoc)
* @see java.util.Set#containsAll(java.util.Collection)
*/
public boolean containsAll(Collection c) {
return m_baseMap.containsAll(c);
}
/* (non-Javadoc)
* @see java.util.Set#iterator()
*/
public Iterator iterator() {
return m_insertList.iterator();
}
/* (non-Javadoc)
* @see java.util.Set#remove(java.lang.Object)
*/
public boolean remove(Object o) {
throw new UnsupportedOperationException("add-only set");
}
/* (non-Javadoc)
* @see java.util.Set#removeAll(java.util.Collection)
*/
public boolean removeAll(Collection c) {
throw new UnsupportedOperationException("add-only set");
}
/* (non-Javadoc)
* @see java.util.Set#retainAll(java.util.Collection)
*/
public boolean retainAll(Collection c) {
throw new UnsupportedOperationException("add-only set");
}
/* (non-Javadoc)
* @see java.util.Set#toArray()
*/
public Object[] toArray() {
return m_insertList.toArray();
}
/* (non-Javadoc)
* @see java.util.Set#toArray(T[])
*/
public Object[] toArray(Object[] a) {
return m_insertList.toArray(a);
}

/**
* Convenience method to add every item in an array.
*
* @param objs
*/
public void addAll(Object[] objs) {
for (int i = 0; i < objs.length; i++) {
add(objs[i]);
}
}
/**
* Get list of values in order added. The returned list is live, and will
* grow as new items are added to the set.
*
* @return list
*/
public ArrayList asList() {
return m_insertList;
}
}

</source>



== Show the union and intersection of two sets ==



<source lang="java">

/*
* Copyright (c) Ian F. Darwin, http://www.darwinsys.ru/, 1996-2002.
* All rights reserved. Software written by Ian F. Darwin and others.
* $Id: LICENSE,v 1.8 2004/02/09 03:33:38 ian Exp $
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS""
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*
* Java, the Duke mascot, and all variants of Sun"s Java "steaming coffee
* cup" logo are trademarks of Sun Microsystems. Sun"s, and James Gosling"s,
* pioneering role in inventing and promulgating (and standardizing) the Java
* language and environment is gratefully acknowledged.
*
* The pioneering role of Dennis Ritchie and Bjarne Stroustrup, of AT&T, for
* inventing predecessor languages C and C++ is also gratefully acknowledged.
*/

import java.util.*;
/** Show the union and instersection of two sets. */
public class SetStuff {
public static void main(String[] args) {
// Create two sets.
Set s1 = new HashSet();
s1.add("Ian Darwin");
s1.add("Bill Dooley");
s1.add("Jesse James");
Set s2 = new HashSet();
s2.add("Ian Darwin");
s2.add("Doolin" Dalton");
Set union = new TreeSet(s1);
union.addAll(s2); // now contains the union
print("union", union);
Set intersect = new TreeSet(s1);
intersect.retainAll(s2);
print("intersection", intersect);
}
protected static void print(String label, Collection c) {
System.out.println("--------------" + label + "--------------");
Iterator it = c.iterator();
while (it.hasNext()) {
System.out.println(it.next());
}
}
}

</source>



== Small sets whose elements are known to be unique by construction ==



<source lang="java">

/*
* JGraphT : a free Java graph-theory library
*
*
* Project Info: http://jgrapht.sourceforge.net/
* Project Creator: Barak Naveh (http://sourceforge.net/users/barak_naveh)
*
* (C) Copyright 2003-2007, by Barak Naveh and Contributors.
*
* This library is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation; either version 2.1 of the License, or
* (at your option) any later version.
*
* This library is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
* License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this library; if not, write to the Free Software Foundation,
* Inc.,
* 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
*/
/* -----------------
* ArrayUnenforcedSet.java
* -----------------
* (C) Copyright 2006-2007, by John V. Sichi and Contributors.
*
* Original Author: John V. Sichi
* Contributor(s): -
*
* $Id: ArrayUnenforcedSet.java 568 2007-09-30 00:12:18Z perfecthash $
*
* Changes
* -------
* 07-May-2006 : Initial version (JVS);
*/
import java.util.*;

/**
* Helper for efficiently representing small sets whose elements are known to be
* unique by construction, implying we don"t need to enforce the uniqueness
* property in the data structure itself. Use with caution.
*
* <p>Note that for equals/hashCode, the class implements the Set behavior
* (unordered), not the list behavior (ordered); the fact that it subclasses
* ArrayList should be considered an implementation detail.
*
* @author John V. Sichi
*/
public class ArrayUnenforcedSet<E>
extends ArrayList<E>
implements Set<E>
{
//~ Static fields/initializers ---------------------------------------------
private static final long serialVersionUID = -7413250161201811238L;
//~ Constructors -----------------------------------------------------------
public ArrayUnenforcedSet()
{
super();
}
public ArrayUnenforcedSet(Collection<? extends E> c)
{
super(c);
}
public ArrayUnenforcedSet(int n)
{
super(n);
}
//~ Methods ----------------------------------------------------------------
public boolean equals(Object o)
{
return new SetForEquality().equals(o);
}
public int hashCode()
{
return new SetForEquality().hashCode();
}
//~ Inner Classes ----------------------------------------------------------
/**
* Multiple inheritance helper.
*/
private class SetForEquality
extends AbstractSet<E>
{
public Iterator<E> iterator()
{
return ArrayUnenforcedSet.this.iterator();
}
public int size()
{
return ArrayUnenforcedSet.this.size();
}
}
}
// End ArrayUnenforcedSet.java

</source>



== Sync Test ==



<source lang="java">

import java.util.Collections;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Iterator;
import java.util.Map;
import java.util.Set;
public class SyncTest {
public static void main(String args[]) {
Set simpsons = new HashSet();
simpsons.add("Bart");
simpsons.add("Hugo");
simpsons.add("Lisa");
simpsons.add("Marge");
simpsons.add("Homer");
simpsons.add("Maggie");
simpsons.add("Roy");
simpsons = Collections.synchronizedSet(simpsons);
synchronized (simpsons) {
Iterator iter = simpsons.iterator();
while (iter.hasNext()) {
System.out.println(iter.next());
}
}
Map map = Collections.synchronizedMap(new HashMap(89));
Set set = map.entrySet();
synchronized (map) {
Iterator iter = set.iterator();
while (iter.hasNext()) {
System.out.println(iter.next());
}
}
}
}

</source>



== Tail ==



<source lang="java">

import java.util.Arrays;
import java.util.SortedSet;
import java.util.TreeSet;
public class Tail {
public static void main(String args[]) throws Exception {
String elements[] = { "Irish Setter", "Poodle", "English Setter",
"Gordon Setter", "Pug" };
SortedSet set = new TreeSet(Arrays.asList(elements));
System.out.println(set.tailSet("Irish Setter"));
System.out.println(set.headSet("Irish Setter"));
System.out.println(set.headSet("Irish Setter\0"));
System.out.println(set.tailSet("Irish Setter\0"));
System.out.println(set.subSet("Irish Setter", "Poodle\0"));
System.out.println(set.subSet("Irish Setter", "Irish Setter\0"));
System.out.println(set.subSet("Irish Setter", "Irish Setter"));
}
}

</source>



== Things you can do with Sets ==



<source lang="java">

// : c11:Set1.java
// Things you can do with Sets.
// From "Thinking in Java, 3rd ed." (c) Bruce Eckel 2002
// www.BruceEckel.ru. See copyright notice in CopyRight.txt.
import java.util.Arrays;
import java.util.HashSet;
import java.util.LinkedHashSet;
import java.util.Set;
import java.util.TreeSet;
public class Set1 {
static void fill(Set s) {
s.addAll(Arrays.asList("one two three four five six seven".split(" ")));
}
public static void test(Set s) {
// Strip qualifiers from class name:
System.out.println(s.getClass().getName().replaceAll("\\w+\\.", ""));
fill(s);
fill(s);
fill(s);
System.out.println(s); // No duplicates!
// Add another set to this one:
s.addAll(s);
s.add("one");
s.add("one");
s.add("one");
System.out.println(s);
// Look something up:
System.out.println("s.contains(\"one\"): " + s.contains("one"));
}
public static void main(String[] args) {
test(new HashSet());
test(new TreeSet());
test(new LinkedHashSet());
}
} ///:~

</source>



== TreeSet Demo ==



<source lang="java">

/*
* Copyright (c) Ian F. Darwin, http://www.darwinsys.ru/, 1996-2002.
* All rights reserved. Software written by Ian F. Darwin and others.
* $Id: LICENSE,v 1.8 2004/02/09 03:33:38 ian Exp $
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS""
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*
* Java, the Duke mascot, and all variants of Sun"s Java "steaming coffee
* cup" logo are trademarks of Sun Microsystems. Sun"s, and James Gosling"s,
* pioneering role in inventing and promulgating (and standardizing) the Java
* language and environment is gratefully acknowledged.
*
* The pioneering role of Dennis Ritchie and Bjarne Stroustrup, of AT&T, for
* inventing predecessor languages C and C++ is also gratefully acknowledged.
*/
import java.util.TreeSet;
/**
* TreeSet Demo.
*
* @author Ian F. Darwin, http://www.darwinsys.ru/
* @version $Id: TreeSetDemo.java,v 1.3 2004/02/09 03:34:04 ian Exp $
*/
public class TreeSetDemo {
public static void main(String[] argv) {
//+
/*
* A TreeSet keeps objects in sorted order. We use a Comparator
* published by String for case-insensitive sorting order.
*/
TreeSet tm = new TreeSet(String.CASE_INSENSITIVE_ORDER);
tm.add("Gosling");
tm.add("da Vinci");
tm.add("van Gogh");
tm.add("Java To Go");
tm.add("Vanguard");
tm.add("Darwin");
tm.add("Darwin"); // TreeSet is Set, ignores duplicates.
// Since it is sorted we can ask for various subsets
System.out.println("Lowest (alphabetically) is " + tm.first());
// Print how many elements are greater than "k"
System.out.println(tm.tailSet("k").toArray().length
+ " elements higher than \"k\"");
// Print the whole list in sorted order
System.out.println("Sorted list:");
java.util.Iterator t = tm.iterator();
while (t.hasNext())
System.out.println(t.next());
//-
}
}

</source>



== Use set ==



<source lang="java">

import java.util.HashSet;
import java.util.Set;
public class FindDups {
public static void main(String args[]) {
Set s = new HashSet();
String[] values = new String[] { "java", "java2", "jexp", "javas",
"java" };
for (int i = 0; i < values.length; i++)
if (!s.add(values[i]))
System.out.println("Duplicate detected: " + values[i]);
System.out.println(s.size() + " distinct words detected: " + s);
}
}

</source>



== What you can do with a TreeSet ==



<source lang="java">

// : c11:SortedSetDemo.java
// What you can do with a TreeSet.
// From "Thinking in Java, 3rd ed." (c) Bruce Eckel 2002
// www.BruceEckel.ru. See copyright notice in CopyRight.txt.
import java.util.Arrays;
import java.util.Iterator;
import java.util.SortedSet;
import java.util.TreeSet;
public class SortedSetDemo {
public static void main(String[] args) {
SortedSet sortedSet = new TreeSet(Arrays
.asList("one two three four five six seven eight".split(" ")));
System.out.println(sortedSet);
Object low = sortedSet.first(), high = sortedSet.last();
System.out.println(low);
System.out.println(high);
Iterator it = sortedSet.iterator();
for (int i = 0; i <= 6; i++) {
if (i == 3)
low = it.next();
if (i == 6)
high = it.next();
else
it.next();
}
System.out.println(low);
System.out.println(high);
System.out.println(sortedSet.subSet(low, high));
System.out.println(sortedSet.headSet(high));
System.out.println(sortedSet.tailSet(low));
}
} ///:~

</source>



== Working with HashSet and TreeSet ==



<source lang="java">

import java.util.HashSet;
import java.util.Iterator;
import java.util.Set;
import java.util.TreeSet;
public class ItemSet {
public static void main(String args[]) {
String names[] = { "Item 1", "Item 2", "Item 3"};
Set moons = new HashSet();
int namesLen = names.length;
int index;
for (int i = 0; i < 100; i++) {
index = (int) (Math.random() * namesLen);
moons.add(names[index]);
}
Iterator it = moons.iterator();
while (it.hasNext()) {
System.out.println(it.next());
}
System.out.println("---");
Set orderedMoons = new TreeSet(moons);
it = orderedMoons.iterator();
while (it.hasNext()) {
System.out.println(it.next());
}
}
}

</source>

Java/Collections Data Structure/Array Convert

2010-06-01T07:27:10Z

Admin: 1 версия

== Array Converter ==



<source lang="java">

/**
*
* LibFormula : a free Java formula library
*
*
* Project Info: http://reporting.pentaho.org/libformula/
*
* (C) Copyright 2006-2007, by Pentaho Corporation and Contributors.
*
* This library is free software; you can redistribute it and/or modify it under the terms
* of the GNU Lesser General Public License as published by the Free Software Foundation;
* either version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
* without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
* See the GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License along with this
* library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
* Boston, MA 02111-1307, USA.
*
* [Java is a trademark or registered trademark of Sun Microsystems, Inc.
* in the United States and other countries.]
*
*
* ------------
* $Id: ArrayConverter.java 3521 2007-10-16 10:55:14Z tmorgner $
* ------------
* (C) Copyright 2006-2007, by Pentaho Corporation.
*/
import java.util.ArrayList;
import java.util.List;
import java.lang.reflect.Array;
/**
* Creation-Date: 08.10.2006, 17:37:50
*
* @author Thomas Morgner
*/
public class ArrayConverter
{
private ArrayConverter()
{
}
public static Object[] getAsList(final Object maybeArray,
final Class arrayType)
{
if (maybeArray == null)
{
return null;
}
if (maybeArray.getClass().isArray() == false)
{
return new Object[]{maybeArray};
}
final ArrayList list = new ArrayList();
ArrayConverter.addToList(list, maybeArray);
final Object o = Array.newInstance(arrayType, list.size());
return list.toArray((Object[]) o);
}
private static void addToList (final List list, final Object array)
{
final int length = Array.getLength(array);
for (int i = 0; i < length; i++)
{
final Object value = Array.get(array, i);
if (value == null)
{
list.add(null);
continue;
}
if (value.getClass().isArray() == false)
{
list.add(value);
continue;
}
ArrayConverter.addToList(list, value);
}
}

/**
* @param maybeArray
* @param dimensions
* @return
*/
public static Object[] getArray(final Object maybeArray,
final Class arrayType,
final int dims)
{
if (maybeArray == null)
{
return null;
}
if (dims <= 0)
{
return null;
}
if (maybeArray.getClass().isArray() == false)
{
Object object = maybeArray;
for (int i = 0; i < dims; i++)
{
final Object[] array = (Object[]) Array.newInstance(arrayType, 1);
array[0] = object;
object = array;
}
return (Object[]) object;
}
if (ArrayConverter.getDimensionCount(maybeArray.getClass()) < dims)
{
return null;
}
return (Object[]) maybeArray;
}
public static int getDimensionCount(Class arrayClass)
{
int count = 0;
while (arrayClass != null && arrayClass.isArray())
{
count += 1;
arrayClass = arrayClass.getComponentType();
}
return count;
}
}

</source>



== Array helper ==



<source lang="java">

/*
* Hibernate, Relational Persistence for Idiomatic Java
*
* Copyright (c) 2008, Red Hat Middleware LLC or third-party contributors as
* indicated by the @author tags or express copyright attribution
* statements applied by the authors. All third-party contributions are
* distributed under license by Red Hat Middleware LLC.
*
* This copyrighted material is made available to anyone wishing to use, modify,
* copy, or redistribute it subject to the terms and conditions of the GNU
* Lesser General Public License, as published by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
* for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this distribution; if not, write to:
* Free Software Foundation, Inc.
* 51 Franklin Street, Fifth Floor
* Boston, MA 02110-1301 USA
*
*/
import java.lang.reflect.Array;
import java.lang.reflect.Type;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collection;
import java.util.Iterator;
import java.util.List;
public final class ArrayHelper {

public static int indexOf(Object[] array, Object object) {
for (int i = 0; i < array.length; i++) {
if (array[i].equals(object))
return i;
}
return -1;
}

public static String[] toStringArray(Object[] objects) {
int length = objects.length;
String[] result = new String[length];
for (int i = 0; i < length; i++) {
result[i] = objects[i].toString();
}
return result;
}
public static String[] fillArray(String value, int length) {
String[] result = new String[length];
Arrays.fill(result, value);
return result;
}
public static int[] fillArray(int value, int length) {
int[] result = new int[length];
Arrays.fill(result, value);
return result;
}

public static String[] toStringArray(Collection coll) {
return (String[]) coll.toArray(EMPTY_STRING_ARRAY);
}
public static String[][] to2DStringArray(Collection coll) {
return (String[][]) coll.toArray(new String[coll.size()][]);
}
public static int[][] to2DIntArray(Collection coll) {
return (int[][]) coll.toArray(new int[coll.size()][]);
}
public static Type[] toTypeArray(Collection coll) {
return (Type[]) coll.toArray(EMPTY_TYPE_ARRAY);
}
public static int[] toIntArray(Collection coll) {
Iterator iter = coll.iterator();
int[] arr = new int[coll.size()];
int i = 0;
while (iter.hasNext()) {
arr[i++] = ((Integer) iter.next()).intValue();
}
return arr;
}
public static boolean[] toBooleanArray(Collection coll) {
Iterator iter = coll.iterator();
boolean[] arr = new boolean[coll.size()];
int i = 0;
while (iter.hasNext()) {
arr[i++] = ((Boolean) iter.next()).booleanValue();
}
return arr;
}
public static Object[] typecast(Object[] array, Object[] to) {
return java.util.Arrays.asList(array).toArray(to);
}
// Arrays.asList doesn"t do primitive arrays
public static List toList(Object array) {
if (array instanceof Object[])
return Arrays.asList((Object[]) array); // faster?
int size = Array.getLength(array);
ArrayList list = new ArrayList(size);
for (int i = 0; i < size; i++) {
list.add(Array.get(array, i));
}
return list;
}
public static String[] slice(String[] strings, int begin, int length) {
String[] result = new String[length];
for (int i = 0; i < length; i++) {
result[i] = strings[begin + i];
}
return result;
}
public static Object[] slice(Object[] objects, int begin, int length) {
Object[] result = new Object[length];
for (int i = 0; i < length; i++) {
result[i] = objects[begin + i];
}
return result;
}
public static List toList(Iterator iter) {
List list = new ArrayList();
while (iter.hasNext()) {
list.add(iter.next());
}
return list;
}
public static String[] join(String[] x, String[] y) {
String[] result = new String[x.length + y.length];
for (int i = 0; i < x.length; i++)
result[i] = x[i];
for (int i = 0; i < y.length; i++)
result[i + x.length] = y[i];
return result;
}
public static String[] join(String[] x, String[] y, boolean[] use) {
String[] result = new String[x.length + countTrue(use)];
for (int i = 0; i < x.length; i++)
result[i] = x[i];
int k = x.length;
for (int i = 0; i < y.length; i++) {
if (use[i])
result[k++] = y[i];
}
return result;
}
public static int[] join(int[] x, int[] y) {
int[] result = new int[x.length + y.length];
for (int i = 0; i < x.length; i++)
result[i] = x[i];
for (int i = 0; i < y.length; i++)
result[i + x.length] = y[i];
return result;
}
public static final boolean[] TRUE = { true };
public static final boolean[] FALSE = { false };
private ArrayHelper() {
}
public static String toString(Object[] array) {
StringBuffer sb = new StringBuffer();
sb.append("[");
for (int i = 0; i < array.length; i++) {
sb.append(array[i]);
if (i < array.length - 1)
sb.append(",");
}
sb.append("]");
return sb.toString();
}
public static boolean isAllNegative(int[] array) {
for (int i = 0; i < array.length; i++) {
if (array[i] >= 0)
return false;
}
return true;
}
public static boolean isAllTrue(boolean[] array) {
for (int i = 0; i < array.length; i++) {
if (!array[i])
return false;
}
return true;
}
public static int countTrue(boolean[] array) {
int result = 0;
for (int i = 0; i < array.length; i++) {
if (array[i])
result++;
}
return result;
}
/*
* public static int countFalse(boolean[] array) { int result=0; for ( int
* i=0; i<array.length; i++ ) { if ( !array[i] ) result++; } return result; }
*/
public static boolean isAllFalse(boolean[] array) {
for (int i = 0; i < array.length; i++) {
if (array[i])
return false;
}
return true;
}
public static void addAll(Collection collection, Object[] array) {
for (int i = 0; i < array.length; i++) {
collection.add(array[i]);
}
}
public static final String[] EMPTY_STRING_ARRAY = {};
public static final int[] EMPTY_INT_ARRAY = {};
public static final boolean[] EMPTY_BOOLEAN_ARRAY = {};
public static final Class[] EMPTY_CLASS_ARRAY = {};
public static final Object[] EMPTY_OBJECT_ARRAY = {};
public static final Type[] EMPTY_TYPE_ARRAY = {};
public static int[] getBatchSizes(int maxBatchSize) {
int batchSize = maxBatchSize;
int n = 1;
while (batchSize > 1) {
batchSize = getNextBatchSize(batchSize);
n++;
}
int[] result = new int[n];
batchSize = maxBatchSize;
for (int i = 0; i < n; i++) {
result[i] = batchSize;
batchSize = getNextBatchSize(batchSize);
}
return result;
}
private static int getNextBatchSize(int batchSize) {
if (batchSize <= 10) {
return batchSize - 1; // allow 9,8,7,6,5,4,3,2,1
} else if (batchSize / 2 < 10) {
return 10;
} else {
return batchSize / 2;
}
}
private static int SEED = 23;
private static int PRIME_NUMER = 37;
/**
* calculate the array hash (only the first level)
*/
public static int hash(Object[] array) {
int length = array.length;
int seed = SEED;
for (int index = 0; index < length; index++) {
seed = hash(seed, array[index] == null ? 0 : array[index].hashCode());
}
return seed;
}
/**
* calculate the array hash (only the first level)
*/
public static int hash(char[] array) {
int length = array.length;
int seed = SEED;
for (int index = 0; index < length; index++) {
seed = hash(seed, (int) array[index]);
}
return seed;
}
/**
* calculate the array hash (only the first level)
*/
public static int hash(byte[] bytes) {
int length = bytes.length;
int seed = SEED;
for (int index = 0; index < length; index++) {
seed = hash(seed, (int) bytes[index]);
}
return seed;
}
private static int hash(int seed, int i) {
return PRIME_NUMER * seed + i;
}
/**
* Compare 2 arrays only at the first level
*/
public static boolean isEquals(Object[] o1, Object[] o2) {
if (o1 == o2)
return true;
if (o1 == null || o2 == null)
return false;
int length = o1.length;
if (length != o2.length)
return false;
for (int index = 0; index < length; index++) {
if (!o1[index].equals(o2[index]))
return false;
}
return true;
}
/**
* Compare 2 arrays only at the first level
*/
public static boolean isEquals(char[] o1, char[] o2) {
if (o1 == o2)
return true;
if (o1 == null || o2 == null)
return false;
int length = o1.length;
if (length != o2.length)
return false;
for (int index = 0; index < length; index++) {
if (!(o1[index] == o2[index]))
return false;
}
return true;
}
/**
* Compare 2 arrays only at the first level
*/
public static boolean isEquals(byte[] b1, byte[] b2) {
if (b1 == b2)
return true;
if (b1 == null || b2 == null)
return false;
int length = b1.length;
if (length != b2.length)
return false;
for (int index = 0; index < length; index++) {
if (!(b1[index] == b2[index]))
return false;
}
return true;
}
}

</source>



== byte array to int array ==



<source lang="java">

/*
* Permission is hereby granted, free of charge, to any person obtaining a copy of
* this software and associated documentation files (the "Software"), to deal in
* the Software without restriction, including without limitation the rights to
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
* of the Software, and to permit persons to whom the Software is furnished to do
* so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
* SOFTWARE.
*/
public class ArrayCopy {

public static int[] byte2int(byte[]src) {
int dstLength = src.length >>> 2;
int[]dst = new int[dstLength];

for (int i=0; i<dstLength; i++) {
int j = i << 2;
int x = 0;
x += (src[j++] & 0xff) << 0;
x += (src[j++] & 0xff) << 8;
x += (src[j++] & 0xff) << 16;
x += (src[j++] & 0xff) << 24;
dst[i] = x;
}
return dst;
}
}

</source>



== Convert array to string ==



<source lang="java">

/* ArraysX.java
{{IS_NOTE
Purpose:
Description:
History:
2001/11/13, Henri Chen: Created.
}}IS_NOTE
Copyright (C) 2001 Potix Corporation. All Rights Reserved.
{{IS_RIGHT
This program is distributed under GPL Version 3.0 in the hope that
it will be useful, but WITHOUT ANY WARRANTY.
}}IS_RIGHT
*/
import java.lang.reflect.Array;
/**
* Utilities for handling arrays.
*
* @author henrichen
*/
public class ArraysX {
/** Converts an array to a readable string (for debugging purpose).
*/
public final static String toString(Object[] array) {
if (array == null)
return "null";
StringBuffer sb = new StringBuffer(128).append("[");
for (int j = 0; j < array.length; ++j) {
if (array[j] == array)
sb.append("(this array)");
else
sb.append(array[j]);
if (j != array.length - 1)
sb.append(", ");
}
return sb.append("]").toString();
}
/** Converts an array of int to a readable string (for debugging purpose).
*/
public final static String toString(int[] array) {
if (array == null)
return "null";
StringBuffer sb = new StringBuffer(128).append("[");
for (int j = 0; j < array.length; ++j) {
sb.append(array[j]);
if (j != array.length - 1)
sb.append(", ");
}
return sb.append("]").toString();
}
/** Converts an array of long to a readable string (for debugging purpose).
*/
public final static String toString(long[] array) {
if (array == null)
return "null";
StringBuffer sb = new StringBuffer(128).append("[");
for (int j = 0; j < array.length; ++j) {
sb.append(array[j]);
if (j != array.length - 1)
sb.append(", ");
}
return sb.append("]").toString();
}
/** Converts an array of short to a readable string (for debugging purpose).
*/
public final static String toString(short[] array) {
if (array == null)
return "null";
StringBuffer sb = new StringBuffer(128).append("[");
for (int j = 0; j < array.length; ++j) {
sb.append(array[j]);
if (j != array.length - 1)
sb.append(", ");
}
return sb.append("]").toString();
}
/** Converts an array of byte to a readable string (for debugging purpose).
*/
public final static String toString(byte[] array) {
if (array == null)
return "null";
StringBuffer sb = new StringBuffer(128).append("[");
for (int j = 0; j < array.length; ++j) {
sb.append(array[j]);
if (j != array.length - 1)
sb.append(", ");
}
return sb.append("]").toString();
}
/** Converts an array of char to a readable string (for debugging purpose).
*/
public final static String toString(char[] array) {
if (array == null)
return "null";
StringBuffer sb = new StringBuffer(128).append("[");
for (int j = 0; j < array.length; ++j) {
sb.append(array[j]);
if (j != array.length - 1)
sb.append(", ");
}
return sb.append("]").toString();
}
/** Converts an array of boolean to a readable string (for debugging purpose).
*/
public final static String toString(boolean[] array) {
if (array == null)
return "null";
StringBuffer sb = new StringBuffer(128).append("[");
for (int j = 0; j < array.length; ++j) {
sb.append(array[j]);
if (j != array.length - 1)
sb.append(", ");
}
return sb.append("]").toString();
}
/** Converts an array of float to a readable string (for debugging purpose).
*/
public final static String toString(float[] array) {
if (array == null)
return "null";
StringBuffer sb = new StringBuffer(128).append("[");
for (int j = 0; j < array.length; ++j) {
sb.append(array[j]);
if (j != array.length - 1)
sb.append(", ");
}
return sb.append("]").toString();
}
/** Converts an array of char to a readable string (for debugging purpose).
*/
public final static String toString(double[] array) {
if (array == null)
return "null";
StringBuffer sb = new StringBuffer(128).append("[");
for (int j = 0; j < array.length; ++j) {
sb.append(array[j]);
if (j != array.length - 1)
sb.append(", ");
}
return sb.append("]").toString();
}
/**
* Returns the hex String representation of a byte array without prefix 0x.
* The String is formed by making value[0] the leftmost two digits and
* value[value.length-1] the rightmost two digits.
*
* @param array the byte array
*/
public final static String toHexString(byte[] array) {
StringBuffer sb = new StringBuffer(array.length*2 + 8);
char ch;
for (int i=0; i< array.length; i++) {
// byte will be promote to integer first, mask with 0x0f is a must.
ch = Character.forDigit(array[i] >>> 4 & 0x0f, 16);
sb.append(ch);
ch = Character.forDigit(array[i] & 0x0f, 16);
sb.append(ch);
}
return sb.toString();
}
/**
* Returns the octal String representation of a byte array with optional
* prefix. The String is formed by making value[0] the leftmost three digits
* and value[value.length-1] the rightmost three digits.
*
* @param array the byte array
*/
public final static String toOctalString(byte[] array, String prefix) {
StringBuffer sb = new StringBuffer(array.length*(3+prefix.length()) + 8);
if (prefix == null) {
for (int i=0; i< array.length; i++) {
appendOctalDigits(sb, array[i]);
}
} else {
for (int i=0; i< array.length; i++) {
sb.append(prefix);
appendOctalDigits(sb, array[i]);
}
}
return sb.toString();
}
/**
* Returns the octal digit String buffer representation of a byte.
* @param byte the byte
*/
private final static StringBuffer appendOctalDigits(StringBuffer sb, byte b) {
// b will be promote to integer first, mask with 0x07 is a must.
return sb.append(Character.forDigit(b >>> 6 & 0x07, 8))
.append(Character.forDigit(b >>> 3 & 0x07, 8))
.append(Character.forDigit(b & 0x07, 8));
}
/**
* Duplicates the specified array.
*
* <p>The array could be an array of objects or primiitives.
*
* @param ary the array
* @param jb the beginning index (included)
* @param je the ending index (excluded)
* @return an array duplicated from ary
* @exception IllegalArgumentException if ary is not any array
* @exception IndexOutOfBoundsException if out of bounds
*/
public static final Object duplicate(Object ary, int jb, int je) {
int len = Array.getLength(ary);
if (jb<0 || je>len || jb>je)
throw new IndexOutOfBoundsException(jb + " or " + je + " exceeds " + len);
len = je - jb;
Object dst = Array.newInstance(ary.getClass().getComponentType(), len);
System.arraycopy(ary, jb, dst, 0, len);
return dst;
}
/**
* Duplicates the specified array.
* @param ary the array
* @return an array duplicated from ary
* @exception IllegalArgumentException if ary is not any array
* @exception IndexOutOfBoundsException if out of bounds
*/
public static final Object duplicate(Object ary) {
return duplicate(ary, 0, Array.getLength(ary));
}
/**
* Concat the two specified array.
*
* <p>The array could be an array of objects or primiitives.
*
* @param ary the array
* @param ary1 the array
* @return an array concat the ary and ary1
* @exception IllegalArgumentException if ary and ary1 component type are different
*/
public static final Object concat(Object ary, Object ary1) {
int len = Array.getLength(ary) + Array.getLength(ary1);

if (!ary.getClass().getComponentType().equals(ary1.getClass().getComponentType()))
throw new IllegalArgumentException("These concated array component type are different.");
Object dst = Array.newInstance(ary.getClass().getComponentType(), len);

System.arraycopy(ary, 0, dst, 0, Array.getLength(ary));
System.arraycopy(ary1, 0, dst, Array.getLength(ary), Array.getLength(ary1));

return dst;
}

/**
* Shrink the specified array. It is similar to duplicate, except
* it returns the previous instance if je==length && jb==0.
*
* @param ary the array
* @param jb the beginning index (included)
* @param je the ending index (excluded)
* @return ary or an array duplicated from ary
* @exception IllegalArgumentException if ary is not any array
* @exception IndexOutOfBoundsException if out of bounds
*/
public static final Object shrink(Object ary, int jb, int je) {
if (jb == 0 && je == Array.getLength(ary))
return ary; //nothing changed
return duplicate(ary, jb, je);
}
/**
* Resizes the specified array. Similar to {@link #shrink}, but
* it can enlarge and it keeps elements from the first.
*/
public static final Object resize(Object ary, int size) {
final int oldsz = Array.getLength(ary);
if (oldsz == size)
return ary;
final Object dst = Array.newInstance(ary.getClass().getComponentType(), size);
System.arraycopy(ary, 0, dst, 0, oldsz > size ? size: oldsz);
return dst;
}
/** Clones an array.
*/
public static final Object clone(Object ary) {
final int size = Array.getLength(ary);
final Object dst = Array.newInstance(ary.getClass().getComponentType(), size);
System.arraycopy(ary, 0, dst, 0, size);
return dst;
}
}

</source>



== Convert array to string (from c3p0) ==



<source lang="java">

/**
* Distributed as part of c3p0 v.0.9.1.2
*
* Copyright (C) 2005 Machinery For Change, Inc.
*
* Author: Steve Waldman <swaldman@mchange.ru>
*
* This library is free software; you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License version 2.1, as published
* by the Free Software Foundation.
*
* This software is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
* details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this software; see the file LICENSE. If not, write to the Free
* Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307,
* USA.
*/
public final class ArrayUtils {
/**
* The array may contain nulls, but <TT>o</TT> must be non-null.
*/
public static int indexOf(Object[] array, Object o) {
for (int i = 0, len = array.length; i < len; ++i)
if (o.equals(array[i]))
return i;
return -1;
}
public static int identityIndexOf(Object[] array, Object o) {
for (int i = 0, len = array.length; i < len; ++i)
if (o == array[i])
return i;
return -1;
}
public static boolean startsWith(byte[] checkMe, byte[] maybePrefix) {
int cm_len = checkMe.length;
int mp_len = maybePrefix.length;
if (cm_len < mp_len)
return false;
for (int i = 0; i < mp_len; ++i)
if (checkMe[i] != maybePrefix[i])
return false;
return true;
}
/**
* returns a hash-code for an array consistent with Arrays.equals( ... )
*/
public static int hashArray(int[] ii) {
int len = ii.length;
int out = len;
for (int i = 0; i < len; ++i) {
// we rotate the bits of the element hashes
// around so that the hash has some loaction
// dependency
int elem_hash = ii[i];
int rot = i % 32;
int rot_hash = elem_hash >>> rot;
rot_hash |= elem_hash << (32 - rot);
out ^= rot_hash;
}
return out;
}
public static int hashOrZeroArray(int[] ii) {
return (ii == null ? 0 : hashArray(ii));
}
// these methods are obsoleted by Arrays.toString() in jdk1.5, but
// for libs that support older VMs...
private static String toString(String[] strings, int guessed_len) {
StringBuffer sb = new StringBuffer(guessed_len);
boolean first = true;
sb.append("[");
for (int i = 0, len = strings.length; i < len; ++i) {
if (first)
first = false;
else
sb.append(",");
sb.append(strings[i]);
}
sb.append("]");
return sb.toString();
}
public static String toString(boolean[] arr) {
String[] strings = new String[arr.length];
int chars = 0;
for (int i = 0, len = arr.length; i < len; ++i) {
String str = String.valueOf(arr[i]);
chars += str.length();
strings[i] = str;
}
return toString(strings, chars + arr.length + 1);
}
public static String toString(byte[] arr) {
String[] strings = new String[arr.length];
int chars = 0;
for (int i = 0, len = arr.length; i < len; ++i) {
String str = String.valueOf(arr[i]);
chars += str.length();
strings[i] = str;
}
return toString(strings, chars + arr.length + 1);
}
public static String toString(char[] arr) {
String[] strings = new String[arr.length];
int chars = 0;
for (int i = 0, len = arr.length; i < len; ++i) {
String str = String.valueOf(arr[i]);
chars += str.length();
strings[i] = str;
}
return toString(strings, chars + arr.length + 1);
}
public static String toString(short[] arr) {
String[] strings = new String[arr.length];
int chars = 0;
for (int i = 0, len = arr.length; i < len; ++i) {
String str = String.valueOf(arr[i]);
chars += str.length();
strings[i] = str;
}
return toString(strings, chars + arr.length + 1);
}
public static String toString(int[] arr) {
String[] strings = new String[arr.length];
int chars = 0;
for (int i = 0, len = arr.length; i < len; ++i) {
String str = String.valueOf(arr[i]);
chars += str.length();
strings[i] = str;
}
return toString(strings, chars + arr.length + 1);
}
public static String toString(long[] arr) {
String[] strings = new String[arr.length];
int chars = 0;
for (int i = 0, len = arr.length; i < len; ++i) {
String str = String.valueOf(arr[i]);
chars += str.length();
strings[i] = str;
}
return toString(strings, chars + arr.length + 1);
}
public static String toString(float[] arr) {
String[] strings = new String[arr.length];
int chars = 0;
for (int i = 0, len = arr.length; i < len; ++i) {
String str = String.valueOf(arr[i]);
chars += str.length();
strings[i] = str;
}
return toString(strings, chars + arr.length + 1);
}
public static String toString(double[] arr) {
String[] strings = new String[arr.length];
int chars = 0;
for (int i = 0, len = arr.length; i < len; ++i) {
String str = String.valueOf(arr[i]);
chars += str.length();
strings[i] = str;
}
return toString(strings, chars + arr.length + 1);
}
public static String toString(Object[] arr) {
String[] strings = new String[arr.length];
int chars = 0;
for (int i = 0, len = arr.length; i < len; ++i) {
String str;
Object o = arr[i];
if (o instanceof Object[])
str = toString((Object[]) o);
else if (o instanceof double[])
str = toString((double[]) o);
else if (o instanceof float[])
str = toString((float[]) o);
else if (o instanceof long[])
str = toString((long[]) o);
else if (o instanceof int[])
str = toString((int[]) o);
else if (o instanceof short[])
str = toString((short[]) o);
else if (o instanceof char[])
str = toString((char[]) o);
else if (o instanceof byte[])
str = toString((byte[]) o);
else if (o instanceof boolean[])
str = toString((boolean[]) o);
else
str = String.valueOf(arr[i]);
chars += str.length();
strings[i] = str;
}
return toString(strings, chars + arr.length + 1);
}
private ArrayUtils() {
}
/*
* public static void main(String[] argv) { int[] is = {1,2,3,4}; String[] ss =
* {"Hello", "There"}; Object[] os = {"Poop", is, ss, new Thread()};
*
* System.out.println( toString(is) ); System.out.println( toString(ss) );
* System.out.println( toString(os) ); }
*/
}

</source>



== Convert byte array to Integer and Long ==



<source lang="java">

/*
* Copyright Aduna (http://www.aduna-software.ru/) (c) 1997-2006.
*
* Licensed under the Aduna BSD-style license.
*/

public class Utils {

public static void putInt(int value, byte[] array, int offset) {
array[offset] = (byte)(0xff & (value >> 24));
array[offset+1] = (byte)(0xff & (value >> 16));
array[offset+2] = (byte)(0xff & (value >> 8));
array[offset+3] = (byte)(0xff & value);
}
public static int getInt(byte[] array, int offset) {
return
((array[offset] & 0xff) << 24) |
((array[offset+1] & 0xff) << 16) |
((array[offset+2] & 0xff) << 8) |
(array[offset+3] & 0xff);
}
public static void putLong(long value, byte[] array, int offset) {
array[offset] = (byte)(0xff & (value >> 56));
array[offset+1] = (byte)(0xff & (value >> 48));
array[offset+2] = (byte)(0xff & (value >> 40));
array[offset+3] = (byte)(0xff & (value >> 32));
array[offset+4] = (byte)(0xff & (value >> 24));
array[offset+5] = (byte)(0xff & (value >> 16));
array[offset+6] = (byte)(0xff & (value >> 8));
array[offset+7] = (byte)(0xff & value);
}
public static long getLong(byte[] array, int offset) {
return
((long)(array[offset] & 0xff) << 56) |
((long)(array[offset+1] & 0xff) << 48) |
((long)(array[offset+2] & 0xff) << 40) |
((long)(array[offset+3] & 0xff) << 32) |
((long)(array[offset+4] & 0xff) << 24) |
((long)(array[offset+5] & 0xff) << 16) |
((long)(array[offset+6] & 0xff) << 8) |
((long)(array[offset+7] & 0xff));
}

}

</source>



== Convert byte array to string ==



<source lang="java">

/*
Copyright (C) 2002 MySQL AB
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

*/
import java.io.UnsupportedEncodingException;

/**
* Various utility methods for converting to/from byte
* arrays in the platform encoding
*
* @author Mark Matthews
*/
public class StringUtils {
//~ Instance/static variables .............................................
private static final int BYTE_RANGE = (1 + Byte.MAX_VALUE)
- Byte.MIN_VALUE;
private static byte[] allBytes = new byte[BYTE_RANGE];
private static char[] byteToChars = new char[BYTE_RANGE];
//~ Initializers ..........................................................
static {
for (int i = Byte.MIN_VALUE; i <= Byte.MAX_VALUE; i++) {
allBytes[i - Byte.MIN_VALUE] = (byte) i;
}
String allBytesString = new String(allBytes, 0,
Byte.MAX_VALUE - Byte.MIN_VALUE);
for (int i = 0; i < (Byte.MAX_VALUE - Byte.MIN_VALUE); i++) {
byteToChars[i] = allBytesString.charAt(i);
}
}

/**
* DOCUMENT ME!
*
* @param buffer DOCUMENT ME!
* @param startPos DOCUMENT ME!
* @param length DOCUMENT ME!
* @return DOCUMENT ME!
*/
public static final String toAsciiString3(byte[] buffer, int startPos,
int length) {
char[] charArray = new char[length];
int readpoint = startPos;
for (int i = 0; i < length; i++) {
charArray[i] = byteToChars[(int) buffer[readpoint]
- Byte.MIN_VALUE];
readpoint++;
}
return new String(charArray);
}
/**
* DOCUMENT ME!
*
* @param buffer DOCUMENT ME!
* @return DOCUMENT ME!
*/
public static final String toAsciiString(byte[] buffer) {
return toAsciiString3(buffer, 0, buffer.length);
}
/**
* DOCUMENT ME!
*
* @param buffer DOCUMENT ME!
* @param startPos DOCUMENT ME!
* @param length DOCUMENT ME!
* @return DOCUMENT ME!
*/
public static final String toAsciiString2(byte[] buffer, int startPos,
int length) {
return new String(buffer, startPos, length);
}
/**
* DOCUMENT ME!
*
* @param buffer DOCUMENT ME!
* @param startPos DOCUMENT ME!
* @param length DOCUMENT ME!
* @return DOCUMENT ME!
*/
public static final String toAsciiString(byte[] buffer, int startPos,
int length) {
StringBuffer result = new StringBuffer();
int endPoint = startPos + length;
for (int i = startPos; i < endPoint; i++) {
result.append(byteToChars[(int) buffer[i] - Byte.MIN_VALUE]);
}
return result.toString();
}
}

</source>



== Converts a Array to an Enumeration and allows it to be serialized ==



<source lang="java">

/*
* Copyright Javelin Software, All rights reserved.
*/

import java.util.*;
import java.io.*;
/**
* An ArrayEnumeration converts a Array to an Enumeration and allows it
* to be serialized.
* <p>
* @author Robin Sharp
*/
public class ArrayEnumeration implements Enumeration, Serializable
{
/**
* Construct a fully qualified ArrayEnumeration.
* @param array the array to be Enumerated.
*/
public ArrayEnumeration(Object[] array)
{
this.array = array;
}
// ENUMERATION /////////////////////////////////////////////////////////
/**
* @return true if there are more elements in the enumeration.
*/
public boolean hasMoreElements()
{
return array != null && index < array.length;
}
/**
* @return the next element in the enumeration
*/
public Object nextElement()
{
return array[index++];
}
// PRIVATE /////////////////////////////////////////////////////////////
private Object[] array;
private int index;
}

</source>



== int array to byte array ==



<source lang="java">

/*
* Permission is hereby granted, free of charge, to any person obtaining a copy of
* this software and associated documentation files (the "Software"), to deal in
* the Software without restriction, including without limitation the rights to
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
* of the Software, and to permit persons to whom the Software is furnished to do
* so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
* SOFTWARE.
*/
public class ArrayCopy {

public static byte[] int2byte(int[]src) {
int srcLength = src.length;
byte[]dst = new byte[srcLength << 2];

for (int i=0; i<srcLength; i++) {
int x = src[i];
int j = i << 2;
dst[j++] = (byte) ((x >>> 0) & 0xff);
dst[j++] = (byte) ((x >>> 8) & 0xff);
dst[j++] = (byte) ((x >>> 16) & 0xff);
dst[j++] = (byte) ((x >>> 24) & 0xff);
}
return dst;
}
}

</source>



== Return a new byte array containing a sub-portion of the source array ==



<source lang="java">

/**********************************************************************************
*
* Copyright (c) 2003, 2004 The Regents of the University of Michigan, Trustees of Indiana University,
* Board of Trustees of the Leland Stanford, Jr., University, and The MIT Corporation
*
* Licensed under the Educational Community License Version 1.0 (the "License");
* By obtaining, using and/or copying this Original Work, you agree that you have read,
* understand, and will comply with the terms and conditions of the Educational Community License.
* You may obtain a copy of the License at:
*
* http://cvs.sakaiproject.org/licenses/license_1_0.html
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
* INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
* AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
* DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*
**********************************************************************************/

/**
* Byte utilities
*/
public class ByteUtils {

/**
* Return a new byte array containing a sub-portion of the source array
*
* @param srcBegin
* The beginning index (inclusive)
* @return The new, populated byte array
*/
public static byte[] subbytes(byte[] source, int srcBegin) {
return subbytes(source, srcBegin, source.length);
}
/**
* Return a new byte array containing a sub-portion of the source array
*
* @param srcBegin
* The beginning index (inclusive)
* @param srcEnd
* The ending index (exclusive)
* @return The new, populated byte array
*/
public static byte[] subbytes(byte[] source, int srcBegin, int srcEnd) {
byte destination[];
destination = new byte[srcEnd - srcBegin];
getBytes(source, srcBegin, srcEnd, destination, 0);
return destination;
}

/**
* Copies bytes from the source byte array to the destination array
*
* @param source
* The source array
* @param srcBegin
* Index of the first source byte to copy
* @param srcEnd
* Index after the last source byte to copy
* @param destination
* The destination array
* @param dstBegin
* The starting offset in the destination array
*/
public static void getBytes(byte[] source, int srcBegin, int srcEnd, byte[] destination,
int dstBegin) {
System.arraycopy(source, srcBegin, destination, dstBegin, srcEnd - srcBegin);
}
}

</source>



== Turn an array of ints into a printable string. ==



<source lang="java">

import java.io.IOException;
import java.io.InputStream;
import java.util.Enumeration;
import java.util.Properties;
/*
Derby - Class org.apache.derby.iapi.util.PropertyUtil
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to you 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.
*/

public class Main {

/**
* Turn an array of ints into a printable string. Returns what"s returned
* in Java 5 by java.util.Arrays.toString(int[]).
*/
public static String stringify( int[] raw )
{
if ( raw == null ) { return "null"; }

StringBuffer buffer = new StringBuffer();
int count = raw.length;
buffer.append( "[ " );
for ( int i = 0; i < count; i++ )
{
if ( i > 0 ) { buffer.append( ", " ); }
buffer.append( raw[ i ] );
}
buffer.append( " ]" );
return buffer.toString();
}
}

</source>

Java/Collections Data Structure/EnumMap

2010-06-01T07:27:10Z

Admin: 1 версия

== Use EnumMap to store enum type data ==



<source lang="java">

import java.util.EnumMap;
public class SizeMap {
public static void main(String[] args) {
EnumMap<Size, String> sizeMap = new EnumMap<Size, String>(Size.class);
sizeMap.put(Size.S, "S");
sizeMap.put(Size.M, "M");
sizeMap.put(Size.L, "L");
sizeMap.put(Size.XL, "XL");
sizeMap.put(Size.XXL, "XXL");
sizeMap.put(Size.XXXL, "XXXL");
for (Size size : Size.values()) {
System.out.println(size + ":" + sizeMap.get(size));
}
}
}
enum Size {
S, M, L, XL, XXL, XXXL;
}
</source>