Java package naming

Question

Okay, so I'm wanting tips on how to pick a name for my Java packages.

I saw this post: What package naming convention do you use for personal/hobby projects in Java? but this talks about personal projects.

What if for example I wanted to make an API Wrapper, and I develop with others on GitHub? I don't have a domain name.

score 6 · Accepted Answer · answered Jun 06 '11 at 05:00

6

The domain-name-backwards convention is there to prevent name collisions. Two different companies with the same product name will have different namespaces so everything works fine.

If you don't have a domain then you need to choose a name that is meaningful to you and will not collide with anything else. That's OK; it just means very slightly more work for you to make sure that there isn't an existing product with the name you want, and there may be difficulties if there ever is a name collision.

You won't be the first to do this: the JMockit library is all in the "mockit" namespace with no "com" or "org" prefix.

answered Jun 06 '11 at 05:00

Cameron Skinner

51,692
2
65
86

Thanks, this answered my question. And also thanks for linking me to a library that does this. – LanguagesNamedAfterCofee Jun 06 '11 at 05:02
JUnit *used* to do this as well: In JUnit 3, the package was `junit.framework`, in JUnit 4 it was changed to `org.junit`. – Joachim Sauer Jun 06 '11 at 06:38

score 2 · Answer 2 · answered Jun 06 '11 at 04:48

2

The recommendation has always been to start with your domain name backwards, then the project name, e.g. com.mycompany.myproject, and continue on with submodules as necessary.

answered Jun 06 '11 at 04:48

user207421

305,947
44
307
483

I don't have a domain name, should I use com.github.username.myproject? – LanguagesNamedAfterCofee Jun 06 '11 at 04:50
If the project has a domain name and you can use it, sure. – user207421 Jun 06 '11 at 07:47
@Languages: Yes, I just wanted to recommend this. – Paŭlo Ebermann Jun 06 '11 at 10:21

Java package naming

2 Answers2