[GitHub] [camel-kafka-connector] orpiske commented on pull request #343: Set default and doc config properties as private
orpiske commented on pull request #343: URL: https://github.com/apache/camel-kafka-connector/pull/343#issuecomment-666340690 > > I agree that moving to private would follow generally accepted good practices (for lack of a better "term"). However, I still feel -1 towards making it `private`. My feeling towards this comes from the fact that Kafka seems to also use [public visibility](https://github.com/apache/kafka/blob/trunk/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/ConnectorConfig.java#L98) on their code base. > > Even though these are separate projects, I believe that maintaining them as `public` would be consistent to how it is done right now on the Kafka Connect code base. I believe that maintaining this consistency could simplify the job for developers looking to extend the Camel Kafka Connector connectors. > > Therefore, my suggestion is -1. > > Well, I see a mixed approach in that class. There are some `_DOC` and `_DISPALY` properties that are actually private, which is what I'm proposing here (make private every metadata associated with a given key). The `_CONF` properties would remain public, because they are actually needed outside of this class. > > That said, I understand that this is more a matter of good practices than a real need, so I'm ok with whatever we choose. Thanks for the clarification. I had initially thought that this would change the _CONF ones too. With your explanation I see that's not the case. So, given that it - with this change - it would be consistent with the way Kafka Connect code base is doing ... That's +1 from me. This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: us...@infra.apache.org
[GitHub] [camel-kafka-connector] orpiske commented on pull request #343: Set default and doc config properties as private
orpiske commented on pull request #343: URL: https://github.com/apache/camel-kafka-connector/pull/343#issuecomment-666311561 I agree that moving to private would follow generally accepted good practices (for lack of a better "term"). Howev er, I still feel -1 towards making it private. My feeling towards this comes from the fact that Kafka seems to also use [public visibility](https://github.com/apache/kafka/blob/trunk/connect/runtime/src/main/java/org/apache/kafka/connect/runtime/ConnectorConfig.java#L98) on their code base. Even though these are separate projects, I believe that maintaining them as `public` would be consistent to how it is done right now on the Kafka Connect code base. I believe that maintaining this consistency could simplify the job for developers looking to extend the Camel Kafka Connect connectors. Therefore, my suggestion is -1. This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: us...@infra.apache.org
[GitHub] [camel-kafka-connector] orpiske commented on pull request #343: Set default and doc config properties as private
orpiske commented on pull request #343: URL: https://github.com/apache/camel-kafka-connector/pull/343#issuecomment-666230358 > Hi @orpiske I see your point, but we have the `ConfigDef.getConfigValue` that we could use to expose these values when needed. In that case we would just need the map of `ConfigKey`s from the public method `ConfigDef.configKeys`. Indeed, that could do the trick in this case! This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: us...@infra.apache.org
[GitHub] [camel-kafka-connector] orpiske commented on pull request #343: Set default and doc config properties as private
orpiske commented on pull request #343: URL: https://github.com/apache/camel-kafka-connector/pull/343#issuecomment-666216380 IMHO, we should keep them as public. One of the ideas we discussed (#178) could benefit from having access to these fields. Having access to the list of configurations and descriptions could, potentially, open the room for interfaces that validate and display those options in a way that is easier for the user to figure them out. Since they are ready-only already, it shouldn't be a problem as they are, IMHO. This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: us...@infra.apache.org