VirtualBox

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

Last change on this file since 38636 was 38228, checked in by vboxsync, 13 years ago

webservice/Makefile.kmk: Dependency fix.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 26.9 KB
Line 
1# $Id: Makefile.kmk 38228 2011-07-28 17:33:56Z 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-2010 Oracle Corporation
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
20# Define VBOX_GSOAP_INSTALLED to something if you have gSOAP's
21# "wsdl2h" and "soapcpp2" executables on your PATH somewhere.
22
23#
24# Here's an overview how all this works. It's complicated. Essentially,
25# lots of files get generated automatically from our XML XIDL file that
26# describes the VirtualBox API (../idl/VirtualBox.xidl); as a result,
27# no manual coding is necessary when the API changes. All generated
28# web service code gets adjusted automatically.
29#
30# In more detail:
31#
32# 1) We use xsltproc and websrv-wsdl.xsl to generate a WSDL file from
33# our XML IDL file. WSDL (Web Service Description language) is an XML
34# industry standard that publicly describes a web service.
35# So, the WSDL generated here describes the VirtualBox web
36# service to third-party clients; for example, one can feed it to
37# Java or Perl or some other toolkit that understands WSDL and thus
38# easily write a short script that connects to the web service properly.
39# This WSDL file ends up in $(VBOXWEB_OUT_DIR)/vboxweb.wsdl.
40#
41# 2) We use xsltproc and websrv-wsdl2gsoapH.xsl to generate a so-called
42# "gSoap header file": $(VBOXWEB_OUT_DIR)/gsoapH_from_xslt.h from
43# the WSDL previously generated.
44# This file looks like a C header file, but really isn't meant
45# to be included by a C compiler. Instead, it just happens to be the
46# format that gSOAP uses to specify SOAP interfaces instead of WSDL.
47# (The reason for this appears to be that gSOAP predates WSDL and
48# thus needed some format to describe the syntax of a web service.)
49#
50# Note that gSOAP now also comes with its own WSDL-to-gsoap.h converter,
51# but the readme mentions some funny license restrictions, so instead we
52# have our own converter in XSLT.
53#
54# 3) We then feed that pseudo-header file to gSOAP's soapcpp2 compiler,
55# which generates a ton of files in $(VBOXWEB_OUT_DIR), most importantly:
56#
57# SOAP_CLIENT_H = $(VBOXWEB_OUT_DIR)/soapStub.h (header file for webservice clients)
58# SOAP_SERVER_H = $(VBOXWEB_OUT_DIR)/soapH.h (header file for webservice servers)
59#
60# These are "real" header files that one can use to program a) a webservice client
61# and b) a webservice server. Of course to build b) one will have to write method
62# implementations with useful code that does something. This is where more
63# code generation via XSLT comes in:
64#
65# 4) We use xsltproc to generate tons of C++ code directly from the XIDL that
66# maps each SOAP method to our COM methods. This large C++ file is
67# $(VBOXWEB_OUT_DIR)/methodmaps.cpp. The actual webservice executable (vboxwebsrv,
68# which acts as an HTTP server) is composed of this file, plus hard-coded
69# method implementations in vboxweb.cpp, plus gSOAP library code for the HTTP
70# server.
71#
72
73SUB_DEPTH = ../../../..
74include $(KBUILD_PATH)/subheader.kmk
75
76#
77# Find the gSOAP toolkit.
78#
79# Note! We're not using the gSOAP toolkit correctly. The main issue is that
80# compiling soapcpp2.cpp instead of using the library. So, in order
81# to make this work with a locally installed gSOAP toolkit there are
82# some hoops to jump thru to say the least... Shipping soapcpp2.cpp/h
83# is out of the question without also including the two soap tools.
84#
85# Some observations on distros for OSE / configure:
86# The proposed gentoo ebuild screws up several things in the install phase
87# and thus fails to ship stdsoap2.cpp and relatives.
88#
89# debian (2.7.9l-0.2) stuffs stdsoap2.cpp and a handful of the import files
90# into /usr/include/gsoap.
91#
92# fedora (2.7.12-fc10.x86_64) uses the default install layout and does not
93# ship stdsoap2.cpp and friends.
94#
95ifeq ($(VBOX_GSOAP_INSTALLED),)
96 VBOX_GSOAP_INSTALLED = 1
97 VBOX_PATH_GSOAP := $(lastword $(sort $(wildcard $(KBUILD_DEVTOOLS)/common/gsoap/*)))
98 ifeq ($(VBOX_PATH_GSOAP),)
99 VBOX_PATH_GSOAP := $(lastword $(sort $(wildcard $(KBUILD_DEVTOOLS_HST)/gsoap/*)))
100 endif
101 if "$(VBOX_PATH_GSOAP)" == "" && defined(KBUILD_DEVTOOLS_HST)
102 VBOX_PATH_GSOAP := $(lastword $(sort $(wildcard $(KBUILD_DEVTOOLS_HST_ALT)/gsoap/*)))
103 endif
104 ifeq ($(VBOX_PATH_GSOAP),)
105 $(warning VBOX_PATH_GSOAP not found...)
106 VBOX_GSOAP_INSTALLED =
107 endif
108else
109 VBOX_PATH_GSOAP := $(VBOX_PATH_GSOAP)
110endif
111VBOX_PATH_GSOAP_BIN := $(strip $(VBOX_PATH_GSOAP_BIN))
112if "$(VBOX_PATH_GSOAP_BIN)" == ""
113 VBOX_PATH_GSOAP_BIN := $(VBOX_PATH_GSOAP)/bin
114 if "$(KBUILD_HOST)" == "darwin"
115 VBOX_PATH_GSOAP_BIN := $(VBOX_PATH_GSOAP_BIN)/macosx
116 else if "$(KBUILD_HOST)" == "win"
117 VBOX_PATH_GSOAP_BIN := $(VBOX_PATH_GSOAP_BIN)/win32
118 else if "$(KBUILD_HOST)" == "linux"
119 VBOX_PATH_GSOAP_BIN := $(VBOX_PATH_GSOAP_BIN)/linux386
120 else
121 VBOX_PATH_GSOAP_BIN := $(VBOX_PATH_GSOAP_BIN)/$(KBUILD_HOST).x86
122 endif
123 if !exists($(VBOX_PATH_GSOAP_BIN))
124 VBOX_PATH_GSOAP_BIN := $(VBOX_PATH_GSOAP)/bin
125 endif
126endif
127VBOX_SOAPCPP2 := $(VBOX_PATH_GSOAP_BIN)/soapcpp2$(HOSTSUFF_EXE)
128VBOX_WSDL2H := $(VBOX_PATH_GSOAP_BIN)/wsdl2h$(HOSTSUFF_EXE)
129VBOX_STUBMAKER = $(firstword $(which stubmaker stubmaker.pl) stubmaker_not_found)
130VBOX_WSDL2PY = $(firstword $(which wsdl2py) wsdl2py_not_found)
131
132VBOX_PATH_GSOAP_IMPORT := $(strip $(if $(VBOX_PATH_GSOAP_IMPORT),$(VBOX_PATH_GSOAP_IMPORT),$(VBOX_PATH_GSOAP)/import))
133VBOX_GSOAP_INCS := $(strip $(if $(VBOX_GSOAP_INCS),$(VBOX_GSOAP_INCS),$(VBOX_PATH_GSOAP) $(VBOX_PATH_GSOAP_IMPORT) ))
134# note: $(if $(defined FOO)) does not work here!
135VBOX_GSOAP_CXX_SOURCES := $(strip $(if-expr "$(origin VBOX_GSOAP_CXX_SOURCES)" != "undefined",$(VBOX_GSOAP_CXX_SOURCES),$(VBOX_PATH_GSOAP)/stdsoap2.cpp))
136VBOX_GSOAP_CXX_LIBS := $(strip $(if-expr "$(origin VBOX_GSOAP_CXX_LIBS)" != "undefined",$(VBOX_GSOAP_CXX_LIBS),))
137
138
139#
140# Globals
141#
142VBOXWEB_OUT_DIR := $(PATH_TARGET)/webservice
143BLDDIRS += $(VBOXWEB_OUT_DIR)
144
145# The webservice location
146VBOX_PATH_WEBSERVICE := $(PATH_SUB_CURRENT)
147
148# If this is set, all webservice files are considered out-of-date every time
149# this makefile is touched. Otherwise, set this to empty.
150RECOMPILE_ON_MAKEFILE_CURRENT := $(MAKEFILE_CURRENT)
151
152PATH_TARGET_SOAPDEMOXML := $(VBOXWEB_OUT_DIR)/demo_soapxml
153PATH_TARGET_SOAPDEMOHEADERS := $(VBOXWEB_OUT_DIR)/demo_headers
154PATH_TARGET_SOAPDEMONSMAPS := $(VBOXWEB_OUT_DIR)/demo_namespacemaps
155PATH_TARGET_WEBTEST := $(VBOXWEB_OUT_DIR)/webtest
156
157# platform-specific XIDL file generated from $(VBOXWEB_IDL_SRC):
158VBOXWEB_IDL_SRC_ORIG := $(VBOX_XIDL_FILE)
159# the original XIDL file:
160VBOXWEB_IDL_SRC := $(VBOXWEB_OUT_DIR)/VirtualBox.xidl
161
162VBOXWEB_WSDL = $(VBOX_PATH_SDK)/bindings/webservice/vboxweb.wsdl
163VBOXWEBSERVICE_WSDL = $(VBOX_PATH_SDK)/bindings/webservice/vboxwebService.wsdl
164
165VBOXWEB_TYPEMAP := $(VBOXWEB_OUT_DIR)/typemap.dat
166
167VBOXWEB_GSOAPH_FROM_XSLT := $(VBOXWEB_OUT_DIR)/gsoapH_from_xslt.h
168ifdef VBOX_GSOAP_INSTALLED
169 VBOXWEB_GSOAPH_FROM_GSOAP := $(VBOXWEB_OUT_DIR)/gsoapH_from_gsoap.h
170else
171 VBOXWEB_GSOAPH_FROM_GSOAP :=
172endif
173VBOXWEB_SOAP_CLIENT_H := $(VBOXWEB_OUT_DIR)/soapStub.h
174VBOXWEB_SOAP_SERVER_H := $(VBOXWEB_OUT_DIR)/soapH.h
175
176
177ifdef VBOX_GSOAP_VERBOSE
178 VBOXWEB_XSLTPROC_VERBOSE = --stringparam G_argDebug '1'
179 VBOXWEB_WSDL_VERBOSE = -v
180else
181 VBOXWEB_SOAPCPP2_SKIP_FILES = -x
182endif
183
184
185## @todo VBOXWEB_GSOAPH_FROM_XSLT should probably be a indirect dep of something.
186VBOXWEB_OTHERS += \
187 $(VBOXWEB_GSOAPH_FROM_XSLT)
188
189
190
191ifdef VBOX_GSOAP_INSTALLED
192 ifndef VBOX_ONLY_SDK
193 #
194 # vboxsoap - Library used by both the programs (save build time).
195 #
196 LIBRARIES += vboxsoap
197 vboxsoap_TEMPLATE = VBOXR3EXE
198 ifdef VBOX_USE_VCC80
199 vboxsoap_CXXFLAGS.win += -bigobj
200 endif
201 ifn1of ($(KBUILD_TARGET), win)
202 vboxsoap_CXXFLAGS += -Wno-shadow
203 endif
204 vboxsoap_INCS := \
205 $(VBOX_GSOAP_INCS) \
206 $(VBOXWEB_OUT_DIR) \
207 $(PATH_SUB_CURRENT)
208 ifdef VBOX_WITHOUT_SPLIT_SOAPC
209 vboxsoap_SOURCES = \
210 $(VBOXWEB_OUT_DIR)/soapC.cpp
211 else
212 BLDPROGS += split-soapC
213 split-soapC_TEMPLATE = VBOXBLDPROG
214 split-soapC_SOURCES = split-soapC.cpp
215
216 vboxsoap_SOURCES = \
217 $(VBOXWEB_OUT_DIR)/soapC-1.cpp \
218 $(VBOXWEB_OUT_DIR)/soapC-2.cpp \
219 $(VBOXWEB_OUT_DIR)/soapC-3.cpp \
220 $(VBOXWEB_OUT_DIR)/soapC-4.cpp \
221 $(VBOXWEB_OUT_DIR)/soapC-5.cpp \
222 $(VBOXWEB_OUT_DIR)/soapC-6.cpp \
223 $(VBOXWEB_OUT_DIR)/soapC-7.cpp \
224 $(VBOXWEB_OUT_DIR)/soapC-8.cpp \
225 $(VBOXWEB_OUT_DIR)/soapC-9.cpp \
226 $(VBOXWEB_OUT_DIR)/soapC-10.cpp \
227 $(VBOXWEB_OUT_DIR)/soapC-11.cpp \
228 $(VBOXWEB_OUT_DIR)/soapC-12.cpp \
229 $(VBOXWEB_OUT_DIR)/soapC-13.cpp \
230 $(VBOXWEB_OUT_DIR)/soapC-14.cpp \
231 $(VBOXWEB_OUT_DIR)/soapC-15.cpp \
232 $(VBOXWEB_OUT_DIR)/soapC-16.cpp \
233 $(VBOXWEB_OUT_DIR)/soapC-17.cpp \
234 $(VBOXWEB_OUT_DIR)/soapC-18.cpp \
235 $(VBOXWEB_OUT_DIR)/soapC-19.cpp \
236 $(VBOXWEB_OUT_DIR)/soapC-20.cpp
237 endif
238 vboxsoap_CLEAN := $(vboxsoap_SOURCES) # lazy bird
239 vboxsoap_SOURCES += \
240 $(VBOX_GSOAP_CXX_SOURCES)
241 vboxsoap_ORDERDEPS = \
242 $(VBOXWEB_IDL_SRC) \
243 $(VBOXWEB_OUT_DIR)/gsoap_copy_all_ts
244 ifn1of ($(KBUILD_TARGET), win)
245 $(VBOX_GSOAP_CXX_SOURCES)_CXXFLAGS = -Wno-format
246 endif
247 $(VBOXWEB_OUT_DIR)/soapC-3.cpp_CXXFLAGS.win.x86 = -Og- # VCC70 says "function too large".
248
249ifdef VBOX_SOAP_PRECOMPILED_HEADER
250 # This'll save a few seconds, but the compiler invocation currently makes it impracticable. This will
251 # be addressed in a future kBuild version, by adding PCH support or/and by adding some helpers to
252 # gather the required data (DEFS,INCS,CXXTOOL,CXXFLAGS).
253 vboxsoap_INTERMEDIATES += $(VBOXWEB_OUT_DIR)/soapH.h.gch
254 vboxsoap_CXXFLAGS += -Winvalid-pch -H
255 vboxsoap_CLEAN += $(VBOXWEB_OUT_DIR)/soapH.h.gch
256
257$(VBOXWEB_OUT_DIR)/soapH.h.gch: $(VBOXWEB_OUT_DIR)/soapH.h
258 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 \
259 $< -o $@
260endif
261 endif # !VBOX_ONLY_SDK
262
263
264 ifndef VBOX_ONLY_SDK
265 #
266 # vboxwebsrv - webservice server process
267 #
268 PROGRAMS += vboxwebsrv
269 vboxwebsrv_TEMPLATE = VBOXMAINCLIENTEXE
270 vboxwebsrv_DEFS += SOCKET_CLOSE_ON_EXEC
271 vboxwebsrv_INCS = \
272 $(VBOX_GSOAP_INCS) \
273 $(VBOXWEB_OUT_DIR) \
274 .
275 ifdef VBOX_USE_VCC80
276 vboxwebsrv_CXXFLAGS.win += -bigobj
277 endif
278 ifn1of ($(KBUILD_TARGET), win)
279 vboxwebsrv_CXXFLAGS += -Wno-shadow
280 endif
281 vboxwebsrv_LIBS += \
282 $(PATH_STAGE_LIB)/vboxsoap$(VBOX_SUFF_LIB) \
283 $(VBOX_GSOAP_CXX_LIBS)
284 vboxwebsrv_LIBS.solaris += socket nsl
285 vboxwebsrv_SOURCES = \
286 vboxweb.cpp \
287 $(VBOXWEB_OUT_DIR)/methodmaps.cpp \
288 $(VBOXWEB_OUT_DIR)/soapServer.cpp
289 vboxwebsrv_CLEAN = \
290 $(VBOXWEB_OUT_DIR)/methodmaps.cpp \
291 $(VBOXWEB_OUT_DIR)/soapServer.cpp
292
293 vboxweb.cpp_DEFS = \
294 VBOX_BUILD_TARGET=\"$(KBUILD_TARGET).$(KBUILD_TARGET_ARCH)\" \
295 $(if $(VBOX_BLEEDING_EDGE),VBOX_BLEEDING_EDGE=\"$(VBOX_BLEEDING_EDGE)\",)
296
297 vboxwebsrv_ORDERDEPS = $(VBOXWEB_OUT_DIR)/gsoap_copy_all_ts
298 endif # !VBOX_ONLY_SDK
299
300 ifdef VBOX_WITH_JWS
301INSTALLS += VBoxJWs-inst-jar
302
303#
304# Java glue JAR files
305#
306VBOX_JWS_JAR = $(VBoxJWs-inst-jar_0_OUTDIR)/vboxjws.jar
307VBOX_JWS_TARGET := $(PATH_TARGET)/vboxjws-gen
308VBOX_JWS_GEN = $(VBOX_JWS_TARGET)/jwsgen
309VBOX_JWS_JDEST := $(VBOX_JWS_TARGET)/jdest
310VBOX_GLUE_XSLT_DIR := $(PATH_ROOT)/src/VBox/Main/glue
311VBOX_JAXLIB_DIR := $(PATH_ROOT)/src/VBox/Main/webservice/jaxlibs
312
313VBoxJWs-inst-jar_INST = $(INST_SDK)bindings/webservice/java/jax-ws/
314VBoxJWs-inst-jar_MODE = a+r,u+w
315VBoxJWs-inst-jar_SOURCES = \
316 $(VBOX_JWS_JAR)
317VBoxJWs-inst-jar_CLEAN = \
318 $(VBOX_JWS_JAR) \
319 $(VBOX_JWS_GEN)/jwsglue.list \
320 $(wildcard \
321 $(VBOX_JWS_GEN)/java/*.java \
322 $(VBOX_JWS_GEN)/java/jws/*/*/*/*.java \
323 $(VBOX_JWS_JDEST)/*.class \
324 $(VBOX_JWS_JDEST)/*/*.class \
325 $(VBOX_JWS_JDEST)/*/*/*.class \
326 $(VBOX_JWS_JDEST)/*/*/*/*.class \
327 )
328VBoxJWs-inst-jar_BLDDIRS += $(VBOX_JWS_GEN)/java $(VBOX_JWS_GEN)/java/jws
329
330$(VBOX_JWS_GEN)/jwsglue.list: \
331 $(VBOX_XIDL_FILE) \
332 $(VBOX_GLUE_XSLT_DIR)/glue-java.xsl \
333 $(VBOX_FILESPLIT) \
334 $(VBOXWEBSERVICE_WSDL) \
335 $(VBOXWEB_WSDL) \
336 | $(VBOX_JWS_GEN)/java/jws/
337 $(call MSG_L1,Generating JAX-WS Java glue files from XIDL)
338 $(RM) -f $(wildcard $(VBOX_JWS_GEN)/java/*.java) $(wildcard $(VBOX_JWS_GEN)/java/jws/*/*/*/*.java)
339 $(QUIET)$(VBOX_XSLTPROC) \
340 --stringparam G_vboxApiSuffix $(VBOX_API_SUFFIX) \
341 --stringparam G_vboxGlueStyle jaxws \
342 -o $(VBOX_JWS_GEN)/java/merged.file $(VBOX_GLUE_XSLT_DIR)/glue-java.xsl $<
343 $(QUIET)$(VBOX_FILESPLIT) $(VBOX_JWS_GEN)/java/merged.file $(VBOX_JWS_GEN)/java
344 $(call MSG_GENERATE,,$@,JAX-WS for Java 1.6 bindings using $(VBOXWEBSERVICE_WSDL))
345 $(VBOX_WSIMPORT) -Xnocompile -p $(VBOX_JAVA_PACKAGE).jaxws -d $(VBOX_JWS_GEN)/java/jws $(VBOXWEBSERVICE_WSDL)
346 $(QUIET)echo $(VBOX_JWS_GEN)/java/*.java > $@
347 $(QUIET)echo $(VBOX_JWS_GEN)/java/jws/*/*/*/*.java >> $@
348
349$$(VBOX_JWS_JAR): $(VBOX_JWS_GEN)/jwsglue.list $(VBOXWEB_WSDL) $(VBOXWEBSERVICE_WSDL) | $$(dir $$@)
350 $(call MSG_TOOL,javac,$(notdir $@),jwsgen.list,)
351 $(QUIET)$(RM) -Rf $(VBOX_JWS_JDEST)
352 $(QUIET)$(MKDIR) -p $(VBOX_JWS_JDEST)
353 $(call MSG_L1,Compiling bridge code)
354 $(VBOX_JAVAC) $(VBOX_JAVAC_OPTS) \
355 @$(VBOX_JWS_GEN)/jwsglue.list \
356 -d $(VBOX_JWS_JDEST) -classpath $(VBOX_JWS_JDEST)
357 $(QUIET)$(SED) -e "s/vboxweb.wsdl/vboxweb$(VBOX_API_SUFFIX).wsdl/" < $(VBOXWEBSERVICE_WSDL) > $(VBOX_JWS_JDEST)/vboxwebService$(VBOX_API_SUFFIX).wsdl
358 $(QUIET)$(CP) -f $(VBOXWEB_WSDL) $(VBOX_JWS_JDEST)/vboxweb$(VBOX_API_SUFFIX).wsdl
359 $(call MSG_LINK,$(notdir $@),$@)
360 $(VBOX_JAR) cf $@ -C $(VBOX_JWS_JDEST) .
361
362 endif # VBOX_WITH_JWS
363
364 ifndef VBOX_ONLY_SDK
365 #
366 # webtest - webservice sample client in C++
367 #
368 PROGRAMS += webtest
369 webtest_TEMPLATE = VBOXR3EXE
370 ifdef VBOX_USE_VCC80
371 webtest_CXXFLAGS.win += -bigobj
372 endif
373 ifn1of ($(KBUILD_TARGET), win)
374 webtest_CXXFLAGS += -Wno-shadow
375 endif
376 webtest_INCS := \
377 $(VBOX_GSOAP_INCS) \
378 $(VBOXWEB_OUT_DIR) \
379 .
380 webtest_LIBS += \
381 $(PATH_STAGE_LIB)/vboxsoap$(VBOX_SUFF_LIB) \
382 $(VBOX_GSOAP_CXX_LIBS)
383 webtest_LIBS.solaris += nsl
384 webtest_SOURCES = \
385 webtest.cpp \
386 $(VBOXWEB_OUT_DIR)/soapClient.cpp
387 webtest_CLEAN = \
388 $(VBOXWEB_OUT_DIR)/soapClient.cpp
389
390 webtest_ORDERDEPS = $(VBOXWEB_OUT_DIR)/gsoap_copy_all_ts
391 endif # !VBOX_ONLY_SDK
392
393
394 #
395 # Additional mess to cleanup (applies to both webtest and vboxwebsrv).
396 #
397 ## @todo figure out whether the SDK really needs this or not...
398 OTHER_CLEAN += \
399 $(wildcard $(VBOXWEB_OUT_DIR)/soap*.h) \
400 $(wildcard $(VBOXWEB_OUT_DIR)/soap*.cpp) \
401 $(wildcard $(VBOXWEB_OUT_DIR)/*.nsmap) \
402 $(VBOXWEB_GSOAPH_FROM_XSLT) \
403 $(VBOXWEB_GSOAPH_FROM_GSOAP) \
404 $(VBOXWEB_SOAP_CLIENT_H) \
405 $(VBOXWEB_SOAP_SERVER_H) \
406 $(VBOXWEB_OUT_DIR)/gsoap_generate_all_ts \
407 $(VBOXWEB_OUT_DIR)/gsoap_copy_all_ts \
408 $(wildcard $(PATH_TARGET_SOAPDEMOXML)/*) \
409 $(PATH_TARGET_SOAPDEMOXML)/dummy_file \
410 $(wildcard $(PATH_TARGET_SOAPDEMOHEADERS)/*) \
411 $(PATH_TARGET_SOAPDEMOHEADERS)/dummy_file \
412 $(wildcard $(PATH_TARGET_SOAPDEMONSMAPS)/*) \
413 $(PATH_TARGET_SOAPDEMONSMAPS)/dummy_file
414
415endif # VBOX_GSOAP_INSTALLED
416
417
418ifdef VBOX_ONLY_SDK
419 #
420 # Globals relevant to the SDK.
421 #
422 VBOXWEB_GLUE_PYTHON = $(VBOX_PATH_SDK)/bindings/webservice/python/lib/VirtualBox_wrappers.py
423 VBOXWEB_WS_PYTHON = $(VBOX_PATH_SDK)/bindings/webservice/python/lib/VirtualBox_services.py
424 VBOXWEB_WS_PERL = $(VBOX_PATH_SDK)/bindings/webservice/perl/lib/vboxService.pm
425 VBOXWEB_WS_PHP = $(VBOX_PATH_SDK)/bindings/webservice/php/lib/vboxServiceWrappers.php
426 VBOXWEB_SAMPLES_JAXWS_DIR = $(VBOX_PATH_SDK)/bindings/webservice/java/jax-ws/samples
427 VBOXWEB_JAXWSSAMPLE = $(VBOXWEB_SAMPLES_JAXWS_DIR)/clienttest.java
428 VBOXWEB_METRICSAMPLE = $(VBOXWEB_SAMPLES_JAXWS_DIR)/metrictest.java
429
430 VBOXWEB_GLUE_JAVA_TMP = $(VBOXWEB_OUT_DIR)/glue-jaxws.java.tmp
431 VBOXWEB_PATH_SDK_GLUE_JAVA = $(VBOX_PATH_SDK)/bindings/webservice/java/jax-ws/src
432 VBOXWEB_JAVALIB = $(VBOX_PATH_SDK)/bindings/webservice/java/jax-ws/lib
433 VBOXWEB_JAVA15_JAR = $(VBOXWEB_JAVALIB)/vboxws_java15.jar
434 VBOXWEB_JAVA16_JAR = $(VBOXWEB_JAVALIB)/vboxws_java16.jar
435
436 define find_java_files
437 $(shell find $(1) -name \*.java)
438 endef
439
440 VBOXWEB_OTHERS += \
441 $(VBOXWEB_GLUE_PYTHON) \
442 $(VBOXWEB_WS_PYTHON) \
443 $(VBOXWEB_WS_PERL) \
444 $(VBOXWEB_WS_PHP) \
445 $(VBOXWEB_PYTHONWSSAMPLE) \
446 $(PATH_ROOT)
447
448
449 #
450 # Install sample code.
451 #
452 INSTALLS += vboxwebinst
453 vboxwebinst_INST = $(INST_SDK)bindings/webservice/
454 vboxwebinst_MODE = a+rx,u+w
455 vboxwebinst_SOURCES = \
456 samples/perl/clienttest.pl=>perl/samples/clienttest.pl \
457 samples/php/clienttest.php=>php/samples/clienttest.php
458
459 INSTALLS += vboxwebinst_nox
460 vboxwebinst_nox_INST = $(INST_SDK)bindings/webservice/
461 vboxwebinst_nox_MODE = a+r,u+w
462 vboxwebinst_nox_SOURCES = \
463 samples/python/Makefile=>python/samples/Makefile \
464 samples/python/Makefile.glue=>python/lib/Makefile \
465 $(PATH_ROOT)/COPYING.LIB=>java/jax-ws/COPYING.LIB
466
467endif # VBOX_ONLY_SDK
468
469## @todo VBOXWEB_WSDL and VBOXWEBSERVICE_WSDL should be an install target.
470VBOXWEB_OTHERS += \
471 $(VBOXWEB_WSDL) \
472 $(VBOXWEBSERVICE_WSDL)
473
474#
475# Update the OTHERS and OTHER_CLEAN lists with VBOXWEB_OTHERS and some more stuff.
476#
477# We can't just built up OTHERS and append it to OTHER_CLEAN because we're sharing
478# OTHERS with all the other VBox makefiles, thus VBOXWEB_OTHERS.
479#
480OTHERS += $(VBOXWEB_OTHERS)
481OTHER_CLEAN += \
482 $(VBOXWEB_OTHERS) \
483 $(VBOXWEB_TYPEMAP) \
484 $(VBOXWEB_IDL_SRC)
485
486# generate platform-specific XIDL file from original XIDL file
487$(VBOXWEB_IDL_SRC): $(VBOXWEB_IDL_SRC_ORIG) $(VBOX_PATH_WEBSERVICE)/platform-xidl.xsl | $$(dir $$@)
488 $(call MSG_GENERATE,,$@,$(VBOXWEB_IDL_SRC) using platform-xidl.xsl)
489 $(QUIET)$(RM) -f -- $@
490 $(QUIET)$(VBOX_XSLTPROC) $(VBOXWEB_XSLTPROC_VERBOSE) -o $@ $(VBOX_PATH_WEBSERVICE)/platform-xidl.xsl $<
491
492# generate WSDL from main XIDL file
493$(VBOXWEB_WSDL): $(VBOXWEB_IDL_SRC) $(VBOX_PATH_WEBSERVICE)/websrv-wsdl.xsl $(VBOX_PATH_WEBSERVICE)/websrv-shared.inc.xsl $(RECOMPILE_ON_MAKEFILE_CURRENT) ## @todo | $$(dir $$@)
494 $(call MSG_GENERATE,,$@,$(VBOXWEB_IDL_SRC) using websrv-wsdl.xsl)
495 $(QUIET)$(RM) -f -- $@
496 $(QUIET)$(MKDIR) -p $(@D)
497 $(QUIET)$(VBOX_XSLTPROC) $(VBOXWEB_XSLTPROC_VERBOSE) -o $@ $(VBOX_PATH_WEBSERVICE)/websrv-wsdl.xsl $<
498
499$(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 $$@)
500 $(call MSG_GENERATE,,$@,$(VBOXWEB_IDL_SRC) using websrv-wsdl-service.xsl)
501 $(QUIET)$(RM) -f -- $@
502 $(QUIET)$(MKDIR) -p $(@D)
503 $(QUIET)$(VBOX_XSLTPROC) $(VBOXWEB_XSLTPROC_VERBOSE) -o $@ $(VBOX_PATH_WEBSERVICE)/websrv-wsdl-service.xsl $<
504
505ifdef VBOX_ONLY_SDK
506
507$(VBOXWEB_GLUE_PYTHON): $(VBOXWEB_IDL_SRC) $(VBOXWEB_WSDL) $(VBOXWEBSERVICE_WSDL) $(VBOX_PATH_WEBSERVICE)/websrv-python.xsl
508 $(call MSG_GENERATE,,$@,$(VBOXWEB_IDL_SRC) using websrv-python.xsl)
509 $(QUIET)$(RM) -f -- $@
510 $(QUIET)$(MKDIR) -p $(@D)
511 $(QUIET)$(VBOX_XSLTPROC) $(VBOXWEB_XSLTPROC_VERBOSE) -o $@ $(VBOX_PATH_WEBSERVICE)/websrv-python.xsl $<
512
513$(VBOXWEB_WS_PYTHON): $(VBOXWEB_WSDL) $(VBOXWEBSERVICE_WSDL)
514 $(call MSG_GENERATE,,$@, WS Python bindings)
515 $(QUIET)$(RM) -f -- $@
516 $(QUIET)$(MKDIR) -p $(@D)
517# Try both w/o and with --file option
518 $(QUIET)$(REDIRECT) -C $(@D) -- bash -c "$(VBOX_WSDL2PY) -b $(VBOXWEBSERVICE_WSDL) || $(VBOX_WSDL2PY) -b --file $(VBOXWEBSERVICE_WSDL)"
519 $(QUIET)$(APPEND) $@ ''
520
521$(VBOXWEB_WS_PERL): $(VBOXWEB_WSDL) $(VBOXWEBSERVICE_WSDL)
522 $(call MSG_GENERATE,,$@, WS Perl bindings)
523 $(QUIET)$(MKDIR) -p $(@D)
524 $(QUIET)$(REDIRECT) -C $(@D) -- $(VBOX_STUBMAKER) file://$(VBOXWEBSERVICE_WSDL)
525# Ugly, ugly, ugly, make me right once
526 $(QUIET)$(SED) -e "s+http://www.virtualbox.org/Service+http://www.virtualbox.org/+" < $(VBOXWEB_WS_PERL) > $(VBOXWEB_WS_PERL).tmp
527 $(QUIET)$(MV) $(VBOXWEB_WS_PERL).tmp $(VBOXWEB_WS_PERL)
528 $(QUIET)$(APPEND) $@ ''
529
530$(VBOXWEB_WS_PHP): $(VBOXWEB_IDL_SRC) $(VBOX_PATH_WEBSERVICE)/websrv-php.xsl
531 $(call MSG_GENERATE,,$@,$(VBOXWEB_IDL_SRC) using websrv-php.xsl)
532 $(QUIET)$(RM) -f -- $@
533 $(QUIET)$(MKDIR) -p $(@D)
534 $(QUIET)$(VBOX_XSLTPROC) $(VBOXWEB_XSLTPROC_VERBOSE) -o $@ $(VBOX_PATH_WEBSERVICE)/websrv-php.xsl $<
535
536endif # VBOX_ONLY_SDK
537
538# generate typemap.dat (used by wsdl2h) from main XIDL file
539$(VBOXWEB_TYPEMAP): $(VBOXWEB_IDL_SRC) $(VBOX_PATH_WEBSERVICE)/websrv-typemap.xsl $(VBOX_PATH_WEBSERVICE)/websrv-shared.inc.xsl $(RECOMPILE_ON_MAKEFILE_CURRENT) | $$(dir $$@)
540 $(call MSG_GENERATE,,$@,$(VBOXWEB_IDL_SRC) using websrv-typemap.xsl)
541 $(QUIET)$(RM) -f -- $@
542 $(QUIET)$(VBOX_XSLTPROC) $(VBOXWEB_XSLTPROC_VERBOSE) -o $@ $(VBOX_PATH_WEBSERVICE)/websrv-typemap.xsl $<
543
544# generate gsoap pseudo-C header file from that WSDL; once via XSLT...
545$(VBOXWEB_GSOAPH_FROM_XSLT): $(VBOXWEB_WSDL) $(VBOX_PATH_WEBSERVICE)/websrv-wsdl2gsoapH.xsl $(VBOX_PATH_WEBSERVICE)/websrv-shared.inc.xsl $(RECOMPILE_ON_MAKEFILE_CURRENT) | $$(dir $$@)
546 $(call MSG_GENERATE,,$@,$(VBOXWEB_WSDL) using websrv-wsdl2gsoapH.xsl)
547 $(QUIET)$(RM) -f -- $@
548 $(QUIET)$(VBOX_XSLTPROC) $(VBOXWEB_XSLTPROC_VERBOSE) -o $@ $(VBOX_PATH_WEBSERVICE)/websrv-wsdl2gsoapH.xsl $<
549
550VBOX_NSMAP = $(VBOXWEB_OUT_DIR)/vboxwebsrv.nsmap
551$(VBOX_NSMAP): $(VBOXWEB_IDL_SRC) $(VBOX_PATH_WEBSERVICE)/websrv-nsmap.xsl $(VBOX_PATH_WEBSERVICE)/websrv-shared.inc.xsl $(RECOMPILE_ON_MAKEFILE_CURRENT) | $$(dir $$@)
552 $(call MSG_GENERATE,,$@,$(VBOXWEB_IDL_SRC) using websrv-nsmap.xsl)
553 $(QUIET)$(RM) -f -- $@
554 $(QUIET)$(VBOX_XSLTPROC) $(VBOXWEB_XSLTPROC_VERBOSE) -o $@ $(VBOX_PATH_WEBSERVICE)/websrv-nsmap.xsl $<
555
556ifdef VBOX_GSOAP_INSTALLED
557# ... and once with the gSOAP tool (just for comparison, we don't use it for licensing reasons)
558$(VBOXWEB_GSOAPH_FROM_GSOAP): $(VBOXWEB_WSDL) $(VBOXWEB_TYPEMAP) | $$(dir $$@)
559 $(call MSG_GENERATE,,$@,)
560 $(QUIET)$(RM) -f -- $@
561 $(VBOX_WSDL2H) $(VBOXWEB_WSDL_VERBOSE) -t$(VBOXWEB_TYPEMAP) -nvbox -o $@ $<
562
563# this sets the gsoap header that we use for further compilation; if stuff works, then the
564# one we generate via XSLT produces the same end result as the one from the gSOAP tool;
565# with this variable we can swap for testing, but shipped code must use VBOXWEB_GSOAPH_FROM_XSLT
566GSOAPH_RELEVANT = $(VBOXWEB_GSOAPH_FROM_XSLT)
567
568# wsdl2h -v: verbose
569# wsdl2h -e: don't qualify enum names
570# wsdl2h -n<prefix>: namespace header prefix
571
572## @todo change this to state explicitly what will be generated?
573
574# generate server and client code from gsoap pseudo-C header file
575$(VBOXWEB_OUT_DIR)/gsoap_generate_all_ts \
576+ $(VBOXWEB_OUT_DIR)/soapH.h \
577+ $(VBOXWEB_OUT_DIR)/soapStub.h \
578+ $(VBOXWEB_OUT_DIR)/soapC.cpp \
579+ $(VBOXWEB_OUT_DIR)/soapClient.cpp \
580+ $(VBOXWEB_OUT_DIR)/soapServer.cpp \
581: $(VBOXWEB_GSOAPH_FROM_GSOAP) $(VBOXWEB_GSOAPH_FROM_XSLT) $(VBOX_NSMAP) $(RECOMPILE_ON_MAKEFILE_CURRENT) | $$(dir $$@)
582 $(call MSG_GENERATE,,lots of files,$(GSOAPH_RELEVANT))
583 $(RM) -f $@
584 $(REDIRECT) -C $(VBOXWEB_OUT_DIR) -- $(VBOX_SOAPCPP2) $(VBOXWEB_SOAPCPP2_SKIP_FILES) -L -2 -w -I$(VBOX_PATH_GSOAP_IMPORT) $(GSOAPH_RELEVANT)
585 $(APPEND) $@ done
586
587# copy the generated headers and stuff. This has to be a separate rule if we
588# want to use wildcard (all commands are expaned when the rule is evaluated).
589$(VBOXWEB_OUT_DIR)/gsoap_copy_all_ts: $(VBOXWEB_OUT_DIR)/gsoap_generate_all_ts | $$(dir $$@)
590 $(RM) -f $@
591 $(MKDIR) -p $(PATH_TARGET_SOAPDEMOXML) $(PATH_TARGET_SOAPDEMOHEADERS) $(PATH_TARGET_SOAPDEMONSMAPS)
592ifdef VBOX_GSOAP_VERBOSE
593 $(MV) -f $(wildcard $(VBOXWEB_OUT_DIR)/*.req.xml $(VBOXWEB_OUT_DIR)/*.res.xml) $(PATH_TARGET_SOAPDEMOXML)
594endif
595 $(MV) -f $(wildcard $(VBOXWEB_OUT_DIR)/soapvbox*.h) $(PATH_TARGET_SOAPDEMOHEADERS)
596 $(MV) -f $(VBOXWEB_OUT_DIR)/vboxBinding.nsmap $(PATH_TARGET_SOAPDEMONSMAPS)
597 $(APPEND) $@ done
598
599$(PATH_TARGET_SOAPDEMONSMAPS) \
600$(PATH_TARGET_SOAPDEMOHEADERS)/soapvboxBindingProxy.h \
601$(PATH_TARGET_SOAPDEMOHEADERS)/soapvboxBindingObject.h: $(VBOXWEB_OUT_DIR)/gsoap_copy_all_ts
602
603# soapcpp2 -2: generate SOAP 1.2 calls
604# soapcpp2 -S: server-side code only
605# soapcpp2 -L: don't generate soapClientLib/soapServerLib
606# soapcpp2 -w: don't generate WSDL and schema files
607# soapcpp2 -x: don't generate sample XML files
608
609ifndef VBOX_WITHOUT_SPLIT_SOAPC
610#
611# Split up the soapC.cpp monster into manageable bits that can be
612# built in parallel and without exhausting all available memory.
613#
614$(VBOXWEB_OUT_DIR)/soapC-1.cpp \
615+ $(VBOXWEB_OUT_DIR)/soapC-2.cpp \
616+ $(VBOXWEB_OUT_DIR)/soapC-3.cpp \
617+ $(VBOXWEB_OUT_DIR)/soapC-4.cpp \
618+ $(VBOXWEB_OUT_DIR)/soapC-5.cpp \
619+ $(VBOXWEB_OUT_DIR)/soapC-6.cpp \
620+ $(VBOXWEB_OUT_DIR)/soapC-7.cpp \
621+ $(VBOXWEB_OUT_DIR)/soapC-8.cpp \
622+ $(VBOXWEB_OUT_DIR)/soapC-9.cpp \
623+ $(VBOXWEB_OUT_DIR)/soapC-10.cpp \
624+ $(VBOXWEB_OUT_DIR)/soapC-11.cpp \
625+ $(VBOXWEB_OUT_DIR)/soapC-12.cpp \
626+ $(VBOXWEB_OUT_DIR)/soapC-13.cpp \
627+ $(VBOXWEB_OUT_DIR)/soapC-14.cpp \
628+ $(VBOXWEB_OUT_DIR)/soapC-15.cpp \
629+ $(VBOXWEB_OUT_DIR)/soapC-16.cpp \
630+ $(VBOXWEB_OUT_DIR)/soapC-17.cpp \
631+ $(VBOXWEB_OUT_DIR)/soapC-18.cpp \
632+ $(VBOXWEB_OUT_DIR)/soapC-19.cpp \
633+ $(VBOXWEB_OUT_DIR)/soapC-20.cpp \
634: $(VBOXWEB_OUT_DIR)/soapC.cpp $$(split-soapC_1_TARGET) | $$(dir $$@)
635 $(RM) -f $(wildcard $(VBOXWEB_OUT_DIR)/soapC-?.cpp $(VBOXWEB_OUT_DIR)/soapC-??.cpp)
636 $(split-soapC_1_TARGET) $(VBOXWEB_OUT_DIR)/soapC.cpp $(VBOXWEB_OUT_DIR) 20
637endif # !VBOX_WITHOUT_SPLIT_SOAPC
638
639endif # VBOX_GSOAP_INSTALLED
640
641
642
643# generate method maps in server: map wsdl operations to com/xpcom method calls
644$(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 $$@)
645 $(call MSG_GENERATE,,$@,$(VBOXWEB_IDL_SRC) using websrv-cpp.xsl)
646 $(QUIET)$(VBOX_XSLTPROC) -o $@ $(VBOX_PATH_WEBSERVICE)/websrv-cpp.xsl $<
647
648
649ifdef VBOX_ONLY_SDK
650
651$(VBOXWEB_JAXWSSAMPLE): $(VBOX_PATH_WEBSERVICE)/samples/java/jax-ws/clienttest.java
652 $(QUIET)$(RM) -f -- $@
653 $(QUIET)$(MKDIR) -p $(VBOXWEB_SAMPLES_JAXWS_DIR)
654 $(QUIET)$(SED) -e 's/{VBOX_API_SUFFIX}/$(VBOX_API_SUFFIX)/' < $< > $@
655
656$(VBOXWEB_METRICSAMPLE): $(VBOX_PATH_WEBSERVICE)/samples/java/jax-ws/metrictest.java
657 $(QUIET)$(RM) -f -- $@
658 $(QUIET)$(MKDIR) -p $(VBOXWEB_SAMPLES_JAXWS_DIR)
659 $(QUIET)$(SED) -e 's/{VBOX_API_SUFFIX}/$(VBOX_API_SUFFIX)/' < $< > $@
660
661endif # VBOX_ONLY_SDK
662
663include $(KBUILD_PATH)/subfooter.kmk
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