Posts Tagged ‘Redpoint’
June 19th, 2009
I just finished putting a server together that uses Google’s Guice and Adobe’s BlazeDS. Here’s how you can quickly get a project working using the same configuration.
* Update: A new post describes using Guice’s ServletModule to configure the MessageBrokerServlet.
Download the libraries
Download Guice and BlazeDS. Use the project configured in the BlazeDS war to get started.
Create the Guice factory
Since BlazeDS provides the servlet, you won’t be able to configure your classes using Guice unless you have a Flex factory. This code will inject itself with Guice to get instances of Flex services.
package com.connorgarvey.guiceblazeds.servlet;
import java.util.HashMap;
import java.util.Map;
import com.google.inject.Injector;
import flex.messaging.FactoryInstance;
import flex.messaging.FlexContext;
import flex.messaging.FlexFactory;
import flex.messaging.config.ConfigMap;
import flex.messaging.services.ServiceException;
/**
* <p>A Flex factory that retrieves instances of Flex services from Guice</p>
* <p>This is based on a similar factory built for Spring by Jeff Vroom</p>
* @author Connor Garvey
* @created May 27, 2009 1:09:49 PM
* @version 1.0.0
* @since 1.0.0
*/
public class GuiceFactory implements FlexFactory {
private static final String SOURCE = "source";
/**
* @see flex.messaging.FlexFactory#createFactoryInstance(java.lang.String, flex.messaging.config.ConfigMap)
*/
public FactoryInstance createFactoryInstance(final String id, final ConfigMap properties) {
final GuiceFactoryInstance instance = new GuiceFactoryInstance(this, id, properties);
instance.setSource(properties.getPropertyAsString(SOURCE, instance.getId()));
return instance;
}
/**
* @see flex.messaging.FlexConfigurable#initialize(java.lang.String, flex.messaging.config.ConfigMap)
*/
public void initialize(final String id, final ConfigMap configMap) {
}
/**
* @see flex.messaging.FlexFactory#lookup(flex.messaging.FactoryInstance)
*/
public Object lookup(final FactoryInstance inst) {
return inst.lookup();
}
static class GuiceFactoryInstance extends FactoryInstance {
private Map<String, Class<?>> classes = new HashMap<String, Class<?>>();
GuiceFactoryInstance(final GuiceFactory factory, final String id, final ConfigMap properties) {
super(factory, id, properties);
}
@Override
public Object lookup() {
final Injector injector = (Injector)FlexContext.getServletContext().getAttribute(
GuiceServletContextListener.KEY);
injector.injectMembers(this);
String className = this.getSource();
Class<?> clazz = this.classes.get(className);
if (clazz == null) {
try {
clazz = Class.forName(this.getSource());
this.classes.put(className, clazz);
}
catch (ClassNotFoundException ex) {
ServiceException throwing = new ServiceException();
throwing.setMessage("Could not find remote service class '" + this.getSource() + "'");
throwing.setRootCause(ex);
throwing.setCode("Server.Processing");
throw throwing;
}
}
return injector.getInstance(clazz);
}
@Override
public String toString() {
return "Guice factory <id='" + this.getId() + "',source='" + this.getSource() +
"',scope='" + this.getScope() + "'>";
}
}
}Create a context listener
The Guice servlet jar contains a ServletContextListener, but I haven’t taken the time to integrate it into this solution. For simplicity, you can use this one, which works with the factory above.
package com.connorgarvey.guiceblazeds.servlet;
import java.util.List;
import javax.servlet.ServletContext;
import javax.servlet.ServletContextEvent;
import javax.servlet.ServletContextListener;
import com.google.inject.Guice;
import com.google.inject.Injector;
import com.google.inject.Module;
/**
* Prepares Guice on application startup
* @author Connor Garvey
* @created May 27, 2009 8:37:26 AM
* @version 1.0.0
* @since 1.0.0
*/
public abstract class GuiceServletContextListener implements ServletContextListener {
/**
* The key of the servlet context attribute holding the injector
*/
public static final String KEY = Injector.class.getName();
/**
* @see javax.servlet.ServletContextListener#contextDestroyed(javax.servlet.ServletContextEvent)
*/
public void contextDestroyed(final ServletContextEvent servletContextEvent) {
servletContextEvent.getServletContext().removeAttribute(KEY);
}
/**
* @see javax.servlet.ServletContextListener#contextInitialized(javax.servlet.ServletContextEvent)
*/
public void contextInitialized(final ServletContextEvent servletContextEvent) {
servletContextEvent.getServletContext().setAttribute(KEY,
this.getInjector(servletContextEvent.getServletContext()));
}
private Injector getInjector(final ServletContext servletContext) {
return Guice.createInjector(this.getModules());
}
/**
* Gets the modules used by the application
* @return the modules
*/
protected abstract List<? extends Module> getModules();
}Extend GuiceContextListener
Create a concret version of the class above. It should return all modules needed for the application.
Modify web.xml
Now, prepare web.xml with the normal BlazeDS settings plus some extras for Guice.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app>
<display-name>Guice BlazeDS</display-name>
<description>Guice BlazeDS</description>
<listener>
<listener-class>flex.messaging.HttpFlexSession</listener-class>
</listener>
<listener>
<listener-class>com.connorgarvey.guiceblazeds.servlet.MyCustomGuiceServletContextListener</listener-class>
</listener>
<servlet>
<servlet-name>MessageBrokerServlet</servlet-name>
<display-name>MessageBrokerServlet</display-name>
<servlet-class>flex.messaging.MessageBrokerServlet</servlet-class>
<init-param>
<param-name>services.configuration.file</param-name>
<param-value>/WEB-INF/config/flex/services-config.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>MessageBrokerServlet</servlet-name>
<url-pattern>/messagebroker/*</url-pattern>
</servlet-mapping>
<welcome-file-list>
<welcome-file>index.html</welcome-file>
<welcome-file>index.htm</welcome-file>
</welcome-file-list>
</web-app>This way, BlazeDS will start at server startup, followed by Guice.
Modify BlazeDS config
Open services-config.xml and add this at the top of the file. Point it to the Guice factory.
<?xml version="1.0" encoding="UTF-8"?>
<services-config>
<factories>
<factory id="guice" class="com.connorgarvey.guiceblazeds.servlet.GuiceFactory" />
</factories>Set the factory of all remoting destinations
In remoting-config.xml, be sure to set the factory of all destinations to the name specified in services-config.xml above.
<destination id="SomeService">
<properties>
<factory>guice</factory>
<source>com.connorgarvey.guiceblazeds.service.flex.SomeFlexService</source>
</properties>
</destination>
How this all works
- When the server starts, BlazeDS and Guice are initialized by the servlet listeners.
- When BlazeDS receives a request, to a service, it’ll see that it’s supposed to retrieve it from the “guice” factory.
- The Guice factory will return an instance of the class specified in the source of the service configuration from Guice to BlazeDS for use in completing the request.
June 1st, 2009
As described in an earlier post, Android is not friendly to mocking frameworks or mock-style testing. If you want to test any class in your application that deals with the Android API, it’s best to run your tests through the emulator, accessing real Android classes. It’s unfortunate because you’re not just testing your application. You’re also testing Android. Anyway, here’s a way to mock a UI component.
If you’re just starting, here are a couple notes to keep you on the right track.
- Android is bundled with JUnit 3. Don’t try using an updated JUnit library or another testing framework. The Android jar doesn’t contain any functional code, so all test cases have to be run in the emulator, which uses JUnit 3. The test framework that will work best is in the Android API.
- If you need basic implementations of Android classes, try to avoid mocking them.
“Mock”ing
In my latest test, I needed a TextView so that I could call the simplest method, setText(String). I’ll describe how I got one.
Don’t bother with the android.test.mock package. It just contains implementations of classes that throw UnsupportedOperationExceptions. There isn’t anything there that I have yet found useful.
- In the test case, instead of extending TestCase, extend at InstrumentationTestCase or, if necessary, one of its subclasses. It’ll set up most of the stuff that’s available in an Activity and make it available to your test case.
public class AnAndroidTest extends InstrumentationTestCase {
- Create a mock implementation of TextView or the class you need.
public class MockTextView extends TextView {
public MockTextView(final Context context) {
super(context);
}
}
- The TextView constructor needs a real Context object because it will call methods on it. The context is difficult to mock because parts of it are private to Android. Since the Android JAR is just an API and doesn’t have any functional code, you couldn’t even see the methods if you tried. They only exist in the VM in the emulator. AFAIK, if you can’t see a method, you can’t mock it. That’s why your test case extends InstrumentationTestCase. Put this in it.
final TextView textView = new MockTextView(this.getInstrumentation().getContext());
Now write the test case. The text view is real and has a fully functional context, so the emulator will have everything it needs to support your test case.
May 30th, 2009
* I stand corrected. A commenter, Kiran Gunda, says it’s possible to mock f inal methods with JMockIt. I may have set the mock up incorrectly. If I try again, I’ll update this post. Until then, an updated post describes how I used Android test classes to run my code. Matt also pointed out that JMock can mock final methods using JDave’s unfinalizer.
* Updated July 11, 2009 to remove some incorrect information
So that you don’t have to read this whole post, I’ll sumarize what I discovered. If you’re thinking about using a mocking library to mock Android classes, don’t. Android uses interfaces sparsely. That makes a clean API with lots of reusable code, but makes mocking difficult. The real problem, though, is caused by Android’s generous use of final methods. I don’t know of any mocking library that can mock final methods, so you just can’t do it. Instead of writing mocks, look into the android.test and android.test.mock packages.
I developed GreenMileage so that I could learn about the Android OS. Now that I have an understanding of it, I decided to go back and write test cases so that I could continue development using TDD. I started by writing tests for utility classes. That wasn’t a problem. After finishing that, I moved to some simple UI cases. The first was TextViewCallbackListener. I just had to mock TextView.setText(String).
First, I spent hours just trying to get the JMock jars into the project. For some reason, the compiler would not put JMock into the APK. I didn’t get any error message or notification. It just wasn’t there.
I decided to use Android’s test mocks to run my code. Click here to see a simple example.
March 21st, 2009
Scroll down for the full source. Today, to execute code asynchronously in JavaFX, the background code must be written in Java. Ideally, your Java code will return JavaFX data types, keeping your FX code clean and helping you be prepared for the day when you won’t need Java.
This is how you can create and return JavaFX sequences from your Java code.
Set the return type of your method to com.sun.javafx.runtime.sequence.Sequence. Many of the com.sun.javafx classes seem to have been created for use in Java code.
@Override
public Sequence<String> call() throws Exception {In your code, use any type of collection class you like. It’s easiest to use List classes, though, because they can be directly converted.
List<String> names = Arrays.asList("Arthur", "Trillian", "Zaphod");Then, convert the list to a sequence using com.sun.javafx.runtime.sequence.Sequences and return it.
return Sequences.make(TypeInfo.getTypeInfo(String.class), names);
Here it is all together for impatient people like me.
@Override
public Sequence<String> call() {
List names = Arrays.asList("Arthur", "Trillian", "Zaphod");
return Sequences.make(TypeInfo.getTypeInfo(String.class), names);
}
March 14th, 2009
I’ve been working on a demonstration JavaFX application. It was originaly written for the prerelease candidate. I just updated it to work with JavaFX version 1.1 and thought I’d share it. This is a simple spinner that can be stopped and started. Here’s the full source. A description of how it works is below.
package org.mediabrowser;
import javafx.animation.KeyFrame;
import javafx.animation.Timeline;
import javafx.scene.CustomNode;
import javafx.scene.Group;
import javafx.scene.image.ImageView;
import javafx.scene.image.Image;
import javafx.scene.Node;
import javafx.scene.shape.Rectangle;
import javafx.scene.transform.Rotate;
/**
* A spinning icon, indicating the application is working
* @author Connor Garvey
* @created Oct 22, 2008, 8:12:48 PM
* @version 0.0.2
* @since 0.0.1
*/
public class Spinner extends CustomNode {
var rotation: Number = 0;
var timeline: Timeline = Timeline {
repeatCount: Timeline.INDEFINITE;
keyFrames: [
KeyFrame {
time: 50ms
action: tick
}
]
};
public override function create(): Node {
return Group {
content: [
ImageView {
image: Image {
url: "{__DIR__}resources/color_wheel.png"
}
transforms: Rotate {
pivotX: 8
pivotY: 8
angle: bind this.rotation
}
translateX: 3
translateY: 3
},
Rectangle {
width: 22
height: 22
}
]
};
}
public function start() {
this.timeline.play();
}
public function stop() {
this.timeline.stop();
}
function tick() {
this.rotation += 20;
if (this.rotation == 360) {
this.rotation = 0;
}
}
}
- First, the spinner extends CustomNode. That way, it can be placed anywhere in a UI.
- The timeline is used to rotate the spinner
- Since the application will be starting and stopping the spinner, set it to run forever, Timeline.INDEFINITE
- The spinner only does one thing, turn, so it only needs one key frame. It’s set to turn 20 degrees every 50ms.
- JavaFX will call create() to create instances of the spinner
- The __DIR__ makes the spinner image relative to the current class
- Since the image is 16×16, set the rotation pivot point to 8×8, the center of the image
- The angle of rotation is bound to a property of the class so that it can be easily modified
- When an image starts to rotate, it appears to shake because it’s not round. To smooth the rotation out, it’s transformed down and to the right and placed inside of a rectangle.
February 11th, 2009
Spring’s architecture isn’t very friendly to static classes and methods. It doesn’t have any way of injecting static properties of classes because it doesn’t have any way to discover them. Spring’s designers have acknowledged that it’s a shortcoming of the framework and suggest the use of this solution.
- Create the static property of the class without any annotations
- Mark the class to have static properties injected with @Component so that the properties will be injected on Spring startup
- Create a non-static setter method that sets the static property
- Mark the setter method with @Autowired(required = true)
@Component
public class UserUtils
{
private static UserAccessor userAccessor;
/**
* Sets the user DAO. This method should never be called except by Spring
* @param userAccessor The user accessor to set
*/
@Autowired(required = true)
public void setUserAccessor(userAccessor UserAccessor) {
UserUtils.userAccessor = userAccessor;
}
}Using this technique, you can have all of the advantages of Spring injection without the headaches of Spring injection! Avoid using this technique whenever possible. It should only be used to support legacy applications. With a lot of statically stored values, your application will not scale well.
January 31st, 2009
A lot of people have found this site by searching for an Android button tutorial, so here it is.
- This tutorial assumes that you already have an activity and are using an XML layout.
- Open the layout XML and add the button element. Assign an ID with the “@+id” operator. The + tells Android to generate an ID for this element so that you can reference it in your Java files.
- This is an example. Your layout and text elements will probably be very different. In this example case, the ID of the button is “close”.
<Button android:id="@+id/close"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:layout_alignParentBottom="true"
android:text="@string/title_close" />
- Open the activity class. Add a class property to hold a reference to the button.
- If you haven’t already, override the onCreate method.
@Override
protected void onCreate(Bundle savedInstanceState) {
}
- For this example, we don’t need the saved instance state, so ignore it.
- Now, in the onCreate method, attach a listener to the click event for the button. This example will call “finish()” on the activity, the Android analog of clicking the close button on a window.
protected void onCreate(Bundle savedInstanceState) {
this.setContentView(R.layout.layoutxml);
this.closeButton = (Button)this.findViewById(R.id.close);
this.closeButton.setOnClickListener(new OnClickListener() {
@Override
public void onClick(View v) {
finish();
}
});
}
- Here’s a short description of what’s happening.
- First, get the button ID. The ID created earlier in the layout, “close”, is compiled by Android and assigned a unique integer ID which is available to the application through the “R” class, which I assume is short for “Resources”.
- Request a reference to the button from the activity by calling “findViewById”. The button has to be retrieved from the activity because while an ID is unique in an activity, it is not unique among all activities.
- Assign the retrieved button to an instance variable so that if you need it later, you can easily find it without having to query for it again.
- Create a class implementing “OnClickListener” and set it as the on click listener for the button.
As UI elements go, buttons are some of the simplest. Later, I’ll write about menus and dialogs, which aren’t so easy.
January 30th, 2009
While working on a project that uses Hibernate, my team was getting a little frustrated while trying to interrogate a tree structure in our data model since all collections are mapped as java.util.HashSets. We wanted a simple function that could print the tree to the log, so I took a free hour and wrote this. It was a little more complicated than I anticipated because it had to handle situations like these.
root
|
|- child
|
|- child
root
|
|- child
|
|- child
and the infamous (to me) …
root
|
|- child
| |
| |- child
| |
| |- child
|
|- child
There’s a subtle difference. Notice that in the middle one, the line for the first child stops because there aren’t any more children, but in the last one, the line continues? I could have created some kind of 2D text buffer and gone back to draw the line, but that would be boring. Here’s what I came up with. I don’t know whether it’s pretty, but it works!
/**
* Creates a tree representation of the node
* @param node The node, which may not be null
* @return A string containing the formatted tree
*/
public static String toStringTree(Node node) {
final StringBuilder buffer = new StringBuilder();
return toStringTreeHelper(node, buffer, new LinkedList<Iterator<Node>>()).toString();
}
private static void toStringTreeDrawLines(List<Iterator<Node>> parentIterators, boolean amLast) {
StringBuilder result = new StringBuilder();
Iterator<Iterator<Node>> it = parentIterators.iterator();
while (it.hasNext()) {
Iterator<Node> anIt = it.next();
if (anIt.hasNext() || (!it.hasNext() && amLast)) {
result.append(" |");
}
else {
result.append(" ");
}
}
return result.toString();
}
private static StringBuilder toStringTreeHelper(Node node, StringBuilder buffer, List<Iterator<Node>>
parentIterators) {
if (!parentIterators.isEmpty()) {
boolean amLast = !parentIterators.get(parentIterators.size() - 1).hasNext();
buffer.append("\n");
String lines = toStringTreeDrawLines(parentIterators, amLast);
buffer.append(lines);
buffer.append("\n");
buffer.append(lines);
buffer.append("- ");
}
buffer.append(node.toString());
if (node.hasChildren()) {
Iterator<Node> it = node.getChildNodes().iterator();
parentIterators.add(it);
while (it.hasNext()) {
Node child = it.next();
toStringTreeHelper(child, buffer, parentIterators);
}
parentIterators.remove(it);
}
return buffer;
}
January 27th, 2009
I just started using Terracotta for the first time. This is how I put it in my project and configured Ant tasks to start and stop the server. The client is using Windows, so the Ant tasks work in Windows.
- Create tc-config.xml in the root of the project.
<?xml version="1.0" encoding="UTF-8"?>
<con:tc-config xmlns:con="http://www.terracotta.org/config">
<servers>
<server host="%i" name="localhost">
<dso-port>9510</dso-port>
<jmx-port>9520</jmx-port>
<data>bin/terracotta/server-data</data>
<logs>bin/terracotta/server-logs</logs>
<statistics>bin/terracotta/cluster-statistics</statistics>
</server>
<update-check>
<enabled>true</enabled>
</update-check>
</servers>
<clients>
<logs>bin/terracotta/client-logs</logs>
<statistics>bin/terracotta/client-statistics/%D</statistics>
<modules>
<module name="tim-hibernate-3.2.5" version="1.2.2"/>
<module name="tim-ehcache-1.3" version="1.2.2"/>
<module name="tim-cglib-2.1.3" version="1.2.2"/>
<module name="tim-ehcache-commons" version="1.2.2"/>
</modules>
</clients>
</con:tc-config>
- Put Terracotta into your library directory. You’ll need bin, docs, lib and schema directories and the license files.
- You don’t need the licenses for the software to work, but it’s always a good idea to include them, especially if your app is not open source 😛
- Create the Ant targets.
<target name="start.terracotta.windows">
<exec executable="cmd">
<arg value="/c"/>
<arg value="lib\terracotta-2.7.2\bin\start-tc-server.bat"/>
</exec>
</target>
<target name="stop.terracotta.windows">
<exec executable="cmd">
<arg value="/c"/>
<arg value="lib\terracotta-2.7.2\bin\stop-tc-server.bat"/>
</exec>
</target>
- Notice the backslashes there. Normally, Ant will convert forward slashes to backslashes in Windows. Since this is a command line argument, though, it doesn’t. If you’re running on both *nix and Windows, you’ll have to have two versions of the paths, one with forward and one with back slashes.
- That’s it. Run the start task to start and the stop task to stop.
January 18th, 2009
Many of Android’s screens use attractive dividers with gradients that fade from black to white to black. Here’s how to create one of your own.
1. Create a file called “black_white_gradient.xml” in /res/drawable. Paste this into it.
<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
android:shape="rectangle">
<gradient
android:startColor="#00000000"
android:centerColor="#FFFFFFFF"
android:endColor="#00000000"
android:angle="0" />
</shape>2. Create a view in the target layout and apply the gradient as the background. The “black_white_gradient” in “@drawable/black_white_gradient” refers to the file name of the shape above.
<View android:id="@+id/divider"
android:background="@drawable/black_white_gradient"
android:layout_width="fill_parent"
android:layout_height="1dp"
android:layout_below="@id/someOtherThing" />
