Comments (11)
What documentation are you referring to and what specifically is confusing? May be an opportunity to improve the documentation if you provide something concrete.
from springfox-demos.
This subproject is a vanilla spring mvc application example
from springfox-demos.
Our concern with using that project is we do not have access to Gradle
where we work, so we cannot deploy it. Do you have a build agnostic
project example?
In most cases we end up creating eclipse dynamic web projects or Maven projects if there's a lot of dependencies, but unfortunately Gradle is not an option for us.
On Tue, Jul 7, 2015 at 3:34 PM, Dilip Krishnan [email protected]
wrote:
This subproject
https://github.com/springfox/springfox-demos/tree/master/spring-java-swagger
is a vanilla spring mvc application example—
Reply to this email directly or view it on GitHub
#6 (comment)
.
from springfox-demos.
the thing about gradle is that it is bootstrapped already using the gradle wrapper (gradlew). if you use the gradlew command it will automatically download everything you need.
./gradlew clean build #equivalent to mvn clean install
Its very simple to translate a gradle project to maven. Also we provide the instructions in our documentation have everything you need as regards maven or gradle.
Another great source to generate a skeleton project for maven is available at http://editor.swagger.io Generate Server -> Spring MVC
, tho' the skeleton is a little out of date.
It would be much appreciated if you contribute a maven example that we can include in the spring demos, but we simply don't have the bandwidth to do that an maintain it unfortunately!
from springfox-demos.
Thank for your response. I have tried creating a skeleton project with the
swagger editor project, unfortunately, there's a bug that prevents
its creation.
Also, I wouldn't expect mvn clean install
to startup and deploy to a web
container. Do you have anything setup to run mvn jetty:run
?
from springfox-demos.
I wanted to document my continued troubles using the springfox-demo project.
I pulled down the latest code and opened it into eclipse. I then opened a terminal and issued the following commands:
C:\eclipse\workspace\springfox-demos>gradle spring-java-swagger:appRun
:spring-java-swagger:compileJava UP-TO-DATE
:spring-java-swagger:processResources UP-TO-DATE
:spring-java-swagger:classes UP-TO-DATE
:spring-java-swagger:prepareInplaceWebAppClasses UP-TO-DATE
:spring-java-swagger:prepareInplaceWebAppFolder UP-TO-DATE
:spring-java-swagger:prepareInplaceWebApp UP-TO-DATE
:spring-java-swagger:appRun
19:25:42 INFO Spring WebApplicationInitializers detected on classpath: [springfoxdemo.java.swagger.ApplicationInitializer@60dce7ea]
19:25:42 INFO Initializing Spring FrameworkServlet 'dispatcher'
....
Jul 07, 2015 7:25:47 PM org.springframework.web.servlet.handler.SimpleUrlHandlerMapping registerHandler
INFO: Mapped URL path [/swagger-ui.html] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
Jul 07, 2015 7:25:47 PM org.springframework.web.servlet.handler.SimpleUrlHandlerMapping registerHandler
INFO: Mapped URL path [/webjars/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
Jul 07, 2015 7:25:48 PM org.springframework.web.servlet.DispatcherServlet initServletBean
INFO: FrameworkServlet 'dispatcher': initialization completed in 5865 ms
19:25:48 INFO Jetty 9.2.9.v20150224 started and listening on port 8080
19:25:48 INFO spring-java-swagger runs at:
19:25:48 INFO http://localhost:8080/spring-java-swagger
Press any key to stop the server.
However, when I visit the webpage I get a 404 error
HTTP ERROR 404
Problem accessing /spring-java-swagger/. Reason:
Not Found
Powered by Jetty://
from springfox-demos.
Have you read the readme?
from springfox-demos.
@dilipkrish - If anything, I think that proves the point I was trying to make. Why do we need to run that script instead of just using native Gradle?
Also, yes; I did read the file and I am still getting the same response:
C:\eclipse\workspace\springfox-demos>gradlew spring-java-swagger:appRun
:spring-java-swagger:compileJava
warning: [options] bootstrap class path not set in conjunction with -source 1.7
1 warning
:spring-java-swagger:processResources
:spring-java-swagger:classes
:spring-java-swagger:prepareInplaceWebAppClasses
:spring-java-swagger:prepareInplaceWebAppFolder
:spring-java-swagger:prepareInplaceWebApp
:spring-java-swagger:appRun
20:13:49 INFO Spring WebApplicationInitializers detected on classpath: [springfoxdemo.java.swagger.ApplicationInitializer@60dce7ea]
20:13:50 INFO Initializing Spring FrameworkServlet 'dispatcher'
Jul 07, 2015 8:13:50 PM org.springframework.web.servlet.DispatcherServlet initServletBean
INFO: FrameworkServlet 'dispatcher': initialization started
....
Press any key to stop the server.
Jul 07, 2015 8:14:03 PM org.springframework.web.servlet.PageNotFound noHandlerFound
WARNING: No mapping found for HTTP request with URI [/spring-java-swagger/] in DispatcherServlet with name 'dispatcher'
Jul 07, 2015 8:14:06 PM org.springframework.web.servlet.PageNotFound noHandlerFound
WARNING: No mapping found for HTTP request with URI [/spring-java-swagger/] in DispatcherServlet with name 'dispatcher'
HTTP ERROR 404
Problem accessing /spring-java-swagger/. Reason:
Not Found
Powered by Jetty://
from springfox-demos.
I also wanted to document more confusion we are facing in regards to trying to figure out dependencies. To simplify the project, I would think adding the controllers into the project would make the most sense instead of using the ones in the dependent jar files.
Another source of confusion are the resourceHandler's:
For example why do we need the following (classpath:/META-INF/resources/):
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
registry.addResourceHandler("swagger-ui.html").addResourceLocations("classpath:/META-INF/resources/");
registry.addResourceHandler("/webjars/**").addResourceLocations("classpath:/META-INF/resources/webjars/");
}
A simpler project for people to get used to springfox might be very beneficial.
from springfox-demos.
To answer your questions:
If anything, I think that proves the point I was trying to make. Why do we need to run that script instead of just using native Gradle
Without repeating the official gradle documentation, the gradle wrapper is only so that you don't need to install gradle on the machine. Secondly, its a way to provide a specific version of gradle (2.4-rc-1) and not depend on the natively installed gradle, and that applies to CI environments as well.
Also, yes; I did read the file and I am still getting the same response:
If you had read the readme, you'd have known that
- the apidocs are @
http://localhost:8080/spring-java-swagger/v2/api-docs
- the swagger ui is available @
http://localhost:8080/spring-java-swagger/swagger-ui.html
If you were expecting that by going to http://localhost:8080/spring-java-swagger/
the browser would magically redirect you to one of those places, thats obviously not going to work, unless YOU write code for it.
To simplify the project, I would think adding the controllers into the project would make the most sense instead of using the ones in the dependent jar files.
Not sure what you mean.
For example why do we need the following (classpath:/META-INF/resources/)
This is for the convenience of library users and is completely optional. This is only needed if you want to use a pre-packaged version of the swagger-ui with your application. We've bundled a custom version of swagger-ui into a web jar and the we need to register resource handlers to serve the bundled swagger-ui.html
. You'd have to do the same thing if you hand rolled your own solution. More info on web jars here.
A simpler project for people to get used to springfox might be very beneficial.
What constitutes "simple" is always a slippery slope. In our opinion, this is the simplest setup to have spring-swagger integration, which also includes the swagger-ui built in. Which is what 90% of the people want to accomplish. If you want instructions on a simpler setup the getting started documentation is the best place to go. In general the demo apps are targeted towards typical setups.
Lastly; and this is by no means tongue in cheek; this is all open source, and we love for you to give back to the community by either adding to the list of demos a sample maven setup or improving the documentation or contributing bug-fixes or even just plain sharing your ideas. Stuff that might be useful for folks similar to yourself. More importantly it would give us an idea as what you mean by "simpler project".
Hope that helped you with your confusion. I'd be happy address any more of your feedback or questions but non-constructive criticism is neither going to be productive for your nor this project.
from springfox-demos.
@dilipkrish, thank you for such a thorough response. I will have to do some research on the links provided. I appreciate the time you took responding.
Thanks again
from springfox-demos.
Related Issues (20)
- ERROR : [RMI TCP Connection(3)-127.0.0.1] [springfox.documentation.spring.web.scanners.ApiDescriptionReader] H=[LT031HLB] Skipping process path[/xx/yy/zzzz], method[xxMethod] as it has an error. HOT 1
- full class name as schema name,
- @Schema can not show
- I am not able to get the headers hooked up and working
- Upgrading from 2.9.2 to 3.0.0 removed access to /swagger-ui.html HOT 1
- How to use ApiListingScannerPlugin to add a web api? Could you offer a demo with version 3.0?
- Swagger UI not showing HOT 1
- Webflux example project is outdated
- Request Body parameter - providing different json examples to the end user in swagger (same object in multiple endpoints)
- Avoid endless Class Parameter Argument scanning, if the parameter Object contains a circular reference (e.g. bi directional relation within a bean)
- [Question] Change /api-docs URL using springfox-boot-starter:3.0.0
- Is it possible to share sample app for spring fox 2.9.2
- Moving /v2/api-docs to customised path
- What ever i try, the /v2/api-docs and /swagger-resources/configuration/ui return a 404 NOT FOUND
- documentationPluginsBootstrapper error in spring fox
- How to define security at root level HOT 1
- Skipping process path[<path>], method[<method>] as it has an error.
- http://localhost:8080/spring-xml-swagger/swagger-ui.html is not working HOT 3
- Questions :: Is there a way in Swagger to show the UI documentation only to internal users? HOT 3
- Cant reach "http://localhost:8080/documentation/swagger-ui" when running the springfox-demos/boot-webflux/ demo HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from springfox-demos.