package com.wordpress.jdevel.ws;
import java.io.File;
import java.io.FileFilter;
import java.io.FilenameFilter;
import java.util.ArrayList;
import java.util.List;
import javax.jws.WebService;
import javax.jws.WebMethod;
import javax.jws.WebParam;
@WebService(serviceName = "Music")
public class Music {
private static final File FOLDER = new File("D:/TEMP/SONGS");
@WebMethod(operationName = "listSongs")
public Song[] listSongs(@WebParam(name = "artist") String artist) {
List<Song> songs = new ArrayList<Song>();
System.out.println("ARTIST: " + artist);
if (artist != null) {
File folder = new File(FOLDER, artist);
if (folder.exists() && folder.isDirectory()) {
File[] listFiles = folder.listFiles(new FilenameFilter() {
public boolean accept(File dir, String name) {
return name.toUpperCase().endsWith(".MP3");
}
});
for (File file : listFiles) {
String fileName = file.getName();
String author = file.getParentFile().getName();
int size = (int) (file.length() / 1048576); //Megabytes
Song song = new Song(fileName, author, size);
songs.add(song);
}
}
}
return songs.toArray(new Song[songs.size()]);
}
@WebMethod(operationName = "listArtists")
public String[] listArtists() {
File[] folders = getFolders(FOLDER);
List<String> artists = new ArrayList<String>(folders.length);
for (File folder : folders) {
artists.add(folder.getName());
}
return artists.toArray(new String[artists.size()]);
}
private File[] getFolders(File parent) {
FileFilter filter = new FileFilter() {
public boolean accept(File pathname) {
return pathname.isDirectory();
}
};
File[] folders = parent.listFiles(filter);
return folders;
}
public static void main(String[] args) {
Music listFiles = new Music();
String[] artists = listFiles.listArtists();
System.out.println("Artists: " + artists);
for (String artist : artists) {
Song[] listSongs = listFiles.listSongs(artist);
for (Song song : listSongs) {
System.out.println(song.getArtist() + " : " + song.getFileName() + " : " + song.getSize() + "MB");
}
}
}
}
Needed also a simple bean to get some more complex types:
package com.wordpress.jdevel.ws;
import java.io.Serializable;
public class Song implements Serializable {
String fileName;
String artist;
int size;
public Song() {
}
public Song(String fileName, String artist, int size) {
this.fileName = fileName;
this.artist = artist;
this.size = size;
}
public String getArtist() {
return artist;
}
public void setArtist(String artist) {
this.artist = artist;
}
public String getFileName() {
return fileName;
}
public void setFileName(String fileName) {
this.fileName = fileName;
}
public int getSize() {
return size;
}
public void setSize(int size) {
this.size = size;
}
}
To make it a web service all you have to do is annotate class with @WebService(serviceName = “Music”) and every method you want to expose as web service operation has to be marked with @WebMethod(operationName = “listArtists”).
This should be all if you’re deploying it on GlassFish, but I’ve used Tomcat, so 3 more steps were needed:
1. Add Metro 2.0 jars to WEB-INF/lib
2. Add Metro servlet and listener to web.xml:
<listener> <listener-class> com.sun.xml.ws.transport.http.servlet.WSServletContextListener </listener-class> </listener> <servlet> <servlet-name>Music</servlet-name> <servlet-class>com.sun.xml.ws.transport.http.servlet.WSServlet</servlet-class> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>Music</servlet-name> <url-pattern>/Music</url-pattern> </servlet-mapping>
You probably shouldn’t change anything here. Just paste it to your web.xml in web-app node.
3. Add sun-jaxws.xml file to WEB-INF with endpoint declaration:
<?xml version="1.0" encoding="UTF-8"?> <endpoints version="2.0" xmlns="http://java.sun.com/xml/ns/jax-ws/ri/runtime"> <endpoint implementation="com.wordpress.jdevel.ws.Music" name="Music" url-pattern="/Music"/> </endpoints>
- implementation has to match your @WebService class
- name has to match serviceName in @WebService annotation
- url-pattern has to match url-pattern you have declared in servlet mapping
There should also be no need to edit these xml files if you create it in NetBeans.
Now start Tomcat and deploy your app. You should be able to access your service via something like
http://localhost:8080/WSServer/Music
Related Article:
Reference: Web Services in Ruby, Python and Java from our JCG partner at the “Development world stories” blog
