spring-projects / spring-integration

Spring Integration provides an extension of the Spring programming model to support the well-known Enterprise Integration Patterns (EIP)
http://projects.spring.io/spring-integration/
Apache License 2.0
1.54k stars 1.11k forks source link

Migrate SI samples to dedicated git repository [INT-1380] #5378

Closed spring-operator closed 13 years ago

spring-operator commented 14 years ago

Chris Beams opened INT-1380 and commented


Sub-tasks:

Issue Links:

spring-operator commented 14 years ago

Chris Beams commented

This suggests that samples should have their own JIRA project, unless you intend to lock the release schedules for these two repositories. Thoughts?

spring-operator commented 14 years ago

Oleg Zhurakousky commented

All samples are now migrated to the new samples repository which could be checked out from git://git.springsource.org/spring-integration/samples.git Samples also have a new structure:

  1. Examples are categorized. Currently there are 3 categories. There could be more if needed. At the time of closing this issue the repository looks like this:
samples
    case-studies
        cafe
        loan-broker
        loan-shark
    cook-books
        async-gateway
        error-handling
        multipart-http
    getting-started
        file
        helloworld
        jms
        jmx
        oddeven
        quote
        ws-inboound-gateway
        ws-outbound-gateway
  1. Each sample is an independent Maven project, ready to be worked with independently (no more parent project)
  2. Each example is ready to be imported into STS/Eclipse as well as ran from the CLI
  3. Each example contains a readme.txt file with a short description of the sample as well as how to run it and what the output (if any) should be.
spring-operator commented 14 years ago

Chris Beams commented

I'm not sure that 'case-studies' makes sense to me yet. loan-broker, for example, is based on an 'interlude' from the EIP book. It's a common domain problem, fleshed out in code. This is different from a case study, which usually connotes an analysis of a real-world customer's real-world problem solved using a particular technology.

spring-operator commented 14 years ago

Oleg Zhurakousky commented

Well i wish i had this feedback earlier ;) May be the 'case-studies' is not the best name, so let me explain some of the thoughts and then we may come up with a better suggestion.

Getting Started - simple examples focusing on how to get started with Spring Integration based on simple tech-cenric samples (no business case or realistic story point, just a notch above Foo and Bar).

Cook Books - will contain samples that are step above 'getting started' but still purely technology oriented and that demonstrate 'ways of doing things' (e.g., error handling - will show various technical scenarios for handling errors). Also it will contain some "hidden treasures" style samples.

Case Studies - was meant to contain samples where the focus is some business case or a story and how SI technologies can address that story. The idea is that once we have enough different stories there, developers will always find a story the can relate to and take that sample as a starting point.

So, if there is a better name, please let me know which it is still in a state where we can change things.

spring-operator commented 14 years ago

Chris Beams commented

Not sure about a better name; I suppose if it's clearly explained to users (as above), perhaps that's sufficient. Case Studies is probably better than 'Interludes' to those unfamiliar with EIP.

Mark's call in the end. I suppose what matters right now is the structure itself, and it seems reasonable.