AMBARI-8617: Example property view to exercise config parameter options

ambari-views/examples/property-view/docs/index.md

@@ -0,0 +1,63 @@
+<!---
+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](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.
+-->
+
+Property View Example
+======
+
+Description
+-----
+The Property View is an example of a basic REST service that serves the configuration parameter values.
+It demonstrates the very basics of how to use the different options available with configuration
+parameters such as label, placeholder, default and description.
+
+Package
+-----
+All views are packaged as a view archive. The view archive contains the configuration
+file and various optional components of the view.
+
+#####view.xml
+
+The view.xml file is the only required file for a view archive.  The view.xml is the configuration that describes the view and view instances for Ambari.
+
+Build
+-----
+
+The view can be built as a maven project.
+
+    cd ambari-views/examples/property-view
+    mvn clean package
+
+The build will produce the view archive.
+
+    ambari-views/examples/property-view/target/property-view-0.1.0.jar
+
+Place the view archive on the Ambari Server and restart to deploy.    
+
+    cp property-view-0.1.0.jar /var/lib/ambari-server/resources/views/
+    ambari-server restart
+    
+Create View Instance
+-----
+
+With the view deployed, from the Ambari Administration interface,
+create an instance of the view (called PROPERTY_1) to be used by Ambari users.
+
+Access the view service end point:
+
+    /api/v1/views/PROPERTY/versions/0.1.0/instances/PROPERTY_1/resources/properties
+
+Access the view UI:
+
+    /views/PROPERTY/0.1.0/PROPERTY_1

ambari-views/examples/property-view/pom.xml

@@ -0,0 +1,96 @@
+<!--
+   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.
+-->
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+  <parent>
+    <groupId>org.apache.ambari</groupId>
+    <artifactId>ambari-view-examples</artifactId>
+    <version>1.0.0</version>
+  </parent>
+  <modelVersion>4.0.0</modelVersion>
+  <artifactId>property-view</artifactId>
+  <version>0.1.0</version>
+  <packaging>jar</packaging>
+  <name>Ambari Property View</name>
+  <url>http://maven.apache.org</url>
+  <properties>
+    <ambari.version>1.3.0-SNAPSHOT</ambari.version>
+  </properties>
+  <dependencies>
+    <dependency>
+      <groupId>org.apache.ambari</groupId>
+      <artifactId>ambari-views</artifactId>
+      <version>${ambari.version}</version>
+    </dependency>
+    <dependency>
+      <groupId>com.sun.jersey</groupId>
+      <artifactId>jersey-server</artifactId>
+      <version>1.8</version>
+    </dependency>
+    <dependency>
+      <groupId>javax.inject</groupId>
+      <artifactId>javax.inject</artifactId>
+      <version>1</version>
+    </dependency>
+  </dependencies>
+
+  <build>
+    <pluginManagement>
+      <plugins>
+        <plugin>
+          <groupId>org.apache.maven.plugins</groupId>
+          <artifactId>maven-surefire-plugin</artifactId>
+          <version>2.12</version>
+        </plugin>
+      </plugins>
+    </pluginManagement>
+    <plugins>
+        <plugin>
+        <groupId>org.codehaus.mojo</groupId>
+        <artifactId>rpm-maven-plugin</artifactId>
+        <version>2.0.1</version>
+        <executions>
+          <execution>
+            <phase>none</phase>
+            <goals>
+              <goal>rpm</goal>
+            </goals>
+          </execution>
+        </executions>
+      </plugin>
+    </plugins>
+    <resources>
+        <resource>
+            <directory>src/main/resources/ui/</directory>
+            <filtering>false</filtering>
+        </resource>
+        <resource>
+            <directory>src/main/resources/</directory>
+            <filtering>false</filtering>
+            <includes>
+                <include>view.xml</include>
+            </includes>
+        </resource>
+        <resource>
+            <targetPath>WEB-INF/lib</targetPath>
+            <filtering>false</filtering>
+            <directory>target/lib</directory>
+        </resource>
+    </resources>
+  </build>
+
+</project>

ambari-views/examples/property-view/src/main/java/org/apache/ambari/view/property/PropertyService.java

@@ -0,0 +1,83 @@
+/**
+ * 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 org.apache.ambari.view.property;
+
+import org.apache.ambari.view.ViewContext;
+
+import javax.inject.Inject;
+import javax.ws.rs.GET;
+import javax.ws.rs.POST;
+import javax.ws.rs.Path;
+import javax.ws.rs.PathParam;
+import javax.ws.rs.Produces;
+import javax.ws.rs.Consumes;
+import javax.ws.rs.core.Context;
+import javax.ws.rs.core.HttpHeaders;
+import javax.ws.rs.core.Response;
+import javax.ws.rs.core.UriInfo;
+import java.io.IOException;
+import java.util.Map;
+import java.util.Iterator;
+
+/**
+ * The Property service.
+ */
+public class PropertyService {
+
+  /**
+   * The view context.
+   */
+  @Inject
+  ViewContext context;
+  
+  /**
+   * Handles: GET /.
+   *
+   * @param headers   http headers
+   * @param ui        uri info
+   *
+   * @return value JSON representation
+   */
+  @GET
+  @Path("/")
+  @Produces({"text/plain", "application/json"})
+  public Response getValue(@Context HttpHeaders headers, @Context UriInfo ui) {
+
+    Map props = context.getProperties();;
+
+    Iterator it = props.entrySet().iterator();
+    StringBuffer buf = new StringBuffer();
+    boolean first = true;
+    buf.append("[");
+    while(it.hasNext()) {
+        Map.Entry pairs = (Map.Entry)it.next();
+        if (first == false)
+            buf.append(",\n");
+        buf.append("{\"");
+        buf.append(pairs.getKey());
+        buf.append("\" : \"");
+        buf.append(pairs.getValue());
+        buf.append("\"}");
+        first = false;
+    }
+    buf.append("]");
+
+    return Response.ok(buf.toString()).build();
+  }
+
+} // end PropertyService

ambari-views/examples/property-view/src/main/resources/ui/index.html

@@ -0,0 +1,63 @@
+<!--
+   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.
+-->
+<html>
+<head>
+    <style>
+        body{
+            text-align: center;
+            font-family: arial;
+        }
+        .button{
+            margin:20px;
+            font-size:16px;
+            font-weight: bold;
+            padding:5px 10px;
+        }
+    </style>
+</head>
+<body>
+    <h1>Property Service</h1>
+    <br />
+    <input type="button" value="Get Value" class="button" />
+    <br />
+    <span id="results"></span>
+
+    <script src="http://code.jquery.com/jquery-1.11.1.min.js"></script>
+
+    <script>
+      function _getPropertyResourceUri() {
+        var parts = window.location.pathname.match(/\/[^\/]*/g);
+        var view = parts[1];
+        var version = '/versions' + parts[2];
+        var instance = parts[3];
+        return '/api/v1/views' + view + version + '/instances' + instance+'/resources/properties';
+      }
+        $(document).ready(function() {
+            $('.button').click(function(){
+                $.ajax({
+                    url: _getPropertyResourceUri(),
+                    dataType: "text",
+                    success: function(data) {
+                        $('#results').html(data);
+                    }
+                });
+            });
+        });
+    </script>
+
+</body>
+</html>

ambari-views/examples/property-view/src/main/resources/view.xml

@@ -0,0 +1,65 @@
+<!--
+   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.
+-->
+<view>
+  <name>PROPERTY</name>
+  <label>Property</label>
+  <version>0.1.0</version>
+  <parameter>
+    <name>name.description</name>
+    <description>Name and description</description>
+    <required>true</required>
+  </parameter>
+  <parameter>
+    <name>name.label.description</name>
+    <description>Name, label and description</description>
+    <label>NameLabelDesc</label>
+    <required>true</required>
+  </parameter>
+  <parameter>
+    <name>name.label.descr.default</name>
+    <description>Name, label, description and default</description>
+    <label>NameLabelDescDefault</label>
+    <default-value>thedefaultvalue</default-value>
+    <required>true</required>
+  </parameter>
+  <parameter>
+    <name>name.label.descr.default.place</name>
+    <description>Name, label, description, default and placeholder</description>
+    <label>NameLabelDescDefaultPlace</label>
+    <placeholder>this is placeholder text but you should see default</placeholder>
+    <default-value>youshouldseethisdefault</default-value>
+    <required>true</required>
+  </parameter>
+  <parameter>
+    <name>name.label.descr.place</name>
+    <description>Name, label,  description and placeholder</description>
+    <label>NameLabelDescPlace</label>
+    <placeholder>this is some placeholder text</placeholder>
+    <required>true</required>
+  </parameter>
+  <parameter>
+    <name>name.descr.place</name>
+    <description>Name, description and placeholder</description>
+    <placeholder>this is the placeholder name.descr.place text</placeholder>
+    <required>true</required>
+  </parameter>
+  
+  <resource>
+    <name>properties</name>
+    <service-class>org.apache.ambari.view.property.PropertyService</service-class>
+  </resource>
+</view>