Let me explain a little bit more about the structure of this simple project.
In the attached "Figure 1", you can see there are two main packages "serverOne"
and "serverTwo". Under each one, there is an interface like "OneServer.java",
an implementation like "OneServerImpl.java", and a CXF configuration file like
"OneServerConfig.java". The main part of the "OneServerConfig.java" is
@Bean @DependsOn("cxf") public Server
oneServerServerREST(ApplicationContext appContext) {
JAXRSServerFactoryBean factory =
RuntimeDelegate.getInstance().createEndpoint(jaxRsApiApplication(),
JAXRSServerFactoryBean.class); factory.setServiceBean(oneServer);
factory.setAddress("/oneServer");
factory.setProviders(restProviderList(appContext, oneServer));
Swagger2Feature feature = new Swagger2Feature(); // customize
some of the properties feature.setTitle("oneServer");
feature.setResourcePackage("com.example.api.serverOne");
feature.setBasePath("/oneServer");
feature.setUsePathBasedConfig(Boolean.TRUE); feature.setScan(true);
feature.setScanAllResources(true);
factory.getFeatures().add(feature); return factory.create(); }
The structure for "serverTwo" is basically the same, with the main part of the
"TwoServerConfig.java" as
@Bean @DependsOn("cxf") public Server
twoServerServerREST(ApplicationContext appContext) {
JAXRSServerFactoryBean factory =
RuntimeDelegate.getInstance().createEndpoint(twoServerJaxRsApiApplication(),
JAXRSServerFactoryBean.class); factory.setServiceBean(twoServer);
factory.setAddress("/twoServer");
factory.setProviders(restProviderList(appContext, twoServer));
Swagger2Feature feature = new Swagger2Feature(); // customize
some of the properties feature.setTitle("twoServer");
feature.setResourcePackage("com.example.api.serverTwo");
feature.setBasePath("/twoServer");
feature.setUsePathBasedConfig(Boolean.TRUE); feature.setScan(true);
feature.setScanAllResources(true);
factory.getFeatures().add(feature); return
factory.create(); }
So you can see that the two "Servers" are basically the same, and they are
loaded in "AppConfig.java" via
@Import({TwoServerConfig.class, OneServerConfig.class})
I am attaching 4 more screenshots here with comments to further explain what we
expects and what is happening. "Figure 2" and "Figure 3" show the cases when
"feature.setUsePathBasedConfig(Boolean.TRUE);" is enabled in both
"OneServerConfig.java" and "TwoServerConfig.java". Like I stated in my first
email, they display the titles correctly, but both pages do not have any
method, and I don't even see the "Show/Hide" link.
"Figure 4" and "Figure 5" show the cases when
"feature.setUsePathBasedConfig(Boolean.TRUE);" is commented out in both
"OneServerConfig.java" and "TwoServerConfig.java". Both display the same thing,
which is the API on "twoServer" with the actual API showing. I can show/hide
the API to show the two methods, "/two" and "/two/feed". We need "Figure 4" to
display "oneServer" APIs.
I hope I have explained my case clearly. Please help.
Dongfeng
On Tuesday, April 10, 2018, 5:47:52 PM CDT, Dongfeng Lu
<[email protected]> wrote:
Hi. We have been using CXF for a long time, and we would like to add Swagger 2
to our project. However, I have been having a hard time doing it. I have been
searching on the web for a couple of days, but I still cannot figure it out. I
need help.
For easy communication, I have build a sample project to illustrate my issue.
You can unzip it and run "mvn clean tomcat7:run" in the directory, and then you
can access it with "http://localhost:8080"; to display the two REST services,
built on two org.apache.cxf.endpoint.Servers.
If I comment out "feature.setUsePathBasedConfig(Boolean.TRUE);" in both
"OneServerConfig.java" and "TwoServerConfig.java", then both
"http://localhost:8080/oneServer/api-docs?url=/oneServer/swagger.json"; and
"http://localhost:8080/twoServer/api-docs?url=/twoServer/swagger.json"; display
the same thing, which is the API on "twoServer" with the actual API showing. I
can show/hide the API to show the two methods, "/two" and "/two/feed". Why do
they display the same thing?
If I enable "feature.setUsePathBasedConfig(Boolean.TRUE);" in both
"OneServerConfig.java" and "TwoServerConfig.java", then
"http://localhost:8080/oneServer/api-docs?url=/oneServer/swagger.json"; displays
a page titled correctly with "oneServer", while
"http://localhost:8080/twoServer/api-docs?url=/twoServer/swagger.json"; displays
a page titled correctly with "twoServer". Seems correct, but both pages do not
have any method, and I don't even see the "Show/Hide" link. Where does those
methods go?
Of course, we want each link to display its own Swagger information correctly,
with all available methods. What have I been doing wrong? Please help. Thanks
in advance.
Dongfeng
