Системное свойство user.home - это маг c, который вы ищете. К сожалению, не существует способа c определения папки с документами, связанного с ОС, вероятно, потому, что это не универсальная концепция.
Вы всегда можете просто быстро проверить, есть ли она там и так что используйте это. Кроме того, есть новый файловый API, я предлагаю вам его использовать.
Собираем вместе:
Path p = Paths.get(System.getProperty("user.home"));
Path candidate = p.resolve("Documents");
if (!Files.isDirectory(candidate)) candidate = p.resolve("My Documents");
if (!Files.isDirectory(candidate)) candidate = p;
p = p.resolve("Test").resolve("user.text");
Files.createDirectories(p.getParent());
Files.write(p, "Hello!");