Top level build of component Javadocs

Change-Id: Iceb2a7c84b3dd0b354b27f93a0f746913cd9b778

@@ -46,6 +46,8 @@ def checkstyle(
                 test_rule_timeout_ms = 20000,
                 test_rule_timeout_ms = 20000,
                 labels = [ 'checkstyle' ],
                 labels = [ 'checkstyle' ],
         )
         )
+    else:
+        print 'Not generating checkstyle rule for %s because there are no sources.' % name
 
 
 def java_doc(
 def java_doc(
     name,
     name,
@@ -61,29 +63,34 @@ def java_doc(
     sourcepath = paths
     sourcepath = paths
   else:
   else:
     sourcepath = ['$SRCDIR/' + n for n in paths]
     sourcepath = ['$SRCDIR/' + n for n in paths]
-  genrule(
-    name = name,
+
+  if len(srcs) != 0:
     cmd = ' '.join([
     cmd = ' '.join([
-      'while ! test -f .buckconfig; do cd ..; done;',
-      'javadoc',
-      '-quiet',
-      '-protected',
-      '-encoding UTF-8',
-      '-charset UTF-8',
-      '-notimestamp',
-      '-windowtitle "' + title + '"',
-      '-link http://docs.oracle.com/javase/7/docs/api',
-      '-subpackages ',
-      ':'.join(pkgs),
-      '-sourcepath ',
-      ':'.join(sourcepath),
-      ' -classpath ',
-      ':'.join(['$(classpath %s)' % n for n in deps]),
-      '-d $TMP',
-    ]) + ';jar cf $OUT -C $TMP .',
-    srcs = srcs,
-    out = name + '.jar',
-    visibility = visibility,
+        'while ! test -f .buckconfig; do cd ..; done;',
+        'javadoc',
+        '-tag onos.rsModel:a:"onos model"',
+        '-quiet',
+        '-protected',
+        '-encoding UTF-8',
+        '-charset UTF-8',
+        '-notimestamp',
+        '-windowtitle "' + title + '"',
+        '-link http://docs.oracle.com/javase/8/docs/api',
+        '-subpackages ',
+        ':'.join(pkgs),
+        '-sourcepath ',
+        ':'.join(sourcepath),
+        ' -classpath ',
+        ':'.join(['$(classpath %s)' % n for n in deps]),
+        '-d $TMP',
+      ]) + ';jar cf $OUT -C $TMP .'
+
+    genrule(
+      name = name,
+      cmd = cmd,
+      srcs = srcs,
+      out = name + '.jar',
+      visibility = visibility,
 )
 )
 
 
 
 
@@ -99,6 +106,7 @@ def osgi_jar(
     debug = False,
     debug = False,
     import_packages = '*',
     import_packages = '*',
     export_packages = '*',
     export_packages = '*',
+    package_name_root = 'org.onosproject',
     include_resources = NONE,
     include_resources = NONE,
     web_context = NONE,
     web_context = NONE,
     resources = NONE,
     resources = NONE,
@@ -187,7 +195,7 @@ def osgi_jar(
   java_doc(
   java_doc(
        name = name + '-javadoc',
        name = name + '-javadoc',
        title = 'Java Docs',
        title = 'Java Docs',
-       pkgs = [ 'org.onosproject' ],
+       pkgs = [ package_name_root ],
        paths = [ 'src/main/java' ],
        paths = [ 'src/main/java' ],
        srcs = srcs,
        srcs = srcs,
        deps = deps,
        deps = deps,
@@ -253,6 +261,9 @@ def osgi_jar_with_tests(
   if test_srcs is None:
   if test_srcs is None:
       test_srcs = glob([TEST + '/*.java'])
       test_srcs = glob([TEST + '/*.java'])
 
 
+  if not test_srcs:
+          print "Generating test rule for %s, but there are no tests." % name
+
   java_test(
   java_test(
     name = name + '-tests',
     name = name + '-tests',
     srcs = test_srcs,
     srcs = test_srcs,
@@ -272,6 +283,3 @@ def osgi_jar_with_tests(
   )
   )
 
 
   #FIXME need to run checkstyle on test sources
   #FIXME need to run checkstyle on test sources
-
-
-

+#!/bin/bash
+# -----------------------------------------------------------------------------
+# Builds the ONOS Java API docs with buck.
+# -----------------------------------------------------------------------------
+
+set -e
+
+[ ! -d "$ONOS_ROOT" ] && echo "ONOS_ROOT is not defined" >&2 && exit 1
+. $ONOS_ROOT/tools/build/envDefaults
+
+onos-buck build  `onos-buck query "filter('.*-javadoc', '//...')"`
+

@@ -20,6 +20,7 @@ osgi_jar(
     visibility = ['PUBLIC'],
     visibility = ['PUBLIC'],
     resources_root = 'src/main/resources',
     resources_root = 'src/main/resources',
     resources = glob(['src/main/resources/**']),
     resources = glob(['src/main/resources/**']),
+    package_name_root = 'org.onlab',
 )
 )
 
 
 java_test(
 java_test(

@@ -16,6 +16,7 @@ osgi_jar(
     srcs = glob([SRC + '/*.java']),
     srcs = glob([SRC + '/*.java']),
     deps = COMPILE_DEPS,
     deps = COMPILE_DEPS,
     visibility = ['PUBLIC'],
     visibility = ['PUBLIC'],
+    package_name_root = 'org.onlab',
 )
 )
 
 
 java_test(
 java_test(

@@ -16,6 +16,7 @@ osgi_jar(
   srcs = glob([SRC + '/*.java']),
   srcs = glob([SRC + '/*.java']),
   deps = COMPILE_DEPS,
   deps = COMPILE_DEPS,
   visibility = ['PUBLIC'],
   visibility = ['PUBLIC'],
+  package_name_root = 'org.onlab',
 )
 )
 
 
 java_test(
 java_test(

@@ -9,4 +9,5 @@ COMPILE_DEPS = [
 osgi_jar_with_tests (
 osgi_jar_with_tests (
     name = 'onlab-rest',
     name = 'onlab-rest',
     deps = COMPILE_DEPS,
     deps = COMPILE_DEPS,
-)
\ No newline at end of file
+    package_name_root = 'org.onlab',
+)

@@ -7,6 +7,7 @@ COMPILE_DEPS = [
     '//lib:jersey-media-multipart',
     '//lib:jersey-media-multipart',
     '//lib:org.apache.karaf.shell.console',
     '//lib:org.apache.karaf.shell.console',
     '//cli:onos-cli',
     '//cli:onos-cli',
+    '//lib:jersey-server',
     '//incubator/api:onos-incubator-api',
     '//incubator/api:onos-incubator-api',
     '//incubator/net:onos-incubator-net',
     '//incubator/net:onos-incubator-net',
     '//utils/rest:onlab-rest',
     '//utils/rest:onlab-rest',