VirtualBox

source: vbox/trunk/src/VBox/Main/webservice/Makefile.kmk@ 22295

Last change on this file since 22295 was 21730, checked in by vboxsync, 15 years ago

SDK: make documentation match reality, minor refactoring

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 26.7 KB
Line 
1# $Id: Makefile.kmk 21730 2009-07-20 16:48:08Z vboxsync $
2## @file
3# Sub-Makefile for the VBox web service.
4#
5# Warning! This is a seriously complicated makefile!
6#
7
8#
9# Copyright (C) 2006-2007 Sun Microsystems, Inc.
10#
11# This file is part of VirtualBox Open Source Edition (OSE), as
12# available from http://www.virtualbox.org. This file is free software;
13# you can redistribute it and/or modify it under the terms of the GNU
14# General Public License (GPL) as published by the Free Software
15# Foundation, in version 2 as it comes in the "COPYING" file of the
16# VirtualBox OSE distribution. VirtualBox OSE is distributed in the
17# hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
18#
19# Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
20# Clara, CA 95054 USA or visit http://www.sun.com if you need
21# additional information or have any questions.
22#
23
24# Define VBOX_GSOAP_INSTALLED to something if you have gSOAP's
25# "wsdl2h" and "soapcpp2" executables on your PATH somewhere.
26
27#
28# Here's a temporary outline how all this works.
29
30# 1) We use xsltproc and websrv-wsdl.xsl to generate a WSDL file from
31# our XML IDL file (../idl/VirtualBox.xidl). This WSDL describes the
32# web service to third-party clients; for example, one can feed it to
33# perl and thus easily write a short script that connects to the web
34# service properly.
35# This WSDL file ends up in $(VBOXWEB_OUT_DIR)/vboxweb.wsdl.
36#
37# 2) We use xsltproc and websrv-gsoapH.xsl to generate a gSoap header
38# file: $(VBOXWEB_OUT_DIR)/gsoapH_from_xslt.h.
39# This file looks like a C header file, but really isn't meant
40# to be included by a C compiler. Instead, it just happens to be the
41# format that gSOAP uses to specify SOAP interfaces instead of WSDL
42# (apparently because gSOAP was written before the advent of WSDL).
43#
44# Note that gSOAP comes with its own WSDL-to-gsoap.h converter, but
45# the readme mentions some funny license restrictions, so instead we
46# have our own converter in XSLT.
47#
48# 3) We then feed that header file to gsoap's soapcpp2, which generates
49# a ton of files in $(VBOXWEB_OUT_DIR), most importantly:
50#
51# SOAP_CLIENT_H = $(VBOXWEB_OUT_DIR)/soapStub.h (header file for webservice clients)
52# SOAP_SERVER_H = $(VBOXWEB_OUT_DIR)/soapH.h (header file for webservice servers)
53#
54# These are "real" header files that one can use to program a) a webservice client
55# and b) a webservice server. Of course to build b) one will have to write method
56# implementations with useful code that does something. This is where more
57# code generation via XSLT comes in:
58#
59# 4) We use xsltproc to generate tons of c++ code directly from the XIDL that
60# maps each soap method to our COM methods. This large c++ file is
61# $(VBOXWEB_OUT_DIR)/methodmaps.cpp. The actual webservice executable (vboxwebsrv,
62# which acts as an http server) is composed of this file, plus hard-coded
63# method implementations in vboxweb.cpp, plus gSOAP library code for the HTTP
64# server.
65#
66
67SUB_DEPTH = ../../../..
68include $(KBUILD_PATH)/subheader.kmk
69
70#
71# Find the gSOAP toolkit.
72#
73# Note! We're not using the gSOAP toolkit correctly. The main issue is that
74# compiling soapcpp2.cpp instead of using the library. So, in order
75# to make this work with a locally installed gSOAP toolkit there are
76# some hoops to jump thru to say the least... Shipping soapcpp2.cpp/h
77# is out of the question without also including the two soap tools.
78#
79# Some observations on distros for OSE / configure:
80# The proposed gentoo ebuild screws up several things in the install phase
81# and thus fails to ship stdsoap2.cpp and relatives.
82#
83# debian (2.7.9l-0.2) stuffs stdsoap2.cpp and a handful of the import files
84# into /usr/include/gsoap.
85#
86# fedora (2.7.12-fc10.x86_64) uses the default install layout and does not
87# ship stdsoap2.cpp and friends.
88#
89ifeq ($(VBOX_GSOAP_INSTALLED),)
90 VBOX_GSOAP_INSTALLED = 1
91 VBOX_PATH_GSOAP := $(lastword $(sort $(wildcard $(KBUILD_DEVTOOLS)/common/gsoap/*)))
92 ifeq ($(VBOX_PATH_GSOAP),)
93 VBOX_PATH_GSOAP := $(lastword $(sort $(wildcard $(KBUILD_DEVTOOLS_HST)/gsoap/*)))
94 endif
95 if "$(VBOX_PATH_GSOAP)" == "" && defined(KBUILD_DEVTOOLS_HST)
96 VBOX_PATH_GSOAP := $(lastword $(sort $(wildcard $(KBUILD_DEVTOOLS_HST_ALT)/gsoap/*)))
97 endif
98 ifeq ($(VBOX_PATH_GSOAP),)
99 $(warning VBOX_PATH_GSOAP not found...)
100 VBOX_GSOAP_INSTALLED =
101 endif
102else
103 VBOX_PATH_GSOAP := $(VBOX_PATH_GSOAP)
104endif
105VBOX_PATH_GSOAP_BIN := $(strip $(VBOX_PATH_GSOAP_BIN))
106if "$(VBOX_PATH_GSOAP_BIN)" == ""
107 VBOX_PATH_GSOAP_BIN := $(VBOX_PATH_GSOAP)/bin
108 if "$(KBUILD_HOST)" == "darwin"
109 VBOX_PATH_GSOAP_BIN := $(VBOX_PATH_GSOAP_BIN)/macosx
110 else if "$(KBUILD_HOST)" == "win"
111 VBOX_PATH_GSOAP_BIN := $(VBOX_PATH_GSOAP_BIN)/win32
112 else if "$(KBUILD_HOST)" == "linux"
113 VBOX_PATH_GSOAP_BIN := $(VBOX_PATH_GSOAP_BIN)/linux386
114 else
115 VBOX_PATH_GSOAP_BIN := $(VBOX_PATH_GSOAP_BIN)/$(KBUILD_HOST).x86
116 endif
117 if !exists($(VBOX_PATH_GSOAP_BIN))
118 VBOX_PATH_GSOAP_BIN := $(VBOX_PATH_GSOAP)/bin
119 endif
120endif
121VBOX_SOAPCPP2 := $(VBOX_PATH_GSOAP_BIN)/soapcpp2$(HOSTSUFF_EXE)
122VBOX_WSDL2H := $(VBOX_PATH_GSOAP_BIN)/wsdl2h$(HOSTSUFF_EXE)
123VBOX_STUBMAKER = $(firstword $(which stubmaker stubmaker.pl) stubmaker_not_found)
124VBOX_WSDL2PY = $(firstword $(which wsdl2py) wsdl2py_not_found)
125
126VBOX_PATH_GSOAP_IMPORT := $(strip $(if $(VBOX_PATH_GSOAP_IMPORT),$(VBOX_PATH_GSOAP_IMPORT),$(VBOX_PATH_GSOAP)/import))
127VBOX_GSOAP_INCS := $(strip $(if $(VBOX_GSOAP_INCS),$(VBOX_GSOAP_INCS),$(VBOX_PATH_GSOAP) $(VBOX_PATH_GSOAP_IMPORT) ))
128# note: $(if $(defined FOO)) does not work here!
129VBOX_GSOAP_CXX_SOURCES := $(strip $(if-expr "$(origin VBOX_GSOAP_CXX_SOURCES)" != "undefined",$(VBOX_GSOAP_CXX_SOURCES),$(VBOX_PATH_GSOAP)/stdsoap2.cpp))
130VBOX_GSOAP_CXX_LIBS := $(strip $(if-expr "$(origin VBOX_GSOAP_CXX_LIBS)" != "undefined",$(VBOX_GSOAP_CXX_LIBS),))
131
132
133#
134# Globals
135#
136VBOXWEB_OUT_DIR := $(PATH_TARGET)/webservice
137BLDDIRS += $(VBOXWEB_OUT_DIR)
138
139# The webservice location
140VBOX_PATH_WEBSERVICE := $(PATH_SUB_CURRENT)
141
142# If this is set, all webservice files are considered out-of-date every time
143# this make file is touched. Otherwise, set this to empty.
144RECOMPILE_ON_MAKEFILE_CURRENT := $(MAKEFILE_CURRENT)
145
146PATH_TARGET_SOAPDEMOXML := $(VBOXWEB_OUT_DIR)/demo_soapxml
147PATH_TARGET_SOAPDEMOHEADERS := $(VBOXWEB_OUT_DIR)/demo_headers
148PATH_TARGET_SOAPDEMONSMAPS := $(VBOXWEB_OUT_DIR)/demo_namespacemaps
149PATH_TARGET_WEBTEST := $(VBOXWEB_OUT_DIR)/webtest
150
151VBOXWEB_IDL_SRC_ORIG := $(VBOX_XIDL_FILE)
152VBOXWEB_IDL_SRC := $(VBOXWEB_OUT_DIR)/VirtualBox.xidl
153
154VBOXWEB_TYPEMAP := $(VBOXWEB_OUT_DIR)/typemap.dat
155
156VBOXWEB_GSOAPH_FROM_XSLT := $(VBOXWEB_OUT_DIR)/gsoapH_from_xslt.h
157ifdef VBOX_GSOAP_INSTALLED
158 VBOXWEB_GSOAPH_FROM_GSOAP := $(VBOXWEB_OUT_DIR)/gsoapH_from_gsoap.h
159else
160 VBOXWEB_GSOAPH_FROM_GSOAP :=
161endif
162VBOXWEB_SOAP_CLIENT_H := $(VBOXWEB_OUT_DIR)/soapStub.h
163VBOXWEB_SOAP_SERVER_H := $(VBOXWEB_OUT_DIR)/soapH.h
164
165
166ifdef VBOX_GSOAP_VERBOSE
167 VBOXWEB_XSLTPROC_VERBOSE = --stringparam G_argDebug '1'
168 VBOXWEB_WSDL_VERBOSE = -v
169else
170 VBOXWEB_SOAPCPP2_SKIP_FILES = -x
171endif
172
173
174## @todo VBOXWEB_GSOAPH_FROM_XSLT should probably be a indirect dep of something.
175VBOXWEB_OTHERS += \
176 $(VBOXWEB_GSOAPH_FROM_XSLT)
177
178
179
180ifdef VBOX_GSOAP_INSTALLED
181 ifndef VBOX_ONLY_SDK
182 #
183 # vboxsoap - Library used by both the programs (save build time).
184 #
185 LIBRARIES += vboxsoap
186 vboxsoap_TEMPLATE = VBOXR3EXE
187 ifdef VBOX_USE_VCC80
188 vboxsoap_CXXFLAGS.win += -bigobj
189 endif
190 vboxsoap_INCS := \
191 $(VBOX_GSOAP_INCS) \
192 $(VBOXWEB_OUT_DIR) \
193 $(PATH_SUB_CURRENT)
194 ifdef VBOX_WITHOUT_SPLIT_SOAPC
195 vboxsoap_SOURCES = \
196 $(VBOXWEB_OUT_DIR)/soapC.cpp
197 else
198 vboxsoap_SOURCES = \
199 $(VBOXWEB_OUT_DIR)/soapC-1.cpp \
200 $(VBOXWEB_OUT_DIR)/soapC-2.cpp \
201 $(VBOXWEB_OUT_DIR)/soapC-3.cpp \
202 $(VBOXWEB_OUT_DIR)/soapC-4.cpp \
203 $(VBOXWEB_OUT_DIR)/soapC-5.cpp \
204 $(VBOXWEB_OUT_DIR)/soapC-6.cpp \
205 $(VBOXWEB_OUT_DIR)/soapC-7.cpp \
206 $(VBOXWEB_OUT_DIR)/soapC-8.cpp \
207 $(VBOXWEB_OUT_DIR)/soapC-9.cpp \
208 $(VBOXWEB_OUT_DIR)/soapC-10.cpp \
209 $(VBOXWEB_OUT_DIR)/soapC-11.cpp \
210 $(VBOXWEB_OUT_DIR)/soapC-12.cpp \
211 $(VBOXWEB_OUT_DIR)/soapC-13.cpp \
212 $(VBOXWEB_OUT_DIR)/soapC-14.cpp \
213 $(VBOXWEB_OUT_DIR)/soapC-15.cpp \
214 $(VBOXWEB_OUT_DIR)/soapC-16.cpp \
215 $(VBOXWEB_OUT_DIR)/soapC-17.cpp \
216 $(VBOXWEB_OUT_DIR)/soapC-18.cpp \
217 $(VBOXWEB_OUT_DIR)/soapC-19.cpp \
218 $(VBOXWEB_OUT_DIR)/soapC-20.cpp
219 endif
220 vboxsoap_CLEAN := $(vboxsoap_SOURCES) # lazy bird
221 vboxsoap_SOURCES += \
222 $(VBOX_GSOAP_CXX_SOURCES)
223 vboxsoap_ORDERDEPS = \
224 $(VBOXWEB_IDL_SRC) \
225 $(VBOXWEB_OUT_DIR)/gsoap_copy_all_ts
226
227ifdef VBOX_SOAP_PRECOMPILED_HEADER
228 # This'll save a few seconds, but the compiler invocation currently makes it impracticable. This will
229 # be addressed in a future kBuild version, by adding PCH support or/and by adding some helpers to
230 # gather the required data (DEFS,INCS,CXXTOOL,CXXFLAGS).
231 vboxsoap_INTERMEDIATES += $(VBOXWEB_OUT_DIR)/soapH.h.gch
232 vboxsoap_CXXFLAGS += -Winvalid-pch -H
233 vboxsoap_CLEAN += $(VBOXWEB_OUT_DIR)/soapH.h.gch
234
235$(VBOXWEB_OUT_DIR)/soapH.h.gch: $(VBOXWEB_OUT_DIR)/soapH.h
236 g++ -x c++-header -g -g -Wall -pedantic -Wno-long-long -Wno-trigraphs -Wno-variadic-macros -pipe -O0 -fno-omit-frame-pointer -fno-strict-aliasing -fvisibility-inlines-hidden -fvisibility=hidden -DVBOX_HAVE_VISIBILITY_HIDDEN -mmacosx-version-min=10.4 -isysroot /Developer/SDKs/MacOSX10.4u.sdk -m32 -I/Volumes/ScratchHFS/bird/vbox/svn/trunk/src/VBox/Main/webservice/gsoap -I/Volumes/ScratchHFS/bird/vbox/svn/trunk/out/darwin.x86/debug/obj/src/VBox/Main -I/Volumes/ScratchHFS/bird/vbox/svn/trunk/src/VBox/Main/webservice -I/Volumes/ScratchHFS/bird/vbox/svn/trunk/include -I/Volumes/ScratchHFS/bird/vbox/svn/trunk/out/darwin.x86/debug -DVBOX -DVBOX_WITH_DEBUGGER -DVBOX_WITH_DEBUGGER_GUI -DDEBUG -DDEBUG_bird -DDEBUG_USERNAME=bird -DRT_OS_DARWIN -D__DARWIN__ -DRT_ARCH_X86 -D__X86__ -DVBOX_WITH_HYBRID_32BIT_KERNEL -DIN_RING3 -DHC_ARCH_BITS=32 -DGC_ARCH_BITS=32 -DMAC_OS_X_VERSION_MIN_REQUIRED=1040 -DMAC_OS_X_VERSION_MAX_ALLOWED=1040 \
237 $< -o $@
238endif
239 endif # !VBOX_ONLY_SDK
240
241
242 ifndef VBOX_ONLY_SDK
243 #
244 # vboxwebsrv - webservice server process
245 #
246 PROGRAMS += vboxwebsrv
247 vboxwebsrv_TEMPLATE = VBOXMAINCLIENTEXE
248 vboxwebsrv_DEFS += SOCKET_CLOSE_ON_EXEC
249 vboxwebsrv_INCS = \
250 $(VBOX_GSOAP_INCS) \
251 $(VBOXWEB_OUT_DIR) \
252 .
253 ifdef VBOX_USE_VCC80
254 vboxwebsrv_CXXFLAGS.win += -bigobj
255 endif
256 vboxwebsrv_LIBS += \
257 $(PATH_LIB)/vboxsoap$(VBOX_SUFF_LIB) \
258 $(VBOX_GSOAP_CXX_LIBS)
259 vboxwebsrv_LIBS.solaris += socket nsl
260 vboxwebsrv_SOURCES = \
261 vboxweb.cpp \
262 $(VBOXWEB_OUT_DIR)/methodmaps.cpp \
263 $(VBOXWEB_OUT_DIR)/soapServer.cpp
264 vboxwebsrv_CLEAN = \
265 $(VBOXWEB_OUT_DIR)/methodmaps.cpp \
266 $(VBOXWEB_OUT_DIR)/soapServer.cpp
267
268 vboxwebsrv_ORDERDEPS = $(VBOXWEB_OUT_DIR)/gsoap_copy_all_ts
269 endif # !VBOX_ONLY_SDK
270
271
272 ifndef VBOX_ONLY_SDK
273 #
274 # webtest - webservice sample client in C++
275 #
276 PROGRAMS += webtest
277 webtest_TEMPLATE = VBOXR3EXE
278 ifdef VBOX_USE_VCC80
279 webtest_CXXFLAGS.win += -bigobj
280 endif
281 webtest_INCS := \
282 $(VBOX_GSOAP_INCS) \
283 $(VBOXWEB_OUT_DIR) \
284 .
285 webtest_LIBS += \
286 $(PATH_LIB)/vboxsoap$(VBOX_SUFF_LIB) \
287 $(VBOX_GSOAP_CXX_LIBS)
288 webtest_LIBS.solaris += nsl
289 webtest_SOURCES = \
290 webtest.cpp \
291 $(VBOXWEB_OUT_DIR)/soapClient.cpp
292 webtest_CLEAN = \
293 $(VBOXWEB_OUT_DIR)/soapClient.cpp
294
295 webtest_ORDERDEPS = $(VBOXWEB_OUT_DIR)/gsoap_copy_all_ts
296 endif # !VBOX_ONLY_SDK
297
298
299 #
300 # Additional mess to cleanup (applies to both webtest and vboxwebsrv).
301 #
302 ## @todo figure out whether the SDK really needs this or not...
303 OTHER_CLEAN += \
304 $(wildcard $(VBOXWEB_OUT_DIR)/soap*.h) \
305 $(wildcard $(VBOXWEB_OUT_DIR)/soap*.cpp) \
306 $(wildcard $(VBOXWEB_OUT_DIR)/*.nsmap) \
307 $(VBOXWEB_GSOAPH_FROM_XSLT) \
308 $(VBOXWEB_GSOAPH_FROM_GSOAP) \
309 $(VBOXWEB_SOAP_CLIENT_H) \
310 $(VBOXWEB_SOAP_SERVER_H) \
311 $(VBOXWEB_OUT_DIR)/gsoap_generate_all_ts \
312 $(VBOXWEB_OUT_DIR)/gsoap_copy_all_ts \
313 $(wildcard $(PATH_TARGET_SOAPDEMOXML)/*) \
314 $(PATH_TARGET_SOAPDEMOXML)/dummy_file \
315 $(wildcard $(PATH_TARGET_SOAPDEMOHEADERS)/*) \
316 $(PATH_TARGET_SOAPDEMOHEADERS)/dummy_file \
317 $(wildcard $(PATH_TARGET_SOAPDEMONSMAPS)/*) \
318 $(PATH_TARGET_SOAPDEMONSMAPS)/dummy_file
319
320endif # VBOX_GSOAP_INSTALLED
321
322
323ifdef VBOX_ONLY_SDK
324 #
325 # Global relevant to the SDK.
326 #
327 VBOXWEB_GLUE_PYTHON = $(VBOX_PATH_SDK)/bindings/webservice/python/lib/VirtualBox_wrappers.py
328 VBOXWEB_WS_PYTHON = $(VBOX_PATH_SDK)/bindings/webservice/python/lib/VirtualBox_services.py
329 VBOXWEB_WS_PERL = $(VBOX_PATH_SDK)/bindings/webservice/perl/lib/vboxService.pm
330 VBOXWEB_SAMPLES_AXIS_DIR = $(VBOX_PATH_SDK)/bindings/webservice/java/axis/samples
331 VBOXWEB_SAMPLES_JAXWS_DIR = $(VBOX_PATH_SDK)/bindings/webservice/java/jax-ws/samples
332 VBOXWEB_JAXWSSAMPLE = $(VBOXWEB_SAMPLES_JAXWS_DIR)/clienttest.java
333 VBOXWEB_METRICSAMPLE = $(VBOXWEB_SAMPLES_JAXWS_DIR)/metrictest.java
334
335 VBOXWEB_GLUE_JAVA_TMP = $(VBOXWEB_OUT_DIR)/glue-jaxws.java.tmp
336 VBOXWEB_PATH_SDK_GLUE_JAVA = $(VBOX_PATH_SDK)/bindings/webservice/java/jax-ws/src
337 VBOXWEB_JAVALIB = $(VBOX_PATH_SDK)/bindings/webservice/java/jax-ws/lib
338 VBOXWEB_JAVA15_JAR = $(VBOXWEB_JAVALIB)/vboxws_java15.jar
339 VBOXWEB_JAVA16_JAR = $(VBOXWEB_JAVALIB)/vboxws_java16.jar
340
341
342 VBOX_JAXWS_LIBDIR = $(VBOX_PATH_WEBSERVICE)/jaxlibs
343 # well, not really good
344 VBOX_JAVA15 = $(firstword $(wildcard \
345 /usr/lib/jvm/java-1.5.0-sun/bin/java \
346 /usr/jdk/jdk1.5*/bin/java \
347 /opt/sun-jdk-1.5*/bin/java))
348 ifndef VBOX_JAVA15
349 $(error Failed to autodetect VBOX_JAVA15, please set it manually)
350 endif
351 VBOX_JAVA16 = java
352 VBOX_JAVAC15 = javac -target 1.5
353 VBOX_JAVAC16 = javac -target 1.6
354 VBOX_WSIMPORT15 = $(VBOX_JAVA15) -jar $(VBOX_JAXWS_LIBDIR)/jaxws-tools.jar
355 VBOX_WSIMPORT16 = $(firstword $(wildcard \
356 /usr/jdk/jdk1.6*/bin/wsimport \
357 /usr/bin/wsimport \
358 /opt/sun-jdk-1.6*/bin/wsimport))
359 ifndef VBOX_WSIMPORT16
360 $(error Failed to autodetect VBOX_WSIMPORT16, please set it manually)
361 endif
362 VBOX_JAR = jar
363 # Keep in sync with G_virtualBoxPackage in glue-jaxws.xsl
364 # Changed with every new version, so beware!
365 VBOX_API_SUFFIX = _$(VBOX_VERSION_MAJOR)_$(VBOX_VERSION_MINOR)
366 VBOX_JAVA_PACKAGE = org.virtualbox$(VBOX_API_SUFFIX)
367
368 VBOXWEB_OTHERS += \
369 $(VBOXWEB_GLUE_JAVA_TMP) \
370 $(VBOXWEB_GLUE_PYTHON) \
371 $(VBOXWEB_WS_PYTHON) \
372 $(VBOXWEB_WS_PERL) \
373 $(VBOXWEB_PYTHONWSSAMPLE)\
374 $(VBOXWEB_JAXWSSAMPLE) \
375 $(VBOXWEB_METRICSAMPLE) \
376 $(VBOXWEB_JAVA15_JAR) \
377 $(VBOXWEB_JAVA16_JAR)
378
379 #
380 # Install sample code.
381 #
382 INSTALLS += vboxwebinst
383 vboxwebinst_INST = $(INST_SDK)bindings/webservice/
384 vboxwebinst_MODE = a+rx,u+w
385 vboxwebinst_SOURCES = \
386 samples/java/axis/clienttest.java=>java/axis/samples/clienttest.java \
387 samples/java/jax-ws/Makefile.glue=>java/jax-ws/src/Makefile \
388 samples/java/jax-ws/Makefile=>java/jax-ws/samples/Makefile \
389 samples/perl/clienttest.pl=>perl/samples/clienttest.pl \
390 samples/python/Makefile=>python/samples/Makefile \
391 samples/python/Makefile.glue=>python/lib/Makefile
392
393 #
394 # filesplitter - build helper, splits up the java classes.
395 #
396 BLDPROGS += filesplitter
397 filesplitter_TEMPLATE = VBOXBLDPROG
398 filesplitter_SOURCES = filesplitter.c
399
400endif # VBOX_ONLY_SDK
401
402VBOXWEB_WSDL = $(VBOX_PATH_SDK)/bindings/webservice/vboxweb.wsdl
403VBOXWEBSERVICE_WSDL = $(VBOX_PATH_SDK)/bindings/webservice/vboxwebService.wsdl
404
405## @todo VBOXWEB_WSDL and VBOXWEBSERVICE_WSDL should be an install target.
406VBOXWEB_OTHERS += \
407 $(VBOXWEB_WSDL) \
408 $(VBOXWEBSERVICE_WSDL)
409
410#
411# Update the OTHERS and OTHER_CLEAN lists with VBOXWEB_OTHERS and some more stuff.
412#
413# We can't just built up OTHERS and append it to OTHER_CLEAN because we're sharing
414# OTHERS with all the other VBox makefiles (VBOX_SINGLE_MAKEFILE), thus VBOXWEB_OTHERS.
415#
416OTHERS += $(VBOXWEB_OTHERS)
417OTHER_CLEAN += \
418 $(VBOXWEB_OTHERS) \
419 $(VBOXWEB_TYPEMAP) \
420 $(VBOXWEB_IDL_SRC)
421
422
423# generate platform-specific XIDL file from original XIDL file
424$(VBOXWEB_IDL_SRC): $(VBOXWEB_IDL_SRC_ORIG) $(VBOX_PATH_WEBSERVICE)/platform-xidl.xsl | $$(dir $$@)
425 $(call MSG_GENERATE,,$@,$(VBOXWEB_IDL_SRC) using platform-xidl.xsl)
426 $(QUIET)$(VBOX_XSLTPROC) $(VBOXWEB_XSLTPROC_VERBOSE) -o $@ $(VBOX_PATH_WEBSERVICE)/platform-xidl.xsl $<
427
428# generate WSDL from main XIDL file
429$(VBOXWEB_WSDL): $(VBOXWEB_IDL_SRC) $(VBOX_PATH_WEBSERVICE)/websrv-wsdl.xsl $(VBOX_PATH_WEBSERVICE)/websrv-shared.inc.xsl $(RECOMPILE_ON_MAKEFILE_CURRENT) ## @todo | $$(dir $$@)
430 $(QUIET)$(MKDIR) -p $(@D)
431 $(call MSG_GENERATE,,$@,$(VBOXWEB_IDL_SRC) using websrv-wsdl.xsl)
432 $(QUIET)$(VBOX_XSLTPROC) $(VBOXWEB_XSLTPROC_VERBOSE) -o $@ $(VBOX_PATH_WEBSERVICE)/websrv-wsdl.xsl $<
433
434$(VBOXWEBSERVICE_WSDL): $(VBOXWEB_IDL_SRC) $(VBOX_PATH_WEBSERVICE)/websrv-wsdl-service.xsl $(VBOX_PATH_WEBSERVICE)/websrv-shared.inc.xsl $(RECOMPILE_ON_MAKEFILE_CURRENT) ## @todo | $$(dir $$@)
435 $(QUIET)$(MKDIR) -p $(@D)
436 $(call MSG_GENERATE,,$@,$(VBOXWEB_IDL_SRC) using websrv-wsdl-service.xsl)
437 $(QUIET)$(VBOX_XSLTPROC) $(VBOXWEB_XSLTPROC_VERBOSE) -o $@ $(VBOX_PATH_WEBSERVICE)/websrv-wsdl-service.xsl $<
438
439ifdef VBOX_ONLY_SDK
440
441$(VBOXWEB_GLUE_PYTHON): $(VBOXWEB_IDL_SRC) $(VBOXWEB_WSDL) $(VBOXWEBSERVICE_WSDL) $(VBOX_PATH_WEBSERVICE)/websrv-python.xsl
442 $(call MSG_GENERATE,,$@,$(VBOXWEB_IDL_SRC) using websrv-python.xsl)
443 $(QUIET)$(MKDIR) -p $(@D)
444 $(QUIET)$(VBOX_XSLTPROC) $(VBOXWEB_XSLTPROC_VERBOSE) -o $@ $(VBOX_PATH_WEBSERVICE)/websrv-python.xsl $<
445
446$(VBOXWEB_WS_PYTHON): $(VBOXWEB_WSDL) $(VBOXWEBSERVICE_WSDL)
447 $(call MSG_GENERATE,,$@, WS Python bindings)
448 $(QUIET)$(MKDIR) -p $(@D)
449# Try both w/o and with --file option
450 $(QUIET)$(REDIRECT) -C $(@D) -- bash -c "$(VBOX_WSDL2PY) -b $(VBOXWEBSERVICE_WSDL) || $(VBOX_WSDL2PY) -b --file $(VBOXWEBSERVICE_WSDL)"
451 $(QUIET)$(APPEND) $@ ''
452
453$(VBOXWEB_WS_PERL): $(VBOXWEB_WSDL) $(VBOXWEBSERVICE_WSDL)
454 $(call MSG_GENERATE,,$@, WS Perl bindings)
455 $(QUIET)$(MKDIR) -p $(@D)
456 $(QUIET)$(REDIRECT) -C $(@D) -- $(VBOX_STUBMAKER) file://$(VBOXWEBSERVICE_WSDL)
457# Ugly, ugly, ugly, make me right once
458 $(QUIET)$(SED) -e "s+http://www.virtualbox.org/Service+http://www.virtualbox.org/+" < $(VBOXWEB_WS_PERL) > $(VBOXWEB_WS_PERL).tmp
459 $(QUIET)$(MV) $(VBOXWEB_WS_PERL).tmp $(VBOXWEB_WS_PERL)
460 $(QUIET)$(APPEND) $@ ''
461
462endif # VBOX_ONLY_SDK
463
464# generate typemap.dat (used by wsdl2h) from main XIDL file
465$(VBOXWEB_TYPEMAP): $(VBOXWEB_IDL_SRC) $(VBOX_PATH_WEBSERVICE)/websrv-typemap.xsl $(VBOX_PATH_WEBSERVICE)/websrv-shared.inc.xsl $(RECOMPILE_ON_MAKEFILE_CURRENT) | $$(dir $$@)
466 $(call MSG_GENERATE,,$@,$(VBOXWEB_IDL_SRC) using websrv-typemap.xsl)
467 $(QUIET)$(VBOX_XSLTPROC) $(VBOXWEB_XSLTPROC_VERBOSE) -o $@ $(VBOX_PATH_WEBSERVICE)/websrv-typemap.xsl $<
468
469# generate gsoap pseudo-C header file from that WSDL; once via XSLT...
470# $(VBOXWEB_GSOAPH_FROM_XSLT): $(VBOXWEB_IDL_SRC) $(VBOX_PATH_WEBSERVICE)/websrv-gsoapH.xsl $(VBOX_PATH_WEBSERVICE)/websrv-shared.inc.xsl $(RECOMPILE_ON_MAKEFILE_CURRENT) | $$(dir $$@)
471# $(call MSG_GENERATE,,$@,$(VBOXWEB_IDL_SRC) using websrv-gsoapH.xsl)
472# $(QUIET)$(VBOX_XSLTPROC) $(VBOXWEB_XSLTPROC_VERBOSE) -o $@ $(VBOX_PATH_WEBSERVICE)/websrv-gsoapH.xsl $<
473$(VBOXWEB_GSOAPH_FROM_XSLT): $(VBOXWEB_WSDL) $(VBOX_PATH_WEBSERVICE)/websrv-wsdl2gsoapH.xsl $(VBOX_PATH_WEBSERVICE)/websrv-shared.inc.xsl $(RECOMPILE_ON_MAKEFILE_CURRENT) | $$(dir $$@)
474 $(call MSG_GENERATE,,$@,$(VBOXWEB_WSDL) using websrv-wsdl2gsoapH.xsl)
475 $(QUIET)$(VBOX_XSLTPROC) $(VBOXWEB_XSLTPROC_VERBOSE) -o $@ $(VBOX_PATH_WEBSERVICE)/websrv-wsdl2gsoapH.xsl $<
476
477NSMAP = $(VBOXWEB_OUT_DIR)/vboxwebsrv.nsmap
478
479$(NSMAP): $(VBOXWEB_IDL_SRC) $(VBOX_PATH_WEBSERVICE)/websrv-nsmap.xsl $(VBOX_PATH_WEBSERVICE)/websrv-shared.inc.xsl $(RECOMPILE_ON_MAKEFILE_CURRENT) | $$(dir $$@)
480 $(call MSG_GENERATE,,$@,$(VBOXWEB_IDL_SRC) using websrv-nsmap.xsl)
481 $(QUIET)$(VBOX_XSLTPROC) $(VBOXWEB_XSLTPROC_VERBOSE) -o $@ $(VBOX_PATH_WEBSERVICE)/websrv-nsmap.xsl $<
482
483
484
485ifdef VBOX_GSOAP_INSTALLED
486# ... and once with the gSOAP tool (just for comparison, we don't use it for licensing reasons)
487$(VBOXWEB_GSOAPH_FROM_GSOAP): $(VBOXWEB_WSDL) $(VBOXWEB_TYPEMAP) | $$(dir $$@)
488 $(call MSG_GENERATE,,$@,)
489 $(VBOX_WSDL2H) $(VBOXWEB_WSDL_VERBOSE) -t$(VBOXWEB_TYPEMAP) -nvbox -o $@ $<
490
491GSOAPH_RELEVANT = $(VBOXWEB_GSOAPH_FROM_XSLT)
492
493# wsdl2h -v: verbose
494# wsdl2h -e: don't qualify enum names
495# wsdl2h -n<prefix>: namespace header prefix
496
497## @todo change this to state explicitly what will be generated?
498
499# generate server and client code from gsoap pseudo-C header file
500$(VBOXWEB_OUT_DIR)/gsoap_generate_all_ts \
501+ $(VBOXWEB_OUT_DIR)/soapH.h \
502+ $(VBOXWEB_OUT_DIR)/soapStub.h \
503+ $(VBOXWEB_OUT_DIR)/soapC.cpp \
504+ $(VBOXWEB_OUT_DIR)/soapClient.cpp \
505+ $(VBOXWEB_OUT_DIR)/soapServer.cpp \
506: $(VBOXWEB_GSOAPH_FROM_GSOAP) $(VBOXWEB_GSOAPH_FROM_XSLT) $(NSMAP) $(RECOMPILE_ON_MAKEFILE_CURRENT) | $$(dir $$@)
507 $(call MSG_GENERATE,,lots of files,$(GSOAPH_RELEVANT))
508 $(RM) -f $@
509 $(REDIRECT) -C $(VBOXWEB_OUT_DIR) -- $(VBOX_SOAPCPP2) $(VBOXWEB_SOAPCPP2_SKIP_FILES) -L -w -I$(VBOX_PATH_GSOAP_IMPORT) $(GSOAPH_RELEVANT)
510 $(APPEND) $@ done
511
512# copy the generated headers and stuff. This has to be a seperate rule if we
513# want to use wildcard (all commands are expaned when the rule is evaluated).
514$(VBOXWEB_OUT_DIR)/gsoap_copy_all_ts: $(VBOXWEB_OUT_DIR)/gsoap_generate_all_ts | $$(dir $$@)
515 $(RM) -f $@
516 $(MKDIR) -p $(PATH_TARGET_SOAPDEMOXML) $(PATH_TARGET_SOAPDEMOHEADERS) $(PATH_TARGET_SOAPDEMONSMAPS)
517ifdef VBOX_GSOAP_VERBOSE
518 $(MV) -f $(wildcard $(VBOXWEB_OUT_DIR)/*.req.xml $(VBOXWEB_OUT_DIR)/*.res.xml) $(PATH_TARGET_SOAPDEMOXML)
519endif
520 $(MV) -f $(wildcard $(VBOXWEB_OUT_DIR)/soapvbox*.h) $(PATH_TARGET_SOAPDEMOHEADERS)
521 $(MV) -f $(VBOXWEB_OUT_DIR)/vboxBinding.nsmap $(PATH_TARGET_SOAPDEMONSMAPS)
522 $(APPEND) $@ done
523
524$(PATH_TARGET_SOAPDEMONSMAPS) \
525$(PATH_TARGET_SOAPDEMOHEADERS)/soapvboxBindingProxy.h \
526$(PATH_TARGET_SOAPDEMOHEADERS)/soapvboxBindingObject.h: $(VBOXWEB_OUT_DIR)/gsoap_copy_all_ts
527
528# soapcpp2 -2: generate SOAP 1.2 calls
529# soapcpp2 -S: server-side code only
530# soapcpp2 -L: don't generate soapClientLib/soapServerLib
531# soapcpp2 -w: don't generate WSDL and schema files
532# soapcpp2 -x: don't generate sample XML files
533
534ifndef VBOX_WITHOUT_SPLIT_SOAPC
535#
536# Split up the soapC.cpp monster into manageable bits that can be
537# built in parallel and without exhausting all available memory.
538#
539$(VBOXWEB_OUT_DIR)/soapC-1.cpp \
540+ $(VBOXWEB_OUT_DIR)/soapC-2.cpp \
541+ $(VBOXWEB_OUT_DIR)/soapC-3.cpp \
542+ $(VBOXWEB_OUT_DIR)/soapC-4.cpp \
543+ $(VBOXWEB_OUT_DIR)/soapC-5.cpp \
544+ $(VBOXWEB_OUT_DIR)/soapC-6.cpp \
545+ $(VBOXWEB_OUT_DIR)/soapC-7.cpp \
546+ $(VBOXWEB_OUT_DIR)/soapC-8.cpp \
547+ $(VBOXWEB_OUT_DIR)/soapC-9.cpp \
548+ $(VBOXWEB_OUT_DIR)/soapC-10.cpp \
549+ $(VBOXWEB_OUT_DIR)/soapC-11.cpp \
550+ $(VBOXWEB_OUT_DIR)/soapC-12.cpp \
551+ $(VBOXWEB_OUT_DIR)/soapC-13.cpp \
552+ $(VBOXWEB_OUT_DIR)/soapC-14.cpp \
553+ $(VBOXWEB_OUT_DIR)/soapC-15.cpp \
554+ $(VBOXWEB_OUT_DIR)/soapC-16.cpp \
555+ $(VBOXWEB_OUT_DIR)/soapC-17.cpp \
556+ $(VBOXWEB_OUT_DIR)/soapC-18.cpp \
557+ $(VBOXWEB_OUT_DIR)/soapC-19.cpp \
558+ $(VBOXWEB_OUT_DIR)/soapC-20.cpp \
559: $(VBOXWEB_OUT_DIR)/soapC.cpp $(VBOX_PATH_WEBSERVICE)/split-soapC.sed | $$(dir $$@)
560 $(RM) -f $(wildcard $(VBOXWEB_OUT_DIR)/soapC-?.cpp $(VBOXWEB_OUT_DIR)/soapC-??.cpp)
561 $(REDIRECT) -C $(VBOXWEB_OUT_DIR) -- \
562 $(SED) -f $(VBOX_PATH_WEBSERVICE)/split-soapC.sed soapC.cpp
563endif # !VBOX_WITHOUT_SPLIT_SOAPC
564
565endif # VBOX_GSOAP_INSTALLED
566
567
568
569# generate method maps in server: map wsdl operations to com/xpcom method calls
570$(VBOXWEB_OUT_DIR)/methodmaps.cpp: $(VBOXWEB_IDL_SRC) $(VBOX_PATH_WEBSERVICE)/websrv-cpp.xsl $(VBOX_PATH_WEBSERVICE)/websrv-shared.inc.xsl $(RECOMPILE_ON_MAKEFILE_CURRENT) | $$(dir $$@)
571 $(call MSG_GENERATE,,$@,$(VBOXWEB_IDL_SRC) using websrv-cpp.xsl)
572 $(QUIET)$(VBOX_XSLTPROC) -o $@ $(VBOX_PATH_WEBSERVICE)/websrv-cpp.xsl $<
573
574
575ifdef VBOX_ONLY_SDK
576
577$(VBOXWEB_JAXWSSAMPLE): $(VBOX_PATH_WEBSERVICE)/samples/java/jax-ws/clienttest.java
578 $(QUIET)$(MKDIR) -p $(VBOXWEB_SAMPLES_JAXWS_DIR)
579 $(QUIET)$(SED) -e 's/{VBOX_API_SUFFIX}/$(VBOX_API_SUFFIX)/' < $< > $@
580
581$(VBOXWEB_METRICSAMPLE): $(VBOX_PATH_WEBSERVICE)/samples/java/jax-ws/metrictest.java
582 $(QUIET)$(MKDIR) -p $(VBOXWEB_SAMPLES_JAXWS_DIR)
583 $(QUIET)$(SED) -e 's/{VBOX_API_SUFFIX}/$(VBOX_API_SUFFIX)/' < $< > $@
584
585# generate jax-ws wrapper for java client code
586$(VBOXWEB_GLUE_JAVA_TMP): $(VBOXWEB_IDL_SRC) $(VBOX_PATH_WEBSERVICE)/glue-jaxws.xsl $(VBOX_PATH_WEBSERVICE)/websrv-shared.inc.xsl $$(TARGET_filesplitter) $(RECOMPILE_ON_MAKEFILE_CURRENT) | $$(dir $$@)
587 $(QUIET)$(MKDIR) -p $(@D)
588 $(call MSG_GENERATE,,$@,$(VBOXWEB_IDL_SRC) using glue-jaxws.xsl)
589 $(QUIET)$(VBOX_XSLTPROC) $(VBOXWEB_XSLTPROC_VERBOSE) \
590 --stringparam G_vboxApiSuffix $(VBOX_API_SUFFIX) \
591 -o $@ $(VBOX_PATH_WEBSERVICE)/glue-jaxws.xsl $<
592 $(call MSG_GENERATE,,java client glue files in $(VBOXWEB_PATH_SDK_GLUE_JAVA))
593 $(RM) -R -f $(VBOXWEB_PATH_SDK_GLUE_JAVA)
594 $(QUIET)$(MKDIR) -p $(VBOXWEB_PATH_SDK_GLUE_JAVA)
595 $(QUIET)$(TARGET_filesplitter) $@ $(VBOXWEB_PATH_SDK_GLUE_JAVA)
596 $(QUIET)$(CP) -f $(VBOX_PATH_WEBSERVICE)/../../../../COPYING.LIB $(VBOXWEB_PATH_SDK_GLUE_JAVA)
597
598$(VBOXWEB_GLUE_JAVA_TMP).done: $(VBOXWEB_GLUE_JAVA_TMP)
599 $(QUIET)$(APPEND) $@ ''
600
601$(VBOXWEB_JAVA15_JAR): $(VBOXWEB_GLUE_JAVA_TMP).done $(VBOXWEB_WSDL) $(VBOXWEBSERVICE_WSDL)
602 $(QUIET)$(RM) -Rf $(VBOXWEB_JAVALIB)/gen15
603 $(QUIET)$(MKDIR) -p $(VBOXWEB_JAVALIB)/gen15
604 $(call MSG_GENERATE,,$@,JAX-WS for Java 1.5 bindings using $(VBOXWEBSERVICE_WSDL))
605 $(QUIET)$(VBOX_WSIMPORT15) -p $(VBOX_JAVA_PACKAGE) -d $(VBOXWEB_JAVALIB)/gen15 $(VBOXWEBSERVICE_WSDL)
606 $(call MSG_L1,Compiling bridge code)
607 $(QUIET)$(VBOX_JAVAC15) -cp \
608 $(VBOXWEB_JAVALIB)/gen15:$(VBOX_JAXWS_LIBDIR)/jaxws-api.jar:$(VBOX_JAXWS_LIBDIR)/lib/jaxb-api.jar:$(VBOX_JAXWS_LIBDIR)/jsr181-api.jar \
609 $(VBOXWEB_PATH_SDK_GLUE_JAVA)/*.java -d $(VBOXWEB_JAVALIB)/gen15
610 $(QUIET)$(SED) -e "s/vboxweb.wsdl/vboxweb$(VBOX_API_SUFFIX).wsdl/" < $(VBOXWEBSERVICE_WSDL) > $(VBOXWEB_JAVALIB)/gen15/vboxwebService$(VBOX_API_SUFFIX).wsdl
611 $(QUIET)$(CP) -f $(VBOXWEB_WSDL) $(VBOXWEB_JAVALIB)/gen15/vboxweb$(VBOX_API_SUFFIX).wsdl
612 $(QUIET)$(RM) -f $(VBOXWEB_JAVALIB)/gen15/*.java
613 $(QUIET)$(VBOX_JAR) cf $@ -C $(VBOXWEB_JAVALIB)/gen15 .
614
615$(VBOXWEB_JAVA16_JAR): $(VBOXWEB_GLUE_JAVA_TMP).done $(VBOXWEB_WSDL) $(VBOXWEBSERVICE_WSDL)
616 $(QUIET)$(RM) -Rf $(VBOXWEB_JAVALIB)/gen16
617 $(MKDIR) -p $(VBOXWEB_JAVALIB)/gen16
618 $(call MSG_GENERATE,,$@,JAX-WS for Java 1.6 bindings using $(VBOXWEBSERVICE_WSDL))
619 $(QUIET)$(VBOX_WSIMPORT16) -p $(VBOX_JAVA_PACKAGE) -d $(VBOXWEB_JAVALIB)/gen16 $(VBOXWEBSERVICE_WSDL)
620 $(call MSG_L1,Compiling bridge code)
621 $(QUIET)$(VBOX_JAVAC16) -cp $(VBOXWEB_JAVALIB)/gen16 \
622 $(VBOXWEB_PATH_SDK_GLUE_JAVA)/*.java -d $(VBOXWEB_JAVALIB)/gen16
623 $(QUIET)$(SED) -e "s/vboxweb.wsdl/vboxweb$(VBOX_API_SUFFIX).wsdl/" < $(VBOXWEBSERVICE_WSDL) > $(VBOXWEB_JAVALIB)/gen16/vboxwebService$(VBOX_API_SUFFIX).wsdl
624 $(QUIET)$(CP) -f $(VBOXWEB_WSDL) $(VBOXWEB_JAVALIB)/gen16/vboxweb$(VBOX_API_SUFFIX).wsdl
625 $(QUIET)$(RM) -f $(VBOXWEB_JAVALIB)/gen16/*.java
626 $(QUIET)$(VBOX_JAR) cf $@ -C $(VBOXWEB_JAVALIB)/gen16 .
627
628endif # VBOX_ONLY_SDK
629
630include $(KBUILD_PATH)/subfooter.kmk
631
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette