Create and package a controller

This task shows you how to:

See Also
Reference JSP in a controller
Installing a Development Environment

Create a controller

Before you begin: You must respect the following requirements:

  • Your class must be in a subpackage of package: com.exalead.cv360.searchui.view.widgets.controller. For example: com.exalead.cv360.searchui.view.widgets.controller.hello

  • There must be an @CustomComponent annotation.

  • The Spring Controller is a class annotated with the @Controller annotation.

Context:

Example of an "Hello World" controller:

package com.exalead.cv360.searchui.view.widgets.controller;
@CustomComponent(displayName="Hello World")
@Controller
public class HelloWorldController {
	@RequestMapping(value = "/helloWorld", method = { RequestMethod.GET })
	public void helloWorld(HttpServletRequest request, HttpServletResponse response) throws Exception {
		response.getWriter().print("Hello World!!");
	}
}

This Controller can then be reached at: http://<HOSTNAME>:<BASEPORT>/<context-name>/helloWorld

Package the controller in a custom Plugin

Before you begin: The Exalead CloudView Eclipse plugin must be installed.
  1. From the Package Explorer panel, right-click on the Controller class and select CloudView Mashup > Export to file.
  2. In the Mashup > Export plugin window, specify the name and destination of the plugin and click Finish.
  3. The plugin is packaged as .zip file and can be uploaded in Mashup Builder, in Application > Manage components > Plugins.
  4. Restart the search server.
    1. Go to Application > Developer area.
    2. Click Reload components
    3. Select the Restart search server processes option.
  5. Go to Application > Manage components > Controllers.

The new controller should be added to the list of controllers.

Package your controller manually in a jar

Before you begin: You can also package your controller manually in a jar but we strongly recommend to package your controller as a plugin.
  1. Right-click the controller class and select Export...
  2. In the Select window, expand the Java node and select JAR file.
  3. Click Next and in the Jar File Specification window:
    1. From Select the resources to export, select the class file to export.
    2. From Select the export destination, select where you want to export the JAR file.
    3. Select the Add directory entries option.
    4. Click Finish.
  4. Copy the exported jar in your <DATADIR>/webapps/360-mashup-ui/WEB-INF/lib/ folder.
  5. Open Mashup Builder and restart the search server.
    1. Go to Application > Developer area.
    2. Click Reload components.
    3. Select the Restart search server processes option.
  6. In your browser, open the mashup-ui page, for example, http://myhost:10000/mashup-ui/helloWorld.

The page should display Hello World!!