Ilya, Completely agree about starting from scratch. My suggestion to clone the examples repo which contains the entire TopNWords example project was in response to your suggestion in item 5 of your message.
For a simpler "Hello World" project, the steps at https://docs.datatorrent.com/apex_development_setup/ should work -- it involves running a just a couple of commands on the comand line and, for those wanting an even simpler process, a script is provided that automates things even further. A similarly super-simple approach to gettting started is outlined in my blog: https://www.datatorrent.com/buildingapps/ People can directly run many of the existing demos after building core and malhar and then experiment with modifying the sources of those demos. For a more substantial example like Top N Words, there is a fair bit of code needed in multiple files; the process outlined in the tutorial on the website is simply trying to save some time by copying existing files over from Malhar and making the minimal changes needed to incorporate them into a standalone project. For someone wanting to get involved with Apex, I think it is imperative to get familiar with running tools like git and maven from the command line, so the tutorials rely on those tools. Please let me know if you run into problems with any of the above steps. Ram On Thu, Nov 19, 2015 at 11:07 AM, Ganelin, Ilya <[email protected]> wrote: > Ram - the use case I'm targeting is having someone create a new project from > scratch based on an example. This is a little bit different. This is why I > was basing it on the documentation from the website. > > The above is a necessity for getting new members involved with the project. > > > > Thank you, > Ilya Ganelin > > > > -----Original Message----- > From: Munagala Ramanath [[email protected]<mailto:[email protected]>] > Sent: Thursday, November 19, 2015 01:50 PM Eastern Standard Time > To: [email protected] > Subject: Re: Word Count Tutorial Failure > > > Ilya, > > Could you please clone: https://github.com/DataTorrent/examples > You'll find the complete project in tutorials/topnwords/app > You should be able to build it successfully with: mvn clean package > -DskipTests > I just tried it. Let me know if you run into any issues. > > Ram > > > On Thu, Nov 19, 2015 at 10:18 AM, Ganelin, Ilya > <[email protected]> wrote: >> Hi all – I just attempted to follow the instructions here: >> http://docs.datatorrent.com/tutorials/topnwords-c2/ >> >> For standing up top N words in Java. >> >> As it stands, things did not work. I was using IntelliJ Idea 14. There were >> a number of issues, a short (not comprehensive) list is below. >> >> 1. There are discrepancies between the selected language level in the >> project settings and certain constructs in the code >> * In WordReader.java diamonds are used, which are only supported in >> java 7 but the language level is set to 5 >> 2. The apex version is out of date in the pom.xml file (it’s set to 2.2) >> 3. ApplicationWithQuerySupport.java does not compile with newer versions >> of Apex >> >> I spent about 15 minutes trying to get this thing to work in its present >> state and it simply was not an easy and ready to roll example. >> >> General thoughts: >> >> 1. We should not be asking users to manually copy example files from one >> place to another >> 2. We should not be asking them to rename packages to get things to work >> 3. We should not be asking them to modify existing example code to >> construct another example. >> * I think a better approach is to provide a complete example (that >> works out of the box) and that we can then walk through line by line to >> explain what it’s doing. >> 4. We shouldn’t be asking them to copy-paste in settings. Instead, we >> should walk them through what it means to set settings and have a simple >> enough example that it’s straightforward to configure. >> 5. Standing up a word count example should be a 1-button-click deployment >> that is ready to run without any user input. Any further configuration >> should only be necessary for the sake of teaching, not for the sake of >> operationalizing the project. >> >> I hope this helps, I’m happy to offer further feedback. Thanks! >> ________________________________________________________ >> >> The information contained in this e-mail is confidential and/or proprietary >> to Capital One and/or its affiliates and may only be used solely in >> performance of work or services for Capital One. The information transmitted >> herewith is intended only for use by the individual or entity to which it is >> addressed. If the reader of this message is not the intended recipient, you >> are hereby notified that any review, retransmission, dissemination, >> distribution, copying or other use of, or taking of any action in reliance >> upon this information is strictly prohibited. If you have received this >> communication in error, please contact the sender and delete the material >> from your computer. > ________________________________________________________ > > The information contained in this e-mail is confidential and/or proprietary > to Capital One and/or its affiliates and may only be used solely in > performance of work or services for Capital One. The information transmitted > herewith is intended only for use by the individual or entity to which it is > addressed. If the reader of this message is not the intended recipient, you > are hereby notified that any review, retransmission, dissemination, > distribution, copying or other use of, or taking of any action in reliance > upon this information is strictly prohibited. If you have received this > communication in error, please contact the sender and delete the material > from your computer.
