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,18 +63,19 @@ 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;',
         'while ! test -f .buckconfig; do cd ..; done;',
         'javadoc',
         'javadoc',
+        '-tag onos.rsModel:a:"onos model"',
         '-quiet',
         '-quiet',
         '-protected',
         '-protected',
         '-encoding UTF-8',
         '-encoding UTF-8',
         '-charset UTF-8',
         '-charset UTF-8',
         '-notimestamp',
         '-notimestamp',
         '-windowtitle "' + title + '"',
         '-windowtitle "' + title + '"',
-      '-link http://docs.oracle.com/javase/7/docs/api',
+        '-link http://docs.oracle.com/javase/8/docs/api',
         '-subpackages ',
         '-subpackages ',
         ':'.join(pkgs),
         ':'.join(pkgs),
         '-sourcepath ',
         '-sourcepath ',
@@ -80,7 +83,11 @@ def java_doc(
         ' -classpath ',
         ' -classpath ',
         ':'.join(['$(classpath %s)' % n for n in deps]),
         ':'.join(['$(classpath %s)' % n for n in deps]),
         '-d $TMP',
         '-d $TMP',
-    ]) + ';jar cf $OUT -C $TMP .',
+      ]) + ';jar cf $OUT -C $TMP .'
+
+    genrule(
+      name = name,
+      cmd = cmd,
       srcs = srcs,
       srcs = srcs,
       out = name + '.jar',
       out = name + '.jar',
       visibility = visibility,
       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,
+    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',