Let me preface by mentioning that I\'ve been through everything I could find about this topic including the Solr docs and all of the SO questions.
I have a Solr inst
DIH does not produce nested documents. Solr supports them, but DIH can't yet generate them.
The nested entities in DIH is to be able to merge sources and to be able to create entities based on iteration from a different source. E.g. if the outer entity reads a file for file names and inner entity loads content from those files with each file getting its own record.
You may want to move your nested object code into the client with SolrJ for now.